Overview

Application performs a ping of given ip adresses and report target online/offline status via mqtt topics. Used in home automation scenarious when its required to distingush user presence/absence at home. Note than local DHCP server (on your wifi router or any other) should be configured to assign static IP adresses for the devices you going to track.

Alternatives

There is a similar, but looking abandoned, project based on bluetooth https://github.com/andrewjfreyer/monitor. Unfortunately, I was not able to make it running on old hardware, which is MacMini 2010 Sever in my case (used as home automation server).

Mqtt Api

• To receive statuses - subscribe to device-pinger/<ip>/status or wildcard device-pinger/+/status, payload would be {"status":<status>}, with 3 possible status numeric values: -1 for UNKNOWN, 1 for ONLINE and 0 for OFFLINE
• Add new IP to monitor - publish to device-pinger/<ip>/add with either empty payload or json {"seq":<number>} to track operation result, which will be published to device-pinger/<ip>/rsp
• Delete IP from monitoring - publish to device-pinger/<ip>/del (same payload format as for add)

Configuration

Configuration is set via environment variables or from .env files. There are several options:

1. use make docker-up to load default .env file;
2. use CONF=.env.sample make docker-up to run with selected file;
3. load envs with docker-compose form some common config like in .env.sample in my case;
4. pass one or more config options using bash syntax MQTT_HOST=test.mosquitto.org ./device-pinger

Development

make run or make && ./device-pinger to compile and start app with default config .evn or you can set any other config with CONF=.env.bak make run

Production

• build image with make docker-build
• run image with default config make docker-up
• run image with any selected config CONF=.env.sample make docker-up

Screenshots

Console MQTT Explorer Image size