homebridge-philips-air

Homebridge Plugin for Philips Air Purifiers

This plugin is now using py-air-control directly to enable support for newer Philips connected air purifier models.

Installation

1. Install Homebridge using the official instructions.
2. Install this plugin using sudo npm install -g homebridge-philips-air --unsafe-perm.
3. Update your configuration file. See configuration sample below.

If you are using CoAP or Plain CoAP:

1. Install pip and git using sudo apt install python3-pip git.
2. Install py-air-control using sudo pip3 install py-air-control.
3. Update CoAPthon3 using sudo pip3 install -U git+https://github.com/Tanganelli/CoAPthon3@89d5173.

Plain CoAP users only will also need to do:

1. Allow non-root to send pings using echo "net.ipv4.ping_group_range=0 1000" | sudo tee -a /etc/sysctl.conf.
2. Update running sysctl configuration using sudo sysctl -p.

If you're only using HTTP, no additional steps are required.

Configuration

Edit your config.json accordingly. Configuration sample:

"platforms": [{
    "platform": "philipsAir",
    "devices": [{
        "name": "Living Room Purifier",
        "ip": "10.0.1.16",
        "protocol": "http"
    }]
}]

Fields	Description	Required
platform	Must always be philipsAir.	Yes
name	For logging purposes.	No
timeout_seconds	Number of seconds to wait for a response from the purifier. (Default: 5)	No
devices	Array of Philips air purifiers (multiple supported).	Yes
|- name	Name of your device.	No
|- ip	IP address of your device.	Yes
|- protocol	Protocol used by your device: http (default), plain_coap, coap	No
|- sleep_speed	Does this device support 'sleep' speed?	No
|- light_control	Expose device lights as lightbulbs.	No