二次开发手册
智能硬件-通讯协议说明书
产品命名规则
智能硬件-通讯协议说明书-v2
智能硬件-通讯协议说明书-v3
智能硬件-通讯协议说明书-WPP-v3
倒计时控制器-通讯协议说明书-DWY-v1
云喇叭-通讯协议说明书-v1
计量硬件-通讯协议说明书-WPP-v4
计量硬件-通讯协议说明书-v1
报警器-通讯协议说明书-v1
ARMS
config
tcp-config
mqtt-config
rules
常见问题
如何对接到自己的私有服务器
如何配网
计量硬件-通讯协议说明书-v1
250428
250429
远程开关-说明书
计量硬件-通讯协议说明书-v4
本文档使用 MrDoc 发布
-
+
首页
计量硬件-通讯协议说明书-WPP-v4
# 项目版本: v2.1.2 *** ## 一、前言 本文档详细说明了智能硬件设备与服务器之间的通信协议规范。主要包含以下内容: 1. 设备标识规则 - 使用 MAC 地址作为设备唯一标识(device_id) - 用于区分不同设备的通信 2. MQTT 与 TCP 通信机制 - 基于发布/订阅模式 (MQTT) 和请求/响应模式 (TCP) - 设备与服务器双向通信 - 支持命令下发与状态上报 3. 命令交互规范 - JSON 格式数据交换 - 完整的命令应答机制 - 标准化的错误处理 4. 适用的产品型号 5. 标准术语定义 1. "硬件终端": 指代智能设备上运行的嵌入式系统，其用于与服务器进行通信以及执行各种控制和监控功能。 2. "服务器端": 指代中心服务器，负责接收智能设备上传的数据、下发控制命令并进行数据处理与存储。 3. "应用终端": 指用户操作界面，如手机应用或网页界面，通过它用户可以发送命令到服务器端并查看设备的状态。 6. 支持的协议 1. MQTT: "硬件终端"作为MQTT客户端 2. TCP Client: "硬件终端"作为TCP客户端 3. HTTP Server: "硬件终端"作为HTTP服务端 ## 二、产品型号说明 本项目支持多种产品型号： | 编号 | 名称 | 功能描述 | | ------- | ------- | ---------------------------------------------- | | D2_CONV | 智能插座转换器 | 远程控制<br>电压检测, 电流检测, 功率检测<br>电压报警, 电流报警, 功率报警 | | D2_SOC | 标准智能插座 | 远程控制<br>电压检测, 电流检测, 功率检测<br>电压报警, 电流报警, 功率报警 | | D2_BRK | 智能电闸 | 单继电器控制<br>电压检测, 电流检测, 功率检测<br>电压报警, 电流报警, 功率报警 | | D2_CBOX | 控制盒 | 远程控制<br>电压检测, 电流检测, 功率检测<br>电压报警, 电流报警, 功率报警 | | D2_SBOX | 迷你控制盒 | 远程控制 | ## 三、设备标识 (device_id) 7. 用途：代表终端的唯一编号 8. 默认值：设备的 MAC 地址 ## 四、通信协议 ### 4.1. MQTT 协议 #### 4.1.1. MQTT 协议概要 9. mqtt 通讯基于2个主题,device_id/device_pub_topic与device_id/device_sub_topic 10. "硬件终端"通过device_id/device_pub_topic主题发布数据,"应用终端"通过该主题接收"硬件终端"的数据 11. "硬件终端"通过device_id/device_sub_topic主题接收数据,"应用终端"通过该主题发送数据 ***node***: mqtt主题由device_id动态构成,修改device_id时,将自动修改这两个主题 #### 4.1.2. MQTT 通讯框图 以下图表,展示了"硬件终端"的"事件上报"与"控制终端"的"应用命令请求"或"参数请求"对应的通讯流程图. ```mermaid sequenceDiagram participant HW_MQTT_Client participant MQTT_Server participant APP_MQTT_Client HW_MQTT_Client->>MQTT_Server: 发布消息到 device_pub_topic Note right of HW_MQTT_Client: 事件上报 MQTT_Server->>APP_MQTT_Client: 转发消息 APP_MQTT_Client->>MQTT_Server: 发布控制指令到 device_sub_topic Note right of APP_MQTT_Client: 控制命令或参数请求 MQTT_Server->>HW_MQTT_Client: 转发指令 Note right of MQTT_Server: 设备执行指令 HW_MQTT_Client-->>MQTT_Server: 回复确认或失败信息 MQTT_Server-->>APP_MQTT_Client: 转发应答结果 ``` * HW_MQTT_Client: 硬件终端,MQTT客户端 * MQTT_Server: MQTT 服务器端,一般指客户在阿里云,华为云等云平台构建的MQTT服务器终端 * APP_MQTT_Client: 应用终端,也是MQTT客户端,一般由手机小程序充当 ### 4.2. TCP Client 协议 #### 4.2.1. TCP Client 协议概要 12. TCP Client 代表"硬件终端"作为TCP客户端与"服务器端"进行socket通讯 13. "硬件终端"上电联网完成后,会主动与"服务器端"建立socket #### 4.2.2. TCP Client 通讯框图 以下图表,展示了"硬件终端"的"事件上报"与"应用终端"的"控制命令请求"或"参数请求"对应的通讯流程图. ```mermaid sequenceDiagram participant TCP_Client participant TCP_Server Note over TCP_Server: TCP Server启动并监听端口 Note over TCP_Client: 硬件终端上电初始化 TCP_Client->>TCP_Server: 发起TCP连接请求(SYN) TCP_Server-->>TCP_Client: 确认连接请求(SYN+ACK) TCP_Client->>TCP_Server: 完成连接建立(ACK) Note over TCP_Client,TCP_Server: TCP连接建立完成 TCP_Client->>TCP_Server: 事件上报 Note right of TCP_Client: 事件通知(如设备状态变化) TCP_Server->>TCP_Client: 发送控制指令 Note right of TCP_Server: 控制命令或参数请求 TCP_Client-->>TCP_Server: 回复执行结果 Note right of TCP_Client: 执行指令并反馈状态 Note over TCP_Client,TCP_Server: 连接保持,可继续通信 Note over TCP_Client,TCP_Server: 任一方可主动断开连接 ``` *TCP Client 采用 ascii 编码通讯内容* ### 4.3. HTTP Server 协议 #### 4.3.1. HTTP Server 协议概要 1. 由于HTTP协议的限制,"硬件终端"无法支持"事件上报"与"消息上报" #### 4.3.2. HTTP Server 通讯框图 以下图表,展示了"应用终端"发送控制指令给到"硬件终端"的通讯流程图 ```mermaid sequenceDiagram participant App_Client participant HW_HTTP_Server App_Client->>HW_HTTP_Server: 发送控制指令请求 Note right of App_Client: 控制命令请求 HW_HTTP_Server-->>App_Client: 返回执行结果 Note right of HW_HTTP_Server: 处理请求并反馈状态 ``` * APP_Client: "应用终端" * HW_HTTP_SERVER: "硬件终端" #### 4.3.3. 通讯报文举例 ##### HTTP 请求报文 假设我们要发送一个 POST 请求，其中包含 JSON 格式的数据： ``` POST /device_id HTTP/1.1 Host: example.com Content-Type: application/json Content-Length: 85 { "ctrl_cmd": { "open_relay_cmd": {} } } ``` - **请求行**：`POST /device_id HTTP/1.1` 指定了请求方法为 POST，请求的资源路径为 `/device_id，使用的 HTTP 版本为 1.1。 - **头部字段**： - `Host: example.com` 指定了目标服务器的主机名。 - `Content-Type: application/json` 指定了请求主体的数据格式为 JSON。 - `Content-Length: 85` 指定了请求主体的字节长度。 - **主体**：包含了实际的数据负载，这里是一个 JSON 格式的控制命令。 ##### HTTP 响应报文 假设服务器返回一个成功的响应： ``` HTTP/1.1 200 OK Content-Type: application/json Content-Length: 17 { "ask": true } ``` - **状态行**：`HTTP/1.1 200 OK` 指定了 HTTP 版本为 1.1，状态码为 200，表示请求成功。 - **头部字段**： - `Content-Type: application/json` 指定了响应主体的数据格式为 JSON。 - `Content-Length: 17` 指定了响应主体的字节长度。 - **主体**：包含了实际的数据负载，这里是一个 JSON 格式的确认应答。 ## 五、通讯报文 所有协议都共用同一套通讯报文,TCP_Client,MQTT等 ### 5.1. 控制命令 控制指令发送成功后,设备终端会返回一个"确认帧"或"否认帧"用于响应控制命令是否执行成功 | 命令 | JSON 格式 | 说明 | | ------ | -------------------------------------------------------------------- | ------- | | OTA更新 | `{"ctrl_cmd":{"ota_cmd":{"url":"http://example.com/firmware.bin"}}}` | 固件升级 | | 恢复出厂设置 | `{"ctrl_cmd":{"factory_params_cmd":{}}}` | 恢复出厂设置 | | 重启设备 | `{"ctrl_cmd":{"restart_cmd":{}}` | 重启系统 | | 打开继电器 | `{"ctrl_cmd":{"open_relay_cmd":{}}` | 打开继电器 | | 关闭继电器 | `{"ctrl_cmd":{"close_relay_cmd":{}}` | 关闭继电器 | | 反转继电器 | `{"ctrl_cmd":{"toggle_relay_cmd":{}}` | 切换继电器状态 | | 开始电量统计 | `{"ctrl_cmd":{"start_power_stat_cmd":{}}` | 开始电量统计 | | 结束电量统计 | `{"ctrl_cmd":{"stop_power_stat_cmd":{}}` | 结束电量统计 | | 获取设备信息 | `{"ctrl_cmd":{"get_info_cmd":{}}` | 获取设备完整信息 | ### 5.2. 参数设置&参数获取 参数表说明: 1. 参数表中的所有配置项都支持掉电保存 2. 当设备收到参数设置命令后,会返回一个"确认帧"或"否认帧"来表示设置是否成功 3. 当设备收到参数查询命令后,会返回包含查询参数值的应答帧,具体格式请参考: [[#5.6. 消息应答]] | 命令 | 设置参数 | 获取参数 | 默认值 | 说明 | | --------- | ------------------------------------------------------- | ----------------------------------------------- | -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | | 设备ID | `{"set_param":{"device_id":"dev001"}}` | `{"get_param":{"device_id":{}}}` | WiFi MAC地址 | 设置设备ID后会自动更新:<br>device_sub_topic为"{device_id}/device_sub_topic"、<br>2. device_pub_topic为"{device_id}/device_pub_topic"、<br>3. ap_ssid为"esp_{device_id}" | | MQTT服务器 | `{"set_param":{"mqtt_server":"xxx.xxx.xxx"}}` | `{"get_param":{"mqtt_server":{}}}` | 10.100.110.166 | MQTT服务器地址 | | MQTT端口 | `{"set_param":{"mqtt_port":1883}}` | `{"get_param":{"mqtt_port":{}}}` | 1883 | MQTT服务器端口 | | MQTT用户名 | `{"set_param":{"mqtt_username":"xxxx"}}` | `{"get_param":{"mqtt_username":{}}}` | CBOX | MQTT服务器用户名 | | MQTT密码 | `{"set_param":{"mqtt_password":"xxxx"}}` | `{"get_param":{"mqtt_password":{}}}` | A3mvi6e9 | MQTT服务器密码 | | WiFi SSID | `{"set_param":{"wifi_ssid":"xxxx"}}` | `{"get_param":{"wifi_ssid":{}}}` | RGJYMQ | WiFi网络名称 | | WiFi密码 | `{"set_param":{"wifi_pwd":"xxxx"}}` | `{"get_param":{"wifi_pwd":{}}}` | wlw5018926 | WiFi网络密码 | | 按键锁定 | `{"set_param":{"key_lock":true}}` | `{"get_param":{"key_lock":{}}}` | false | 设置按键锁定状态,true表示锁定,false表示解锁,锁定后物理按键的所有操作(短按、长按、双击等)都将被禁用,详见第七章说明 | | 网络调试状态 | `{"set_param":{"net_console_en":true}}` | `{"get_param":{"net_console_en":{}}}` | false | 设置网络调试功能的启用状态 | | 串口调试状态 | `{"set_param":{"com_console_en":true}}` | `{"get_param":{"com_console_en":{}}}` | true | 设置串口调试功能的启用状态 | | 网络调试主题 | `{"set_param":{"device_net_console_topic":"xxxx"}}` | `{"get_param":{"device_net_console_topic":{}}}` | "device_net_console_topic" | 设置网络调试主题 | | 软件版本号 | - | `{"get_param":{"soft_ver":{}}}` | 1 | 只读参数 | | 硬件版本号 | - | `{"get_param":{"hard_ver":{}}}` | 1 | 只读参数 | | 协议版本号 | - | `{"get_param":{"protocol_ver":{}}}` | 1 | 只读参数 | | 编译时间 | - | `{"get_param":{"build_datetime":{}}}` | "240101120203" | 只读参数 | | 参数版本号 | - | `{"get_param":{"param_ver":{}}}` | 1 | 只读参数 | | 完整版本号 | - | `{"get_param":{"full_ver":{}}}` | - | 只读参数 | | WiFi信号强度 | - | `{"get_param":{"rssi_abs":{}}}` | - | 只读参数,单位:dBm | | 设备订阅主题 | `{"set_param":{"device_sub_topic":"device_sub_topic"}}` | `{"get_param":{"device_sub_topic":{}}}` | "device_sub" | 设置设备订阅主题 | | 设备发布主题 | `{"set_param":{"device_pub_topic":"device_pub_topic"}}` | `{"get_param":{"device_pub_topic":{}}}` | "device_pub" | 设置设备发布主题 | | 心跳包使能 | `{"set_param":{"ping_en":true}}` | `{"get_param":{"ping_en":{}}}` | true | 设置心跳包使能状态 | | 心跳包周期 | `{"set_param":{"ping_interval_s":60}}` | `{"get_param":{"ping_interval_s":{}}}` | 120 | 设置心跳包上报周期,单位,秒 | | 继电器状态 | `{"set_param":{"relay":true}}` | `{"get_param":{"relay":{}}}` | true | 继电器状态 | | 过压阈值 | `{"set_param":{"over_voltage_v_th":250}}` | `{"get_param":{"over_voltage_v_th":{}}}` | 260 | 设置过压保护阈值(单位:V) | | 低压阈值 | `{"set_param":{"low_voltage_v_th":200}}` | `{"get_param":{"low_voltage_v_th":{}}}` | 180 | 设置欠压保护阈值(单位:V) | | 过流阈值 | `{"set_param":{"over_current_ma_th":2000}}` | `{"get_param":{"over_current_ma_th":{}}}` | 5100 | 设置过流保护阈值(单位:mA) | | 欠流阈值 | `{"set_param":{"low_current_ma_th":2000}}` | `{"get_param":{"low_current_ma_th":{}}}` | 100 | 欠流保护阈值(单位:mA) | | 过载阈值 | `{"set_param":{"over_power_w_th":2200}}` | `{"get_param":{"over_power_w_th":{}}}` | 1100 | 设置过载保护阈值(单位:W) | | 欠载阈值 | `{"set_param":{"low_power_w_th":2200}}` | `{"get_param":{"low_power_w_th":{}}}` | 10 | 设置欠载保护阈值(单位:W) | | 过温阈值 | `{"set_param":{"over_temperature_c_th":75}}` | `{"get_param":{"over_temperature_c_th":{}}}` | 60 | 设置过温保护阈值(单位:℃) | | 欠温阈值 | `{"set_param":{"low_temperature_c_th":75}}` | `{"get_param":{"low_temperature_c_th":{}}}` | 5 | 设置过温保护阈值(单位:℃) | | 电压值 | - | `{"get_param":{"voltage_v":{}}}` | - | 只读参数,单位:V | | 电流值 | - | `{"get_param":{"current_ma":{}}}` | - | 只读参数,单位:mA | | 功率值 | - | `{"get_param":{"power_w":{}}}` | - | 只读参数,单位:W | | 温度值 | - | `{"get_param":{"temperature_c":{}}}` | - | 只读参数,单位:℃ | | 电流校准参数 | `{"set_param":{"current_calibration":100}}` | `{"get_param":{"current_calibration":{}}}` | 0 | 用于校准BL0937测量电流的误差,正值表示增加,负值表示减少,范围: -1000~1000 | | 电压校准参数 | `{"set_param":{"voltage_calibration":-50}}` | `{"get_param":{"voltage_calibration":{}}}` | 0 | 用于校准BL0937测量电压的误差,正值表示增加,负值表示减少,范围: -1000~1000 | | 温度校准参数 | `{"set_param":{"temperature_calibration":-50}}` | `{"get_param":{"temperature_calibration":{}}}` | 0 | 用于校准温度检测的误差,正值表示增加,负值表示减少,范围: -1000~1000 | | 用电量 | - | `{"get_param":{"power_consumption_w":{}}}` | - | 只读参数,用电量统计值,单位:W,通过开始电量统计和结束电量统计指令控制统计周期 | ### 5.3. 状态设置&状态获取 状态(Status)与参数(Param)的区别: 1. 状态是运行时的实时数据, 如当前电压、电流等测量值, 这些数据断电后不会保存 2. 当设备收到状态获取命令后, 会返回对应的状态值, 具体格式请参考: [[#5.6. 消息应答]] | 命令 | 设置状态 | 获取状态 | 说明 | | -------- | ---- | ------------------------------------------- | ------------------------------------------------------------------ | | WiFi信号强度 | - | `{"get_status":{"rssi_abs":{}}}` | 只读参数,WiFi信号强度的绝对值:<br>50: 非常好<br>60~70: 好<br>70~80: 一般<br>80~90: 差 | | 继电器状态 | - | `{"get_status":{"relay":{}}}` | 只读参数,继电器状态:<br>true: 闭合<br>false: 断开 | | 电压值 | - | `{"get_status":{"voltage_v":{}}}` | 只读参数,当前电压值,单位:V | | 电流值 | - | `{"get_status":{"current_ma":{}}}` | 只读参数,当前电流值,单位:mA | | 功率值 | - | `{"get_status":{"power_w":{}}}` | 只读参数,当前功率值,单位:W | | 温度值 | - | `{"get_status":{"temperature_c":{}}}` | 只读参数,当前温度值,单位:℃ | | 用电量 | - | `{"get_status":{"power_consumption_w":{}}}` | 只读参数,用电量统计值,单位:Wh | | 统计状态 | - | `{"get_status":{"power_stat_running":{}}}` | 只读参数,电量统计运行状态:<br>true: 正在统计<br>false: 未在统计 | ### 5.4. 事件上报 | 事件类型 | JSON 格式 | 说明 | | ---------- | -------------------------------------------------- | ------------- | | OTA 更新完成事件 | `{"event":{"ota_end_evt":更新结果}}` | OTA 升级完成后上报结果 | | 上电事件 | `{"event":{"powerup_evt":""}}` | 设备上电时上报 | | 重启事件 | `{"event":{"reboot_evt":""}}` | 设备重启时上报 | | 恢复出厂设置事件 | `{"event":{"factory_params_evt":""}}` | 恢复出厂设置时上报 | | 系统信息上报事件 | `{"event":{"report_sysinfo_evt":系统信息}}` | 上报系统所有可获取参数 | | 继电器状态变化事件 | `{"event":{"relay_state_change_evt":状态}}` | 继电器状态发生改变时上报 | | 断电事件 | `{"event":{"powerdown_evt":""}}` | 设备断电时上报 | | 电流过流事件 | `{"event":{"current_over_evt":当前电流}}` | 当检测到电流超过阈值时上报 | | 电流欠流事件 | `{"event":{"current_low_evt":当前电流}}` | 当检测到电流低于阈值时上报 | | 过流恢复事件 | `{"event":{"current_oeve_recovery_evt":当前电流}}` | 电流恢复正常后上报 | | 欠流恢复事件 | `{"event":{"current_low_recovery_evt":当前电流}}` | 电流恢复正常后上报 | | 电压过压事件 | `{"event":{"voltage_over_evt":当前电压}}` | 当检测到电压超过阈值时上报 | | 电压欠压事件 | `{"event":{"voltage_low_evt":当前电压}}` | 当检测到电压低于阈值时上报 | | 过压恢复事件 | `{"event":{"voltage_over_recovery_evt":当前电压}}` | 电压恢复正常后上报 | | 欠压恢复事件 | `{"event":{"voltage_low_recovery_evt":当前电压}}` | 电压恢复正常后上报 | | 功率过载事件 | `{"event":{"power_over_evt":当前功率}}` | 当检测到功率超过阈值时上报 | | 功率欠载事件 | `{"event":{"power_low_evt":当前功率}}` | 当检测到功率低于阈值时上报 | | 功率恢复事件 | `{"event":{"power_over_recovery_evt":当前功率}}` | 功率恢复正常后上报 | | 功率欠载恢复事件 | `{"event":{"power_low_recovery_evt":当前功率}}` | 功率恢复正常后上报 | | 温度过温事件 | `{"event":{"temperature_over_evt":当前温度}}` | 温度过温后上报 | | 温度欠温事件 | `{"event":{"temperature_low_evt":当前温度}}` | 温度低温后上报 | | 过温恢复事件 | `{"event":{"temperature_over_recovery_evt":当前温度}}` | 温度过温恢复后上报 | | 欠温恢复事件 | `{"event":{"temperature_low_recovery_evt":当前温度}}` | 温度低温恢复后上报 | | 按键短按 | `{"event":{"short_click_evt":""}}` | 按键被短按时触发 | | 按键长按 | `{"event":{"long_click_evt":""}}` | 按键被长按时触发 | | 按键超长按 | `{"event":{"extra_long_click_evt":""}}` | 按键被超长按时触发 | | 按键双击 | `{"event":{"double_click_evt":""}}` | 按键被双击时触发 | | 按键三击 | `{"event":{"triple_click_evt":""}}` | 按键被三级时触发 | ### 5.5. 主动上报 "硬件终端"间隔一定的时间,会往"服务器端",上报的报文 该报文是可选,可使用"参数设置"报文开启或关闭 可通过"参数设置"报文,设置上报时间间隔 | 消息类型 | JSON 格式 | 说明 | 支持型号 | | ---- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------- | ---- | | 心跳包 | `{"report":{"ping": { "device_id": "xxxx", "mac": "xx:xx:xx:xx:xx:xx", "device_type": "D2_SOC", "ip": "192.168.1.100", "ssid": "test_wifi", "relay_state": true, "hw_version": "1.0.0", "sw_version": "1.0.0", "voltage_v": 220, "current_ma": 1000, "power_w": 220, "temperature_c": 25 }}}` | 包含设备基本信息、电源状态、温度状态等完整信息 | ALL | ### 5.6. 获取设备信息应答 当设备收到 get_info_cmd 命令后，会返回以下格式的应答： ```json { "ask_cmd": { "get_info_cmd": { "device_id": "dev001", "mac": "xx:xx:xx:xx:xx:xx", "device_type": "D2_SOC", "ip": "192.168.1.100", "ssid": "test_wifi", "relay_state": true, "hw_version": "1.0.0", "sw_version": "1.0.0", "voltage_v": 220, "current_ma": 1000, "power_w": 220, "temperature_c": 25 } } } ``` ## 六、电量统计功能说明 ### 6.1. 功能概述 电量统计功能用于统计设备在一段时间内的用电量。该功能通过以下方式工作： 1. 通过控制指令开始和结束统计 2. 在统计期间，实时累加用电量 3. 结束统计时，自动清零，为下次统计做准备 ### 6.2. 通信流程 ```mermaid sequenceDiagram participant App as 应用终端 participant Device as 硬件终端 App->>Device: 发送开始统计指令 {"ctrl_cmd":{"start_power_stat_cmd":{}}} Device-->>App: 返回确认帧 {"ask":true} Note over Device: 清零统计值并开始累加 App->>Device: 查询当前用电量 {"get_status":{"power_consumption_w":{}}} Device-->>App: 返回当前累计值 {"ask_status":{"power_consumption_w":数值}} App->>Device: 发送结束统计指令 {"ctrl_cmd":{"stop_power_stat_cmd":{}}} Device-->>App: 返回确认帧 {"ask":true} Note over Device: 停止累加并自动清零 ``` ### 6.3. 相关指令说明 | 类型 | 指令 | 说明 | |------|------|------| | 控制指令 | `{"ctrl_cmd":{"start_power_stat_cmd":{}}}` | 开始电量统计 | | 控制指令 | `{"ctrl_cmd":{"stop_power_stat_cmd":{}}}` | 结束电量统计 | | 状态查询 | `{"get_status":{"power_consumption_w":{}}}` | 查询当前用电量统计值 | | 状态查询 | `{"get_status":{"power_stat_running":{}}}` | 查询统计运行状态 | ### 6.4. 工作原理 1. 开始统计： - 收到开始指令后，清零统计值并开始累加用电量 2. 结束统计： - 收到结束指令后，停止统计 - 自动清零统计值，为下次统计做准备 3. 查询结果： - 通过状态查询指令可随时获取当前累计用电量 - 单位为瓦时(Wh) ### 6.5. 注意事项 1. 统计过程中如果设备断电，统计将被中断并清零 2. 统计结果为实时累计用电量，单位为瓦时(Wh) 3. 可以随时查询当前累计值，不需要等待统计结束 4. 结束统计时会自动清零，下次开始统计时会重新开始计数 ## 七、按键锁定功能说明 ### 7.1. 功能概述 按键锁定功能用于控制设备物理按键的使能状态。该功能通过以下方式工作： 1. 通过参数设置命令开启或关闭按键锁定 2. 锁定状态下，短按操作将不起作用 3. 锁定状态掉电保存，重启后保持锁定状态 ### 7.2. 相关指令说明 | 类型 | 指令 | 说明 | |------|------|------| | 参数设置 | `{"set_param":{"key_lock":true}}` | 开启按键锁定 | | 参数设置 | `{"set_param":{"key_lock":false}}` | 关闭按键锁定 | | 参数查询 | `{"get_param":{"key_lock":{}}}` | 查询按键锁定状态 | ### 7.4. 注意事项 1. 按键锁定状态掉电保存，重启后状态不变 2. 锁定状态下物理按键无效，但不影响远程控制功能 3. 恢复出厂设置会将按键锁定状态恢复为默认值（false） 4. 建议在特殊场景下使用此功能，如防止他人误操作等
admin
2025年4月5日 02:53
转发文档
收藏文档
上一篇
下一篇
手机扫码
复制链接
手机扫一扫转发分享
复制链接
Markdown文件
分享
链接
类型
密码
更新密码