Com controlar bombetes Tuya de forma local a Home Assistant

Darrera actualització: 10 d'agost de 2026
  • Accés a les claus de xifratge mitjançant el portal de desenvolupadors de Tuya.
  • Ús d'eines externes com la teva cli per extreure identificadors de dispositiu.
  • Configuració d'adreces IP estàtiques per evitar la pèrdua de connexió local.
  • Mapeig de punts de dades específics per habilitar el control de color i brillantor.

Bombeta intel·ligent Tuya

Segur que t'ha passat: et compres un munt de bombetes intel·ligents perquè són barates i funcionen bé amb Smart Life, però després t'adones que dependre totalment del núvol és un mal de cap. Vols integrar-ho tot a Home Assistant per tenir el control real de casa teva, però en començar a llegir els plugins, et trobes que gairebé tots et demanen registrar-te en un portal de desenvolupadors. Fa la sensació que t'estan venent la moto amb allò de «control local» quan en realitat t'obliguen a passar pels seus servidors per començar.

La realitat és que, encara que sembli una contradicció, aquest pas inicial és necessari per obtenir la clau de xifratge de cada bombeta. Quan tens aquesta clau, el trànsit de dades ja no ha de sortir de la teva xarxa, permetent gestionar els teus llums sense que un servidor a la Xina sàpiga quan encens la cuina. Si tens paciència i segueixes els passos adequats, pots aconseguir que els teus dispositius Calex o qualsevol altra marca basada a Tuya funcionin de forma completament autònoma i privada.

domòtica local amb n8n
Article relacionat:
Guia Completa de Domòtica Local i Automatització amb n8n

Preparant el terreny i les eines

Bombeta intel·ligent Tuya

Abans de ficar-te en feina, necessites tenir instal·lat HACS (Home Assistant Community Store) , ja que és la via més senzilla per afegir el plugin LocalTuya. Un cop tinguis HACS operatiu, cerca i instal·la LocalTuya des del seu repositori de GitHub. No et saltis aquest pas perquè és el motor que permetrà la comunicació directa amb el maquinari.

  Introducció a Swift: característiques i avantatges

Per treure les claus de seguretat, necessitaràs instal·lar al teu ordinador Python i NPM. Amb això ja llest, obre la terminal i executa l'ordre npm i @tuyapi/cli -g per instal·lar la utilitat teva-cli. Aquesta eina és la que farà la feina bruta d'extreure la informació tècnica que Home Assistant necessita per parlar amb les bombetes sense intermediaris.

El procés d'aparellament i organització

Bombeta intel·ligent Tuya

Quan comencis a afegir les bombetes, et recomano encaridament que facis servir una mica de cinta adhesiva per etiquetar cada bombeta físicament. És molt fàcil embolicar-se quan tens deu llums iguals i no saps quina és la del saló o la del dormitori. Anoteu en un paper el nom que us poseu a l'app, la vostra adreça IP i l'espai per a la clau de xifratge.

home assistant plug-in
Article relacionat:
Home Assistant plug-in: guia completa d'add-ons i integracions clau

Un truc fonamental perquè no se't trenqui la configuració és entrar al teu router i assignar IPs estàtiques a cada dispositiu. Si deixeu que el DHCP canviï les adreces IP, Home Assistant deixarà de trobar la bombeta i, encara que el control pel núvol segueixi funcionant, l'accés local es tallarà , obligant-te a reconfigurar-ho tot des de zero.

Extraient les claus de xifratge

Bombeta intel·ligent Tuya

Quan les llums estiguin vinculades al teu compte de Tuya, és hora d'usar la terminal. Executa la comanda tuya-cli wizard. La primera vegada que ho facis, el sistema et demanarà els teus credencials de l'API del portal de desenvolupadors. Un cop configurat, només cal que introduïu l'ID d'un dels vostres dispositius i l'eina generarà un fitxer JSON amb els noms, IDs i claus de xifratge de tots els aparells vinculats al vostre compte.

  Lua vs Bash: guia pràctica, exemples i criteris reals

Configuració detallada a Home Assistant

Bombeta intel·ligent Tuya

A l'hora d'afegir els llums a LocalTuya, el millor és anar una per una per mantenir l'estabilitat del sistema. El procés es divideix en diverses etapes: primer seleccioneu la bombeta de la llista mitjançant la vostra IP; després, introdueixes el nom amigable i la clau de xifratge que vas obtenir anteriorment. Assegureu-vos que al formulari de dades la bombeta estigui marcada amb el valor «20».

home assistant automatitzacions
Article relacionat:
Guia completa d'automatitzacions amb Home Assistant

En el pas següent, definiu el dispositiu com una «light» (llum) . El més complicat ve al final, amb els punts de dades (DP). Perquè el control de color i brillantor funcioni correctament, has d'assignar els valors següents: la Brillantor al 22 , la Temperatura de Color al 22, el Mode de Color al 21 i el Color al 24 . Aquests valors poden variar segons el model però solen ser l'estàndard per aconseguir un control total del cercle cromàtic.

Seguint aquest flux de treball, hauràs transformat unes bombetes dependents del núvol en dispositius gestionats localment. En combinar l'ús de la teva-cli, l'assignació d'IPs fixes i el mapatge correcte dels punts de dades a LocalTuya, aconsegueixes una resposta instantània de les llums i la tranquil·litat que la teva domòtica seguirà funcionant encara que caigui la connexió a internet.

home assistant funcionalitats ocultes
Article relacionat:
Home Assistant: funcionalitats ocultes i trucs avançats