ETM-Schurig/powersync-docs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
powersync-docs/docs/appareils/smart/shelly.de.md
Patrick Schurig 325409dd3f feat(i18n): prose traduite DE/EN et référence régénérée en anglais 
82 pages .de.md et 82 .en.md. La volumétrie explique la forme : 95 % du volume
est GÉNÉRÉ (74 013 mots contre 3 506 rédigés, mesuré sur 107 pages). On ne
traduisait donc pas 77 500 mots — on traduit la prose, et le vocabulaire des
générateurs fait le reste.

Prose traduite à la main : accueil, installation (4), fonctionnalités (4),
tarifs, référence, dépannage, FAQ, intégrations (2), api/index, et les 6 fiches
appareils qui portent une vraie prose + compatibilite.md. Les blocs générés ne
sont JAMAIS recopiés dans une traduction : le script de pose les reprend
verbatim du fichier français via des placeholders, pour qu'une traduction ne
puisse pas désynchroniser un bloc généré.

Les 49 fiches légères n'ont rien à traduire : leur tagline vient d'amont et est
DÉJÀ en anglais (« Connects nymea to powerfox. »). Constat, pas renoncement.

Localisation ≠ traduction, et tarifs.md en est l'exemple à connaître : la
version FR parle de Tempo et du signal RTE, la DE de §14a EnWG et de SMARD,
l'EN des deux. Ce ne sont pas des traductions l'une de l'autre, et c'est
volontaire — les signaux tarifaires sont nationaux. Aucune des deux n'est
annoncée comme livrée : les deux sont Roadmap, et les pages le disent.

Référence régénérée : en-têtes et libellés en anglais (Field/Type/Notes,
Supported models, Settings, Read-only, Brand / Model…). Conséquence assumée et
signalée : les pages FR en ligne changent aussi.

README.md (il était VIDE) : la règle du 95 % généré en tête, la frontière de
décision du multi-langue avec sa mesure, pourquoi SCAFFOLD existe, et le piège
--strict/navigation.instant.

TODO : multi-langue clos, et trois points ouverts qui en restent — les tagline
vivent dans les meta.json de 5 autres dépôts (forme à ajouter : tagline_de /
tagline_en), les stubs traduits restent des stubs (la dette éditoriale a triplé
en surface, pas en fond), api/types.md n'a pas besoin de variante. Le P1
openmeteo est corrigé sur constat : il EST dans PORTING_STATUS depuis, et une
ligne commentée contradictoire y traîne encore.

Vérifié : mkdocs build --strict vert sur les trois langues, 322 pages HTML,
contenu traduit relu dans le HTML produit, et les deux générateurs rendent
« Doc à jour » en --check.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-10-13 06:39:20 +02:00

34 KiB
Raw Blame History

Shelly

STABLE NYMEA CONSUMER

Use Shelly devices with nymea.

Installationsanleitung folgt.

Referenz

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

??? abstract "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 | — |

??? abstract "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 | — |

??? abstract "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 |

??? abstract "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 |

??? abstract "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 |

??? abstract "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 |

??? abstract "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 | — |

??? abstract "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 | — |

??? abstract "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 | — |

??? abstract "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 |

??? abstract "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 | — |

??? abstract "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 | — |

??? abstract "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 | — |

??? abstract "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 | — |

??? abstract "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 | — |

??? abstract "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 | — |

??? abstract "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 | — |

??? abstract "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 | — |

??? abstract "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 | — |

??? abstract "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 | — |

??? abstract "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 | — |

??? abstract "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 | — |

??? abstract "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 | — |

??? abstract "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 | — |

??? abstract "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 | — |

??? abstract "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 | — |

??? abstract "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 |

??? abstract "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 |

??? abstract "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 |

??? abstract "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 |

??? abstract "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 |