ESPHome: update doc

2 months ago · 3a01fcd0d1
parent b89339d524
commit 3a01fcd0d1
1 changed files with 4 additions and 1 deletions
--- a/docs/widgets/services/esphome.md
+++ b/docs/widgets/services/esphome.md
@ -7,7 +7,10 @@ Learn more about [ESPHome](https://esphome.io/).

 Show the number of ESPHome devices based on their state.

-Allowed fields: `["total", "online", "offline", "offline_alt", "unknown"]`.
+Allowed fields: `["total", "online", "offline", "offline_alt", "unknown"]` (maximum of 4).
+
+By default ESPHome will only mark devices as `offline` if their address cannot be pinged. If it has an invalid config or its name cannot be resolved (by DNS) its status will be marked as `unknown`.
+To group both `offline` and `unknown` devices together, users should use the `offline_alt` field instead. This sums all devices that are _not_ online together.

 ```yaml
 widget: