Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/haywirecoder/homebridge-frigidaire-dehumidifier
Homebridge Frigidaire Dehumidifier
https://github.com/haywirecoder/homebridge-frigidaire-dehumidifier
Last synced: 2 months ago
JSON representation
Homebridge Frigidaire Dehumidifier
- Host: GitHub
- URL: https://github.com/haywirecoder/homebridge-frigidaire-dehumidifier
- Owner: haywirecoder
- License: mit
- Created: 2022-09-12T02:40:54.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-05-11T14:10:42.000Z (8 months ago)
- Last Synced: 2024-10-31T18:12:46.429Z (3 months ago)
- Language: JavaScript
- Size: 122 KB
- Stars: 4
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://www.npmjs.com/package/homebridge-frigidaire-dehumidifier)
[](https://github.com/homebridge/homebridge/wiki/Verified-Plugins)
# Homebridge Plug-In for Frigidaire Dehumidifier
An Homebridge plug-in to integrate the Frigidaire's connected dehumidifier with HomeKit. It monitors and control devices via the Frigidaire unofficial cloud API. Thanks to the Frigidaire Python API https://github.com/bm1549/frigidaire developers and https://github.com/karlg100/frigidaire , this module uses logic and code gain from reviewing those works.
Frigidaire updated their API to v3 in June 2023 and deprecated v2 in February 2024, meaning the plug-in engine had to be re-written. Upgrade to version 2+ may impact previous automation or setting. This is a one time event to support Frigidaire v3 API.
## Limitation:
* This module will poll for the status of the various components based frequency provided in the configuration file. No realtime notification is provided.
## Configuration options
| Attributes | Description |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------ |
| username | Frigidaire username. This is a required value. |
| password | Frigidaire password. This is a required value. |
| deviceRefresh | Polling interval to obtain status of Frigidaire appliance, provided in seconds. Default to 90 seconds, this is an optional value. Please note: Small values may cause account lock or frequent API errors. |
| dehumidifierMode | Homekit only has two mode dehumidifying modes "Auto" and "Dehumidifying". When "Dehumidifying" is selected in Homekit the selection is map to a specific Frigidaire appliance mode: "Quiet", "Dry" or "Continuous".
Valid string values are the following:
"Dry"
"Continuous"
"Quiet"
The default mode for is Frigidaire "Dry" mode. This an optional value.
| enableAirPurifier | Create additional tile for Air purifier/Ionizer functionality. Default to true, this is an optional value.
| excludedDevices | Devices IDs to suppress from HomeKit. The device IDs can be obtain from Homebridge logs at startup of this plug-in. This is an optional value. | |
## 💧 Note: Dehumidifier Relative Humidity
There is a difference between Frigidaire App and Homebridge/HomeKit for relative humidity.
HomeKit Relative Humidity work between 0%-100% (By design). Here is translation between Frigidaire and Homekit.
| Frigidaire | HomeKit |
| --- | --- |
| 35% | 0% |
| 40% | 10% |
| 45% | 20% |
| 50% | 30% |
| 55% | 40% |
| 60% | 50% |
| 65% | 60% |
| 70% | 70% |
| 75% | 80% |
| 80% | 90% |
| 85% | 100% |
Example configuration is below, with Frigidaire dehumidifier mode set to Quiet mode for dehumidifying and Air purifier/Ionizer set to display in Homekit.
```javascript
...
"platforms": [
{
"name": "FrigidaireAppliance",
"auth": {
"username": "",
"password": ""
},
"deviceRefresh": 90,
"dehumidifierMode": "Quiet",
"enableAirPurifier": true,
"platform": "FrigidaireAppliance"
}
...]