mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-13 04:16:48 +00:00
🚜 Merges/Redirect Ping platform pages (#9123)
* 🚜 Merges/Redirect Ping platform pages * ✏️ Tweak
This commit is contained in:
Klaas Schoute
Fabian Affolter
parent
37e3745f71
commit
e5604cefc5
@ -1,46 +0,0 @@
|
||||
---
|
||||
layout: page
|
||||
title: "Ping (ICMP)"
|
||||
description: "Instructions on how to integrate Ping (ICMP)-based presence detection into Home Assistant."
|
||||
date: 2017-01-06 08:00
|
||||
sidebar: true
|
||||
comments: false
|
||||
sharing: true
|
||||
footer: true
|
||||
logo: home-assistant.png
|
||||
ha_category: Network
|
||||
ha_release: 0.36
|
||||
ha_qa_scale: internal
|
||||
---
|
||||
|
||||
|
||||
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.
|
||||
|
||||
<p class='note'>
|
||||
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.
|
||||
</p>
|
||||
|
||||
## {% linkable_title Configuration %}
|
||||
|
||||
To use this presence detection in your installation, add the following to your `configuration.yaml` file:
|
||||
|
||||
```yaml
|
||||
# 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.
|
||||
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 component page](/components/device_tracker/) for instructions how to configure the people to be tracked.
|
||||
@ -1,23 +1,32 @@
|
||||
---
|
||||
layout: page
|
||||
title: "Ping (ICMP) Binary sensor"
|
||||
description: "Instructions on how to integrate Ping (ICMP)-based binary sensors into Home Assistant."
|
||||
title: "Ping (ICMP)"
|
||||
description: "Instructions on how to integrate Ping (ICMP)-based into Home Assistant."
|
||||
date: 2017-04-11 08:00
|
||||
sidebar: true
|
||||
comments: false
|
||||
sharing: true
|
||||
footer: true
|
||||
logo: home-assistant.png
|
||||
ha_category: Network
|
||||
ha_category:
|
||||
- Network
|
||||
- Binary Sensor
|
||||
- Presence Detection
|
||||
ha_release: 0.43
|
||||
ha_qa_scale: internal
|
||||
redirect_from:
|
||||
- /components/binary_sensor.ping/
|
||||
- /components/device_tracker.ping/
|
||||
---
|
||||
|
||||
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.
|
||||
There is currently support for the following device types within Home Assistant:
|
||||
|
||||
## {% linkable_title Configuration %}
|
||||
- [Binary Sensor](#binary-sensor)
|
||||
- [Presence Detection](#presence-detection)
|
||||
|
||||
## {% linkable_title 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:
|
||||
|
||||
@ -66,3 +75,36 @@ binary_sensor:
|
||||
<p class='note'>
|
||||
When run on Windows systems, the round trip time attributes are rounded to the nearest millisecond and the mdev value is unavailable.
|
||||
</p>
|
||||
|
||||
## {% linkable_title 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.
|
||||
|
||||
<p class='note'>
|
||||
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.
|
||||
</p>
|
||||
|
||||
### {% linkable_title Configuration %}
|
||||
|
||||
To use this presence detection in your installation, add the following to your `configuration.yaml` file:
|
||||
|
||||
```yaml
|
||||
# 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.
|
||||
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 component page](/components/device_tracker/) for instructions how to configure the people to be tracked.
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user