CATALOG

一、咱们先聊聊这个24路继电器模块能干什么

如果你正在做一个创客项目,涉及到“远程控制一堆设备”,那芯步这款24路远程控制继电器模块简直是神器。简单来说,它就是一个可以让你通过网络(HTTP请求)来控制24个开关通断的小盒子。

它能干什么?

  • 控制24路独立设备:灯光、电机、电磁锁、水泵、风扇……只要是需要开关控制的,它都能干

  • 每路最大支持2200W阻性负载(比如白炽灯),总负载不超过4400W

  • 支持交直流小负载直连,大负载可以外接触器扩展

什么场景用得着?

  • 智能沙盘模型(点亮不同区域的灯光)

  • 自动售货柜(控制出货电机)

  • 智能养殖/种植(控制灯光、水泵、风扇)

  • 展览展示(控制展品灯光、互动装置)

  • 任何“需要远程控制多个开关”的创客项目

二、硬件准备和基础配置

动手之前,先把硬件搞定:

  1. 设备清单

    • UNI-KZQ-TY-24 控制器本体 ×1

    • DC 12V/2A 电源适配器 ×1(包装里自带)

    • 你要控制的设备和连接线

  2. 注册与配网

    • 去芯步官网注册账号

    • 创建工作台,进入“物联网控制台”模块

    • 给设备配网:添加现场2.4G WiFi的SSID和密码,设备通电后会自己连上(指示灯从闪烁变常亮就说明连上了)

    • 在控制台找到你的设备ID(后面调用接口要用)

  3. 获取API密钥

    • 在控制台的“开发设置”里找到:

      • AppID:你的应用标识

      • AppSecret:你的开发者密码(别泄露给别人)

搞定这些,硬件层面就准备好了。

三、核心:如何用代码控制继电器

芯步的接口设计比较友好——就是标准的HTTP POST请求,不管你用Python、JavaScript、Java还是Go,只要发HTTP请求就行。

3.1 接口地址和鉴权方式

请求地址:

鉴权机制(稍微有点绕,但照着来就行):

签名的计算规则是:

简单说就是把你的AppSecret先MD5一次,然后拼上当前的时间戳(秒),再对整个字符串做一次MD5。

为什么要这样? 防止接口被随意调用,保证只有你本人能控制设备。

3.2 控制单路继电器的示例代码

假设你想控制第1路接通(打开):

命令格式说明:

  • {"power1": 1} → 打开第1路

  • {"power1": 0} → 关闭第1路

  • {"power3": 1} → 打开第3路

  • 以此类推,power1到power24对应24个继电器

3.3 批量控制:一次性控制多路

如果你需要同时打开多个设备(比如打开第1、3、5路),可以这样:

或者用batch命令批量设置:

3.4 不同编程语言的实现思路

JavaScript/Node.js:

小程序里也可以用,就是把上面逻辑搬到小程序的request里。

四、实际项目集成:给几个实战例子

场景1:做一个智能灯光控制系统

你想要一个网页来控制24盏灯的开关:

前端: 24个开关按钮,点一下发一个请求后端: 封装一个接口/api/control/light?id=1&status=1,里面调用芯步的API

伪代码:

场景2:定时任务控制

比如每天8点打开第1路,18点关闭:

场景3:传感器联动

假设你有人体传感器,检测到人就打开某路灯光:

五、开发中的注意事项

1. 签名时间戳问题

  • ts是秒级时间戳,不是毫秒

  • 时间戳有效期通常几分钟,超时会失效

  • 别缓存签名,每次请求重新计算

2. 网络环境

  • 设备只支持2.4G WiFi,5G不行

  • 如果是在局域网里用,可以配成局域网模式,响应更快

  • 公网访问需要设备能联网

3. 响应时间

  • 实测大概80-120ms,对大多数控制场景足够了

4. 并发控制

  • 如果多个用户同时操作,服务端加个状态管理

  • 避免同时发送冲突的命令

5. 错误处理

  • 网络超时要重试

  • 设备离线要提示

  • 加个设备状态查询接口(可以问芯步要文档)

六、常见问题排查

Q:设备连不上网怎么办?A:确认WiFi是2.4G,密码没错,设备指示灯是不是在闪

Q:控制没反应?A:检查device_id对不对,sign算对了没,设备是不是在线

Q:能同时控制多个设备吗?A:device参数可以传多个ID,用英文逗号隔开

Q:能知道当前每路的开关状态吗?A:可以调用设备状态查询接口(参考芯步开放平台文档)

七、总结

把芯步24路继电器集成到你的软件项目里,核心就三步:

  1. 硬件准备:设备配网、拿到AppID/AppSecret/DeviceID

  2. 搞懂API:HTTP POST + MD5签名 + JSON命令

  3. 代码对接:封装一个控制函数,在你需要的地方调用

接口设计得比较直接,基本上一下午就能搞定。如果要做复杂场景(定时、联动、多用户),多花点时间设计状态管理就行。

动手试试吧,有问题可以查芯步的产品手册或者问技术支持~