芯步的智能红外空调遥控器通过开放HTTP接口，可以实现远程控制、信号转发和场景联动。以下从硬件准备、设备配网、接口调用到信号学习的完整流程，帮助你快速完成接入。

解决方案：基于芯步开放接口接入智能红外空调遥控器实现红外信号转发

1. 背景与概述

在智能家居或办公场景中，传统空调（仅支持红外遥控）无法接入互联网实现远程控制。芯步的 智能红外空调遥控器 通过 WiFi 联网，配合其开放的 HTTP 接口，可以接收云端指令并转发红外信号，从而将传统空调升级为智能设备。本文将详述其接入流程和技术实现。

2. 硬件与前置准备

• 硬件：芯步“智能红外空调遥控器”。

• 环境要求

  • 现场 WiFi（2.4GHz 频段，因红外遥控器仅支持此频段）。

  • 供电电源（通常为 USB 供电）。

  • 待控制的空调（需支持红外遥控，兼容率 >90%）。

• 软件账号

  • 注册 芯步官网 账号。

  • 登录控制台，获取 AppID 和 AppSecret（用于 API 签名）。

3. 设备配网与初始化

在调用 API 之前，需先将设备连入网络。芯步支持小程序配网和控制台配网，以下以常用的小程序方式为例

1. 进入配网模式：通电后，长按设备按键直至指示灯 快闪（表示进入 AP 配网模式/AirKiss 模式）。

2. 小程序操作：微信搜索“芯步小程序”并登录。

3. 登记 WiFi：在小程序中选择你的“工作台” -> “添加网络” -> 输入当前的 2.4G WiFi 名称和密码。

4. 配置设备：点击已添加的网络，选择“为设备配置此网络”。

   • 特殊操作：部分模式下需要手机开启个人热点，热点名称/密码需与上述 WiFi 信息完全一致，设备会通过扫描热点获取凭证。

5. 完成确认：等待指示灯 常亮或慢闪，且在控制台“设备列表”中看到设备状态更新为“在线”，即表示配网成功。

4. 核心 API 接口详解

芯步开放 HTTP 接口，开发者可通过任意编程语言（Python, Java, JavaScript, PHP 等）调用。所有接口均需携带签名（Sign）以验证身份。

基础信息：

• Base URLhttps://api.yoyoiot.com (具体以官方文档为准)

• 认证方式：签名机制（AppID + Timestamp + Sign）

1. 获取设备列表/状态

• 接口GET /device/list

• 作用：查询账户下的设备 ID（deviceId），该 ID 是控制指令的目标。

• 请求参数appId, sign, ts。

2. 发送红外控制指令（核心转发逻辑）此接口用于向空调转发特定的红外码。

• 接口POST /device/ac/control

• 请求示例（JSON）

  { "appId": "YOUR_APP_ID", "deviceId": "设备ID（如 1234567890）", "ts": 1700000000, "sign": "加密签名", "data": { "cmd": "send_ir", // 命令类型:发送红外 "type": "air_conditioner", // 设备类型:空调 "code": "红外码字符串" // 即空调的红外指令码 } }

3. 针对空调的快捷控制芯步针对空调协议进行了深度封装，无需记忆繁琐的红外码，可直接下发结构化指令。

• 接口POST /device/ac/set

• 请求参数（data部分） ：

  { "deviceId": "xxx", "ac": { "power": "on", // on/off "mode": "cool", // cool(制冷), heat(制热), auto(自动), fan(送风) "temp": 24, // 温度范围 16-30℃ "fan_speed": "medium", // low, medium, high, auto "swing": "on" // 扫风开关 } }

5. 实现“红外信号转发”的技术细节

“转发”功能通常用于解决空调码库不全或特殊空调协议的场景。芯步设备支持 “学习模式” ，具体实现流程如下：

步骤 1：开启学习模式调用接口让设备进入“学习”状态，准备接收空调原装遥控器发出的红外信号。

• 指令{"cmd":"enter_learn", "timeout": 60}

• 逻辑：设备指示灯变为常亮（呼吸灯），等待接收红外信号。

步骤 2：捕获原装遥控器信号

• 将原装空调遥控器对准设备，按下需要转发的按键（例如：26℃ 制冷）。

• 设备捕获到红外信号后，会在内部 Flash 中存储该波形，并通过 消息推送 或 事件上报 返回该信号对应的 Code（字符串）。

• 数据获取：开发者需配置 HTTP 回调（Webhook） 或通过 MQTT 订阅主题，接收设备上报的 learn_code 事件。

步骤 3：保存与转发

• 获得到 Code 后（例如 "55AA01FF..."），将其保存在业务数据库中。

• 当用户点击 App 中的“26℃制冷”按钮时，调用第 4 节中的 send_ir 接口，将此 Code 下发。

• 设备执行：芯步设备接收到 HTTP 请求后，通过板载红外二极管发射该 Code，空调接收并执行。

6. 设备状态同步机制

在转发控制后，需要确保系统状态一致。芯步采用 “物模型” 机制。

• 属性上报：设备执行红外码后，实际上无法物理获知“空调是否真的冷了”。但设备支持通过传感器（如内置的温度传感器或人体传感器）联动。

• 事件监听：订阅设备的事件上报（如 boot 事件、infrared_detect 事件），以确定设备本身在线且工作正常。

• 局域网控制（私有化） ：若需低延迟或断网控制，芯步支持私有化部署。此时，接口请求不经过公网云平台，而是直接发送到局域网内的设备 IP，响应速度更快。

7. 常见问题与排障

• 设备离线：检查电源和 WiFi 信号强度。该设备仅支持 2.4G WiFi，不支持 5G 频段。

• 控制不成功

  • 确保设备正对空调且无金属遮挡物，有效距离约 8 米内。

  • 若是“学习”的码不生效，可能是波形捕获畸变，重新学习或降低环境光干扰。

• API 签名错误：严格按照芯步提供的签名算法（通常是 MD5 或 HMAC-SHA256）处理参数，注意参数排序和 ts 时间戳的有效期（通常为 5 分钟）。

8. 总结

通过上述步骤，开发者可以基于芯步的开放接口，在 3 小时内 完成从配网到 API 联调的全过程。其核心优势在于：

1. 免开发固件：无需二次烧录，直接使用 HTTP 标准协议。

2. 灵活性：既支持结构化指令（快捷），也支持原始红外码转发（万能）。

3. 私有化支持：数据可存储在本地服务器，安全可控。