跳转至

外设接口

  • 前提注意：不同板型的接口数量/位置/规格存在差异，使用前请先查看对应板卡 规格书 / 快速入门文档，并核对主板丝印标识

  • 排查原则：所有排线（FPC）与插针的插拔必须在主板断电状态下进行，带电插拔可能损坏接口或外设！！！

接口详解与使用方法

显示接口（MIPI DSI / LVDS / Dual LVDS / eDP）

  • MIPI DSI：FPC 排线座，30Pin、间距 0.5mm、4 Lane

  • LVDS：与 MIPI 共用同一个接口，FPC 排线座， 30Pin、0.5mm

  • Dual LVDS：独立连接器，30Pin（2x15）、间距 2.0mm

  • eDP：FPC 排线座，30Pin、间距 0.5mm、2 Lane，最高 2560x1600

摄像头接口（MIPI CSI）

  • FPC 排线座，22Pin / 40Pin，0.5mm间距，4 Lane（部分板型可拆分为 2 Lane x2）

  • 插拔前断电，摄像头 FPC 对准金手指方向插入并锁紧翻盖

  • 摄像头接线以及测试方法参考维基文档功能测试部分

风扇接口

  • 风扇 FAN：MX1.25 2Pin（间距 1.25mm），5V 供电，5V 风扇对插即可，上电默认开启；K1B/K2B/K3B/K4B/K10B 无风扇接口

  • 软件控制：瑞芯微 echo 1 > /sys/class/leds/fan/brightness（0 关闭）；全志 echo 255 > /sys/class/leds/fan_en/brightness（0 关闭）

  • 获取 CPU 温度 cat /sys/class/thermal/thermal_zone*/temp 可实现通过温度控制开关风扇状态

RTC、喇叭、MIC 接口

  • RTC：MX1.25 2Pin（间距 1.25mm），外接纽扣电池（3.3V），断电后为板载 RTC（如 HYM8563）供电保持时间

  • 喇叭 SPK：MX1.25 2Pin（间距 1.25mm），接 4~8Ω 无源喇叭；多喇叭板型区分左右声道

  • 麦克风 MIC：部分主板为板载 MIC，其余为 MX1.25 2Pin 外接麦克风座（间距 1.25mm）

扩展引脚

  • 规格：标准 2.54mm 间距双排排针，20Pin / 30Pin / 40Pin，提供 3.3V/5V/GND 电源脚 + 多路 GPIO，可复用为 UART/SPI/PWM/ADC/I2C/I3C/CAN/PDM/I2S

  • 使用方法：杜邦线连接外部模块（传感器/继电器/串口设备等）；复用功能需在 SDK/设备树配置后生效，默认多为普通 GPIO

  • 注意事项：严禁 5V 直入，扩展引脚电压有3.3V/1.8V，具体请查看维基文档外设接口部分

电源接口

  • DC 12V 圆头插座：直流圆头插头，外径 5.5mm × 内径 2.1mm、内正外负，适配器电流建议不低于 2A**

  • TYPE-C 5V：常规 5V/3A 充电头即可，电脑 USB 口供电通常带不动主板

  • POE：需 802.3af/at 标准 PoE 交换机/供电器 + 8 芯全通网线（K5C 等支持）

  • 电池：K3B/K5C/K10B 支持锂电池供电，具体供电参数参考主板规格书

调试串口

  • 规格：PH2.54 3Pin（间距 2.54mm），含 GND/TX/RX（引脚顺序以丝印为准）

  • 使用方法：USB 转 TTL 模块连接（GND-GND、板TX-模块RX、板RX-模块TX）；波特率：瑞芯微 1500000，全志 115200

  • 注意事项：TX/RX 接反无输出，对调即可；串口模块需先装好驱动（Windows通常自带CH341驱动）

USB / TYPE-C 接口

  • USB HOST（TYPE-A）：USB3.0 口为蓝色（5Gbps）、USB2.0 口为黑色（480Mbps），接 U 盘/键鼠/4G 模块/USB 摄像头等

  • USB OTG（TYPE-C / TYPE-A）：用于 烧录系统 和 ADB 调试（K9 的 OTG 为 TYPE-A 口）

  • TYPE-C 扩展功能：K7/K8 的 TYPE-C 支持 DP 视频输出；K1B/K2B/K3B/K4B/K7C/K8D/K10B 的 TYPE-C 兼作 5V 供电口

  • USB 扩展排针：PH2.0 4Pin（间距 2.0mm），按丝印 V+/D-/D+/GND 接线引出 USB 口

  • 注意事项：USB 扩展座取电能力有限，大功率设备使用带独立供电的 USB HUB

音频接口

  • 耳机：四段式 3.5mm 耳机座；部分板型仅支持音频输出，部分支持音频输入输出（以规格书为准）

  • 使用方法：直接插入耳机；耳机与喇叭共用音频流，喇叭测试需在系统声卡设置中打开对应输出通路

电池接口

  • K3B：适配锂电池电压 3.7~4.2V，，最大充电电流 2A（恒流）；官方默认镜像未启用电池相关功能，不支持快充与 NTC 检测

  • K5C：适配锂电池电压 3.7~4.2V，支持 BAT 供电（需要主板硬件版本 V1.2 及以上），最大充电电流上限为 2A

  • K10B：适配锂电池电压 3.8~4.6V，最大充电电流上限为 3A。电源切换端子跳帽：电池模式短接靠近扩展引脚一侧，如用TYPE-C 供电则短接靠近螺丝孔一侧

  • 注意事项：接入时确认正负极方向（接口旁通常标有丝印），插拔电池线前断电

Q&A

Q1: 上电风扇不转？

  • 主板蓝灯是否闪烁，上电后风扇默认开启，内核正常启动后风扇才会转动，如果不闪说明系统异常

  • 确认接线是否松动，用万用表测量风扇接口是否有5V电压，如果没有，说明板子硬件问题

  • 执行 cat /sys/class/leds/fan/brightness 命令查看，如果值为0，说明风扇是关闭状态

  • 确认以上验证都正常，如问题仍存在，烧录我们网盘最新镜像再测试，不行则大概率风扇硬件问题

Q2: 调试串口无输出？

  • 确认接的是 DEBUG 串口（PH2.54 3Pin），不是 GPIO 排针上的普通 UART

  • 接线：GND 共地、板 TX→模块 RX、板 RX→模块 TX（TX/RX 交叉），接反则对调，引脚旁通常有丝印标注

  • 串口参数：波特率瑞芯微 1500000、全志 115200

  • 确认使用的是 USB 转 TTL（3.3V 电平）模块，不能用 RS232/RS485 电平模块直连

  • 换一根杜邦线/模块交叉验证；部分模块带 3.3V/5V 输出跳线，请拨到 3.3V

Q3: USB 设备识别不到？

  • 更换 USB 线 / USB 口测试；USB3.0 设备建议插蓝色 USB3.0 口（部分板型 USB3.0 与 USB2.0 口分开），线尽量短而粗

  • 大功率设备（移动硬盘等）请使用带独立供电的 USB HUB，USB 口供电能力有限

  • 系统侧确认是否枚举成功：lsusb 查看设备列表、dmesg | tail 查看内核日志，有报错先换线再查驱动/镜像

  • 扩展排针引出的 USB 口需确认 V+/D-/D+/GND 接线正确，杜邦线过长/接触不良也会导致识别不到

Q4: K8 (RK3588) 单 MIPI 摄像头画面显示暗？

  • 默认镜像配置为双 MIPI 摄像头，单 MIPI 摄像头时 ISP 加载异常，画面偏暗；如需使用单 MIPI 摄像头，需要在设备树中注释对应摄像头节点，参考：wiki/Peripherals-and-Interfaces/Camera.md 重新编译 SDK 生成单摄像头镜像

  • K8 默认设备树配置了双 MIPI CSI 通道（csi2_dphy0 和 csi2_dphy1），ISP（图像信号处理器）预期接收两路输入。单路摄像头时 ISP 的 AEC/AGC 算法对异常通道的数据处理异常，导致画面曝光不足偏暗

  • 编辑 kernel-6.1/arch/arm64/boot/dts/rockchip/rk3588-kickpi-k8.dtsi，注释掉未接摄像头对应的 &csi2_dphy1 节点及关联的 &i2c7 等节点，重新编译 boot 分区烧录即可

  • 修改后使用 v4l2-ctl --list-devices 查看摄像头设备应只显示一个节点；用 gst-launch-1.0 v4l2src device=/dev/video0 ! videoconvert ! fbdevsink 测试画面亮度和清晰度

Q5: I2C 设备无法通信？

  • 用 i2cdetect -l 列出系统 I2C 总线，i2cdetect -y <bus_num> 扫描设备地址确认硬件连接是否正确

  • 确认 I2C 设备上拉电阻已焊接（部分主板需外接 4.7kΩ 上拉）；测量 SCL/SDA 信号电平是否正常（3.3V）

  • I2C 总线上每个设备需要唯一地址，使用 i2cdetect -y <bus> 查看总线上所有占用地址，如果预期设备地址未出现（显示为 --），说明设备未正常响应

  • 用示波器测量 SCL 和 SDA 引脚的信号波形，正常的 I2C 信号上升沿应干净无毛刺；方波幅度应接近 3.3V（低电平接近 0V）；上拉电阻过大会导致信号上升沿变缓影响通讯

Q6: AW 平台 USB 转串口模块 与 4G 模块设备号冲突？

  • CH34X 先注册 ttyUSB0，4G 后注册 ttyUSB1~3。解决方法：上电后再插 USB 串口，或修改拨号脚本设备号

  • USB 转串口芯片（CH340/CH341）和 4G 模块都使用 USB 转串口驱动，系统按枚举先后顺序分配 ttyUSB 设备号，导致之前配置好的设备号对应出错

  • 先断开 USB 串口 → 主板完全上电启动 → 等待 4G 模块注册完成（约 30 秒） → 再插入 USB 转串口模块，此时 CH34X 会被分配在最后

  • 或者在 /etc/udev/rules.d/ 下创建规则文件，根据 USB 设备的 VID/PID 创建固定软链接，如 SUBSYSTEM=="tty", ATTRS{idVendor}=="1a86", ATTRS{idProduct}=="7523", SYMLINK+="ttyCH340"，使设备号不受顺序影响