pimatic-meross

meross plugin for Pimatic home automation system

Usage no npm install needed!

<script type="module">
  import pimaticMeross from 'https://cdn.skypack.dev/pimatic-meross';
</script>

README

pimatic-meross

Pimatic plugin for support of Meross devices

This plugin lets you control and get status info from a Meross devices. This version of the plugin supports the SmartPlug (mss210), SmartPlug with electricity reading (mss310) and the Garagedoor Opener (msg100).

After downloading the Meross app, you can register in the app with your email and password. After registration you can add your meross device(s) in the app, configure the wifi and other settings.

When these steps are done you can configure the pimatic-meross plugin.

Config of the plugin

{
  username: "The username of your Meross account"
  password: "The password of your Meross account"
  debug:    "Debug mode. Writes debug messages to the Pimatic log, if set to true."
}

Config of a Meross device

Meross devices are added via the discovery function. The automatic generated information must not change. Its the unique reference to your meross device. You can change the Pimatic device name after you have saved the device. This is the only device variable you may change! The following data is automatically generated on device discovery and should not be changed!

{
  region: "The region"
  devIconId: "The device icon"
  fmwareVersion: "The firmware version number"
  hdwareVersion: "The hardware version number"
}

Garagedoor Opener (msg100)

The following variables (attributes) are available in the gui / pimatic.

<deviceId>.deviceStatus:      "If the device is online or offline"
<deviceId>.garagedoorStatus:  "Actual status of the garagedoor (open or closed)"

The garagedoor is opened and closed via buttons in the gui or via rules. The rules action syntax is:

meross <garagedoor-device-id> [open|close]

Smartplug (mss210)

The following variables (attributes) are available in the gui / pimatic.

<deviceId>.deviceStatus:  "If the device is online or offline"
<deviceId>.state:         "Actual stateof the Smartplug switch (on or off)"

The smartplug is switched on or off via the gui, rules or the api. If the button on the smartplug is toggled (swithed on or off) the switch in pimatic will also toggle.

Smartplug with electricity readings (mss310)

The following variables (attributes) are available in the gui / pimatic.

<deviceId>.deviceStatus:  "If the device is online or offline"
<deviceId>.state:         "Actual state of the Smartplug switch (on or off)"
<deviceId>.voltage:       "Actual voltage of the Smartplug"
<deviceId>.current:       "Actual current usage of the Smartplug"
<deviceId>.power:         "Actual power of the the Smartplug"
<deviceId>.consumption:   "The (daily) power consumption of the Smartplug"

The smartplug is switched on or off via the gui, rules or the api. If the button on the smartplug is toggled (swithed on or off) the switch in pimatic will also toggle.

You could backup Pimatic before you are using this plugin!

The minimum requirement for this plugin is node v8!