全链路 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/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板侧串口(实测):


板侧实现(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));
}三个关键设计:
控制后立即回传,但不在 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); } }断线自愈。每次 tick 检查 tcp_mini_established(),掉线后 每 5 秒自动重连 + 重订阅,浏览器刷新页面也会立即收到最近 一次状态(server 侧缓存 last_state)。
状态真值在板子上。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 就跑起来,不装任何包,换台电脑也能演示。
踩坑记录
1883 端口在 Windows 上绑定失败(WinError 10013,权限 被拒):该端口落在 Windows 保留端口区间(netsh interface ipv4 show excludedportrange protocol=tcp 可见)。改用 18830(与之前手工测试用的端口一致)。板侧 broker 地址固化 在 main.c,改端口要同步改。
Python 输出缓冲:后台跑 py -3 server.py 时 print 全被 缓冲,看不到连接日志,一度误判"板子没连上来"。加 -u(unbuffered)解决。
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 发布已验证过,订阅路径相同)。

我要赚赏金
