CATALOG

芯步的24路控制器开放了标准HTTP接口,你用任何编程语言都能调用,接入门槛很低。下面这份方案会从设备配网、接口鉴权到实际调试验收,把整个流程串起来。

1. 背景与概述

在很多场景下,比如智能楼宇的灯光控制、工厂的电机启停、农业大棚的喷灌管理,甚至是家里的全屋电器总控,我们常常需要集中控制几十条线路。传统的做法是去电箱里手动扳开关,或者拉很长的控制线,这既不高效也不智能。

针对这个痛点,芯步推出了 “智能通用控制器24路” (型号:UNI-KZQ-TY-24)

一句话概括这个方案的价值:只要你的设备能联网(哪怕只是局域网),通过极其简单的几行代码,就能在全世界任何地方随手关掉或打开 24 个灯或电机。

2. 准备工作:硬件与网络

在开始写代码之前,咱们先得把硬件“物理”上架起来。

  • 硬件:芯步 24 路控制器(UNI-KZQ-TY-24) x 1 台。

  • 供电:DC 12V/2A 电源适配器(设备通常自带)。注意,这只给控制器的逻辑电路供电,千万别理解成用这个电去带灯泡。

  • 负载接线

    • 小功率:如果你要控制的设备是 LED 灯、小电机,可以直接接在控制器的输出端。

    • 大功率:如果是工厂大机器,千万不要直接接!要用控制器去控制一个交流接触器,再用接触器去带大负载。不然会把控制器继电器烧掉

  • 网络:这个控制器用的是 WiFi 2.4G,不支持 5G 频段。直接给它连上网就行,不需要买额外的网关。它有“自动配网”功能,注册后通过配置工具把 WiFi 密码告诉它即可

3. 核心接口解析:怎么发命令?

这是接入最核心的部分。芯步的接口设计得非常“友好”,采用的是标准的 HTTP POST 请求。说白了,就是访问一个网址,发一段 JSON 文本。

通信流程很简单:你的软件/服务器 → 芯步云平台 → 你家的24路控制器。

3.1. 鉴权与签名

为了防止别人乱动你的设备,接口是加密的。你需要提前在芯步控制台拿到两个关键东西:AppIDAppSecret

  • AppID:相当于你的用户名。

  • AppSecret:相当于你的密码,不要泄露。

签名生成规则(稍微有点绕,但一次封装好就能用):你需要先算出 YourSign,否则接口会报错。

翻译一下:先把 AppSecret 进行一次 MD5 加密(得到32位小写字符串),然后在末尾拼接上当前的时间戳 ts(比如 1712123456),最后把整个拼接后的字符串再算一次 MD5 签名。

3.2. 请求地址与数据格式

有了签名,我们就可以拼接请求地址了:

URL 地址:https://api.thingboot.com/{你的AppID}/device/control/?sign={你的Sign}&ts={时间戳}

Request Body (JSON 格式):这里是关键,你需要告诉设备“你是谁”以及“你要干什么”。

注意这个 order 对象,power1power24 就是你这台控制器的核心接口

4. 实战演练:用代码实现远程控制

理论说完了,来点实在的。这里我用 cURL 命令(在命令行运行)和一段简单的 Python 代码来演示。

场景设定

假设我们要:关闭第 3 路,打开第 7 路

4.1. 示例代码(Python)

控制器产品方案:
怎样在照明控制中对接智能硬件以实现多达24路独立线路控制
查看 >>
无人值守包间设备控制:怎么将8路包间设备集中控制器集成到软件项目中
查看 >>
共享自习室独立包间控制:怎样把共享空间智能控制器对接到软件项目中
查看 >>
剧本杀密室包间场景:怎样把HTTP接口包间控制器接入到自己的项目中
查看 >>
户外亮化工程控制中:如何把智能 24 路远程信号控制器接入到软件项目中
查看 >>
线路场景方案:
怎样在照明控制中对接智能硬件以实现多达24路独立线路控制
查看 >>
怎样接入AC5-10A 定时控制开关来实现线路状态反馈控制
查看 >>
怎样接入8路防水防尘控制箱来实现远程控制8路线路
查看 >>
怎么接入24 路智能分体远程设备集中控制模块以实现线路状态反馈控制
查看 >>
如何在共享茶室电器线路控制中集成智能设备以实现线路状态反馈控制
查看 >>
24路用途方案:
怎么二次开发24 路智能分体远程控制设备联动模块以实现多达24路独立线路控制
查看 >>
怎样在车间设备远程管理中接入智能设备以实现多达24路独立线路控制
查看 >>
如何接入智能分体控制器以实现多达24路独立线路控制
查看 >>
怎么在自助储物柜控制中集成智能设备来实现控制 24 路交直流输出
查看 >>
怎么在教研实训设备远程管理中对接智能硬件来实现24路独立线路控制
查看 >>