CATALOG

共享场所(如自习室、共享办公室、短租公寓)对照明管理的核心诉求是“低成本部署”和“精细化计费”——每个独立空间需要单独控制,且最好能与订单系统联动。以下方案基于芯步的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个房间、走廊、洗手间或招牌灯

集成步骤:

  1. 电路安装:在强电箱或设备柜中安装这两台控制器。将220V市电接入控制器的输入端,并将12路输出线路分别对应连接到12个独立空间的照明灯具上

  2. 网络配置:设备支持2.4G WiFi。通过芯步官方小程序或被集成应用的配网功能,将两台控制器连接到现场的网络中。需要注意:设备仅支持2.4G频段WiFi(现场路由器需开启2.4G信号)

3. 核心接口集成方案

芯步开放平台提供标准的HTTP协议接口,这是集成到第三方系统的核心通道。

3.1 设备管理在集成之前,需在芯步控制台获取两台设备的唯一标识ID(如 Device_8A3FDevice_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. 业务场景与逻辑设计

对于“共享场所”,单纯的开关控制是不够的,必须结合业务逻辑。

第一种场景:订单联动(无人值守模式)

  1. 用户下单 -> 后台系统获取支付成功信号 -> 调用上述接口,找到该房间对应的继电器回路 -> 发送 {"powerX":"1"} -> 照明通电。

  2. 计时结束/点击退租 -> 后台系统调用接口 {"powerX":"0"} -> 照明断电。

  3. 防作弊/超时保护:如果网络断开,可在本地通过硬件定时(需硬件支持)或后台轮询任务,防止用户未续费但灯一直亮着。

第二种场景:全局控制(管理员模式)

  • 分区控制:系统调用 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 1Room 12

  • 前端界面只需关心“操作12号灯”,后端负责判断该命令是发给8路设备还是4路设备。

5.2 设备寻址与签名所有API请求必须包含签名认证。开发时需要参考其签名生成规则:

  • 参数包括 AppIDsign(签名)、ts(时间戳)。

  • 签名算法通常是将参数排序后拼接密钥进行MD5加密。开发前需在后台配置API Key

5.3 负载安全单路最大支持2200W,但在一个配电箱内集成12路时,需计算总功率。8路设备总额定功率4400W,4路设备也是4400W,分别接入不同支路即可满足大部分商用照明需求

6. 总结

通过集成芯步的开放接口,开发者可以在3天内完成“硬件配网 -> API对接 -> 业务逻辑绑定”的全流程。这套方案不仅解决了12路照明的远程独立控制,还通过批量指令和状态同步机制,完美适配共享场景对“自动化计费”和“无人化管理”的需求。

开发者只需关注4路和8路设备在逻辑层的合并封装,即可像操作一块12路控制卡一样,稳定地管理整个共享场所的光环境。

照明控制器产品方案:
怎样在共享棋牌室照明管理中接入智能设备来实现延时通断控制
查看 >>
共享棋牌室照明管理:如何把8路灯光控制器集成到软件项目中
查看 >>
怎样接入智能照明控制器|8路以实现远程开关状态查询
查看 >>
共享民宿照明管理:怎样把8路智能灯光控制器对接到软件项目中
查看 >>
怎么在共享民宿照明管理中集成智能设备来实现定时开关照明设备电源
查看 >>
共享场所场景方案:
共享场所灯光门禁管理:怎么将2路墙壁智能开关对接到项目中
查看 >>
共享场所交流负载管理:怎么把DC-10A 控制模块对接到项目中
查看 >>
共享场所安全节能管理:如何将吸顶式红外探测器集成到项目中
查看 >>
共享场所直流负载管理:怎么将DC-10A 智能线路开关接入到自己的项目中
查看 >>
共享场所照明管理:如何将86型2路WiFi开关接入到软件项目中
查看 >>
12路用途方案:
怎么在无人售货机灯光控制中集成智能硬件来实现12路照明设备电源状态监测
查看 >>
如何在厂房照明智能控制中集成智能设备以实现12路独立线路控制
查看 >>
怎么在共享棋牌室照明管理中集成智能设备来实现远程控制12路照明设备通断
查看 >>
怎样二次开发12路独立线路控制器来实现12路独立线路控制
查看 >>
如何在弱电间灯光联动中集成智能设备来实现12路独立线路控制
查看 >>