Airx设备最新接入方法-2024

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

本帖最后由 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中使用了。

最后接入效果：
{85D2C695-C00D-4861-A14D-FE0797550926}.png