xaal.yeelight 0.4.1

Boot & Connect flow

On startup, setup() loads bulbs from config and starts async_listen on each. The Yeelight library handles reconnection automatically:

• While connected: push notifications arrive in real time; sync() is rarely needed.

• If a bulb disconnects: backoff (15s) then retry, and on_properties({connected: False/True}) updates the gateway status.

Important: if a bulb is offline at boot, async_listen fails immediately with no retry. The bulb will only be picked up later by discover() (which runs every 300 seconds). This is a limitation of the library.

Rate limiting

Yeelight bulbs enforce a hardware limit of 60 commands/minute. To stay under this limit:

• turn_on / turn_off skip if already in the target state.

• sync() coalesces multiple get_properties calls into one, and is skipped if a push notification arrived within the last 300ms.

• discover() is the only periodic poll (every 300s).