CATALOG

芯步这款16路控制器用HTTP接口控制,说白了就是发“网络指令”的事儿。下面直接说人话,讲清楚怎么一步步对接。

1. 准备工作:先让设备“上网”

写代码之前,你得先把硬件伺候好,确保它在你的局域网里,或者能连上芯步的云平台。

  • 硬件接线:这东西需要 12V 2A 供电。接好电,网口插上网线(或者配置好WiFi)。

  • 找设备ID:登录芯步后台,找到你绑定的这个设备,复制那串 设备ID(比如截图里的 1878),等下代码里要用

2. 核心原理:它认“暗号”不认人

这个模块的接口是通用的 HTTP 协议,说白了就是调用一个网址。为了安全,平台有个 签名机制,防止别人随便控制你的设备。

签名算法给你翻译成人话:

把你手里的 AppSecret(开发者密码)先做一次 MD5 加密,得到一串字母数字。然后把 当前的时间戳 拼在这串字母后面。最后,把 拼好的新字符串 再做一次 MD5 加密,这时候得到的值就是 sign

公式看着唬人,逻辑就是:sign = MD5( MD5(AppSecret) + ts )

3. 实战对接:如何控制第8路继电器亮灯?

我们要控制的是“16路输出”,命令参数在官方文档里有,就是 power1power16

假设我们要 关闭第8路(注意协议里通常 1 是接通,0 是断开):

命令生成示例 (JSON格式):

完整请求地址:https://api.thingboot.com/你的AppID/device/control/?sign=计算出的签名&ts=当前时间戳

通俗解释一下这段代码在干什么:它在告诉服务器:“我是开发者AppID对应的人,我在当前这个时间点(ts)发请求,这是我的证件(sign),请帮我把 device 这个设备的第8路电给断了。”

4. 代码怎么写?用一个 Curl 示例看明白

别被代码吓到,逻辑就是打包数据、加上签名、发请求。

5. 高级玩法:让16路“一起动”

有时候你要开一个机器,可能需要同时启动好几个继电器。

方式一:逐个发命令(不推荐)发16次请求。这样很慢,而且网络延迟会导致第1路和第16路启动时间差半秒钟,对于有些电机来说容易出问题。

方式二:批量控制(推荐)这个模块支持 batch 命令

批量命令示例:

解释一下:"FFFF" 是16进制的。比如你只想让第1路和第16路通,其他关,可以算出一个值。这样 一个请求搞定16个开关,没有延迟。

6. 连线时要注意的“坑”

这部分属于“血的教训”,多看两眼:

  • 带不动大电机? 这个板子直接输出适合小负载。如果接大功率交流接触器或者大电机,千万不要直接接在板子的端子上!要拿板子当“开关”,去控制一个交流接触器,再用接触器去控制负载

  • 负载类型:如果接的是LED灯或电机,属于“感性负载”,实际能带的功率要打折,别怼满

  • 调试模式:刚开始写代码如果老报签名错误,去后台把“调试模式”打开,可以临时跳过签名校验,先调通流程,最后再回去搞那个加密算法

总结一下:对接这个模块,就是往 api.thingboot.com 发一个 POST 请求。只要把 AppSecret 的签名算对,把 powerX 的参数传对,硬件那边瞬间就动作了。

控制器产品方案:
怎么二次开发24 路智能分体远程控制设备联动模块以实现多达24路独立线路控制
查看 >>
怎样在店铺照明设备控制中集成智能设备以实现4路独立线路控制
查看 >>
怎么接入智能 24 路远程开关控制模块以实现自定义场景联动控制
查看 >>
照明控制:如何将8路防水防尘控制箱对接到项目中
查看 >>
线下服务门店包间管理:如何将8路包间综合管理控制器接入到项目中
查看 >>
直流场景方案:
怎样在共享自习室 LED 灯条控制中集成智能硬件来实现低压直流负载通断控制
查看 >>
怎么在产线设备控制中接入智能设备来实现控制8路交直流输出
查看 >>
LED灯光系统直流控制:如何将ThingBoot 2路直流控制器接入到项目中
查看 >>
如何在配电柜智能改造中接入智能设备来实现控制 24 路交直流输出
查看 >>
如何在养老社区公共设备控制中集成智能设备以实现控制24路交直流输出
查看 >>
16路用途方案:
怎么在养老社区公共区域电源管理中接入智能硬件来实现16路独立回路远程控制
查看 >>
如何在自助储物柜控制中集成智能设备来实现16路多通道独立控制
查看 >>
怎么二次开发智能 16 路远程线路管理控制器以实现控制16路交直流输出
查看 >>
怎么在快递柜设备控制中集成智能硬件来实现远程控制16路线路
查看 >>
怎样在自助洗车设备线路控制中集成智能设备以实现16路多通道独立控制
查看 >>