共享办公区照明管理：怎样将2路智能墙壁远程控制开关对接到软件项目中_解决方案

CATALOG

共享办公区的照明管理痛点很典型：工位流动性大、人走灯忘关、不同区域需求差异大。芯步的2路智能墙壁开关通过HTTP API可以很好地解决这些问题——控制命令直接用{"power1":1}这样的格式就能完成开关动作，接入门槛其实很低。以下方案从签名计算到业务落地完整覆盖，可根据实际工位布局调整分区策略。

1. 背景与需求分析

在共享办公空间中，照明能耗通常占总能耗的15%-20%，而“人走灯亮”、“公共区域长明灯”等现象普遍存在，造成大量能源浪费。传统改造方案往往需要重新布线，施工复杂、成本高昂。芯步的 2路智能墙壁远程控制开关（UNI-KG-2） 提供了一种低成本、低侵入的解决方案：它采用标准86型底盒，可直接平行替换原有墙面开关，无需重新凿墙布线。

核心需求：

远程集中控制：运营人员无需逐间巡查，通过后台即可批量关闭无人区灯光。
精细化管理：区分开放工位区、独立会议室、走廊等不同场景的照明策略。
降低开发门槛：利用标准HTTP接口，快速集成进现有的物业管理系统或SaaS平台。
保持手动习惯：保留物理按键操作，同时支持“状态保持”功能，防止用户手动关灯后被系统自动打开。

2. 设计

本方案采用“端-云-应用”的三层架构。所有智能开关通过Wi-Fi直接连接路由器（2.4GHz频段），不依赖额外的网关硬件（直连模式），从而降低项目初期投入。

设备层：部署UNI-KG-2智能墙壁开关，控制两路独立的照明回路（例如：回路1控制工位区主灯，回路2控制走廊或装饰灯）。
传输层：利用场所现有Wi-Fi网络。设备通过HTTP协议与芯步云端API交互，或通过局域网进行本地控制。
应用层：软件系统（Web/小程序/APP）通过调用芯步开放API，下发指令或订阅设备状态变更。

graph LR
    Client[管理软件/小程序] -->|HTTP请求 + Sign签名| API[芯步云端API]
    API -->|指令透传| Device[智能墙壁开关2路]
    Device -->|状态上报| API
    API -->|异步推送| Client
    Device -->|物理按键| Lamp1[照明回路1]
    Device -->|物理按键| Lamp2[照明回路2]
    
    subgraph Office [共享办公区现场]
        Device
        Lamp1
        Lamp2
    end

    subgraph Cloud [云端/服务器]
        API
    end

3. 技术对接：API与签名机制

对接的核心在于解决设备寻址与安全认证。芯步的接口采用动态签名机制，有效防止接口被恶意篡改。

3.1 签名生成算法

接口调用需要携带 AppID、ts（时间戳）和 sign（签名）。签名生成逻辑如下，后端需严格按此逻辑封装：

将开发者密码（AppSecret）进行一次MD5加密，得到字符串 S1。
将 S1 与当前时间戳 ts（秒级）拼接，得到字符串 S2。
对 S2 再次进行MD5加密，得到最终的 sign。

公式sign = MD5( MD5(AppSecret) + ts )

3.2 设备控制指令下发

控制设备需调用 device/control 接口。这是一个POST请求，核心参数如下：

URLhttps://api.thingboot.com/{AppID}/device/control/
Query参数sign 和 ts
Body参数
- device：设备ID（在控制台获取）。
- order：控制命令，JSON格式。

2路开关指令集

功能描述	指令JSON格式	业务场景
开启第1路	`{"power1": 1}`	上班开启工位主灯
关闭第1路	`{"power1": 0}`	下班或人走灯灭
开启第2路	`{"power2": 1}`	开启氛围灯或辅助照明
关闭第2路	`{"power2": 0}`	关闭辅助照明
1路点动	`{"point1": 1}`	结合传感器实现“触发-延时-关闭”
状态保持	`{"power1": 0, "lock": 1}`	锁定开关状态，防止误触

3.3 代码实现示例（伪代码/后端逻辑）

在后端服务中，您可以封装一个通用函数。以下核心逻辑片段：

4. 共享办公场景：联动逻辑设计

硬件对接完成后，业务逻辑的优化是节能关键。在软件项目中配置以下自动化规则：

4.1 人体传感器联动

在开放工位区部署“智能人体存在传感器”。当软件系统接收到“无人”状态上报时，延迟5分钟向指定设备ID下发 {"power1": 0} 命令，关闭工位灯光。

4.2 定时任务与“状态保持”结合

共享办公常遇到预定会议室未使用的情况。

场景：某会议室预定9:00-10:00。系统设定9:05自动开灯。
问题：若用户手动关灯离开，系统不应强制再开。
解决：下发命令时利用 状态保持 功能。命令格式：{"power1": 1, "lock": 1}。这表示将开关打开，但如果用户手动按了墙壁开关关闭，系统不会自动恢复，尊重了现场人员的物理操作意愿。

4.3 基于“点动”的节能模式

在午休或打扫时段，可使用 point1 命令。例如下发 {"point1": 1}，灯光会短暂开启（如默认几秒或一分钟）后自动熄灭，适合在仓库、垃圾房等不需要长时间照明的区域使用。

4.4 数据可视化

通过轮询设备状态或接收消息推送，在管理后台绘制“能耗热力图”。对于长期拒绝执行关灯指令的工位（设备在线但人为拒绝关灯），在软件中标记为“高能耗工位”，便于运营团队沟通。

5. 部署与实施注意事项

Wi-Fi信号覆盖：UNI-KG-2仅支持2.4GHz Wi-Fi 。在部署前，必须使用Wi-Fi分析工具检查共享办公区各隔间（尤其是弱电箱附近的金属底盒内）的信号强度，避免因信号弱导致设备离线。
负载限制：虽然额定10A，但在LED灯场景下，单路负载小于300W 。一个回路不宜挂载过多灯具。
电容并接：在低功率LED灯（如小于5W）场景下，为防止“鬼火”（关灯后微闪），硬件安装时需将包装内附带的电容并接在零火线上。
离线处理：共享办公网络复杂，若偶尔断网，软件系统应设计“失败重试”与“离线告警”机制。同时，由于该设备支持本地局域网控制（私有化部署），若您的软件服务器与设备处于同一局域网，可走局域网API通道，响应更快且不受外网波动影响。

6. 总结

通过将芯步2路智能墙壁开关的标准HTTP接口对接到软件项目中，共享办公空间可以快速实现“低成本、零重布线”的智能化改造。软件开发者只需关注签名安全与业务逻辑（定时、联动、传感器数据融合），硬件层面即可稳定执行通断指令。该方案不仅解决了长明灯浪费问题，还提升了共享办公的科技感与入驻体验。