学习 / TSENGCHEN BLOG

RK3576-Industrial-Bus-Driver-Course--05-RK3576-RS485-Driver

01_Learning · 第 16 / 23 篇

第 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 路径都被证明正确但驱动寄存器编码错误时,才进入该文件改代码。

01_Learning · 文档目录
上一篇RK3576-Industrial-Bus-Driver-Course--04-RK3576-CAN-Driver下一篇RK3576-Industrial-Bus-Driver-Course--06-RK3576-DSMC-Driver