Come configurare BroadLink per telecomandi IR e RF in Home Assistant

BroadLink è l’hardware Wi-Fi che trasmette codici a infrarossi o radiofrequenza; Home Assistant è il software che apprende e invia i comandi. IR e RF non sono intercambiabili: i modelli BroadLink RM mini sono orientati all’infrarosso, mentre RM Pro/RM4 Pro aggiungono un trasmettitore RF nelle bande supportate. Un telecomando rolling code o un protocollo fuori frequenza non diventa compatibile solo perché il dispositivo è RF.

Prerequisiti & Hardware Necessario

• BroadLink compatibile e già configurabile tramite app del produttore. L’app BroadLink è richiesta per collegare il dispositivo alla rete.
• Home Assistant sulla stessa LAN del BroadLink, con comunicazione locale consentita. Per camere Tasmota basate su BroadLink la documentazione richiede stessa rete locale.
• Telecomando originale funzionante, batterie cariche e dispositivo da controllare posizionato nel raggio IR/RF.
• Per RF, BroadLink RM Pro/RM4 Pro e dispositivo compatibile con 433.05–434.79 MHz oppure 314.95–315.25 MHz.
• Nessun link d’acquisto viene inserito: il modello BroadLink necessario dipende da IR, RF e protocollo dell’apparecchio.

Procedura passo-passo

1. Identifica il protocollo. Usa IR per TV, climatizzatori e apparecchi con LED/ricevitore a vista. Usa RF solo se il BroadLink e l’apparecchio lavorano su una banda supportata. Frequenza, modulazione e rolling code devono essere compatibili.
2. Configura il BroadLink nell’app. Collega l’hardware alla rete Wi-Fi secondo l’app ufficiale e assegna un nome univoco. Usa una rete 2,4 GHz quando il modello lo richiede e crea una prenotazione DHCP per l’IP.
3. Verifica la rete locale. Dal server Home Assistant controlla che l’IP BroadLink sia raggiungibile. Non isolare il dispositivo in una VLAN senza consentire il traffico locale e la discovery necessari.
4. Aggiungi l’integrazione. In Home Assistant apri Impostazioni → Dispositivi e servizi → Aggiungi integrazione, cerca BroadLink e completa il flusso. Se non viene scoperto, usa la configurazione manuale e inserisci l’IP.
5. Controlla le entità. Per un telecomando universale dovresti vedere un’entità remote; i modelli RF compatibili espongono anche l’entità radiofrequency. Le entità infrared e radiofrequency sono trasmettitori, non la rappresentazione automatica di ogni apparecchio.
6. Apprendi un comando IR. In Strumenti per sviluppatori → Azioni esegui l’azione remote.learn_command con dati come:

   action: remote.learn_command
   target:
     entity_id: remote.broadlink_rm4
   data:
     device: tv_soggiorno
     command: power
     command_type: ir

   Premi il tasto del telecomando originale puntandolo verso BroadLink quando l’interfaccia lo richiede. Ripeti per ogni comando necessario.
7. Apprendi un comando RF. Per un RM Pro/RM4 Pro usa lo stesso flusso con command_type: rf. Tieni il telecomando vicino al BroadLink e ripeti più volte se il protocollo richiede una sequenza. Se il comando usa rolling code o autenticazione bidirezionale, l’apprendimento può non essere utilizzabile.
8. Invia un comando appreso. Testa l’azione remote.send_command:

   action: remote.send_command
   target:
     entity_id: remote.broadlink_rm4
   data:
     device: tv_soggiorno
     command: power
     num_repeats: 1
     delay_secs: 0.4

   Per il primo test usa una sola ripetizione e aumenta solo se il dispositivo lo richiede.
9. Verifica i codici. I codici appresi vengono memorizzati nell’area di storage di Home Assistant in un file JSON associato al MAC BroadLink. Non modificare manualmente i file in /config/.storage/: usali solo come riferimento e gestisci i comandi dalle azioni o dalla configurazione documentata.
10. Crea uno switch custom solo se necessario. La configurazione legacy può usare switch: e la piattaforma broadlink con MAC e comandi codificati. Preferisci le azioni remote.learn_command/remote.send_command e l’entità remote per i nuovi setup, così eviti una configurazione YAML duplicata.
11. Costruisci l’automazione. Dopo aver verificato manualmente i comandi, aggiungi un trigger e richiama remote.send_command. Per un climatizzatore usa comandi completi coerenti, perché molti telecomandi IR inviano lo stato totale e non un semplice tasto incrementale.
12. Posiziona il trasmettitore. L’IR richiede linea ottica o riflessioni adeguate; l’RF richiede portata e frequenza compatibili. Non chiudere l’unità in un armadio metallico e non aggiungere ripetizioni finché il comando base non è stabile.

Verifica del funzionamento

1. Invia un comando IR appreso e verifica che l’apparecchio risponda senza usare l’app originale.
2. Invia un comando RF e controlla che la risposta sia ripetibile, non solo occasionale.
3. Riavvia Home Assistant e BroadLink: l’entità remote deve tornare disponibile senza riapprendere i codici.
4. Controlla i log Home Assistant in caso di errore di rete o comando non riconosciuto.
5. Per i climatizzatori verifica anche modalità, temperatura e ventola: un singolo comando “power” non garantisce che lo stato reale sia sincronizzato.

Problemi comuni

FAQ essenziali

BroadLink RF controlla qualsiasi dispositivo a 433 MHz?

No. La frequenza è solo una parte della compatibilità: contano modulazione, codifica, portata e tipo di codice. I dispositivi rolling code o bidirezionali possono non essere clonabili.

Devo usare il cloud BroadLink?

L’app del produttore serve per configurare il dispositivo in rete, ma l’integrazione Home Assistant comunica localmente con i modelli supportati. Non esporre il BroadLink su Internet.