CATALOG

芯步的智能空调遥控器通过标准HTTP接口开放控制能力,可快速集成到现有办公系统中。以下方案涵盖设备选型、接口对接、代码实现及智能策略配置。

解决方案:智能办公空调控制——远程空调控制模块项目对接指南

1. 项目概述与选型

在智能办公场景中,实现空调的远程控制和集中管理是节能的关键。芯步提供的智能空调遥控器(红外版)是针对办公场景(特别是已有老旧空调或分体式空调)的最优解。

  • 核心优势:无需更换现有空调,即插即用,支持市面上90%以上的红外空调品牌

  • 控制能力:支持远程开关机、模式切换(制冷/制热/送风)、温度调节、风速及风向控制

  • 对接基础:设备采用Wi-Fi通信,开放全功能的HTTP API接口,支持任何编程语言接入,能够无缝集成到你现有的OA系统、钉钉/企业微信小程序或自研的能源管理平台中

2. 整体设计

采用标准的“端-云-应用”三层架构,确保指令的实时性与数据的安全性。

  • 端(设备层):智能空调遥控器。部署在办公室内,通过2.4G Wi-Fi连接网络,通过红外信号一对一控制空调。

  • 云(平台层):芯步开放平台。负责设备连接、指令转发、状态上报,并提供统一的HTTP接口。

  • 应用层(你的项目):你的业务服务器(或SaaS系统)。通过调用芯步的接口,实现前端(App/Web)与后端设备的指令交互。

3. 详细对接步骤与开发指南

3.1 前期准备:注册与设备配网
  1. 注册与创建:在芯步官网注册开发者账号,并创建一个“工作台”(即项目空间)

  2. 获取密钥:在控制台的“开发设置”中获取你的 AppID(应用ID)和 AppSecret(应用密钥),这将在接口鉴权中使用。

  3. 设备配网

    • 使用“芯步小程序”或PC控制台,添加现场2.4G Wi-Fi的账号密码。

    • 给智能空调遥控器通电,长按配网键,等待设备指示灯变为常亮(或根据手册指示),此时设备状态变为“在线”

    • 关键步骤:在控制台将设备与空调进行红外码库匹配,确保“开关”、“调温”等指令能正确控制物理空调(通常平台内置码库,选择空调品牌型号即可)。

3.2 核心开发:HTTP接口对接

芯步的接口设计遵循RESTful风格,签名机制保证了调用的安全性。

1. 接口地址POST https://api.thingboot.com/{AppId}/device/control/

2. 鉴权机制(签名计算)为了防止接口被篡改,每次请求需携带动态签名 sign 和时间戳 ts签名算法逻辑如下

sign = MD5( MD5(AppSecret) + ts )

  • 步骤拆解

    1. 将你的 AppSecret 进行MD5加密,得到字符串 S1

    2. S1 与当前请求的时间戳(秒级,即Unix timestamp)ts 进行拼接,得到字符串 S2

    3. S2 再次进行MD5加密,得到最终的 sign

3. 下发控制指令(代码示例)以下是一段标准的业务服务器下发指令给ID为 820720 的空调遥控器的示例。假设我们需要:开启空调,设置为制冷、24度、自动风速

注:具体的 modespeed 数值含义请参考对应型号的《产品手册》,不同版本可能略有差异

4. 状态同步(消息推送)为了保持项目中空调状态的实时性(例如是否被人用遥控器手动关了),你需要配置消息推送

  • 机制:在芯步控制台设置你的服务器回调URL(Webhook)。

  • 流程:当空调状态发生变化(通过遥控器或设备自测),平台会主动向你的服务器推送设备当前状态。

  • :在你的后端维护一个设备状态缓存(Redis),避免前端频繁轮询。

4. 办公场景下的智能策略集成

为了提升方案价值,在项目中结合芯步的其他传感器产品,通过服务器逻辑实现以下自动化规则

  • 上班预备模式:每天早上8:55,定时任务自动开启老板办公室/会议室的空调。

  • 恒温/节能模式

    • 服务器接收到“智能温湿度传感器”上报的数据。

    • 逻辑判断:如果温度 < 24°C 且 空调模式为“制冷”,则服务器自动调用接口发送关机指令,避免过度制冷浪费电。

  • 无人在线自动关

    • 配合“人体存在传感器”。

    • 逻辑判断:如果连续30分钟检测到“无人”状态,服务器自动下发 {"power":0} 关闭该区域空调

  • 下班统控:管理员在管理后台点击“一键下班”,服务器遍历所有设备ID,批量发送关机指令(注:批量指令可通过循环调用接口或在 device 参数中传入多个ID用逗号隔开实现)。

5. 本地局域网控制(可选)

如果你的安全策略要求空调控制指令不能经过公网,芯步的设备也支持局域网控制功能

  • 实施方法:将你的业务服务器与空调遥控器置于同一局域网段。服务器可以直接调用设备在本地的IP地址接口进行控制,无需经过芯步的广域网云平台,从而保证网络断开时的稳定性。

6. 常见问题与

  1. 网络要求:现场Wi-Fi必须是2.4G频段(不支持5G WiFi),且信号强度覆盖空调所在位置

  2. 红外遮挡:确保空调遥控器与空调挂机之间有直线距离,中间不要被金属或柜子完全遮挡,最大距离不超过8米。

  3. 状态反馈延迟:红外控制是单向的“盲发”(发出指令不管是否执行成功)。若需严格的状态反馈,开启“功率计量”或通过传感器辅助判断空调是否真的启动了

通过以上步骤,你可以快速将芯步的硬件能力集成到你的办公管理项目中,实现从“人工巡检”到“自动感知、远程一键控制”的智能化升级。