共享场所(如自习室、共享办公室、短租公寓)对照明管理的核心诉求是“低成本部署”和“精细化计费”——每个独立空间需要单独控制,且最好能与订单系统联动。以下方案基于芯步的8路/4路智能控制器,通过其HTTP开放接口实现12路照明设备的远程独立控制。
解决方案:基于芯步开放接口的共享场所12路照明远程集控系统
1. 概述
在共享场所(如共享自习室、共享茶室、共享办公室、短租公寓)中,空间通常被分割为多个独立的小房间或工位区。为了降低改造成本,我们不需要为每一路照明单独购买一个智能开关,而是采用多路智能控制器。
本方案基于芯步的 “智能控制器8路” 和 “智能控制器4路” 组合(8+4=12路),通过其公开的 HTTP API接口,将12路照明回路无缝集成到现有的微信公众号、小程序或PC管理后台中,实现远程通断控制、状态同步及与订单联动的自动化管理。
2. 硬件选型与连接
为了覆盖12路照明,需要组合使用两台设备:
| 设备型号 | 控制路数 | 单路最大负载 | 适用场景 |
|---|---|---|---|
| 智能控制器 8路 | 8 路 | 2200W (阻性) | 控制8个房间的主照明或8个工位区的灯带 |
| 智能控制器 4路 | 4 路 | 2200W (阻性) | 控制剩余4个房间、走廊、洗手间或招牌灯 |
集成步骤:
电路安装:在强电箱或设备柜中安装这两台控制器。将220V市电接入控制器的输入端,并将12路输出线路分别对应连接到12个独立空间的照明灯具上。
网络配置:设备支持2.4G WiFi。通过芯步官方小程序或被集成应用的配网功能,将两台控制器连接到现场的网络中。需要注意:设备仅支持2.4G频段WiFi(现场路由器需开启2.4G信号)。
3. 核心接口集成方案
芯步开放平台提供标准的HTTP协议接口,这是集成到第三方系统的核心通道。
3.1 设备管理在集成之前,需在芯步控制台获取两台设备的唯一标识ID(如 Device_8A3F 和 Device_4B2D)。集成方需实现以下逻辑:
将硬件ID与业务系统内的“房间号”(如“VIP Room 1”)进行绑定。
3.2 远程通断控制(核心接口)使用 “向设备下发指令” 接口。在共享场所的业务逻辑中,最常见的场景是:用户下单后自动通电,计时结束后自动断电。
请求地址
http(s)://api.thingboot.com/{AppID}/device/control/请求方法:POST (推荐 JSON 格式)
核心参数
device:填目标设备ID(支持批量)。order:命令内容,支持JSON字符串。
针对12路的具体实现代码示例(伪代码):
3.3 状态同步与异步消息虽然发送命令会立即返回200状态码,但这仅代表指令下发成功,不代表灯确实亮了(例如设备可能离线)。
解决方案:集成方订阅芯步的云端消息推送服务。设备执行指令后会反馈实际状态,系统可通过消息队列(如Kafka)或回调接口接收此状态,并更新数据库中的“灯实际状态”。
4. 业务场景与逻辑设计
对于“共享场所”,单纯的开关控制是不够的,必须结合业务逻辑。
第一种场景:订单联动(无人值守模式)
用户下单 -> 后台系统获取支付成功信号 -> 调用上述接口,找到该房间对应的继电器回路 -> 发送
{"powerX":"1"}-> 照明通电。计时结束/点击退租 -> 后台系统调用接口
{"powerX":"0"}-> 照明断电。防作弊/超时保护:如果网络断开,可在本地通过硬件定时(需硬件支持)或后台轮询任务,防止用户未续费但灯一直亮着。
第二种场景:全局控制(管理员模式)
分区控制:系统调用
batch指令,一键关闭8路空闲区域照明,节约能耗。先断后通(Reset):在某些需要重置设备或清空所有状态的场景,可使用
{"reset":{"relay":[1,2,3,4],"interval":1000}},让指定线路断开1秒后重新通电(适用于路由器重启或特定设备复位)。
5. 集成实施保障
5.1 关于12路的实现官方标准硬件目前提供4路和8路两种规格,并未提供单台12路接口的模块。本方案的12路是通过物理组合(8+4)实现的。在业务抽象层,开发一个中间件层
将
Device_8A3F(port 1-8) 和Device_4B2D(port 1-4) 映射为逻辑上的Room 1到Room 12。前端界面只需关心“操作12号灯”,后端负责判断该命令是发给8路设备还是4路设备。
5.2 设备寻址与签名所有API请求必须包含签名认证。开发时需要参考其签名生成规则:
参数包括
AppID、sign(签名)、ts(时间戳)。签名算法通常是将参数排序后拼接密钥进行MD5加密。开发前需在后台配置API Key。
5.3 负载安全单路最大支持2200W,但在一个配电箱内集成12路时,需计算总功率。8路设备总额定功率4400W,4路设备也是4400W,分别接入不同支路即可满足大部分商用照明需求。
6. 总结
通过集成芯步的开放接口,开发者可以在3天内完成“硬件配网 -> API对接 -> 业务逻辑绑定”的全流程。这套方案不仅解决了12路照明的远程独立控制,还通过批量指令和状态同步机制,完美适配共享场景对“自动化计费”和“无人化管理”的需求。
开发者只需关注4路和8路设备在逻辑层的合并封装,即可像操作一块12路控制卡一样,稳定地管理整个共享场所的光环境。