芯步智能通断器的开放接口支持“按钮动作可屏蔽”这一配置项,实现逻辑是:在设备初始化时通过API禁用本地按钮,此后物理按键失效,所有控制完全由云端或本地HTTP指令接管。以下是具体方案。
1. 核心实现逻辑
要实现“按钮动作屏蔽”,核心在于利用设备配置接口,将设备的本地按钮功能逻辑设置为禁用。
原理:智能通断器内部有MCU(微控制单元)处理本地按键事件。通过HTTP接口修改设备寄存器中的
button_mode(按钮模式)或disable_button(禁用按钮)标志位,MCU在执行循环时便会跳过对按键响应的代码段,从而实现物理屏蔽。效果:设置成功后,无论用户如何按动设备外壳上的物理按钮,继电器状态都不会改变。此时设备完全受控于云端或局域网下发的指令。
2. 准备工作
在开始对接前,请确认以下信息:
硬件确认:请确保使用的设备型号支持“按钮动作可自定义、可屏蔽”功能。经查,芯步的AC3、AC4-10A、AC4-20A、AC5-10A等系列均支持该特性。
凭证获取
AppID / AppSecret:登录芯步控制台,在“开发设置”中获取。
Device ID:在控制台设备列表或通过设备配网后获取。
接口地址
云端API
https://api.thingboot.com/{AppId}/device/control/局域网API(推荐,低延迟):
http://[设备IP]/control/(需设备与服务器在同一网段或开启局域网控制功能)。
3. 详细对接步骤
第一步:动态签名计算 (Signature)
芯步的接口通常需要动态签名验证。请求需携带sign和ts参数。
签名算法(推测/逻辑还原)
(注:实际签名规则请以官方最新文档为准,核心是将密钥与时间戳混合加密以防止重放攻击)。
第二步:下发屏蔽指令 (核心配置)
请求示例(假设云端API):
根据资料,除了直接的锁定指令,有时也可以通过配置按钮的“可自定义”模式来实现屏蔽,或者通过设置“无功能”模式来达到屏蔽效果。具体的order字段命名可能包括:
{"button_enable": 0}{"btn_lock": 1}{"key_disabled": true}
注意:具体使用的字段名需参考对应型号的设备手册。例如智能通断器AC5-10A的文档中提及“可设定5组WiFi网络”,其配置接口中包含了按钮行为的定义区域。
第三步:验证与状态查询
下发指令后,查询一次设备状态以确认设置生效。
查询请求
预期返回:应在返回的JSON数据包中看到类似 "button_status": "disabled" 的字段。
4. 多种屏蔽策略场景
根据“按钮动作可自定义”的特性,您可以实现比单纯屏蔽更复杂的逻辑:
| 模式 | 实现指令 | 应用场景 |
|---|---|---|
| 完全屏蔽 | {"button_lock":"1"} | 防止儿童误触、公共场所设备、确保远程独占控制。 |
| 仅本地限时屏蔽 | 发送{"button_lock":"1"} + 定时任务 | 在特定时间段(如夜间)物理按钮无效,白天恢复。 |
| 紧急解锁 | 发送{"button_lock":"0"} | 在服务器维护或断网前,提前解锁物理按钮,作为应急备份控制。 |
5. 故障排除和需要注意的点
固件版本:若发现指令下发成功但按钮仍可操作,请检查设备固件是否已升级至最新版。老旧固件可能不支持按钮逻辑改写。
断电记忆:注意设备的“断电记忆”功能。如果设备断电重启后,按钮屏蔽状态恢复成了未屏蔽,说明该设备的按钮状态可能未被写入EEPROM(电可擦可编程只读存储器)。在程序逻辑中增加设备上线通知触发重新下发屏蔽指令的机制。
配网模式:在配网期间(通常为慢闪状态),按钮可能具有强制复位/配网功能。逻辑上无法通过软件屏蔽此阶段的按键(这属于硬件级恢复机制)。如需彻底屏蔽,可考虑物理短接或剪断按钮引脚。
6. 方案总结
通过芯步开放的HTTP接口,您可以非常便捷地实现对智能通断器物理按钮的远程屏蔽控制。上述方案的实施路径如下:获取凭证 → 计算签名 → 下发button_lock锁定指令 → 执行控制。利用这一特性,您可以构建更安全、更专业的B端应用(如共享设备、工业控制等)。