CATALOG

芯步这款4路直流控制器,核心优势就是HTTP接口开放得很彻底——任何能发HTTP请求的项目都能直接调用,不需要私有SDK或网关。下面从选型、配网到接口调用,把集成全流程捋一遍。

一、上来先确认:这东西是你的菜吗?(选型篇)

在动手写代码之前,咱得先把硬件摸透了,免得后面扯皮。

这东西型号一般是 UNI-KZQ-DC-4,名字听着绕口,其实就是个能接WiFi的“智能开关排插”,只不过它是直流版本,而且一口气能控制4路

  • 负载类型:这货是直流版的,输出电压看你的适配器(比如接12V或24V的电源),单路最大10A。适合接电磁锁(共享柜子那“咔哒”一声就靠它)、电插锁直流电机(小卷帘门)或者LED灯带。切记,别拿它直接捅家里的空调(交流电)

  • 网络:只支持 2.4G WiFi。配网的时候,记得把你的手机或电脑也切成2.4G,不然搜不到。

  • 接口优势:芯步这玩意儿最良心的地方是开放HTTP接口,不用装什么复杂的网关,也不用折腾私有SDK,只要是能发HTTP请求的语言(Python, Java, JS, PHP...)都能玩

二、第一次见面:怎么让它“上网”?(配网篇)

东西拿到手,先别急着敲代码,得先把设备送到网上。这板子上有个蓝色灯,一直在闪说明它在等你。

  1. 通电:给控制器接上电,确保蓝灯在闪。

  2. 找工具:去芯步的控制台或者他们提供的配网工具(通常是微信公众号或者App里的“添加设备”功能)。

  3. 配网:按提示输入WiFi密码。等蓝灯变常亮或者熄灭(各版本定义略有差异,总之不闪了),恭喜,它连上网了。

这时候,在你的后台控制台里,你应该能看到这个设备变成了“在线”状态,并且拿到了唯一的 Device ID(设备编号)。这个ID,就是我们要用的“身份证”

三、重头戏:集成到你的项目里(实战篇)

核心思路:你的项目(不管是网页、小程序还是手机App) --> 调用芯步的开放API --> 芯步服务器 --> 你家控制器 --> 继电器吸合/断开。

说白了,就是发一个特定的POST请求。

1. 先准备“钥匙”(必要参数)

你需要凑齐下面这三样东西,通常在你的后台管理界面能看到:

  • URL(大门地址)https://api.thingboot.com/{AppID}/device/control/(注意要把 {AppID} 换成你自己的应用ID)

  • sign(签名):这玩意儿是为了安全,一般是把ts、device等参数按规则拼接后MD5加密,防止有人乱发指令搞破坏。

  • ts(时间戳):当前的时间,用来防重放攻击

这里稍微多一嘴:官方文档一般会提供sign的生成示例代码,复制粘贴那个函数最稳妥,手写容易掉坑里。

2. 真正的命令(Order参数)

这是最核心的,告诉板子到底要干什么。Order参数是一个 JSON字符串

以下是几个你绝对会用到的命令示例:

  • 第一种场景:我要开第1号门(控制单路)

    • 比如共享柜子,用户买了A柜门的东西。

    • 命令:{"power1":"1"} (1是通,0是断)

  • 第二种场景:紧急情况,全给我锁死(控制多路)

    • 命令:{"power1":"0","power2":"0","power3":"0","power4":"0"}

  • 第三种场景:电机点动控制(比如按一下开门,松开停)

    • 这个功能很实用。有时候继电器通了不能一直通(比如给电锁通电太久会烧线圈),就需要“通一下立刻断”。

    • 芯步支持 先通后断 模式:{"point":{"relay":[1],"interval":500}}(这表示第1路通,500毫秒后自动断开,正好用来“弹”开锁舌)

3. 实际代码跑一下

假设你用的是最普通的 Python 写后端逻辑:

四、高级玩法 & 避坑指南

1. 关于接口地址上面例子用的是友鱼的公有云API。如果你是做私有化部署,或者要求纯局域网内控制(比如工厂里不允许数据出内网),这板子支持自建服务器。你可以把API地址指向你自己的服务器IP,数据不经过友鱼

2. 关于“反馈”怎么做?你可能会问:“我发指令开了门,我怎么知道门真的开了?”

  • 物理方式:这板子有4路开关量输入。你可以接个门磁传感器。当关门时,传感器会给板子一个信号。板子可以把这信号推送到你的服务器。

  • 业务逻辑:如果是售货柜,通常不用管继电器吸没吸,只要HTTP返回200,基本就成功了。你只需要记录用户“点击购买”这个动作即可。

3. 适配不同语言如果你用的是 微信小程序,注意要把 api.thingboot.com 加入小程序的request合法域名里。前端代码里直接用 wx.request 调用上述格式就行,记得处理好异步回调

4. 接线的小提醒板子上有两部分线:

  • 电源输入:接220V给板子自己供电的。

  • 负载端:如果你控制的是电磁锁,直流电源的(+)接COM,(-)接NO或NC。千万别接反,也别把220V接到直流端口上,否则会烧板子(血泪教训)

总结一下

把这款“智能控制器4路”集成到项目里,就是把“物理开关”替换成 “发HTTP请求”

  1. 物理上:接线别搞错正负极。

  2. 网络上:把板子连上WiFi。

  3. 代码上:对着 device_id{"power1":"1"} 这条指令。

这套方案对于做快递柜、共享按摩椅、远程设备监控的项目非常友好,门槛低,见效快。如果你在集成时发现签名校验失败,99%是时间戳没对齐或者字符串拼接顺序不对,再对着文档看一眼就行。