CATALOG

芯步的智能墙壁开关通过标准HTTP接口开放控制能力,可在10-15分钟内完成对接。以下方案涵盖接口调用、签名生成和四种常用控制模式(基本开关、状态保持、点动触发等),支持任何能发起HTTP请求的编程语言或平台。

1. 解决概述

基于芯步开放平台,利用其提供的标准化HTTP APIs,对接“智能墙壁开关1路”设备。通过向云端发送JSON格式的指令,实现通过公网远程控制照明或设备的开/关。该方案支持任何能发起HTTP请求的编程语言(如Python, PHP, Java, Go)或工具(如Postman, 小程序)。

适用场景

  • 共享空间:自习室、棋牌室灯位控制。

  • 智慧办公:定时关闭空调/照明节能。

  • 智能家居:远程关灯、离家模式一键断电。

2. 核心对接准备

在开始编码前,需完成以下准备工作:

  1. 硬件准备

    • 购买芯步智能墙壁开关1路(标准86型,需接入零火线或单火,具体视型号而定)

    • 安装并通电,确认设备指示灯状态正常。

  2. 平台准备

    • 访问芯步官网,注册并登录账号

    • 在“控制台”中创建应用,获取唯一的 AppIDAppSecret(用于生成签名)

  3. 设备配网

    • 使用“芯步”微信小程序或控制台,将设备连接至2.4GHz WiFi网络,确保设备在线

3. 接口调用流程

芯步的接口设计非常简洁,核心逻辑为:向特定URL POST一个包含设备ID和命令的JSON包

  • 请求地址https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}

    • {AppID}:你的应用ID。

    • {sign}:按规则生成的签名,用于鉴权。

    • {ts}:当前Unix时间戳(秒)。

  • 请求方法:POST

  • 请求头Content-Type: application/json

  • 请求体 (Body)

鉴权参数生成说明

为了安全,接口使用动态签名。以AppSecret为密钥,将AppID + ts进行加密(通常为MD5),生成sign。

4. 核心控制指令详解

针对“1路远程控制”,主要利用order字段中的以下参数进行控制。

功能类型JSON 命令示例适用场景
即时开关{"power1":"1"} (开) {"power1":"0"} (关)基础远程开关灯。
状态保持{"power1":{"keep":"1","revert":"3"}}酒店/KTV场景:用户按下物理按键关灯,3秒后自动恢复照明;防止客人误触全黑。
点动/脉冲{"point1":"2000"}控制门禁或电机:先通电,延时2秒后自动断电。
先断后通{"reset1":"3000"}重启路由器或设备:先断电复位,3秒后重新上电。

*注:power1中的1代表第一路。

5. 实战对接示例

以下提供三种常见开发环境下的对接代码逻辑。

Python 示例

PHP 示例

微信小程序示例

注:实际使用时需将{AppID}替换,并处理好signts参数。

6. 高级功能:状态实时反馈

单纯的“发命令”是不够的,系统需要知道“灯到底开了没”。芯步支持消息推送机制:

  1. 设置接收URL:在平台控制台设置你的服务器URL(例如:http://yourdomain.com/api/device_callback)。

  2. 接收数据:当设备状态变化(物理按键按下、指令执行成功、设备重启)时,平台会主动将设备状态推送到该URL。

  3. 数据格式:平台会POST一个JSON包到你的服务器,包含设备ID、当前状态(power1:1)等。

    • 这样你就可以在自己的数据库中实时同步设备状态,避免“状态不同步”的问题。

7. 注意事项

  1. 网络稳定性:设备仅支持2.4G WiFi,不支持5G频段。确保现场WiFi信号覆盖良好

  2. 负载限制:单路负载功率不超过1000W,若控制LED灯需注意可能存在的“幽灵闪烁”现象,必要时需并联电容(产品通常随箱配有电容)

  3. 私有化部署:如果你有内网安全需求,芯步支持私有化部署,API地址可切换为局域网IP,无需经过公网,响应更快(可低至80ms)

通过以上步骤,你即可在10-15分钟内完成从注册到代码调用,实现对芯步1路墙壁开关的远程控制集成。