硬件安装与验证

整体框图

RK3588 / RK3576 主控板           RK182X (PCIe AI 协处理器)
───────────────────────           ───────────────────────
PCIe/M.2 插槽  ◄────────────►     无应用 CPU
供电（独立）  ◄─────────────────► 独立供电线
       │
       ▼
  Debian 12 aarch64
  /dev/pcie-rkep-<BDF>
  rknn3.service / rknn3_transfer_proxy

1. 前置条件

  • RK3588 / RK3576 主控开发板 + RK182X AI 协处理器
  • 系统已启动（Debian 12 bookworm / aarch64）

2. 登录主控

三种方式任选一种。

方式一：HDMI + 键鼠（最简单）

接显示器 + USB 键鼠，开机打开终端即可。

方式二：ADB 连接（USB）

USB 数据线连电脑到开发板 OTG 口：

adb shell

默认用户 linaro。

ADB 连接

方式三：SSH 远程登录（推荐）

1. 看开发板 IP

在开发板上执行（接显示器或查路由器后台）：

ip a | grep inet

找同网段的 IP，例如 192.168.1.100。

没有显示器可以去路由器后台找主机名 linaro 的设备。

2. SSH 登录

电脑端执行：

ssh linaro@<开发板IP>

默认用户名 linaro，密码 linaro。

SSH 登录

首次连接提示是否信任主机，输入 yes。

3. 验证

whoami        # 应输出 linaro
uname -a      # 确认系统为 aarch64 / Debian

3. 验证硬件识别

看 PCIe 设备

lspci | grep Rockchip

预期输出：

0004:41:00.0 Processing accelerators: Rockchip Electronics Co., Ltd. Device 182a

注意：

  • 设备 ID 通常显示为 182a（1828 芯片在 PCIe 端的设备 ID），属正常现象
  • BDF 地址（如 0004:41:00.0）因主板 PCIe 拓扑而异，看到 Rockchip 的 Processing accelerators 字样即正常

一键健康检查

cat <<'EOF' > /tmp/check_1828.sh
#!/bin/bash
echo "=== RK1828 健康检查 ==="
# 自动探测 BDF（实际 BDF 因主板 PCIe 拓扑而异，如 0004:41:00.0）
bdf=$(ls /dev/pcie-rkep-* 2>/dev/null | head -1 | sed 's|/dev/pcie-rkep-||')
[ -n "$bdf" ] && echo "✅ 设备节点 OK (${bdf})" || echo "❌ 设备节点缺失"
systemctl is-active rknn3.service >/dev/null && echo "✅ 服务运行中" || echo "❌ 服务未运行"
# 进程名可能带 hash 后缀（如 rknn3_transfer_proxy_c36211b1），也可能无后缀，故放宽匹配
npu_pid=$(pgrep -f rknn3_transfer_proxy | head -1)
if [ -n "$npu_pid" ]; then
    echo "✅ 代理进程 PID=$npu_pid, CPU=$(ps -p $npu_pid -o pcpu= | tr -d ' ')%"
else
    echo "❌ 代理进程不在"
fi
/usr/bin/pcie_upgrade_tool ld 2>&1 | grep -q 182a && echo "✅ PCIe 链路正常" || echo "❌ PCIe 链路异常"
EOF
chmod +x /tmp/check_1828.sh && /tmp/check_1828.sh

预期输出：

=== RK1828 健康检查 ===
✅ 设备节点 OK (0004:41:00.0)
✅ 服务运行中
✅ 代理进程 PID=1952, CPU=25%
✅ PCIe 链路正常

脚本会逐项检查 4 件事：

  • /dev/pcie-rkep-* 设备节点是否存在
  • rknn3.service 服务是否 active
  • rknn3_transfer_proxy 代理进程是否在跑
  • pcie_upgrade_tool ld 链路是否能识别到 182a

4. 常见问题

现象原因处理
lspci 没看到 Rockchip卡没插紧 / 供电不足 / 插槽模式错重插 + 检查供电 + dmesg | grep -iE 'pcie|pcie-rkep|182a|fw_load'
设备节点缺失（/dev/pcie-rkep-*）PCIe 未枚举重启主控或 sudo modprobe pcie_rkep
rknn3.service 不在 activesystemd 服务异常sudo systemctl restart rknn3.service
代理进程 rknn3_transfer_proxy 不在运行时没起来sudo systemctl restart rknn3.service
代理进程 CPU 占用异常高推理任务卡死rmmod pcie_rkep && modprobe pcie_rkep && systemctl restart rknn3.service
推理任务失败驱动异常同上 + dmesg 看 PCIe 错误

5. 下一步