CATALOG

芯步的硬件接口采用标准HTTP协议,签名机制简单、响应延迟低(80-120ms),非常适合构建自定义联动逻辑。以下方案围绕“传感器触发→规则引擎判断→执行器响应”的闭环展开,核心代码可直接复用。

1. 概述

本方案的目标是通过集成芯步的智能硬件产品(如智能墙壁出门开关、智能人体传感器、智能WiFi控制器等),利用其全开放的HTTP API接口,构建一套自定义的智能家居联动控制系统。

在智能家居场景中,用户不再满足于独立的设备控制,而是希望实现“条件自动触发”。例如:“开门即亮灯”、“深夜感应到人自动开灯但不报警”、“离家一键关闭所有电源”。

核心优势:

  • 全接口开放:所有设备均支持HTTP接口控制,无厂商锁定

  • 超低延迟:指令响应控制在80-120ms,体验无缝

  • 私有化部署:支持局域网直连,数据不上云,保障隐私安全

2. 核心技术架构

本方案采用公有云/私有云 + 本地逻辑引擎的架构,或者基于芯步平台的回调机制。

  • 设备层:包含门禁设备(电子锁、出门开关)、照明设备(墙壁开关、控制器)、传感器(人体红外、门磁)。

  • 传输层:设备直连WiFi 2.4G,通过HTTP/HTTPS协议与服务器交互。

  • 控制层:开发者的业务服务器(或芯步控制台)负责接收设备上报的事件,执行逻辑判断,并下发指令。

  • 接口特征:调用芯步接口非常简单,仅需携带AppId、签名Sign(基于MD5加密)、设备ID及具体的JSON命令

3. 关键硬件选型与接口定义

要实现照明与门禁的联动,以下三类芯步硬件是核心:

3.1 门禁控制类

用于控制锁的通断电,或接入出门按钮。

  • 推荐设备:智能墙壁出门开关、智能WiFi控制器(4路/8路)

  • 核心接口Power(通断控制)、Reset(先断后通,适用于门禁短暂断电开门)。

3.2 照明控制类

用于开关灯、调节亮度或场景切换。

  • 推荐设备:智能墙壁复合开关、智能WiFi墙壁开关

  • 核心接口Power1/Power2(多路控制)。

3.3 传感触发类

用于感知环境与人的状态,作为联动的“眼睛”。

  • 推荐设备:智能WiFi人体感应传感器(雷达版)、门磁传感器

  • 工作机制:传感器通常主动上行数据。当探测到“有人/无人”时,设备会通过HTTP Push将状态推送到开发者指定的服务器URL

4. 自定义联动逻辑实现步骤

要集成这些设备实现自定义逻辑,通常遵循以下四步流程:

4.1 第一步:设备对接与注册

  1. 在芯步物联网控制台获取AppIdAppSecret

  2. 将设备配网连接至WiFi,获取唯一的Device ID(例如:820720)

  3. 配置回调地址:在控制台设置“消息推送URL”,这是实现自定义逻辑的关键。当传感器状态变化或门禁被触发时,芯步平台会立即将事件JSON数据POST到你的后台服务器

4.2 第二步:实现联动逻辑(代码级示例)

假设场景配置:“当人体传感器探测到有人,且时间为18:00-06:00(夜间),自动打开客厅灯,并解除门禁锁定状态(或延时关门)。”

服务器端伪代码实现思路如下:

1. 接收传感数据你的服务器需提供一个API接收芯步推送的传感器数据。

2. 核心逻辑处理你需要编写规则引擎代码来处理接收到的数据:

3. 调用接口下发执行指令基于芯步的签名规则,向物理设备发送命令

  • 场景A:夜间感应开灯

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

    • 请求体

  • 场景B:联动门禁控制

    • 需求:访客按门铃(假如接入I/O模块),自动开灯并开门。

    • 请求体(针对门禁)

    注:reset命令非常适合门禁控制,它解决了“开门后需自动关门上锁”的业务痛点

4.3 第三步:自定义场景配置

为了让非技术人员也能配置逻辑,你开发一个简单的场景配置界面。用户在界面上选择“触发器”和“执行动作”。

场景范例:离家模式

  • 触发条件:用户按下智能墙壁开关的“离家”按钮(或手机App一键执行)。

  • 联动动作

    1. 关闭所有照明(调用{"power":0}给所有灯控设备)。

    2. 关闭所有插座(调用{"power":0}给智能PDU/插座)。

    3. 强制确认门禁上锁(调用门禁设备的状态查询接口或下发锁门指令)。

5. 典型应用场景详解

第一种场景:无障碍门禁照明联动

  • 痛点:夜间回家摸黑找钥匙,或楼道黑暗不安全。

  • 集成方案

    1. 硬件:智能WiFi电子锁 + 智能人体传感器 + 玄关灯控开关。

    2. 逻辑:当门磁/门锁感应器检测到“门锁开启”信号(即开门动作)-> 服务器判断时间 > 18:00 -> 向玄关灯控开关发送{"power":1}指令。

    3. 特色:利用reset命令,可在开门亮灯的同时,解除门禁常闭状态,防止夹伤或提供便捷进出

第二种场景:门禁考勤与工作照明联动

  • 痛点:企业、办公室或健身房,员工打卡后需逐一开灯开设备,耗电且低效。

  • 集成方案

    1. 硬件:智能密码门禁(或刷卡读头) + 智能WiFi控制器(PDU)。

    2. 逻辑

      • 员工输入密码/刷卡 -> 门禁上报{user_id:xxx}到服务器 -> 服务器验证合法 -> 下发开门指令 + 下发该员工工位/区域的照明开关指令。

    3. 进阶:利用人体传感器实现“人来灯亮、人走灯灭”的节能模式。当最后一个员工离开感应区,服务器自动关闭对应区域的电源控制

第三种场景:安防联动

  • 硬件:智能WiFi烟雾传感器 + 智能语音音柱 + 智能门锁。

  • 逻辑:烟雾传感器检测到浓度超标 -> 上报报警信号 -> 服务器触发最高优先级指令:1. 开门(便于逃生或救援);2. 语音播报(调用语音音柱接口播放逃生提示);3. 手机告警

  • 接口支持:芯步的智能语音音柱支持HTTP调用播放特定文本,非常适合这种紧急情况

6. 高级优化

6.1 私有化部署(局域网联动)

对于家庭用户或对延迟极其敏感的场景,可以利用芯步支持的私有化特性。

  • 方案:在内网(如NAS或树莓派)部署一个轻量级的Home Assistant或Node-RED服务。

  • 优势:所有指令通过局域网API直接发送,不需要经过外网服务器,即使宽带断网,照明和门禁联动依然正常进行

6.2 安全机制

  • 签名验证:在接收芯步推送的设备状态时,增加签名验证逻辑,确保请求确为合法设备发出,防止恶意伪造请求开门

  • 临时密码:对于门禁管理,可利用密码门禁的接口动态生成一次性密码,联动照明开启权限,实现“带客看房”等临时场景

7. 总结

通过集成芯步的开放接口,开发者可以轻松剥离复杂的硬件通信细节,专注于顶层业务逻辑。无论是简单的“开门亮灯”,还是复杂的“离家安防布防”,只需聚焦于服务器端的 “事件接收 -> 条件判断(时间/状态/用户) -> API指令下发” 这一闭环流程,即可快速实现稳定可靠的自定义智能家居联动控制。