wifi_ps + MQTT 示例

📁 源码位置: samples/subsys/lisa_pm/wifi_ps/mqtt 查看源码

功能说明

在 basic 子工程 的 WiFi 自动轻睡眠基础上挂一个 coreMQTT 客户端，演示在 AUTO_LIGHT_SLEEP 下如何安全地跑 socket 收发：

  • 连上 broker（默认匿名，端口 1883），订阅 arcs/test/sub，启动时往 arcs/test/pub 发一条 hello

  • 收到下行消息时打印

  • 主循环里 MQTT_ProcessLoop 前后用 lisa_pm_wifi_lock_acquire/release 包裹，避免在 socket 收发中途进 light sleep 导致丢包

与 basic 的差异

项

basic

mqtt

WiFi + AUTO_LIGHT_SLEEP

✓

✓

MQTT 客户端

✗

✓

额外 Kconfig

——

CONFIG_SDK_MODULE_COREMQTT=y

lisa_pm_wifi_lock_*

✗

主循环包裹 MQTT_ProcessLoop

使用前修改

src/main.c 顶部：

#define TARGET_WIFI_SSID    "YOUR_WIFI_SSID"
#define TARGET_WIFI_PWD     "YOUR_WIFI_PASSWORD"

#define MQTT_BROKER_HOST    "192.168.1.100"
#define MQTT_BROKER_PORT    1883

配套主机脚本

mqtt_test.sh 在 Linux 主机上一键配置 Mosquitto broker、订阅设备消息、向设备发命令：

./mqtt_test.sh setup       # 首次配置 + 启动 broker（需要 sudo）
./mqtt_test.sh sub         # 终端 A：订阅设备上行
./mqtt_test.sh pub ping    # 终端 B：向设备发命令

编译

重要提示：在编译前，请先确认您使用的开发板型号。SDK 目前支持以下开发板：

  • arcs_evb - ARCS EVB 评估板

  • arcs_mini - ARCS Mini 开发板

根据您的开发板型号，选择对应的编译命令：

在 SDK 根目录执行编译:

# 使用 arcs_evb 开发板
./build.sh -C -S samples/<示例路径> -DBOARD=arcs_evb

# 或使用 arcs_mini 开发板
./build.sh -C -S samples/<示例路径> -DBOARD=arcs_mini

Note

确保已安装对应的工具链。

烧录

两份固件必须同时烧到 flash：

固件

路径

烧录地址

AP 固件

build/remote/ap.bin

0x0

CP 固件

build/arcs.bin

0x100000

 
./tools/burn/cskburn -s /dev/ttyUSB0 -b 3000000 \
    0x0       build/remote/ap.bin \
    0x100000  build/arcs.bin \
    -C arcs

预期输出

=== lisa_pm wifi_ps + MQTT ===
Waiting for WiFi + IP...
WiFi connected
DHCP success: 192.168.x.x
Connected to MQTT broker 192.168.1.100:1883
MQTT connected
Published: hello from arcs
SUBACK
AUTO_LIGHT_SLEEP enabled
RX: topic=arcs/test/sub, payload=ping       ← 主机端 ./mqtt_test.sh pub ping

关键 API

/* socket / MQTT 临界段必须持锁，否则可能在收发中途被 light sleep 切断 */
lisa_pm_wifi_lock_acquire();
MQTTStatus_t st = MQTT_ProcessLoop(&g_mqtt);
lisa_pm_wifi_lock_release();

API

说明

lisa_pm_wifi_lock_acquire() / release()

WiFi 省电锁，临界段引用计数；持锁期间 WiFi 不进 PS

MQTT_Init / MQTT_Connect / MQTT_Subscribe / MQTT_Publish / MQTT_ProcessLoop

coreMQTT 标准 API

注意事项

  1. 临界段必须持锁：在 MQTT 收发期间不持锁，可能引发包丢失或连接异常。任何应用层的 socket / TCP 业务都应该用同样模式包裹。

  2. WiFi 是 AUTO_LIGHT_SLEEP 的硬依赖：与 basic 一样，必须先连上 AP 才能切到 AUTO_LIGHT_SLEEP。

  3. 回调上下文：mqtt_event_callback 在 MQTT_ProcessLoop 调用栈中运行；如果要在回调里 publish 响应，必须用独立任务 + 队列，不能在回调里直接调 MQTT_Publish（会形成嵌套）。本示例只打印，不响应，避免该复杂度。