CATALOG

[6650] 文档版本:V1.0 更新日期:2026年5月 适用对象:软件工程师、智能家居集成商、公寓运营管理方

第一章:场景痛点与解决概述

1.1 出租屋照明管理的运营挑战

在出租屋、公寓、民宿等租赁场景中,照明控制不仅关乎租客体验,更直接影响运营成本和能源效率。传统管理方式面临以下痛点:

痛点具体表现带来的问题
能源浪费严重租客离房后忘记关灯电费持续产生,单间月浪费可达数十度电
场景切换不便无预设场景模式每次需手动调节多路灯光,体验差
无人化管理难退租后需人工断电无法实现远程控制和自动化运营
缺乏数据支撑无用电数据统计无法分析能耗规律,优化空间不明

1.2 解决方案:智能照明控制器实现场景化控制

芯步智能照明控制器专为出租屋/公寓场景设计,通过HTTP接口与租赁管理软件对接,实现“远程控制、场景预设、定时任务、能耗监测”的完整智能照明闭环

核心价值

  • 一机多控:单台设备控制多达8路照明,覆盖整套出租屋

  • 场景化体验:预设“会客”、“观影”、“睡眠”等模式,一键切换

  • 远程管理:租客离房后自动关灯,运营方远程统一管控

  • 开放接口:标准HTTP API,支持接入任何租赁管理软件

第二章:硬件选型与部署方案

2.1 推荐产品:智能照明控制器8路

针对出租屋场景,推荐使用芯步智能照明控制器8路:

参数项规格详情
产品型号UNI-KZQ-ZM-8-10A / UNI-KZQ-ZM-8-16A
控制路数8路独立控制
额定电流10A版MAX 10A/路,16A版MAX 16A/路
单路阻性负载10A版2200W,16A版3500W
单路感性负载10A版350W,16A版500W(LED灯等注意降额)
总负载功率全接通时不超过4400W(阻性负载)
工作电压AC 85-265V(交流/市电)
无线连接WiFi 2.4GHz
外壳材质防火V0级PC,符合安规标准

2.2 同一品类版本对比

版本单路电流阻性负载感性负载适用场景
10A版MAX 10AMAX 2200WMAX 350WLED灯、节能灯为主
16A版MAX 16AMAX 3500WMAX 500W含大功率电器

选型:出租屋照明以LED灯为主(感性负载),选择10A版即可,每路不超过2-3盏LED灯

2.3 其他可选型号

根据出租屋规模,还可选择以下型号:

产品型号控制路数适用场景
智能照明控制器4路4路单间/小型出租屋
智能墙壁开关1路1路(86盒安装)单灯控制/替换原有开关
智能包间控制器|Mini4路含门禁接口的公寓

2.4 负载功率注意事项(重要)

出租屋照明以LED灯为主,属于感性负载,使用时需特别注意:

负载类型功率限制说明
LED灯/节能灯MAX 350W/路(10A版)启动电流可达额定5-7倍
普通白炽灯MAX 2200W/路(10A版)阻性负载,可满载
总负载MAX 4400W8路总功率之和限制

⚠️ 重要提示:LED灯每路控制在300W以内(约2-3盏),避免启动冲击电流损坏设备。

第三章:HTTP接口协议详解

3.1 整体架构

芯步智能照明控制器采用标准的HTTP请求-响应模型,适用于任何支持HTTP请求的编程语言,可无缝接入租赁管理Web、APP/小程序等系统

graph LR
    subgraph 软件层
        A[租赁管理平台/小程序]
    end
    
    subgraph 网络层
        B[芯步API网关
api.thingboot.com] end subgraph 硬件层 C[智能照明控制器8路] D[客厅照明] E[卧室照明] F[卫生间照明] end A -- HTTP POST --> B B -- MQTT透传 --> C C --> D C --> E C --> F

性能指标:从命令下发到设备响应,端到端延迟约80-120ms,响应非常快

3.2 请求地址格式

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

URL参数说明

参数说明示例
{AppId}应用ID,在芯步控制台获取10001
sign动态签名,验证请求合法性a1b2c3d4...
ts当前Unix时间戳(秒级)1746000000

3.3 签名算法(核心安全机制)

芯步API采用双重MD5签名机制,确保接口调用的安全性

Sign = md5( md5(AppSecret) + ts )

签名计算步骤

flowchart LR
    A[AppSecret] --> B[MD5加密]
    B --> C[32位小写: md5_secret]
    C --> D[拼接ts: md5_secret + ts]
    D --> E[再次MD5加密]
    E --> F[最终Sign]

核心代码实现

安全要点

  • 两次MD5输出均为32位小写十六进制字符串

  • ts需与服务端时间同步,误差不超过5分钟

3.4 核心命令集

3.4.1 单路控制

3.4.2 批量控制

同时控制多路:

3.4.3 全开/全关

3.4.4 状态查询

3.4.5 延时控制(核心功能)

延时类型命令说明
延时断开{"point1":"30000"}通电30秒后自动断电
延时接通{"reset1":"30000"}断电30秒后自动通电

3.5 完整请求示例

第四章:多语言代码实现

4.1 Python完整实现

4.2 Node.js实现

4.3 Java实现

第五章:出租屋场景化控制集成

5.1 系统集成架构

出租屋照明控制系统可与租赁管理平台深度集成:

graph TB
    subgraph 用户端
        A[租客小程序]
        B[运营管理后台]
    end
    
    subgraph 云端
        C[芯步API网关]
    end
    
    subgraph 硬件层
        D[智能照明控制器8路]
        E[客厅照明]
        F[卧室照明]
        G[卫生间照明]
    end
    
    subgraph 传感器联动
        H[人体传感器]
        I[门磁传感器]
    end
    
    A -->|控制指令| C
    B -->|场景/定时| C
    C -->|MQTT| D
    D --> E
    D --> F
    D --> G
    H -->|状态上报| C
    I -->|状态上报| C
    C -->|联动触发| D

5.2 第一种场景:一键场景切换(核心功能)

业务需求:租客通过手机APP一键切换不同生活场景。

场景名称照明配置适用场景
迎宾模式全亮回家/会客
观影模式主灯关,氛围灯开看电影/休闲
睡眠模式全关入睡
阅读模式床头灯亮睡前阅读
离家模式全关外出/退租
工作模式书桌区域亮办公/学习

实现代码

5.3 第二种场景:人体感应联动(传感联动)

业务需求:卫生间、走廊等区域实现人来灯亮、人走灯灭。

设备配置:需要配合芯步人体存在传感器

实现逻辑

  1. 传感器检测到有人移动

  2. 上报状态至服务器

  3. 服务器下发命令开启对应照明

  4. 人离开后延时关闭

流程图

sequenceDiagram
    participant Sensor as 人体传感器
    participant Server as 管理平台
    participant Light as 照明控制器
    
    Sensor->>Server: 检测到有人
    Server->>Light: 开启照明
    Light->>Light: 照明亮起
    Note over Sensor: 人离开后
    Server->>Light: 延时30秒后关闭

5.4 第三种场景:定时任务自动化

业务需求:根据作息时间自动控制照明,模拟有人在家(防盗)。

实现代码

5.5 场景四:退租自动断电

业务需求:租客退租后,运营方远程一键断电,避免能源浪费。

实现代码

5.6 场景五:能耗统计与分析

业务需求:统计各房间用电量,优化照明策略。

说明:智能照明控制器本身不内置电量计量,计量功能需要配合芯步计量版断路器实现。如需精确统计照明用电量,结合使用带计量功能的断路器

简单时长统计实现

第六章:最佳实践与故障排查

6.1 出租屋部署

部署要点推荐方案说明
设备位置配电箱内靠近电源,便于布线
通道分配1路=1个房间/区域便于独立控制
LED限制每路≤2-3盏LED灯启动电流限制
网络要求WiFi信号强度≥-60dBm确保稳定在线
外置天线推荐外置天线版金属配电箱内信号更稳定

6.2 场景模式优化

根据租客生活习惯,可自定义场景模式:

时段推荐场景照明配置
早晨(6:00-8:00)唤醒模式卧室灯渐亮
白天(8:00-17:00)离家模式全关/节能
傍晚(17:00-19:00)归家模式客厅+玄关亮
晚间(19:00-22:00)休闲模式客厅+餐厅
深夜(22:00-6:00)睡眠模式全关+夜灯

6.3 故障排查指南

现象可能原因解决方案
设备离线1. 电源断开2. WiFi信号弱3. 路由器禁用了MAC1. 检查DC 5V供电2. 检查WiFi信号强度3. 检查路由器白名单
接口返回4031. AppSecret错误2. 签名计算错误3. ts与服务器时间偏差>5分钟1. 核对AppSecret2. 确认MD5为32位小写3. 同步NTP时间
控制成功但灯不亮1. 接线错误2. LED灯功率超限3. 灯本身损坏1. 检查火线连接2. 检查感性负载功率3. 测试灯泡
某路控制无响应通道号超出范围确保通道号在1-8之间

6.4 网络优化

出租屋WiFi环境可能复杂,:

  1. 2.4GHz频段:设备仅支持2.4GHz WiFi

  2. 信号覆盖:确保控制器位置信号强度足够

  3. 静态IP:DHCP分配固定IP,便于管理

  4. 备用方案:关键房间可保留物理开关

6.5 安全注意事项

  • ⚠️ 接线前请一定要断电:确认总闸已断开

  • ⚠️ LED灯功率控制:每路感性负载不超过350W(10A版)

  • ⚠️ 总功率限制:全接通时总负载不超过4400W

  • ⚠️ 专业安装:由持证电工操作

第七章:总结

通过将芯步智能照明控制器接入出租屋管理软件,可以构建“场景化、自动化、远程化”的智能照明系统

核心要点回顾

  1. 硬件选型:智能照明控制器8路为出租屋首选,1路控制1个房间

  2. 场景控制:通过{"power1":"1"}等命令实现场景模式一键切换

  3. 签名算法Sign = md5(md5(AppSecret) + ts),双重安全保障

  4. 定时任务:支持基于Cron的自动化开关,节能增效

  5. 传感器联动:配合人体传感器实现人来灯亮、人走灯灭

对接工作量评估:熟练开发人员可在2小时内完成场景化控制的核心功能对接,包括单路控制、