CATALOG

分组控制是智能化改造中的关键功能,它让你能按场景(如“照明组”“设备组”)批量管理设备,而非逐个控制。以下方案基于芯步开放接口,说明如何从接口对接、分组创建到指令下发的完整实现路径。

1. 背景与目标

在各类智能化改造项目(如共享自习室、智能办公区、工业设备控制等)中,往往需要同时控制多个设备(如关闭一层楼的所有灯光、开启一组插座)。为此,设置分组控制模式成为提升管理效率的刚需。

本方案的目标是指导开发者如何利用芯步提供的开放接口,在保留或新建自有软件系统(APP/小程序/Web管理后台)的基础上,快速实现设备的“分组管理”与“分组控制”,从而实现场景化的一键批量操控

2. 整体技术架构

基于芯步“应用软件+智能硬件”的模式,接入逻辑如下:

  • 硬件层:接入现场的智能硬件,如4路/8路智能控制器、智能PDU、传感器等

  • 云平台层:芯步提供Open API,负责设备状态上报与指令下发,同时支持分组逻辑存储

  • 应用层:你的业务系统通过调用芯步的HTTP接口,设置分组并下发控制指令。

3. 关键步骤实现:分组控制模式设置

要实现“分组控制模式”,核心分为两步:一是设备分组的管理,二是向分组下发指令

3.1 设备分组管理

在调用控制接口前,需要先建立分组并将设备加入分组。

  • 获取分组列表:在进行控制前,系统需获取分组ID。通过调用分组列表查询接口,获取当前工作台下已有的分组信息,返回数据中包含分组ID group

  • 管理分组设备:通过调用修改分组设备接口,可以向指定分组(Group ID)中添加或移除设备。这一步骤确定了哪些设备属于该“照明组”或“设备组”。

3.2 分组控制的指令下发机制

这是实现“模式设置”的核心。芯步提供了专用的分组控制接口,允许直接向整个群组下发指令。

  • 接口类型:HTTP API 或 MQTT

  • 核心逻辑:业务系统只需指定目标“分组ID”和“命令动作”,云平台会自动将该指令分发给分组内的所有设备,无需业务系统循环处理单个设备。

3.3 常见的分组控制模式设置实例

假设需要为一个共享办公区设置“上班模式”(开启所有灯光和插座)和“下班模式”(全部关闭)。

1. 定义数据结构在业务后台记录分组ID。例如:

  • 照明分组:group_id = 1234(包含8路控制器中的线路1-4)

  • 设备分组:group_id = 5678(包含智能PDU的插座1-8)

2. 执行“上班模式”业务系统需向芯步API发送以下POST请求(以内容类型 application/json 为例):

  • URLhttp(s)://api.thingboot.com/{AppID}/group/control/?sign={sign}&ts={ts}

  • Body 示例

    这里直接指定属性=值注:也可使用 order 对象格式下发复杂指令

3. 执行动作模式接口不仅支持简单的开关属性,还支持预先设定的“动作ID”,实现延时或联动。

  • 命令格式{"group":1234,"action":1}

  • 场景:比如执行动作1,表示“间隔2秒依次开启设备”,避免瞬间电流过大

4. 签名认证与安全性

每次调用接口都需要进行签名(sign)验证。芯步采用 md5(md5(AppSecret) + ts) 的算法

  • 参数

    • AppID:应用唯一标识。

    • AppSecret:应用密钥,需MD5加密一次。

    • ts:当前Unix时间戳(秒)。

  • 实现示例

    1. AppSecret 进行MD5得到 sec_md5

    2. 拼接字符串 sec_md5 + ts

    3. 再次进行MD5得到最终的 sign

5. 异步反馈与状态确认

由于分组控制涉及多个设备,个别设备可能因网络离线导致执行失败。芯步平台提供消息推送机制(上行消息)来解决该问题

  • 实现机制:设置接收URL,平台会推送设备对命令的应答结果

  • 业务逻辑处理:当系统收到分组控制指令后,可统计返回成功/失败的设备数。如果超时未收到特定设备反馈,业务系统可标记该设备“离线”或“执行异常”。

6. 策略优势

  1. 极简开发:无需维护大量的设备列表循环,只需调用一个分组接口即可完成多设备控制

  2. 响应迅速:API调用响应通常在80-120ms,直接由云平台处理高并发分发

  3. 扩展性强:支持命令携带extra字段,业务系统可在此传递订单号或业务ID,实现精准的计费关联

  4. 硬件成本低:不仅支持传统控制器,还支持通过外接模块方式“无损”改造旧设备,无需更换昂贵主机

7. 总结

通过对接芯步开放平台的 “分组-执行命令或动作” 接口,企业可以极低的代码量实现复杂的智能化场景控制。开发者只需重点关注分组ID的映射关系业务模式的指令组合,物理层的通信、并发控制及设备状态同步均可交由芯步的可靠云平台处理。这种方式是目前实现共享棋牌室、办公室节能改造及工业设备集群控制最高效的解决方案之一

控制器产品方案:
怎样在无人值守包间设备控制中接入智能设备以实现HTTP接口远程独立控制通断
查看 >>
如何在灯光控制中集成智能硬件以实现联动继电器模块扩展控制
查看 >>
无人售货机两路设备控制:如何把智能2路交流远程控制模块集成到软件项目中
查看 >>
怎么在照明控制中集成智能设备来实现分路控制灯光与设备
查看 >>
剧本杀密室包间场景:怎样把HTTP接口包间控制器接入到自己的项目中
查看 >>
改造场景方案:
家庭智能改造:如何把10A86型智能电源控制插座对接到自己的项目中
查看 >>
配电柜智能改造:怎样把8位远程控制总控PDU集成到项目中
查看 >>
怎样在酒店客房智能改造中集成智能设备来实现设备电源状态监测
查看 >>
智能化改造空调场景:如何把智能空调控制器2对接到自己的项目中
查看 >>
怎样在智能化改造中接入智能硬件以实现开门信号输出控制
查看 >>
模式用途方案:
怎么在舞蹈练习室设备管理中集成智能设备来实现包间清洁模式一键切换
查看 >>
怎么接入24 路智能分体远程控制设备联动模块以实现场景模式一键切换
查看 >>
怎样二次开发吸顶式智能雷达感应开关以实现节能模式联动
查看 >>
如何对接电竞房RGB灯光控制器来实现呼吸/闪烁/流水模式切换
查看 >>
怎么二次开发智能 LED 灯情景控制器来实现远程灯光模式设置
查看 >>