一、概述
智能空调红外控制器2是芯步推出的红外遥控设备，支持通过HTTP接口远程控制空调的开关机、模式、温度、风力等参数。本方案的目标是指导开发者如何快速接入该设备，重点实现空调模式调节功能。
适用场景：智能家居系统、楼宇节能管理、远程运维平台、APP/小程序后端等。
技术特点
开放HTTP接口，支持任何编程语言
支持远程控制和局域网控制
兼容市面上90%以上的红外遥控空调
二、准备工作
2.1 账号注册与登录
访问芯步官网（），通过手机号一键注册并登录。登录后进入物联网控制台，这是后续所有操作的管理中枢。
2.2 获取应用凭证
在控制台左侧导航栏点击“开发设置”，完成以下操作：
记录开发者ID（AppID）
设置并记录开发者密码（AppSecret），用于接口签名计算
调试：初次对接时可开启“调试模式”，此时系统不校验签名（sign）和时间戳（ts），方便快速验证接口调用流程。正式上线前关闭调试模式，按生产环境标准接入。
2.3 设备准备
实际设备：为控制器加电并完成配网，配网方式请参照产品手册
若无实体设备：可使用控制台提供的“演示设备”进行模拟对接测试
2.4 查阅产品手册
在控制台的设备详情页找到“产品手册”，其中包含：设备支持的完整命令集（模式、温度、风速等参数的指令格式）、接口请求地址和示例、签名计算方法。
三、接口认证机制
芯步的开放接口采用签名认证机制，每个请求需携带以下参数：
| 参数 | 说明 |
|---|---|
| AppID | 应用ID，控制台获取 |
| sign | 签名值，按规则计算 |
| ts | 时间戳（Unix秒级） |
签名算法
sign = md5(AppID + AppSecret + ts)
即将AppID、AppSecret、ts三个字符串拼接后进行MD5加密。
请求示例（设备ID为123456，命令为切换制冷模式）：
四、核心功能实现：空调模式调节
4.1 支持的空调模式
智能空调遥控器2支持以下模式指令：
| 模式 | 指令值 | 说明 |
|---|---|---|
| 制冷 | cool | 夏季降温 |
| 制热 | heat | 冬季供暖 |
| 送风 | fan | 仅风扇运转 |
| 除湿 | dry | 除湿模式 |
| 自动 | auto | 空调自动调节 |
4.2 接口调用流程
整体流程
计算签名 → 2. 构造请求体 → 3. 发送HTTP请求 → 4. 处理响应结果
调用方式：接口采用HTTP协议，任何支持HTTP请求的编程语言均可调用。封装一个通用函数，将设备ID和命令数组作为参数传入，便于复用。
模式切换示例（以切换为制冷模式为例）：
使用Postman或代码发送如下POST请求：
请求体JSON
4.3 多参数组合控制
更常见的场景是一次性设置多个参数（如模式、温度、风速同时调整）：
4.4 响应处理机制
成功响应时，服务器返回code=0及设备执行结果；失败响应时需根据错误码排查原因，常见错误包括签名错误（sign校验失败）、设备离线（红外控制器网络异常）、命令不支持（该空调型号无此模式）等。
五、完整的函数封装示例（伪代码）
实际开发中可封装如下核心函数：
签名计算函数：接收AppID、AppSecret、时间戳，返回MD5加密字符串。
设备控制函数：接收设备ID、命令字典，内部自动获取当前时间戳、AppSecret，计算签名，构造HTTP POST请求发送，最后解析返回结果并输出执行状态。
调用示例：仅需一行代码即可完成模式切换，如 ControlDevice(123456, {"cmd":"mode", "value":"heat"}) 即可将空调切换为制热模式。
六、注意事项
6.1 设备配网
收到设备后必须先完成配网操作，具体步骤请参照《智能空调遥控器2产品手册》中的引导说明。
6.2 签名验证
调试模式虽然方便，但存在安全风险。正式环境请一定要关闭调试模式，并在服务端实现完整的签名验证机制。
6.3 网络要求
设备需保持稳定的Wi-Fi连接，若需局域网内低延迟控制，可参考产品手册中的局域网API说明。
6.4 空调数据库更新
如遇到空调型号无法控制，请联系芯步技术支持获取固件升级或红外码库更新。
七、总结
通过芯步智能空调红外控制器2的开放HTTP接口，开发者可以在15分钟内完成空调模式调节功能的对接。核心步骤为：注册获取凭证 → 设备配网 → 参考产品手册构造命令 → 封装HTTP请求 → 上线运行。该方案适用于智能家居集成、楼宇节能控制、远程运维等各类场景。
如需对接其他空调品牌或实现定时任务、设备分组等功能，可参考芯步开放平台的其他产品手册和技术文档。芯步提供全程免费技术指导，对接中遇到问题可随时联系技术支持团队。