Local Control

The plugin can control supported devices on your local network without the need for your Meross credentials in the configuration.

It is recommended to give your devices fixed IPs from your router.

Benefits of Local Control (over cloud control)

• Privacy - you can block your devices from the internet and they will continue to function with Homebridge
• Stability - if your internet connection goes down or there is a cloud outage, your devices will continue to work

Benefits of Cloud Control (over local control)

• Easier setup - no need to enter the device's IP in the configuration
• Remote devices - device does not need to be on the same network as Homebridge
• Real-time updates - if a device is controlled outside of Homebridge (e.g. physically) then the change will appear instantly in HomeKit (no need for polling unlike local control)

Version 6 & Above

The plugin uses an account 'user key' which is linked to your Meross account. The devices must have been setup in the Meross app logged into this account.

Note from v5
This version of the plugin removes the need to find the messageId, timestamp, and sign - the user key now generates these

User Key Setup

• If you have configured your Meross username and password into the plugin then the plugin will already have access to this 'key' so no action is needed
• If you don't have your Meross username and password configured then you need to find and configure this key manually
  • Easier Method: You can find this key by enabling plugin debug mode on a beta version and entering your Meross username and password into the configuration once. Restart the plugin and your 'key' will be shown in the log. You can then remove your Meross username and password from the configuration again and enter the key.
  • Harder Method: You can see the structure of the HTTP request the plugin uses and you can use this to mimic your own HTTP request

Device Setup

• In the 'Device Settings' section of the configuration, add an entry for each of your devices to control locally
• In the 'Connection Type' field, select 'Force Local Control' and enter the local IP address of the device e.g. 192.168.1.23 into the field that will appear below, you also need to set the model and optionally the firmwareRevision

Version 5 & Below

You need to find the name, deviceUrl, channel, messageId, timestamp, and sign of a device you wish to control locally.

If you're setting this plug up fresh, make sure you go through the typical Meross app for the initial setup.

HTTP Catcher

• Download and Install HTTP Catcher.
• Click Configure and then Allow to setup/enable VPN.
• Then Click Start to start collecting requests.
• You will now go into the meross app and turn on the outlet that you want to first setup.
• Return to the HTTP Catcher App, Search for the IP Address of your meross plug in Search URL.
• You will see an application/json Post to /config, with a 200 Response.
• Click into that and hit Response header.
• From there you will find the sign,timestamp, and messageId.