CATALOG

芯步的通断器类产品本身就内置了延时控制参数,无需在服务器端维护定时任务队列,一个POST请求即可完成“延时断开”或“延时接通”的设置。以下方案以智能通断器为核心,涵盖硬件选型、接口调用逻辑及三种常见场景的实现方式。

1. 概述

在普通灯具系统中,传统的机械开关往往只能实现即时通断,无法满足延时关灯(如楼道灯、卧室小夜灯)或定时关闭的场景需求。

本方案的目标是利用芯步的智能通断器类产品及其开放API,以一种“低代码”、“高兼容性”的方式,在不改动原有灯具线路核心结构的前提下,通过加装智能硬件并调用HTTP接口,为普通灯具增加延时通断功能。

核心价值在于无需购买昂贵的全套智能家居系统,通过简单的接口对接,即可实现楼道照明延时关断、设备定时断电保护等场景。

2. 硬件选型

针对“普通灯具”的控制,本方案推荐使用芯步旗下的 【智能通断器系列】 产品。

首先,这类设备符合本方案最核心的需求:

  • 内置延时指令:设备硬件及固件原生支持 reset 参数,无需服务器维护复杂的定时队列。

  • 开放接口:支持HTTP API控制,兼容任何编程语言(Python, Node.js, PHP等)或支持HTTP请求的SaaS平台(如小程序、Web应用)。

  • 安装便捷:体积小巧,可置入灯头的接线盒或配电箱内,支持WiFi 2.4G直连,无需额外购买网关

  • 适配高功率:以AC4-20A型号为例,支持4400W额定功率,适配绝大多数家用及商用灯具

注:若需要物理按键联动或采集环境数据(如光照度),可额外配合“智能传感器”或“智能面板”使用

3. 接口对接核心逻辑

芯步的开放接口架构遵循标准的RESTful风格。实现“延时通断”的关键在于请求参数中的 reset(重启/复位计时)power(电源) 配合timer指令。

3.1 接口基础信息

根据官方文档,调用地址结构如下

  • URL: http(s)://api.thingboot.com/{AppId}/device/control/

  • Method: POST

  • Header: Content-Type: application/json

  • 鉴权参数:

    • sign: 动态签名(用于验证权限,由AppSecret计算得出)

    • ts: Unix时间戳(毫秒级,用于防重放攻击)

  • Body 参数:

    • device: 设备ID(如:820720)

    • order: 指令集(JSON对象)

3.2 延时控制实现机制

芯步的硬件逻辑中处理了时间的计算,极大地简化了云端代码。以下是关键指令的对照表

功能描述指令格式 (order 对象)业务逻辑说明
即时开启{"power":1}立即闭合继电器,灯具通电点亮。
即时关闭{"power":0}立即断开继电器,灯具断电熄灭。
延时关闭 (核心){"power":1, "reset": 60000}开启灯具,并在60秒(60000毫秒)后自动关闭。
延时开启{"reset": 300000}在5分钟后自动开启灯具。

技术细节reset 参数代表“重置时间”,单位是毫秒。当设备接收到带有该参数的指令时,会启动内部的倒计时定时器。如果在倒计时结束前收到新的指令(如延长或关闭),倒计时会随之重置或取消。

4. 解决方案实施步骤

4.1 第一阶段:硬件安装与配网

  1. 物理安装:断开总闸电源。将芯步智能通断器串联接入灯具的零火线中。输入端接220V电源,输出端接灯具负载。

  2. 网络配置

    • 下载“芯步”小程序或登录物联网控制台。

    • 开启手机热点或输入现场2.4G WiFi密码进行配网。

    • 确保设备指示灯由闪烁变为常亮/熄灭,表示上线成功

4.2 第二阶段:获取API凭证

  1. 登录芯步开放平台,获取 AppIdAppSecret

  2. 在控制台获取已安装通断器的唯一 device ID

4.3 第三阶段:代码实现(核心方案)

您可以通过任何后端语言发起一个HTTP请求。以下以 Node.jsPython 为例,演示如何实现“开灯后延时自动关闭”。

场景 A:基础延时控制(如:楼道照明)

需求:用户触发开关,灯亮2分钟后自动熄灭。

Python 实现代码示例:

场景 B:多环境智能联动(如:人来灯亮,人走灯灭)

需求:配合人体传感器,检测到人活动时灯亮,人离开1分钟后灯灭。

这种场景下,芯步的传感器(如雷达传感器)会上报数据到您的服务器,服务器根据业务逻辑触发指令

  1. 设备侧:传感器探测到“无人”状态,推送数据到您的服务器。

  2. 服务端逻辑

场景 C:倒计时可中断逻辑

借助 reset 参数的灵活性,可以实现“防误触”或“延时取消”。例如:用户按了关灯,但在5秒内又按了开,只需重新下发 {"power":1} 即可覆盖之前的倒计时任务。

5. 技术优势与特性

  1. 无需消息队列:传统方案中,如果要实现“2分钟后关灯”,开发者需要在服务器维护一个定时任务或消息队列。而芯步的方案将计时逻辑下沉到了 硬件端(Edge Computing) ,即使服务器与设备之间的网络出现瞬时波动,设备内部的计时器依然精准运行,设备断网后仍可执行预设的延时指令(基于设备固件)

  2. 极速响应:从云端下发指令到设备执行的物理延迟约为 80-120ms,保证了用户体验的流畅性

  3. 部署灵活:方案支持 公有云 (通过)和私有化部署。如果您的灯具系统运行在涉密局域网(如工厂车间),可将API接口部署在本服务器,实现纯内网控制

6. 总结

通过在普通灯具前端串联 芯步智能通断器,并利用其开放的HTTP API接口中提供的 reset (延时复位)参数,开发者仅需通过几行简单的代码即可为传统照明系统赋予强大的“延时通断”能力。该方案解决了传统智能控制中过度依赖云端定时的弊端,将逻辑计算分布到设备端,既降低了云服务器的资源消耗,又提高了控制指令执行的可靠性。