PM1

The PM1 component handles electrical power metering capabilities. It uses PM1 as RPC namespace and provides the methods:

• PM1.SetConfig to update the component's configuration
• PM1.GetConfig to obtain the component's configuration
• PM1.GetStatus to obtain the component's status

PM1 components are identified with PM1:<id> in objects containing multiple component payloads.

Methods

PM1.SetConfig

Properties:

Property	Type	Description
id	number	Id of the PM1 component instance
config	object	Configuration that the method takes

Find more about the config properties in config section

PM1.GetConfig

Properties:

Property	Type	Description
id	number	Id of the PM1 component instance

Find the PM1.GetConfig response properties in config section

PM1.GetStatus

Properties:

Property	Type	Description
id	number	Id of the PM1 component instance

Find more about the status response properties in status section

Configuration

The configuration of the PM1 component contains information about the id and name of the component.

Property	Type	Description
id	number	Id of the PM1 component instance
name	string or null	Name of the PM1 instance

Status

The status of the PM1 component contains information about the measured variables. To obtain the status of the PM1 component its id must be specified.

Property	Type	Description
id	number	Id of the PM1 component instance
voltage	number	Last measured voltage in Volts
current	number	Last measured current in Amperes
apower	number	Last measured instantaneous active power (in Watts) delivered to the attached load
aprtpower	number	Last measured instantaneous apparent power (in Volt-Amperes) delivered to the attached load (shown if applicable)
pf	number	Last measured power factor (shown if applicable)
freq	number	Last measured network frequency (shown if applicable)
aenergy	object	Information about the active energy counter Property Type Description total number Total energy consumed in Watt-hours by_minute array of type number Energy consumption by minute (in Milliwatt-hours) for the last three minutes (the lower the index of the element in the array, the closer to the current moment the minute) minute_ts number Unix timestamp of the first second of the last minute (in UTC)
ret_aenergy	object	Information about the returned active energy counter Property Type Description total number Total returned energy consumed in Watt-hours by_minute array of type number Returned energy consumption by minute (in Milliwatt-hours) for the last three minutes (the lower the index of the element in the array, the closer to the current moment the minute) minute_ts number Unix timestamp of the first second of the last minute (in UTC)
errors	array of type string	Error conditions occurred. May contain power_meter_failure, out_of_range:voltage, out_of_range:current, out_of_range:aprtpower, out_of_range:apower(shown if at least one error is present)

Webhook Events

PM1 component supports conditional webhooks.

Events related to the PM1 component that can trigger webhooks:

• voltage_change - when the voltage has changed with at least 1V and 5% from the last reported value.
  • voltage_change event supports attributes, that can be used to compose conditional webhooks:

    Property	Type	Description
    voltage	number	New voltage in Volts

• current_change - when the current has changed with at least 0.05A and 5% from the last reported value.
  • current_change event supports attributes, that can be used to compose conditional webhooks:

    Property	Type	Description
    current	number	New current in Amps

• apower_change - when the active power has changed with at least 1W and 5% from the last reported value.
  • apower_change event supports attributes, that can be used to compose conditional webhooks:

    Property	Type	Description
    apower	number	New active power in Watts

Examples

PM1.SetConfig example

PM1.SetConfig HTTP GET Request

http://192.168.33.1/rpc/PM1.SetConfig?id=0&config={"name":"Meter"}

PM1.SetConfig Curl Request

curl -X POST -d '{"id":1,"method":"PM1.SetConfig","params":{"id":0,"config":{"name":"Meter"}}}' http://${SHELLY}/rpc

PM1.SetConfig Mos Request

mos --port ${PORT} call PM1.SetConfig '{"id":0,"config":{"name":"Meter"}}'

Response

PM1.SetConfig HTTP GET Response

{
  "restart_required": false
}

PM1.SetConfig Curl Response

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

PM1.SetConfig Mos Response

{
  "restart_required": false
}

PM1.GetConfig example

PM1.GetConfig HTTP GET Request

http://192.168.33.1/rpc/PM1.GetConfig?id=0

PM1.GetConfig Curl Request

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

PM1.GetConfig Mos Request

mos --port ${PORT} call PM1.GetConfig '{"id":0}'

Response

PM1.GetConfig HTTP GET Response

{
  "id": 0,
  "name": "PM1device"
}

PM1.GetConfig Curl Response

{
  "id": 1,
  "params": {
    "id": 0,
    "name": "PM1device"
  }
}

PM1.GetConfig Mos Response

{
  "id": 0,
  "name": "PM1device"
}

PM1.GetStatus example

PM1.GetStatus HTTP GET Request

http://192.168.33.1/rpc/PM1.GetStatus?id=0

PM1.GetStatus Curl Request

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

PM1.GetStatus Mos Request

mos --port ${PORT} call PM1.GetStatus '{"id":0}'

Response

PM1.GetStatus HTTP GET Response

{
  "id": 0,
  "voltage": 225.9,
  "current": 0,
  "apower": 0,
  "freq": 50,
  "aenergy": {
    "total": 11.679,
    "by_minute": [
      0,
      0,
      0
    ],
    "minute_ts": 1654511972
  },
  "ret_aenergy": {
    "total": 4.126,
    "by_minute": [
      0,
      0,
      0
    ],
    "minute_ts": 1654511318
  },
  "errors": [
    "power_meter_failure",
    "out_of_range:voltage",
    "out_of_range:current",
    "out_of_range:apower",
    "out_of_range:aprtpower"
  ]
}

PM1.GetStatus Curl Response

{
  "id": 1,
  "src": "shellyplus1pm-441793ce3f08",
  "params": {
    "id": 0,
    "voltage": 225.9,
    "current": 0,
    "apower": 0,
    "freq": 50,
    "aenergy": {
      "total": 11.679,
      "by_minute": [
        0,
        0,
        0
      ],
      "minute_ts": 1654511972
    },
    "ret_aenergy": {
      "total": 4.126,
      "by_minute": [
        0,
        0,
        0
      ],
      "minute_ts": 1654511318
    },
    "errors": [
      "power_meter_failure",
      "out_of_range:voltage",
      "out_of_range:current",
      "out_of_range:apower",
      "out_of_range:aprtpower"
    ]
  }
}

PM1.GetStatus Mos Response

{
  "id": 0,
  "voltage": 225.9,
  "current": 0,
  "apower": 0,
  "freq": 50,
  "aenergy": {
    "total": 11.679,
    "by_minute": [
      0,
      0,
      0
    ],
    "minute_ts": 1654511972
  },
  "ret_aenergy": {
    "total": 4.126,
    "by_minute": [
      0,
      0,
      0
    ],
    "minute_ts": 1654511318
  },
  "errors": [
    "power_meter_failure",
    "out_of_range:voltage",
    "out_of_range:current",
    "out_of_range:apower",
    "out_of_range:aprtpower"
  ]
}