办公设备照明联动中：怎么将双路智能墙壁控制开关接入到自己的项目中_解决方案

CATALOG

芯步的双路智能墙壁开关通过标准的 HTTP API 接口对外开放控制能力，签名机制简单、命令语义清晰，可以很方便地集成到办公照明联动系统中。以下方案从接口对接、签名算法到具体业务场景（如人体传感器联动）逐步展开，你可根据实际开发语言调整代码示例。

解决方案：基于芯步双路智能墙壁开关的办公设备照明联动接入方案

一、背景与目标

在现代智能办公场景中，实现照明的自动化控制（如人来灯亮、人走灯灭或定时关断）是节能降耗和提升员工体验的关键。本方案的目标是解决如何将芯步双路智能墙壁开关（以 UNI-KG-2 型号为例）快速接入现有的办公管理系统（如 Web 管理后台、企业内部 App 或小程序）。

核心目标是利用设备开放的 HTTP API 接口，通过编程方式实现对办公室两路独立照明回路的远程通断控制、状态查询以及与其他传感器（如人体存在传感器）的联动。

二、核心对接原理

芯步的双路开关采用 WiFi 直连方式，无需网关。对接的核心是通过 HTTP 请求调用芯步的云端 API。

控制链路：业务系统 → 芯步云 API → 办公室 WiFi → 墙壁开关 → 照明设备。
数据格式： RESTful API + JSON。
鉴权方式： MD5 双重加密签名。

三、接入前的准备工作

在编写代码前，需要进行如下硬件与软件配置

硬件准备
- 设备：芯步智能触摸墙壁开关2路（需安装并通电）。
- 网络：确保办公室有 2.4GHz 的 WiFi 信号覆盖开关安装位置。
平台账号准备
- 注册账号。
- 登录控制台，获取 AppID 和 AppSecret。这是后续 API 调用的身份凭证。
- 将双路开关通过“物联网控制台”或小程序配网添加到您的账号下，获取该设备的唯一标识 Device ID。

四、接口接入技术详解

1. 签名机制

为了防止接口被恶意篡改，芯步使用了动态签名。签名生成规则如下 $YourSign = md5( md5(AppSecret) + ts )$

AppSecret：开发者密码。
ts：当前 UNIX 时间戳（秒）。
拼接顺序：先将 AppSecret 进行一次 MD5 加密得到 32 位小写字符串，接着拼接上时间戳 ts，最后将整个字符串再进行一次 MD5 加密。

示例：若 AppSecret 为 abc123，ts 为 1700000000，则先计算 md5(abc123) 得到 xxx，再计算 md5(xxx1700000000)。

2. 双路独立控制命令集

该开关支持两路线路。你需要通过 order 参数传递 JSON 字符串来指定控制哪一路以及执行什么动作。

动作描述	命令格式（order参数）	适用场景
1路开启	`{"power1": 1}`	打开第一组灯（如办公区主灯）
1路关闭	`{"power1": 0}`	关闭第一组灯
2路开启	`{"power2": 1}`	打开第二组灯（如会议区射灯）
2路关闭	`{"power2": 0}`	关闭第二组灯
点动控制	`{"point1": "2000"}`	1路先通电，2秒后自动断电。适用于门禁或暂态控制
状态保持	`{"power1": {"keep":1, "revert":10}}`	重要：强制锁定状态，防止用户手动关掉。维持开启10秒后恢复自动逻辑

五、代码落地：从单控到业务集成

以下是一段通用的业务系统集成逻辑，展示了如何将开关控制嵌入到你的办公自动化（OA）或楼宇自控系统中。

场景： 你的办公管理系统需要在下班时间自动关闭某个会议室的全部灯光。

开发步骤：

引入依赖：任何支持 HTTP 请求的语言均可（Java, Python, PHP, Node.js）。
编写核心函数：封装签名生成与请求发送。

Node.js 集成示例（基于 Express/Vue 后端）

const crypto = require(‘crypto’);
const axios = require(‘axios’);

// 配置从环境变量或数据库读取，确保安全
const config = {
    appId: ‘YOUR_APP_ID’,
    appSecret: ‘YOUR_APP_SECRET’,
    deviceId: ‘YOUR_DEVICE_ID’ // 刚从控制台添加的设备ID
};

// 1. 编写签名生成函数
function generateSign(ts) {
    // 第一步: md5(AppSecret)
    const firstMd5 = crypto.createHash(‘md5’).update(config.appSecret).digest(‘hex’);
    // 第二步: md5(第一步结果 + ts)
    const sign = crypto.createHash(‘md5’).update(firstMd5 + ts).digest(‘hex’);
    return sign;
}

// 2. 控制设备函数
async function controlSwitch(channel, action) {
    const ts = Math.floor(Date.now() / 1000); // 获取当前秒级时间戳
    const sign = generateSign(ts);
    
    // 构建命令
    let order = {};
    if (channel === ‘Light_1’) order = { "power1": action ? 1 : 0 };
    if (channel === ‘Light_2’) order = { "power2": action ? 1 : 0 };
    
    // 请求 URL 示例: https://api.thingboot.com/AppId/device/control/
    const url = `https://api.thingboot.com/${config.appId}/device/control/?sign=${sign}&ts=${ts}`;
    
    try {
        const response = await axios.post(url, {
            device: config.deviceId,
            order: order
        }, {
            headers: { ‘Content-Type’: ‘application/json’ }
        });
        console.log(设备控制成功:, response.data);
        return response.data;
    } catch (error) {
        console.error(控制失败:, error);
    }
}

// 3. 业务调用:下班自动关灯
// controlSwitch(‘Light_1’, 0);
// controlSwitch(‘Light_2’, 0);

六、进阶场景：实现办公设备照明联动

在办公场景中，开关往往不是孤立工作的。通常需要利用传感器的数据来触发开关动作。

联动逻辑：当人体存在传感器探测到“无人”状态持续 10 分钟后，通过你的业务服务器调用上述接口关闭双路开关。

接收事件：你的服务器接收来自芯步“人体存在传感器”的告警回调。
业务判断：后端服务校验该办公区域当前是否为“可关闭”状态（例如：不在工作时间范围内）。
下发指令：调用 controlSwitch 函数，将对应区域的开关关闭。

针对复杂自动化场景的补充说明：如果你担心员工手动关闭了开关导致自动化失效，或者需要强制保持灯亮（例如在清洁时段），可以使用状态保持命令：

七、局域网与私有化部署

对于注重数据安全或网络稳定的高端写字楼项目，芯步支持局域网和私有化部署。

局域网：如果业务服务器与开关在同一局域网内，API 请求可以不经过公网，直接指向路由器的内网 IP，延迟可降至毫秒级。
私有化：芯步可提供完整的后台部署包，数据完全存储在企业内部服务器。

八、总结

通过芯步开放的 HTTP API，将双路智能墙壁开关接入你的项目只需三个步骤：

获取凭证（AppID/Secret/DeviceID）；
实现签名算法（MD5 嵌套）；
发送 POST 请求（JSON 格式命令）。

该方案不仅支持基础的开关灯，通过配合“点动”、“保持”等高级命令，还能延伸出会议模式、下班巡视、设备保护等丰富的办公自动化场景。如果你的系统需要对接门禁或窗帘电机，其底层逻辑与此完全一致，只需替换对应的 order 命令即可。