MMM-PIR-Sensor.md

layout	permalink
noheader	/:path/:basename:output_ext

MMM-PIR-Sensor

tl;dr

Interagisce con un sensore PIR (di movimento / di presenza) per attivare la modalità di sospensione del MagicMirror quando necessario.

---

Config JSON Fragment

{
    "module": "MMM-PIR-Sensor",
    "position": "bottom_right",
    "config": {
        "sensorPin": 17,
        "powerSaving": true,
        "powerSavingDelay": 900,
        "powerSavingNotification": false,
        "powerSavingMessage": "Attivazione modalità sospensione...",
        "preventHDMITimeout": 5,
        "presenceIndicatorColor": "white",
        "runSimulator": false
    }
}

---

Proprietà (Config Section)

Proprietà	Tipo	Valori	Valore Default	Inderogabilità	Descrizione
sensorPin	Integer	Qualsiasi valore numerico di pin GPIO valido. Qui maggiori dettagli: https://www.raspberrypi.org/documentation/usage/gpio/, https://pinout.xyz/	22	OPTIONAL	Pin GPIO al quale il sensore interno del MagicMirror è connesso. E' sconsigliata la modifica di questa proprietà.
powerSaving	Boolean	true: Il modulo esegue il suo scopo. false: Il modulo non esegue il suo scopo (è disattivato).	true	OPTIONAL	Attiva o disattiva l'esecuzione da parte del modulo del suo scopo di esistenza.
powerSavingDelay	Integer	Valore numerico x (secondi), con x >= 0. 0 disattiva questa funzione.	0	OPTIONAL	Delay prima di entrare in modalità sospensione. Il conteggio inizia da quando il sensore non rileva più una presenza.
powerSavingNotification	Boolean	true: Attiva la visualizzazione di una notifica prima dell'entrata in modalità sospensione. false: Disattiva la visualizzazione di una notifica prima dell'entrata in modalità sospensione.	false	OPTIONAL	Attiva o disattiva la visualizzazione di una notifica prima dell'entrata in modalità sospensione.
powerSavingMessage	String	Qualsiasi stringa.	"Monitor will be turn Off by PIR module"	OPTIONAL	Contenuto del messaggio visualizzato prima dell'entrata in modalità sospensione. Visualizzazione solo se il valore della proprietà powerSavingNotification è true.
preventHDMITimeout	Integer	Valore numerico x (minuti), con 0 <= x <= 10. 0 disattiva questa funzione.	0	OPTIONAL	Attiva o disattiva l'entrata e uscita intermittente dalla modalità sospensione. Questo permette di evitare lo spegnimento automaticato per alcuni schermi la cui configurazione causa lo spegnimento in assenza di segnale.
presenceIndicator	String	Nome icona da Font Awesome https://fontawesome.com/icons?d=gallery. null: Disattiva questa opzione.	"fa-bullseye"	OPTIONAL	Icona da visualizzare se una presenza (dell'utente) è rilevata.
presenceIndicatorColor	String	Qualsiasi stringa figurante un colore CSS valida.	"red"	OPTIONAL	Colore dell'icona descritta dalla proprietà presenceIndicator.
runSimulator	Boolean	true: Attiva la modalità simulazione del modulo. false: Disattiva la modalità simulazione del modulo.	false	OPTIONAL	Attiva o disattiva la modalità simulazione del modulo. Questa modalità è progettata a scopo di debug. In release, il valore di questa proprietà DEVE ESSERE false. E' sconsigliata la modifica di questa proprietà.

---

Notifiche

Le notifiche sono uno strumento utilizzato dai moduli per comunicare con:

• L'OS del MagicMirror
• Altri moduli
• Attori umani

Notifica	Direzione	Trigger	Payload (inline js)	Descrizione
USER_PRESENCE	OUT	Cambio di stato.	{Boolean value}	Valore indicante lo stato di rilevazione della presenza (dell'utente).

---

Screenshots

Icona visualizzata dal modulo se una presenza è rilevata:

Notifica visualizzata prima dell'entrata in modalità sospensione:

---

MagicMirror Default Hardware

Il sensore interno del MagicMirror è il HC-SR501. Il pin GPIO utilizzato dal sensore è il GPIO/BCM 17 https://it.pinout.xyz/pinout/pin11_gpio17.

pin GPIO

Presta Attenzione: i pin GPIO del Raspberry Pi possono essere riferiti seguendo (molti) diversi standard. La proprietà sensorPin del modulo utilizza lo standard evidenziato in giallo: