CATALOG

芯步AC1-10A这款智能通断器本身就带HTTP接口,这意味着你完全可以用自己熟悉的编程语言(Python、Node.js、PHP都行)把它集成到自己的系统里。下面我按“准备工作 → 单个控制 → 联动逻辑 → 状态监听”这个顺序来讲,代码示例会尽量口语化一些。

一、 先认识一下主角:AC1-10A 能干嘛?

在动手写代码之前,咱们得知道咱们控制的这个“小家伙”到底有啥能耐。

  • 核心功能:其实就是一路继电器开关。你可以通过给它发命令,让它“闭合”(通电)或“断开”(断电)。

  • 进阶功能:它支持“点动模式”。比如你可以设定让它“通电1秒后自动断开”,这在控制电动门锁或者自动喷水装置时非常好用

  • 触发方式:官方提供了HTTP接口、WebSocket,甚至还支持硬件上的信号输入触发

我们今天的重点是 HTTP 接口二次开发,这意味着只要你的电脑或服务器能上网,就能通过一行代码控制它。

二、 准备工作:先拿钥匙(AppID 和签名)

在开始写代码之前,你需要在芯步的开发者后台拿到三样东西:

  1. AppID:你的应用身份标识。

  2. AppSecret:你的应用密码(密钥)。

  3. Device ID:就是那个AC1-10A模块外壳上贴着的ID。

芯步的接口安全性做得比较规范,每次请求都需要加一个 动态签名。签名的算法如下

1. 先把 AppSecret 做一次 MD5 加密 -> 得到字符串 A2. 把 字符串A + 当前的时间戳(ts) 拼在一起 -> 再做一次 MD5 加密3. 最后得到的这一串,就是你的 sign

不要看到算法就头疼,其实代码写起来很简单:

签名生成逻辑(示例):

这个 ts(时间戳)和 sign(签名)在下面每次请求中都要带着。

三、 核心操作:怎么“点对点”控制它?

单个控制是整个联动逻辑的基础。我们要往 api.thingboot.com 这个地址发请求

命令格式:接口地址:https://api.thingboot.com/{AppID}/device/control/

需求场景:假设我要在自习室里,当用户扫码付款后,自动给 AC1-10A 通电,让他桌子上的插座有电。

代码示例(Python):

只要返回的 code200,就代表云平台已经收到了指令,你的设备马上就动作了

四、 进阶玩法:怎么实现“场景联动”?

这是你要的核心。所谓“场景联动”,就是 “当 A 事件发生,则 B 设备执行动作”

比如:当有人推开入户门(触发传感器),玄关的灯(AC1-10A)亮起。或者是:当有人按下你网页上的“紧急呼叫”按钮,休息室的风铃(AC1-10A控制的蜂鸣器)响一下。

实现这个,核心是两步走:

  1. 接收信号(触发源):你的服务器收到一个信号(可能是别的传感器、小程序按钮、甚至是闹钟)。

  2. 执行动作(控制模块):你的服务器收到信号后,立马去调用上述的 device/control 接口,告诉 AC1-10A 该干嘛。

这里以 “人体传感器联动灯光” 为例,写一个最简单的后端逻辑(伪代码):

解决方案逻辑流程:

如果不写代码,有没有其他联动方式?有的。芯步的设备支持“消息推送”。你可以把 AC1-10A 的状态变化推送到你自己的服务器 URL 上。比如,你把一个普通的翘板开关接到了 AC1-10A 的信号输入端,当有人按下开关,芯步的云平台会主动给你服务器发一条 HTTP 通知,你的服务器收到通知后,再去控制另一个设备,这样就实现了“物理按键控制远程设备”的硬联动

五、 进阶玩法:高级控制指令(点动与延时)

在场景联动中,有时候不是单纯地开或关,而是需要一瞬间的动作。

比如控制电动卷帘门:你需要给它一个“正转”信号,2秒后停止。如果单纯地用 power=1 然后 power=0,网络延迟会导致这中间的时间差很不准确。

AC1-10A 支持硬件级别的 先通后断点动。你只需要发一条指令,设备内部芯片就会自己计时,不依赖网络。

接口调用示例:如果你想让设备 接通 500 毫秒后自动断开(这就是个完美的点动脉冲,适合模拟按键):

六、 总结:你的云-管-端架构图

如果把这套方案落地,你的系统架构大概是这样的:

  1. 端(AC1-10A):执行命令。通过 Wi-Fi 连接在云端。

  2. 管(HTTP API & MQTT):云平台提供的接口管道。

  3. 云(你的服务器):大脑核心。负责接收外界信号(扫码、传感器、按钮),并决策何时调用接口。

几点贴心提示:

  • 关于签名:官方 C 语言示例里特意强调了时间戳 ts 的一致性,如果你发现调用失败,八成是服务器时间和标准时间对不上,或者 MD5 大小写写错了

  • 关于反馈:接口返回 200 只代表指令发出成功,不代表设备真的执行了。如果你需要确认设备真的“咔嗒”一下通电了,需要配置消息推送功能,让设备执行成功后在回调里告诉你

  • 适用场景:这种方案特别适合 共享棋牌室、自习室、智慧农业大棚 这种需要把硬件嵌入到现有的 SaaS 系统里的场景。

希望这份方案能帮到你,动手试试吧,只要第一个 Hello World 跑通了,剩下的就是做填空题了!

通断器产品方案:
共享场馆照明系统控制:怎样将4400W 线路控制器对接到自己的项目中
查看 >>
怎么在普通灯具系统交流控制中接入智能设备来实现远程批量控制
查看 >>
共享麻将馆灯光插座管理:怎么将DC-10A 电器开关集成到自己的项目中
查看 >>
怎么接入DC-10A 设备电源控制器以实现远程定时任务控制
查看 >>
校园公共设备电源管理中:怎样把AC3-10A 计量版电源开关接入到软件项目中
查看 >>
联动场景方案:
怎样在活动现场人体感应与火灾预警中接入智能设备以实现消防预警联动
查看 >>
如何在弱电间空调联动中接入智能设备以实现空调风力调节
查看 >>
怎么二次开发50A带计量数显物联网断路器来实现场景联动控制
查看 >>
怎么二次开发双路智能墙壁控制开关以实现门禁与照明联动控制
查看 >>
怎样在商业空间门禁照明联动控制中接入智能硬件来实现设备运行状态监控
查看 >>
场景用途方案:
如何接入8位总控PDU插排以实现场景联动总控电源
查看 >>
怎样对接智能直流控制器4路以实现联动场景逻辑控制
查看 >>
如何在共享棋牌室设备电源集中管理中接入智能设备来实现自定义场景联动控制
查看 >>
怎么接入2路智能墙壁开关以实现场景联动照明门禁控制
查看 >>
怎么接入24 路智能分体远程控制设备联动模块以实现场景模式一键切换
查看 >>