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: ha_platforms:
- binary_sensor - binary_sensor
- device_tracker - device_tracker
- sensor
ha_integration_type: integration ha_integration_type: integration
ha_config_flow: true ha_config_flow: true
ha_codeowners: ha_codeowners:
@ -21,6 +22,7 @@ ha_codeowners:
There is currently support for the following device types within Home Assistant: There is currently support for the following device types within Home Assistant:
- [Binary sensor](#binary-sensor) - [Binary sensor](#binary-sensor)
- [Sensors](#sensors)
- [Presence detection](#presence-detection) - [Presence detection](#presence-detection)
{% include integrations/config_flow.md %} {% 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. 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. 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 The integration exposes the different round trip times milliseconds as entities:
- `round_trip_time_avg` - the average round trip time
- `round_trip_time_min` - the shortest round trip time - `Round Trip Time Mean Deviation` - the standard deviation
- `round_trip_time_max` - the longest round trip time - `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'> <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. When run on Windows systems, the round trip time attributes are rounded to the nearest millisecond and the mdev value is unavailable.