Releases: regaw-leinad/homebridge-winix-purifiers
v2.1.2
What's Changed
- Add alternate Winix mapping for good air quality by @regaw-leinad in #26
Full Changelog: v2.1.1...v2.1.2
v2.1.1
v2.1.0
What’s New?
Your Winix account token will automatically refresh in the background, meaning you no longer need to log in every 30 days to keep your air purifiers connected.
Key Features:
- Automatic Token Refresh: Once logged in, the plugin will handle the token renewal in the background. No more interruptions or manual re-authentication.
- Encrypted Password and Token Storage: Your account password and refresh token are securely stored on disk using encryption.
Important Details:
- You’ll need to re-authorize your Winix account after updating to this version. This one-time step is required since we now securely store your password for the automatic token refresh process.
- Set your own encryption key: I strongly recommend setting the
WINIX_ENCRYPTION_KEY
environment variable when you start homebridge to your own custom encryption key to keep your stored data secure. If you don't set this, the plugin will use a default static key, which is less secure. - If you're configuring the plugin manually or using HOOBS, check out the new
encrypt-password
script to securely store your password in the config file.
Please share your feedback or report any issues you encounter 😅
PRs
- Save passwords instead of refresh tokens by @regaw-leinad in #20
Full Changelog: v2.0.4...v2.1.0
v2.1.0-beta.0
What’s New?
In this beta version, your Winix account token will automatically refresh in the background, meaning you no longer need to log in every 30 days to keep your air purifiers connected.
Key Features:
- Automatic Token Refresh: Once logged in, the plugin will handle the token renewal in the background. No more interruptions or manual re-authentication.
- Encrypted Password and Token Storage: Your account password and refresh token are securely stored on disk using encryption.
Important Beta Details:
- You’ll need to re-authorize your Winix account after updating to this beta version. This one-time step is required since we now securely store your password for the automatic token refresh process.
- Set your own encryption key: I strongly recommend setting the
WINIX_ENCRYPTION_KEY
environment variable when you start homebridge to your own custom encryption key to keep your stored data secure. If you don't set this, the plugin will use a default static key, which is less secure. - If you're configuring the plugin manually or using HOOBS, check out the new
encrypt-password
script to securely store your password in the config file.
Please give it a try and share your feedback or report any issues you encounter 😅
Full Changelog: v2.0.4...v2.1.0-beta.0
v2.0.4
Bugfix
- Fixed usage of ambient light level triggering a characteristic warning at min value
Full Changelog: v2.0.3...v2.0.4
v2.0.3
New Features
- Sleep Switch Exposure: Added a new configuration option
exposeSleepSwitch
to allow users to expose a sleep switch in HomeKit.
Enhancements
- Rotation Speed Adjustment Debounce: Implemented a 500ms debounce for setting the rotation speed to prevent rapid sending of commands that could overwhelm the device or lead to unintended behavior.
Bugfixes
- Rotation Speed for Sleep Mode: Corrected the rotation speed representation for the sleep mode from 0 to 1, ensuring correct behavior when the purifier is set to sleep mode.
- Airflow Handling in SetRotationSpeed: Updated the
setRotationSpeed
function to gracefully handle a state of 0 by not attempting to set the airflow, which is interpreted as a signal to turn off the purifier. - Auto Switch State: Fixed the value when setting the auto switch
Full Changelog: v2.0.1...v2.0.3
v2.0.1
Important!! DO NOT UPDATE DIRECTLY FROM v1.x.x!!
Critical Migration Steps
If you are updating from version 1.x.x to 2.0.0, it is crucial to follow the specific migration instructions available in the Wiki (below). Do not apply this update through Homebridge as usual.
Migrating from v1.x.x to v2.x.x
v2.0.0 Release Notes
Homebridge Plugin Architecture Change
- Dynamic Platform Plugin: The plugin architecture has changed from the legacy "Accessory Plugin" to a "Dynamic Platform Plugin". This new architecture allows the plugin to add and remove devices at runtime, without the user having to make configuration changes and restarting Homebridge.
Dynamic Device Discovery
- Automatically Discovers Devices: The plugin now dynamically discovers and configures your Winix air purifiers directly from your linked Winix account, eliminating the need for manual device entry - just link your Winix account in the setup.
- Automatic Device Updates: Keeps your devices up to date within Homebridge based on a user-defined interval, ensuring that any changes in your Winix account (like adding or removing devices) are accurately reflected.
Filter Management Features
- Filter Life Monitoring: You can now monitor the filter life of your purifiers directly from the Home app, giving you a clear view of your filter's usage and remaining lifespan.
- Filter Replacement Alerts: The plugin will alert you when it's time to replace your purifier's filter, helping you maintain optimal air quality and device performance.
Other Noteworthy Features
- Custom Device Naming: Customize the names of your devices and their associated properties
- Enhanced API Stability: Improved error handling and communication stability with Winix devices
- Fix ambient light value by @regaw-leinad in #12
- v2.0.0 - Dynamic Platform Plugin by @regaw-leinad in #10
Full Changelog: v1.4.4...v2.0.1
v2.0.0
Important!! DO NOT UPDATE DIRECTLY FROM v1.x.x!!
Critical Migration Steps
If you are updating from version 1.x.x to 2.0.0, it is crucial to follow the specific migration instructions available in the Wiki (below). Do not apply this update through Homebridge as usual.
Migrating from v1.x.x to v2.x.x
v2.0.0 Release Notes
Homebridge Plugin Architecture Change
- Dynamic Platform Plugin: The plugin architecture has changed from the legacy "Accessory Plugin" to a "Dynamic Platform Plugin". This new architecture allows the plugin to add and remove devices at runtime, without the user having to make configuration changes and restarting Homebridge.
Dynamic Device Discovery
- Automatically Discovers Devices: The plugin now dynamically discovers and configures your Winix air purifiers directly from your linked Winix account, eliminating the need for manual device entry - just link your Winix account in the setup.
- Automatic Device Updates: Keeps your devices up to date within Homebridge based on a user-defined interval, ensuring that any changes in your Winix account (like adding or removing devices) are accurately reflected.
Filter Management Features
- Filter Life Monitoring: You can now monitor the filter life of your purifiers directly from the Home app, giving you a clear view of your filter's usage and remaining lifespan.
- Filter Replacement Alerts: The plugin will alert you when it's time to replace your purifier's filter, helping you maintain optimal air quality and device performance.
Other Noteworthy Features
- Custom Device Naming: Customize the names of your devices and their associated properties
- Enhanced API Stability: Improved error handling and communication stability with Winix devices
- v2.0.0 - Dynamic Platform Plugin by @regaw-leinad in #10
Full Changelog: v1.4.4...v2.0.0
v2.0.0-beta.6
Documentation
- Brought the README up to date with latest details
- Added Wiki pages for
Other
- Refactored Winix device handling for getting and setting attribute values
- Fix an issue referencing
hap-nodejs
types
Full Changelog: v2.0.0-beta.4...v2.0.0-beta.6
v2.0.0-beta.5
Documentation
- Brought the README up to date with latest details
- Added Wiki pages for
Other
- Refactored Winix device handling for getting and setting attribute values
Full Changelog: v2.0.0-beta.4...v2.0.0-beta.5