移远 Quectel Pi M2 官方文档 · 7 处实测勘误
立场先说清楚:这 7 处与本机(Quectel Pi M2,RK3576)实测表现对不上,或同一份文档内部前后表述不一致。 我把这些整理出来,是给同行做一个参考,方便大家按自己的板子实际状态判断哪条能直接用、哪条要改。 如认为是我的理解有误,欢迎在评论区指正,我随时改。
全部结论来自实机测量:IMX219 模组、Debian、内核 6.1.118-rt36,出厂配置未刷机。
一览表
| # | 文档位置 | 文档写法 | 本板实测 |
|---|---|---|---|
| ① | 应用开发 → GPIOD 使用说明 | 示例输出里 gpiochip1 名为 [1c40000.qcom,spmi:qcom,pm6125@0] |
本板 gpiochip0~5,无 qcom/spmi/pm6125 字样 |
| ② | FAQ → 外设问题 | 让你执行 systemctl status cam-server |
本板无 cam-server,实际服务名 rkaiq_3A |
| ③ | 使用指南 → 摄像头 → MIPI 摄像头 | 示例用 width=1640,height=1232(30 FPS) |
本板协商失败(not-negotiated),可用上限 1920×1080 |
| ④ | 同上(同一页前后两句) | 前句「以 imx 219 接入 camera1 为例」→ 命令却用 /dev/video33;后句又写「video33 代表第一个 CSI 卡槽(camera0)」 |
本板 /dev/video51 = camera1 = 唯一在用;/dev/video33 = camera0,无传感器绑定 |
| ⑤ | 使用指南 → 规格介绍 | 同一格里先写「四核 ARM Cortex-A72 + 四核 ARM Cortex-A53」,下一行又写 4 × A73 @ 2.2 GHz |
RK3576 无 A73 核,实为 4×A72 + 4×A53 |
| ⑥ | 规格介绍 ↔ 电源供给 | 规格页:至少 15 W (5V / 3A);电源页:适配器具备 5 V / 5 A 以上能力 |
两页互相矛盾,需按更高者(5V/5A)准备 |
| ⑦ | 支持清单 | 「编译工具 gcc/clang」标注 √(已预装) |
本板未预装 gcc / make,需 apt install |
① GPIOD 页示例输出用了高通平台 PMIC 的 gpiochip 名
示例输出里 gpiochip1 [1c40000.qcom,spmi:qcom,pm6125@0] —— pm6125 是高通平台的 PMIC 型号。本板实测只有 gpiochip0~5,推断该示例沿用了同厂高通平台 H1 的输出。
② FAQ 让查 cam-server,本板没有这个服务
出处:FAQ → 外设问题
本板执行 systemctl status cam-server 提示无此单元;实际 3A 服务是 rkaiq_3A。注意:3A 不能停,停掉画面会直接塌(实测均值 12.9)。
③ 摄像头示例 1640×1232,实测协商失败
本板 /dev/video51 按 1640×1232 协商返回 not-negotiated,可用上限为 1920×1080。多段示例(预览 / 录制 / 拍照)都用了这个分辨率。
④ 同一页前后矛盾:说「camera1 为例」却用 video33
出处:使用指南 → 摄像头 → MIPI 摄像头(预览小节)
前一句写「这里以 imx 219 接入 camera1 为例」。
紧跟其后的命令,设备节点却是 device=/dev/video33(红框处)。
同一页下一句又写「video33 代表第一个 CSI 卡槽(camera0),video51 代表第二个 CSI 卡槽(camera1)」,与上一句的示例直接冲突。
⑤ 规格页写 4×A73@2.2GHz,RK3576 没有 A73
出处:使用指南 → 规格介绍
同一格内三行自相矛盾:第一行「四核 ARM Cortex-A72 + 四核 ARM Cortex-A53」,第二行却写 4 × A73 @ 2.2 GHz。RK3576 的 CPU 是 4×A72 + 4×A53,没有 A73。
⑥ 供电规格两页矛盾
规格页:USB Type-C 供电,推荐使用至少提供 15 W(5V / 3A) 功率适配器。
电源页:资料要求适配器具备 5 V / 5 A 以上能力。同一份文档给出两个相差很大的口径。
⑦ 支持清单标 gcc/clang 已预装,实际没有
出处:支持清单
「编译工具 gcc/clang」一栏打了 √,但本板实测 gcc / make 均未安装,需自行 apt install(内核头文件 /usr/src/linux-headers-6.1-rockchip 倒是预装好了)。
截图均取自 docs.quectel.com 官方文档站,红框为本次实测校核标注。
整理者:Quectel Pi M2 体验官投稿 · 环境:Quectel Pi M2 (RK3576) + IMX219 · Debian · kernel 6.1.118-rt36
所有结论欢迎指正与补充。








