Philips Air Binding
Binding to support the integration with Philips Air Purifiers including the models based on COAP communication protocol (most >2019 models)
Note may require to (manually) install coap and upnp transport
feature:install openhab-transport-coap
feature:install openhab-transport-upnp
Installation
- Uninstall/remove any older philipsair JAR from your
addonsfolder first. - Either:
- KAR: drop the
.karfile into theaddonsfolder. It pulls in the required CoAP and UPnP transport features automatically. - JAR: drop the
.jarinto theaddonsfolder and install the transports yourself from the Karaf console:
feature:install openhab-transport-coap openhab-transport-upnp
- KAR: drop the
- Check with
bundle:list | grep -i philipsthat it is Active. The binding should now be listed when you add a Thing.
Changelog
2021-11-04 Initial market place version.
- fixed: several code warnings & NPE warnings
- source GitHub - marcelrv/openhab-addons at philipsair-coap-v2
2022-12-15 Minor update
- Version bump for 3.4, Removed uuid pattern constraint which gives issues in the new releases
- source GitHub - marcelrv/openhab-addons at philips-air-coap-oh34
2023-09-24 Version bump oh4 - Minor update
- Version bump for 4.x, minor cleanup and remove dependency for apache commons
- source GitHub - marcelrv/openhab-addons at philipsair-coap-oh4
2026-09-27 Version bump oh5.2 - Minor update
-
The binding now shows up in the UI again. It still used the old openHAB 2 style binding description, which openHAB 4+ no longer reads. So the bundle was Active but didn’t appear as an add-on, and you could only add things through the Inbox. @ollo, I think this is what you ran into.
-
Humidifier channels for CoAP devices. Humidity setpoint (
rhset), function (func), humidity (rh), temperature (temp), water level (wl) and wick filter (wicksts) are now added automatically once your device reports them. Devices without a humidifier don’t get these extra channels. @Fargi, this should cover the parameters you were missing, without the modified JAR. -
Better model recognition in UPnP discovery. Model numbers with a region suffix (e.g.
AC2889/10,AC2729/50) are now recognized instead of falling back to the universal thing type.
Notes:
Philips Air Binding is developed by Michał Boroński
(GitHub - michalboronski/openhab-addons: Add-ons for openHAB 2.x
Coap protocol support (this version) contributed by [Marcel Verpaalen] (Profile - marcel_verpaalen - openHAB Community)
Discussion topic in this forum: Binding request: Philips air purifier
Market place topic for 3.x version: Philips Air Binding [3.0.0.0;4.0.0.0)
Market place topic for 4.x version: https://community.openhab.org/t/philips-air-binding-4-0-0-0-5-0-0-0
Alternative installation jar (you must manually install coap and upnp transport): https://verpaalen.com/openhab/org.openhab.binding.philipsair-5.2.1.jar
Resources
https://verpaalen.com/openhab/org.openhab.binding.philipsair-5.2.1.kar
