---
title: "Shelly Motion 2"
description: "Shelly Motion 2 a batteria collegato a TapHome via MQTT: movimento, luminosità, temperatura e batteria. Fino a 5 sensori per modulo."
url: "https://taphome.com/it/compatibility/shelly-motion-2-mqtt/"
language: it
lastmod: 2026-03-30
generator: hugo
ai:
  topics: ["mqtt","sensor","wifi","motion-detection","battery-powered","pir-sensor"]
  questions: ["Come integrare lo Shelly Motion 2 con TapHome tramite MQTT?","Cosa rileva il template Shelly Motion 2 in TapHome?","Come configurare più sensori Shelly Motion in un unico template TapHome?","Perché il mio Shelly Motion 2 non segnala eventi di movimento?","Come trovare l'MQTT Device ID dello Shelly Motion 2?","Lo Shelly Motion 2 riporta livello batteria, luminosità e temperatura in TapHome?","Si può regolare la sensibilità dello Shelly Motion 2 da TapHome?"]
---

# Shelly Motion 2

Comunicazione: Packet Parser → MQTT

- [Shelly Motion 2 Knowledge Base](https://kb.shelly.cloud/knowledge-base/shelly-motion-2)

> Indirizzo di rete
> 
> Con il broker MQTT integrato in TapHome, inserisci `127.0.0.1` come indirizzo del broker in TapHome. Nel dispositivo inserisci l’indirizzo IP del TapHome Core e assegna al Core una prenotazione IP nel router.
> 
> [Preparazione della rete](https://taphome.com/it/docs/setup/network-preparation/)

## Guida all'integrazione

Lo Shelly Motion 2 (SHMOS-02) è un sensore di movimento PIR Wi-Fi alimentato a batteria (Li-ion 6500 mAh, ricaricabile tramite USB-C). TapHome comunica con il dispositivo tramite MQTT — il protocollo consigliato per i dispositivi Shelly alimentati a batteria, poiché il sensore è in stato di sospensione per la maggior parte del tempo e pubblica dati solo in corrispondenza degli eventi di risveglio (rilevamento movimento o timer periodico).

A differenza dei dispositivi Gen1 Shelly di tipo relè che pubblicano topic di stato individuali, il Motion 2 pubblica il proprio stato completo tramite un singolo payload JSON `/info` al risveglio. Lo script listener di TapHome analizza questo JSON per estrarre lo stato del movimento, la luminosità, la temperatura, il livello della batteria e gli attributi diagnostici.

Il template supporta fino a 5 sensori Shelly Motion 2 per modulo. Ogni istanza del sensore è identificata da una variabile personalizzata `sensorN_topic` che punta all'MQTT Client ID del dispositivo.

## Configurazione

### Device ID

Ogni Shelly Motion 2 ha un MQTT Device ID univoco nel formato `shellymotion2-<MAC>`, dove `<MAC>` è l'indirizzo MAC completo a 12 caratteri in formato esadecimale maiuscolo (es. `shellymotion2-AABBCCDDEEFF`).

Il Device ID si trova:

- Sull'etichetta del dispositivo (indirizzo MAC)
- Nell'interfaccia web di Shelly: **Settings** → **Device Info**
- Tramite API: `GET http://<device-ip>/settings` → campo `device.hostname`

### Configurazione del template

Dopo aver importato il template in TapHome:

1. Apri il modulo **Shelly Motion 2 MQTT**
2. Imposta l'**MQTT Broker IP** e la **Porta** (predefinita `1883`)
3. Per ogni istanza del sensore, imposta la variabile personalizzata `sensorN_topic` sul Device ID dello Shelly Motion 2 corrispondente (es. `shellymotion2-AABBCCDDEEFF`)

Il modulo si sottoscrive a `shellies/#` e gli script listener filtrano i messaggi in base al prefisso del topic configurato.

> [!TIP]
> Configura solo gli slot dei sensori che utilizzi effettivamente. Gli slot non configurati (con il valore predefinito `shellymotion2-deviceid`) mostreranno un messaggio di errore che invita a impostare il topic corretto.

### Impostazioni del sensore di movimento

Lo Shelly Motion 2 dispone di diversi parametri configurabili che influenzano il comportamento di rilevamento. Questi si configurano direttamente sul dispositivo tramite la sua interfaccia web (`http://<device-ip>/`), non tramite TapHome:

| Parametro | Intervallo | Descrizione |
|-----------|------------|-------------|
| Sensibilità | 1–256 | Sensibilità del rilevamento movimento (inferiore = più sensibile) |
| Tempo cieco | 1–1440 min | Minuti di ignoramento del movimento dopo un rilevamento |
| Conteggio impulsi | 1–4 | Movimenti consecutivi necessari per confermare il movimento |
| Modalità operativa | ANY / DARK / TWILIGHT / BRIGHT | Quando il rilevamento è attivo in base alla luce ambientale |
| Tempo di sospensione | 0–86400 s | Intervallo di risveglio periodico in secondi |

> [!TIP]
> Tempi di sospensione più brevi aumentano la freschezza dei dati ma riducono la durata della batteria. L'intervallo di risveglio predefinito è sufficiente per la maggior parte dei casi d'uso. Gli eventi di movimento attivano sempre un risveglio immediato indipendentemente dal timer di sospensione.

## Funzionalità del dispositivo

### Rilevamento movimento

Ogni istanza del sensore è mappata come dispositivo Reed Contact con capacità "security" in TapHome. Lo stato del movimento viene analizzato dal topic `shellies/<id>/info` — in particolare il campo `$.sensor.motion` nel payload JSON:

- `true` → **Allarme** (movimento rilevato)
- `false` → **OK** (nessun movimento)

Il sensore si risveglia e pubblica il proprio stato quando viene rilevato un movimento (in base alle impostazioni di sensibilità, tempo cieco e conteggio impulsi), e anche durante gli intervalli di risveglio periodici.

### Attributi di servizio

Ogni istanza del sensore espone 14 attributi di servizio a livello di dispositivo, tutti analizzati dal payload JSON `/info`:

| Attributo | Campo sorgente | Descrizione |
|-----------|----------------|-------------|
| Indirizzo IP | `$.wifi_sta.ip` | Indirizzo IP Wi-Fi del sensore |
| Indirizzo MAC | `$.mac` | Indirizzo MAC hardware |
| Batteria | `$.bat.voltage`, `$.bat.value` | Tensione e percentuale batteria (es. 3,83V (97%)) |
| Segnale | `$.wifi_sta.rssi` | Potenza del segnale Wi-Fi in dB |
| Cloud abilitato | `$.cloud.enabled` | Se Shelly Cloud è abilitato |
| Cloud connesso | `$.cloud.connected` | Se il dispositivo è connesso a Shelly Cloud |
| Ora dispositivo | `$.time` | Ora corrente sul dispositivo |
| Luminosità | `$.lux.value` | Livello di luce ambientale in lux |
| Temperatura | `$.tmp.value`, `$.tmp.units` | Lettura della temperatura interna |
| Tempo di attività | `$.uptime` | Tempo dall'ultimo riavvio |
| Versione FW | `$.fw_info.fw` | Versione firmware corrente |
| Aggiornamento FW | `$.update.has_update` | Se è disponibile un aggiornamento firmware |
| RAM libera | `$.ram_total`, `$.ram_free` | Memoria disponibile |
| Spazio FS libero | `$.fs_size`, `$.fs_free` | Spazio di archiviazione filesystem disponibile |

Un avviso di batteria scarica viene attivato automaticamente quando il livello della batteria scende sotto il 20%.

### Funzionalità aggiuntive (non implementate)

Lo Shelly Motion 2 pubblica anche il **rilevamento vibrazioni/manomissione** (`$.sensor.vibration`, sensibilità configurabile 0–80), la **categoria di illuminazione** (`$.lux.illumination` — dark/twilight/bright) e lo **stato del caricatore USB** (`$.charger`) tramite il payload JSON `/info`. Lo stato online/offline è disponibile tramite il topic LWT (`shellies/<id>/online`). Queste funzionalità sono disponibili nell'output MQTT del dispositivo ma non sono mappate nel template TapHome attuale. Possono essere aggiunte in un futuro aggiornamento del template.

## Risoluzione dei problemi

### Il sensore non segnala dati

1. Verifica che lo Shelly Motion 2 sia connesso al Wi-Fi e che l'MQTT sia abilitato nelle impostazioni del dispositivo
2. Controlla che la variabile personalizzata `sensorN_topic` corrisponda esattamente al Device ID (es. `shellymotion2-AABBCCDDEEFF`)
3. Usa un client MQTT (es. MQTT Explorer) per sottoscriverti a `shellies/#` e verificare che il sensore pubblichi messaggi al risveglio
4. Il Motion 2 è alimentato a batteria e pubblica dati solo al risveglio — attiva un evento di movimento per forzare un risveglio

### Lo stato del movimento non si aggiorna

1. Controlla che la lente del sensore PIR non sia ostruita e che il sensore sia montato all'altezza consigliata (1,8–2,5 m)
2. Se il sensore è stato installato di recente, verifica le impostazioni di sensibilità e tempo cieco nell'interfaccia web del dispositivo — un tempo cieco elevato significa che il sensore ignora il movimento per periodi più lunghi dopo ogni rilevamento
3. Regola il conteggio impulsi se il sensore si attiva troppo raramente (inferiore = meno movimenti consecutivi necessari)
4. Controlla in TapHome lo stato del dispositivo Reed Contact — 1 = movimento rilevato (allarme), 0 = nessun movimento (OK)

### La batteria si scarica rapidamente

1. Lo Shelly Motion 2 utilizza una batteria Li-ion ricaricabile integrata (6500 mAh) caricata tramite USB-C, con una durata attiva tipica di 12–18 mesi
2. Risvegli frequenti dovuti a elevata attività di movimento o brevi intervalli di sospensione scaricano la batteria più velocemente
3. L'abilitazione di SSL su MQTT riduce significativamente la durata della batteria — usa MQTT semplice (porta 1883) su una rete locale affidabile
4. Assicura un segnale Wi-Fi forte nella posizione del sensore — un segnale debole comporta tempi di connessione più lunghi ad ogni risveglio

> [!WARNING]
> I dispositivi Gen1 Shelly **non supportano** MQTT su TLS senza un impatto significativo sulla batteria. La comunicazione tra il sensore e il broker MQTT è tipicamente non crittografata (MQTT semplice, porta 1883). Assicurati che il broker MQTT si trovi su una rete locale affidabile.

> [!WARNING]
> L'abilitazione di MQTT sui dispositivi Gen1 Shelly **disabilita la connettività Cloud**. MQTT e Cloud non possono coesistere sullo stesso dispositivo.

## Come installare in TapHome

### Prerequisiti

- Dispositivo Shelly connesso al Wi-Fi (2,4 GHz), ad es. tramite l'app Shelly o l'access point del dispositivo stesso
- Broker MQTT attivo sulla rete locale (es. Mosquitto, Home Assistant o il broker integrato di TapHome)
- TapHome CCU sulla stessa rete del broker

> [!WARNING]
> Sui dispositivi **Gen1**, l'attivazione di MQTT **disabilita Shelly Cloud**. Entrambi non possono funzionare contemporaneamente. Sui dispositivi Gen2/Plus questa limitazione non si applica.

### Passaggio 1 — Abilitare MQTT sul dispositivo Shelly

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

1. Apri l'interfaccia web Shelly: `http://<device-ip>/`
2. Vai su **Internet & Security** → **Advanced — MQTT**
3. Abilita **MQTT**
4. Imposta **MQTT Server**: `<broker-ip>:<port>` (es. `192.168.1.10:1883`)
5. Opzionalmente imposta **MQTT User** e **MQTT Password** se il broker richiede l'autenticazione
6. Clicca su **Save** — il dispositivo si riavvierà e si connetterà al broker

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

1. Apri l'interfaccia web Shelly: `http://<device-ip>/`
2. Vai su **Settings** → **MQTT**
3. Abilita **MQTT**
4. Imposta **Server**: `<broker-ip>:<port>` (es. `192.168.1.10:1883`)
5. Il **Client ID** è precompilato con l'ID del dispositivo (es. `shellyplus1pm-AABBCCDDEE`) — lascialo così a meno che tu non abbia un motivo specifico per cambiarlo
6. Clicca su **Save** e riavvia il dispositivo

Con il broker integrato di TapHome, `<broker-ip>` è l'indirizzo IP del TapHome Core. Assegna al Core una prenotazione IP nel router, altrimenti il dispositivo perde il broker quando il router cambia l'indirizzo → [Preparazione della rete](https://taphome.com/it/docs/setup/network-preparation/).

> [!TIP]
> Per verificare che MQTT funzioni, usa un client MQTT (es. MQTT Explorer) e sottoscrivi `shellies/#` (Gen1) o `<device-id>/#` (Gen2). Dovresti vedere i messaggi di stato dal dispositivo.

### Passaggio 2 — Trovare il Device ID / MQTT Client ID

Alcuni template richiedono un parametro **Device ID** o **MQTT Client ID**. Questo è l'identificatore univoco utilizzato nei topic MQTT.

- **Gen1:** si trova sull'etichetta come indirizzo MAC (es. `AABBCCDDEE`). Device ID = `shelly<model>-<mac>`, es. `shelly1pm-AABBCCDDEE`
- **Gen2/Plus:** si trova nell'interfaccia web Shelly sotto **Settings** → **Device Info** → **Device ID**, oppure sull'etichetta del dispositivo

### Passaggio 3 — Configurazione in TapHome

1. In TapHome, aggiungi un nuovo modulo **Packet Parser (MQTT)**
2. **IP Address:** `127.0.0.1` per il broker integrato di TapHome (l'unità di controllo si connette a sé stessa, l'indirizzo non cambia mai); per un broker esterno il suo indirizzo IP (es. `192.168.1.10`)
3. **Port:** `1883` (predefinito; usa `8883` per TLS)
4. **Device ID / MQTT Client ID:** inserisci il valore dal passaggio 2 (se richiesto dal template)
5. Importa il template — TapHome si sottoscriverà automaticamente ai topic del dispositivo

## Dispositivi disponibili 5

Questi dispositivi compaiono in TapHome dopo l'importazione.

Shelly Motion 2 MQTT Modulo

Variabili personalizzate

`sensor1_topic` (string) = shellymotion2-deviceid ID dispositivo MQTT del sensore di movimento 1 — formato: 'shellymotion2-DEVICEID' (nell'interfaccia web Shelly → Settings → Device Info)

Open http://shellyIpAddress → Settings → Device info → copy Device ID. Format: shellymotion2-&lt;last6MAC&gt;

`sensor2_topic` (string) = shellymotion2-deviceid ID dispositivo MQTT del sensore di movimento 2 

`sensor3_topic` (string) = shellymotion2-deviceid ID dispositivo MQTT del sensore di movimento 3 

`sensor4_topic` (string) = shellymotion2-deviceid ID dispositivo MQTT del sensore di movimento 4 

`sensor5_topic` (string) = shellymotion2-deviceid ID dispositivo MQTT del sensore di movimento 5

Rilevatore di movimento 1 Contatto reed Solo lettura

Rilevamento movimento PIR — segnala allarme quando rileva movimento, OK senza movimento; analizza $.sensor.motion dal payload JSON /info

boolean

Attributi di servizio

|                   |
|-------------------|
| Indirizzo IP      |
| Indirizzo MAC     |
| Batteria          |
| Segnale           |
| Cloud abilitato   |
| Cloud connesso    |
| Ora dispositivo   |
| Luminanza         |
| Temperatura       |
| Tempo di attività |
| Versione FW       |
| Aggiornamento FW  |
| RAM libera        |
| Spazio FS libero  |

Listener

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

VAR topicPrefix := "shellies/" + sensor1_topic;

IF (INDEXOF(RECEIVEDMSG.TOPIC, topicPrefix + "/info") = 0)
    BOOL status := PARSEJSON(RECEIVEDMSG.PAYLOAD, "$.sensor.motion", 1);
    
    IF ISNULL(status)
        Rc := NaN;
    ELSE
        Rc := status;
    END
    
    VAR battery := PARSEJSON(RECEIVEDMSG.PAYLOAD, "$.bat.value");
    IF battery < 20
        ADDWARNING("Battery low (" + battery + "%)");
    END
END
```

Attributi di servizio

IP Address

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    RETURN(PARSEJSON(infoJson, "$.wifi_sta.ip"));
END
```

MAC Address

```taphome
IF(LENGTH(infoJson) = 0, "-", PARSEJSON(infoJson, "$.mac"));

IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    RETURN(PARSEJSON(infoJson, "$.mac"));
END
```

Battery

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    VAR voltage := PARSEJSON(infoJson, "$.bat.voltage");
    VAR percentage := PARSEJSON(infoJson, "$.bat.value");

    RETURN(voltage + "V (" + percentage + "%)");
END
```

Signal

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    RETURN(PARSEJSON(infoJson, "$.wifi_sta.rssi", 1) + "db");
END
```

Cloud enabled

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    RETURN(PARSEJSON(infoJson, "$.cloud.enabled"));
END
```

Cloud connected

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    RETURN(PARSEJSON(infoJson, "$.cloud.connected"));
END
```

Device time

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    RETURN(PARSEJSON(infoJson, "$.time"));
END
```

Luminance

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    RETURN(PARSEJSON(infoJson, "$.lux.value", 1) + "lux");
END
```

Temperature

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    RETURN(PARSEJSON(infoJson, "$.tmp.value", 1) + PARSEJSON(infoJson, "$.tmp.units", 1));
END
```

Uptime

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    VAR upTimeSeconds := PARSEJSON(infoJson, "$.uptime", 1);
    VAR days := FLOOR(upTimeSeconds/86400, 1);
    uptimeSeconds := MOD(upTimeSeconds, 86400);
    var hours := FLOOR(upTimeSeconds/3600, 1);
    uptimeSeconds := MOD(upTimeSeconds, 3600);
    var minutes := FLOOR(upTimeSeconds/60, 1);
    RETURN(days + "day(s) " + hours + "h " + minutes + "m");
END
```

FW version

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    RETURN(PARSEJSON(infoJson, "$.fw_info.fw"));
END
```

FW update

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    RETURN(PARSEJSON(infoJson, "$.update.has_update", 1));
END
```

Free RAM

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    VAR total := PARSEJSON(infoJson, "$.ram_total");
    VAR free := PARSEJSON(infoJson, "$.ram_free");
    RETURN(free + "/" + total + "(B)");
END
```

Free FS space

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    VAR total := PARSEJSON(infoJson, "$.fs_size");
    VAR free := PARSEJSON(infoJson, "$.fs_free");
    RETURN(free + "/" + total + "(B)");
END
```

Rilevatore di movimento 2 Contatto reed Solo lettura

Rilevamento movimento PIR — segnala allarme quando rileva movimento, OK senza movimento; analizza $.sensor.motion dal payload JSON /info

boolean

Attributi di servizio

|                   |
|-------------------|
| Indirizzo IP      |
| Indirizzo MAC     |
| Batteria          |
| Segnale           |
| Cloud abilitato   |
| Cloud connesso    |
| Ora dispositivo   |
| Luminanza         |
| Temperatura       |
| Tempo di attività |
| Versione FW       |
| Aggiornamento FW  |
| RAM libera        |
| Spazio FS libero  |

Listener

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

VAR topicPrefix := "shellies/" + sensor2_topic;

IF (INDEXOF(RECEIVEDMSG.TOPIC, topicPrefix + "/info") = 0)
    BOOL status := PARSEJSON(RECEIVEDMSG.PAYLOAD, "$.sensor.motion", 1);
    
    IF ISNULL(status)
        Rc := NaN;
    ELSE
        Rc := status;
    END
    
    VAR battery := PARSEJSON(RECEIVEDMSG.PAYLOAD, "$.bat.value");
    IF battery < 20
        ADDWARNING("Battery low (" + battery + "%)");
    END
END
```

Attributi di servizio

IP Address

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    RETURN(PARSEJSON(infoJson, "$.wifi_sta.ip"));
END
```

MAC Address

```taphome
IF(LENGTH(infoJson) = 0, "-", PARSEJSON(infoJson, "$.mac"));

IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    RETURN(PARSEJSON(infoJson, "$.mac"));
END
```

Battery

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    VAR voltage := PARSEJSON(infoJson, "$.bat.voltage");
    VAR percentage := PARSEJSON(infoJson, "$.bat.value");

    RETURN(voltage + "V (" + percentage + "%)");
END
```

Signal

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    RETURN(PARSEJSON(infoJson, "$.wifi_sta.rssi", 1) + "db");
END
```

Cloud enabled

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    RETURN(PARSEJSON(infoJson, "$.cloud.enabled"));
END
```

Cloud connected

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    RETURN(PARSEJSON(infoJson, "$.cloud.connected"));
END
```

Device time

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    RETURN(PARSEJSON(infoJson, "$.time"));
END
```

Luminance

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    RETURN(PARSEJSON(infoJson, "$.lux.value", 1) + "lux");
END
```

Temperature

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    RETURN(PARSEJSON(infoJson, "$.tmp.value", 1) + PARSEJSON(infoJson, "$.tmp.units", 1));
END
```

Uptime

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    VAR upTimeSeconds := PARSEJSON(infoJson, "$.uptime", 1);
    VAR days := FLOOR(upTimeSeconds/86400, 1);
    uptimeSeconds := MOD(upTimeSeconds, 86400);
    var hours := FLOOR(upTimeSeconds/3600, 1);
    uptimeSeconds := MOD(upTimeSeconds, 3600);
    var minutes := FLOOR(upTimeSeconds/60, 1);
    RETURN(days + "day(s) " + hours + "h " + minutes + "m");
END
```

FW version

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    RETURN(PARSEJSON(infoJson, "$.fw_info.fw"));
END
```

FW update

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    RETURN(PARSEJSON(infoJson, "$.update.has_update", 1));
END
```

Free RAM

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    VAR total := PARSEJSON(infoJson, "$.ram_total");
    VAR free := PARSEJSON(infoJson, "$.ram_free");
    RETURN(free + "/" + total + "(B)");
END
```

Free FS space

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    VAR total := PARSEJSON(infoJson, "$.fs_size");
    VAR free := PARSEJSON(infoJson, "$.fs_free");
    RETURN(free + "/" + total + "(B)");
END
```

Rilevatore di movimento 3 Contatto reed Solo lettura

Rilevamento movimento PIR — segnala allarme quando rileva movimento, OK senza movimento; analizza $.sensor.motion dal payload JSON /info

boolean

Attributi di servizio

|                   |
|-------------------|
| Indirizzo IP      |
| Indirizzo MAC     |
| Batteria          |
| Segnale           |
| Cloud abilitato   |
| Cloud connesso    |
| Ora dispositivo   |
| Luminanza         |
| Temperatura       |
| Tempo di attività |
| Versione FW       |
| Aggiornamento FW  |
| RAM libera        |
| Spazio FS libero  |

Listener

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

VAR topicPrefix := "shellies/" + sensor3_topic;

IF (INDEXOF(RECEIVEDMSG.TOPIC, topicPrefix + "/info") = 0)
    BOOL status := PARSEJSON(RECEIVEDMSG.PAYLOAD, "$.sensor.motion", 1);
    
    IF ISNULL(status)
        Rc := NaN;
    ELSE
        Rc := status;
    END
    
    VAR battery := PARSEJSON(RECEIVEDMSG.PAYLOAD, "$.bat.value");
    IF battery < 20
        ADDWARNING("Battery low (" + battery + "%)");
    END
END
```

Attributi di servizio

IP Address

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    RETURN(PARSEJSON(infoJson, "$.wifi_sta.ip"));
END
```

MAC Address

```taphome
IF(LENGTH(infoJson) = 0, "-", PARSEJSON(infoJson, "$.mac"));

IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    RETURN(PARSEJSON(infoJson, "$.mac"));
END
```

Battery

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    VAR voltage := PARSEJSON(infoJson, "$.bat.voltage");
    VAR percentage := PARSEJSON(infoJson, "$.bat.value");

    RETURN(voltage + "V (" + percentage + "%)");
END
```

Signal

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    RETURN(PARSEJSON(infoJson, "$.wifi_sta.rssi", 1) + "db");
END
```

Cloud enabled

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    RETURN(PARSEJSON(infoJson, "$.cloud.enabled"));
END
```

Cloud connected

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    RETURN(PARSEJSON(infoJson, "$.cloud.connected"));
END
```

Device time

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    RETURN(PARSEJSON(infoJson, "$.time"));
END
```

Luminance

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    RETURN(PARSEJSON(infoJson, "$.lux.value", 1) + "lux");
END
```

Temperature

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    RETURN(PARSEJSON(infoJson, "$.tmp.value", 1) + PARSEJSON(infoJson, "$.tmp.units", 1));
END
```

Uptime

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    VAR upTimeSeconds := PARSEJSON(infoJson, "$.uptime", 1);
    VAR days := FLOOR(upTimeSeconds/86400, 1);
    uptimeSeconds := MOD(upTimeSeconds, 86400);
    var hours := FLOOR(upTimeSeconds/3600, 1);
    uptimeSeconds := MOD(upTimeSeconds, 3600);
    var minutes := FLOOR(upTimeSeconds/60, 1);
    RETURN(days + "day(s) " + hours + "h " + minutes + "m");
END
```

FW version

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    RETURN(PARSEJSON(infoJson, "$.fw_info.fw"));
END
```

FW update

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    RETURN(PARSEJSON(infoJson, "$.update.has_update", 1));
END
```

Free RAM

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    VAR total := PARSEJSON(infoJson, "$.ram_total");
    VAR free := PARSEJSON(infoJson, "$.ram_free");
    RETURN(free + "/" + total + "(B)");
END
```

Free FS space

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    VAR total := PARSEJSON(infoJson, "$.fs_size");
    VAR free := PARSEJSON(infoJson, "$.fs_free");
    RETURN(free + "/" + total + "(B)");
END
```

Rilevatore di movimento 4 Contatto reed Solo lettura

Rilevamento movimento PIR — segnala allarme quando rileva movimento, OK senza movimento; analizza $.sensor.motion dal payload JSON /info

boolean

Attributi di servizio

|                   |
|-------------------|
| Indirizzo IP      |
| Indirizzo MAC     |
| Batteria          |
| Segnale           |
| Cloud abilitato   |
| Cloud connesso    |
| Ora dispositivo   |
| Luminanza         |
| Temperatura       |
| Tempo di attività |
| Versione FW       |
| Aggiornamento FW  |
| RAM libera        |
| Spazio FS libero  |

Listener

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

VAR topicPrefix := "shellies/" + sensor4_topic;

IF (INDEXOF(RECEIVEDMSG.TOPIC, topicPrefix + "/info") = 0)
    BOOL status := PARSEJSON(RECEIVEDMSG.PAYLOAD, "$.sensor.motion", 1);
    
    IF ISNULL(status)
        Rc := NaN;
    ELSE
        Rc := status;
    END
    
    VAR battery := PARSEJSON(RECEIVEDMSG.PAYLOAD, "$.bat.value");
    IF battery < 20
        ADDWARNING("Battery low (" + battery + "%)");
    END
END
```

Attributi di servizio

IP Address

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    RETURN(PARSEJSON(infoJson, "$.wifi_sta.ip"));
END
```

MAC Address

```taphome
IF(LENGTH(infoJson) = 0, "-", PARSEJSON(infoJson, "$.mac"));

IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    RETURN(PARSEJSON(infoJson, "$.mac"));
END
```

Battery

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    VAR voltage := PARSEJSON(infoJson, "$.bat.voltage");
    VAR percentage := PARSEJSON(infoJson, "$.bat.value");

    RETURN(voltage + "V (" + percentage + "%)");
END
```

Signal

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    RETURN(PARSEJSON(infoJson, "$.wifi_sta.rssi", 1) + "db");
END
```

Cloud enabled

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    RETURN(PARSEJSON(infoJson, "$.cloud.enabled"));
END
```

Cloud connected

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    RETURN(PARSEJSON(infoJson, "$.cloud.connected"));
END
```

Device time

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    RETURN(PARSEJSON(infoJson, "$.time"));
END
```

Luminance

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    RETURN(PARSEJSON(infoJson, "$.lux.value", 1) + "lux");
END
```

Temperature

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    RETURN(PARSEJSON(infoJson, "$.tmp.value", 1) + PARSEJSON(infoJson, "$.tmp.units", 1));
END
```

Uptime

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    VAR upTimeSeconds := PARSEJSON(infoJson, "$.uptime", 1);
    VAR days := FLOOR(upTimeSeconds/86400, 1);
    uptimeSeconds := MOD(upTimeSeconds, 86400);
    var hours := FLOOR(upTimeSeconds/3600, 1);
    uptimeSeconds := MOD(upTimeSeconds, 3600);
    var minutes := FLOOR(upTimeSeconds/60, 1);
    RETURN(days + "day(s) " + hours + "h " + minutes + "m");
END
```

FW version

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    RETURN(PARSEJSON(infoJson, "$.fw_info.fw"));
END
```

FW update

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    RETURN(PARSEJSON(infoJson, "$.update.has_update", 1));
END
```

Free RAM

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    VAR total := PARSEJSON(infoJson, "$.ram_total");
    VAR free := PARSEJSON(infoJson, "$.ram_free");
    RETURN(free + "/" + total + "(B)");
END
```

Free FS space

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    VAR total := PARSEJSON(infoJson, "$.fs_size");
    VAR free := PARSEJSON(infoJson, "$.fs_free");
    RETURN(free + "/" + total + "(B)");
END
```

Rilevatore di movimento 5 Contatto reed Solo lettura

Rilevamento movimento PIR — segnala allarme quando rileva movimento, OK senza movimento; analizza $.sensor.motion dal payload JSON /info

boolean

Attributi di servizio

|                   |
|-------------------|
| Indirizzo IP      |
| Indirizzo MAC     |
| Batteria          |
| Segnale           |
| Cloud abilitato   |
| Cloud connesso    |
| Ora dispositivo   |
| Luminanza         |
| Temperatura       |
| Tempo di attività |
| Versione FW       |
| Aggiornamento FW  |
| RAM libera        |
| Spazio FS libero  |

Listener

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

VAR topicPrefix := "shellies/" + sensor5_topic;

IF (INDEXOF(RECEIVEDMSG.TOPIC, topicPrefix + "/info") = 0)
    BOOL status := PARSEJSON(RECEIVEDMSG.PAYLOAD, "$.sensor.motion", 1);
    
    IF ISNULL(status)
        Rc := NaN;
    ELSE
        Rc := status;
    END
    
    VAR battery := PARSEJSON(RECEIVEDMSG.PAYLOAD, "$.bat.value");
    IF battery < 20
        ADDWARNING("Battery low (" + battery + "%)");
    END
END
```

Attributi di servizio

IP Address

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    RETURN(PARSEJSON(infoJson, "$.wifi_sta.ip"));
END
```

MAC Address

```taphome
IF(LENGTH(infoJson) = 0, "-", PARSEJSON(infoJson, "$.mac"));

IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    RETURN(PARSEJSON(infoJson, "$.mac"));
END
```

Battery

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    VAR voltage := PARSEJSON(infoJson, "$.bat.voltage");
    VAR percentage := PARSEJSON(infoJson, "$.bat.value");

    RETURN(voltage + "V (" + percentage + "%)");
END
```

Signal

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    RETURN(PARSEJSON(infoJson, "$.wifi_sta.rssi", 1) + "db");
END
```

Cloud enabled

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    RETURN(PARSEJSON(infoJson, "$.cloud.enabled"));
END
```

Cloud connected

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    RETURN(PARSEJSON(infoJson, "$.cloud.connected"));
END
```

Device time

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    RETURN(PARSEJSON(infoJson, "$.time"));
END
```

Luminance

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    RETURN(PARSEJSON(infoJson, "$.lux.value", 1) + "lux");
END
```

Temperature

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    RETURN(PARSEJSON(infoJson, "$.tmp.value", 1) + PARSEJSON(infoJson, "$.tmp.units", 1));
END
```

Uptime

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    VAR upTimeSeconds := PARSEJSON(infoJson, "$.uptime", 1);
    VAR days := FLOOR(upTimeSeconds/86400, 1);
    uptimeSeconds := MOD(upTimeSeconds, 86400);
    var hours := FLOOR(upTimeSeconds/3600, 1);
    uptimeSeconds := MOD(upTimeSeconds, 3600);
    var minutes := FLOOR(upTimeSeconds/60, 1);
    RETURN(days + "day(s) " + hours + "h " + minutes + "m");
END
```

FW version

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    RETURN(PARSEJSON(infoJson, "$.fw_info.fw"));
END
```

FW update

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    RETURN(PARSEJSON(infoJson, "$.update.has_update", 1));
END
```

Free RAM

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    VAR total := PARSEJSON(infoJson, "$.ram_total");
    VAR free := PARSEJSON(infoJson, "$.ram_free");
    RETURN(free + "/" + total + "(B)");
END
```

Free FS space

```taphome
IF LENGTH(infoJson) = 0
    RETURN("-");
ELSE
    VAR total := PARSEJSON(infoJson, "$.fs_size");
    VAR free := PARSEJSON(infoJson, "$.fs_free");
    RETURN(free + "/" + total + "(B)");
END
```

**Connessione:** Packet Parser → MQTT • Hostname: `shellymotion2-{MAC}.local`

Possibili miglioramenti (4)

- Vibration / Tamper Detection — Vibration/tamper detection (bool). Available in the /info JSON but not parsed by the listener script. Configurable sensitivity 0-80.
- Illumination Category — Light category string — dark/twilight/bright. Available in /info but only numeric lux is parsed via service attributes.
- USB Charger Connected — Whether USB-C charger is plugged in. Available in /info JSON.
- Connection Status — LWT topic — true on connect, false on disconnect. Could detect offline sensors.

## Parametri di importazione

Inserisci questi valori quando importi l'XML.

| Richiesto nell'app       | Predefinito   |
|--------------------------|---------------|
| Mqtt Broker Indirizzo IP | `192.168.0.1` |
| Mqtt Broker port         | `1883`        |

## Fonti

- Shelly Gen1 API Reference
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen1/) 2026-03-12
- Home Assistant Shelly Integration
  
  [www.home-assistant.io](https://www.home-assistant.io/integrations/shelly/) 2026-03-12
- Shelly Motion 2 — Device-Specific API
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen1/#shelly-motion-2) 2026-03-30
- Shelly Motion 2 — Knowledge Base
  
  [kb.shelly.cloud](https://kb.shelly.cloud/knowledge-base/shelly-motion-2) 2026-03-30

## Documentazione correlata

- [MQTT Integration](https://taphome.com/it/compatibility/mqtt-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/it/docs/integration/packet-parser/)
- [Funzioni Packet parser](https://taphome.com/it/docs/script/packet-parser/)
- [Funzioni di parsing](https://taphome.com/it/docs/script/parsing-functions/)
- [Broker MQTT](https://taphome.com/it/docs/integration/packet-parser/mqtt-broker/)
- [Script listener](https://taphome.com/it/docs/script/listener-scripts/)