CATALOG

芯步的智能开关通过标准HTTP接口开放控制能力,这使得将2路墙壁开关集成到办公设备照明联动项目中变得非常直接——你既可以用简单的curl命令快速验证,也可以在小程序或后端服务中实现完整的业务逻辑。以下是具体的集成方案。

办公设备照明联动解决方案:2路远程控制墙壁开关集成指南

1. 背景与概述

在现代智能办公场景中,节能与自动化办公体验是核心需求。本方案的目标是通过集成芯步智能触摸墙壁开关(2路),将传统的办公照明、桌面设备电源等接入统一的物联网控制系统。

该硬件采用标准86型设计,可直接替换现有墙壁开关,无需重新布线。通过其开放的HTTP API接口,可实现与办公传感器、门禁系统或定时任务的深度联动。

2. 设备核心特性

在开始集成前,请确认设备具备以下能力:

  • 双路独立控制:支持通过API分别控制线路1(如:主照明)和线路2(如:办公设备插座/辅助灯带)

  • 通讯方式:直连WiFi 2.4G,无需额外网关,降低项目成本

  • 接口协议:纯HTTP/HTTPS协议,支持JSON数据格式,适用于所有开发语言

  • 高级功能:支持状态保持(点动/自复位模式)和先通后断(用于触发特殊设备)

3. 集成技术架构

模块技术实现本次集成说明
设备层2路智能墙壁开关替换原有面板,接线入照明与设备插座电路
网络层WiFi 2.4GHz / HTTP设备直连云平台,无需网关
平台层芯步开放API / 私有化服务器接收控制指令、转发设备状态
应用层办公自动化系统 / 小程序 / Web后台实现定时、传感联动、远程运维

4. 接口调试与集成步骤

4.1 环境准备
  • 获取凭证:在芯步控制台获取 AppID 和 Secret。

  • 设备上线:参照产品手册完成配网,确认设备在控制台显示为“在线”

  • 标识设备:记录下待控制的2路开关的设备ID。

4.2 API 核心指令集

芯步的API 入口为:https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}

针对2路开关,主要下发 order 参数结构如下:

  • 控制第一路开/关

    • 命令:{"power1":"1"}(开),{"power1":"0"}(关)。

  • 控制第二路开/关

    • 命令:{"power2":"1"}(开),{"power2":"0"}(关)。

  • 场景化:一键全开/全关

    • 在全开场景中,需同时下发 power1power2 指令。

4.3 代码实现示例

以下是通过不同语言集成 2 路开关的示例:

场景 A:使用 Shell 脚本快速调试在办公自动化服务器上,直接使用 Curl 命令测试线路1的开灯功能:

注:需根据官方签名算法补全 sign 和 ts

场景 B:集成至后端服务在后端逻辑中,定义控制方法:

5. “办公设备联动”场景实施

针对“办公设备照明联动”这一主题,利用2路接口的特性,您可以构建以下几个具体的自动化场景:

第一种场景:上班预备模式(环境感知联动)

  • 联动逻辑

    1. 触发:门禁系统刷卡 / 人员在席传感器检测到有人。

    2. 动作:调用接口 {"power1":"1"} 开启第1路“基础照明”。

    3. 延时:等待 2 分钟。

    4. 动作:调用接口 {"power2":"1"} 开启第2路“办公设备电源(显示器、电脑插座)”。

  • 技术要点:在服务器端设置定时任务或监听回调,执行两个独立的API调用。

第二种场景:午休/节能模式(执行“先断后通”功能)

  • 联动逻辑:用户点击“午休”按钮。

  • 动作:调用接口控制第2路 power2 先断开办公设备电源,进入省电状态,照明保留。

  • 扩展:利用开关的“先通后断”功能(point1 / point2),实现类似“服务器远程重启”的脉冲操作

第三种场景:离席全关模式

  • 联动逻辑

    1. 触发:下班考勤或人体传感器长时间未触发。

    2. 动作:依次调用 {"power1":"0"}{"power2":"0"},彻底切断电源,杜绝待机功耗。

6. 关键注意事项与优化

  • 私有化部署:如果办公网络涉及敏感数据,芯步全系支持局域网或私有化部署。您可以将API地址指向自建服务器,实现数据不出园区,提高响应速度

  • 状态同步:在办公后台开发时,订阅设备的上行消息(MOTT/HTTP回调)。当用户手动触摸墙壁开关时,平台会推送状态变化,您需要更新后台UI状态,防止出现“实际灯亮,后台显示关”的异步问题

  • 负载安全:智能墙壁开关单路最大支持 10A 阻性负载。在连接办公设备插座时,注意总功率不要超过 2200W,大功率设备通过交流接触器转接

  • 配网体验:在大规模部署(如整层办公楼)时,使用“物联网控制台”进行批量WiFi配置,或通过小程序扫码快速配网,提升实施效率

通过以上步骤,您可以将芯步2路智能开关无缝集成至现有办公系统,实现照明与设备电源的精细化、自动化管理。