homebridge-meross

Added

• Hybrid Mode
  • This mode can be turned on from the 'Optional Settings' section of the config
  • If a local IP for a cloud device is provided by Meross, then the plugin will attempt to control the device locally. If this fails for any reason then the request will be sent via the cloud as before
  • I would eventually like to remove this option and have this hard-coded as the way the plugin works, but I don't want to make a breaking change for now
• New Devices
  • MSL100R added to supported list
  • MSL120DR added to supported list
  • MSS120B added to supported list
• All Devices
  • Set a user key per device, can be useful if the device is registered to a different Meross account that defined in the 'Optional Settings'
  • Initial device information will be displayed in the log when an accessory initialises and debug mode is on
• Eve History
  • On/Off history graphs added for single and multi-channel devices when exposed as Switch

Changed

• All Devices
  • Option to disable polling has been removed in order to keep cloud device IPs up to date. Cloud and local polling now has a maximum interval of 10 minutes, and if option is set to 0 then this will be increased to 10 minutes.
  • Cloud device IP will now be checked and updated if necessary on every poll run
• Multi-Channel Devices
  • Meross channel names will be used for sub-accessories if provided by cloud
• Garage Devices
  • ⚠️ MSG200 will now show a separate garage door accessory for the three available channels, you can use the configuration to hide any of the channels you don't use or don't want visible in Homebridge
  • For local devices, when closing garage via HomeKit, the plugin will poll every 3 seconds for status update until either the garage has closed or 15 seconds after the configured operation time when the garage will be marked as open again
• Plugin UI
  • Credentials settings moved out of 'Optional Settings' section
  • Some unnecessary placeholders removed
• Platform Versions
  • Recommended node version bumped to v14.17.5

Fixed

• All Devices
  • Plugin did not use default cloudRefreshRate or refreshRate if not configured by the user
• Multi-Channel Devices
  • Information like firmware, IP and mac address will now show properly in the Homebridge UI, sometimes this info would not be properly saved by the plugin
  • Hidden sub-accessories will no longer be added as hidden Homebridge accessories

Removed

• Plugin UI
  • Device URL and firmware override options for 'Sensor Devices', at least temporarily, whilst local mode is not supported for the MSH300

Added

• New Devices
  • MSS560X added to supported list

Added

• New Devices
  • MSS110R added to supported list
  • MSS510H added to supported list

Changed

• Changed 'Manufacturer' from 'Meross' to 'Meross Technology'
  • This should fix future cases of false 'firmware update' alerts
  • Existing accessories will need to be removed from the cache so they are re-added with this new manufacturer
• Diffusers & Light Devices
  • Removed cloud polling force override as real-time updates are now available for these devices
• Configuration
  • The model field in the device sections will only show for local devices (not needed for cloud devices)

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

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

Fixed

• An issue preventing local devices from initialising

Added

• Homebridge UI
  • More information on the devices tab: connection status, IP address, MAC address and hardware & firmware version
• New Devices
  • Experimental 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

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

Changes

• Housekeeping and updated dependencies.

Changes

• Fixed an issue where MSL-120 payload fails to be read.
• Updated dependencies.

Changes

• Fixes 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.

Breaking Changes

• The Plugin has been changed from an accessory type to a platform type.
• You will have to change your 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/donavanbecker/homebridge-meross/wiki/Specific-Model-Configurations] Wiki for more examples.
  • Example:

  Before:

  "accessories": [
      {
        "model": "MSS620",
        "name": "Outlet",
        "deviceUrl": "192.168.1.1",
        "channel": 0,
        "messageId": "abcdefghijklmnopqrstuvwxyz123456789",
        "timestamp": 123456789,
        "sign": "abcdefghijklmnopqrstuvwxyz123456789",
        "accessory": "Meross"
      }
  ]
  

  After:

  "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 too often can be set in the config.

Changes

• Fixes a bug that does not retrieve the status of an outlet device.

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.

Changes

• Adding in MSL-320

Changes

• 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!

Changes

• Add option to change accessory Firmware Revision and Serial Number.
  • This fixes #121 - HomeKit showing as "Update Available".

Changes

• 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.

Changes

• Added basic support for MSL-100, MSL-120.

Changes

• 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.

Changes

• Added brightness changing support to the MSS560 switch.