商业店铺灯光电源管理：如何将30A 智能通断器接入到软件项目中_解决方案

CATALOG

针对商业店铺中普遍存在的“长明灯”、空调忘关、广告牌定时不准等电力浪费与管理痛点，芯步的30A智能通断器提供了一种高性价比的改造方案。其核心优势在于全开放式的HTTP接口，使得设备可以无缝对接现有的各类软件系统。本文将详细介绍如何通过约100行核心代码，将该硬件快速集成到您的软件项目中。

1. 解决概述

1.1 背景痛点

商业店铺（如连锁零售、便利店、餐饮等）普遍面临以下问题：

长明灯与空耗：员工下班忘记关灯、关招牌，导致电力浪费。
定时不灵活：传统定时插座调整繁琐，无法根据节假日或日出日落动态调整。
监管盲区：总部无法实时知晓各分店的设备通断状态。
改造困难：原有配电箱老旧，重新布线成本高。

1.2 解决方案

基于芯步智能断路器30A (UNI-DLQ-30A) ，利用其 “WiFi直连+HTTP开放接口” 的特性，直接将设备安装于店铺配电箱内，通过调用极简的HTTP API接口，即可将该设备集成进现有的连锁店管理系统、小程序或SaaS平台中。

1.3 核心优势

无需网关：设备直连WiFi 2.4G网络，降低硬件成本与故障点。
高功率承载：30A容量，可直接控制店铺总闸、多路灯光、灯箱广告或空调。
响应极快：指令下发到执行仅需80-120ms，操作无延迟感。
接口通用：支持任何支持HTTP请求的编程语言（Java, Python, PHP, Go, C#等）。

2. 硬件选型与部署

2.1 产品选型

型号：芯步智能断路器30A (UNI-DLQ-30A)。
适用场景：单路总功率较大的设备（如主照明回路、灯箱、冷柜电源），或单回路控制在30A以内的混合负载。

2.2 部署架构

网络层：设备通过WiFi连接至店铺路由器（需2.4G频段）。
数据流
1. 软件端(SaaS/App)发起HTTP请求。
2. 芯步云平台接收指令并进行签名验证。
3. 云平台下推指令至店铺内的30A通断器。
4. 通断器执行吸合/断开，控制灯光电源。

2.3 关键部署配置

WiFi配置：设备支持配置5组WiFi，会优选信号最强的连接，保障稳定性。
私有化部署：如果对数据安全要求比较高，芯步支持私有化部署，指令可完全在局域网内部流转，不经过公网。

3. 软件集成开发指南

这是集成的核心部分。芯步的接口设计极其简单：只需控制 power (电源) 字段。

3.1 接口鉴权机制

为了防止恶意控制，接口采用动态签名方式。你需要准备：

AppID：应用唯一标识。
AppSecret：开发者密钥（请妥善保管）。
ts：当前Unix时间戳（秒）。
sign：签名，计算公式为 md5( md5(AppSecret) + ts )。

注：具体的参数值（AppID、AppSecret、Device ID）可在芯步控制台获取，这里以示例值演示。

3.2 核心接口调用示例

以下是一个通用的HTTP请求示例，适用于任何编程语言。

请求地址

https://api.thingboot.com/{你的AppID}/device/control/?sign={你的签名}&ts={当前时间戳}

请求方式

POST

请求头 (Headers)

Content-Type: application/json

请求体 (Body)

第一种场景：开启灯光（通电）发送 {"power": 1} 即可让继电器吸合，设备接通电源。

第二种场景：关闭灯光（断电）发送 {"power": 0} 让继电器断开。

第三种场景：定时关闭（自动关灯）这是一个很实用的功能，软件端无需维护定时任务队列，只需告诉设备要接通多久后自动断开。

参数解析reset 单位为毫秒。这里 3600000 毫秒 = 1小时。设备会立即接通电源，并在1小时后自动断开。这非常适合用于“临时加班开灯”或“试衣间/仓库延时关灯”场景。

3.3 代码实战：Python与JavaScript接入

为了让你直观地理解集成过程，这里提供核心控制函数的伪代码逻辑。

Python 3.6+ 接入示例

使用 requests 库即可轻松实现。签名生成过程涉及两次MD5加密，需严格按文档拼接。

JavaScript (Node.js / Web) 接入示例

前端或云函数可参考以下逻辑调用HTTP接口实现远程控制。

const crypto = require('crypto');

// 1. 配置参数（替换为控制台实际值）
// 这里的值仅为占位示意，实际请替换
const APP_ID = 'YOUR_APP_ID';
const APP_SECRET = 'YOUR_APP_SECRET';
const DEVICE_ID = 'YOUR_DEVICE_ID';

async function toggleLight(powerStatus) {
    // 生成时间戳
    const ts = Math.floor(Date.now() / 1000);
    
    // 计算签名: md5(md5(secret) + ts)
    const md5Secret = crypto.createHash('md5').update(APP_SECRET).digest('hex');
    const signRaw = md5Secret + ts;
    const sign = crypto.createHash('md5').update(signRaw).digest('hex');

// 请求配置
    const url = `https://api.thingboot.com/${APP_ID}/device/control/?sign=${sign}&ts=${ts}`;
    const body = {
        device: DEVICE_ID,
        order: { power: powerStatus }  // 1为开，0为关
    };

try {
        const response = await fetch(url, {
            method: 'POST',
            headers: { 'Content-Type': 'application/json' },
            body: JSON.stringify(body)
        });
        const result = await response.json();
        console.log('控制成功:', result);
    } catch (error) {
        console.error('控制失败:', error);
    }
}

// 调用示例:开启灯光
toggleLight(1);

4. 高级应用场景与功能

4.1 多路独立控制 (适用于4路控制器)

如果你采购的是4路版本（30A通常是1路，但芯步系列存在4路控制器），你可以独立控制每一路。

API指令{"power1":1} (开启第1路)，{"power2":0} (关闭第2路)。
应用：一路接普通照明，一路接备用插座，一路接灯箱广告，通过软件界面独立分开控制。

4.2 传感器联动 (打造全自动店铺)

结合芯步的传感器产品（如人体存在传感器），可以实现人来灯亮、人走灯灭的极致节能。

架构：人体传感器检测到“无人”状态 -> 传感器上报数据至服务器 -> 服务器自动调用API -> 30A通断器执行断电。
注意：这需要你的软件项目订阅设备上行消息（通过消息推送接收传感器状态）。

4.3 数据监控与状态同步

智能通断器支持状态实时上报。

实时同步：当店员在店内按下物理按键开关时，设备会上报状态变化，你的软件界面上的开关按钮会实时更新状态，避免了“指令发了但实际上没控制到”的界面状态不同步问题。

5. 总结

将芯步30A智能通断器接入商业店铺管理系统，技术门槛极低：HTTP协议 + JSON数据格式 + MD5签名。

通过上述方案，开发人员只需编写几十行代码封装API请求，即可让店铺的灯光、电源管理插上物联网的翅膀。这不仅实现了：

远程集中控制：一个App管所有分店。
能耗精细化管理：通过定时任务杜绝浪费。
自动化场景联动：提升科技感与用户体验。

实施路径

采购“芯步智能断路器30A”。
在芯步官方控制台注册账号，获取AppKey/Secret。
参照本文第三节代码块，编写一个控制函数进行测试。
将控制函数集成进现有后台管理系统，开发可视化开关按钮。
（可选）配置消息推送服务，实现状态实时同步。

注：具体的API接口地址、AppID及Device ID等参数，请以芯步官方最新文档及控制台实际获取为准。