homebridge-esphome-ts

This plugin integrates the esphome platform into homebridge so that you don't have to gothrough homeassistant if you don't want to (not that there is anything wrong with that). It makes use of the native API of esphomeso that you can expect instant updates for all your binary sensors what have you.

Supported components include:

• Lights
• Switches
• BinarySensors (motion, window, door, smoke and leakage)
• Sensors (temperature & humidity at the moment)

This project is currently still in beta, but I thought that many eyes see more than justmy two :)

Installation

Unless you haven't done so already, make sure to install homebridge first. See instructionshere. Once you have done this, you can install this plugin by typing

npm i -g homebridge-esphome-ts

Once this is done, you can configure your homebridge config.json according to the next section.

Getting Started

{
    "platform": "esphome",
    "devices": [
        {
            "host": "my_esp.local",
            "password": "Passw0rd!",
            "port": 9001,
            "retryAfter": 120000 // optional, time in milliseconds!
        }
    ],
    "retryAfter": 60000 // optional, time in milliseconds!
}

Only the host key is mandatory under devices. As password '' is assumed aka no password and the defaultport number 6053 is also wired into the plugin. You can add, in theory, as many ESP devices as you want tothat array.

If some of your devices are password-less you can enable devices discovery to let the plugin find all yourdevices by setting discover: true in platform configuration. In case if you don't have any password-secureddevices you can even fully omit "devices" section in platform configuration.

In case you don't have a working esphome configuration you can have look at the examples folder. There you willfind both an example homebridge config.json file as well as an example esphome configuration. For further guidanceon esphome please check out their website.

retryAfter

Both retryAfter keys are as explained optional and need to contain an integer that tells this pluginafter what time frame it should try to reconnect. Keep in mind that this value needs to be in milliseconds. The innerretryAfter will trump the outer value if present. The default value is 90 seconds.

Blacklisting

If for some reason you want to exclude a specific component from this plugin justadd a key containing its name (as it was defined in esphome and is shown initially in HomeKit) to a string array under the key blacklist:

{
    "platform": "esphome",
    "devices": [
        ...
    ],
    "blacklist": [
        "My blacklisted switch"
    ]
}

Todo

• Implement a blacklist for components
• Testing, especially with the new homebridge version
• Implement sensor component

Troubleshooting

Please make sure to add the api entry to your config!

If you still have problems please feel free to open a ticket on GitHub. Before doing so add this to yourconfig "debug": true. The plugin will now output what it has gotten from your ESP device.Please append this when you open a ticket here on GitHub. Please attach your config as well and makesure to remove any sensitive information such as WiFi passwords.

In addition to simply writing stuff to the console, it will also write everything received from your devices to individualfiles under /tmp. You can then submit these files with any issues you might file on GitHub.

Slight warning The writing of these files means that it will also occupy more space on your SD card or whatever youmight have. So simply turn off this option once you don't need it anymore.