CATALOG

将24路继电器模块接入项目,比想象中简单很多——芯步的开放接口基于HTTP协议,用任何编程语言都能调,核心就是“发指令、收状态”。下面从准备工作到代码实现完整说一遍。

一、准备工作:拿到“钥匙”和“地图”

在写代码之前,需要先拿到两样东西——开发者凭证(AppID/AppSecret)和设备ID

  1. 注册与登录:去芯步官网注册一个账号,登录后进入“物联网控制台”

  2. 获取AppID/AppSecret:在左侧菜单找到“开发设置”。这里的AppID相当于你的“用户名”,AppSecret是“密码”。特别注意AppSecret只在创建时显示一次,立马保存好

  3. 获取设备ID:确保你的24路继电器模块已经通电并连上网(通常支持网线或2.4G Wi-Fi),在控制台的“设备列表”里就能看到它的Device ID(一串数字)

:刚开始测试时,可以在“开发设置”里打开调试模式。这个模式下暂时不需要搞复杂的签名计算,方便快速验证功能

二、控制原理:其实就是发个“网络请求”

芯步的接口设计得比较直接——把控制指令包装成一个HTTP POST请求发出去就行

  • 请求地址http(s)://api.thingboot.com/{你的AppId}/device/control/

  • 核心参数

    • device:之前记下的设备ID。

    • order:具体的动作指令(JSON格式)。

针对我们的“24路继电器模块”,控制第1路到第24路的开关,指令规则通常如下

  • 开启第N路{"powerN": 1} (N代表通道号)

  • 关闭第N路{"powerN": 0}

三、实战演练:从单路到全部控制

下面用实际代码展示怎么操作。假设你的AppId12345DeviceId67890

1. 单路控制(开/关第1路)

假设你想控制连接在第1个接口上的灯光或设备:

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

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

Python代码示例

2. 全开与全关

有时候需要一键开启所有灯光或设备。虽然可以写24行代码循环,但很多固件支持组播(具体看你的产品手册,部分型号支持),如果硬件不支持,可以用循环逐个发送:

四、进阶玩法:获取状态与场景联动

除了控制,有时候还需要知道继电器实际有没有动作,或者要跟传感器联动(比如光线暗了自动开灯)。

1. 获取当前状态

设备状态通常有两种拿法:

  • 主动查询:调用查询接口(参考《产品手册》里的“状态查询”命令)获取每路的0/1状态。

  • 被动接收:在“开发设置”里配置消息推送URL。设备状态变了(比如你本地按了开关),平台会自动把你的服务器地址发一份数据,这样就能实时同步状态了

2. 传感器联动:如果“有人”就“开灯”

假设环境里有个“人体传感器”,可以设置一个服务端监听逻辑。当传感器上报“有人”消息时,立即回调控制继电器闭合

五、几个注意事项

  1. 关于命名规则:确认一下你的产品手册。大多数是power1power24,但有些特殊固件命名不同,请一定要以为准

  2. 网络环境:如果是在工厂或内网环境,芯步支持私有化部署,可以把数据完全控制在局域网内,不需要走外网,延迟更低

  3. 响应速度:实测从发出指令到继电器动作,通常在80-120毫秒左右,响应还是比较快的

  4. 硬件接线:24路模块通常用于控制强电。如果不熟悉电路,找专业电工操作。控制信号线接模块,负载(灯/电机)接继电器触点

总结

把24路继电器接入项目,只需要记住这三点:拿AppID、看产品手册找命令词、POST请求发JSON。无论用的是Java、Python还是Node.js,实现思路都一样。先从控制单路开始,成功后扩展到全控和联动即可。