---
title: "Shelly Plus 1PM"
description: "Releu Shelly Plus 1PM Gen2+ cu măsurarea puterii prin MQTT. Putere (kW), energie (kWh), tensiune, curent și temperatură în timp real, prin broker MQTT."
url: "https://taphome.com/ro/compatibility/shelly-plus-1pm-mqtt/"
language: ro
lastmod: 2026-03-31
generator: hugo
ai:
  topics: ["mqtt","electric-meter","wifi","relay","power-metering","gen2plus"]
  questions: ["Cum integrez Shelly Plus 1PM cu TapHome prin MQTT?","Ce măsoară șablonul TapHome Shelly Plus 1PM MQTT?","Cum găsesc Client ID-ul MQTT al Shelly Plus 1PM?","De ce Shelly Plus 1PM MQTT nu raportează date?","Ce informații de diagnosticare sunt disponibile pentru Shelly Plus 1PM prin MQTT?","Cum comand releul Shelly Plus 1PM prin MQTT din TapHome?"]
---

# Shelly Plus 1PM

Comunicație: Packet Parser → MQTT

- [Pagina produsului Shelly Plus 1PM](https://www.shelly.com/en/products/shop/shelly-plus-1pm)
- [Documentația API MQTT Shelly Gen2+](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/Mqtt/)

> Adresa în rețea
> 
> Pentru brokerul MQTT integrat în TapHome este vorba de un singur broker, accesat din două locuri. Șablonul rulează direct în TapHome Core, de aceea în TapHome adresa brokerului este `127.0.0.1` (acest calculator). Dispozitivul rulează în altă parte a rețelei, de aceea în dispozitiv introduceți adresa IP a unității TapHome Core și atribuiți unității Core o rezervare IP în router — dacă adresa Core se schimbă, dispozitivul nu mai ajunge la broker.
> 
> [Pregătirea rețelei](https://taphome.com/ro/docs/setup/network-preparation/)

## Ghid de integrare

Shelly Plus 1PM este un releu Wi-Fi compact Gen2+ cu măsurarea integrată a puterii. Se montează în spatele unui întrerupător de perete standard și poate comanda un circuit de până la 16 A (3500 W la 230 V AC) sau 10 A (30 V DC). Aceasta este **varianta MQTT** a șablonului TapHome — dispozitivul comunică printr-un broker MQTT în locul interogării directe prin HTTP, ceea ce este util în medii cu mai multe controlere sau când dispozitivul se află într-un alt VLAN.

Șablonul oferă două dispozitive: un **contor electric** pentru monitorizarea puterii și a energiei și un **întrerupător** pentru comanda releului. Trei atribute de service la nivel de modul raportează temperatura internă, tensiunea și curentul.

## Configurare

### Client ID-ul MQTT

Fiecare Shelly Plus 1PM are un Client ID MQTT unic în formatul `shellyplus1pm-<DEVICEID>`, unde `<DEVICEID>` este adresa MAC de 12 caractere în hexazecimal (de ex. `shellyplus1pm-AABBCCDDEE00`).

Client ID-ul se găsește:

- În interfața web Shelly: **Settings** → **MQTT** → **Client ID**
- Prin API: `GET http://<device-ip>/rpc/MQTT.GetConfig` → câmpul `client_id`
- Pe eticheta dispozitivului (adresa MAC)

> [!TIP]
> Acest dispozitiv acceptă **descoperirea mDNS**. La verificarea conectivității puteți folosi numele de gazdă `shellyplus1pm-{MAC}.local` în locul adresei IP. Înlocuiți `{MAC}` cu adresa MAC completă a dispozitivului, în hexazecimal cu litere mici (de ex. `shellyplus1pm-aabbccddee00.local`).

### Activarea MQTT

1. Deschideți interfața web Shelly: `http://<device-ip>/`
2. Mergeți la **Settings** → **MQTT**
3. Activați **MQTT**
4. Setați **Server**: `<broker-ip>:<port>` (de ex. `192.168.1.10:1883`)
5. **Client ID** este completat automat — lăsați-l neschimbat, dacă nu aveți un motiv anume să îl modificați
6. Faceți clic pe **Save** și reporniți dispozitivul

> [!TIP]
> Pentru a verifica funcționarea MQTT, folosiți un client MQTT (de ex. MQTT Explorer) și abonați-vă la `shellyplus1pm-<DEVICEID>/#`. Ar trebui să vedeți mesajele de stare ale dispozitivului, inclusiv `shellyplus1pm-<DEVICEID>/status/switch:0`.

### Configurarea șablonului

După importul șablonului în TapHome:

1. Deschideți **Modul Shelly Plus 1PM MQTT**
2. Setați **MQTT Broker IP** și **Port** (implicit `1883`)
3. Setați variabila personalizată **plug1topic** la Client ID-ul MQTT al Shelly Plus 1PM (de ex. `shellyplus1pm-AABBCCDDEE00`)

Modulul se abonează la `{plug1topic}/status/switch:0` și publică comenzile de control pe `{plug1topic}/command/switch:0`.

## Funcțiile dispozitivului

### Măsurarea puterii

Contorul electric citește două valori din mesajul de stare MQTT `{plug1topic}/status/switch:0`:

- **Putere instantanee** — `apower`, raportată în wați și convertită de șablon în kW (împărțire la 1000)
- **Energie cumulată** — `aenergy.total`, raportată în wați-oră și convertită de șablon în kWh (împărțire la 1000)

Contorul este doar pentru citire — se actualizează automat ori de câte ori dispozitivul publică un mesaj de stare către brokerul MQTT.

### Comanda releului

Întrerupătorul comandă releul:

- **Citirea stării** — se abonează la `{plug1topic}/status/switch:0` și citește câmpul boolean `output`
- **Scrierea stării** — publică `on` sau `off` pe `{plug1topic}/command/switch:0`

Releul suportă până la 3500 W / 16 A la 230 V AC.

### Diagnosticare

Trei atribute de service la nivel de modul sunt preluate din același mesaj JSON `status/switch:0`:

| Atribut | Unitate | Descriere |
|-----------|------|-------------|
| Temperatură internă | °C | Temperatura internă a dispozitivului — monitorizează starea termică a releului și a plăcii electronice |
| Tensiune | V | Tensiunea de alimentare AC la intrarea releului |
| Curent | A | Curentul sarcinii prin ieșirea releului |

Toate cele trei atribute afișează „Necunoscut” până la sosirea primului mesaj de stare MQTT (valoarea inițială este `NaN`).

### Funcții suplimentare

Prin API-ul MQTT, Shelly Plus 1PM furnizează și factorul de putere, frecvența rețelei, energia returnată (pentru contorizare bidirecțională), starea intrării fizice, comanda de comutare (toggle), temporizatorul de oprire automată și o acțiune de actualizare forțată a stării. Aceste funcții pot fi adăugate într-o actualizare viitoare a șablonului.

## Rezolvarea problemelor

### Mesajele MQTT nu ajung

1. Verificați dacă MQTT este activat în interfața web Shelly (**Settings** → **MQTT**)
2. Verificați dacă adresa și portul brokerului sunt corecte atât pe dispozitivul Shelly, cât și în setările modulului TapHome
3. Verificați dacă variabila personalizată `plug1topic` corespunde exact Client ID-ului MQTT al dispozitivului Shelly (de ex. `shellyplus1pm-AABBCCDDEE00`)
4. Folosiți un client MQTT (de ex. MQTT Explorer) pentru a vă abona la `shellyplus1pm-#` și verificați dacă dispozitivul publică mesaje

### Puterea afișată este zero

1. Verificați dacă sarcina este conectată prin releul Shelly (nu ocolește releul)
2. Verificați dacă releul este pornit — contorul măsoară doar atunci când curentul trece prin releu
3. Abonați-vă la `{plug1topic}/status/switch:0` cu un client MQTT și verificați dacă `apower` returnează o valoare diferită de zero

### Releul nu răspunde la comenzi

1. Verificați dacă TapHome poate accesa brokerul MQTT (adresa IP și portul corecte în setările modulului)
2. Verificați dacă valoarea `plug1topic` corespunde Client ID-ului MQTT al dispozitivului
3. Testați publicând `on` pe `{plug1topic}/command/switch:0` cu un client MQTT — releul ar trebui să pornească

### Diagnosticarea afișează „Necunoscut”

1. Toate cele trei atribute de service (temperatură, tensiune, curent) afișează „Necunoscut” până la sosirea primului mesaj de stare
2. Dacă valorile rămân „Necunoscut” și după ce dispozitivul funcționează de ceva timp, verificați dacă conexiunea MQTT este activă și dacă mesajele de stare sunt publicate
3. Reporniți dispozitivul Shelly pentru a forța publicarea unei stări noi

> [!WARNING]
> Dispozitivele Shelly Gen2+ acceptă MQTT cu TLS opțional. Dacă TLS nu este configurat, comunicația dintre dispozitiv și brokerul MQTT nu este criptată (MQTT simplu, portul 1883). Pentru o comunicație criptată, activați TLS în setările MQTT ale dispozitivului Shelly și folosiți portul 8883.

## Cum se instalează în TapHome

### Cerințe preliminare

- Dispozitiv Shelly conectat la Wi-Fi (2,4 GHz), de ex. prin aplicația Shelly sau prin punctul de acces propriu al dispozitivului
- Broker MQTT care rulează în rețeaua dvs. locală (de ex. Mosquitto, Home Assistant sau brokerul integrat TapHome)
- TapHome CCU în aceeași rețea cu brokerul

> [!WARNING]
> La dispozitivele **Gen1**, activarea MQTT **dezactivează Shelly Cloud**. Cele două nu pot funcționa simultan. La dispozitivele Gen2/Plus această limitare nu se aplică.

### Pasul 1 — Activați MQTT pe dispozitivul Shelly

#### Dispozitive Gen1 (Shelly 1, 1PM, 2.5, EM, 3EM, Plug S, RGBW2, Dimmer, TRV…)

1. Deschideți interfața web Shelly: `http://<device-ip>/`
2. Accesați **Internet & Security** → **Advanced — MQTT**
3. Activați **MQTT**
4. Setați **MQTT Server**: `<broker-ip>:<port>` (de ex. `192.168.1.10:1883`)
5. Opțional, setați **MQTT User** și **MQTT Password**, dacă brokerul dvs. necesită autentificare
6. Faceți clic pe **Save** — dispozitivul repornește și se conectează la broker

#### Dispozitive Gen2 / Plus (Shelly Plus 1, Plus 1PM, Plus 2PM, Plus Plug S, Plus H&T, Pro 3EM…)

1. Deschideți interfața web Shelly: `http://<device-ip>/`
2. Accesați **Settings** → **MQTT**
3. Activați **MQTT**
4. Setați **Server**: `<broker-ip>:<port>` (de ex. `192.168.1.10:1883`)
5. Câmpul **Client ID** este precompletat cu ID-ul dispozitivului (de ex. `shellyplus1pm-AABBCCDDEE`) — lăsați-l neschimbat, dacă nu aveți un motiv anume să îl modificați
6. Faceți clic pe **Save** și reporniți dispozitivul

La brokerul integrat TapHome, `<broker-ip>` este adresa IP a unității TapHome Core. Atribuiți unității Core o rezervare IP în router; altfel dispozitivul pierde brokerul atunci când routerul schimbă adresa → [Pregătirea rețelei](https://taphome.com/ro/docs/setup/network-preparation/).

> [!TIP]
> Pentru a verifica funcționarea MQTT, folosiți un client MQTT (de ex. MQTT Explorer) și abonați-vă la `shellies/#` (Gen1) sau `<device-id>/#` (Gen2). Ar trebui să vedeți mesajele de stare trimise de dispozitiv.

### Pasul 2 — Aflați Device ID / MQTT Client ID

Unele șabloane necesită parametrul **Device ID** sau **MQTT Client ID**. Acesta este identificatorul unic folosit în topicurile MQTT.

- **Gen1:** se găsește pe etichetă, ca adresă MAC (de ex. `AABBCCDDEE`). Device ID = `shelly<model>-<mac>`, de ex. `shelly1pm-AABBCCDDEE`
- **Gen2/Plus:** se găsește în interfața web Shelly, la **Settings** → **Device Info** → **Device ID**, sau pe eticheta dispozitivului

### Pasul 3 — Configurați dispozitivul în TapHome

1. În TapHome adăugați un nou modul **Packet Parser (MQTT)**
2. **IP Address:** pentru brokerul integrat TapHome `127.0.0.1` (unitatea de control se conectează la ea însăși, adresa nu se schimbă niciodată); pentru un broker extern, adresa sa IP (de ex. `192.168.1.10`)
3. **Port:** `1883` (implicit; pentru TLS folosiți `8883`)
4. **Device ID / MQTT Client ID:** introduceți valoarea de la pasul 2 (dacă șablonul o necesită)
5. Importați șablonul — TapHome se abonează automat la topicurile dispozitivului

## Dispozitive disponibile 2

Aceste dispozitive apar în TapHome după import.

Modul Shelly Plus 1PM MQTT Modul

Atribute de service

|                     |                                                                                                        |
|---------------------|--------------------------------------------------------------------------------------------------------|
| Temperatură internă | Temperatura internă a dispozitivului — monitorizează starea termică a releului și a plăcii electronice |
| Tensiune            | Tensiunea de alimentare AC la intrarea releului                                                        |
| Curent              | Curentul sarcinii prin ieșirea releului                                                                |

Variabile personalizate

|                       |                                                                                                                                                                           |
|-----------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `plug1topic` (string) | Client ID-ul MQTT al Shelly Plus 1PM — formatul este 'shellyplus1pm-&lt;deviceid&gt;'. Se găsește în interfața web a dispozitivului: Settings → MQTT Settings → Client ID |

Ascultător

```taphome
IF(INDEXOF(plug1topic, "shellyplus1pm-deviceid") = 0)
    ADDERROR("Set correct 'plug1topic' value in module variables. Topic format is 'shellyplus1pm-<deviceid>'. The Device ID can be found by opening url 'http://shellyIpAddress', in Settings -> MQTT Settings -> Client ID.");
    RETURN(-1);
END

IF(RECEIVEDMSG.TOPIC = plug1topic + "/status/switch:0")
    internalTemp := PARSEJSON(RECEIVEDMSG.PAYLOAD, "temperature.tC");
    voltage := PARSEJSON(RECEIVEDMSG.PAYLOAD, "voltage");
    current := PARSEJSON(RECEIVEDMSG.PAYLOAD, "current");
    VAR errors := PARSEJSON(RECEIVEDMSG.PAYLOAD, "errors", TRUE);
    
    IF (!ISNULL(errors))
        VAR errCount := LENGTH(errors);
        VAR i := 0;
        VAR errorText := "";
        
        WHILE i < errCount
            IF LENGTH(errorText)
                errorText += ", ";
            END
            errorText := errorText + GETAT(errors, i);
            i += 1;
        LOOP
        
        IF LENGTH(errorText)
            ADDERROR(errorText);
        END
    END
END
```

Atribute de service

Internal temperature

```taphome
IF(ISNAN(internalTemp), "Unknown", internalTemp + "°C");
```

Voltage

```taphome
IF(ISNAN(voltage), "Unknown", voltage + "V");
```

Current

```taphome
IF(ISNAN(current), "Unknown", current + "A");
```

Contor electric Contor electric Doar citire

Putere instantanee (kW) și energie cumulată (kWh) din mesajul de stare MQTT

numeric Unitate: kW / kWh

Ascultător

```taphome
IF(INDEXOF(plug1topic, "shellyplus1pm-deviceid") = 0)
    ADDERROR("Set correct 'plug1topic' value in module variables. Topic format is 'shellyplus1pm-<deviceid>'. The Device ID can be found by opening url 'http://shellyIpAddress', in Settings -> MQTT Settings -> Client ID.");
    RETURN(-1);
END

IF(RECEIVEDMSG.TOPIC = plug1topic + "/status/switch:0")
    Ed := PARSEJSON(RECEIVEDMSG.PAYLOAD, "apower") / 1000.0;
    To := PARSEJSON(RECEIVEDMSG.PAYLOAD, "aenergy.total") / 1000.0;
END
```

Întrerupător Comutator Citire și scriere

Comanda releului (pornit/oprit) prin topicul de comandă MQTT

boolean

Valori / Stări: ON · OFF

Scrierea stării comutatorului

```taphome
VAR value := IF(St = 1, "on", "off");
MQTTPUBLISH(plug1topic + "/command/switch:0", value);
```

Ascultător

```taphome
IF(INDEXOF(plug1topic, "shellyplus1pm-deviceid") = 0)
    ADDERROR("Set correct 'plug1topic' value in module variables. Topic format is 'shellyplus1pm-<deviceid>'. The Device ID can be found by opening url 'http://shellyIpAddress', in Settings -> MQTT Settings -> Client ID.");
    RETURN(-1);
END

IF(RECEIVEDMSG.TOPIC = plug1topic + "/status/switch:0")
    St := PARSEJSON(RECEIVEDMSG.PAYLOAD, "output");
END
```

**Conexiune:** Packet Parser → MQTT • Nume gazdă: `shellyplus1pm-{MAC}.local`

Îmbunătățiri posibile (8)

- Power Factor — Power factor value, available in switch:0 status JSON for metered devices
- Network Frequency — AC network frequency in Hz, available in switch:0 status JSON
- Returned Energy — Returned/exported energy in Wh, for bi-directional metering scenarios
- Connection Status — LWT topic — true on connect, false on disconnect. Could detect offline device.
- Toggle Command — Toggle relay state; template only supports on/off
- Auto-off Timer — Turn ON with auto-off timer in seconds via 'on,N' command
- Input State — Physical switch/button input state, available via Input.GetStatus RPC method over MQTT
- Force Status Update — Request device to publish current status on all component topics

## Parametri de import

Introduceți aceste valori când importați XML-ul.

| Solicitat în aplicație | Implicit                 |
|------------------------|--------------------------|
| Mqtt Broker Adresă IP  | `192.168.0.1`            |
| Mqtt Broker port       | `1883`                   |
| Shelly MQTT Client ID  | `shellyplus1pm-deviceId` |

## Surse

- Shelly Gen2+/Gen3 RPC API Reference
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/) 2026-03-29
- Shelly Gen2+ Switch Component API
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/Switch/) 2026-03-29
- Shelly Gen2+ System (Sys) Component API
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/Sys/) 2026-03-29
- Shelly Gen2+ WiFi Component API
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/WiFi/) 2026-03-29
- Shelly Gen2+ MQTT Component API
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/Mqtt/) 2026-03-29
- Home Assistant Shelly Integration
  
  [www.home-assistant.io](https://www.home-assistant.io/integrations/shelly/) 2026-03-29
- Shelly Plus 1PM Knowledge Base — specs & wiring
  
  [kb.shelly.cloud](https://kb.shelly.cloud/knowledge-base/shelly-plus-1pm) 2026-03-31

## Documentație asociată

- [MQTT Integration](https://taphome.com/ro/compatibility/mqtt-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/ro/docs/integration/packet-parser/)
- [Funcții Packet parser](https://taphome.com/ro/docs/script/packet-parser/)
- [Funcții de parsare](https://taphome.com/ro/docs/script/parsing-functions/)
- [MQTT Broker](https://taphome.com/ro/docs/integration/packet-parser/mqtt-broker/)
- [Scripturi listener](https://taphome.com/ro/docs/script/listener-scripts/)

