3.2.6 • Published 1 year ago
@vectronic/homebridge-ping-hosts v3.2.6
homebridge-ping-hosts
A ping state sensor plugin for homebridge (https://github.com/nfarina/homebridge).
Installation
- Install homebridge using:
npm install -g homebridge
- Install this plugin:
npm install -g --unsafe-perm @vectronic/homebridge-ping-hosts
- Update your
config.json
configuration file
Configuration
Example config.json
entry:
"platforms": [
{
"platform": "PingHosts",
"hosts": [
{
"name": "Router",
"ipv4_address": "192.168.0.1",
"interval": 60,
"timeout": 25,
"retries": 1,
"startup_as_failed": true,
"closed_on_success": true,
"type": "Lightbulb"
},
{
"name": "Website",
"ipv4_address": "website.com",
"interval": 60,
"timeout": 25,
"retries": 1,
"startup_as_failed": true,
"closed_on_success": true,
"type": "ContactSensor"
},
{
"name": "Internet",
"ipv6_address": "fe80::a00:27ff:fe2a:3427",
"interval": 60,
"timeout": 25,
"retries": 1,
"startup_as_failed": true,
"closed_on_success": true,
"type": "MotionSensor"
},
{
"name": "Television",
"mac_address": "04:a1:51:1b:12:92",
"interval": 60,
"timeout": 25,
"retries": 1,
"startup_as_failed": true,
"closed_on_success": true,
"type": "ContactSensor"
}
]
}
]
Notes
- Only one of
ipv6_address
,ipv4_address
ormac_address
should be specified for any given device. - If
ipv6_address
is specified any specifiedipv4_address
ormac_address
will be ignored. - If
ipv4_address
is specified any specifiedmac_address
will be ignored. - Despite the name
ipv4_address
supports either an IP address e.g.192.168.0.1
OR a hostname e.g.www.google.com
. - If a MAC address is specified, ARP table lookup is performed to map to an IP address. NOTE: This will only resolve an IP address if there is already a MAC address in the ARP table on the machine running Homebridge.
interval
defaults to 60timeout
defaults to 25retries
defaults to 1- Works better if
timeout * (1 + retries) < interval
- On startup the sensor will default to a "failed" ping state. This can be overridden by configuring
startup_as_failed: false
. - The sensor will have a "closed" state for successful pings and an "open" state for failed pings (or for any other issues).
This can be overridden by configuring
closed_on_success: false
. - The
type
of the accessory can be one ofContactSensor
,Lightbulb
orMotionSensor
. The default isContactSensor
.
3.2.6
1 year ago
3.2.2
2 years ago
3.2.1
2 years ago
3.2.0
2 years ago
3.2.5
2 years ago
3.2.4
2 years ago
3.2.3
2 years ago
3.1.3
2 years ago
3.1.2
2 years ago
3.1.1
2 years ago
3.1.0
2 years ago
3.1.4
2 years ago
3.0.1
2 years ago
3.0.0
2 years ago
2.0.1
3 years ago
1.0.4
3 years ago
2.0.0
3 years ago
1.0.3
4 years ago
1.0.2
4 years ago
1.0.1
4 years ago
1.0.0
4 years ago