一、背景与需求痛点

现代写字楼办公室的照明管理面临一个典型矛盾：一方面，企业希望通过智能化改造实现节能降耗、远程控制和自动化管理；另一方面，用户早已习惯传统的物理按键操作方式，完全取消实体开关会带来使用体验的割裂感。

所谓“复合开关”，是指同一路灯具同时支持两种控制方式：一是传统的物理按键本地控制，二是通过物联网平台进行的远程控制。这种“双控”模式的难点在于：如何让物理按键的即时操作与云端下发的指令保持状态同步，避免出现“实际灯亮、系统显示关”的状态不一致问题。

芯步的智能硬件产品恰好解决这一痛点——其开放接口与状态同步机制，使得将1路物理按键复合开关集成到现有楼宇管理系统中成为标准化的技术方案。

二、方案核心产品选择

2.1 推荐硬件：芯步智能墙壁开关1路

针对1路照明的复合控制需求，推荐采用芯步智能墙壁开关1路产品。该产品具备以下关键特性：

该产品最大的特点是原位替换——无需重新布线，可直接替换办公室内现有的86型墙壁开关，极大降低了改造成本和施工周期。

2.2 开放接口能力

芯步全系智能硬件均提供标准的HTTP API接口，支持任何能够发起HTTP请求的编程语言接入。这意味着现有的物业管理系统、楼宇自控平台、企业微信/钉钉应用，甚至低代码搭建的管理后台，均可通过简单的接口调用实现与硬件的通信。

接口的核心能力包括：

• 远程控制：向设备下发开/关命令

• 状态查询：获取设备当前通断状态

• 状态保持：支持“用户操作后n秒自动恢复”的场景

• 先通后断/先断后通：适用于特殊时序控制的场景

三、核心技术架构

3.1 混合组网架构

整个方案采用云-端协同的混合架构，兼顾本地响应的实时性与远程管理的便捷性：

┌─────────────────────────────────────────────────────────┐
│                    管理端（软件层）                       │
│  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐    │
│  │ Web管理后台│ │ 手机APP  │ │ 小程序   │ │ API调用   │    │
│  └────┬─────┘ └────┬─────┘ └────┬─────┘ └────┬─────┘    │
│       └────────────┼────────────┼────────────┘          │
│                    ▼           ▼                         │
│             芯步云平台 / 私有化服务器                 │
│                    │                                     │
└────────────────────┼─────────────────────────────────────┘
                     │ HTTPS / HTTP
                     ▼
┌─────────────────────────────────────────────────────────┐
│                    设备层（硬件）                         │
│  ┌─────────────────────────────────────────────────┐    │
│  │    智能墙壁开关1路（WiFi直连）                     │    │
│  │  ┌─────────┐                        ┌─────────┐ │    │
│  │  │ 物理按键 │◄──────本地控制────────►│ 继电器  │ │    │
│  │  └─────────┘     (毫秒级响应)        └────┬────┘ │    │
│  │                                           │      │    │
│  │                                      ┌────┴────┐ │    │
│  │                                      │ 照明线路 │ │    │
│  │                                      └─────────┘ │    │
│  └─────────────────────────────────────────────────┘    │
└─────────────────────────────────────────────────────────┘

3.2 状态同步机制

复合开关的核心技术难点在于状态同步。芯步的解决方案是通过云端作为“状态中枢”：

1. 物理按键操作时：用户按下物理按键，设备继电器动作，同时设备自动将最新状态上报至云端；

2. 远程控制时：云端下发命令至设备，设备执行后回传执行结果；

3. 状态查询时：任何管理端均可通过API查询设备当前状态。

这种机制确保了无论通过何种方式操作，所有管理端看到的状态始终与物理设备的实际状态保持一致。

四、集成实施步骤

4.1 第一阶段：环境准备

步骤1：注册并创建工作台

• 访问芯步官网完成账号注册

• 创建工作台，进入物联网控制台模块

步骤2：获取API凭证

• 在控制台的“开发设置”中获取AppID和AppSecret

• AppID用于标识您的应用，AppSecret用于签名计算

步骤3：添加设备

• 按照产品说明书为智能墙壁开关配网

• 在控制台中记录设备的唯一ID（device值）

4.2 第二阶段：接口集成

芯步的API采用标准的HTTP POST请求方式，核心请求地址为：

POST https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

签名计算规则（重要）

sign = MD5( MD5(AppSecret) + ts )

其中ts为当前时间的Unix时间戳（秒）。这种双层MD5加密方式确保了接口调用的安全性。

控制1路开关的请求示例

order参数的取值说明

• 开启线路：{"power1":"1"}

• 关闭线路：{"power1":"0"}

• 状态保持（用户关灯后3秒自动恢复）：{"power1":{"keep":"1","revert":"3"}}

4.3 第三阶段：状态同步处理

为了实现“复合开关”的完整体验，需要在软件系统中实现状态监听机制。

方案A：主动轮询

• 定时（如每5秒）调用设备状态查询接口

• 适用于对实时性要求不高的场景，实现简单

方案B：消息推送接收（推荐）

• 配置消息接收服务器URL

• 设备状态变化时，平台主动推送状态变更消息

• 实时性高，服务器压力小

推送的消息格式示例：

4.4 第四阶段：与现有系统对接

芯步的纯HTTP接口特性使得其能与各类现有系统无缝对接：

• 物业管理平台：通过后端服务调用API，将照明控制集成到现有工单系统或巡检系统中

• 办公协同软件：在企业微信、钉钉、飞书中开发自定义应用，实现“一键下班关灯”

• 楼宇自控系统（BAS）：通过BA系统的脚本或中间件调用API，将照明纳入楼宇整体控制策略

• 低代码平台：在简道云、明道云等低代码平台中通过HTTP模块直接调用

五、典型应用场景

5.1 第一种场景：下班一键关灯

通过管理后台或办公软件，物业人员可一键关闭整层楼甚至整栋楼的所有照明。与此同时，每个办公室内的物理按键依然可用，加班员工可自行开灯，不受远程控制影响。

5.2 第二种场景：定时+传感器联动

配合芯步的人体存在传感器，可实现“人走灯关”的自动化策略。当传感器检测到办公室无人持续N分钟后，自动下发关灯指令。若有人进入，自动开灯——用户甚至无需触碰任何开关。

5.3 第三种场景：会议室投影模式

在会议室场景中，可通过API下发状态保持命令：用户按下“投影模式”按键后，灯光自动调暗或关闭，若有人误按物理开关开灯，系统可在3秒后自动恢复关灯状态。这种“强制保持”模式特别适合对光照环境有严格要求的场景。

六、总结

核心价值：本方案在不改变用户使用习惯（保留物理按键）的前提下，将照明系统纳入数字化管理范畴。施工简单（86盒原位替换），集成方便（纯HTTP接口），既满足了物业管理的智能化需求，又兼顾了终端用户的操作体验。