2路直流智能开关的联动控制,核心在于将传感器的状态变化通过业务逻辑转化为开关指令。芯步的开放接口支持HTTP和MQTT两种协议,以下方案涵盖设备对接、签名认证、联动引擎设计三个关键环节。
1. 概述
本方案的目标是指导开发者如何利用芯步开放平台及智能硬件产品的HTTP API接口,实现对2路直流智能开关的程序化控制和复杂的联动场景逻辑搭建。
通过对接芯步的开放接口,您可以摆脱手动控制,将智能开关无缝集成到现有的软件系统(如APP、Web后台、SaaS平台)中,实现基于传感器数据、定时任务或业务事件的自动化联动。例如:当温度传感器检测到超温时,自动切断开关线路;或通过定时任务实现设备的间歇性通断。
2. 核心设备与接口能力
在开始开发前,我们需要明确2路直流智能开关的技术特性。根据芯步提供的产品手册,该类设备具备以下核心开放能力:
双路独立控制:支持独立控制线路1和线路2,互不干扰。
多样化控制指令
通断控制
power1/power2– 立即改变开关状态。点动控制(先通后断/先断后通) :
point1/reset1– 适用于触发闸机、门禁或脉冲设备。状态锁定:支持保持特定状态(常用于安防联锁)。
通信协议:支持HTTP API(公网/局域网)及MQTT协议,满足高实时性或高安全性场景。
3. 对接准备工作
在编写代码之前,您需要完成以下环境配置:
注册与创建:注册芯步账号并创建工作台。
获取密钥:在“物联网控制台” -> “开发设置”中获取
AppID和AppSecret。这是调用API的身份凭证。设备配网:将2路直流智能控制器接通电源,通过“芯步”小程序或控制台将其配网至您的账户下。记录下生成的
DeviceID。
4. 接口鉴权与连接实现
芯步采用动态签名验证机制,所有API请求均需携带 sign(签名)和 ts(时间戳)。
4.1 签名生成规则
为了防止请求被伪造,签名算法采用双重MD5加密:Sign = MD5 ( MD5(AppSecret) + ts )
步骤一:对
AppSecret进行MD5加密得到Secret_MD5。步骤二:将
Secret_MD5与当前时间戳ts(秒级)拼接成字符串。步骤三:对拼接后的字符串再次进行MD5加密,得到最终
sign。
4.2 接口调用示例:控制线路通断
请求地址https://api.thingboot.com/{AppID}/device/control/
请求方法:POST (Content-Type: application/json)
核心参数示例(控制设备ID为“1878”的开关接通第1路线路):
实现逻辑:您只需要构建上述JSON,带上正确的签名,向服务器发起POST请求即可。如果设备在线且指令正确,开关将瞬间执行动作。
5. 典型联动场景逻辑构建
这是最核心的部分。利用开放接口,您可以设计各种复杂的“If This Then That”逻辑。
第一种场景:基于环境传感器的安全联动
需求:当仓库温度超过阈值或烟雾传感器报警时,自动断开2路直流开关的总电源,防止火灾。实现方案
数据接收:您的服务器接收芯步平台推送的传感器数据(或主动轮询)。
逻辑判断:后端代码判断
temperature > 70或smoke = 1。干预机制:满足条件则触发保护机制——向设备发送
{"power1":0, "power2":0}命令,实现双路断开。告警恢复:在未收到人工复位指令前,系统可设计为屏蔽对该设备的下发指令,确保安全。
第二种场景:定时脉冲控制
需求:每隔10分钟,让开关的第1路接通2秒后自动断开(类似按下复位键)。实现方案
调度任务:在您的业务系统中设置一个定时任务(Cron Job)。
指令下发:定时任务触发后,调用
point1命令。注:具体参数格式需参考产品手册,该命令通常会让线路自动执行“通->断”脉冲动作。
第三种场景:双路互锁逻辑
需求:控制电机正反转,第一路接通时,第二路必须断开;第二路接通时,第一路必须断开。实现方案在您的业务逻辑代码中维护状态机:
要开启A路:先下发指令关闭B路,读取反馈确认B路已断开后,再下发指令开启A路。
启用状态保持:利用设备的“状态保持”功能,防止物理按键误触破坏互锁状态。
6. 高级联动架构:事件驱动模型
为了提供更流畅的体验,不完全依赖轮询(Pull)。芯步平台支持消息推送机制。
架构图解
传感器/开关动作->芯步云->HTTP推送->您的服务器Webhook实施步骤
在控制台设置您的服务器接收地址(URL)。
当用户按下开关的物理按键时,平台会立即向该URL发送JSON数据(包含设备ID,按下的按钮状态)。
您的服务器接收此事件,触发相应的自动化工作流(如:记录日志或触发其它设备的联动)。
回调确认:处理完业务逻辑后,您的服务器需返回特定的成功标识,平台会识别为推送成功。
7. 局域网与高可用方案
对于对公网依赖较低或追求极低延迟的生产环境:
局域网通信:芯步设备支持局域网直连。如果您的服务器与智能控制器处于同一局域网(LAN),可以直接通过设备的局域网IP进行HTTP控制,无需经过云端,极大提高响应速度和稳定性。
私有化部署:对于高安全要求的政企客户,支持将MQTT Broker(消息代理)部署在内网,实现数据完全隔离。
8. 总结
通过对接芯步的2路直流智能开关开放接口,开发者可以轻松实现以下目标:
快速集成:简单的HTTP请求逻辑,可在数小时内完成POC测试。
场景丰富:结合点动、互锁、定时等指令,满足工控、农业、智能家居等绝大多数场景需求。
健壮性:支持局域网控制与异步消息推送,确保指令不丢失、执行有反馈。
技术支持:官方提供全套API文档和免费的技术指导支持,助力项目快速落地。
请请一定要参阅对应型号的《产品手册》以获取精确的参数定义(如电压类型是DC还是AC,以及最大负载),确保物理接线安全。