串口模块到语音为止。今天换工业现场那根差分线——RS485。半双工,单模块自发自收失败常常是正常的。

半双工。单板、单模组、A/B 悬空,自发自收失败是正常的。write 返回正数只说明 UART FIFO 吃了字节。DE 有效时本地 RO 是聋的,总线上没有第二台,RX 就是空。不要当 uart 驱动 bug。

三种能把 RX 做出来的办法:

  1. A/B 短接回环 — 发什么收什么,验收最快
  2. 两套对发 — A-A、B-B、GND 共地
  3. 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

Logo

作为“人工智能6S店”的官方数字引擎,为AI开发者与企业提供一个覆盖软硬件全栈、一站式门户。

更多推荐