电子产品世界 » 论坛首页 » DIY与开源设计 » 电子DIY » 【瑞萨RA6W1|Zephyr】​全链路Web+MQTT远程点灯

共1条 1/1 1 跳转至页

【瑞萨RA6W1|Zephyr】​全链路Web+MQTT远程点灯

高工
2026-11-17 14:19:32     打赏

全链路 Web +MQTT远程点灯


简介

  • 目前完整产品形态: 板子上电 → 连 WiFi → 自动连本地 broker(192.168.3.214:18830)→ 订阅控制主题 → 每 1 秒上报 LED 状态 → 浏览器点按钮下发控制 → 板子执行后立即回传新状态。全链路经服务端日志验证通过。

  • 板侧固件:app/wifi_conn_min。

  • PC 端:D:\RA\RRQ61051\tools\mqtt_led_demo\,纯 Python 标准库 三合一服务(MQTT broker + HTTP + WebSocket 桥),配一个自包含 HTML 控制页。

    RA6W1-zephyr+Mqtt.png

系统架构

image.png

主题设计:

主题方向载荷说明





ra6w1/led/cmd浏览器 → 板子on / off / toggle控制命令
ra6w1/led/state板子 → 浏览器on / off状态上报(1 Hz + 变化即时回传)

复现步骤

# 1. 启动 PC 服务端(必须 -u,否则日志被缓冲看不到)
cd D:\RA\RRQ61051\tools\mqtt_led_demo
py -3 -u server.py
#   [mqtt] broker on 0.0.0.0:18830
#   [http] page on http://0.0.0.0:8000
#   [info] PC LAN IP: 192.168.3.214  <- point the board here

# 2. 板子上电(固件已固化 broker 地址 192.168.3.214:18830)
# 3. 浏览器打开 http://localhost:8000,点 on/off/toggle 按钮

服务端日志(实测):

[mqtt] connect from ('192.168.3.18', 49153)
[mqtt] ('192.168.3.18', 49153) connected (v4)
[mqtt] ('192.168.3.18', 49153) sub ra6w1/led/cmd
[http] browser websocket up
[ws] browser cmd: off
[ws] browser cmd: on
[ws] browser cmd: toggle

板侧串口(实测):

image.png

image.png

image.png

板侧实现(mqtt_mini.c 自动模式)

新增自动演示模式,主线程 1 Hz 驱动:

void mqtt_mini_tick(void)
{
    if (!auto_enabled) return;
    if (session_up && tcp_mini_established()) {
        mqtt_publish_state_nowait();    /* 1 Hz 状态上报 */
        return;
    }
    session_up = false;
    if (k_uptime_get() < next_retry_ms) return; /* 5s 重连间隔 */
    next_retry_ms = k_uptime_get() + 5000;
    if (mqtt_connect_full(auto_ip, auto_port, NULL, NULL) != 0)
        return;
    if (mqtt_do_subscribe(CMD_TOPIC) == 0) {
        strcpy(sub_topic, CMD_TOPIC);
    }
}

main.c 里挂接(WiFi 关联 + net_mini 起来之后):

static const uint8_t broker[4] = { 192, 168, 3, 214 };
mqtt_mini_auto_start(broker, 18830);
while (1) {
    mqtt_mini_tick();
    k_sleep(K_SECONDS(1));
}

三个关键设计:

  1. 控制后立即回传,但不在 net 线程里等 ACK。 收到控制 PUBLISH 的回调跑在 net 线程(tcp_mini 的 RX 路径), 若在这里调 mqtt_do_publish()(会 tcp_mini_wait_ack() 阻塞), 就把自己的 RX 线程卡死、ACK 永远收不到 → 死锁。 所以回传用 fire-and-forget 版本,且用 K_NO_WAIT 抢锁, 抢不到就丢(下一秒 1 Hz 上报会补上):

    static void mqtt_publish_state_nowait(void)
    {
     if (!session_up || !tcp_mini_established()) return;
     if (k_mutex_lock(&mqtt_lock, K_NO_WAIT) == 0) {
         mqtt_do_publish_locked(STATE_TOPIC,
                        led_state ? "on" : "off");
         k_mutex_unlock(&mqtt_lock);
     }
    }
  2. 断线自愈。每次 tick 检查 tcp_mini_established(),掉线后 每 5 秒自动重连 + 重订阅,浏览器刷新页面也会立即收到最近 一次状态(server 侧缓存 last_state)。

  3. 状态真值在板子上。LED 状态变量 led_state 与 GPIO 一起 更新,网页上看到的永远是板子上报的真实状态,不是按钮的 "预期"状态。

PC 端 server.py 设计要点

单文件、零依赖(纯标准库),一个进程里跑三个服务:

  • MQTT 3.1.1 broker(:18830):手写 CONNECT / CONNACK、 SUBSCRIBE / SUBACK、PUBLISH(QoS0 转发 + QoS1 回 PUBACK)、 PINGREQ / PINGRESP、DISCONNECT,主题通配符 + / #。 每个连接一个线程,publish() 按订阅匹配把消息扇出给所有 MQTT 客户端。

  • HTTP(:8000):把 index.html 原样吐给浏览器。

  • WebSocket(:8000 /ws):手写握手(SHA1 + base64 算Sec-WebSocket-Accept)和帧解析(含 mask、ping/pong)。 浏览器发来 {"cmd":"on"} → 转 MQTT PUBLISH 到 cmd 主题; 板子的 state 上报 → 广播 JSON 给所有浏览器连接。

WebSocket 桥的核心(双向各几行):

# 浏览器 -> MQTT
cmd = msg.get('cmd')
if cmd in ('on', 'off', 'toggle'):
    publish(CMD_TOPIC, cmd)

# MQTT state -> 浏览器
if topic == STATE_TOPIC:
    last_state = payload.decode(errors='replace')
    for w in ws_clients:
        ws_send(w, json.dumps({"type": "state",
                               "value": last_state,
                               "ts": int(time.time() * 1000)}))

为什么不用现成 broker / 现成 JS MQTT 客户端? 一是板侧的 mini TCP 栈对 TCP 行为(分段、时序)很敏感,自己写的 broker 出问题时两端日志都在手边,好对照;二是整个 demo 一个py -3 server.py 就跑起来,不装任何包,换台电脑也能演示。

踩坑记录

  1. 1883 端口在 Windows 上绑定失败(WinError 10013,权限 被拒):该端口落在 Windows 保留端口区间(netsh interface ipv4 show excludedportrange protocol=tcp 可见)。改用 18830(与之前手工测试用的端口一致)。板侧 broker 地址固化 在 main.c,改端口要同步改。

  2. Python 输出缓冲:后台跑 py -3 server.py 时 print 全被 缓冲,看不到连接日志,一度误判"板子没连上来"。加 -u(unbuffered)解决。

  3. net 线程里不能阻塞发 MQTT(见上文板侧设计 1)——这是 本次唯一一个真 bug,症状是点按钮后板子"收到命令但网页不 更新,随后板子网络整体卡死"。

index.html 简述

自包含单页(CSS+JS 全内联,无外部资源):

  • 大灯球(div + radial-gradient),on 状态带辉光;

  • on / off / toggle 三个按钮;

  • 状态栏 + 连接指示(WS 绿字"已连接")+ 滚动日志;

  • new WebSocket('ws://' + location.host + '/ws'),断线自动 重连,收到 {"type":"state"} 更新灯球。

局域网内任何设备(含手机)打开 http://192.168.3.214:8000即可控制。

资源占用

编译后 RAM 259.6 KB / 256 KB 分区统计(99.03%,含 WIFI_RAM 等独立区),链接通过、连续运行稳定。但已无任何余量——后续 叠加 LVGL 等必须先瘦身(裁剪 shell/net 调试打印)或启用 PSRAM(跳线 J105,尚未验证)。

下一步

  • keepalive 60s 到期前自动 PINGREQ(长连接保活);

  • 订阅多主题 / 通配符匹配,支持更多板载资源(按键、ADC 上报);

  • LVGL 屏联动:MQTT 消息上屏 + 屏上触摸按钮反向控制;

  • 把 broker 换成外网服务器(39.99.195.81)验证广域网控制 (外网 MQTT 发布已验证过,订阅路径相同)。





关键词: 瑞萨     RA6W1     Zephyr     +MQTT    

共1条 1/1 1 跳转至页

回复

匿名不能发帖!请先 [ 登陆 注册 ]