homebridge-meross

# Change Log All notable changes to homebridge-meross will be documented in this file. ## 6.3.0 (2021-08-03) ### Added - **Configuration** - The plugin settings screen now splits up the 'Device Settings' into different sections - You should consider moving the entries from the 'Devices Settings' section (at the bottom) to the appropriate section above - No breaking change has been made, but in a future version of the plugin I would like to remove the general 'Device Settings' section - Extra configuration options that have been added in this release and in the future will only appear in the specific section to the device type, not the previous 'Device Settings' section - **All Devices** - Plugin will log the user-configurable options and values per accessory when devices are initialised on startup - **Single-Channel Devices** - Added option to expose as an `AirPurifier` homekit accessory type (nice to look at in the home app if by chance you have a purifier connected to an outlet) - **Light Devices** - Added 'Brightness Step' option to specify a step-size on the brightness slider - Added 'Adaptive Lighting Shift' option to specify a mired-shift, also can be used to remove the adaptive lighting feature - **Diffuser Devices** - Added 'Brightness Step' option to specify a step-size on the brightness slider - **New Devices** - MSL320M added to supported list - MSS550L added to supported list - MPD100 (re)added to supported list as a dimmer device - Support for MS100 sensor/humidity devices via the MSH300 - Note that cloud connection is necessary to obtain a subdevice list for the hub ### Changed - **Light Devices** - Plugin will update status (when controlled externally) in real time for cloud devices - **Diffuser Devices** - Plugin will update status (when controlled externally) in real time for cloud devices - Set logging level back to user-defined now that it's working ### Fixed - **Light Devices** - Fixed a `this.colourUtils.mr2hk is not a function` issue ## 6.2.0 (2021-08-01) ### Added - **All Devices** - Device online/offline status in the Homebridge log - Plugin will show a local device as offline in the plugin ui if the polling has failed due to timeout or `EHOSTUNREACH` (unreachable, normally means the device has lost wifi connection) - **Diffusers** - Switch between 'colour', 'rainbow' and 'temperature' modes using Eve-only characteristics (create scenes in the Eve app that will appear in the Home app) - **Single-Channel Outlets** - Plugin will now poll every minute for power data for devices that offer this feature (plugin will attempt to check automatically) - Current wattage and voltage is available to see in the Eve app - Plugin will set the HomeKit 'In Use' status to 'Yes' if the outlet is on and the wattage is above a configurable value - This can be useful to setup automations in the Eve app based on whether the wattage has risen above or dropped below a certain value ### Changed - **Configuration** - Plugin will disable if neither of username & password nor user key has been configured - Device `connection` setting has been removed, plugin will instead check for a configured `deviceUrl` to determine connection mode - **Light Devices** - ⚠️ On/Off light switches will now be exposed as a `Switch` accessory type (you can change to show it as a light in the Home app, or a fan for the sake of it!) ### Fixed - **Multi-Channel Outlets** - An issue preventing multi-channel devices from updating from polled data when exposed as outlets - The Homebridge UI will now show the correct status for sub-accessories of a multi-channel device - **Light Devices** - Reinstate 'lost' support for MSL120B - **Diffusers** - Bugfixes for MOD-100 ## 6.1.1 (2021-07-29) ### Fixed - An issue preventing local devices from initialising ## 6.1.0 (2021-07-29) ### Added - **Homebridge UI** - More information on the devices tab: connection status, IP address, MAC address and hardware & firmware version - **New Devices** - Initial support for the MOD-100 diffuser - only light control at this stage - **Configuration** - Plugin will now check for duplicate device ID entries in the config and ignore them ### Changed - ⚠️ **Platform Versions** - Recommended node version bumped to v14.17.4 - Recommended homebridge version bumped to v1.3.4 - **Single Channel Devices** - The plugin will try to auto detect whether 'Toggle' or 'ToggleX' namespace is used ## 6.0.0 (2021-07-28) ### Important Note - This new release changes the way that locally controlled devices are managed/configured - It also brings in the functionality of `homebridge-meross-cloud` plugin - When updating from v5, your HomeKit accessories will most likely be reset (due to config changes) - It is recommended to use the Homebridge/HOOBS UI to reconfigure your locally controlled devices - See the full change log below for more details ### Added - **Cloud Control** - Support for cloud devices (bringing the functionality of `homebridge-meross-cloud` into this plugin) - Device MQTT connections so any external changes to devices should be reflected in HomeKit in real time - This makes cloud polling no longer necessary, so is now disabled by default, you can re-enable this in the plugin settings - **Local Control** - The use of an account key for local device control - The key will automatically be obtained if your Meross credentials are present - Docs to find this account key are available in the wiki - The use of this account key makes the device `messageId`, `sign` and `timestamp` redundant and these options have been removed - It is necessary to also configure the serial number (uuid) per the device in the configuration - **⚠️ Your local devices will not work with this version unless you configure the account key and serial number (uuid)** - **New Devices** - MSG100 cloud support added - MRS100 cloud and local support added - **Adaptive Lighting** - Adaptive Lighting for supported lightbulbs - **Logging** - Logging level on a per-accessory basis, which can be helpful when wanting to debug a specific accessory - **Configuration Validation** - More configuration validation, logging if you have entries that are incorrectly configured or unused - **No Response Label** - Promise-based device control, so the plugin should show a device as 'No Response' if controlling an accessory has failed ### Changed - ⚠️ All switch/outlet devices will be now exposed to HomeKit by default as a `Switch` (both cloud and local devices) - A new configuration setting has been added if you prefer for your device to be exposed as an `Outlet` - ⚠️ Cloud multi-channel devices will now appear as separate accessories - An extra 'All On/Off' accessory will be shown in HomeKit - You can use the 'Hide Channels' setting to hide channels you don't use, including the 'All On/Off' accessory ## 5.0.3 (2021-06-15) ### Changed - Housekeeping and updated dependencies. ## 5.0.2 (2020-03-25) ### Changed - Fixed an issue where MSL-120 payload fails to be read. - Updated dependencies. ## 5.0.1 (2020-03-19) ### Changed - Fixed an issue with `config.schema.json` where it wouldn't save changes to `refreshRate`. - Added the ability to enter a custom value for `garageDoorOpeningTime`. - Updated dependencies. ## 5.0.0 (2021-03-14) ### Breaking Changes - The Plugin has been been changed from an `accessory` type to a `platform` type. - You will have to change you config completely if you update to this version. - You can take your current `accessory` and move it to the platform config. - See (Specific Model Configurations)[https://github.com/homebridge-plugins/homebridge-meross/wiki/Specific-Model-Configurations] Wiki for more examples. - Example: #### Before: ```json "accessories": [ { "model": "MSS620", "name": "Outlet", "deviceUrl": "192.168.1.1", "channel": 0, "messageId": "abcdefghijklmnopqrstuvwxyz123456789", "timestamp": 123456789, "sign": "abcdefghijklmnopqrstuvwxyz123456789", "accessory": "Meross" } ] ``` #### After: ```json "platforms": [ { "name": "Meross", "devices": [ <This_is_from_above> { "model": "MSS620", "name": "Outlet", "deviceUrl": "192.168.1.1", "channel": 0, "messageId": "abcdefghijklmnopqrstuvwxyz123456789", "timestamp": 123456789, "sign": "abcdefghijklmnopqrstuvwxyz123456789", "accessory": "Meross" <You_Can_Remove_This.> } <Ends_here_from_above> ], "platform": "Meross" } ] ``` - Added Config for Refresh Rate. - default is 5 seconds and if updating to often can be set in the config. ## 4.0.1 (2020-03-12) ### Changed - Fixes a bug that does not retrieve the status of an outlet device. ## 4.0.0 (2021-03-02) ### Major Changes - Homebridge support has moved to v1.3.1 - Homebridge v1.3.1 must be installed before updating to this version. - Support for the new onGet/onSet introdcued in Homebridge v1.3.0. ### Changed - Adding in MSL-320 ## 3.5.0 (2021-02-13) ### Changed - Add support for MSL-420 (#167), Thanks @123marvin123! - Fixed MSS110-1 and MSS110-2 Type Error (#170), Thanks @MrJer! - Adds support for MSS630 device (#196), Thanks @rcoletti116! ## 3.4.1 (2020-12-19) ### Changed - Add option to change accessory `Firmware Revision` and `Serial Number`. - This fixes [#121](https://github.com/homebridge-plugins/homebridge-meross/issues/121) - `HomeKit showing as "Update Available"`. ## 3.4.0 (2020-11-19) ### Changed - Add preliminary support for MSG200. - Minor changes to support channels with the garage door opener, has been tested with the MSG100 and MSG200. - The MSG100 uses channel 0, for the single door, but the MSG200 uses channels 1, 2, and 3. - FWIW, setting channel 0 on the MSG200 to open or closed appears to control all doors. ## 3.3.0 (2020-11-06) ### Changed - Added basic support for MSL-100, MSL-120. ## 3.2.0 (2020-10-15) ### Changed - Added support for the MSS530H. - You set an ChannelID 1, 2 or 3. - Channel 1 is the Top Outlet. - Channel 2 the bottom left. - Channel 3 the bottom right. ## 3.1.0 (2020-10-02) ### Changed - Added brightness changing support to the MSS560 switch. ## 3.0.0 (2020-09-17) ### Changed - Converted Project to Typescript. ## 2.3.1 (2020-07-21) ### Changed - Change garage door status check interval to 5s. ## 2.3.0 (2020-06-22) ### Changed - Get garage door status change notification by requesting status every 2s all the time. (#41) Thanks CocoaBob! ## 2.2.0 (2020-06-16) ### Changed - Add support for garage door opening time parameter. (#36) Thanks CocoaBob! ## 2.1.0 (2020-04-13) ### Changed - Changed Log to only display On & Off States. - Compressed all other logging to debug. - To View This logging, turn on Homebridge Debug (-D) in Homebridge Settings of Config UI X. ## 2.0.0 (2020-05-27) ### Changed - added Support for MSG-100 (Garage Door Opener). ## IMPORTANT ### Homebridge v1.0.0 - Changed homebridge requirement to be v1.0.0 or higher. ## 1.1.0 (2020-04-13) ### Changed - Update config.schema.json with specific models that are supported. - Changed requirements for specific models on what fields are needed. - Added helpful wiki links to repo # IMPORTANT ### Change to Config Needed! - We have replaced the `hardware revision` with `model`. - We also changed the `deviceUrl` to only require the device IP Address. - You will have to change your config to match the new config.schema.json layout. ## 1.0.4 (2020-04-13) ### Changed - fix config.schema.json ## 1.0.3 (2020-04-13) ### Changed - fix config.schema.json - update engine dependencies ## 1.0.2 (2020-04-11) ### Changed - remove devDependencies homebridge-config-ui-x and homebridge - update engine dependencies ## 1.0.1 (2020-04-08) ### Changed - Update devDependencies homebridge-config-ui-x and homebridge ## 1.0.0 (2020-04-06) ### Changed - Update Readme ## 0.1.0 (2020-03-21) ### Changed - Bump request from 2.88.0 to 2.88.2 [#8](https://github.com/homebridge-plugins/homebridge-meross/pull/8) ## 0.0.8 (2020-01-30) ### Changed - Fixed config.schema.json ## 0.0.7 (2020-01-30) ### Changed - Update dependencies ## 0.0.6 (2020-01-30) ### Changed - Allowing for multiple devices.