d9fba1be5b
1. 核心功能增强： - 实现 1s/次的传感器数据主动上报，温湿度精度提升至小数点后两位。 - 新增基于 cJSON 的 MQTT 控制指令解析逻辑，支持对双路继电器的远程开关控制。 - 引入即时回执 (ACK) 机制：设备在执行控制指令后立即通过 `agri/env/ack` 主题反馈执行状态。 2. 系统架构优化： - 引入 `sntp_time` 组件实现自动对时，确保上报数据携带准确的 `YYYY-MM-DD HH:MM:SS` 时间戳。 - 增加基于 eFuse 的芯片 UID 获取逻辑，结合 MAC 地址实现设备唯一标识。 - 为传感器采集任务引入 Mutex 互斥锁，确保多任务环境下 `env_sample_data_t` 的线程安全。 - 将所有传感器任务堆栈提升至 3072 字节，解决 cJSON 操作导致的 Stack Overflow 风险。 3. 文档与规范： - 新增 `README_MQTT.md` (V1.2)，定义了环境报文、控制指令及 ACK 回执的完整 JSON Schema。 - 同步更新主工程 `README.md`，明确硬件接线说明及系统功能列表。
89 lines
2.3 KiB
Markdown
89 lines
2.3 KiB
Markdown
# AgriEnv_Monitor MQTT 通信协议文档 (V1.2)
|
||
|
||
本文档面向上位机（控制端）开发，定义了与 AgriEnv_Monitor 硬件终端的交互格式。
|
||
|
||
## 1. 通信主题 (Topic)
|
||
|
||
| 功能 | 主题 (Default) | 说明 |
|
||
| :--- | :--- | :--- |
|
||
| **环境上报** | `agri/env/data` | 硬件每 1 秒主动推送到此主题 |
|
||
| **设备控制** | `agri/env/cmd` | 上位机发送控制指令到此主题 |
|
||
| **执行回执** | `agri/env/ack` | 设备执行指令后的状态反馈 |
|
||
|
||
---
|
||
|
||
## 2. 环境数据上报 (Device -> Cloud/Client)
|
||
|
||
硬件会在任务循环中自动采集并打包传感器数据，格式如下：
|
||
|
||
### 报文示例 (JSON)
|
||
```json
|
||
{
|
||
"uid": "C5E171EDA59400F8",
|
||
"mac": "D8:85:AC:5D:EE:30",
|
||
"time": "2026-04-19 20:12:48",
|
||
"data": {
|
||
"temp": 29.0,
|
||
"humi": 64.0,
|
||
"lux": 109.17,
|
||
"gas_do": 1
|
||
},
|
||
"status": {
|
||
"r1": 0,
|
||
"r2": 1
|
||
}
|
||
}
|
||
```
|
||
|
||
### 字段定义
|
||
- **uid**: (String) 芯片唯一 ID，用于区分不同终端。
|
||
- **mac**: (String) 硬件 MAC 地址。
|
||
- **time**: (String) 时间戳字符串 (`YYYY-MM-DD HH:MM:SS`)。
|
||
- **data**: (Object) 传感器实时数据：
|
||
- **temp**: (Float) 温度，单位 °C。
|
||
- **humi**: (Float) 相对湿度，单位 %。
|
||
- **lux**: (Float) 光照强度，单位 Lux。
|
||
- **gas_do**: (Int) MQ135 数字输出电平（1: 正常，0: 触发报警）。
|
||
- **status**: (Object) 执行器当前状态：
|
||
- **r1**: (Int) 继电器 1 状态 (0: 关, 1: 开)。
|
||
- **r2**: (Int) 继电器 2 状态 (0: 关, 1: 开)。
|
||
|
||
---
|
||
|
||
## 3. 设备远程控制 (Client -> Device)
|
||
|
||
上位机通过发布 JSON 指令到 `agri/env/cmd` 来控制继电器。
|
||
|
||
### 指令示例 (JSON)
|
||
```json
|
||
{
|
||
"relay": 1,
|
||
"state": 1
|
||
}
|
||
```
|
||
|
||
### 字段说明
|
||
- **relay**: (Int) 目标继电器编号。可选值：`1` 或 `2`。
|
||
- **state**: (Int) 目标状态。可选值：`1` (开启), `0` (关闭)。
|
||
|
||
|
||
---
|
||
|
||
## 4. 控制执行回执 (Device -> Client)
|
||
|
||
当设备成功解析并执行控制指令后，会立即向 `agri/env/ack` 主题发布一条回执消息。
|
||
|
||
### 回执示例 (JSON)
|
||
```json
|
||
{
|
||
"relay": 1,
|
||
"state": 1,
|
||
"result": "success"
|
||
}
|
||
```
|
||
|
||
### 字段说明
|
||
- **relay**: (Int) 已控制的继电器编号。
|
||
- **state**: (Int) 执行后的状态。
|
||
- **result**: (String) 执行结果，固定为 "success"。
|