CATALOG

这是一个相对简单的过程,芯步的控制器开放了标准的HTTP API接口,只要你懂一点代码(比如Python、Java甚至只是用Postman工具),就可以轻松集成。

下面是详细对接方案。

一、 准备工作:硬件接线与上电

首先要明确你要控制什么设备,比如是12V的LED灯带还是24V的电磁阀?

接线逻辑在你手上的“2路直流负载控制器”上,一般会有明确的标识:

  1. 输入端:接你的直流电源(比如12V蓄电池或开关电源),注意正负极,VCC接正极,GND接负极

  2. 输出端

    • 通道1OUT1+OUT1-,接负载1(比如LED灯)。

    • 通道2OUT2+OUT2-,接负载2(比如小风扇)。

    • 这里有个小细节:有些控制器是“共正极”接法,即输入端正极直通负载,控制器只控制负极通断;有些是“双线通断”。接线前瞄一眼设备侧面的接线图就好。

接好线,给控制器供上电。等个几秒钟,如果看到设备指示灯在闪,说明它在尝试联网了。

二、 核心对接:设备怎么入网?

要让控制器能被云端控制,首先得给它连上Wi-Fi。这里有一个比较省事的办法:

芯步的设备通常支持“智能配网”“AP热点配网”。一般流程是:

  1. 手机连上你现场的2.4G Wi-Fi。

  2. 打开微信小程序或官方App(比如“物联网控制台”),扫描设备上的二维码。

  3. 按照提示输入Wi-Fi密码,手机发出声波或信号,设备收到信息后自动连网。

连上网之后,设备指示灯会变成常亮。这时候,你登录芯步的后台,在“设备列表”里就能看到这个设备了,那里会有一个一串数字的“设备ID”(Device ID),记下来,待会儿要用。

三、 技术对接:HTTP接口调用教程

这是对接的关键部分。芯步的接口设计得比较简洁,不需要复杂的SDK,直接发HTTP请求就行

1. 先搞到密钥(AppID 和 AppSecret)

登录芯步开放平台或工作台:

  • 进入“开发设置”页面。

  • 你会看到系统分配给应用的 AppID(相当于用户名)和 AppSecret(相当于密码)。

特别提醒AppSecret 别明码写在网页前端代码里,那会暴露你的密钥。这一步应该在后台服务器去执行。

2. 生成签名(Sign)

为了防止接口被人乱刷,每次请求都要带一个动态签名。他们用的是MD5双重加密,算法规则如下

公式sign = md5( md5(AppSecret) + ts )

举个例子(假设 AppSecret = abc123,当前时间戳 ts = 1712000000):

  1. 先算 md5(“abc123”),假设结果是 xyz...

  2. xyz... 拼接上时间戳,变成 xyz...1712000000

  3. 再对这个字符串做一次 md5,最后的结果就是 sign

AppIDsignts 三个参数拼接在请求地址后面

3. 下发命令:控制开关

这是最直接的环节——发送指令来“闭合”或“断开”继电器。

请求地址(用POST方式):https://api.thingboot.com/{你的AppID}/device/control/?sign={你的签名}&ts={时间戳}

请求体参数

  • device:填入刚才记下的设备ID。

  • order:这是一个JSON字符串,用来告诉设备做什么。

针对“2路控制器”的命令示例

  • 关闭第2路负载(比如关排风):如果你想关掉第二路,order{"power2":0}

  • 打开第1路负载(比如开水泵):想把第一路接通,order{"power1":1}

4. 附赠功能:查状态和批量控制

  • 查状态:一般调用 /device/status 接口,传入设备ID,就能知道现在是通电还是断电了。

  • 批量控制device 参数支持一次传多个ID,用逗号隔开就行。比如 device=123,456,一条指令就能把整个车间的灯全关了。

四、 实战代码片段(Python + Bash)

因为是开放接口,用什么语言写都行。Python示例:

更直接一点,curl命令(直接在Linux终端跑也行):

五、 踩坑和需要注意的点

  1. 千万不要接220V:你选的是“直流控制器”,输入的电压有范围限制(比如12V或24V)。千万别手误把它直接插到插座上,否则控制器会烧。

  2. 注意控制的反常识逻辑:有些控制器的 power1=0 代表继电器断开(电路不通),power1=1 代表吸合(电路通)。如果你发现逻辑反了,在代码里把1和0互换一下就行,不用重新接线

  3. 局域网模式:如果你那边没有外网,或者对速度要求比较高(毫秒级响应),这个设备其实支持局域网纯内网控制。也就是不经过云平台,直接在局域网里发HTTP请求,这样速度和稳定性都更可靠,不过这需要你部署私有化的消息服务器

总结

整个对接流程概括就是:接好线 -> 设备连Wi-Fi -> 后台拿Key -> 代码发{"power1":1}

按照这个思路操作,半小时内基本就能把第一盏灯点起来了。

控制器产品方案:
4路共享空间智能控制器MINI:怎么把4路包间电源智能控制器MINI对接到自己的项目中
查看 >>
如何二次开发4 路智能照明控制器来实现定时开关照明设备电源
查看 >>
怎样在无人值守包间设备控制中接入智能设备以实现HTTP接口远程独立控制通断
查看 >>
无人值守包间设备控制:怎么将8路包间设备集中控制器集成到软件项目中
查看 >>
共享自习室包间管理:怎么将8路包间灯光空调控制器接入到软件项目中
查看 >>
低压场景方案:
怎样对接2路直流负载控制器来实现低压直流负载通断控制
查看 >>
智能家居低压设备控制:怎么把2路直流电压版控制器集成到软件项目中
查看 >>
如何在共享民宿氛围灯控制中中接入智能硬件以实现低压直流负载通断控制
查看 >>
实验室低压负载控制:如何将DC-10A 远程电源控制器对接到自己的项目中
查看 >>
实验室低压负载控制:如何将DC-10A 物联网开关集成到软件项目中
查看 >>
通断用途方案:
怎么二次开发20A智能空开来实现延时通断控制
查看 >>
怎么接入60A带计量远程控制断路器来实现定时通断控制
查看 >>
怎样对接 8 路智能交流控制模块以实现交流负载通断控制
查看 >>
怎样在居家电器控制中集成智能硬件来实现设备电源远程通断
查看 >>
怎样在无人值守包间设备控制中接入智能设备以实现HTTP接口远程独立控制通断
查看 >>