芯步的智能照明控制器通过标准HTTP接口开放控制能力，可在10分钟内完成设备对接。以下方案以写字楼办公区为场景，说明如何将LED智能控制器集成到现有项目中，实现定时、感应、情景等多种灯光控制模式。

1 背景与需求分析

在现代写字楼办公环境中，照明系统不仅影响企业运营成本，更直接关系到员工的工作效率和视觉舒适度。传统办公区灯光管理多依赖人工开关，常出现上班高峰期灯光未及时开启、午休时段光线刺眼、下班后无人关灯等痛点，导致能源浪费与体验不佳的双重困境。相关统计显示，照明能耗占写字楼总能耗的20%-30%，通过智能化改造可实现30%以上的节能空间。

本项目旨在将芯步的LED智能控制器（型号：UNI-KZQ-ZM-4）对接至楼宇管理系统或企业办公SaaS平台，实现办公区灯光的远程控制、场景联动与自动化调度。核心需求包括：

• 远程集中控制：管理员可通过Web端或移动端APP批量控制各分区灯光。

• 情景模式自定义：预设“上班模式”“午休模式”“会议模式”“下班模式”等，一键切换。

• 传感器联动：结合人体存在传感器，实现“人来灯亮、人走灯灭”。

• 定时任务：根据工作日历自动执行灯光策略。

2 芯步开放接口技术特性

芯步智能硬件产品的核心竞争力在于其全开放、标准化的HTTP接口体系。该体系具备以下技术特征：

• 接口通用性：支持任何能发起HTTP请求的编程语言或平台（Java、Python、Node.js、PHP以及各类低代码平台），真正消除了技术栈壁垒。

• 低延迟响应：从命令下发到设备执行的端到端时延控制在80-120毫秒内，满足办公场景对即时反馈的体验要求。

• 双网络架构：设备同时支持公网与局域网（纯局域网）两种模式，并可实现私有化部署，满足金融、研发等对数据安全有苛刻要求的企业需求。

• 极简对接流程：无需复杂的SDK嵌入，仅需通过签名鉴权+设备ID+JSON指令三个要素即可完成设备控制，官方宣称“十分钟完成对接”。

3 对接方案架构

本方案采用云-端-场三层架构，实现控制指令的闭环流转。

数据流说明

1. 用户在业务端点击“关闭第3区灯光”。

2. SaaS平台依据芯步签名规则（MD5嵌套）生成sign，向api.thingboot.com发起POST请求。

3. 芯步平台校验权限后，将指令下发给指定的UNI-KZQ-ZM-4控制器。

4. 控制器执行power3:0指令，断开第三路继电器，灯光熄灭。

5. 控制器返回执行结果，经云平台推送至SaaS端，更新前端UI状态。

4 详细对接实施步骤

4.1 设备初始化与开发准备

• 硬件上电配网：将UNI-KZQ-ZM-4控制器接入AC 100-250V电路，通过设备AP模式或SmartConfig方式配置WiFi（仅支持2.4GHz频段）。控制器支持设置5组备用WiFi，当主信号中断时可自动切换至最强信号，保障办公网络稳定性。

• 获取凭证：登录芯步物联网控制台，创建应用获取唯一的AppId和开发密码。此处的AppId将用于拼接请求URL，开发密码用于生成签名。

4.2 核心接口鉴权

芯步的鉴权设计兼顾了简便性与安全性。开发者无需引入复杂的OAuth流程，只需在URL参数中携带sign和ts。

• 签名算法sign = md5(md5(开发者密码) + “.” + 时间戳)。

• 请求地址示例http://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

4.3 控制指令下发实操

以控制办公区东侧4路灯光为例，假设设备ID为820720，需开启第1、3路，关闭第2、4路。请求体如下：

此JSON结构清晰，order内的键值对直接对应控制器的物理继电器触点。这种设计使得开发者无需维护复杂的设备状态表，通过简单的位操作即可实现精细化管理。

4.4 上行数据接收与联动

为了构建“人来灯亮”的智慧场景，需引入芯步生态中的智能人体存在雷达传感器。

• 消息推送机制：当传感器检测到人员移动时，芯步平台会主动向开发者预设的Callback URL推送设备状态数据。

• 联动逻辑实现

  1. 服务器接收传感器上报的{“radar_enable”：1}（有人）数据。

  2. 触发业务层逻辑，调用智能照明控制器的开灯接口。

  3. 实现从“感知”到“控制”的全自动化闭环。

5 关键场景配置与代码映射

在实际办公环境中，通过后端定时任务或前端手动触发，封装以下标准场景：

6 方案亮点与效益分析

1. 显著缩短开发周期得益于HTTP接口的极简设计与设备端内置的WiFi模块（无需额外网关），开发人员在前端交互完成后，平均半天内即可完成全功能对接。相较于传统Modbus或KNX总线协议，减少了约80%的代码量。

2. 精细化能源管理通过集成定时器与人体传感器逻辑，系统能有效杜绝“长明灯”现象。结合芯步开放的API，企业能耗管理系统可每日自动拉取设备开关记录，生成能耗审计报告，辅助制定节能策略。

3. 高度灵活的系统集成该方案不仅适用于单一写字楼项目，还具备良好的横向扩展性。由于所有控制基于HTTP，开发者可轻松将其集成进现有的楼宇自控系统（BAS）、企业微信或钉钉工作流中，实现行政管理的数字化。

4. 兼容多业态场景以“智能照明控制器4路”为执行终端，方案还可快速复制至办公走廊、会议室、展厅、地下停车场等附属区域，通过统一平台实现全域设备集中管理。

7 总结

通过对接芯步UNI-KZQ-ZM-4智能照明控制器，写字楼办公区的灯光系统不再是被动的电力线路，而是进化为主动感知、随需而变的智慧空间神经网络。该方案凭借其开放的技术架构、低廉的开发成本和立竿见影的节能效果，为现代楼宇的数字化转型提供了极具落地价值的参考路径。