home-assistant.io/source/_integrations/ping.markdown

title, description, ha_category, ha_release, ha_quality_scale, ha_domain

title	description	ha_category	ha_release	ha_quality_scale	ha_domain
Ping (ICMP)	Instructions on how to integrate Ping (ICMP)-based into Home Assistant.	Network Binary Sensor Presence Detection	0.43	internal	ping

There is currently support for the following device types within Home Assistant:

• Binary Sensor
• Presence Detection

Binary Sensor

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.

To use this sensor in your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry
binary_sensor:
  - platform: ping
    host: 192.168.0.1

{% configuration %} host: description: The IP address or hostname of the system you want to track. required: true type: string count: description: Number of packets to send. required: false type: integer default: 5 name: description: Let you overwrite the name of the device. required: false type: string default: Ping Binary sensor {% endconfiguration %}

The sensor exposes the different round trip times values measured by ping as attributes:

• round trip time mdev
• round trip time avg
• round trip time min
• round trip time max

The default polling interval is 5 minutes. As many integrations based on the entity class, it is possible to overwrite this scan interval by specifying a scan_interval configuration key (value in seconds). In the example below we setup the ping binary sensor to poll the devices every 30 seconds.

# Example configuration.yaml entry to ping host 192.168.0.1 with 2 packets every 30 seconds.
binary_sensor:
  - platform: ping
    host: 192.168.0.1
    count: 2
    scan_interval: 30

When run on Windows systems, the round trip time attributes are rounded to the nearest millisecond and the mdev value is unavailable.

Presence Detection

The ping device tracker platform offers presence detection by using ping to send ICMP echo requests. This can be useful when devices are running a firewall and are blocking UDP or TCP packets but responding to ICMP requests (like Android phones). This tracker doesn't need to know the MAC address since the host can be on a different subnet. This makes this an option to detect hosts on a different subnet when nmap or other solutions don't work since arp doesn't work.

Please keep in mind that modern smart phones will usually turn off WiFi when they are idle. Simple trackers like this may not be reliable on their own.

Configuration

To use this presence detection in your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry
device_tracker:
  - platform: ping
    hosts:
      hostone: 192.168.2.10

{% configuration %} hosts: description: List of device names and their corresponding IP address or hostname. Device names must conform to the standard requirements of lower case, numbers and underscore only - see entity names. required: true type: list count: description: Number of packet used for each device (avoid false detection). required: false type: integer {% endconfiguration %}

See the device tracker integration page for instructions how to configure the people to be tracked.