Shelly Plug PM

Shelly Plug PM Gen3 is a single-phase electrical power metering device with only one current channel of measurement. The device measures the consumed energy from the system. In addition, the device features built-in LEDs indicating the power consumption and the status of the network connectivity.

The following components are available in Shelly Plug PM Gen3:

• System
• WiFi
• Bluetooth Low Energy
• Cloud
• MQTT
• Outbound Websocket
• PM1
• PLUGPM_UI
• Virtual components
• BTHome components
• Matter
• Up to 10 instances of Script

PLUGPM_UI

The PLUGPM_UI component handles the settings of a Plug PM Gen3 device's LEDs.

Methods

PLUGPM_UI.SetConfig

Properties:

Property	Type	Description
config	object	Configuration that the method takes

Find more about the config properties in config section

PLUGPM_UI.GetConfig

Find the PLUGPM_UI.GetConfig response properties in config section

PLUGPM_UI.GetStatus

Find more about the status response properties in status section

Configuration

The configuration of the PLUGPM_UI component allows you to set the color mode of the LEDs (power/switch/off).

Property	Type	Description
leds	object	PLUGPM_UI LED configuration	mode	string	LED indication mode Value Description power LED indication according to the power consumption switch LED indication according to the user-defined values for output state on off disabled LED indication	colors	object	LED colors and brightness in RGB format Property Type Description pm1:0 object PM1 component instance on object LED colors for output state on Property Type Description rgb array of numbers or null Value for red, green and blue [0-100] brightness number Value for brightness [0-100]
power	object	LED brightness for LED indication mode power Property Type Description brightness number Value for brightness [0-100]

night_mode

object

LED brightness in night mode

Property	Type	Description
enable	boolean	Enable or disable night mode
brightness	number	Value for brightness [0-100]
active_between	array of 2 elements of type string for start of the period and end of the period in format HH:MM	Value for strings [00:00-23:59]

Status

The PLUGPM_UI component does not own any status properties.

Examples

PLUGPM_UI.GetStatus example

PLUGPM_UI.GetStatus HTTP GET Request

http://192.168.33.1/rpc/PLUGPM_UI.GetStatus

PLUGPM_UI.GetStatus Curl Request

curl -X POST -d '{"id":1,"method":"PLUGPM_UI.GetStatus"}' http://${SHELLY}/rpc

PLUGPM_UI.GetStatus Mos Request

mos --port ${PORT} call PLUGPM_UI.GetStatus

Response

PLUGPM_UI.GetStatus HTTP GET Response

{}

PLUGPM_UI.GetStatus Curl Response

{
  "id": 1,
  "params": {}
}

PLUGPM_UI.GetStatus Mos Response

{}

PLUGPM_UI.GetConfig example

PLUGPM_UI.GetConfig HTTP GET Request

http://192.168.33.1/rpc/PLUGPM_UI.GetConfig

PLUGPM_UI.GetConfig Curl Request

curl -X POST -d '{"id":1,"method":"PLUGPM_UI.GetConfig"}' http://${SHELLY}/rpc

PLUGPM_UI.GetConfig Mos Request

mos --port ${PORT} call PLUGPM_UI.GetConfig

Response

PLUGPM_UI.GetConfig HTTP GET Response

{
  "leds": {
    "mode": "power",
    "colors": {
      "pm1:0": {
        "on": {
          "rgb": [
            0,
            100,
            0
          ],
          "brightness": 100
        }
      },
      "power": {
        "brightness": 100
      }
    },
    "night_mode": {
      "enable": false,
      "brightness": 10,
      "active_between": [
        "22:00",
        "06:00"
      ]
    }
  }
}

PLUGPM_UI.GetConfig Curl Response

{
  "id": 1,
  "params": {
    "leds": {
      "mode": "power",
      "colors": {
        "pm1:0": {
          "on": {
            "rgb": [
              0,
              100,
              0
            ],
            "brightness": 100
          }
        },
        "power": {
          "brightness": 100
        }
      },
      "night_mode": {
        "enable": false,
        "brightness": 10,
        "active_between": [
          "22:00",
          "06:00"
        ]
      }
    }
  }
}

PLUGPM_UI.GetConfig Mos Response

{
  "leds": {
    "mode": "power",
    "colors": {
      "pm1:0": {
        "on": {
          "rgb": [
            0,
            100,
            0
          ],
          "brightness": 100
        }
      },
      "power": {
        "brightness": 100
      }
    },
    "night_mode": {
      "enable": false,
      "brightness": 10,
      "active_between": [
        "22:00",
        "06:00"
      ]
    }
  }
}

PLUGPM_UI.SetConfig example

PLUGPM_UI.SetConfig HTTP GET Request

http://192.168.33.1/rpc/PLUGPM_UI.SetConfig?config={"leds":{"mode":"switch","colors":{"pm1:0":{"on":{"rgb":[100,100,0],"brightness":100}},"power":{"brightness":100}},"night_mode":{"enable":true,"brightness":10,"active_between":["22:00","06:00"]}}}

PLUGPM_UI.SetConfig Curl Request

curl -X POST -d '{"id":1,"method":"PLUGPM_UI.SetConfig","params":{"config":{"leds":{"mode":"switch","colors":{"pm1:0":{"on":{"rgb":[100,100,0],"brightness":100}},"power":{"brightness":100}},"night_mode":{"enable":true,"brightness":10,"active_between":["22:00","06:00"]}}}}}' http://${SHELLY}/rpc

PLUGPM_UI.SetConfig Mos Request

mos --port ${PORT} call PLUGPM_UI.SetConfig '{"config":{"leds":{"mode":"switch","colors":{"pm1:0":{"on":{"rgb":[100,100,0],"brightness":100}},"power":{"brightness":100}},"night_mode":{"enable":true,"brightness":10,"active_between":["22:00","06:00"]}}}}'

Response

PLUGPM_UI.SetConfig HTTP GET Response

{
  "restart_required": false
}

PLUGPM_UI.SetConfig Curl Response

{
  "id": 1,
  "params": {
    "restart_required": false
  }
}

PLUGPM_UI.SetConfig Mos Response

{
  "restart_required": false
}