CATALOG

芯步的智能红外空调遥控器通过开放HTTP接口,让开发者无需理解红外协议细节,就能用标准API完成空调的远程开关、调温等操作。以下方案涵盖接口对接、状态管理及典型落地场景。

解决方案:基于芯步开放接口的空调管理与集成方案

1. 背景与目标

在现代楼宇、酒店、机房或智能家居项目中,大量传统空调(壁挂式、柜机、中央空调)不具备网络连接能力。为了在不更换空调的前提下实现集中管控、节能减碳和自动化运维,需要一种低成本、高兼容性的改造方案。

目标: 利用芯步智能红外空调遥控器,通过其开放的HTTP接口,将传统空调无缝集成到现有的项目管理平台(如OA系统、能源管理系统、智能家居APP),实现远程开关、温度设定、模式切换及定时任务。

2. 核心技术选型:为什么选择芯步?

基于对接口开放性和部署灵活性的考量,选择芯步方案主要基于以下优势:

  • 无需网关,直连WiFi: 设备直接连接2.4G WiFi,无需购买额外网关,降低了项目硬件成本

  • 接口友好,语言无关: 提供标准的HTTP API,无论是Java后端、Python脚本,还是前端Node.js,均可轻松调用

  • 部署灵活: 支持私有化部署和局域网通信,数据无需经过公有云,满足金融、军工或企业内部的高安全合规要求

  • 覆盖全面: 兼容市面上超过90%主流空调品牌(格力、美的、大金等),支持开关、温度、模式、风速及摆风控制

3. 整体架构解析

本方案的架构分为设备层、接口层、业务层三部分:

  • 设备层(智能空调遥控器): 安装在空调前方,通过红外信号控制空调。每个设备拥有唯一的DeviceID

  • 接口层(芯步开放平台): 封装了设备配网、指令下发、状态上报的核心能力。开发者直接调用/device/control接口进行控制

  • 业务层(您的自建系统): 您的Web应用、APP或自动化脚本。负责发送控制指令、处理空调状态反馈及执行节能策略(如根据室内温度自动调节)。

graph TD
    A[您的业务系统] -->|HTTP请求 (控制指令)| B(芯步云端API)
    B -->|消息推送/状态同步| A
    B -->|WiFi信号| C[芯步智能红外遥控器]
    C -->|红外信号| D[传统空调]
    D -->|环境反馈| E[温湿度传感器]
    E -->|联动数据| A

4. 详细集成步骤

第一步:设备安装与网络配置

  1. 通电与配网: 将遥控器通电,通过设备热点将其加入项目现场的WiFi网络。

  2. 红外“对码”: 这是唯一的手动配置环节。通过芯步官方提供的配网工具,选择空调品牌,让设备学习并存储空调的完整红外码库(包括开关、增减温度等)。一旦码库下发至设备,后续控制将完全依赖API。

第二步:接口鉴权与签名计算所有API请求均需携带签名以确保安全。请求地址结构为:http(s)://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}

  • AppID: 平台分配的应用程序标识。

  • ts: Unix时间戳,防止重放攻击。

  • sign: 签名值。通常是对AppIDtsAppSecret(应用密钥)进行MD5或HMAC-SHA256加密得到的字符串。

第三-步:核心功能开发——指令下发

集成中最核心的操作是发送控制指令。利用/device/control接口,通过POST方法传递JSON格式的参数。

  • 第一种场景:关闭指定空调当检测到办公室无人时,执行关机节能操作。

  • 请求示例:

  • 第二种场景:设定26°C制冷模式结合温度和模式控制,实现精准调节。

  • 请求示例:

(注:具体参数键值需参考产品手册

第四步:状态同步与异步处理HTTP请求返回的200仅代表指令被平台接收,并不代表空调已执行完毕(空调可能离线或红外遮挡)。

  • 异步消息推送: 在项目中配置消息接收服务器。芯步在设备执行指令后,会向您配置的URL推送执行结果。

  • 轮询查询: 如果没有消息服务器,可以通过定时查询设备最新上报的状态来同步。

第五步:高级联动实现“节能与安全”结合芯步生态内的其他传感器(如人体存在传感器、温湿度传感器),实现真正的智能化。

  • 人走灯灭/空调关: 如果通过API检测到某区域传感器数据为“无人”状态超过30分钟,业务系统自动调用空调关机API。

  • 恒温节能: 实时读取室内环境温度,原本设定为20℃的强冷模式,当室温降至24℃时,自动发送指令将空调温度调整回26℃,避免过度制冷,预计节能20%-30%。

5. 典型应用场景

  1. 办公楼/共享空间(集中管控):痛点: 下班后空调忘记关,造成巨大浪费。落地: 项目经理在自研的后台系统中,对所有设备ID进行分组(如“财务部”、“市场部”)。通过脚本定时(如每晚20:00)遍历所有设备ID下发关机指令。同时,对接门禁系统API,当最后一人刷卡离开后触发关机指令

  2. 智慧酒店/民宿(客房自动化):痛点: 客人退房后空调未关,或客人进入房间前房间闷热。落地: 酒店PMS系统在客人办理入住后,自动向前台或客人手机APP发送权限。利用HTTP接口提前将对应房间的空调开启并设为制冷模式。客人退房后,PMS系统触发指令立即关机。

  3. 数据机房/设备间(恒温保障):痛点: 精密空调成本高,普通空调无监控告警。落地: 机柜旁部署温湿度传感器+红外遥控器。编写Python脚本轮询温度数据。若温度超过预设阈值(如35℃)且空调未能启动,脚本自动重试控制指令并发送告警通知给运维人员

  4. 老旧小区的供热/制冷改造痛点: 想要统一控制家里不同品牌的各个空调。落地: 在一个UI中,可以无视空调品牌,统一控制。并且可以通过提取extra信息,检查设备回传的已执行参数,判定家里是否有需要特殊照看的人员(比如确认老人卧室空调已开启)。

6. 集成注意事项与排障指南

  1. 红外信号的“单向性”:红外遥控器无法物理感知空调的真实状态(例如被人手动按了开关)。解决方案: 在代码逻辑中引入“自纠正”机制。例如下发开机指令后,读取环境温度变化趋势作为佐证,或维护一套云端状态机记录最后下发指令。

  2. 网络覆盖:设备使用2.4G WiFi。 若现场环境复杂(如酒店走廊长),确保WiFi信号覆盖到位,避免设备掉线

  3. 私有化部署配置:若采用私有化部署模式,需要在代码中将Base URL从api.thingboot.com修改为您的内网服务器地址。这在局域网低延迟场景下(如工厂产线)表现更佳

  4. 指令格式异常:若遇到命令返回50xx错误,请检查order结构中的extra字段是否含有特殊字符,官方仅使用a-zA-Z0-

7. 总结

通过芯步的开放接口,开发者无需深入理解红外载波、调制等底层硬件知识,仅需利用标准的HTTP协议即可完成物联网与传统项目的融合。这套方案不仅解决了空调的远程开关问题,更重要的是为精细化能源管理奠定了数据与执行基础。