[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 10A | MAX 2200W | MAX 350W | LED灯、节能灯为主 |
| 16A版 | MAX 16A | MAX 3500W | MAX 500W | 含大功率电器 |
选型:出租屋照明以LED灯为主(感性负载),选择10A版即可,每路不超过2-3盏LED灯。
2.3 其他可选型号
根据出租屋规模,还可选择以下型号:
| 产品型号 | 控制路数 | 适用场景 |
|---|---|---|
| 智能照明控制器4路 | 4路 | 单间/小型出租屋 |
| 智能墙壁开关1路 | 1路(86盒安装) | 单灯控制/替换原有开关 |
| 智能包间控制器|Mini | 4路 | 含门禁接口的公寓 |
2.4 负载功率注意事项(重要)
出租屋照明以LED灯为主,属于感性负载,使用时需特别注意:
| 负载类型 | 功率限制 | 说明 |
|---|---|---|
| LED灯/节能灯 | MAX 350W/路(10A版) | 启动电流可达额定5-7倍 |
| 普通白炽灯 | MAX 2200W/路(10A版) | 阻性负载,可满载 |
| 总负载 | MAX 4400W | 8路总功率之和限制 |
⚠️ 重要提示: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 -->|联动触发| D5.2 第一种场景:一键场景切换(核心功能)
业务需求:租客通过手机APP一键切换不同生活场景。
| 场景名称 | 照明配置 | 适用场景 |
|---|---|---|
| 迎宾模式 | 全亮 | 回家/会客 |
| 观影模式 | 主灯关,氛围灯开 | 看电影/休闲 |
| 睡眠模式 | 全关 | 入睡 |
| 阅读模式 | 床头灯亮 | 睡前阅读 |
| 离家模式 | 全关 | 外出/退租 |
| 工作模式 | 书桌区域亮 | 办公/学习 |
实现代码
5.3 第二种场景:人体感应联动(传感联动)
业务需求:卫生间、走廊等区域实现人来灯亮、人走灯灭。
设备配置:需要配合芯步人体存在传感器
实现逻辑
传感器检测到有人移动
上报状态至服务器
服务器下发命令开启对应照明
人离开后延时关闭
流程图
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. 路由器禁用了MAC | 1. 检查DC 5V供电2. 检查WiFi信号强度3. 检查路由器白名单 |
| 接口返回403 | 1. AppSecret错误2. 签名计算错误3. ts与服务器时间偏差>5分钟 | 1. 核对AppSecret2. 确认MD5为32位小写3. 同步NTP时间 |
| 控制成功但灯不亮 | 1. 接线错误2. LED灯功率超限3. 灯本身损坏 | 1. 检查火线连接2. 检查感性负载功率3. 测试灯泡 |
| 某路控制无响应 | 通道号超出范围 | 确保通道号在1-8之间 |
6.4 网络优化
出租屋WiFi环境可能复杂,:
2.4GHz频段:设备仅支持2.4GHz WiFi
信号覆盖:确保控制器位置信号强度足够
静态IP:DHCP分配固定IP,便于管理
备用方案:关键房间可保留物理开关
6.5 安全注意事项
⚠️ 接线前请一定要断电:确认总闸已断开
⚠️ LED灯功率控制:每路感性负载不超过350W(10A版)
⚠️ 总功率限制:全接通时总负载不超过4400W
⚠️ 专业安装:由持证电工操作
第七章:总结
通过将芯步智能照明控制器接入出租屋管理软件,可以构建“场景化、自动化、远程化”的智能照明系统。
核心要点回顾
硬件选型:智能照明控制器8路为出租屋首选,1路控制1个房间
场景控制:通过
{"power1":"1"}等命令实现场景模式一键切换签名算法
Sign = md5(md5(AppSecret) + ts),双重安全保障定时任务:支持基于Cron的自动化开关,节能增效
传感器联动:配合人体传感器实现人来灯亮、人走灯灭
对接工作量评估:熟练开发人员可在2小时内完成场景化控制的核心功能对接,包括单路控制、