芯步的开放接口采用标准HTTP协议,无论控制空调开关、温度还是风力,本质上都是一个API请求。以下是基于其红外遥控器、智能插座、包间控制器三套方案的完整实现路径。
一、 背景与选型分析
在线下服务场景(如连锁餐厅、办公室、自习室、酒店客房)中,空调控制面临三个痛点:管理分散(无法统一开关)、人为浪费(无人时未关)、调节滞后(需人工到现场)。
基于芯步生态,通常有三种硬件对接方案,根据场景需求和空调类型选择:
| 方案类型 | 适用场景 | 控制粒度 | 优势 | 对应产品示例 |
|---|---|---|---|---|
| 红外遥控方案 | 壁挂机、柜机(带遥控器) | 全功能:模式、温度、风力 | 不改线路,即贴即用,支持逻辑闭环 | 智能空调遥控器 |
| 通断控制方案 | 大功率空调、2匹左右柜机 | 基础:开关机 | 简单可靠,承载功率大,成本较低 | 智能墙壁插座16A / 智能通断器 |
| 场景集成方案 | 茶室、棋牌室、包间 | 全屋联动 | 高度集成,可同时控制灯光、门锁、空调 | 智能包间控制器 |
推荐首选:为了实现“温度风力调节”,智能空调遥控器是最佳选择。它模拟红外信号,不仅能开关,还能像实体遥控器一样设定到26℃、制冷/制热模式、自动风速。
二、 核心对接原理:API与设备交互
芯步的设备开放接口基于 HTTP/HTTPS 协议,采用 POST 请求方式。这意味着你的线下业务系统(如小程序后台、PC管理软件、自助机终端)可以通过发送JSON数据包直接控制硬件。
1. 对接流程图
sequenceDiagram
participant SaaS as 业务系统/小程序
participant API as 芯步开放API
participant Device as 智能空调遥控器
participant AC as 空调
SaaS->>API: POST /device/control (签名+设备ID+指令)
API-->>SaaS: 返回状态(成功/失败)
API->>Device: 下发指令(红外码库匹配)
Device->>AC: 发射红外信号(温度/风力)
AC-->>Device: 执行结果上报
Device-->>API: 状态回传2. 鉴权与连接所有接口调用都需要携带 AppID、sign(签名)、ts(时间戳)以防止篡改。设备通过WiFi 2.4G联网,支持局域网纯网络环境运行,这意味着即使外网断开,只要局域网通,控制依然有效 。
三、 具体实施步骤:如何实现温度与风力调节
以下以智能空调遥控器为例,详细说明如何实现“降温/升温”和“调大风/调小风”。
第一步:环境准备与设备配网
注册与创建应用:在芯步开发者后台注册账号,获取
AppID和API Key(用于生成签名)。设备上线:将智能空调遥控器接通电源,通过热点配网或扫码配网将其连接到本地WiFi。在后台绑定设备ID(一串数字,如
820720)。码库匹配:在后台配置空调品牌(如格力、美的)。芯步设备内置了市面上主流品牌的红外码库,这一步确保设备发出的信号能被你的空调识别 。
第二步:接口调试与指令下发
要实现控制,你只需要向特定的API地址发送如下结构的HTTP请求。
请求示例(控制温度为24℃,制冷模式,自动风速):
URL:
https://api.thingboot.com/{AppID}/device/control/?sign=xxxx&ts=1712123123Method: POST
Body (JSON):
针对不同场景的指令集构建逻辑:
| 业务场景 | 业务逻辑代码 (伪代码/JSON逻辑) | 对应物理效果 |
|---|---|---|
| 上班/营业前预冷 | order.temp = 26order.windspeed = "high" | 快速降温,在顾客到达前将室温拉低至26℃。 |
| 节能强制约束 | if room.empty: order.power = 0if temp < 18: order.mode = "off" | 人走灯灭同时关空调,或冬季限制最高温。 |
| 顾客精准调节 | user.set(22℃, 中风) -> API.order | 服务员不用跑腿,顾客扫码一键调整头顶空调。 |
第三步:数据上报与闭环控制(高级联动)
单纯的控制是单向的,为了实现恒温或节能,需要结合芯步的传感器。
场景实例:会议室/办公室智能恒温
设备组合:智能空调遥控器 + 智能温湿度传感器。
传感器逻辑:传感器实时采集当前温度(例如检测到25℃)。
服务器逻辑:你的服务器收到传感器上报的25℃数据,假设设定目标是24℃,则自动触发指令:
{"temp":24, "windspeed":"low"}。风力调节:当温度降至24℃时,服务器再次下发指令
{"windspeed":"auto"}或调低风速,避免冷感过强 。
接口响应处理芯步API会在80-120ms内响应。你需要处理返回码:
200: 指令下达成功(设备已收到)。4xx/5xx: 重试或记录日志。设备离线处理:若设备离线,API会返回特定错误码,业务系统需提示“设备不在线” 。
四、 特殊场景:大功率及老旧空调改造
如果你的线下场景使用的是中央空调风盘或功率超过2匹的柜机,红外遥控可能信号不稳或无法覆盖。
此时可以采用智能通断器方案
硬件:芯步智能通断器AC4-20A/30A 。
温度风力调节的实现方式:虽然通断器只控制“火线”通断,但结合上述的温度传感器逻辑,可以实现“恒温”效果。例如:温度高于26℃ -> 闭合继电器(启动空调),此时空调需预设为制冷模式;温度低于24℃ -> 断开继电器(关闭空调)。注:这种方式实现风力调节较难,但可通过控制压缩机的启停来实现温度恒定。
五、 总结
利用芯步开放接口在线下服务场景实现空调控制,核心在于 “一次对接,全场景覆盖”。
能力:利用 智能空调遥控器 的丰富指令集(mode/temp/windspeed)解决风力、模式调节问题。
路径:通过标准的 HTTP API 将线下硬件无缝对接到微信小程序、PC收银系统或IoT中控台。
亮点:结合 传感器数据上报,形成“感知-决策-执行”的AI闭环,实现真正的无人化节能管理。
开发者只需关注业务逻辑(何时开、开多少度),无需关心底层通信细节,所有复杂的透传与重试机制由芯步的开放平台承担。