CATALOG

基于芯步开放平台,实现“2路远程复位开关”联动的核心思路是:利用HTTP接口下发带延时参数的指令,利用消息推送接收传感器状态,由您的业务服务器作为中枢执行联动逻辑。

以下是详细的技术解决方案。

1. 解决方案架构

要实现两路开关的联动(例如:按下开关A的按钮,触发开关B开启5秒后自动关闭,或触发报警器鸣响),不能依赖设备侧的直接通信,而应采用云端/服务器端联动架构:

  1. 触发源:人体传感器、门磁、或第一路物理开关的状态变化。

  2. 数据出口:芯步平台通过消息推送,将上述设备的状态变化实时推送到您的服务器

  3. 逻辑中枢:您的业务服务器接收事件,根据预设规则(如:若传感器A触发,则执行指令X),构造指令。

  4. 执行端:服务器调用芯步的 device/control HTTP接口或MQTT接口,向第二路(或第一路)开关下发带有复位逻辑的指令。

2. 核心接口与“复位”指令实现

芯步的智能开关(2路/3路)及控制器支持丰富的指令集,是实现“远程复位”(即短暂触发后自动复原)的关键

2.1 接口调用方式

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

  • 方法POST

  • 数据格式JSON

2.2 实现“复位”的三种指令模式

根据您的硬件选型(墙壁开关或通断器),针对某一路(如第2路)的复位控制有以下三种实现方式:

指令模式JSON 参数示例行为描述适用场景
点动模式{"point2":"2000"}立即接通第2路,持续2秒后自动断开。控制卷帘门、电机、脉冲式水阀。
自复位模式{"reset2":"3000"}立即断开第2路,等待3秒后自动重新接通。控制设备重启、路由器/主机复位。
状态锁定模式{"power2":{"keep":"1","revert":"5"}}强制开启第2路,即使用户手动关闭,5秒后也会自动重开。强制保持设备开启(如排风扇延时关闭)。

应用示例: 若您需要“触发第2路排风扇开启,运行10秒后自动关闭”,下发的指令应为:

3. 两路联动场景实现详解

第一种场景:第一路开关控制第二路(主从联动)

需求:用户按物理开关的第1路,不仅控制本地灯,还要同步触发第2路的插座通电10秒(如门铃或警示灯)。

实现逻辑

  1. 硬件配置:选用芯步“智能墙壁开关2路”

  2. 数据流

    • 用户按下开关面板。

    • 开关状态变化(power1 变为 1)上报至芯步云端。

    • 云端推送消息到您的服务器(/message/receive)。

    • 您的服务器解析到 device_id 为开关,且 power1=1

    • 服务器调用下发指令接口,目标设备为该开关本身(或另一个独立的通断器),指令为 {"point2": "10000"}

关键代码逻辑(伪代码)

第二种场景:传感器联动双路复位

需求:雷达传感器检测到人离开,关闭第1路照明,同时触发第2路发出“滴”的一声(蜂鸣器响2秒后关)。

实现逻辑

  1. 硬件:智能人体存在传感器 + 智能控制器2路(或自带蜂鸣器的设备)。

  2. 数据流

    • 传感器上报:{"presence": 0} (无人)

    • 服务器下发指令给控制器:

      • 控制第1路:{"power1": 0}

      • 控制第2路(蜂鸣器):{"point2": "2000"} (响2秒即停)

4. 批量控制与稳定性优化

在涉及多设备联动时,芯步接口支持单次请求控制多个设备,这能显著降低网络延迟和服务器压力

批量复位示例假设您需要一键“离开模式”:关闭所有灯(长期断),但启动排气扇(运行5分钟后关)和报警器(响2秒)。

5. 注意事项

  1. 设备型号确认:请确保您的设备支持 pointreset 指令。普通单路开关可能仅支持简单的 power 指令,而多路墙壁开关或智能通断器(AC4-20A)是支持这些高级指令的

  2. 异步处理:接口返回 code 200 仅代表指令到达云端,不代表设备执行成功。若需确保联动可靠,开启“消息推送”,监听设备是否返回了执行成功的回执

  3. 延时精度point 指令的单位是毫秒。例如 "point2":"500" 表示0.5秒。

  4. 网络选择:如果您的服务器和芯步平台均在公网,使用HTTP即可。若追求极低延迟或局域网内控,使用MQTT方式接入(订阅设备状态主题,发布控制主题)

通过上述方案,您可以灵活利用芯步的开放接口,将2路开关改造为具备自动复位能力的智能执行单元,并实现跨设备的复杂逻辑联动。