Update Sonos S1 battery support (#17893)

Co-authored-by: Franck Nijhof <git@frenck.dev>
This commit is contained in:
jjlawren 2021-05-25 11:42:14 -05:00 committed by GitHub
parent dffd41841a
commit 0e77e96caf
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -24,10 +24,16 @@ The `sonos` integration allows you to control your [Sonos](https://www.sonos.com
## Battery support
Battery sensors are supported for the `Sonos Roam` and `Sonos Move` devices on S2 firmware.
Battery sensors are fully supported for the `Sonos Roam` and `Sonos Move` devices on S2 firmware. `Sonos Move` speakers still on S1 firmware are supported but may update infrequently.
For each speaker with a battery, a `sensor` showing the current battery charge level and a `binary_sensor` showing the power state of the speaker are created. The `binary_sensor` reports if the speaker is currently powered by an external source and its `power_source` attribute shows which specific source is providing the current power. This source attribute can be one of `BATTERY`, `SONOS_CHARGING_RING` if using wireless charging, or `USB_POWER` if charging via USB cable. Note that the Roam will report `SONOS_CHARGING_RING` even when using a generic Qi charger.
<div class='note'>
The battery sensors rely on working change events or updates will be delayed. S1 battery sensors **require** working events to report any data. See more details in [Advanced use](#advanced-use).
</div>
## Alarm support
The Sonos integration adds one `switch` for each alarm set in the Sonos app. The alarm switches are detected, deleted and assigned automatically and come with several attributes that help to monitor Sonos alarms.