芯步的智能复合墙壁开关采用WiFi直连架构，通过标准HTTP接口即可完成对两路照明的独立控制。结合园区场景的共性需求——定时策略、人来灯亮、远程运维，以下是具体的集成方案。

1. 项目概述与选型分析

在园区（如产业园、物流园、商业综合体）的公共照明管理中，楼道、卫生间、茶水间等区域常面临“长明灯”浪费或巡检困难的问题。传统改造成本高、布线复杂。

选择芯步2路智能复合墙壁开关（型号：UNI-KG-KC） 作为执行单元，具备以下核心优势：

• 零改线安装：该产品为标准86型规格，支持单火/零火接线，可直接平行替换园区内现有的传统墙壁开关，无需砸墙或重新布线。

• 双路独立控制：单设备支持2路物理照明线路的独立控制，完美适配园区常见的“双控灯”或“主副灯”场景。

• 网络适应性强：采用WiFi 2.4G直连，无需额外购买网关，降低项目整体TCO（总拥有成本）；且支持设定5组WiFi，网络稳定性高。

• 开放接口友好：提供全开放的HTTP API接口，签名验证机制简单（MD5嵌套），无论后端是Java、Python还是PHP，均可快速集成。

2. 系统设计

本方案的核心理念是将“设备层”与“业务层”解耦，通过芯步的云平台作为桥梁。

• 设备层：部署2路智能墙壁开关，连接园区内的LED灯具。

• 网络传输层：设备通过WiFi连接云端（支持私有化部署，若园区有安全要求，可将消息服务器部署在局域网内）。

• 芯步云平台：负责设备状态维系与命令转发。提供统一的OpenAPI（开放接口）和MQTT推送服务。

• 园区业务层：即客户的现有系统（如OA系统、能源管理系统、园区APP或自研的SaaS平台）。

交互流程

1. 主动控制：园区管理后台 $\rightarrow$ 调用HTTP接口 $\rightarrow$ 芯步云 $\rightarrow$ 墙壁开关 $\rightarrow$ 灯亮/灭。

2. 状态上报：墙壁开关状态变更 $\rightarrow$ 芯步云 $\rightarrow$ 消息推送到园区服务器（实时同步）。

3. 集成开发核心步骤

要将该设备集成到现有项目，开发人员仅需关注“签名生成”与“指令封装”。

3.1 接口鉴权与准备

所有API请求均需携带签名（sign）和时间戳（ts），防止接口被恶意篡改。

• 鉴权公式sign = md5( md5(AppSecret) + ts )。

• 变量获取

  • AppID/AppSecret：在芯步控制台的“开发设置”中获取。

  • Device ID：设备外壳或控制台设备列表中的唯一标识。

3.2 核心指令集成（对项目方开放）

针对园区照明的两类核心场景，封装以下API接口供前端或业务逻辑调用：

第一种场景：单路继电器控制（基础开关）

用于手动控制或定时任务触发。

• 接口地址https://api.thingboot.com/{AppID}/device/control/

• 请求方法：POST (JSON格式)

• 请求示例

  { "device": "123456789", // 设备ID "order": { "power1": 1, // 1表示开启，0表示关闭；此处控制第一路 "power2": 0 // 此处控制第二路关闭 } }

• 集成效果：开发者只需在代码中发起HTTP请求，即可实现园区照明的一键全关或定时开关。

第二种场景：点动/触发模式（适用于感应控制）

在园区走廊或卫生间，常需要配合人体传感器实现“人来灯亮，人走灯灭”。若直接使用“开启”指令，人走后无法自动关闭。利用设备的 “先通后断” 模式可完美解决。

• 指令参数"point1": 30000 （第一路瞬时接通，30秒后自动断开）。

• 业务逻辑：园区自有的传感器判断到有人 $\rightarrow$ 调用 point1 指令 $\rightarrow$ 灯亮30秒 $\rightarrow$ 30秒后设备自动灭灯（无需服务器干预）。

• 注意：该时间单位是毫秒（ms）。

第三种场景：状态保持（场景切换）

用于园区会议室或活动室。例如保洁人员可能误触关闭了本应常亮的灯。

• 指令参数"power1": { "value": 1, "keep": 3600000 } （开启第一路，并锁定状态1小时，期间按键无效）。

• 价值：防止非法操作，确保特定时间段（如晚自习、加班时段）的照明稳定。

3.3 消息推送与同步（Webhook）

项目需要实时获取设备状态（如某线路故障或被人为按灭），以便前端UI更新。

• 配置：在芯步控制台设置“API回调URL”（即园区自己的服务器地址）。

• 接收格式当有人按下墙壁开关物理按键时，芯步云会主动POST数据到配置的地址：

  { "device": "123456789", "status": { "power1": 0, // 第一路被关闭 "power2": 1 } }

• 集成动作：园区后端接收此数据并存入数据库，WebSocket推送到前端，实现App/网页上的状态实时更新。

4. 关键业务场景

4.1 经纬度定时照明（园区道路/泛光照明）

• 实现的方式是：在项目后端集成天文算法（或调用第三方API）获取当前经纬度的日落/日出时间。

• 逻辑：后端定时任务（例如每日下午5点计算） $\rightarrow$ 计算今日日落时间为18:23 $\rightarrow$ 组装命令 {"power1": 1}$\rightarrow$ 调用设备控制接口。

• 优势：相比传统时控开关，每天自动微调，避免冬季天黑灯未亮或夏季天亮灯未灭的能源浪费。

4.2 能耗监测与运维联动

虽然开关本身不带计量功能，但通过接口调用日志可实现“软计量”：

• 策略：记录每次 power1 指令的调用时长。

• 价值：当某条线路连续运行超过阈值（如连续亮灯24小时），系统自动判定为“异常长明”或“设备粘连”，触发工单系统提醒维修人员处理。

4.3 本地局域网控制

对于高安全要求的园区（如军工、研发保密中心）：

• 私有化部署：利用设备支持的“局域网纯网环境”特性。

• 修改API域名：将请求地址从 api.thingboot.com 修改为自建的本地消息服务器地址。

• 效果：所有控制指令不出园区，即使外网断开，通过园区内网依然可以正常控制照明。

5. 实施注意事项

1. 设备配网：首次使用需通过芯步提供的配网工具（通常是APP/小程序）将设备连接到园区WiFi。注意：设备仅支持2.4G WiFi，若园区AP开启了5G优先，需进行调整。

2. 负载适配：如果是LED节能灯，需确认功率是否满足该开关的最小负载要求（避免出现幽灵闪烁）。

3. 异步处理：API返回的code 200仅代表指令下达成功，不代表设备执行成功。若需要强反馈（如“灯确实亮了”），需配合消息推送机制，通过设备上报的状态反向确认。

4. 并发控制：通过 device 参数支持批量控制，例如 device=111,222,333。这在园区下班时间执行“一键关灯”时可大幅降低调用次数，但单次不超过100台。

通过上述方案，开发者可在2小时内完成从注册到第一个指令下发的原型验证，快速将传统照明升级为可感知、可编辑、可预测的智慧园区照明系统。