RS485半双工通信模块驱动开发—【万物智能之开源鸿蒙OpenHarmony系统实战开发系列教程】
串口模块到语音为止。今天换工业现场那根差分线——RS485。半双工,单模块自发自收失败常常是正常的。


半双工。单板、单模组、A/B 悬空,自发自收失败是正常的。write 返回正数只说明 UART FIFO 吃了字节。DE 有效时本地 RO 是聋的,总线上没有第二台,RX 就是空。不要当 uart 驱动 bug。
三种能把 RX 做出来的办法:
- A/B 短接回环 — 发什么收什么,验收最快
- 两套对发 — A-A、B-B、GND 共地
- PC USB-RS485 — 电脑侧用 USB 转 485,A-A、B-B、共地

DE/RE 方向脚:有的模组要 GPIO(发前拉 DE、write 完 tcdrain、放 DE 再听);有的硬件自动方向(OE 上拉,软件当普通串口)。软件永远不碰 DE,模组又不是自动方向 → 「能发不能收」。
常见收发器挂 uart8 = /dev/ttyS8 @ 115200。写到 ttyS7 会「发送成功」,字节没过 485 收发器。以原理图 DI/RO 接哪路 uart 为准,不要猜,不要看语音/LoRa 那组排针的丝印。
不要和 RS232 搅在一起。RS232 是 TTL 转正负电平、DB9、uart0。RS232 回环短 2-3 针,不是短 A/B。
产品 rk3568_evb。用户态 32 位 armv7 musl。不要占用 /dev/ttyS2(console,1500000)。
1. 现象
打开 /dev/ttyS8,write("HELLO") 返回 5,poll 一秒,RX 空。有人开始改 termios、改 poll、怀疑 dw-apb-uart 坏了。内核 serial 表 8: 的 tx 在涨,rx 不动。这正是半双工空总线该有的样子。
另一类:写到 /dev/ttyS7,同样 TX 5,示波器在 485 的 A/B 上没有差分波形。字节进了另一组排针,没进收发器。
第三类:软件从不碰 DE,模组也不是自动方向。DE 悬空或常低,驱动器不工作,A/B 安静;或者 DE 常高,本地接收器一直聋,短接 A/B 也收不回。
根因按层拆:
| 层 | 看什么 |
|---|---|
| 口 | DI/RO 接到哪路 uart,常见 `ttyS8`,不是 `ttyS7` |
| 半双工 | 没有对端、A/B 悬空,RX 空是预期 |
| 方向 | GPIO 控 DE,还是硬件自动 |
| 回环 | A/B 短接才能在单板上听到自己 |
| 和 RS232 | 不是 DB9,不是短 2-3 针 |
2. 链路上的位置
用户态 write
│ ttyS8 115200 8N1
▼
RK3568 uart8 TX/RX(TTL)
│ DI / RO
▼
RS485 收发器
│ DE/RE(GPIO 或自动)
▼
A / B 差分
│
▼
对端收发器 或 A/B 短接 或 USB-RS485
TTL 这一侧是全双工的 uart。485 这一侧是半双工差分。DE 有效时驱动器占线,接收器关掉,自己听不见自己。所以:
- A/B 悬空、没有第二台:RX 空。正常。
- DE 拉着不放:即使 A/B 短接,RO 仍聋,RX 仍空。正常(方向错了)。
write成功:只证明 uart FIFO 吃了。不证明 A/B 上有波形。
硬件自动方向的模组:OE 被电阻拉到电源,芯片看 TX 是否有数据自己切 DE。软件当普通串口,不要再翻 GPIO。分不清就先当自动,A/B 短接发 HELLO。回得来就不用管 DE。回不来,再看 write 期间 DE 是不是高。
3. 口、设备树、权限
hdc shell "ls -l /dev/ttyS8"
hdc shell "cat /proc/tty/driver/serial"
hdc shell "chmod 0666 /dev/ttyS8"
期望 crw,serial 表有 8:。没有 8:,DTS 没 okay。假文件 Not a tty。
板级:
device/board/rk/rk3568_evb/kernel/rk3568-evb-linux.dts
&uart8 {
status = "okay";
pinctrl-names = "default";
pinctrl-0 = <&uart8m0_xfer>;
};
pinctrl 组名以你这份 dtsi 为准,必须是接到收发器 DI/RO 的那组。写错 mux,节点还在,write 也成功,A/B 没波形。
开机放权:
device/board/rk/rk3568_evb/board_perm/board-perm.sh
init.rk30board.cfg 里 once = 1。HAP 不是 root。方向 GPIO 的 value 同样要 chmod 0666,否则应用拉不了 DE。
不要占用 /dev/ttyS2。不要把 RS485 工具默认写成 ttyS7。
4. 完整 C
O_NONBLOCK + poll。关 CRTSCTS。不要 O_NDELAY + select,不要纯阻塞 + VTIME。可选 GPIO 控制 DE:发前拉高,write 后 tcdrain,再放低,然后听。GPIO 号来自原理图,不要猜。传 -1 表示硬件自动,软件不碰 DE。
uart_rs485.c:
/* uart_rs485.c — OpenHarmony 4.1 用户态,32 位 musl
* uart_rs485 /dev/ttyS8 115200 自动方向,发 HELLO 再听 1 秒
* uart_rs485 /dev/ttyS8 115200 67 GPIO67 作 DE,发完再听
* uart_rs485 /dev/ttyS8 115200 -1 recv 5000
*
* A/B 短接:应收回 HELLO。不短接:RX 空是预期。
*/
#include <errno.h>
#include <fcntl.h>
#include <poll.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <termios.h>
#include <unistd.h>
static int g_de = -1;
static speed_t baud_const(int b)
{
switch (b) {
case 9600: return B9600;
case 57600: return B57600;
case 115200: return B115200;
default: return B0;
}
}
static void hexdump_line(const unsigned char *b, int n)
{
int i;
for (i = 0; i < n; i++)
printf("%02X", b[i]);
printf("\n");
}
static int de_export(int gpio)
{
char path[128], buf[16];
int fd, n, wr;
fd = open("/sys/class/gpio/export", O_WRONLY);
if (fd >= 0) {
n = snprintf(buf, sizeof(buf), "%d", gpio);
wr = (int)write(fd, buf, (size_t)n);
(void)wr;
close(fd);
}
snprintf(path, sizeof(path), "/sys/class/gpio/gpio%d/direction", gpio);
fd = open(path, O_WRONLY);
if (fd < 0) {
fprintf(stderr, "direction %s: %s(先 export,或 gpio 号不对)\n",
path, strerror(errno));
return -1;
}
if (write(fd, "out", 3) < 0) {
fprintf(stderr, "write direction: %s\n", strerror(errno));
close(fd);
return -1;
}
close(fd);
snprintf(path, sizeof(path), "/sys/class/gpio/gpio%d/value", gpio);
g_de = open(path, O_WRONLY);
if (g_de < 0) {
fprintf(stderr, "value %s: %s(chmod 0666?)\n",
path, strerror(errno));
return -1;
}
return 0;
}
static void de_set(int v)
{
if (g_de < 0)
return;
if (write(g_de, v ? "1" : "0", 1) < 0)
fprintf(stderr, "DE write: %s\n", strerror(errno));
}
static int uart_open(const char *path, int baud)
{
speed_t sp = baud_const(baud);
if (sp == B0) {
fprintf(stderr, "波特率 %d 不在表里\n", baud);
return -1;
}
int fd = open(path, O_RDWR | O_NOCTTY | O_NONBLOCK);
if (fd < 0) {
fprintf(stderr, "open %s: %s\n", path, strerror(errno));
return -1;
}
struct termios t;
memset(&t, 0, sizeof(t));
if (tcgetattr(fd, &t) != 0) {
fprintf(stderr, "tcgetattr: %s(假节点?)\n", strerror(errno));
close(fd);
return -1;
}
cfsetispeed(&t, sp);
cfsetospeed(&t, sp);
t.c_cflag &= ~CSIZE;
t.c_cflag |= CS8 | CLOCAL | CREAD;
t.c_cflag &= ~PARENB;
t.c_cflag &= ~CSTOPB;
t.c_cflag &= ~CRTSCTS;
t.c_lflag &= ~(ICANON | ECHO | ECHOE | ISIG);
t.c_iflag &= ~(IXON | IXOFF | IXANY | INLCR | ICRNL);
t.c_oflag &= ~OPOST;
t.c_cc[VMIN] = 0;
t.c_cc[VTIME] = 0;
tcflush(fd, TCIOFLUSH);
if (tcsetattr(fd, TCSANOW, &t) != 0) {
fprintf(stderr, "tcsetattr: %s\n", strerror(errno));
close(fd);
return -1;
}
return fd;
}
static int uart_read_bytes(int fd, unsigned char *out, int outsz, int timeout_ms)
{
int total = 0, idle = 0;
while (idle < timeout_ms && total < outsz) {
struct pollfd p;
p.fd = fd;
p.events = POLLIN;
p.revents = 0;
int pr = poll(&p, 1, 100);
if (pr > 0 && (p.revents & POLLIN)) {
int r = (int)read(fd, out + total, (size_t)(outsz - total));
if (r > 0) {
total += r;
idle = 0;
continue;
}
}
idle += 100;
}
return total;
}
static int send_then_listen(int fd, const unsigned char *tx, int n, int wait_ms)
{
de_set(1);
usleep(50 * 1000);
ssize_t w = write(fd, tx, (size_t)n);
if (w < 0) {
fprintf(stderr, "write: %s\n", strerror(errno));
de_set(0);
return -1;
}
if (tcdrain(fd) != 0)
fprintf(stderr, "tcdrain: %s\n", strerror(errno));
usleep(50 * 1000);
de_set(0);
printf("TX %d 字节: ", (int)w);
hexdump_line(tx, n);
unsigned char rx[512];
int r = uart_read_bytes(fd, rx, sizeof(rx), wait_ms);
if (r > 0) {
printf("RX %d: ", r);
hexdump_line(rx, r);
printf("RX 文本: %.*s\n", r, rx);
} else {
printf("RX: 空。A/B 未短接、没有对端、或 DE 没放下来,这是预期,不是 uart bug。\n");
}
return (int)w;
}
int main(int argc, char **argv)
{
const char *dev = "/dev/ttyS8";
int baud = 115200;
int gpio = -1;
int i = 1;
if (argc >= 2 && argv[1][0] == '/') {
dev = argv[1];
i = 2;
if (argc >= 3 && argv[2][0] >= '0' && argv[2][0] <= '9') {
baud = atoi(argv[2]);
i = 3;
}
}
if (i < argc && strcmp(argv[i], "recv") != 0) {
gpio = atoi(argv[i]);
i++;
}
int fd = uart_open(dev, baud);
if (fd < 0)
return 1;
if (gpio >= 0) {
if (de_export(gpio) != 0) {
close(fd);
return 1;
}
de_set(0);
printf("DE = GPIO%d(发前 1,tcdrain 后 0)\n", gpio);
} else {
printf("不碰 DE,当硬件自动方向。\n");
}
if (i < argc && strcmp(argv[i], "recv") == 0) {
int ms = 5000;
if (i + 1 < argc)
ms = atoi(argv[i + 1]);
printf("只听 %d ms。对端先发。\n", ms);
unsigned char rx[512];
int r = uart_read_bytes(fd, rx, sizeof(rx), ms);
if (r > 0) {
printf("RX %d: ", r);
hexdump_line(rx, r);
} else {
printf("RX: 空\n");
}
close(fd);
if (g_de >= 0)
close(g_de);
return 0;
}
const unsigned char hello[] = "HELLO";
send_then_listen(fd, hello, (int)sizeof(hello) - 1, 1000);
close(fd);
if (g_de >= 0)
close(g_de);
return 0;
}
write 完立刻切回接收,末尾比特会被自己的 DE 切掉。所以必须 tcdrain:等移位器排空,不是等 FIFO 入队。tcdrain 之后再留几十毫秒,再放 DE。
32 位 musl:
OHOS=$HOME/code/opcode/OpenHarmony
CLANG=$OHOS/prebuilts/clang/ohos/linux-x86_64/llvm/bin/clang
SYSROOT=$OHOS/prebuilts/ohos-sdk/linux/11/native/sysroot
$CLANG --target=arm-linux-ohos --sysroot=$SYSROOT \
-O2 -Wall \
-Wl,--dynamic-linker=/system/lib/ld-musl-arm.so.1 \
-o uart_rs485 uart_rs485.c
file uart_rs485
hdc file send uart_rs485 /data/local/tmp/uart_rs485
hdc shell "chmod 0755 /data/local/tmp/uart_rs485"
hdc shell "chmod 0666 /dev/ttyS8"
GPIO 控 DE 时,号来自原理图。先 export,再放权:
hdc shell "echo 67 > /sys/class/gpio/export"
hdc shell "echo out > /sys/class/gpio/gpio67/direction"
hdc shell "chmod 0666 /sys/class/gpio/gpio67/value"
hdc shell "/data/local/tmp/uart_rs485 /dev/ttyS8 115200 67"
67 只是示例。换成原理图上那颗脚的 Linux gpio 编号。HAP 要写 value,0666 漏了会 Permission denied,看起来像「能发不能收」。
自动方向:
hdc shell "/data/local/tmp/uart_rs485 /dev/ttyS8 115200"
5. A/B 短接:单板最快验收
把模块的 A、B 两根信号短在一起。发 HELLO,poll 读回来。能原样收回,说明 UART + 收发器 + 方向 整条链通。
hdc shell "/data/local/tmp/uart_rs485 /dev/ttyS8 115200"
期望:
TX 5 字节: 48454C4C4F
RX 5: 48454C4C4F
RX 文本: HELLO
不短接:
TX 5 字节: 48454C4C4F
RX: 空。A/B 未短接、没有对端、或 DE 没放下来,这是预期,不是 uart bug。
第二种打印出现在没短接时,停手。不要改 termios。短接后再跑一次。
短接了仍空:
- 写到了
ttyS7。换成ttyS8。 - 需要 GPIO 控 DE,软件没拉。或拉了没
tcdrain就放下,末尾被切掉,RX 残缺或空。 - DE 极性反了。试着把
de_set(1)/de_set(0)对调——以原理图「高=发送」为准。 - 收发器没供电。
- A/B 其实没短到。量通断。
短接成功之后,拆掉短接线,RX 重新变空。这不是退步,这是半双工。
6. 两套对发,或 USB-RS485
两套:A 接 A,B 接 B,GND 共地。不要交叉成 A-B。极性反了,对端全是噪声或什么都没有。
板 B 先听:
hdc shell "/data/local/tmp/uart_rs485 /dev/ttyS8 115200 recv 20000"
板 A 发:
hdc shell "/data/local/tmp/uart_rs485 /dev/ttyS8 115200"
B 期望 RX 5: 48454C4C4F。长线两端各 120 Ω 端接,中间节点不要每台都接。必须共地。
PC USB-RS485:电脑侧串口工具 115200 8N1,A-A、B-B、共地。板上 recv,电脑发 HELLO;反过来板上发,电脑该看到。USB 适配器自己的方向通常是自动的。
不要用 RS232 的 DB9 去短 2-3 针冒充 485 回环。那是另一颗芯片、另一路 uart0、另一套电平。短 A/B 才是 485。
7. 现场对照
ttyS7。 语音/LoRa 的习惯。TX 成功,A/B 没波形。看原理图 DI/RO。
单板等回显。 A/B 悬空。RX 空是预期。
不碰 DE。 模组不是自动方向。能发不能收。
write 完立刻放 DE。 末尾被切。tcdrain。
CRTSCTS。 CTS 悬空。关掉。
select / VTIME。 dw-apb-uart 假路。poll。
和 RS232 搞混。 短 2-3 针、uart0、正负电平,全是另一篇文章的对象。
GPIO 0666 漏了。 hdc 能拉 DE,HAP 不能。应用表现为能发不能收。
32 位。 file 看 interpreter。
两套 A-B 交叉。 极性反。A-A、B-B。
8. 通不了时的顺序
1. ls -l /dev/ttyS8 字符设备?0666?serial 有 8:?
2. 原理图:DI/RO 是 uart8 还是别的
3. A/B 短接,uart_rs485 /dev/ttyS8 115200
4. 收回 HELLO:这一侧 UART+收发器过。拆短接,RX 空是预期
5. 短接仍空:换回 ttyS7 试?不。查 DE、供电、tcdrain、极性
6. 短接成功、对发失败:A-A B-B、共地、波特率、端接
7. 工具行、应用不行:tty 0666、GPIO value 0666
短接回环是分水岭。没过不要谈两套。过了不要再改 termios。
发前后各 cat /proc/tty/driver/serial 一次。tx 不涨,字节没进控制器。tx 涨、A/B 无波形,字节出了 SoC、没进收发器(口错或 DE)。tx 涨、有波形、RX 空,半双工没有对端,或 DE 没放。
9. 什么叫过
单板:
| 项 | 通过 |
|---|---|
| `/dev/ttyS8` | `c` 开头,115200 |
| 不短接 `send` | `TX 5`,RX 空,允许 |
| A/B 短接 | `RX` 为 `HELLO` / `48454C4C4F` |
两套或 USB-RS485:
| 项 | 通过 |
|---|---|
| 两边或电脑 115200 8N1 | 打开成功 |
| A 发 `HELLO` | B 或电脑收到同样五个字节 |
| 反向 | 同样回去 |
不要用「能 open」当过。不要用「write 返回正数」当过。不要用 RS232 的 2-3 针短接当 485 过。
路径
| 用途 | 路径 |
|---|---|
| DTS uart8 | `device/board/rk/rk3568_evb/kernel/rk3568-evb-linux.dts` |
| 节点 | `/dev/ttyS8` |
| 放权 | `device/board/rk/rk3568_evb/board_perm/board-perm.sh` |
| 工具 | `uart_rs485.c` → `/data/local/tmp/uart_rs485` |
| DE | `/sys/class/gpio/gpioN/value`,0666 |
| 勿占 | `/dev/ttyS2`,1500000 |
系列第 50 篇 · 芯片:瑞芯微 RK3568 · OpenHarmony 4.1(API 11) · Linux 5.10
更多推荐


所有评论(0)