这篇方案会从硬件选型、API对接逻辑到代码实现逐层展开，重点是讲清楚双开开关如何与传感器、管理后台联动，实现真正的“按需照明”。
1 背景与目标
在共享办公空间中，照明管理长期面临“长明灯”导致的能源浪费、人工管理效率低下以及办公体验不佳等痛点。芯步的双开智能触摸开关（UNI-KG-CM-2）凭借其开放、标准的HTTP API接口，为开发者提供了一种低门槛、高集成度的硬件控制方案。本方案的目标是指导软件工程师如何将双开智能触摸开关无缝集成到现有的共享办公管理后台、小程序或APP中，实现照明设备的远程控制、定时策略与状态监控，最终达成“人来灯亮、人走灯灭”的智能化节能目标。
2 硬件选型与接口概览
2.1 硬件：双开智能触摸开关
本方案选取智能触摸墙壁开关2路作为执行单元。该设备支持两路独立照明电路控制（例如分别控制办公区与会议室，或主照明与氛围灯），适配标准86型底盒，可直接替换传统开关，无需大规模线路改造。设备通过WiFi 2.4G直接联网，无需额外网关，降低了硬件部署成本。
2.2 开放接口特性
该产品的核心优势在于其全开放的HTTP API体系，具体特性如下表所示：
| 特性 | 描述 | 技术价值 |
|---|---|---|
| 协议通用性 | 采用标准HTTP协议，JSON数据格式 | 任何编程语言（Java/Python/Go/JS等）均可调用，无SDK绑定 |
| 通信模式 | 支持公网SaaS与局域网私有化两种模式 | 既可快速接入云端SaaS，也可部署于纯内网环境保障数据安全 |
| 安全机制 | 双重MD5签名验证（AppSecret + Timestamp） | 防止请求伪造与重放攻击，保障设备控制安全 |
| 响应速度 | 瞬时下发，WiFi直连 | 实测开关响应延迟极低，体验接近物理按键 |
核心接口定义：
控制接口
POST /{AppID}/device/control/参数示例
3 软件集成设计
为了实现模块化开发与高可用运维，采用分层架构将硬件管理能力封装为业务中台的一部分。
3.1 整体架构图描述
设备层：部署于各工位、会议室的双开智能触摸开关，通过WiFi连接路由器。
接入层（Open API）：芯步提供的API网关，负责设备鉴权与指令转发。
服务层（业务后端）
设备控制服务：封装鉴权Sign算法，提供RESTful接口给前端调用。
定时任务服务：基于xxl-job或类似框架，执行预设的定时策略。
事件处理服务：接收硬件上报的状态变更回调。
应用层（前端）：Web管理后台、租户小程序、运营APP。
3.2 关键流程：Sign签名生成算法
接口调用的核心是鉴权。根据官方文档，签名的生成逻辑需在后端严格实现，避免将AppSecret暴露在前端。算法逻辑如下：
注：时间戳（ts）取秒级，服务器会校验时间戳有效性，防止过期请求
4 具体实现步骤
4.1 设备接入与配网
注册与创建：在芯步控制台注册账号，创建工作台并获取AppID与AppSecret。
设备配网：长按开关触摸面板进入配网模式（指示灯闪烁），通过“芯步”小程序或热点模式配置WiFi密码。
获取Device ID：配网成功后，在控制台设备列表页面获取唯一的设备ID（Device ID），作为后续指令的目标参数。
4.2 后端服务开发节点
在共享办公系统中，设备控制绝非简单的“开”与“关”，需结合业务逻辑。
第一种场景：通过管理后台手动控制运营人员需在后台关闭某间未预约但亮灯的会议室。
实现逻辑：前端调用后端接口
POST /api/light/control，携带device_id和channel（1或2）。代码示例（Java伪代码）
第二种场景：集成人体传感器实现“人走灯关”这是共享办公的核心价值实现。通常利用工位区域的毫米波雷达传感器检测人员存在状态。
联动逻辑
传感器检测到“无人”状态超过10分钟。
业务服务器收到传感器的回调事件。
服务器调用芯步API，向对应区域的双开开关下发
{"power1":0, "power2":0}指令。
第三种场景：定时与预约策略
需求：每晚22:00强制关闭所有非24小时区域的灯光。
实现：使用定时任务框架，每晚22:00查询数据库中的“非24小时区域”设备列表，批量循环调用关闭接口。
4.3 前端交互设计
租户小程序侧：提供简洁的控制卡片，支持远程关闭桌位灯光，解决“离开忘记关灯”的痛点。
管理后台侧：提供楼层平面图可视化控制，支持分组管理（如将整个开放区的开关绑定为一个分组，实现一键全开/全关）。
5 高级功能与策略优化
为了进一步提升用户体验与节能效率，可利用双开开关的高级API命令实现精细化管理。
5.1 “点动模式”与状态保持
共享办公区常有临时使用者，物理按键操作习惯不同。
技术实现：调用接口时，
order字段可传入point1（点动-先通后断）或reset1（点动-先断后通）。应用场景：例如在茶水间，设置开关为“复位模式”，用户按下开关后灯光延时3分钟自动关闭，避免茶水间无人时长时间亮灯。
5.2 基于照度传感器的恒照度控制
若环境配置了光照传感器，双开开关可用于调整灯光亮度（需配合可调光驱动，或通过继电器进行通断循环）。
策略：靠近窗户的区域，当自然光充足时，软件逻辑自动维持
power=0（关灯）；当傍晚照度低于阈值时，自动下发指令开启照明，且不响应用户的“关灯”请求（通过软件锁定控制）。
5.3 故障与离线处理
心跳监测：软件系统需定期记录设备最后心跳时间。若设备离线（如WiFi断连），系统应向前端推送“设备离线告警”，提示运维人员检查。
本地直连容灾：由于设备支持局域网HTTP API，当外网断开时，如果后端服务部署在同一局域网内，依然可以通过内网IP直接调用指令，保障核心控制功能不中断。
6 方案优势与效益分析
通过将芯步双开智能触摸开关集成至共享办公软件系统，可带来以下显著收益：
开发效率提升：无需编写底层嵌入式代码，无需处理复杂的MQTT协议栈，直接使用HTTP协议即可完成控制，将数月的物联网开发周期缩短至数天。
运维成本降低：无需购买额外网关设备，降低了硬件故障点。API接口的远程控制配合管理后台，可大幅减少人工巡场关灯的人力成本。
用户体验升级：实现了照明与工位预约系统、安防系统的数据打通。例如：用户通过小程序预定工位，系统自动开启该区域的灯光和插座，打造“无感”智慧办公体验。
综上所述，基于芯步开放的API能力，共享办公软件项目可像调用支付宝支付接口一样简单地控制物理照明设备。开发者只需关注业务逻辑（何时开、为何关），无需关注复杂的通信协议，即可快速构建出稳定、高效的照明管理系统。