Debian 与 Ubuntu 镜像差异
M5-R2A 提供 Debian 12 和 Ubuntu 22.04 两种 Linux 镜像，内核同为 Linux 6.1.141，硬件功能一致。Linux 系统各章节的内容对两种镜像通用，本篇只说明两者的差异；操作时遇到登录提示符或命令输出对不上，先对照本篇确认自己用的是哪个镜像。
1. 支持的镜像
| 镜像 | 内核 | 适用场景 |
|---|---|---|
| Debian 12 (bookworm) | 6.1.141 | 出厂默认镜像 |
| Ubuntu 22.04.4 LTS (jammy) | 6.1.141 | 需要 Ubuntu 生态（ROS 2 Humble、snap 等）时选用 |
2. 确认当前运行的镜像
cat /etc/os-release | grep PRETTY
hostnameDebian 镜像输出：
PRETTY_NAME="Debian GNU/Linux 12 (bookworm)"
linaro-alipUbuntu 镜像输出：
PRETTY_NAME="Ubuntu 22.04.4 LTS"
RK35883. 登录账户差异
| 项目 | Debian 12 镜像 | Ubuntu 22.04 镜像 |
|---|---|---|
| 主机名 | linaro-alip | RK3588 |
| 默认账户 | linaro | root |
| 默认密码 | linaro | 123456 |
串口登录提示符对照：
# Debian 镜像
linaro-alip login: linaro
# 密码 linaro
# Ubuntu 镜像
RK3588 login: root
# 密码 123456SSH 登录使用同样的账户和密码。首次登录后建议用
passwd修改默认密码。
4. 软件源差异
Debian 镜像使用 Debian 官方源，Ubuntu 镜像默认配置为阿里云 ubuntu-ports 源并启用全部四个仓库：
# Ubuntu 镜像 /etc/apt/sources.list（默认已配置）
deb https://mirrors.aliyun.com/ubuntu-ports/ jammy main restricted universe multiverse
deb https://mirrors.aliyun.com/ubuntu-ports/ jammy-security main restricted universe multiverse
deb https://mirrors.aliyun.com/ubuntu-ports/ jammy-updates main restricted universe multiverse两系统的包管理命令（apt update、apt install 等）完全一致，见软件包管理与更新。Ubuntu 镜像另预置了一个多媒体 PPA 源（george-coolpi/multimedia），提供播放器相关软件包。
5. 工具链版本差异
| 工具 | Debian 12 镜像 | Ubuntu 22.04 镜像 |
|---|---|---|
| gcc | 12.2.0 | 11.4.0 |
| Python 3 | 3.11 | 3.10.12 |
编译第三方源码对工具链版本有要求时，先按上表确认。两个镜像都可以通过 apt 安装其他版本的工具链。
NPU 软件栈（librknnrt、rknnlite）两个镜像的安装方式一致：rknnlite 均需手动安装，安装流程见 RKNN Toolkit2 安装与使用。注意 RKNN 模型对运行时版本有要求，转模型用的 Toolkit 版本要和板上的 librknnrt 匹配。
6. 网卡命名与设备差异
网卡接口名（影响网络配置相关章节，两镜像命名规则不同）：
| 镜像 | 千兆网口（GMAC） | 其他接口 |
|---|---|---|
| Debian 12 | end1（systemd 可预测命名） | enP2p33s0 |
| Ubuntu 22.04 | eth0（传统命名，千兆在用） | eth1 |
网络相关章节的示例以 Debian 镜像的 end1 为准，Ubuntu 镜像上替换为 eth0 即可。
设备节点与预装软件：
| 项目 | Debian 12 镜像 | Ubuntu 22.04 镜像 |
|---|---|---|
| GPIO 控制器节点 | 5 个 gpiochip | 7 个 gpiochip（含 GPIO2/GPIO3 对应的 gpiochip64/96） |
| I2C 适配器 | i2c-0/1/3/5/6/7 | i2c-0/1/3/5/6/7/9（i2c-9 为 HDMI DDC） |
| PWM 节点 | pwmchip0/1/2 | pwmchip0/1/2/3 |
| Docker | 需自行安装 | 已预装（Docker 26）并开机自启 |
| WiFi | 默认未装配模块 | 整板若装配 WiFi 模块则有 wlan0（Broadcom SDIO） |
ADC、CAN、音频声卡（rockchipes8388 / rockchiphdmi1）、DRM 节点、ttyS9、thermal、存储分区等内核层输出两镜像一致。
7. 其余章节的通用性
以下内容与发行版无关，两种镜像按同一份文档操作：
- 系统烧录、调试串口、ADB、网络配置（快速上手章节）
- SDK 编译、内核裁剪、设备树（系统开发章节）
- 外设驱动（GPIO/I2C/SPI/UART 等读写路径一致）
- NPU 推理（librknnrt、RKNN Toolkit2 板端用法一致）
- 多媒体、性能调优、调试工具
个别命令输出中包含发行版信息（如 gcc --version 显示的发行版后缀、/etc/os-release 内容），以实际镜像为准，不影响操作结果。