Skip to content

Shelly

STABLE NYMEA CONSUMER

Connection: LOCAL

Use Shelly devices with nymea.

Installation guide coming soon.

Reference

Application labels

The keys and labels below are the ones the application shows, in English. They are left verbatim so that you find them word for word on screen.

Manufacturer: Shelly
Plugin: shelly

Supported models

Model Role Transport Pairing Quantities
Shelly 1 gateway, update — Auto-discovery 6
Shelly Plus 1 gateway, update — Auto-discovery 6
Shelly 1PM gateway, Consumption meter, update — Auto-discovery 8
Shelly Plus 1PM gateway, Consumption meter, update — Auto-discovery 8
Shelly Pro 1PM gateway, Consumption meter, update — Auto-discovery 8
Shelly 1L gateway, Consumption meter, update — Auto-discovery 8
Shelly 2 gateway, update — Auto-discovery 7
Shelly 2.5 gateway, update — Auto-discovery 7
Shelly Plus 2PM gateway, update — Auto-discovery 7
Shelly Plus Plug S/US/UK/IT powersocket, Consumption meter, update — Auto-discovery 8
Shelly Plug/PlugS powersocket, Consumption meter, update — Auto-discovery 8
Shelly RGBW2 colorlight, update — Auto-discovery 11
Shelly Dimmer (2) / Vintage dimmablelight, update — Auto-discovery 8
Shelly button 1 longpressmultibutton, battery, update — Auto-discovery 7
Shelly I3 longpressmultibutton, update — Auto-discovery 8
Shelly H&T temperaturesensor, humiditysensor, battery, update — Auto-discovery 9
Shelly TRV thermostat, temperaturesensor, battery, update — Auto-discovery 13
Shelly Flood watersensor, temperaturesensor, battery, update — Auto-discovery 9
Shelly Smoke firesensor, temperaturesensor, battery, update — Auto-discovery 9
Shelly Plus Smoke firesensor, battery, update — Auto-discovery 9
Shelly Gas gassensor, update — Auto-discovery 10
Shelly switch powerswitch — Automatic 3
Shelly 3EM (gen1) Energy meter, update — Auto-discovery 27
Shelly Pro 3EM (120A / 400A) Energy meter, update — Auto-discovery 24
Shelly 3EM (Gen3) Energy meter, update — Auto-discovery 24
Shelly EM gateway, power, update — Auto-discovery 6
Shelly Power meter Channel Consumption meter — Automatic 4
Shelly EM Channel Energy meter — Automatic 7
Shelly Motion presencesensor, lightsensor, update, battery — Auto-discovery 10
Shelly connected Roller Shutter extendedshutter, Consumption meter — Automatic 6
Shelly Addon temperature sensor temperaturesensor — Automatic 3

Per-model detail

Shelly 1 — shelly1

Settings:

Key Label Type Range Default Read-only
id Shelly ID QString — — yes
coapMode CoIoT peer mode QString — unicast no
username Username (optional) QString — — no
password Password (optional) QString — — no

Measured quantities:

Key Quantity Type Unit
power Powered bool —
connected Connected bool —
signalStrength Signal strength uint Percentage
updateStatus Update status QString —
currentVersion Firmware version QString —
availableVersion Available firmware version QString —
Shelly Plus 1 — shellyPlus1

Settings:

Key Label Type Range Default Read-only
id Shelly ID QString — — yes

Measured quantities:

Key Quantity Type Unit
power Powered bool —
connected Connected bool —
signalStrength Signal strength uint Percentage
updateStatus Update status QString —
currentVersion Firmware version QString —
availableVersion Available firmware version QString —
Shelly 1PM — shelly1pm

Settings:

Key Label Type Range Default Read-only
id Shelly ID QString — — yes
coapMode CoIoT peer mode QString — unicast no
username Username (optional) QString — — no
password Password (optional) QString — — no

Measured quantities:

Key Quantity Type Unit
power Powered bool —
connected Connected bool —
signalStrength Signal strength uint Percentage
updateStatus Update status QString —
currentVersion Firmware version QString —
availableVersion Available firmware version QString —
totalEnergyConsumed Total energy consumed double KiloWattHour
currentPower Current power consumption double Watt
Shelly Plus 1PM — shellyPlus1pm

Settings:

Key Label Type Range Default Read-only
id Shelly ID QString — — yes

Measured quantities:

Key Quantity Type Unit
power Powered bool —
connected Connected bool —
signalStrength Signal strength uint Percentage
updateStatus Update status QString —
currentVersion Firmware version QString —
availableVersion Available firmware version QString —
totalEnergyConsumed Total energy consumed double KiloWattHour
currentPower Current power consumption double Watt
Shelly Pro 1PM — shellyPro1Pm

Settings:

Key Label Type Range Default Read-only
id Shelly ID QString — — yes

Measured quantities:

Key Quantity Type Unit
power Powered bool —
connected Connected bool —
signalStrength Signal strength uint Percentage
updateStatus Update status QString —
currentVersion Firmware version QString —
availableVersion Available firmware version QString —
totalEnergyConsumed Total energy consumed double KiloWattHour
currentPower Current power consumption double Watt
Shelly 1L — shelly1l

Settings:

Key Label Type Range Default Read-only
id Shelly ID QString — — yes
coapMode CoIoT peer mode QString — unicast no
username Username (optional) QString — — no
password Password (optional) QString — — no

Measured quantities:

Key Quantity Type Unit
power Powered bool —
connected Connected bool —
signalStrength Signal strength uint Percentage
updateStatus Update status QString —
currentVersion Firmware version QString —
availableVersion Available firmware version QString —
totalEnergyConsumed Total energy consumed double KiloWattHour
currentPower Current power consumption double Watt
Shelly 2 — shelly2

Settings:

Key Label Type Range Default Read-only
id Shelly ID QString — — yes
coapMode CoIoT peer mode QString — unicast no
username Username (optional) QString — — no
password Password (optional) QString — — no
rollerMode Roller shutter mode bool — False no

Measured quantities:

Key Quantity Type Unit
connected Connected bool —
signalStrength Signal strength uint Percentage
updateStatus Update status QString —
currentVersion Firmware version QString —
availableVersion Available firmware version QString —
channel1 Power channel 1 bool —
channel2 Power channel 2 bool —
Shelly 2.5 — shelly25

Settings:

Key Label Type Range Default Read-only
id Shelly ID QString — — yes
coapMode CoIoT peer mode QString — unicast no
username Username (optional) QString — — no
password Password (optional) QString — — no
rollerMode Roller shutter mode bool — False no

Measured quantities:

Key Quantity Type Unit
connected Connected bool —
signalStrength Signal strength uint Percentage
updateStatus Update status QString —
currentVersion Firmware version QString —
availableVersion Available firmware version QString —
channel1 Power channel 1 bool —
channel2 Power channel 2 bool —
Shelly Plus 2PM — shellyPlus25

Settings:

Key Label Type Range Default Read-only
id Shelly ID QString — — yes
rollerMode Roller shutter mode bool — False no

Measured quantities:

Key Quantity Type Unit
connected Connected bool —
signalStrength Signal strength uint Percentage
updateStatus Update status QString —
currentVersion Firmware version QString —
availableVersion Available firmware version QString —
channel1 Power channel 1 bool —
channel2 Power channel 2 bool —
Shelly Plus Plug S/US/UK/IT — shellyPlusPlug

Settings:

Key Label Type Range Default Read-only
id Shelly ID QString — — yes
coapMode CoIoT peer mode QString — unicast no
username Username (optional) QString — — no
password Password (optional) QString — — no

Measured quantities:

Key Quantity Type Unit
power Powered bool —
connected Connected bool —
signalStrength Signal strength uint Percentage
updateStatus Update status QString —
currentVersion Firmware version QString —
availableVersion Available firmware version QString —
totalEnergyConsumed Total energy consumed double KiloWattHour
currentPower Current power consumption double Watt
Shelly Plug/PlugS — shellyPlug

Settings:

Key Label Type Range Default Read-only
id Shelly ID QString — — yes
coapMode CoIoT peer mode QString — unicast no
username Username (optional) QString — — no
password Password (optional) QString — — no

Measured quantities:

Key Quantity Type Unit
connected Connected bool —
signalStrength Signal strength uint Percentage
power Powered bool —
totalEnergyConsumed Total energy consumed double KiloWattHour
currentPower Power consumption double Watt
updateStatus Update status QString —
currentVersion Firmware version QString —
availableVersion Available firmware version QString —
Shelly RGBW2 — shellyRgbw2

Settings:

Key Label Type Range Default Read-only
id Shelly ID QString — — yes
coapMode CoIoT peer mode QString — unicast no
username Username (optional) QString — — no
password Password (optional) QString — — no

Measured quantities:

Key Quantity Type Unit
connected Connected bool —
signalStrength Signal strength uint Percentage
power On bool —
brightness Brightness int —
colorTemperature Color temperature int —
color Color QColor —
whiteChannel White channel uint —
currentPower Current power consumption double Watt
updateStatus Update status QString —
currentVersion Firmware version QString —
availableVersion Available firmware version QString —
Shelly Dimmer (2) / Vintage — shellyDimmer

Settings:

Key Label Type Range Default Read-only
id Shelly ID QString — — yes
coapMode CoIoT peer mode QString — unicast no
username Username (optional) QString — — no
password Password (optional) QString — — no

Measured quantities:

Key Quantity Type Unit
connected Connected bool —
signalStrength Signal strength uint Percentage
power On bool —
brightness Brightness int Percentage
currentPower Current power consumption double Watt
updateStatus Firmware update status QString —
currentVersion Firmware version QString —
availableVersion Available firmware version QString —
Shelly button 1 — shellyButton1

Settings:

Key Label Type Range Default Read-only
id Shelly ID QString — — yes
coapMode CoIoT peer mode QString — unicast no
username Username (optional) QString — — no
password Password (optional) QString — — no

Measured quantities:

Key Quantity Type Unit
connected Connected bool —
signalStrength Signal strength uint Percentage
batteryLevel Battery level int Percentage
batteryCritical Battery level critical bool —
updateStatus Update status QString —
currentVersion Current firmware version QString —
availableVersion Available firmware version QString —
Shelly I3 — shellyI3

Settings:

Key Label Type Range Default Read-only
id Shelly ID QString — — yes
coapMode CoIoT peer mode QString — unicast no
username Username (optional) QString — — no
password Password (optional) QString — — no

Measured quantities:

Key Quantity Type Unit
connected Connected bool —
signalStrength Signal strength uint Percentage
input1 Input 1 bool —
input2 Input 2 bool —
input3 Input 3 bool —
updateStatus Update status QString —
currentVersion Firmware version QString —
availableVersion Available firmware version QString —
Shelly H&T — shellyHT

Settings:

Key Label Type Range Default Read-only
id Shelly ID QString — — yes
coapMode CoIoT peer mode QString — unicast no
username Username (optional) QString — — no
password Password (optional) QString — — no

Measured quantities:

Key Quantity Type Unit
temperature Temperature double DegreeCelsius
humidity Humidity double Percentage
connected Connected bool —
signalStrength Signal strength uint Percentage
batteryLevel Battery level int Percentage
batteryCritical Battery level critical bool —
updateStatus Update status QString —
currentVersion Current firmware version QString —
availableVersion Available firmware version QString —
Shelly TRV — shellyTrv

Settings:

Key Label Type Range Default Read-only
id Shelly ID QString — — yes
coapMode CoIoT peer mode QString — unicast no
username Username (optional) QString — — no
password Password (optional) QString — — no

Measured quantities:

Key Quantity Type Unit
temperature Temperature double DegreeCelsius
targetTemperature Target temperature double DegreeCelsius
valvePosition Valve position uint Percentage
heatingOn Heating bool —
boost Boost bool —
windowOpen Window open bool —
connected Connected bool —
signalStrength Signal strength uint Percentage
batteryLevel Battery level int Percentage
batteryCritical Battery level critical bool —
updateStatus Update status QString —
currentVersion Current firmware version QString —
availableVersion Available firmware version QString —
Shelly Flood — shellyFlood

Settings:

Key Label Type Range Default Read-only
id Shelly ID QString — — yes
coapMode CoIoT peer mode QString — unicast no
username Username (optional) QString — — no
password Password (optional) QString — — no

Measured quantities:

Key Quantity Type Unit
waterDetected Water detected bool —
temperature Temperature double DegreeCelsius
connected Connected bool —
signalStrength Signal strength uint Percentage
batteryLevel Battery level int Percentage
batteryCritical Battery level critical bool —
updateStatus Update status QString —
currentVersion Current firmware version QString —
availableVersion Available firmware version QString —
Shelly Smoke — shellySmoke

Settings:

Key Label Type Range Default Read-only
id Shelly ID QString — — yes
coapMode CoIoT peer mode QString — unicast no
username Username (optional) QString — — no
password Password (optional) QString — — no

Measured quantities:

Key Quantity Type Unit
fireDetected Fire detected bool —
temperature Temperature double DegreeCelsius
connected Connected bool —
signalStrength Signal strength uint Percentage
batteryLevel Battery level int Percentage
batteryCritical Battery level critical bool —
updateStatus Update status QString —
currentVersion Current firmware version QString —
availableVersion Available firmware version QString —
Shelly Plus Smoke — shellyPlusSmoke

Settings:

Key Label Type Range Default Read-only
id Shelly ID QString — — yes

Measured quantities:

Key Quantity Type Unit
fireDetected Fire detected bool —
mute Muted bool —
connected Connected bool —
signalStrength Signal strength uint Percentage
batteryLevel Battery level int Percentage
batteryCritical Battery level critical bool —
updateStatus Update status QString —
currentVersion Current firmware version QString —
availableVersion Available firmware version QString —
Shelly Gas — shellyGas

Settings:

Key Label Type Range Default Read-only
id Shelly ID QString — — yes
coapMode CoIoT peer mode QString — unicast no
username Username (optional) QString — — no
password Password (optional) QString — — no

Measured quantities:

Key Quantity Type Unit
gasLevel Gas level double PartsPerMillion
connected Connected bool —
signalStrength Signal strength uint Percentage
updateStatus Update status QString —
currentVersion Current firmware version QString —
availableVersion Available firmware version QString —
sensorOperation Sensor operation QString —
selfTest Self test QString —
gas Gas level index QString —
valveState Valve state QString —
Shelly switch — shellySwitch

Settings:

Key Label Type Range Default Read-only
channel Channel uint — 1 no

Measured quantities:

Key Quantity Type Unit
connected Connected bool —
signalStrength Signal strength uint Percentage
power On/Off bool —
Shelly 3EM (gen1) — shellyEm3

Settings:

Key Label Type Range Default Read-only
id Shelly ID QString — — yes
coapMode CoIoT peer mode QString — unicast no
username Username (optional) QString — — no
password Password (optional) QString — — no

Measured quantities:

Key Quantity Type Unit
connected Connected bool —
signalStrength Signal strength uint Percentage
totalEnergyConsumed Total consumed energy double KiloWattHour
totalEnergyProduced Total returned energy double KiloWattHour
currentPower Current power double Watt
currentPowerPhaseA Power usage (Phase A) double Watt
powerFactorPhaseA Power factor (Phase A) double —
currentPhaseA Current (Phase A) double Ampere
voltagePhaseA Voltage (Phase A) double Volt
energyConsumedPhaseA Total consumed energy (Phase A) double KiloWattHour
energyProducedPhaseA Total returned energy (Phase A) double KiloWattHour
currentPowerPhaseB Power usage (Phase B) double Watt
powerFactorPhaseB Power factor (Phase B) double —
currentPhaseB Current (Phase B) double Ampere
voltagePhaseB Voltage (Phase B) double Volt
energyConsumedPhaseB Total consumed energy (Phase B) double KiloWattHour
energyProducedPhaseB Total returned energy (Phase B) double KiloWattHour
currentPowerPhaseC Power usage (Phase C) double Watt
powerFactorPhaseC Power factor (Phase C) double —
currentPhaseC Current (Phase C) double Ampere
voltagePhaseC Voltage (Phase C) double Volt
energyConsumedPhaseC Total consumed energy (Phase C) double KiloWattHour
energyProducedPhaseC Total returned energy (Phase C) double KiloWattHour
updateStatus Update status QString —
currentVersion Current firmware version QString —
availableVersion Available firmware version QString —
power Powered bool —
Shelly Pro 3EM (120A / 400A) — shellyPro3EM

Settings:

Key Label Type Range Default Read-only
id Shelly ID QString — — yes
username Username (optional) QString — — no
password Password (optional) QString — — no

Measured quantities:

Key Quantity Type Unit
connected Connected bool —
signalStrength Signal strength uint Percentage
totalEnergyConsumed Total consumed energy double KiloWattHour
totalEnergyProduced Total returned energy double KiloWattHour
currentPower Current power double Watt
currentPowerPhaseA Power usage (Phase A) double Watt
currentPhaseA Current (Phase A) double Ampere
voltagePhaseA Voltage (Phase A) double Volt
energyConsumedPhaseA Total consumed energy (Phase A) double KiloWattHour
energyProducedPhaseA Total returned energy (Phase A) double KiloWattHour
currentPowerPhaseB Power usage (Phase B) double Watt
currentPhaseB Current (Phase B) double Ampere
voltagePhaseB Voltage (Phase B) double Volt
energyConsumedPhaseB Total consumed energy (Phase B) double KiloWattHour
energyProducedPhaseB Total returned energy (Phase B) double KiloWattHour
currentPowerPhaseC Power usage (Phase C) double Watt
currentPhaseC Current (Phase C) double Ampere
voltagePhaseC Voltage (Phase C) double Volt
energyConsumedPhaseC Total consumed energy (Phase C) double KiloWattHour
energyProducedPhaseC Total returned energy (Phase C) double KiloWattHour
updateStatus Update status QString —
currentVersion Current firmware version QString —
availableVersion Available firmware version QString —
power Powered bool —
Shelly 3EM (Gen3) — shelly3EM

Settings:

Key Label Type Range Default Read-only
id Shelly ID QString — — yes
username Username (optional) QString — — no
password Password (optional) QString — — no

Measured quantities:

Key Quantity Type Unit
connected Connected bool —
signalStrength Signal strength uint Percentage
totalEnergyConsumed Total consumed energy double KiloWattHour
totalEnergyProduced Total returned energy double KiloWattHour
currentPower Current power double Watt
currentPowerPhaseA Power usage (Phase A) double Watt
currentPhaseA Current (Phase A) double Ampere
voltagePhaseA Voltage (Phase A) double Volt
energyConsumedPhaseA Total consumed energy (Phase A) double KiloWattHour
energyProducedPhaseA Total returned energy (Phase A) double KiloWattHour
currentPowerPhaseB Power usage (Phase B) double Watt
currentPhaseB Current (Phase B) double Ampere
voltagePhaseB Voltage (Phase B) double Volt
energyConsumedPhaseB Total consumed energy (Phase B) double KiloWattHour
energyProducedPhaseB Total returned energy (Phase B) double KiloWattHour
currentPowerPhaseC Power usage (Phase C) double Watt
currentPhaseC Current (Phase C) double Ampere
voltagePhaseC Voltage (Phase C) double Volt
energyConsumedPhaseC Total consumed energy (Phase C) double KiloWattHour
energyProducedPhaseC Total returned energy (Phase C) double KiloWattHour
updateStatus Update status QString —
currentVersion Current firmware version QString —
availableVersion Available firmware version QString —
power Powered bool —
Shelly EM — shellyEm

Settings:

Key Label Type Range Default Read-only
id Shelly ID QString — — yes
coapMode CoIoT peer mode QString — unicast no
username Username (optional) QString — — no
password Password (optional) QString — — no

Measured quantities:

Key Quantity Type Unit
connected Connected bool —
signalStrength Signal strength uint Percentage
updateStatus Update status QString —
currentVersion Current firmware version QString —
availableVersion Available firmware version QString —
power Powered bool —
Shelly Power meter Channel — shellyPowerMeterChannel

Settings:

Key Label Type Range Default Read-only
id Shelly ID QString — — yes
channel Channel uint — 1 no

Measured quantities:

Key Quantity Type Unit
connected Connected bool —
signalStrength Signal strength uint Percentage
totalEnergyConsumed Total consumed energy double KiloWattHour
currentPower Current power double Watt
Shelly EM Channel — shellyEmChannel

Settings:

Key Label Type Range Default Read-only
id Shelly ID QString — — yes
channel Channel uint — 1 no

Measured quantities:

Key Quantity Type Unit
connected Connected bool —
signalStrength Signal strength uint Percentage
totalEnergyConsumed Total consumed energy double KiloWattHour
totalEnergyProduced Total returned energy double KiloWattHour
currentPower Current power double Watt
currentPhaseA Current double Ampere
voltagePhaseA Voltage double Volt
Shelly Motion — shellyMotion

Settings:

Key Label Type Range Default Read-only
id Shelly ID QString — — yes
coapMode CoIoT peer mode QString — unicast no
username Username (optional) QString — — no
password Password (optional) QString — — no

Measured quantities:

Key Quantity Type Unit
isPresent Person is present bool —
lightIntensity Light intensity double Lux
vibration Vibration bool —
connected Connected bool —
signalStrength Signal strength uint Percentage
updateStatus Update status QString —
currentVersion Current firmware version QString —
availableVersion Available firmware version QString —
batteryCritical Battery level critical bool —
batteryLevel Battery level int Percentage
Shelly connected Roller Shutter — shellyRoller

Settings:

Key Label Type Range Default Read-only
channel Channel uint — 1 no

Measured quantities:

Key Quantity Type Unit
connected Connected bool —
signalStrength Signal strength uint Percentage
totalEnergyConsumed Total energy consumed double KiloWattHour
currentPower Current power consumption double Watt
moving Moving bool —
percentage Position int Percentage
Shelly Addon temperature sensor — shellyAddonTempSensor

Settings:

Key Label Type Range Default Read-only
addonId ID QString — — no

Measured quantities:

Key Quantity Type Unit
connected Connected bool —
signalStrength Signal strength uint Percentage
temperature Temperature double DegreeCelsius