UART 串口控制台
瑞莎的绝大多数产品将 GPIO 引脚上的第 8 (TX)、第 10 (RX) 引脚定义为 UART 串口通信接口,以方便排查系统早期启动阶段的问题。
准备事项
- 任意瑞莎提供了 GPIO 引脚的产品,及兼容供电方案
- 个人电脑
- USB 转 TTL 串口线
提示
基于 MediaTek 芯片的瑞莎产品,UART 默认配置为 921600n8,无流量控制。
下文使用基于 CH340 的串口线进行描述。
串口连接
如下所示连接 USB 转 TTL 串口线:
Radxa SBC | 连接 | 串口线 |
---|---|---|
GND (pin 6) | <---> | 黑色线 |
TX (pin 8) | <---> | 白色线 |
RX (pin 10) | <---> | 绿色线 |
![](/img/accessories/rock5a-1000px-Serial-connection.webp)
危险
请勿连接红色供电线!
使用串口工具
基于 MediaTek 芯片的瑞莎产品的串口默认配置如下:
baudrate: 921600
data bit: 8
stop bit: 1
parity : none
flow control: none
- Windows
- Linux
- Mac
Windows
Putty 是一个可以在 Windows 上使用,支持多种波特率的串口工具。下面介绍如何使用 Putty 连接串口。
-
下载 Putty 并安装。
-
将 USB 转 TTL 串口线的 USB 一端插到 PC,查看设备管理器,以找到 COM 编号。这里假设是 COM3。
-
打开 Putty,并按如下方式进行设置:
- 在左边栏目中选择 Session,将串行线路设置为 COM3,波特率设置 921600,连接类型为 Serial。
- 在 Saved Sessions 列中写入 radxa-nio12l ,然后按 Save。
- 在左边栏目选择最底下的 Serial 并按照以下参数配置:
- 设置完成后,点击 Open 打开串口,确保 TTL 端正确接入之后,接通主板的电源即可。
Linux
Minicom 是一个可以在 Linux 上使用,支持多种波特率的串口工具。下面介绍如何使用 Minicom 连接串口。
- 将串口 USB 端插入主机 PC 后,请先找到串口设备:
在终端输入 dmesg | tail
会得到类似下面的打印:
[10.654076] usb 1-6.4.3: new full-speed USB device number 103 using xhci_hcd
[10.755730] usb 1-6.4.3: New USB device found, idVendor=0403, idProduct=6001
[10.755732] usb 1-6.4.3: New USB device strings: Mfr=1, Product=2, SerialNumber=0
[10.755733] usb 1-6.4.3: Product: USB <-> Serial
[10.755734] usb 1-6.4.3: Manufacturer: FTDI
[10.756728] ftdi_sio 1-6.4.3:1.0: FTDI USB Serial Device converter detected
[10.756750] usb 1-6.4.3: Detected FT232BM
[10.757195] usb 1-6.4.3: FTDI USB Serial Device converter now attached to ttyUSB0
依照最后一行所示,/dev/ttyUSB0 即是新插入的串口设备。
提示
可能存在没有权限读写串口的情况。
临时处理:通过 chmod 命令修改权限
sudo chmod 777 /dev/ttyUSB0
永久处理:通过将当前用户加入 dialout 组
sudo usermod -aG dialout $USER
- 安装 minicom:
sudo apt-get update
sudo apt-get install minicom
- 设置 minicom
首先将当前非 root 或者不使用 sudo 的用户加入 plugdev 组
sudo usermod -aG plugdev $USER
编辑 ~/.bashrc,添加以下参数,重新打开新的终端后即可生效。
alias minicom='minicom -w -t xterm -l -R UTF-8'
创建并且编辑文件 ~/.minirc.921600-usb0,添加下列内容:
pu port /dev/ttyUSB0
pu baudrate 921600
pu bits 8
pu parity N
pu stopbits 1
pu rtscts No
- 执行以下命令以连接设备,指定参数 921600-usb0 来使用上面的配置。
minicom 921600-usb0
Mac
Picocom 是一个可以在 Mac 上使用,支持多种波特率的串口工具。下面介绍如何使用 Picocom 连接串口。
- 安装 picocom
% brew install --build-from-source radxa/picocom/picocom
- 开启 picocom
% picocom -b 921600 -d 8 /dev/tty.usbserial-2130
FAQs
- 使用调试控制台时,屏幕上有系统启动信息,但无法使用键盘输入文字? 可能是默认开启了 Hardware Flow Control。关闭 Hardware Flow Control 后应该能恢复正常。