Manuale Interattivo: Bridge MQTT per BMS15

Cos'è il Bridge MQTT BMS15?

È un componente software fondamentale per l'integrazione del sistema di gestione BMS15 con il moderno panorama **IoT (Internet of Things)**. Agisce come un client MQTT all'avanguardia, focalizzato su robustezza, diagnostica chiara e massima aderenza agli standard, offrendo pieno supporto a **MQTT v5.0** per un'efficienza e versatilità superiori.

Introduzione a MQTT

**MQTT (Message Queuing Telemetry Transport)** è un protocollo leggero basato sul modello **pubblica/sottoscrivi**. Utilizza un intermediario centrale (Broker) per disaccoppiare chi invia i dati (Publisher) da chi li riceve (Subscriber). Questo modello è ideale per sistemi complessi e distribuiti come BMS15, garantendo comunicazioni scalabili ed efficienti per dispositivi IoT e reti inaffidabili.

Il Contesto BMS15

Il Bridge agisce come traduttore, consentendo al sistema BMS15 (che gestisce automazione di hotel, building automation, domotica, e controllo accessi) di **pubblicare** stati e dati di sensoristica verso piattaforme IoT e di **sottoscriversi** a comandi da remoto, inoltrandoli al motore BMS15 per l'esecuzione.

Architettura e Affidabilità

Il Bridge è costruito su un'architettura **resistente ai guasti**, supportando fino a 10 broker in configurazione multi-broker per garantire massima disponibilità e flessibilità.

Affidabilità

Implementa il reconnect con backoff esponenziale e utilizza code protette da overflow.

Sicurezza

Supporta TLS 1.2 con caricamento di Certificate Authorities (CA) per connessioni sicure.

Keep-Alive Intelligente

L'engine KA è basato su timer di trasmissione reale, inviando PING al 75% del KA effettivo.

Funzionalità Negoziate alla Connessione

Queste capacità sono concordate con il broker all'avvio della connessione e ottimizzano il comportamento del client per massima stabilità ed efficienza. Clicca su una card per i dettagli.

Proprietà Avanzate dei Messaggi

MQTT v5 arricchisce i messaggi con metadati che abilitano un routing intelligente e una gestione efficiente dei dati.

Diagnostica Migliorata con ACK v5

Tutti i messaggi di conferma (ACK) ora includono un **Reason Code** specifico. Invece di un generico "Fallito", il log mostrerà "SUBACK Refused: Reason Code = 135 (Topic Filter Invalid)", accelerando drasticamente il troubleshooting.

Flusso Dati in Uscita (Client → Broker)

Il Bridge è progettato per rispettare rigorosamente i limiti imposti dal broker, prevenendo errori e sovraccarichi. Il flusso di pubblicazione include controlli automatici che garantiscono la stabilità della comunicazione.

1. Client Pubblica

→

2. Controllo Throttle

(Rispetta Receive Maximum)

→

3. Controllo Dimensione

(Rispetta Max Packet Size)

→

4. Invio al Broker

Flusso Dati in Ingresso (Broker → Client)

Alla ricezione, il Bridge applica logiche v5 per garantire che solo i dati pertinenti e validi vengano inoltrati all'applicazione BMS15.

**Scarto Messaggi Scaduti:** I messaggi con `Message Expiry Interval` scaduto vengono scartati e loggati.
**Risoluzione Topic Alias:** Il Bridge mantiene una mappa `alias -> topic` per ricostruire il topic completo, ottimizzando l'uso della banda.
**Inoltro con Metadati:** I messaggi vengono arricchiti con le proprietà v5 (`UserProperties`, `SubscriptionIdentifier`) prima di essere inviati all'handler dell'applicazione.

Esempi di Autoregolazione del Client

Il Bridge si adatta dinamicamente alle capacità del broker. Clicca su uno scenario per vedere come si comporta e quale messaggio di log viene generato.