CATALOG

芯步智能通断器的开放接口支持“按钮动作可屏蔽”这一配置项,实现逻辑是:在设备初始化时通过API禁用本地按钮,此后物理按键失效,所有控制完全由云端或本地HTTP指令接管。以下是具体方案。

1. 核心实现逻辑

要实现“按钮动作屏蔽”,核心在于利用设备配置接口,将设备的本地按钮功能逻辑设置为禁用

  • 原理:智能通断器内部有MCU(微控制单元)处理本地按键事件。通过HTTP接口修改设备寄存器中的button_mode(按钮模式)或disable_button(禁用按钮)标志位,MCU在执行循环时便会跳过对按键响应的代码段,从而实现物理屏蔽

  • 效果:设置成功后,无论用户如何按动设备外壳上的物理按钮,继电器状态都不会改变。此时设备完全受控于云端或局域网下发的指令。

2. 准备工作

在开始对接前,请确认以下信息:

  1. 硬件确认:请确保使用的设备型号支持“按钮动作可自定义、可屏蔽”功能。经查,芯步的AC3、AC4-10A、AC4-20A、AC5-10A等系列均支持该特性

  2. 凭证获取

    • AppID / AppSecret:登录芯步控制台,在“开发设置”中获取。

    • Device ID:在控制台设备列表或通过设备配网后获取。

  3. 接口地址

    • 云端APIhttps://api.thingboot.com/{AppId}/device/control/

    • 局域网API(推荐,低延迟):http://[设备IP]/control/(需设备与服务器在同一网段或开启局域网控制功能)

3. 详细对接步骤

第一步:动态签名计算 (Signature)

芯步的接口通常需要动态签名验证。请求需携带signts参数

签名算法(推测/逻辑还原)

(注:实际签名规则请以官方最新文档为准,核心是将密钥与时间戳混合加密以防止重放攻击)

第二步:下发屏蔽指令 (核心配置)

请求示例(假设云端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. 故障排除和需要注意的点

  1. 固件版本:若发现指令下发成功但按钮仍可操作,请检查设备固件是否已升级至最新版。老旧固件可能不支持按钮逻辑改写

  2. 断电记忆:注意设备的“断电记忆”功能。如果设备断电重启后,按钮屏蔽状态恢复成了未屏蔽,说明该设备的按钮状态可能未被写入EEPROM(电可擦可编程只读存储器)。在程序逻辑中增加设备上线通知触发重新下发屏蔽指令的机制。

  3. 配网模式:在配网期间(通常为慢闪状态),按钮可能具有强制复位/配网功能。逻辑上无法通过软件屏蔽此阶段的按键(这属于硬件级恢复机制)。如需彻底屏蔽,可考虑物理短接或剪断按钮引脚

6. 方案总结

通过芯步开放的HTTP接口,您可以非常便捷地实现对智能通断器物理按钮的远程屏蔽控制。上述方案的实施路径如下:获取凭证 → 计算签名 → 下发button_lock锁定指令 → 执行控制。利用这一特性,您可以构建更安全、更专业的B端应用(如共享设备、工业控制等)。