Tutorial on how to use the HA Lawn mower integration

ESPHome
1

Hi there,

I’ve forked and further developed an ESPHome firmware for my automower. Works fine.

Now, I stumbled upon this Lawn mower page from HA: Lawn mower - Home Assistant and this looks inspiring to make HA recognize my ESPHome integration as a native “lawn mower”.

I see the corresponding code following the “View source on GitHub” link, but I have absolutely no clue what I’m supposed to do to “integrate” that HA component into my ESPHome device. I miss some documentation or example on what I’m supposed to do, namely:

  1. Where am I supposed to to reference that HA component? In the device YAML? I guess it will be somewhere in that file: esphome-hqam/hqam-esphome.yaml at 4ac0617615fa1135a562861f0b48a678cff3a9f1 · xperseguers/esphome-hqam · GitHub In the doc of ESPHome I see a concept of external component (which I used) but I didn’t find anything about using a HA component, is that a “package” somehow?
  2. I will have to configure/implement some methods such as how to tell the lawn mower component the state of the automower, or what to do when asking to mown from HA using the component’s play button…

I miss some doc/entry point on what to look for, which file to open, what to “read” in the code to figure out those things.

Thanks for helping.