怎样接入16 路远程多回路智能控制器来实现分组控制模式设置_解决方案

CATALOG

芯步的开放接口提供了完整的设备分组管理能力。针对16路远程多回路智能控制器，可以通过“创建分组→绑定设备→配置命令模板→执行分组控制”四步实现灵活的分组控制模式设置。以下是具体方案。

针对多回路（多通道）控制需求，芯步的开放接口支持通过 设备分组 功能，将16路控制器中的任意几个回路（甚至跨设备的回路）逻辑组合在一起。通过调用 维护设备分组 和 执行命令或动作 接口，用户可以实现“一键全开”、“定时轮流启停”或“场景联动”等高级分组控制模式。

在芯步体系中，16路远程多回路智能控制器被视为一个拥有16个独立属性的设备（如 channel_1, channel_2, ..., channel_16）。

为了实现分组控制，我们需要打破物理设备的限制。例如，您可以建立三个分组：

建立分组后，通过 API 向指定 Group ID 下发控制指令，即可实现“一组一策”的控制模式。

步骤一：获取关键参数与设备标识在开始开发前，请确保您已在芯步平台完成以下准备工作：

获取 AppID/AppSecret：登录芯步控制台，获取您的应用凭证，用于生成 API 签名。
设备上线：确保16路智能控制器已通过配网成功接入平台，并在控制台“设备列表”中处于在线状态。
确认指令格式：查阅该产品的详情页，确认16路回路的控制指令名称。通常情况下，标准协议中第一路可能对应 channel_1 或 power1，参数值通常为 0（关）或 1（开）。

步骤二：创建逻辑分组并绑定设备利用 “维护设备分组” 接口（API: /device/group），将特定的回路添加到特定的分组 ID 中。

核心逻辑：由于多回路控制器视为单一设备，但在分组控制中，您可能需要单独控制某个回路。为了灵活性，将一个回路视为一个独立的“子设备”进行分组管理。
操作示例
- 场景：想要创建一个“生产线动力组”，包含设备A的第3路和第4路。
- 实施：调用接口，将 device 参数指定为 设备A_channel_3 和 设备A_channel_4 映射到新建的 Group_ID = 1001 中。
- 请求示例（HTTP POST）
  { "device": "DEVICE_ID_001:channel_3,DEVICE_ID_001:channel_4", "group": "1001" }

步骤三：配置分组控制模式（命令模板化）这是实现“分组控制模式设置”的核心。芯步的 “执行命令或动作” 接口（API: /group/control）允许您定义两种模式

即时命令模式直接下发具体的开关指令。适用于“全部关闭”或“全部开启”的简单场景。
- 请求示例（关闭动力组所有回路）
  { "group": 1001, "order": { "power": 0 } }
预设动作模式芯步支持动作（Action） 机制。您可以在控制台预先为分组配置复杂的场景动作（例如：间隔3秒启动一路，或设置特定运转模式）。
- 请求示例（执行预设在ID为5的动作）
  { "group": 1001, "action": 5 }

步骤四：执行与状态同步通过 HTTP 或 MQTT 方式调用上述接口。如果使用 HTTP GET 方式，示例如下

系统返回 {"code":200} 即代表指令下发成功，分组内的所有回路将同步执行该模式。

跨设备分组策略如果您的系统中有多台16路控制器（例如两台设备共32路），为了实现中央控制，可以将第一台的第1路和第二台的第1路通过 API 绑定到同一个 Group_ID 中。调用一次 API，即可实现两台设备的同时通断。
异步控制（MQTT）对于16路这种高实时性要求的工业场景，采用 MQTT 方式对接。将控制指令发布到主题 api/{AppID}/group/control，可以获得更低的指令延迟。
状态回读与监控分组控制指令下发后，通过查询设备状态接口或订阅设备上行 Topic，回读每一路回路的实际通断状态，以确认分组模式执行成功，避免因网络抖动导致的状态不同步。

场景：办公楼宇的“下班一键关灯”模式

需求：下班时，关闭所有楼层的16路控制器中连接照明的那几路。
配置
1. 定义一个分组 ID：OFFICE_LIGHTS。
2. 将所有控制器中负责照明的回路（如设备A的回路1-5，设备B的回路1-8）添加到该分组。
3. 设置模式：调用 /group/control，命令内容为 {"power":0}。
4. 结果：无论这些回路分布在哪个物理设备上，一次 API 调用即可全部关闭，无需循环遍历设备。

分组 ID 管理：创建分组后请记录返回的整型 ID，分组不存在（错误码 502）是常见的报错原因。
指令兼容性：不同型号的多回路控制器（如4路、8路、16路）支持的属性名可能不同。若标准指令 power1 无效，请参考产品文档中的“功能定义”部分确认准确的属性名称。
安全性：在生产环境中，签名（sign）逻辑请一定要在服务端计算，严禁将 AppSecret 暴露在前端代码中。

通过以上步骤，您可以灵活利用芯步的开放接口，实现对16路远程多回路智能控制器的精细化、场景化分组控制。