CATALOG

共享自习室的独立包间需要精细化的电源管理——用户下单后自动通电、时间到前提醒、超时自动断电。芯步的8路控制器配合HTTP接口可以很好地解决这些问题,以下是具体的对接方案。

1. 引言与选型背景

在共享自习室的运营中,独立包间的电源管理是痛点之一。运营方需要远程控制每个包间的照明、插座供电,并实现与订单系统的联动(用户下单后自动通电,结束后自动断电)。此外,还需具备门禁控制、超时提醒等功能。

芯步(ThingBoot)提供的 8路智能通用控制器及配套的4路智能包间控制器,凭借其开放的HTTP API接口、支持私有化部署、无需网关(直连Wi-Fi)等特性,非常适合作为此类项目的硬件底座

本文将详细阐述如何利用该系列产品的开放接口,系统性地将其对接到自有的共享自习室管理系统中,实现8路(或多路)设备的精准远程控制。

2. 硬件选型与场景映射

针对共享自习室独立包间的具体场景,我们选用以下两款硬件,以满足不同负载类型(照明、插座、空调、门锁)的控制需求:

  • 核心控制设备:智能通用控制器 | 8路

    • 型号:UNI-KZQ-TY-8

    • 适用场景:该设备提供8路独立输出,非常适合控制一个房间内的多个工位或多组设备

    • 负载能力:单路最大2200W(阻性负载),总功率最大4400W。对于自习室内的顶灯、座位插座、风扇、小型饮水机负载足够。

    • 对接优势:无需网关,直接通过Wi-Fi 2.4G连接路由器,部署简单,降低硬件成本。

  • 辅助控制设备:智能包间控制器 | Mini

    • 型号:UNI-KZQ-BJ-MINI

    • 适用场景:专门为包间设计,提供4路输出,体积小巧

    • 特殊接口:某一路专门针对电磁锁优化,另一路可达30A支持空调。

    • 对接优势:支持TTS语音播报,可在订单快结束时提醒用户续费。

系统架构:每个独立包间部署1个“8路控制器”或“4路控制器”。网络拓扑采用 设备直连云端/本地服务器 的模式,用户小程序通过后端服务与设备通信,确保安全性。

3. API对接核心机制

芯步的开放接口采用标准的HTTP协议,这意味着只要你的后端服务能发起HTTP请求,无论是Java、Python、PHP还是Node.js,都能无缝集成。其核心鉴权机制如下

3.1 接口鉴权(Sign签名)

为了防止接口被恶意调用,所有API请求需携带动态签名。

  • AppId:应用唯一标识

  • AppSecret:应用密钥(请妥善保管,不放在前端)

  • Sign生成算法Sign = md5( md5(AppSecret) + ts )

注:ts为当前Unix时间戳(秒),服务器会校验时间戳有效性,防止请求重放。

3.2 核心接口示例:下发控制命令

  • 请求地址https://api.thingboot.com/{AppId}/device/control/

  • Method: POST

  • HeaderContent-Type: application/json

  • Body 参数

    • device: 设备ID(字符串)

    • order: 指令集(JSON对象)

4. 详细实施方案:8路独立包间控制逻辑

在独立包间中,我们将8路控制器进行如下定义(依据实际接线进行映射):

线路编号控制对象联动逻辑
线路1主照明灯订单开始后通电,结束后断电
线路2插座(总)订单开始后通电,结束后断电
线路3空调插座订单开始后通电,支持温度监测
线路4门禁电磁锁通电开锁(用户扫码进入)
线路5新风/排风扇定时控制或跟随订单
线路6辅助氛围灯跟随主照明
线路7饮水机定时控制(间歇性通电)
线路8备用插座预留

4.1 第一种场景:用户扫码开门与自动通电

用户在小程序端完成支付后,需要能够进入包间并让设备通电。

步骤

  1. 用户端: 用户在小程序点击“开门”或订单自动开始。

  2. 后端逻辑: 后端验证订单有效性后,调用8路控制器的单路控制接口,先开启线路4(门锁),延迟2秒后开启线路1(照明)和线路2(插座)。

  3. API 调用示例

4.2 第二种场景:批量控制与全屋断电

当用户在小程序点击“结束订单”时,需要给包间内所有设备断电,防止资源浪费。

方案:利用8路控制器提供的 批量控制命令,一次性将所有回路关闭,替代多次单路请求,提高效率

API 调用示例

注:batch值为8位字符串,每位对应一个回路,1为开,0为关。

4.3 第三种场景:语音提醒(结合带TTS版本的Mini控制器)

自习室需要保持安静,但用户在包间内容易忘记时间。可以部署一个带有TTS功能的“智能包间控制器Mini [TTS版]”,当快结束时,仅播报语音提醒,不切断电源(避免突然断电导致学习中断)

API 调用示例

5. 高级功能:数据感知与自动化

除了单向控制,利用芯步的生态,可以进一步提升自习室的智能化程度。

5.1 状态实时上报与断网重连

虽然8路控制器主要接受指令,但在强电波动或设备重连时,设备会向服务器上报当前状态。后端监听 设备状态回调接口,实现数据库中的状态同步。

  • 状态同步:如果用户手动按了包间内的物理按键,后台需能感知并将状态同步给小程序,防止“开关状态不同步”。

5.2 联动传感器实现有人检测

在控制台中,可以将人体传感器与8路控制器进行逻辑联动

  • 场景:当用户订单结束后忘记关门(灯虽断电,但系统流程未结束),若结合人体雷达传感器,设定“订单结束后10分钟若检测到无人”,后端主动调用API强制断电并结束订单。

6. 实施注意事项与排障

在实际项目中,以下几点对于稳定运行至关重要:

  1. Wi-Fi信号强度

    • 8路控制器仅支持 2.4G Wi-Fi。自习室包间隔断多,请一定要确保每个包间的Wi-Fi信号强度在70%以上。采用企业级AP方案,而非家用路由器

  2. 私有化部署(局域网)

    • 如果自习室网络不稳定或对数据安全要求高,芯步支持 私有化部署。此时可将API请求地址切换到本地服务器IP,设备与服务器在同网段通信,即便外网断网,扫码开门功能依然可用

  3. 接线安全

    • 8路控制器虽然强大,但接线端有额定电流限制(阻性/感性负载不同)。对于感性负载(电机类风扇),降额使用,或通过控制器驱动交流接触器去带动大功率空调,以保护控制器主板

7. 总结

通过对接芯步的 8路远程包间电源管理模块,共享自习室可以实现从“人工巡店”到“全自动无人值守”的转变。

  1. 轻量对接: 统一的HTTP API和简单的MD5签名机制,让后端开发人员能在1-2天内完成核心控制逻辑的集成

  2. 成本控制: 省去了网关设备,降低了单点故障风险和硬件投入

  3. 体验提升: 结合批量控制与TTS语音能力,在保障电源安全的同时,提供了更人性化的服务提醒。

对于计划开发此类系统的团队,优先完成“通电/断电”这一核心闭环,再逐步通过传感器联动和设备状态上报功能,打磨精细化运营的SaaS系统。

控制器产品方案:
如何二次开发4 路智能照明控制器来实现定时开关照明设备电源
查看 >>
如何对接8路包间电器覆盖控制器来实现包间智能语音联动控制
查看 >>
怎样在照明控制中对接智能硬件以实现多达24路独立线路控制
查看 >>
舞蹈练习室设备管理:如何将8路包间场景联动控制器对接到自己的项目中
查看 >>
无人值守包间设备控制:怎么将8路包间设备集中控制器集成到软件项目中
查看 >>
共享自习室场景方案:
共享自习室照明控制:如何把1路独立控制触摸墙壁开关集成到自己的项目中
查看 >>
如何在共享自习室独立包间控制中对接智能设备来实现包间智能语音联动控制
查看 >>
怎样在共享自习室 LED 灯条控制中集成智能硬件来实现低压直流负载通断控制
查看 >>
如何在共享自习室氛围灯光控制中接入智能设备来实现设备分组统一管理
查看 >>
共享自习室照明门禁控制:怎样把2路智能复合墙壁开关接入到自己的项目中
查看 >>
包间用途方案:
如何二次开发8路包间设备集中控制器以实现包间消费时长电源联动
查看 >>
如何对接8路包间电器覆盖控制器来实现包间智能语音联动控制
查看 >>
台球厅 VIP 包间管理:怎么把8 路智能包间控制器集成到软件项目中
查看 >>
如何在电竞酒店包间联动控制中接入智能硬件以实现包间设备故障自动告警
查看 >>
如何对接8 路智能包间控制器以实现包间设备异常断电保护
查看 >>