---
title: "Centrali d'allarme Paradox tramite PAI (MQTT)"
description: "Collega le centrali Paradox Spectra SP, Magellan MG e Digiplex EVO a TapHome via MQTT con il bridge open source PAI — partizione, zone e uscita PGM."
url: "https://taphome.com/it/compatibility/paradox-pai-mqtt/"
language: it
lastmod: 2026-11-04
generator: hugo
ai:
  topics: ["mqtt","alarm-system","security","zone-monitoring","arming","open-source-bridge"]
  questions: ["Come comunica un allarme Paradox con TapHome?","Esiste un template TapHome per le centrali d'allarme Paradox?","TapHome può inserire e disinserire un allarme Paradox Spectra o Magellan?","Cosa serve per collegare un allarme Paradox a TapHome via MQTT?","Perché PAI non si collega alla mia centrale Paradox SP6000+ o MG5050+?","Come collegare un allarme Paradox a TapHome senza PAI?"]
---

# Centrali d'allarme Paradox tramite PAI (MQTT)

Comunicazione: Packet Parser → MQTT

- [Sito ufficiale Paradox](https://www.paradox.com)
- [PAI — Paradox Alarm Interface (GitHub)](https://github.com/ParadoxAlarmInterface/pai)
- [PAI — interfaccia MQTT (wiki)](https://github.com/ParadoxAlarmInterface/pai/wiki/MQTT-Interface)

Il template Paradox PAI collega le centrali d'allarme Paradox — Spectra SP, Magellan MG e Digiplex EVO — a TapHome via MQTT tramite PAI, il Paradox Alarm Interface. PAI è un bridge open source, non un prodotto Paradox. Gira su un piccolo computer vicino alla centrale (ad esempio un Raspberry Pi, un NAS o un computer con Home Assistant), comunica con la centrale tramite la sua porta seriale o un modulo IP150 e pubblica lo stato della centrale su un broker MQTT. TapHome legge questi messaggi e rimanda i comandi di inserimento. Paradox non pubblica il protocollo che PAI utilizza.

Il template mostra lo stato di una partizione e la inserisce o la disinserisce, mostra quattro zone con i loro avvisi e comanda un'uscita PGM. Per le centrali Digiplex EVO con il modulo PRT3 esiste un template separato che utilizza il protocollo ufficiale di Paradox e non richiede un computer: [Paradox Digiplex EVO tramite PRT3 (TCP)](https://taphome.com/it/compatibility/paradox-evo-prt3-tcp/).

> [!WARNING]
> **Template della community — non ancora testato con TapHome su una centrale reale.** Il template è stato generato nel portale TapHome dalla documentazione di PAI ed è stato testato solo con un PAI e una centrale simulati su un TapHome Core 2025.2 locale, non con una vera centrale Paradox. Verificalo sulla tua installazione prima di affidarti a esso per la sicurezza; i riscontri dal campo sono benvenuti. Scarica l'XML da questa pagina o dal portale TapHome: [Paradox tramite PAI — template della community](https://portal.taphome.com/portal/community/paradox-pai-mqtt), e importalo come nuovo modulo.

**[Paradox alarm (Spectra SP, Magellan MG, Digiplex EVO) through PAI over MQTT](https://portal.taphome.com/it/portal/community/paradox-pai-mqtt)** — Paradox, MQTT. Paradox SP, MG and EVO panels through PAI, the open-source Paradox Alarm Interface, over MQTT: partition arming and state, four zones with alarm, tamper and low-battery warnings, one PGM output.

> [!DANGER]
> **Sicurezza: chi può pubblicare sul broker può disinserire l'allarme.** PAI inserisce e disinserisce la centrale **senza il codice utente** della centrale. Attiva nome utente e password sul broker MQTT (il broker integrato in TapHome lo supporta) e inseriscili in PAI e in questo template.

## Centrali supportate

| Serie | Modelli | Note |
|---|---|---|
| Spectra SP | SP4000, SP5500, SP6000, SP7000, SP65 | Sui modelli "+" (SP5500+, SP6000+, SP7000+) la porta seriale è bloccata per i dispositivi di altri produttori. Paradox vende un codice di sblocco, oppure collega PAI tramite un IP150 |
| Magellan MG | MG5000, MG5050, MG5050+, MG5075 | Anche la MG5050+ ha la porta seriale bloccata. La MG6250 è solo sperimentale in PAI |
| Digiplex EVO | EVO48, EVO96, EVO192, EVOHD | Il firmware EVO 7.50 e successivi cifra la porta seriale; PAI 3.8 lo gestisce con la password PC. EVO non ha l'inserimento Sleep |

## Collegamento hardware

PAI si collega alla centrale in uno di questi modi:

- **Porta seriale della centrale** — con un adattatore USB-TTL verso il computer con PAI, oppure con un bridge seriale ESP32 sulla rete locale.
- **Modulo IP150** sulla rete locale. Un IP150 accetta un solo client alla volta: mentre PAI è collegato, le app Paradox Insite Gold e BlueEye non possono collegarsi tramite lo stesso modulo. Un IP150+ con firmware 6.x e l'IP180 non consentono il collegamento locale.

Il computer con PAI e il TapHome Core devono raggiungere lo stesso broker MQTT — di solito il broker integrato nel TapHome Core.

## Configurazione

### Broker MQTT in TapHome

Attiva il MQTT Broker in TapHome e imposta nome utente e password — vedi [MQTT Broker](https://taphome.com/it/docs/integration/packet-parser/mqtt-broker/). PAI e questo template li usano per accedere al broker.

### PAI

Nella configurazione di PAI, indirizza MQTT al broker che usa TapHome. Per il broker integrato in TapHome è l'indirizzo IP del TapHome Core — il nome `taphome.mqtt.broker.local` funziona solo all'interno del Core, non per PAI:

```yaml
MQTT_ENABLE: true
MQTT_HOST: 192.168.1.10        # IP address of the TapHome Core with the built-in broker
MQTT_PORT: 1883
MQTT_USERNAME: pai
MQTT_PASSWORD: 'replace-me'
MQTT_BASE_TOPIC: paradox
MQTT_RETAIN: true              # default: the broker keeps the last state for TapHome
```

`MQTT_USE_NUMERIC_STATES` può restare al valore predefinito (`False`); il template legge sia `True`/`False` sia `1`/`0`.

### Chiavi di partizione, zone e PGM

PAI chiama ogni partizione, zona e PGM con il suo nome nella centrale, sostituendo spazi e caratteri speciali con `_` (ad esempio `Front door` → `Front_door`). Leggi le chiavi dal broker dopo l'avvio di PAI, ad esempio:

```
mosquitto_sub -h 192.168.1.10 -u pai -P 'replace-me' -t 'paradox/states/#' -v
```

```
paradox/states/partitions/Area_1/current_state disarmed
paradox/states/zones/Front_door/open False
paradox/states/outputs/Gate/on False
```

La parte dopo `partitions/`, `zones/` e `outputs/` è la chiave. Le chiavi distinguono maiuscole e minuscole.

### Parametri di importazione

| Parametro di importazione | Descrizione | Predefinito |
|---|---|---|
| Indirizzo del broker MQTT | `taphome.mqtt.broker.local` per il broker integrato in TapHome, oppure l'indirizzo di un altro broker | `taphome.mqtt.broker.local` |
| Porta del broker MQTT | Porta del broker | `1883` |
| Nome utente e password del broker MQTT | L'account del broker | (vuoto) |
| Topic di base di PAI | `MQTT_BASE_TOPIC` di PAI | `paradox` |
| Chiave della partizione | Chiave della partizione | `Area_1` |
| Chiavi delle zone 1–4 | Chiavi di quattro zone | `Zone_1` … `Zone_4` |
| Chiave dell'uscita PGM | Chiave di un'uscita PGM | `PGM_1` |

Per altre partizioni o zone, importa di nuovo il template con altre chiavi ed elimina i dispositivi che non ti servono.

## Funzionalità dei dispositivi

### Partizione

Mostra lo stato della partizione e la inserisce o la disinserisce.

| Stato | PAI `current_state` | Quando selezionato in TapHome |
|---|---|---|
| Disinserito | `disarmed` | invia `disarm` |
| Inserito | `armed_away` | invia `arm` |
| Inserito Stay | `armed_home` | invia `arm_stay` |
| Inserito Sleep | `armed_night` | invia `arm_sleep` (solo SP e MG) |
| Inserimento | `arming` (ritardo di uscita) | non invia nulla |
| Allarme | `triggered` | non invia nulla |

I comandi vengono pubblicati su `paradox/control/partitions/<key>` senza il flag retain, come richiede PAI. Inserimento e Allarme sono stati segnalati dalla centrale e non inviano mai un comando. All'avvio del TapHome Core, la partizione prende il suo stato dal messaggio conservato (retained) di PAI e non invia nulla.

### Zone 1–4

Ogni zona mostra se è aperta o chiusa. Gli avvisi compaiono quando la zona è in allarme, manomessa o esclusa, oppure quando una zona senza fili ha la batteria scarica. Ogni avviso resta finché PAI non segnala che lo stato è cessato.

### Uscita PGM

Accende o spegne un'uscita PGM della centrale e ne mostra lo stato. Se una PGM può essere comandata dipende dalla centrale e da come l'ha programmata l'installatore. All'avvio del TapHome Core, la PGM prende il suo stato da PAI e non viene commutata.

### Modulo

Il modulo mostra un errore quando PAI si segnala offline (`paradox/interface/availability`), ad esempio quando PAI ha perso il collegamento con la centrale o si è fermato.

## Senza PAI

Un'uscita PGM della centrale collegata a un ingresso TapHome (inserito, allarme) e un relè TapHome collegato a una zona a chiave della centrale funzionano con ogni centrale Paradox, con meno stati e senza i dettagli delle zone.

## Risoluzione dei problemi

### Nessuno stato in TapHome

Verifica che PAI sia in funzione e pubblichi (`mosquitto_sub … -t 'paradox/#'`), che il topic di base e le chiavi corrispondano esattamente e che in PAI sia attivo `MQTT_RETAIN`.

### L'inserimento non fa nulla

Verifica che PAI e TapHome usino lo stesso broker e leggi in `paradox/interface/command_status` la risposta di PAI. Su EVO l'inserimento Sleep non è disponibile.

### Errore del modulo "PAI reports offline"

PAI ha perso la centrale o si è fermato; consulta il log di PAI.

### PAI non si collega alla centrale

Su SP5500+, SP6000+, SP7000+ e MG5050+ la porta seriale è bloccata — chiedi a Paradox il codice di sblocco oppure collegati tramite un IP150. Mentre PAI è collegato tramite un IP150, chiudi Insite Gold e BlueEye. Un IP150+ con firmware 6.x e un IP180 non consentono a PAI il collegamento locale.

## Dispositivi disponibili

Bridge MQTT Paradox PAI Modulo

Variabili personalizzate

`baseTopic` (string) Topic di base di PAI (MQTT\_BASE\_TOPIC nella configurazione di PAI), predefinito paradox

Enter the same value as MQTT\_BASE\_TOPIC in the PAI configuration as the import parameter PAI base topic.

Partizione Interruttore multivalore

Stato di una partizione della centrale e suo inserimento o disinserimento; Inserimento e Allarme sono solo mostrati e non inviano nulla

enum string

Valori / Stati: Disinserito · Inserito · Inserito Stay · Inserito Sleep · Inserimento · Allarme

Variabile: `partitionKey` — Chiave della partizione come PAI la pubblica in paradox/states/partitions/&lt;chiave&gt;, ad esempio Area\_1

Zona 1 Contatto reed Solo lettura

Stato di una zona della centrale (aperta o chiusa), con avvisi per allarme, manomissione, batteria scarica di una zona senza fili ed esclusione

boolean

Variabile: `zoneKey` — Chiave della zona come PAI la pubblica in paradox/states/zones/&lt;chiave&gt;, ad esempio Front\_door

Zona 2 Contatto reed Solo lettura

Stato di una zona della centrale (aperta o chiusa), con avvisi per allarme, manomissione, batteria scarica di una zona senza fili ed esclusione

boolean

Variabile: `zoneKey` — Chiave della zona come PAI la pubblica in paradox/states/zones/&lt;chiave&gt;, ad esempio Front\_door

Zona 3 Contatto reed Solo lettura

Stato di una zona della centrale (aperta o chiusa), con avvisi per allarme, manomissione, batteria scarica di una zona senza fili ed esclusione

boolean

Variabile: `zoneKey` — Chiave della zona come PAI la pubblica in paradox/states/zones/&lt;chiave&gt;, ad esempio Front\_door

Zona 4 Contatto reed Solo lettura

Stato di una zona della centrale (aperta o chiusa), con avvisi per allarme, manomissione, batteria scarica di una zona senza fili ed esclusione

boolean

Variabile: `zoneKey` — Chiave della zona come PAI la pubblica in paradox/states/zones/&lt;chiave&gt;, ad esempio Front\_door

Uscita PGM Interruttore

Accende o spegne un'uscita programmabile (PGM) della centrale e ne mostra lo stato

boolean

Valori / Stati: ON · OFF

Variabile: `outputKey` — Chiave dell'uscita PGM come PAI la pubblica in paradox/states/outputs/&lt;chiave&gt;

**Connessione:** Packet Parser → MQTT

Possibili miglioramenti (6)

- Zone bypass control — The template shows the bypass state of a zone as a warning but does not bypass a zone.
- Force arming and EVO instant arming — arm\_instant exists on EVO panels only; EVO has no Sleep arming, so Armed Sleep does nothing there.
- Panic alarms — Left out on purpose: a panic command triggers a real alarm report.
- System trouble flags — Trouble flags of the panel that PAI publishes under states/system/troubles.
- Event stream — Live panel events PAI publishes as JSON when MQTT\_PUBLISH\_RAW\_EVENTS is on.
- More partitions, zones and PGM outputs — The template has one partition, four zones and one PGM. Import it again with other keys for more.

## Fonti

- PAI — Paradox Alarm Interface, project README (version 3.8.1)
  
  [github.com](https://github.com/ParadoxAlarmInterface/pai) 2026-11-04
- PAI wiki — MQTT Interface (topics, states, control commands)
  
  [github.com](https://github.com/ParadoxAlarmInterface/pai/wiki/MQTT-Interface) 2026-11-04
- PAI — example configuration pai.conf.example
  
  [raw.githubusercontent.com](https://raw.githubusercontent.com/ParadoxAlarmInterface/pai/master/config/pai.conf.example) 2026-11-04
- PAI wiki — Compatibility (panels, firmware, connections)
  
  [github.com](https://github.com/ParadoxAlarmInterface/pai/wiki/Compatibility) 2026-11-04
- PAI wiki — Connection methods (serial, IP150, ESP32 bridge)
  
  [github.com](https://github.com/ParadoxAlarmInterface/pai/wiki/Connection-methods) 2026-11-04

## 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/)

