产品参数​

产品尺寸​

硬件连接​

软件环境配置测试​

更新系统​

为了确保摄像头可以正常使用，请使用最新版本树莓派系统，并用以下指令更新。

sudo apt-get update -y
sudo apt-get upgrade -y

如果只调用一个摄像头，请将摄像头接入到 CAM1 口。

配置 config.txt 文件​

• 使用 nano 工具打开并编辑 /boot/firmware/config.txt 文件。

  sudo nano /boot/firmware/config.txt
  

• 找到 camera-auto-detect=1 语句，修改为 camera_auto_detect=0。

• 在文件尾部，加入语句 dtoverlay=imx477，如果有多个摄像头接入，可以添加 cam0 或者 cam1 参数来指定，比如：

  dtoverlay=imx477,cam0
  dtoverlay=imx477,cam1
  

• 配置完成后，保存文件并重启系统 sudo reboot。

测试摄像头​

• 配置完成后，重启系统并用 sudo rpicam-hello --list-cameras 指令查看摄像头是否被识别。
• 接入屏幕后，可以用 sudo rpicam-hello -t 0 指令预览摄像头。

更多 rpicam 指令相关，可以查看 树莓派 rpicam 工具说明

硬件连接​

软件配置​

JetPack 4.6 及以上版本（推荐）​

Jetson 主板使用 jetson-io 工具配置摄像头驱动，IMX477 传感器已原生支持。

1. 打开终端，运行 jetson-io 工具：

   sudo /opt/nvidia/jetson-io/jetson-io.py
   

2. 选择 Configure Jetson CSI Connector。

3. 选择 Configure for compatible hardware。

4. 根据摄像头接入数量选择对应配置：

   • Camera IMX477 Dual — 两个摄像头接口均设置为 IMX477
   • Camera IMX477-A and IMX219-B — 一个接口为 IMX477，另一个为 IMX219

5. 保存配置并重启系统。

JetPack 4.6 以下版本​

JetPack 4.6 以下版本需要额外安装 IMX477 驱动，安装驱动后可能对原 IMX219 摄像头的使用产生影响，建议安装前先备份系统。

可参考 RidgeRun 的 IMX477 驱动教程：
https://github.com/RidgeRun/NVIDIA-Jetson-IMX477-RPIV3

测试摄像头​

检查摄像头是否识别​

sudo dmesg | grep imx477

如果摄像头识别成功，会看到类似 imx477 传感器的相关信息。

使用 gstreamer 预览​

连接 HDMI 或 DP 显示器后，执行以下指令预览摄像头画面：

DISPLAY=:0.0 gst-launch-1.0 nvarguscamerasrc ! 'video/x-raw(memory:NVMM), width=1920, height=1080, format=(string)NV12, framerate=(fraction)20/1' ! nvoverlaysink -e

双摄像头测试​

如果需要测试双摄像头，可以添加 sensor-id 参数来选择摄像头：

# 测试 video0
DISPLAY=:0.0 gst-launch-1.0 nvarguscamerasrc sensor-id=0 ! 'video/x-raw(memory:NVMM), width=1920, height=1080, format=(string)NV12, framerate=(fraction)20/1' ! nvoverlaysink -e

# 测试 video1
DISPLAY=:0.0 gst-launch-1.0 nvarguscamerasrc sensor-id=1 ! 'video/x-raw(memory:NVMM), width=1920, height=1080, format=(string)NV12, framerate=(fraction)20/1' ! nvoverlaysink -e

RDK X 系列主板（RDK X3 / RDK X5）提供了 MIPI 摄像头示例程序，可快速测试摄像头数据通路。

硬件连接​

• 将摄像头排线连接到 RDK 主板的 MIPI CSI 接口，注意金属触点朝向。具体接口位置请参考对应主板硬件说明。
• 通过 HDMI 线缆连接开发板和显示器，用于显示摄像头画面。

运行官方示例程序​

RDK 系统预装了 MIPI 摄像头测试示例 mipi_camera.py，位于 /app/pydev_demo/03_mipi_camera_sample/ 目录下。

1. （可选）如果使用的是 Desktop 版本系统，可以先执行以下命令关闭桌面服务释放显示资源：

   sudo systemctl stop lightdm
   

2. 通过 SSH 登录开发板，进入示例目录并运行：

   cd /app/pydev_demo/03_mipi_camera_sample/
   sudo python3 ./mipi_camera.py
   

   程序执行后，显示器会实时显示摄像头画面及目标检测结果。

注意事项​

• 更多 RDK X 系列 MIPI 摄像头使用说明，请参考官方文档：
  RDK X5 MIPI 摄像头使用

• 树莓派摄像头软件官方资料
• Jetson Multimedia 官方资料
• RDK 官方文档