homebridge-mi-acpartner v0.7.1

homebridge-mi-acpartner

English Ver. Here

小米空调伴侣的Homebridge插件

感谢takatost，miio，YinHangCode和所有测试开发人员提供支持。

注意：此插件于0.4.0版本后修改成platform，请根据本文修改你的配置文件使插件正常工作。

Support(支持)

空调伴侣2代 & 空调伴侣1代

继电器空调伴侣的插件支持还处于开发阶段。

如需要使用空调伴侣中的网关功能，请使用YinHangCode提供的Mi-Aqara插件。

Feature(功能）

• 开关空调

• 控制模式：

  • 使用空调码或红外码控制你的空调。
  • 在17-30度之间调整空调温度（默认情况）。
  • 制冷，制热，自动模式支持。
  • 改变风力，改变扫风状态。（请将空调定义成heaterCooler）
  • 使用红外控制其他电器。（即将上线）

• 如果我们没有提供预设，可自定义你的空调码（请将空调定义成climate）

• 在空调伴侣和Homekit中同步信息。(即将上线)

• 自动获取你的空调码。(只支持部分空调空调)

• 米家温湿度传感器支持。(即将上线)

Installation（安装）

1. 安装Homebridge

2. 安装此插件和依赖包(miio)

      npm install -g  homebridge-mi-acpartner miio

3. 在config.json中加入你的配置信息，请参考下方的Config和Config Example添加

4. 启动Homebridge.

Preset（预设）

此插件目前支持的预设：

格力：1，2，8
大部分空调的1号预设

你可以在米家App中更改预设信息

如果没有定义customize，插件会使用自动生成的空调码，不保证可用性。

Config（配置）

全局配置

参考这篇文章获得空调伴侣的token。

如果你有一台安卓手机，也可以直接从安卓版米家App中拿到token

设备配置

• climate（空调）

使用此方法来获取你正使用的空调码，然后填入到config，填写方法请参考Config Example。

• heaterCooler（Beta）

可以更改风力和扫风的空调，还处于测试阶段

• learnIR (红外学习开关)

打开开关后，使用遥控器向空调伴侣发送信号，30秒内接收到的红外信号会显示在日志中。

请注意空调码仍然需要自己抓包，且空调码和红外码是有区别的。

• switch（红外开关）

• switchMulti (多重信号红外开关)

Config Example（配置例子）

基本插件配置（推荐）

"platforms": [
        {
            "platform": "XiaoMiAcPartner",
            "ip": "your_ac_partner_ip",
            "token": "your_ac_partner_token",
            "accessories":[
                {
                    "name": "Ac Partner",
                    "type": "climate"
                }
            ]
        }
    ]

也可以写成这样

"platforms": [
        {
            "platform": "XiaoMiAcPartner",
            "accessories":[
                {
                    "name": "Ac Partner",
                    "type": "climate",
                    "ip": "your_ac_partner_token",
                    "token": "your_ac_partner_token"
                }
            ]
        }
    ]

加入空调和红外学习开关

"platforms": [
        {
            "platform": "XiaoMiAcPartner",
            "ip": "AC_Partner_1",
            "token": "AC_Partner_1_token",
            "accessories":[
                {
                    "name": "learn",
                    "type": "learnIR"
                },{
                    "name": "Ac Partner",
                    "type": "climate",
                    "ip":"AC_Partner_2",
                    "token":"AC_Partner_2_token"
                }
            ]
        }
    ]

加入空调和开关

"platforms": [
        {
            "platform": "XiaoMiAcPartner",
            "ip": "AC_Partner_1",
            "token": "AC_Partner_1_token",
            "accessories":[
                {
                    "name": "test",
                    "type": "switch",
                    "data":{
                        "on": "FE018254234ON",
                        "off": "FE019205313OFF"
                    }
                },{
                    "name": "Ac Partner",
                    "type": "climate",
                    "ip":"AC_Partner_2",
                    "token":"AC_Partner_2_token"
                }
            ]
        }
    ]

空调和多重信号开关

"platforms": [
        {
            "platform": "XiaoMiAcPartner",
            "ip": "AC_Partner_1",
            "token": "AC_Partner_1_token",
            "accessories":[
                {
                    "name": "test",
                    "type": "switchMulti",
                    "interval": 1500,
                    "data":{
                        "on": [
                            "FE.....",
                            "FE......",
                            "FE......"
                        ],
                        "off": [
                            "FE.....",
                            "FE......"
                        ]
                    }
                },{
                    "name": "Ac Partner",
                    "type": "climate",
                    "ip":"AC_Partner_2",
                    "token":"AC_Partner_2_token"
                }
            ]
        }
    ]

使用外置温湿度传感器

"platforms": [
        {
            "platform": "XiaoMiAcPartner",
            "ip": "your_ac_partner_token",
            "token": "your_ac_partner_token",
            "accessories":[
                {
                    "name": "Ac Partner",
                    "type": "climate",
                    "sensorSid": "lumi.158d000156e667"
                }
            ]
        }
    ]

使用自定义空调码或红外码

大部分空调码以01开头，且能与空调伴侣同步信息；大部分红外码以FE开头，能否同步信息未知

"platforms": [
        {
            "platform": "XiaoMiAcPartner",
            "ip": "your_ac_partner_token",
            "token": "your_ac_partner_token",
            "accessories":[
                {
                    "name": "Ac Partner",
                    "type": "climate",
                    "customize": {
                        "off": "关闭信号（必须）",
                        "on": "有些空调需要这个信号（可选）",
                        "auto": "自动模式信号（可选）",
                        "heat":{
                            "30": "（可选）",
                            "29": "",
                            "17": ""
                        },
                        "cool":{
                            "30": "（必须）",
                            "29": "",
                            "17": ""
                        }
                    }
                }
            ]
        }
    ]

Changelog

0.5.6

修复了一个导致climate无法工作的问题

0.5.4

修复BUG

0.5.1

修复部分配件无响应的问题（感谢qqshfox）

0.5.0

支持使用heaterCooler定义空调

0.4.4

可以设置红外学习开关和更多的开关类型

0.4.2

添加同步锁来解决多设备导致的问题

0.4.0

插件转移成Platform，支持基础的红外开关

0.3.0

支持自动重连，增加预设

0.2.9

支持湿度信息显示

0.2.8

支持深度自定义

0.2.7

支持连接到空调伴侣的温湿度传感器

0.2.6

Remove Gateway temperature sensor support. Add automatic preset detection.

0.2.5

Outer temperature sensor support.

0.2.3

Gree 2 preset support, customize IR control support.

0.2.0

Sync State between hk and AC Partner. maxTemp & minTemp Support. Add gree 2 preset for testing.

0.1.5

Presets reconstruction.

0.0.9

Auto mode support, "on" signal support, code reconstruction, presets reconstruction.

0.0.1

ADD Basic File.