摄像头
关于摄像头模块
树莓派目前有多个官方摄像头模块。最初的 500 万像素型号发布于 2013 年，随后是 2016 年发布的 800 万像素摄像头模块2。最新的摄像头型号是 2023 年发布的 1200 万像素摄像头模块3。树莓派已不再提供最初的 500 万像素设备。
所有这些摄像头都有可见光和红外版本，而摄像头模块3也有标准和广视角两种型号，共有四种不同的变体。
摄像头模块 3（左）和摄像头模块 3 广角（右）
摄像头模块 3 NoIR 普通型和广角型
此外，还分别于 2020年 和 2023年 推出了 1200 万像素的高像素摄像头，配有 CS 或 M12 卡口，可与外置镜头配合使用。HQ 摄像头没有红外版本，但可根据需要拆除红外滤镜。
、
HQ 摄像头，M12 安装（左）和 C/CS 安装（右）
最后是 2023年 发布的全局快门摄像头。GS 摄像头没有红外版本，但可根据需要拆除红外滤镜。
全局快门摄像头
树莓派摄像头模块兼容所有带 CSI 接口的树莓派计算机，即除树莓派400和 2016 年发布的 Zero 版本外的所有型号。
滚动快门还是全局快门？
大多数数码摄像头 (包括我们的摄像头模块) 都使用滚动快门：它们逐行扫描正在捕捉的图像，然后输出结果。您可能已经注意到，这在某些情况下会造成失真效果；如果您曾经拍摄过旋转的螺旋桨叶片，您可能会发现图像在闪烁，而不像是一个正在旋转的物体。螺旋桨叶片有足够的时间在摄像头扫过和观察场景的瞬间改变位置。
全局快门--就像我们的全局快门摄像头模块，它不会这样做。它能一次性捕捉到场景中每个像素的光线，因此您拍摄的螺旋桨叶片不会出现同样的失真。
这有什么用呢？快速移动的物体，比如螺旋桨叶片，现在很容易捕捉；我们还可以同步多台摄像头，在精确的同一时刻拍摄照片。这样做有很多好处，比如在捕捉立体图像时可以最大限度地减少失真。(如果左眼出现的任何动作尚未在右眼出现，人脑就会感到困惑）。树莓派全局快门摄像头的曝光时间也比滚动快门摄像头短，在光线充足的情况下，曝光时间最短可达 30µs，这使它在高速摄影时非常有用。
全局快门摄像头的图像传感器具有 6.3 毫米对角线有效感应区域，与树莓派的 HQ 摄像头大小相似。不过，像素更大，可以收集更多光线。大像素尺寸和低像素数量在机器视觉应用中很有价值；传感器产生的像素越多，实时处理图像的难度就越大。为了解决这个问题，许多应用都会缩小和裁剪图像。使用全局快门摄像头和适当的镜头倍率就不需要这样做了，较低的分辨率和较大的像素尺寸意味着可以原生捕捉图像。
安装树莓派摄像头
摄像头对静电很敏感。在处理 PCB 之前，请先接地。如果没有接地带，水槽水龙头或类似装置就足够了。
连接摄像头
将柔性电缆插入树莓派上标有 CAMERA 的连接器，该连接器位于以太网和 HDMI 端口之间。插入电缆时，银色触点必须朝向 HDMI 端口。要打开连接器，将连接器顶部的卡扣向上拉，然后拉向以太网端口。应将柔性电缆牢固地插入连接器，注意不要将柔性电缆弯曲得太厉害。关闭连接器时，将连接器上部推向 HDMI 端口并向下，同时将软线固定到位。
我们制作了一段视频来说明连接摄像头的过程。以下视频展示了如何在原始 Raspberry Pi 1 上连接原始摄像头。虽然 Raspberry Pi 5 和所有 Raspberry Pi Zero 型号都需要 不同的摄像头连接线，但所有带摄像头连接器的 Raspberry Pi 板的原理都是一样的。
未能嵌入YOUTUBE视频
根据型号的不同，摄像头的镜头上可能会覆盖一小块半透明的蓝色塑料薄膜。这只是为了在邮寄给您的过程中保护镜头，需要轻轻撕掉。
准备软件
在继续之前，我们建议确保您的内核、GPU 固件和应用程序都是最新的。请按照说明保持操作系统为最新版本。
然后，请按照 libcamera 软件栈和 Picamera2 Python 库 的相关设置说明进行设置。
硬件规格
| 摄像头模块v1 | 摄像头模块v2 | 摄像头模块3 | 摄像头模块3广角型 | 高清摄像头 | GS摄像头 | |
|---|---|---|---|---|---|---|
| 净价 | $25 | $25 | $25 | $35 | $50 | $50 |
| 尺寸 | 约 25 × 24 × 9 毫米 | 约 25 × 24 × 24 × 9 毫米 | 约 25 × 24 × 24 × 11.5 毫米 | 约 25 × 24 × 24 × 12.4 毫米 | 38 x 38 x 18.4 毫米(不包括镜头) | 38 x 38 x 19.8 毫米(带适配器和防尘盖时为 29.5 毫米) |
| 重量 | 3g | 3g | 4g | 4g | 30.4g | 34g （带适配器和防尘盖时为 41g） |
| 静态分辨率 | 500 万像素 | 800 万像素 | 1,190 万像素 | 1,190 万像素 | 1,230 万像素 | 158 万像素 |
| 视频模式 | 1080p30、720p60 和 640 × 480p60/90 | 1080p47、1640 × 1232p41 和 640 × 480p206 | 2304 × 1296p56、2304 × 1296p30 HDR、1536 × 864p120 | 2304 × 1296p56，2304 × 1296p30 HDR，1536 × 864p120 | 2028 × 1080p50、2028 × 1520p40 和 1332 × 990p120 | 1456 x 1088p60 |
| 传感器 | OmniVision OV5647 | 索尼 IMX219 | 索尼 IMX708 | 索尼 IMX708 | 索尼 IMX477 | 索尼 IMX296 |
| 传感器分辨率 | 2592 × 1944 像素 | 3280 × 2464 像素 | 4608 x 2592 像素 | 4608 x 2592 像素 | 4056 x 3040 像素 | 1456 x 1088 像素 |
| 传感器图像区域 | 3.76 × 2.74 毫米 | 3.68 x 2.76 毫米（对角线 4.6 毫米） | 6.45 x 3.63 毫米（对角线 7.4 毫米） | 6.45 x 3.63 毫米（对角线 7.4 毫米） | 6.287 毫米 x 4.712 毫米（对角线长 7.9 毫米） | 6.3 毫米对角线 |
| 像素尺寸 | 1.4 微米 × 1.4 微米 | 1.12 微米 x 1.12 微米 | 1.4 微米 x 1.4 微米 | 1.4 微米 x 1.4 微米 | 1.55 微米 x 1.55 微米 | 3.45 微米 x 3.45 微米 |
| 光学尺寸 | 1/4" | 1/4" | 1/2.43" | 1/2.43" | 1/2.3" | 1/2.9" |
| 聚焦 | 固定式 | 可调 | 电动 | 电动 | 可调 | 可调 |
| 景深 | 约 1 米至∞ | 约 10 厘米至 ∞ | 约 10 厘米至 ∞ | 约 5 厘米至 ∞ | 不适用 | 不适用 |
| 焦距 | 3.60 毫米 +/- 0.01 | 3.04 毫米 | 4.74 毫米 | 2.75 毫米 | 取决于镜头 | 取决于镜头 |
| 水平视场角 (FoV) | 53.50 +/- 0.13 度 | 62.2 度 | 66 度 | 102 度 | 取决于镜头 | 取决于镜头 |
| 垂直视场角 (FoV) | 41.41 +/- 0.11 度 | 48.8 度 | 41 度 | 67 度 | 取决于镜头 | 取决于镜头 |
| 焦距比 (F档) | F2.9 | F2.0 | F1.8 | F2.2 | 取决于镜头 | 取决于镜头 |
| 最长曝光时间（秒） | 0.97 | 11.76 | 112 | 112 | 670.74 | 15.5 |
| 镜头安装 | 不适用 | 不适用 | 不适用 | 不适用 | C/CS 或 M12 安装 | C/CS |
| 是否提供 NoIR 版本？ | 是 | 是 | 是 | 是 | 否 | 否 |
有证据表明，摄像头模块3可能会以 CSI 时钟频率的谐波发射射频干扰。这种射频干扰的范围会干扰 GPS L1 频率（1575 MHz）。请参阅 Github 上的主题，了解详细信息和建议的解决方法。
机械图纸
可用的机械图纸；
- 摄像头模块 2 PDF
- 摄像头模块 3 PDF
- 宽幅摄像头模块 3 PDF
- 摄像头模块 3 STEP
- HQ 摄像头模块（CS 安装版）PDF
- CS 卡口 PDF
- HQ 摄像头模块（M12 安装版）PDF
- GS 摄像头模块 PDF
摄像头模块3的电路板尺寸和安装孔位置与摄像头模块2相同。但是，由于传感器模块的尺寸和位置发生了变化，它与树莓派Zero外壳的摄像头盖在机械上不兼容。
示意图
树莓派 CSI 摄像头连接器示意图。
其他可用示意图；
摄像头滤镜
某些传输特性适用于摄像头模块3 以及 HQ 和 GS 摄像头。
这些图表以 PDF 格式提供。
摄像头模块3
摄像头模块3 以 IMX708 为核心，其光谱灵敏度特性如下。
HQ摄像头
不带红外滤镜的树莓派 HQ 摄像头。
GS摄像头
树莓派 GS 摄像头，不带红外截止滤镜。
HQ和GS摄像头
HQ 和 GS 摄像头使用 Hoya CM500 红外滤镜。其传输特性如下图所示。
滤镜拆卸
此步骤适用于 HQ 和 GS 摄像头。
此步骤不能反过来进行：固定滤镜的粘合剂无法承受抬起和更换，而且红外滤镜的厚度约为 1.1 毫米，取下时可能会破裂。取下滤镜将导致产品保修失效。尽管如此，有些用户还是希望取下滤镜。
高品质摄像头和全局快门摄像头都包含一个红外滤光镜，用于降低摄像头对红外光的敏感度。这可以确保户外照片看起来更加自然。不过，去掉红外滤光镜后，某些自然景物的拍摄效果会更好；去掉红外滤光镜后，天空、植物和水的颜色都会受到影响。在没有滤光镜的情况下，也可以在有红外光照射的地方使用摄像头进行夜视。
在继续操作之前，请仔细阅读所有步骤，并决定是否愿意使保修失效。除非您确定愿意取消保修，否则请勿继续操作。
拆卸滤镜
- 在清洁无尘的环境中工作，因为传感器将暴露在空气中。
- 拧下主电路板底部的两个 1.5 毫米六角锁匙。小心不要让垫圈滚落。外壳和电路板之间有一个略带粘性的垫圈，需要用一些力才能将其分开。
- 提起电路板，将其放在非常干净的表面上。确保传感器不接触表面。
- 您可以尝试一些削弱粘合剂的方法，例如使用少量异丙醇和/或加热（~20-30℃）。
- 将镜头座转过来，使其 "朝上看"，然后放在桌子上。
- 使用笔杆或类似的软塑料物品，仅在玻璃与铝材连接的最边缘向下按压滤光镜，以尽量减少弄破滤光镜的风险。胶水会断裂，滤镜就会从镜头支架上脱落。
- 鉴于更换镜头会暴露传感器，此时可以粘贴一个透明滤镜（例如 OHP 塑料），以尽量减少灰尘进入传感器腔的机会。
- 更换电路板上的主外壳。确保将外壳与电路板上的垫圈重新对齐。
- 尼龙垫圈可防止损坏电路板；请先使用该垫圈。然后装上钢垫圈，以防止损坏尼龙垫圈。
- 拧下两个六角锁匙。只要垫圈安装顺序正确，就不需要拧得很紧。
要将滤镜粘回原位并使设备恢复正常光学照摄像头功能可能会很困难，甚至不可能。
推荐镜头
建议将以下镜头与我们的 HQ 和 GS 摄像头配合使用。
HQ 摄像头有 C/CS 卡口和 M12 卡口两种型号，而 GS 摄像 头只有 C/CS 卡口。
C/CS 镜头
我们推荐使用两个镜头，一个 6 毫米广角镜头和一个 16 毫米长焦镜头。这些镜头可从最近的授权经销商处购买。
| 16 毫米长焦镜头 | 6 毫米广角镜头 | ||
| 分辨率 | 1000 万像素 | 300 万像素 | |
| 图像格式 | 1" | 1/2" | |
| 光圈 | F1.4 至 F16 | F1.2 | |
| 安装 | C | CS | |
| 视场角 H°×V° (D°) | HQ | 22.2°×16.7° (27.8°) | 55°×45° (71°) |
| GS | 17.8°×13.4° (22.3) | 45°×34° (56°) | |
| 背面焦距 | 17.53 毫米 | 7.53 毫米 | |
| 外径 | 0.2m | 0.2m | |
| 尺寸 | φ39.00×50.00毫米 | φ30×34毫米 | |
M12镜头
我们推荐三种由高佳光学制造的镜片。这些镜片可从离您最近的授权经销商处购买。
| 8 毫米 | 25 毫米 | 鱼眼 | |
| 分辨率 | 1200 万像素 | 500 万像素 | 1500 万像素 |
| 图像格式 | 1/1.7" | 1/2" | 1/2.3" |
| 光圈 | F1.8 | F2.4 | F2.5 |
| 安装 | M12 | ||
| HQ 视场角 H°×V° (D°) | 49°×36° (62°) | 14.4°×10.9° (17.9)° | 140°×102.6° (184.6°) |
同步捕捉
HQ 摄像头和全局快门摄像头均支持同步捕捉。利用 XVS 引脚（垂直同步），一台摄像头可以在开始帧捕捉时发出脉冲。然后，另一台摄像头可以监听该同步脉冲，并与另一台摄像头同时捕捉帧。
使用HQ摄像头
为了正确操作，两台摄像头的 XVS 线路都需要 1.65V 的上拉电压，该电压通过树莓派上的 3.3V 和 GND 引脚的电位分配器产生。
从两个 10kΩ 电阻器上创建一个电位分压器，分别连接到 3.3V 和地（使电压达到 1.65V，有效源阻抗为 5kΩ）。这可以连接到任意一台 Raspberry Pi。
将每块 HQ 摄像头电路板的接地和 XVS 测试点相互焊接。
将 XVS 线连接到 1.65V 电位分压器上拉电阻。
启动两个树莓派
文件 /sys/module/imx477/parameters/trigger_mode 决定哪块板输出脉冲或等待接收脉冲（源和"汇"）。该参数只能在超级用户模式下更改。
运行以下命令配置"汇"：
sudo su
echo 2 > /sys/module/imx477/parameters/trigger_mode
exit
运行以下命令配源：
sudo su
echo 1 > /sys/module/imx477/parameters/trigger_mode
exit
运行以下命令启动"汇"：
rpicam-vid --frames 300 --qt-preview -o sink.h264
运行以下启动配源：
rpicam-vid --frames 300 --qt-preview -o source.h264
帧应同步。使用 --frames 可确保捕捉到的帧数相同，且录制长度完全相同。先运行汇集器可确保不遗漏任何帧。
当信号源处于空闲状态时，需要使用电位分配器将 XVS 引脚拉高。这可确保启动时不会创建或丢失帧。信号源在初始化时从低电平变为高电平，可能会触发误帧。
使用GS摄像头
全局快门 (GS) 摄像头也可以在同步模式下操作。但是，源摄像头将多记录一帧。要确保两台摄像头拍摄相同的帧数，更好的替代方法是使用外部触发方法。
全局快门摄像头还需要将 XHS（水平同步）引脚连接在一起，才能作为源和"从"一起工作。不过，这些引脚不需要连接上拉电阻器。
接线设置与 HQ摄像头 的方法相同，只是您还需要将 XHS 引脚连接在一起。
从两个 10kΩ 电阻器上创建一个电位分压器，分别连接到 3.3V 和地（使电压达到 1.65V，有效源阻抗为 5kΩ）。这可以连接到任意一台 Raspberry Pi。
将 2 根导线焊接到每块电路板上的 XVS 测试点，然后将这 2 根导线一起连接到 1.65V 电位分压器。
将每块摄像头板的 GND 焊接在一起。同时将 2 根导线焊接到每块电路板上的 XHS 测试点，并将其连接起来。XHS 引脚无需上拉。
在希望用作"汇流排"的电路板上，将 MAS 焊盘的两半焊接在一起。这将告知传感器充当"汇"，并等待信号以捕获帧。
启动源与汇
运行以下命令配置"汇"：
rpicam-vid --frames 300 -o sync.h264
由于 IMX296 传感器的限制，汇接收器无法记录与源完全相同的帧数。在汇接收器开始记录之前， 源会多记录一帧。因此，需要使用 --frames 选项指定水槽少记录一帧。
在启动源之前至少等待两秒钟。
等待两秒后，运行以下命令启动源：
rpicam-vid --frames 299 -o sync.h264
由于汇和源录制的帧数不同，请使用 ffmpeg 重新同步视频。去掉源视频的第一帧后，我们就能得到两段起点和帧长相同的视频：
ffmpeg -i source.h264 -vf select="gte(n\, 1)" source.h264
GS摄像头上的外部触发器
全局快门（GS）摄像头可通过电路板上的外部触发器（在电路板上表示为 XTR）连接进行外部触发。同一脉冲可连接多台摄像头，这也是同步两台摄像头的另一种方法。
曝光时间等于低脉冲宽度时间加上 14.26us 的额外时间，即 10000us 的低脉冲导致 10014.26us 的曝光时间。帧频直接受控于对引脚的脉冲频率。PWM 频率为 30Hz 时，帧频为每秒 30 帧。
准备工作
本修改包括拆除 SMD 焊接部件。除非您认为自己有能力完成此改装，否则不应尝试。焊接到摄像头电路板时，请取下塑料后盖，以免损坏电路板。
如果电路板上安装了晶体管 Q2（如下图中蓝色所示），则需要从电路板上拆下 R11（如下图中红色所示）。它将 GP1 连接到 XTR，如果不取下 R11，摄像头将无法在外部触发模式下工作。元件位置如下所示。
接下来，将一根导线焊接到 GS 摄像头电路板上的 XTR 和 GND 连接点上。请注意，XTR 是 1.8V 输入电压，因此可能需要电平转换器或电位分配器。
我们可以使用树莓派Pico来提供触发器。通过 1.5kΩ 电阻器将任何 Pico GPIO 引脚（本例中使用 GP28）连接至 XTR。同时在 XTR 和 GND 之间连接一个 1.8kΩ 电阻器，以将高逻辑电平降至 1.8V。接线图如下所示。
启动连接了摄像头的树莓派
通过超级用户模式启用外部触发：
sudo su
echo 1 > /sys/module/imx296/parameters/trigger_mode
exit
树莓派Pico Micropython代码
from machine import Pin, PWM
from time import sleep
pwm = PWM(Pin(28))
framerate = 30
shutter = 6000 # In microseconds
frame_length = 1000000 / framerate
pwm.freq(framerate)
pwm.duty_u16(int((1 - (shutter - 14) / frame_length) * 65535))
低脉冲宽度等于快门时间，PWM 频率等于帧频。
在本示例中，引脚 28 用于连接 GS 摄像头板上的 XTR 触摸点。
操作
在 Pico 上运行代码并设置摄像头运行：
rpicam-hello -t 0 --qt-preview --shutter 3000
Pico 每脉冲一次该引脚，就会产生一个帧。要控制帧频，可改变脉冲之间的持续时间。
运行 rpicam-apps 时，请始终指定一个固定的快门持续时间，以确保 AGC 不会调整相机的快门速度。持续时间并不重要，因为它实际上是由外部触发脉冲控制的。
中文翻译版以英文版相同知识授权方式共享：CC-BY-SA 4.0。交流 Q群：498908352