Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/adamcsk1/ha-philips-airpurifier-coap
Philips Air Purifier Home Assistant custom component with MQTT (for Encrypted CoAP devices)
https://github.com/adamcsk1/ha-philips-airpurifier-coap
home-assistant
Last synced: 21 days ago
JSON representation
Philips Air Purifier Home Assistant custom component with MQTT (for Encrypted CoAP devices)
- Host: GitHub
- URL: https://github.com/adamcsk1/ha-philips-airpurifier-coap
- Owner: adamcsk1
- Created: 2024-07-05T19:01:56.000Z (6 months ago)
- Default Branch: master
- Last Pushed: 2024-08-19T08:45:14.000Z (5 months ago)
- Last Synced: 2024-08-19T10:22:25.191Z (5 months ago)
- Topics: home-assistant
- Language: Python
- Homepage:
- Size: 161 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
[](https://github.com/custom-components/hacs)
Philips Air Purifier Home Assistant custom component with MQTT (for Encrypted CoAP devices).
Tested on AC2729/50
## Requirements:
- [CoAPthon3 (https://github.com/rgerganov/CoAPthon3)](https://github.com/rgerganov/CoAPthon3)
## Installation steps:
1. Add custom component to homeassitant
2. Configure your device in HA
3. Run this command on your HA instance host system: _pip3 install -U git+https://github.com/rgerganov/CoAPthon3_
4. Restart HA
## Usage:
```yaml
fan:
- platform: philips-airpurifier-coap
host: 192.168.0.17
mqtt: 192.168.0.18
```
## Configuration variables:
| Field | Value | Necessity | Description |
| -------- | -------------------------- | ---------- | ---------------------------- |
| platform | `philips-airpurifier-coap` | _Required_ | The platform name. |
| host | 192.168.0.17 | _Required_ | IP address of your Purifier. |
| name | Philips Air Purifier | Optional | Name of the Fan. |
| mqtt | 192.168.0.18 | Optional | MQTT broker IP address |
## Here you can find device id:
## Available functions:
- Get device attributes (MQTT)
- [Set fan speed (off, low, medium, high, turbo)](https://raw.githubusercontent.com/adamcsk1/ha-philips-airpurifier-coap/master/device_detail.png)
- [Set device mode (Available in speed select: Auto / Silent)](https://raw.githubusercontent.com/adamcsk1/ha-philips-airpurifier-coap/master/device_detail.png)
- Set target humidity
- Set function
- Set display brightness
- Set child lock state
## Available services:
##### fan.philips_air_purifier_coap_set_humidity:


| Key | Example | Possible values | Description |
| --------- | --------------------------- | ---------------------- | --------------- |
| entity_id | fan.purifier_and_humidifier | | Fan entity id |
| humidity | "50" | "40", "50", "60", "70" | Tartget humidity|
##### fan.philips_air_purifier_coap_function:


| Key | Example | Possible values | Description |
| --------- | --------------------------- | --------------- | ------------------------------------------------------------------- |
| entity_id | fan.purifier_and_humidifier | | Fan entity id |
| function | "PH" | "P", "PH" | Device mode (P = Purification, PH = Purification and Humidification)|
##### fan.philips_air_purifier_coap_light_brightness:


| Key | Example | Possible values | Description |
| ---------- | --------------------------- | ---------------------------- | ------------------------------ |
| entity_id | fan.purifier_and_humidifier | | Fan entity id |
| brightness | "25" | "0", "25", "50", "75", "100" | Device display light brightness|
##### fan.philips_air_purifier_coap_child_lock:


| Key | Example | Possible values | Description |
| --------- | --------------------------- | ---------------------- | ---------------- |
| entity_id | fan.purifier_and_humidifier | | Fan entity id |
| state | False | True, False | Child lock state |
## MQTT topic:
| Topic | Description |
| ---------------------------------------------- | --------------- |
| philips-air-purifier-coap/DEVICE_ID/attributes | Attributes json |
## MQTT topic sensor usage:
```yaml
sensor:
- platform: mqtt
state_topic: 'philips-air-purifier-coap/DEVICE_ID/attributes'
name: 'PM 2.5'
unit_of_measurement: 'Index'
icon: 'mdi:chart-line'
value_template: '{{ value_json.pm25 }}'
```
## Examples:
- [scripts.yaml configuration](https://github.com/adamcsk1/ha-philips-airpurifier-coap/blob/master/examples/scripts.yaml)
- [sensors.yaml configuration](https://github.com/adamcsk1/ha-philips-airpurifier-coap/blob/master/examples/sensors.yaml)
- [mqtt attributes json](https://github.com/adamcsk1/ha-philips-airpurifier-coap/blob/master/examples/mqtt_attributes.json)
## Known issues:
- The water level attribute only takes 0 or 100 values. (AC2729/50)
- The device may disconnect from the network, but reconnect again 5-10 minutes later.