怎样接入两路照明智能开关来实现2路独立线路控制_解决方案

CATALOG

芯步的两路智能开关通过标准HTTP接口开放控制能力，开发者只需掌握简单的API调用即可实现独立远程控制。以下方案涵盖硬件选型、接口对接、签名计算到场景的完整流程。

1. 解决概述

本方案基于芯步提供的开放API，旨在指导开发者（或系统集成商）如何通过HTTP协议，对接其智能硬件产品，实现两路照明线路的独立远程控制。

适用产品型号：

智能触摸墙壁开关2路
智能墙壁出门开关

核心优势：

接口通用：基于HTTP协议，支持任何能发起HTTP请求的编程语言或开发平台（如小程序、Web、APP、NodeJS等）。
控制精准：可独立控制“线路1”和“线路2”，互不干扰。
支持局域网：支持私有化部署，即使在外网断开的情况下，局域网内仍可控制。

2. 硬件安装与准备

2.1 接线示意（2路独立控制）

注意： 接线前请请一定要关闭总闸，确保操作安全。

零火线接入（L/N）：为开关提供工作电源。
线路1（L1 out）：接入第一路照明灯的控制线。
线路2（L2 out）：接入第二路照明灯的控制线。

提示：请确保负载功率在额定范围内（通常单路阻性负载≤1000W，具体参见对应产品手册）。

2.2 设备配网

设备通电后，指示灯会闪烁，表示为待配网状态。请按以下步骤操作：

注册并登录芯步控制台。
在控制台的“网络配置”中，录入现场环境的 2.4G WiFi 名称和密码。
根据控制台页面的提示（开启手机热点），将开关加入网络。
成功配网后，设备会显示在控制台的设备列表中，并生成唯一的 Device ID。

3. API 接口对接指南

芯步的接口设计非常简洁，核心是签名（Sign）计算和设备命令（Order）下发。

3.1 核心参数准备

在开始编程前，请在芯步控制台的“开发设置”中获取以下凭证：

参数名称	说明	示例值
AppID	应用的唯一标识，由平台生成	`100123`
AppSecret	开发者密码，用于计算签名	`abc123xyz`
Device ID	设备的唯一ID（可查看设备列表）	`1878`

3.2 签名（Sign）计算规则

为了防止接口被恶意篡改，每次请求都需要携带动态签名。计算步骤（伪代码）如下

计算 Secret_MD5 = md5(AppSecret)
获取当前时间戳 Timestamp （单位：秒）
拼接字符串 Str = Secret_MD5 + Timestamp
计算最终签名 Sign = md5(Str)

3.3 两路独立控制命令详解

这是实现“2路独立线路控制”的核心。通过改变 order 参数中的 power1 和 power2 值，即可分别控制两路开关的通断。

请求地址https://api.thingboot.com/{AppID}/device/control/?sign={Sign}&ts={Timestamp}

请求方式：POSTContent-Type：application/json

第一种场景：仅关闭第1路，开启第2路

第二种场景：同时开启两路

4. 代码实战示例

以下示例演示了如何在NodeJS环境下（或在云函数、小程序中）调用上述接口实现控制。

// 引入必要的库
const crypto = require('crypto');

// 配置信息（请替换为控制台中的真实值）
const config = {
    appId: 'YOUR_APP_ID',
    appSecret: 'YOUR_APP_SECRET',
    deviceId: 'YOUR_DEVICE_ID'
};

// 1. 生成签名
function generateSign() {
    const ts = Math.floor(Date.now() / 1000); // 获取当前时间戳（秒）
    const md5Secret = crypto.createHash('md5').update(config.appSecret).digest('hex');
    const signStr = md5Secret + ts;
    const sign = crypto.createHash('md5').update(signStr).digest('hex');
    return { sign, ts };
}

// 2. 下发控制命令
async function controlRelay(power1, power2) {
    const { sign, ts } = generateSign();
    const url = `https://api.thingboot.com/${config.appId}/device/control/?sign=${sign}&ts=${ts}`;
    
    const requestBody = {
        device: config.deviceId,
        order: {
            power1: power1, // 1: 开， 0: 关
            power2: power2
        }
    };

console.log('发送命令:', JSON.stringify(requestBody));

// 发起HTTP请求（这里以axios或fetch为例）
    const response = await fetch(url, {
        method: 'POST',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify(requestBody)
    });

const result = await response.json();
    console.log('控制结果:', result);
}

// 3. 执行场景:例如开启第一路，关闭第二路
// controlRelay(1, 0);

5. 进阶功能应用

除了简单的通断控制，芯步的接口还支持以下复杂的商业逻辑，特别适合共享棋牌室、自习室等计时计费场景

5.1 状态保持（“锁定”功能）

场景：客人扫码付费成功后，系统锁定该路灯光（如线路1）保持开启状态，用户即使手动点击物理开关关闭，3秒后系统会自动强制拉闸，防止作弊或误关。命令示例

5.2 点动控制（先通后断）

场景：用于控制门禁电插锁或提示铃铛，触发后通电2秒自动断电。命令示例

6. 常见问题排查（FAQ）

设备不在线怎么办？
- 检查设备电源是否正常（开关面板指示灯是否亮）。
- 检查现场的WiFi网络是否稳定（注意：不支持5G WiFi，必须用2.4G）。
- 查看控制台设备列表中的“最后上线时间”。
签名计算错误（Sign Error）
- 检查MD5加密后的字符串是否为32位小写。
- 检查服务器时间是否与北京时间误差过大（时间戳不准会导致鉴权失败）。
接口返回成功但设备无动作？
- 确认 Device ID 是否复制正确。
- 确认命令格式为标准JSON格式，注意 power1 的值是数字 1 还是字符串 "1"（通常文档支持字符串，参考最新API文档）。