CATALOG

共享自习室最头疼的就是每个座位的灯光和电源独立控制。这篇方案会一步步带你搞定24路控制器的接入,从硬件连接到API调用都有详细说明。

解决方案:把24路智能分体控制器接入共享自习室系统

一、 这个“大家伙”能干啥?先来个产品速览

我们要用的是芯步的 智能分体控制器(24路) 。你可以把它想象成一个拥有24个插座的超级排插,只不过这24个插座是完全独立的,而且都可以通过网络来控制开关。

它的核心优势就是:

  • 路数多:整整24路,对应自习室的24个座位绰绰有余

  • 接口开放:支持 HTTP API,这意味着不管你后端用Java、Python,还是前端写小程序,只要会发网络请求,就能控制它

  • 控制灵活:可以单独控制某一盏灯,也可以一键全开/全关

拿到设备后,你会发现它除了天线,还有一堆接线端子。简单来说:

  • 输入端:接220V火零线。

  • 输出端:24个继电器,相当于24个开关。你把每个座位的火线引过来,接在对应端子上,零线共用即可。

  • 电源:接DC 12V给设备主板供电

一点提示:如果灯带功率大,记得加交流接触器,别直接把大电流走控制器里头。

二、 准备工作:让设备“上网”并找到它

硬件接好线,第一步是让设备连上Wi-Fi。

  1. 注册与登录:去芯步官网注册账号,进到“工作台”。

  2. 添加设备:在“物联网控制台”里,用APP或扫码方式把控制器添加到你的账号下

  3. 拿到钥匙(AppID & AppSecret):这是最关键的一步。在控制台的“开发设置”里,找到你的 AppIDAppSecret。这相当于你家大门的钥匙,调用接口全靠它们。

  4. 记住设备ID:在设备列表里,找到刚刚添加的控制器,复制那一串 Device ID(设备编号)

搞定这几步,设备就已经在云端待命,随时等你下指令了。

三、 接入逻辑:接口怎么调?

要控制这24路,只需要学会向特定的URL发送HTTP POST请求就行

请求地址(示例):

https://api.thingboot.com/{你的AppID}/device/control/?sign={签名}&ts={时间戳}

核心参数解析:

  • device:就是刚才让你记下来的那一串设备ID

  • order:这是灵魂,决定了哪个开关动作。

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

    • 想关第3路:{"power3": 0}

    • 第2路开1小时后再自动关:{"reset2": 3600000} (3600000毫秒,非常适合自习室预约时长)

关于签名(Sign):别被“签名”吓到,其实就是个防篡改的公式。按照文档的示例代码(Python/Java/Postman都有),把 AppSecret 和时间戳 ts 套进去算一下就行。一般SDK里有现成的方法,复制过来改改就能用

四、 实战场景:具体怎么写代码?

我们拿最常见的 Node.js 后端和 微信小程序 来举个栗子。

场景设定:用户A在手机上点击“开灯”,服务器需要控制座位对应的第8路继电器闭合。

1. 后端/云函数代码示例:这里不贴大段代码,只讲逻辑。你需要封装一个函数 controlDevice(deviceId, command)

  • 入参command 就是你拼好的JSON,比如 {"power8": 1}

  • 过程:获取当前时间戳,拼接AppSecret算出sign,然后向上述URL发起POST请求。

  • 关键点:因为涉及密钥(AppSecret),绝对不要在前端小程序直接调用,必须由后端中转,防止密钥泄露

2. 业务逻辑怎么设计?接口调通后,你的数据库设计就活了。在“座位表”里加一列 relay_index,值为 1 到 24。当用户下单“座位8”时:

  • 开电:调用接口,order 里带上 power8 = 1。

  • 计时:如果你不想自己写定时任务,直接用设备的“先断后通”功能——reset8 = 剩余毫秒数。到点设备自动断电,非常省事

  • 状态同步:也可以主动轮询查询设备状态,或者让设备状态变化时主动推送消息到你的服务器。

五、 落地前,这几点请一定要注意

  1. 供电与负载:设备工作电压是DC 12V,别忘了插电源。每路最大负载有限制(阻性负载约2200W),带个台灯、显示器绰绰有余,但如果是大功率取暖器,必须加接触器过渡

  2. 网络稳定性:设备走2.4G Wi-Fi,部署位置尽量别离路由器太远,或者用Mesh网络覆盖

  3. 设备返回码:接口返回 code: 200 只代表指令发出,不代表设备真的动作了。如果调试时没反应,检查一下设备是否在线(是否掉线)

六、 写在最后

芯步的这套24路控制器,对于共享自习室来说性价比很高。它的接口封装得比较干净,只要把第一步的“签名认证”跑通,剩下的 power1power24 就是纯体力活了。

给你们开发小哥的顺口溜:

设备ID要记牢,密钥千万别外抛。控制命令很简单,power后面跟路号。预约时长不用愁,reset参数搞定掉。