跳到主要内容

Raspberry Pi 使用说明

1. 硬件连接​

树莓派 5

接入树莓派 5

树莓派 4

接入树莓派 4

提示

以上图片仅供展示，本产品不含以上树莓派主板和黄色 FPC 排线。

2. 软件环境配置​

2.1 烧录官方 Raspberry Pi OS 镜像​

  • 请先将最新版官方 Raspberry Pi OS 烧录到 SD 卡。
  • 烧录完成后，启动树莓派并完成基础初始化配置。

2.2 安装 GStreamer 工具​

sudo apt update
sudo apt install gstreamer1.0-tools

2.3 拷贝驱动安装包​

将驱动压缩包 ISX031-3MP-Camera.zip 拷贝到树莓派。

解压并进入目录：

unzip ISX031-3MP-Camera.zip
cd ISX031-3MP-Camera

2.4 安装驱动​

给安装脚本添加执行权限并执行安装：

chmod +x install.sh
./install.sh

2.5 树莓派 5 摄像头接口选择​

  • CAM1（默认）：将摄像头连接到 CAM1，无需修改配置。
  • CAM0：将摄像头连接到 CAM0，然后打开 /boot/firmware/config.txt：
sudo nano /boot/firmware/config.txt

将下面这一行：

dtoverlay=isx031

修改为：

dtoverlay=isx031,cam0

2.6 重启树莓派​

安装及接口配置完成后，重启树莓派：

sudo reboot

3. 预览测试​

3.1 查找 ISX031 对应的 media 设备​

执行以下命令，查找 ISX031 对应的 media 设备：

for dev in /dev/media*; do media-ctl -d "$dev" -p 2>/dev/null | grep -qi isx031 && echo "$dev"; done

在下面配置拓扑的命令中，-d 后面填写上面查到的 media 设备号。例如输出 /dev/media0，则使用 -d 0。

3.2 树莓派 5​

3.2.1 分辨率：1920 × 1536​

配置链路：

media-ctl -d 0 -V ''\''isx031 11-001a'\'':0 [fmt:UYVY8_1X16/1920x1536 field:none colorspace:smpte170m]'
media-ctl -d 0 -V ''\''csi2'\'':0 [fmt:UYVY8_1X16/1920x1536 field:none colorspace:smpte170m]'
media-ctl -d 0 -l ''\''csi2'\'':4 -> '\''rp1-cfe-csi2_ch0'\'':0 [1]'

预览（在树莓派上执行）：

gst-launch-1.0 v4l2src device=/dev/video0 ! video/x-raw,format=UYVY,width=1920,height=1536,framerate=30/1 ! videoconvert ! fpsdisplaysink video-sink=xvimagesink sync=false

3.2.2 分辨率：1920 × 1080​

配置链路：

media-ctl -d 0 -V ''\''isx031 11-001a'\'':0 [fmt:UYVY8_1X16/1920x1080 field:none colorspace:smpte170m]'
media-ctl -d 0 -V ''\''csi2'\'':0 [fmt:UYVY8_1X16/1920x1080 field:none colorspace:smpte170m]'
media-ctl -d 0 -l ''\''csi2'\'':4 -> '\''rp1-cfe-csi2_ch0'\'':0 [1]'

预览（在树莓派上执行）：

gst-launch-1.0 v4l2src device=/dev/video0 ! video/x-raw,format=UYVY,width=1920,height=1080,framerate=30/1 ! videoconvert ! fpsdisplaysink video-sink=xvimagesink sync=false

3.3 树莓派 4​

3.3.1 分辨率：1920 × 1536​

配置链路：

media-ctl -d 0 -V ''\''isx031 10-001a'\'':0 [fmt:UYVY8_1X16/1920x1536 field:none colorspace:smpte170m]'

预览（在树莓派上执行）：

gst-launch-1.0 v4l2src device=/dev/video0 ! video/x-raw,format=UYVY,width=1920,height=1536,framerate=30/1 ! videoconvert ! fpsdisplaysink video-sink=xvimagesink sync=false

3.3.2 分辨率：1920 × 1080​

配置链路：

media-ctl -d 0 -V ''\''isx031 10-001a'\'':0 [fmt:UYVY8_1X16/1920x1080 field:none colorspace:smpte170m]'

预览（在树莓派上执行）：

gst-launch-1.0 v4l2src device=/dev/video0 ! video/x-raw,format=UYVY,width=1920,height=1080,framerate=30/1 ! videoconvert ! fpsdisplaysink video-sink=xvimagesink sync=false

4. 注意事项​

  • 请确认摄像头排线连接正确（注意金属触点方向，并确保卡扣锁紧）。