check_air_purifier

Project Notes

check_air_purifier.py is a python 3 script for monitoring air purifiers made by philips. Communication with the device is made with a customized version of py-air-control. Tested with AC1214_10, but should work with any other philips device.

Features:

* Monitor air-quality (allergen index / pm2.5) and filter status including thresholds and perfdata
* Check device status (fan speed, power, light, updates, network)

Installation

Use the package manager pip3 to install the required module py-air-control (tested with version 0.5.0).

pip3 install py-air-control

Put the plugin into libexec and extend your checkcommands. For icinga2 you can use check_air_purifier.cfg.

Usage
usage: check_air_purifier.py [-h] -H HOSTNAME -m
{deviceinfo,filters,airquality} [-w WARNING]
[-c CRITICAL]

optional arguments:
-h, --help show this help message and exit
-H HOSTNAME, --hostname HOSTNAME
Hostname / IP of air purifier
-m {deviceinfo,filters,airquality}, --mode {deviceinfo,filters,airquality}
mode to check
-w WARNING, --warning WARNING
Warning threshold
-c CRITICAL, --critical CRITICAL
Critical threshold
Examples
check_air_purifier.py -H 192.168.10.120 -m 'deviceinfo'
OK: Power is ON - Mode is auto - Fan Speed is 2 - Light brightness is 50 - Button Light is ON - Used Index is IAI - Child lock is False - name is AC1214_10 - version is 2 - upgrade is - state is idle - progress is 0 - statusmsg is - mandatory is False - ssid is myssid - password is mypassword - protection is wpa-2 - ipaddress is 192.168.10.120 - netmask is 255.255.255.0 - gateway is 192.168.10.1 - dhcp is True - macaddress is mymacaddress - cppid is mycppid|'Fan Speed'=2 'Light brightness'=50

check_air_purifier.py -H 192.168.10.120 -m 'filters' --warning 16 --critical 8
OK: Pre-filter and Wick is ok (44 hours remaining) - Active carbon filter is ok (2084 hours remaining) - HEPA filter is ok (4484 hours remaining)|'Pre-filter and Wick'=44 'Active carbon filter'=2084 'HEPA filter'=4484

check_air_purifier.py -H 192.168.10.120 -m 'airquality' --warning 8 --critical 10
OK: Allergen index is ok (4) - PM25 is 19|'Allergen index'=4 'PM25'=19