> ## Documentation Index
> Fetch the complete documentation index at: https://dragonwingdocs.qualcomm.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Camera
The IQ8-EVK supports camera sensor connectivity through three MIPI CSI interfaces, supporting both C-PHY and D-PHY modes.
## Hardware Architecture
### CSI Interface Mapping
| CSI Interface | Analog Switch | Camera Connector | B2B Connector |
| ------------- | ----------------- | ---------------- | ------------------- |
| CSI0 | U45 (TMUX646ZECR) | JCAM0 | JEXP4, Pins 111–120 |
| CSI1 | U42 (TMUX646ZECR) | JCAM1 | JEXP4, Pins 51–60 |
| CSI2 | U44 (TMUX646ZECR) | JCAM2 | JEXP4, Pins 40–49 |
### DIP Switch Configuration
| Switch | ON | OFF (default) |
| ------ | --------------------- | ---------------- |
| SW1-5 | CSI0 → GMSL mezzanine | CSI0 → mainboard |
| SW1-6 | CSI1 → GMSL mezzanine | CSI1 → mainboard |
| SW1-7 | CSI2 → GMSL mezzanine | CSI2 → mainboard |
## Supported MIPI CSI Camera Sensors
### ov9282 Camera Sensor
### Arducam imx577 Camera Sensor
**Arducam sensor requires an additional converter board(Arducam 22-pin to Qualcomm 30-pin CSI adapter)**
**Arducam imx577 sensor + 22 pin flex cable + converter board**
### Arducam imx577 Camera Sensor connection to iq8275
### ov9282 Camera Sensor connection to iq8275
## Supported Resolutions
| Resolution | Aspect Ratio | IMX577 | OV9282 |
| ----------- | ------------ | ------ | ------ |
| 4000 × 3000 | 4:3 | Yes | No |
| 3840 × 2160 | 16:9 | Yes | No |
| 1920 × 1080 | 16:9 | Yes | No |
| 1280 × 720 | 16:9 | Yes | Yes |
| 1024 × 768 | 4:3 | Yes | Yes |
| 640 × 480 | 4:3 | Yes | Yes |
| 320 × 240 | 4:3 | Yes | Yes |
* Advanced features such as SHDR, LDC, and EIS are not supported on IQ-8275.
* There is no hardware JPEG encoder — snapshots use a software encoder running on the CPU.
## Camera Streaming
### Single Camera Stream
```bash theme={null}
gst-launch-1.0 -e qtiqmmfsrc name=camsrc camera=0 ! \
'video/x-raw,format=NV12,width=1280,height=720,framerate=30/1' ! fakesink
```
The above command starts the camera with 720p at 30 FPS configuration.
The frame coming from the camera sensor is thrown away by fakesink.
If the gst pipeline status is changed to “PLAYING” as shown below, this indicates that the camera is running.
Since this command dumps camera frames to fakesink, nothing will be saved on the device.
If the pipeline status changes to `PLAYING`, the camera is running. Press `Ctrl+C` to stop.
```bash theme={null}
gbm_create_device(187): Info: backend name is: msm_drm
Setting pipeline to PAUSED ...
Pipeline is live and does not need PREROLL ...
Setting pipeline to PLAYING ...
New clock: GstSystemClock
```
### Video Encoding
```bash theme={null}
gst-launch-1.0 -e qtiqmmfsrc name=camsrc camera=0 ! \
video/x-raw,format=NV12,width=1280,height=720,framerate=30/1,\
interlace-mode=progressive,colorimetry=bt601 ! \
v4l2h264enc capture-io-mode=4 output-io-mode=5 \
extra-controls="controls,video_bitrate=6000000,video_bitrate_mode=0;" ! \
h264parse ! mp4mux ! filesink location=/home/ubuntu/mux_avc.mp4
```
### Object Detection Pipeline
Download required models and assets first:
```bash theme={null}
cd /home/ubuntu
curl -L -O https://raw.githubusercontent.com/quic/sample-apps-for-qualcomm-linux/refs/heads/main/qualcomm-linux/scripts/download_artifacts.sh
sudo chmod +x download_artifacts.sh && sudo ./download_artifacts.sh
```
## Multi-Camera with Offline IFE
The IQ-8275 has two IFEs for real-time bayer-to-YUV processing. The **Offline IFE** feature allows a single IFE to process two cameras in offline mode, enabling concurrent streaming from all four cameras.
A maximum of two cameras can operate concurrently with real-time IFE. All four cameras can operate concurrently using the Offline IFE feature.
## Troubleshooting
```bash theme={null}
systemctl restart cam-server
```
```bash theme={null}
gst-launch-1.0 -e qtiqmmfsrc name=camsrc camera=0 ! \
video/x-raw,format=NV12,width=1280,height=720,framerate=30/1 ! fakesink
```
```bash theme={null}
journalctl -f > /home/ubuntu/log.txt
```
Look for: `CAM_INFO: CAM-SENSOR: Probe success, slot:0, ...`
If no probe success appears, check the flex cable connection or camera module.
```bash theme={null}
sudo su
echo 3 > /sys/kernel/debug/camera/ife/ife_csid_debug
dmesg -w > /home/ubuntu/dmesg.txt
```
## Resources
| Topic | Link |
| -------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| Camera Architecture | [Camera Architecture](https://docs.qualcomm.com/doc/80-70023-17A/topic/camera-architecture.html) |
| Camera Sensor Driver Development | [Camera Sensor Driver Development](https://docs.qualcomm.com/doc/80-70023-17A/topic/camera-sensor-driver-development.html) |
| Customize Camera Use Case and Pipeline | [Customize Camera Use Case and Pipeline](https://docs.qualcomm.com/doc/80-70023-17A/topic/customize-camera-use-case-and-pipelines.html) |