Move Ping binary sensor attributes to sensor entities (#31705)

* Move Ping binary sensor attributes to sensor entities

* Fix

* Add note about disabled entities

* Update source/_integrations/ping.markdown

---------

Co-authored-by: G Johansson <goran.johansson@shiftit.se>
This commit is contained in:
Jan-Philipp Benecke 2024-03-03 11:17:40 +01:00 committed by GitHub
parent 51674ca9a7
commit 2b45fa7145
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -12,6 +12,7 @@ ha_domain: ping
ha_platforms:
- binary_sensor
- device_tracker
- sensor
ha_integration_type: integration
ha_config_flow: true
ha_codeowners:
@ -21,6 +22,7 @@ ha_codeowners:
There is currently support for the following device types within Home Assistant:
- [Binary sensor](#binary-sensor)
- [Sensors](#sensors)
- [Presence detection](#presence-detection)
{% include integrations/config_flow.md %}
@ -49,12 +51,16 @@ To change the settings, go to {% my integrations title="**Settings** > **Devices
The `ping` binary sensor platform allows you to use `ping` to send ICMP echo requests. This way you can check if a given host is online and determine the round trip times from your Home Assistant instance to that system.
This sensor is enabled by default. The default polling interval is 30 seconds.
The sensor exposes the different round trip times in milliseconds measured by `ping` as attributes:
## Sensors
- `round_trip_time_mdev` - the standard deviation
- `round_trip_time_avg` - the average round trip time
- `round_trip_time_min` - the shortest round trip time
- `round_trip_time_max` - the longest round trip time
The integration exposes the different round trip times milliseconds as entities:
- `Round Trip Time Mean Deviation` - the standard deviation
- `Round Trip Time Average` - the average round trip time
- `Round Trip Time Minimum` - the shortest round trip time
- `Round Trip Time Maximum` - the longest round trip time
**These entities are disabled by default and can be enabled in the UI if needed.**
<div class='note'>
When run on Windows systems, the round trip time attributes are rounded to the nearest millisecond and the mdev value is unavailable.