第 5 章:RK3576 UART RS485——从 DTS 到方向切换
RS485 不是一个独立 UART 控制器驱动。RK3576 的 UART1 是 DesignWare APB UART,由 8250/serial core 管理;RS485 是 serial core 的 struct serial_rs485 配置加上硬件收发器 DE/RE 方向控制。
1. 真实代码与设备树路径
uart1 DTS node
-> compatible "rockchip,rk3576-uart", "snps,dw-apb-uart"
-> drivers/tty/serial/8250/8250_dw.c
-> drivers/tty/serial/8250/8250_dwlib.c
-> serial core / tty
-> /dev/ttyS* 或 SDK 实际映射的 tty 节点
先在目标板确认节点,不能假设 UART1 一定是 /dev/ttyS1:
dmesg | grep -i -E 'tty|uart'
ls -l /dev/ttyS*
2. 设备树的两个关键属性
&uart1 {
pinctrl-0 = <&uart1m0_xfer &uart1m0_rtsn>;
linux,rs485-enabled-at-boot-time;
status = "okay";
};
uart1m0_xfer 选 TX/RX,uart1m0_rtsn 输出 UART 的 RTS_N。是否 RTS_N 实际连到 RS485 收发器 DE、DE 是否反相、RE 是否与 DE 相连,必须读原理图。DTS 的启动属性只打开 Linux 的 RS485 模式,不会修复板上接线。
3. 驱动如何检测硬件 RS485
8250_dwlib.c 的 dw8250_setup_port() 会尝试读取/写入 RS485 扩展寄存器:
pd->hw_rs485_support = dw8250_detect_rs485_hw(p);
if (pd->hw_rs485_support) {
p->rs485_config = dw8250_rs485_config;
p->rs485_supported = dw8250_rs485_supported;
} else {
p->rs485_config = serial8250_em485_config;
up->rs485_start_tx = serial8250_em485_start_tx;
up->rs485_stop_tx = serial8250_em485_stop_tx;
}
这段代码有两个分支。硬件支持时,UART 在寄存器中自动控制 DE;否则使用 8250 的 em485 软件模拟路径。调试前先确定目标实际走哪条,而不是想当然认为所有 RK3576 UART 行为相同。
4. Rockchip 分支怎样设置方向
在 dw8250_rs485_config() 的 CONFIG_ARCH_ROCKCHIP 分支,核心逻辑是:
tcr = 0;
if (rs485->flags & SER_RS485_ENABLED)
tcr |= RK_RS485_TCR_RS485EN | RK_RS485_TCR_AUTO_DE;
if (!(rs485->flags & SER_RS485_RTS_ON_SEND))
tcr |= RK_RS485_TCR_DE_POL;
dw8250_writel_ext(p, DW_UART_TCR, tcr);
SER_RS485_ENABLED 打开 RS485 和自动 DE;SER_RS485_RTS_ON_SEND 决定极性。这里必须把软件 flag 与收发器的真实 DE 有效电平匹配。极性错时,现象通常是“只能收不能发”“持续占线”或“最后字节被截断”。
5. 小而完整的用户态配置段
下面代码只负责读回、修改并写回 RS485 配置,适合放入你的测试程序;它不是重复实现 UART 驱动。
#include <linux/serial.h>
#include <sys/ioctl.h>
static int enable_rs485(int fd)
{
struct serial_rs485 rs485 = {0};
if (ioctl(fd, TIOCGRS485, &rs485) < 0)
return -1;
rs485.flags |= SER_RS485_ENABLED | SER_RS485_RTS_ON_SEND;
rs485.flags &= ~SER_RS485_RTS_AFTER_SEND;
if (ioctl(fd, TIOCSRS485, &rs485) < 0)
return -1;
return 0;
}
在调用前使用 open() 打开已确认的 tty,使用 termios 配置 baud、data bits、parity、stop bits 和 flow control。双方必须一致。不要把 RS232 电平设备直接接入 TTL UART 或 RS485 A/B 总线。
6. 完整验证应看波形
测试顺序:先用两个节点低速收发短帧;再抓取 TX、DE(或 RTS_N)和 A/B 差分波形;最后进行长帧、高频和双向轮询。一次 write() 返回只说明数据进入内核队列,并不意味着最后一个 stop bit 已经从收发器送出。
正确波形的因果顺序:DE 在 TX 前有效 → 完整输出起始位、数据位、校验位、停止位 → 发送移位寄存器空 → DE 延后释放。若丢第一个字节,优先查 DE 建立时间;若丢最后字节,优先查发送完成判断与 DE 释放。
7. RS485 诊断表
| 现象 | 最可能层级 | 先取的证据 |
|---|---|---|
| 一端永远收不到 | A/B、共地、DE 极性、串口参数 | 差分波形、TX/DE 波形 |
| 丢第一个字节 | DE 过晚有效 | TX 与 DE 同时抓取 |
| 丢最后一个字节 | DE 过早释放 | stop bit 与 DE 释放时刻 |
| 高速乱码 | 波特率、终端/偏置、地、信号完整性 | UART 错误、波形、对端对照 |
TIOCSRS485 失败 | tty 节点或驱动不支持 | TIOCGRS485、内核配置、driver probe |
8. 首个驱动任务
先不改 8250_dwlib.c。完成“修改 UART1 板级 RTS pinmux 或明确收发器极性,利用 TIOCSRS485 与波形验证方向切换”的任务。只有在硬件能力、DTS 和 serial core 路径都被证明正确但驱动寄存器编码错误时,才进入该文件改代码。