> For the complete documentation index, see [llms.txt](https://documentation.nomos-system.com/nomos-system/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.nomos-system.com/nomos-system/integratore-it/funzioni/rilevamento-presenza.md).

# Rilevamento presenza

Il rilevamento presenza unisce i componenti di sua scelta in un'unica risposta: **c'è qualcuno sul posto?** Questa risposta è disponibile come dispositivo di nome **Presenza** — automazioni, scene e la registrazione d'uso lavorano con essa, e l'app lo mostra come qualsiasi altro dispositivo.

Quali componenti siano adatti lo decide lei: sensori di movimento e sensori di presenza, contatti porta, ma anche interruttori o gli stati di altri sistemi — tutto ciò che dimostra che c'è qualcuno.

## Ingressi

Un ingresso è un componente e uno dei suoi valori di stato. Ne esistono due tipi:

* **Presenza e assenza** — ingressi bidirezionali che possono segnalare entrambe, come una centrale di allarme o la segnalazione di presenza di un altro sistema.
* **Solo presenza** — ingressi che dimostrano che c'è qualcuno, ma mai il contrario. Un sensore di movimento appartiene a questa categoria: chi dorme non lo fa scattare.

Almeno un ingresso bidirezionale deve poter segnalare assenza, altrimenti la presenza resterebbe accesa per sempre. La pagina glielo fa notare finché manca.

Per ogni ingresso sceglie l'**interpretazione**: o *acceso* significa presente (su richiesta invertito), oppure inserisce **valori specifici** — una centrale che segnala HOME, AWAY, NIGHT, OFF e ALARM è *un* ingresso con elenchi di valori (presenza: HOME, ALARM — assenza: AWAY). Usi ogni componente con ogni valore di stato una volta sola.

Due tempi rendono l'interpretazione pratica:

* **Tolleranza** — per quanto tempo un ingresso conta ancora come presente dopo essere caduto. Alcune sorgenti spariscono per un momento e rispondono di nuovo qualche minuto dopo; senza tolleranza ognuna di queste pause conterebbe subito come assenza.
* **Tempo di mantenimento** — per quanto tempo un ingresso «solo presenza» continua a contare dopo l'ultimo scatto.

## Comando manuale

La presenza può essere impostata a mano in qualsiasi momento — nell'app sul dispositivo (Automatico, Presente, Assente) o tramite scene. La **modalità** decide per quanto tempo vale un simile comando:

* **Assistita** — un *assente* impostato a mano viene annullato appena un ingresso segnala qualcuno. Altrimenti si avvierebbe ciò che dipende dall'assenza mentre c'è qualcuno sul posto.
* **A tempo** — come *Assistita*, in più il comando scade da solo dopo il tempo impostato.
* **Fissa** — il comando resta finché non viene revocato a mano. Gli ingressi vengono allora solo registrati.

## Avvio rapido

Due modelli creano, una sola volta, ciò che la maggior parte degli impianti costruisce comunque:

* **Scene per commutare a mano** — le scene *A casa* e *Assente*, da premere nell'app o da collegare a un pulsante.
* **Automazione sul cambio di stato** — due messaggi di registro e un'automazione che li scrive: l'uno appena qualcuno è sul posto, l'altro appena non c'è più nessuno. Ciò che deve accadere in più lo inserisce direttamente nell'automazione.

Quanto ne risulta è poi suo: può rinominarlo, modificarlo o eliminarlo — la funzione non lo tocca mai più.

## Il dispositivo «Presenza»

All'attivazione la funzione crea il dispositivo **Presenza**. Mostra lo stato attuale, accoglie il comando manuale ed è a disposizione di automazioni e scene come trigger e condizione. Come ogni dispositivo può rinominarlo e assegnarlo a una stanza — si può eliminare solo reimpostando la funzione.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://documentation.nomos-system.com/nomos-system/integratore-it/funzioni/rilevamento-presenza.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
