2.3.3 通过串口接入
串口接入是板端无法 SSH 时的救火方式：通过 UART 直接读取板端 console，可以查看 boot 日志、登录板端 shell、调试 U-Boot 与内核启动。串口接入仅提供终端能力，不支持文件传输、远程桌面、远程 IDE。
适 用场景
| 场景 | 串口能解决 |
|---|---|
| 板烧坏了，启动卡 logo | 读取 boot 日志定位问题 |
| 配错网络后 SSH 无法连接 | 进入 console 改回正确配置 |
| 需要查看 dmesg 或内核日志 | 完整的内核输出 |
| 调试 U-Boot 或内核启动 | 唯一可用方式 |
| 需要传输文件、查看桌面、远程 IDE | 串口不支持，需要再用 SSH 接入 |
第 1 步：接线
不同板型的串口位置和默认波特率不同（三者不一致，务必按板型填写，否则会看到一屏乱码）：
| 板型 | 串口位置 | 默认波特率 |
|---|---|---|
| RDK X3 | 40-pin GPIO 上的 UART2 | 921600 |
| RDK X5 | 板载 micro-USB 调试口（自带 USB-UART 桥） | 115200 |
| RDK S100 | 板载 USB-UART（Type-C 调试口 J16） | 921600 |
所有板型均为
8N1/ 无流控。
RDK X5 与 RDK S100 自带 USB-UART 桥，直接用 USB 数据线连接 PC 即可。RDK X3 需要 USB 转 TTL 模块，将模块的 RX / TX 与板端 UART 引脚交叉连接。
第 2 步：在 Studio 中选择串口接入
打开桌面客户端，点击顶部 添加设备，在弹窗中选择 USB 串口调试。填写以下字段：
| 字段 | 默认值 | 说明 |
|---|---|---|
| 串口设备 | （Studio 自动列出） | macOS 通常为 /dev/tty.usbserial-XXXX；Linux 通常为 /dev/ttyUSB0；Windows 通常为 COM3 等 |
| 波特率 | 115200 | Studio UI 默认；RDK X3 与 RDK S100 请切换到 921600 |
| 数据位 / 校验 / 停止位 | 8 / N / 1 | 标准串口配置 |
第 3 步：连接
点击 连接。终端会立刻显示板端 console：如果板正在运行，看到 shell 提示符；如果板正在启动，看到 boot 日志。
常见串口问题
| 现象 | 可能原因 | 解决方法 |
|---|---|---|
| 串口设备列表为空 | 驱动未安装或线未插好 | macOS 与 Linux 通常免驱；Windows 安装 CH340 / FTDI 驱动 |
| 接上后满屏乱码 | 波特率不匹配 | 按板型：X3/S100 用 921600，X5 用 115200；若仍乱码再尝试 1500000 |
| 看到字符但回车无响应 | 行尾配置错误 | Studio 默认 LF，切换到 CRLF 试试 |
| 启动时只看到几行就停止 | UART 未连接完整或被劫持 | 检 查跳线；部分内核可能把 console 挂到其他通道 |
救火示范：板进不去系统
按以下顺序排查启动失败：
- 串口接好，断电板端
- Studio 中开启串口监听（先连接）
- 给板上电
- 看到 U-Boot 倒计时，按任意键打断
- 进入 U-Boot shell 后可以：
setenv bootargs ...修改启动参数- 选择另一个内核启动
- tftp 烧录固件（高级）
如果看不懂 U-Boot 的输出，把整段 boot 日志复制到 AI Dock，AI 会帮你分析卡在哪一步。
后续操作
板能正常启动后，切换到 2.3.2 通过 SSH 接入 恢复完整功能（远程终端、文件管理、IDE、远程桌面）。