sunfang1cn 发表于 2024-2-13 23:38:58

Airx设备最新接入方法-2024

本帖最后由 sunfang1cn 于 2024-2-14 00:05 编辑

Airx的设备目前已经全系列接入了涂鸦智能,并且非标准指令的模式比较多,这里以 Airx 加湿器H8为例来大概描述下如何加入HA。


1、下载涂鸦 "智能生活" APP并给设备重新配网
目前涂鸦平台的设备均可使用其智能生活 APP重新配网,将加湿器进入配网模式(本型号是长按电源键),打开涂鸦的 智能生活APP添加设备,即可扫描到新设备,配网即可,这个是下面获取所有id和key的基础。


2、注册涂鸦Iot平台开发者,并绑定 "智能生活"APP
按照官方文档 的方式注册开发者平台,新建应用,绑定智能生活APP并将Airx设备绑定到平台。


3、获取localkey
由于Airx设备非标控制指令比较懂,涂鸦官方的hass插件对其支持的不太好,所以我们还是以localtuya的方式进行接入,就需要获取localkey来进行。
此篇文档 直接给出了在线获取localkey的方式,当然通过tuya-cli等也可以获取,不过还是在线比较方便。需要的设备id可以在涂鸦开发者控制台上项目的设备页面看到。


4、安装localtuya
localtuya目前有很多社区分支,我选用的是 https://github.com/xZetsubou/hass-localtuya的分支,目前更新比较快,而且对加湿器支持最好。根据文档进行安装即可,我们主要直接做本地接入,无需配置云端API。


5、获取DP ID
由于airx的设备dp大多不标准,所以建议用"查询设备物理模型"的API进行获取实际的dp_id,否则添加设备时可能出现无响应错误。
API在线地址这里可以直接点击使用,填入之前获取到的设备ID即可,最后返回类似结果:
{
"result": {
    "model": "{\"modelId\":\"000004ewl4\",\"services\":[{\"actions\":[],\"code\":\"\",\"description\":\"\",\"events\":[],\"name\":\"默认服务\",\"properties\":[{\"abilityId\":1,\"accessMode\":\"rw\",\"code\":\"switch\",\"description\":\"\",\"extensions\":{\"iconName\":\"icon-dp_power\",\"attribute\":\"128\"},\"name\":\"总开关\",\"typeSpec\":{\"type\":\"bool\",\"typeDefaultValue\":false}},{\"abilityId\":5,\"accessMode\":\"rw\",\"code\":\"switch_led\",\"description\":\"\",\"extensions\":{\"iconName\":\"icon-dp_light\",\"attribute\":\"128\"},\"name\":\"灯光\",\"typeSpec\":{\"type\":\"bool\",\"typeDefaultValue\":false}},{\"abilityId\":8,\"accessMode\":\"rw\",\"code\":\"sound\",\"description\":\"\",\"extensions\":{\"iconName\":\"icon-dp_voice\",\"attribute\":\"128\"},\"name\":\"声音\",\"typeSpec\":{\"type\":\"bool\",\"typeDefaultValue\":false}},{\"abilityId\":13,\"accessMode\":\"rw\",\"code\":\"humidity_set\",\"description\":\"\",\"extensions\":{\"iconName\":\"icon-a_mode_dry\",\"attribute\":\"128\"},\"name\":\"湿度设置\",\"typeSpec\":{\"max\":80,\"min\":30,\"scale\":0,\"step\":5,\"type\":\"value\",\"typeDefaultValue\":30,\"unit\":\"%RH\"}},{\"abilityId\":14,\"accessMode\":\"ro\",\"code\":\"humidity_current\",\"description\":\"\",\"extensions\":{\"iconName\":\"icon-shidu\",\"attribute\":\"128\"},\"name\":\"当前湿度\",\"typeSpec\":{\"max\":90,\"min\":10,\"scale\":0,\"step\":1,\"type\":\"value\",\"typeDefaultValue\":10,\"unit\":\"%RH\"}},{\"abilityId\":22,\"accessMode\":\"ro\",\"code\":\"fault\",\"description\":\"\",\"extensions\":{\"iconName\":\"icon-Panic\",\"scope\":\"fault\",\"attribute\":\"1152\"},\"name\":\"机头分离告警\",\"typeSpec\":{\"label\":[\"break_off\"],\"maxlen\":1,\"type\":\"bitmap\",\"typeDefaultValue\":0}},{\"abilityId\":24,\"accessMode\":\"rw\",\"code\":\"mode\",\"description\":\"\",\"extensions\":{\"attribute\":\"128\"},\"name\":\"工作模式\",\"typeSpec\":{\"range\":[\"AUTO\",\"LOW\",\"MIDDLE\",\"HIGH\",\"SLEEP\"],\"type\":\"enum\",\"typeDefaultValue\":\"AUTO\"}},{\"abilityId\":25,\"accessMode\":\"rw\",\"code\":\"anion\",\"description\":\"\",\"extensions\":{\"attribute\":\"128\"},\"name\":\"负离子\",\"typeSpec\":{\"type\":\"bool\",\"typeDefaultValue\":false}},{\"abilityId\":29,\"accessMode\":\"rw\",\"code\":\"child_lock\",\"description\":\"\",\"extensions\":{\"attribute\":\"128\"},\"name\":\"童锁\",\"typeSpec\":{\"type\":\"bool\",\"typeDefaultValue\":false}},{\"abilityId\":101,\"accessMode\":\"ro\",\"code\":\"water_level\",\"description\":\"\",\"name\":\"当前水位\",\"typeSpec\":{\"range\":[\"No_water\",\"Have_water\",\"Full_water\",\"Have_water2\"],\"type\":\"enum\",\"typeDefaultValue\":\"No_water\"}},{\"abilityId\":102,\"accessMode\":\"rw\",\"code\":\"uv_light\",\"description\":\"\",\"extensions\":{\"iconName\":\"icon-dp_power2\",\"attribute\":\"4096\"},\"name\":\"UV灯\",\"typeSpec\":{\"type\":\"bool\",\"typeDefaultValue\":false}}]}]}"
},
"success": true,
"t": 1707835567705,
"tid": "9ef05dc8ca7e11ee9b96ba916b56a9a0"
}其中的abilityID 就是我们需要的DP ID,可以看到每个也都有取值解释。


6、配置本地设备
根据localtuya文档的指示,在集成配置中添加新设备,如下填写内容:

之后点击提交。

然后稍等一会儿会让你做一个hass中设备类型的适配,我这里直接让他做自动检测就可以自动适配为加湿器,如果无法自动配置,需要选择合适的设备模型后填入对应属性的DP ID或对每个DP ID配置为switch input等实体,会比较麻烦。然后就可以正常在hass中使用了。

最后接入效果:


BJUTLXF 发表于 2024-2-24 20:23:56

我的空气净化器, 传感器(滤芯寿命,PM2.5)好像数值都拿不到全是0

sunfang1cn 发表于 2024-2-28 22:29:30

BJUTLXF 发表于 2024-2-24 20:23
我的空气净化器, 传感器(滤芯寿命,PM2.5)好像数值都拿不到全是0

要看下涂鸦的调试页面上能不能拿到。

befantasy 发表于 2024-4-14 22:26:59

老的airx A7可以吗?用的好像是Marvell的芯片。
页: [1]
查看完整版本: Airx设备最新接入方法-2024