CATALOG

芯步的3路智能墙壁开关采用标准HTTP接口,签名机制简单清晰,单条命令即可同时控制三条线路。以下方案涵盖设备选型、API对接、三种线路管理模式及实际落地注意事项。

芯步智能硬件解决方案:写字楼办公区三路线路管理

1. 背景与选型

在现代写字楼管理中,精细化能源管理与灵活的空间控制是提升运营效率的关键。芯步的 智能墙壁开关3路 (UNI-KG-3) 是解决该场景的理想选择。

  • 核心优势:该设备支持三路线路独立控制(例如:1路总照明、2路工位插座、3路空调/新风),完美适配办公室常见的多回路控制需求

  • 开放接口:设备提供标准HTTP接口,无论你的后台系统是基于Java、Python、PHP还是Node.js,只需支持HTTP请求即可在10-20分钟内完成对接

2. 解决方案架构

为实现“三路线路管理”,我们设计以下集成架构:

  • 硬件层:芯步3路智能墙壁开关(替换原有86型面板)。

  • 网络层:设备直连写字楼2.4G WiFi,无需额外网关

  • 云平台层:芯步API (https:// 或 企业私有化部署服务器。

  • 应用层:你的OA系统、能源管理SaaS或移动端APP。

3. 对接核心工作:接口集成

要将开关集成到你的项目,核心是调用设备控制接口。芯步采用签名(Sign)机制保证安全。

步骤一:准备参数在芯步控制台获取以下三个关键凭证:

  1. AppId: 你的应用ID。

  2. AppSecret: 你的应用密钥(用于加密)。

  3. Device ID: 现场安装的墙壁开关设备ID(如:820720)。

步骤二:签名生成算法为了防止接口被恶意篡改,每次请求需携带签名。算法规则如下:Sign = md5( md5(AppSecret) + ts )(即:先将AppSecret进行MD5加密,得到字符串A;将字符串A与当前时间戳ts拼接;再将拼接后的字符串进行MD5加密)

步骤三:下发控制命令(核心逻辑)这是对接的重点——如何控制3路中的其中一路请求地址: POST https://api.thingboot.com/{AppId}/device/control/?sign={Sign}&ts={Timestamp}

在请求Body中,通过 order 参数传递不同指令来控制不同线路,这是你项目中需要重点实现的逻辑单元

4. 三路线路管理的具体实现逻辑

针对写字楼办公区的具体场景,你可以在自己的项目中分别实现以下三种管理模式:

模式一:单路独立控制(精细化节能)场景:保洁人员只打扫部分区域,或下班后某员工加班只开头顶灯。

  • 实现方案:在你的管理界面设置三个独立按钮。

    • 只开第一路(照明): {“power1”: 1}

    • 只关第二路(插座): {“power2”: 0}

  • 代码提示:你可以在循环中分别调用接口,或如上述示例在一次请求中同时指定三路状态

模式二:场景联动与定时任务(上班/下班模式)场景:早上10点自动开灯,晚上7点自动断电,无需人工干预。

  • 实现方案:利用你后端系统的定时任务(如Linux Crontab或Spring Task),定时触发接口调用。

  • 你的代码逻辑

    • 上班模式 (09:00): 发送 {“power1”: 1, “power2”: 1, “power3”: 0} (开灯及插座,空调需延时)。

    • 下班模式 (19:00): 发送 {“power1”: 0, “power2”: 0, “power3”: 0} (全关,彻底断电防火)。

    • 午休模式 (12:30): 发送 {“power1”: 0, “power2”: 1, “power3”: 1} (关灯节能,留空调和新风)。

模式三:动态状态保持场景:会议室使用。用户按了物理开关手动开灯,系统10秒后自动复位关闭。

  • 实现方案:利用设备内置的 reset (先断后通) 或 point (先通后断) 以及 keep 保持功能。

  • 你的代码逻辑

    • 如果你希望强制关灯且不让用户通过物理按键随意开启,可使用保持命令

5. 高级部署:局域网与私有化(适用于金融/政企客户)

如果你的写字楼项目对数据安全要求比较高,芯步支持私有化部署

  • 实施方案:你可以将API部署在公司内部服务器,所有控制指令仅在局域网内传输,不经过外网。只需将上述代码中的 api.thingboot.com 替换为你自己的服务器IP即可。

6. 实施

  1. 先模拟后集成:拿到设备后,先用Postman或Curl命令行生成签名测试一下,确认能控制 power1 通断后,再写代码

  2. 负载注意事项:写字楼通常有密集的LED灯带,虽然开关额定是10A,但LED驱动电源启动电流大,每路控制在300W-1200W之间,如果是LED灯不超过300W

  3. 状态同步:利用接口查询设备状态,确保你的软件界面显示的开关状态与现场物理按键状态实时同步,避免出现“显示关,实际开”的体验bug。

总结:通过芯步3路开关的开放接口,你可以在不改造现有强电线路的情况下,仅通过HTTP请求中的 power1power2power3 参数,快速在你的OA或能源系统中构建起对写字楼办公区的精细化线路管理能力。**