写字楼办公室照明管理：怎么把双开智能触摸开关接入到软件项目中_解决方案

CATALOG

芯步的智能开关开放了标准HTTP API，通过“签名认证+指令下发”即可将双开开关接入各类软件项目。以下是完整的落地方案，涵盖接口原理、代码示例和场景配置。

解决方案：基于芯步开放接口的写字楼办公室照明管理（双开智能触摸开关接入）

1. 背景与选型

在写字楼办公室场景中，通常需要将公共办公区、独立办公室、会议室等空间的照明进行集中管控。采用 芯步智能墙壁触摸开关2路（型号：UNI-KG-CM-2） 可以很好地解决这一问题。

核心优势：该设备无需网关，直连WiFi 2.4G；支持标准的HTTP API接口，兼容任何现代编程语言（Java, Python, Go, Node.js等）。
双路价值：一个开关面板可独立控制两路照明（例如：路1控制办公区主灯，路2控制走廊灯或氛围灯带），实现精细化分区。

2. 接口对接架构

整个接入方案采用 请求-响应 同步模式，无需复杂的MQTT订阅，适合快速集成到现有的OA系统、小程序或企业微信/钉钉应用中。

通讯流程：软件项目（App/Web） -> 芯步云API （或企业私有化服务器） -> 智能开关（WiFi） -> 灯具。
签名机制：采用 MD5 （MD5（AppSecret） + ts） 的双重MD5加密方式，保障接口调用安全。

3. 对接实施步骤

3.1 前期准备：设备配网与控制台配置

设备上电：零火线接入（注意：芯步开关一般为零火版，需确认办公室线路），按键指示灯亮起。
配网
- 打开“芯步”小程序或登录控制台工作台。
- 点击“网络配置”，输入办公室的2.4G WiFi密码。
- 通过手机热点模式或扫码将开关加入网络，直到设备指示灯停止闪烁。
获取凭证
- 在芯步控制台获取 AppID 和 AppSecret。
- 记录下设备的唯一标识 Device ID （如：1878）。

3.2 核心接口调用：双路控制逻辑

双开开关的控制核心在于 order 参数中的 power1 （第1路）和 power2 （第2路）。

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

请求方法： POST

签名计算示例（伪代码）：

双路控制的JSON指令：要实现对双开开关的完全控制，只需构建对应的JSON字符串。

场景 A：上班模式（全开）打开办公室所有灯光。
{ "device": "设备ID"， "order": {"power1": 1， "power2": 1} }
场景 B：午休/会议模式（仅保留必要照明）关闭主灯，保留走廊灯或间接照明。
{ "device": "设备ID"， "order": {"power1": 0， "power2": 1} }
场景 C：下班模式（全关）
{ "device": "设备ID"， "order": {"power1": 0， "power2": 0} }

3.3 代码集成示例（前端/后端）

以下是一个通用HTTP调用示例，适用于Node.js后端：

const axios = require（‘axios’）；
const crypto = require（‘crypto’）；

async function controlDoubleSwitch（deviceId， status1， status2） {
    const AppID = "your_app_id"；
    const AppSecret = "your_app_secret"；
    const ts = Math.floor（Date.now（） / 1000）。toString（）；

// 签名生成逻辑
    const md5Secret = crypto.createHash（‘md5’）。update（AppSecret）。digest（‘hex’）；
    const sign = crypto.createHash（‘md5’）。update（md5Secret + ts）。digest（‘hex’）；

const url = `https://api.thingboot.com/${AppID}/device/control/？sign=${sign}&ts=${ts}`；
    
    const payload = {
        device: deviceId，
        order: {
            power1: status1 ？ 1 : 0，
            power2: status2 ？ 1 : 0
        }
    }；

try {
        const response = await axios.post（url， payload， {
            headers: { ‘Content-Type’: ‘application/json’ }
        }）；
        console.log（"控制成功:"， response.data）；
    } catch （error） {
        console.error（"控制失败:"， error）；
    }
}

// 调用示例:打开第一路，关闭第二路
controlDoubleSwitch（"your_device_id"， true， false）；

4. 软件项目中的高级功能实现

4.1 场景模式联动（模式化）

在软件项目中，不必每次都单独控制两个按键。可以预设“办公场景模式”：

专注模式：仅 power1 开，关闭 power2 和不需要的灯光。
清洁模式：仅 power2 开，方便保洁人员打扫。
延时断电/先断后通：芯步的接口支持高级指令，例如使用 reset1 实现“先断后通”，适用于特定电子设备的保护，或使用状态保持 keep 参数实现“人走灯灭后的自动恢复”。
// 示例:发送一个"点动"命令，让第一路接通3秒后自动关闭（常用于茶水间排气扇） { "point1": "3000" }

4.2 局域网与私有化部署（提升稳定性）

对于对数据安全或网络稳定性要求较高的企业（如金融机构总部），可以利用芯步支持的私有化部署特性。将API请求指向企业内部的服务器地址，即使外网断开，管理员依然可以通过内部系统控制所有办公室照明。

5. 实施注意事项

零火线确认：芯步该系列开关通常需要零线。在接入前，需请电工确认办公室86底盒内是否预留零线。若为单火线路，需选型单火版模块。
WiFi信号覆盖：由于设备直连2.4G WiFi，在写字楼密集办公区，需确保开关安装位置的信号强度（RSSI）大于 -70dBm，避免频繁掉线。
设备ID管理：在后端数据库中，建立 Office_Room_Mapping 表，将物理办公室房间号（如 “10F-会议室A”）映射到 Device ID，便于运维人员界面化管理。

通过以上步骤，即可快速将物理的双开触摸开关无缝集成到现代的软件管理后台中，实现写字楼照明的数字化与节能化改造。