芯步的开放接口采用标准HTTP协议，可以快速将智能控制器、传感器与现有办公系统对接。以下方案围绕“设备选型—接口集成—场景”三条主线展开，涵盖远程单控、批量调控、传感器联动和故障预警等核心功能。

1 背景与概述

在现代办公环境中，照明系统的智能化管理已成为提升能源效率、优化员工体验的关键环节。传统办公照明往往存在长明灯、控制不便、无法精细化管理等问题，导致电力浪费严重。本方案基于芯步（ThingBoot）智能硬件产品及其开放HTTP接口，构建一套完整的办公照明远程控制系统。通过集成智能控制器、人体传感器等设备，实现对办公区域照明的远程开关、定时策略、自动联动及场景化控制。

芯步平台的核心优势在于其接口的普适性与简易性。设备开放标准的HTTP API，支持任何能发起HTTP请求的编程语言（如Python、Java、Go）或平台（Web、小程序、APP）进行集成。同时，方案支持私有化部署，可运行于纯局域网环境，满足企业对数据安全与响应速度的高要求。

本方案主要面向企业行政管理人员、系统集成商及后勤部门，目标是实现照明设备的“可视、可管、可控”，预计可实现办公照明节能20%-30%，并极大提升管理便捷性。

2 系统架构

本方案采用端-云-应用三层架构。前端由芯步的硬件设备构成，包括执行层（智能墙壁开关/控制器）与感知层（人体存在传感器）；云端负责设备管理、数据转发与逻辑处理；应用层则面向管理员与普通员工，提供多端控制入口。

核心架构图

（本处为文字描述：应用层包括PC Web端后台与移动端微信小程序；网络层采用HTTPS协议与MQTT推送；感知层包含人体传感器，执行层包含智能开关和多路控制器）

架构说明

• 感知/执行层：部署WiFi智能墙壁开关（1-3路）或智能控制器（4/8路）直接控制灯具；部署人体存在雷达传感器采集 occupancy 状态。

• 网络传输层：所有设备通过WiFi 2.4G直连路由器，无需额外网关。设备状态变更通过HTTP/HTTPS协议上报至指定服务器，控制指令下行同样通过HTTP请求实现。

• 平台层（私有云/内网）：用户自建服务器接收设备上报数据，并调用芯步开放API下发指令。平台层可集成定时任务引擎与规则引擎。

• 应用层：管理员可通过PC端管理后台进行批量操控与策略配置；员工通过微信小程序完成特定区域（如工位、会议室）的照明控制。

3 硬件选型

本方案根据不同办公场景的负载及控制需求，推荐选型以下芯步硬件设备，涵盖照明开关回路控制与环境感知两大维度。

4 开放接口集成与API调用详解

实现远程控制的核心环节是调用芯步的开放接口对设备进行指令下发及状态接收。设备支持主动上报状态变更（如灯被本地手动关闭），也支持被动接收远程指令。

4.1 接口基础信息

所有设备控制命令均通过HTTP POST请求发送。请求地址格式为固定的动态路由模式，并在URL中携带身份验证签名（Signature）与时间戳（Timestamp），以此确保接口调用的合法性与请求时效性。

请求地址http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

4.2 控制指令下发示例（以Python/Postman为例）

以下演示如何通过HTTP请求控制智能控制器第1路照明的开启与关闭。数据格式为JSON，核心参数包含设备ID（device）与具体指令（order）。

请求体构造：以ID为820720的设备为例，控制其第一路继电器吸合（开灯）。若需关闭，将power值修改为0即可。

多路控制：若需同时控制第1路开、第2路关，order字段可传入 {"power1": 1, "power2": 0}。

实现逻辑：用户后台服务器（或小程序前端）构造请求，计算签名，发起POST请求。芯步平台验证通过后，将指令推送到设备，设备在100ms左右响应执行。

4.3 设备状态获取机制

平台采用了主动上报机制，以保证设备状态的实时同步与准确性。当照明设备被物理按键操作或定时任务触发时，设备会主动将最新状态推送到用户指定的服务器地址，避免了轮询接口造成的网络开销。

• 消息推送配置：用户需在芯步控制台中设置Callback URL。当设备状态变更（如开关由关变开）或传感器触发（有人移动）时，平台会向该URL发送JSON格式的POST数据。

• 数据解析：服务器接收数据包，解析设备ID、当前功率、开关状态（power字段）、传感器信号等字段，并存入业务数据库。

5 关键业务场景与实现逻辑

本方案通过集成传感器数据与规则引擎，将简单的远程开关升级为自动化、场景化的智能照明系统。

5.1 第一种场景：基于人体感应的“人来灯亮/人走灯灭”

此方案针对办公楼的走廊、茶水间、独立工位等区域设计，可有效杜绝“长明灯”造成的能源浪费。

硬件配置：每个独立区域部署1个智能人体存在传感器，照明回路接至智能墙壁开关/控制器。

联动逻辑：当传感器探测到“有人”时，通过HTTP接口向照明设备下发“开启”指令；当持续“无人”时间超过设定阈值（如2分钟）或未检测到微动时，下发“关闭”指令。以服务端规则引擎为例的处理流程如下：

1. 数据上报：传感器检测到状态变化 {"device":"sensor_01","status":"occupied"} -> 回调用户服务器。

2. 规则触发：服务器解析到“occupied”，查询关联设备ID light_01。

3. 指令下发：服务器调用控制接口 POST /device/control/，携带 {"device":"light_01", "order":{"power":1}}。

5.2 第二种场景：午休/会议模式场景化控制

针对会议效率提升，使用微信小程序或PC后台实现全会议室灯光的一键批量切换。管理员通过后台设定“投影模式”、“洽淡模式”或“全亮模式”，将不同灯具的亮灭组合保存为独立场景。

应用示例：午休时间（12:00-13:00），定时任务触发，关闭办公区大面积照明，仅保留走廊应急照明与部分背景灯带，营造休息氛围。该系统也支持集成窗帘电机与空调，实现一键场景联动。

5.3 第三种场景：能耗监测与故障预警

依托部分智能控制器（如4路/8路控制器）的电量统计能力，系统可实时采集电流、电压与功率数据。当检测到某回路电流异常升高（如灯具短路征兆）或功率长期归零（灯具损坏）时，管理后台自动通过Webhook或钉钉推送设备故障预警，提示后勤人员精准维修。

6 方案实施要点

在实施过程中，需重点考量设备的网络覆盖、私有化部署架构及现有开关线路的适配性，以确保系统的稳定落地。

1. 网络规划：芯步设备仅支持2.4G WiFi，部署前需要对办公区域进行WiFi信号勘测，确保信号强度满足要求。对于大规模部署（>50台），采用独立SSID的IoT专用网络，以减少广播域冲突。

2. 私有化部署配置

   • 自建消息服务器：用户需准备一台公网/内网服务器，设备通过配置MQTT Broker地址或HTTP上报URL指向该服务器。

   • 内网穿透：若仅需内网控制且无公网IP，所有设备与手机在同一局域网下也可正常工作。

3. 施工接线：智能墙壁开关需区分零火线版本（底盒必须有零线）。对于老旧办公楼，若只有火线无法更换线路，需选用单火版开关；若负载较大，推荐在强电箱内加装智能控制器。

4. 接口鉴权安全：正式上线前，请一定要在服务端隐藏AppId和Token。签名算法应置于后端执行，前端仅调用后端接口，避免凭证泄露导致设备被恶意控制。

7 总结

通过集成芯步的开放接口与智能硬件，企业能够以较低的成本和开发门槛，实现办公照明从“人工管控”到“自动化与智能化”的升级。本方案利用HTTP API的通用性，将照明系统无缝融入企业现有的OA或小程序体系中，通过人体感应节能、场景化提升体验、数据化辅助运维，最终构建一个绿色、高效、舒适的智慧办公光环境。