CATALOG

芯步的开放接口设计得很直接,核心就是调用设备控制接口,向空调红外控制器下发红外指令。下面这套方案涵盖了从设备准备、接口调用到代码实现的完整流程。

解决方案:通过芯步开放平台对接通用空调红外控制器

一、 准备工作:硬件上云与获取“身份证”

在写代码之前,得先把硬件准备好。你可以按下面这几步来:

  1. 硬件上电与配网把芯步的通用空调红外控制器买回来插上电。根据官方文档,通常是用“芯步”小程序给它配网,输一下你家的Wi-Fi密码就行。注意要连2.4G频段的Wi-Fi。

  2. 获取设备ID(Device ID)配网成功后,去芯步的“物联网控制台”后台,在设备列表里找到这个控制器,你会看到一串数字,比如 123456789

  3. 获取密钥(AppID & AppSecret)在控制台的“开发设置”页面,找到你的应用ID(AppID)和开发者密码(AppSecret)。这两个是你的“账号密码”,后面发起HTTP请求签名要用。

二、 核心逻辑:如何“教”会它控制空调

很多人以为直接发一个“打开空调”的红外码就行了,其实不是。芯步的红外控制器核心逻辑是 “虚拟遥控器”

你需要先告诉控制器:“我要控制的是格力的空调”,然后把格力空调的红外码库“下载”到你的设备上。这一步通常叫 “配码”“匹配遥控器”

  • 第一步:添加遥控器。 你调用接口,传入品牌“格力”、设备类型“空调”,后台会返回一个 remote_id(遥控器ID)。

  • 第二步:下发指令。 拿到 remote_id 后,你想调温度到24度,就直接发HTTP指令给芯步云,芯步云再转给红外控制器,控制器发出红外信号。

技术背景小贴士:现在的万能红外遥控器(比如涂鸦、芯步的方案)大多采用“码库下载”模式。设备本地存了一套红外码,云端下发的指令是“请执行温度24度”,设备直接映射成红外波发射,速度很快

三、 实战对接:HTTP接口调用详解

这里以“设置制冷模式,24度”为例,展示怎么发HTTP请求。

1. 构建请求地址

芯步的接口地址格式是固定的http(s)://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}

你需要把 {AppID} 替换成你的,{ts} 是当前的时间戳(秒级,比如 1714204800),{sign} 是签名,算法是 md5(md5(开发者密码) + ts)

小:如果你在局域网内,想控制延时低一点,可以用MQTT协议,主题是 api/{AppID}/device/control,比HTTP实时性更好

2. 构造请求参数 (Body)

这一步最关键。根据芯步的接口文档,向红外设备(空调)下发指令时,用 POST 方式,参数以 JSON 格式放在 Body 里

3. 代码示例 (Python)

假设你刚拿到了 remote_id,想控制空调开机并设置为24度制冷:

注意:接口返回200只代表平台收到了指令。如果空调没反应,可能是:红外控制器没对准空调、remote_id