Un nodo es un ESP32 que mide en un lugar al que su hub no puede llegar por cable (un subcuadro en un garaje separado, una bomba en su propio cobertizo, un electrodoméstico al otro lado de la casa) y envía sus lecturas por radio.
La primera pregunta es siempre la misma, y nadie puede responderla por usted: ¿llegará? Eso depende de sus paredes, de su cuadro eléctrico, de su edificio. Lo que sí podemos decirle es que puede averiguarlo en unos diez minutos, sin tener nada montado ni haber taladrado nada.
Así que haga eso primero.
Antes de empezar
Un nodo necesita tres cosas, y la primera sorprende a la mayoría:
- Un módulo que mida la tensión. En v1.1.7, un nodo registra energía solo si uno de sus módulos rbAmp mide la tensión. Con módulos que miden solo corriente, le mostrará la corriente en vivo y no guardará nada: ni períodos, ni historial, ni coste. Así que el conjunto de un nodo es un conjunto rbAmp monofásico con medición de tensión.
- Un ESP32 original con 4 MB de flash y sin PSRAM. No un S2, S3 ni C3: el firmware del nodo no está compilado para ellos.
- Un hub conectado a su Wi-Fi. La radio con la que habla el nodo es la radio Wi-Fi, así que un hub sin red no tiene nada que el nodo pueda encontrar.
⚠️ Para cualquier trabajo dentro de un cuadro eléctrico, llame a un electricista cualificado.
Empareje el nodo donde va a vivir
No en la mesa de trabajo. El objetivo de los próximos diez minutos es probar el camino que el nodo va a usar de verdad, así que llévelo al lugar, aliméntelo allí y empareje desde donde esté.
Points → Nodes → abra la ventana de emparejamiento. Usted elige cuánto tiempo permanece abierta la ventana: entre 10 segundos y 10 minutos. Encienda el nodo dentro de ese tiempo y los dos se encontrarán: intercambian claves, y los puntos del nodo aparecen de inmediato en la app, con historial desde la primera hora. Ninguno de los dos dispositivos se reinicia.
Usted nunca elige un canal de radio. El nodo busca el hub y se conecta a él por sí mismo, en menos de cuatro segundos en nuestro banco de pruebas.
⚠️ La ventana de emparejamiento no tiene PIN. Mientras esté abierta, cualquier nodo RBgrid al alcance que pida emparejarse se emparejará. Ábrala solo cuando vaya a encender su propio nodo, ciérrela después y revise la lista de nodos para ver qué se ha unido.
Los tres números
Una vez emparejado, la tarjeta del nodo muestra el enlace. Estos son los datos que sustituyen una promesa sobre la distancia:
- Signal: la intensidad del último mensaje que el hub recibió de este nodo.
- Lost packets: la proporción de paquetes que el nodo perdió en el último minuto aproximadamente. No aparece hasta que pasa la primera ventana completa, así que espere un minuto antes de sacar conclusiones.
- Last heard: cuánto tiempo hace que el hub recibió algo del nodo.
No hay una cifra de aprobado, y no vamos a inventarla. El firmware no tiene umbral de señal ni de pérdidas, así que un número que parece correcto en un lugar no significa nada en otro. Lo que debe vigilar es el comportamiento:
Déjelo diez minutos con la carga funcionando de verdad (la bomba bombeando, el cargador cargando) y observe que los paquetes perdidos se mantienen en cero y el nodo sigue en línea. Un enlace que funciona bien con todo en reposo y se deshace cuando arranca el motor es el que le hará perder la tarde, y solo se manifiesta bajo carga.
Si eso se cumple, móntelo. Si no se cumple, lo habrá averiguado por el precio de estar de pie en un cobertizo, no por el de taladrar una pared.
Cuando no basta
En el orden en que suele probarlas la gente:
- Mueva el nodo. Un metro importa más de lo que cree, y lo que se mueve es el nodo, no los cables de las pinzas. Alargar el cableado del sensor para llevar la medición hasta el hub es hacerlo al revés, y es exactamente lo que un nodo existe para evitar.
- Saque la antena del metal. Un nodo sellado dentro de una caja de acero está hablando a través de una caja.
- Tienda un cable hasta un lugar mejor para el nodo, y mantenga corto el salto de radio.
Qué hace el hub mientras el enlace está caído
Esta es la parte que conviene conocer antes de preocuparse por un enlace marginal.
Un nodo mantiene su propia hora y cierra cada período de 15 minutos según su reloj. Si el hub no es alcanzable, el nodo conserva esos períodos terminados y los envía cuando vuelve la conexión, y se archivan y se valoran según la hora en que se midieron, no la hora en que llegaron. Cuánto tiempo puede conservarlos depende del firmware del propio nodo, no del hub:
- El firmware del nodo 1.5, que viene con el hub v1.1.8, escribe cada período terminado en la flash del nodo: unos cinco días de ellos.
- El firmware del nodo 1.4 guarda ocho de ellos, unas dos horas, en memoria. Pasado eso, el noveno desplaza al más antiguo, y ese se pierde para siempre.
En ambos casos, cuando la retención está llena, sale primero el más antiguo. Pero la pregunta para un enlace inestable deja de ser «¿fue el hueco más largo que dos horas?» y pasa a ser una que rara vez tendrá que hacerse.
Lo que la retención no cubre:
- Un nodo que pierde la alimentación. Con el firmware 1.4 pierde la cola y el período en curso. Con el 1.5, los períodos conservados están en la flash y sobreviven; el período que estaba abierto en el momento del corte sigue perdido.
- Un nodo que arranca mientras el hub no es alcanzable conserva su energía, pero la registra en la hora equivocada. Su reloj viene del hub, así que hasta que haya recibido una señal de él no puede cerrar un período. En v1.1.7, todo lo que midió mientras tanto llega entonces en su primer registro, que cubre todo el tramo desde el encendido hasta el final del primer período completo de 15 minutos, y se archiva como si todo hubiera ocurrido en ese único período. No se pierde nada; un día funcionando a ciegas simplemente cae en un único período de su historial.
Cuando algo parece estar mal
El hub considera que un nodo está desconectado tras unos quince segundos sin ninguna señal suya, y lo registra como un evento, también en MQTT si lo usa, junto con un tema de estado por nodo y un sensor de señal en Home Assistant.
⚠️ Fuera de alcance y apagado parecen idénticos. La app no puede distinguirlos, y tampoco la API. Lo que los diferencia es lo que pasó antes: un enlace que empeora suele desviarse primero (suben los paquetes perdidos, baja la señal, el nodo alterna alterne entre en línea y fuera de línea). Un corte de corriente es una caída limpia, con buenas cifras hasta el último momento.
Un enlace marginal se manifiesta con paquetes perdidos por encima de cero y huecos en los valores en vivo. Sus registros son más robustos que la vista en vivo: los períodos se reenvían hasta que el hub los confirma, así que siguen llegando con retraso y caen en la hora correcta, mientras esté dentro de la retención de dos horas.
Si el router cambia su canal Wi-Fi, el nodo nota el silencio tras unos ocho segundos y vuelve a buscar el hub. Nada se reinicia, y los períodos cerrados durante el corte se conservan.
Apagar la radio de nodos del hub se comporta igual: los nodos siguen cerrando sus períodos y guardan hasta ocho, y luego los envían cuando vuelve la radio. Lo que se pierde es la vista en vivo durante ese tramo, y lo que sea más antiguo que la retención, no sus registros.
Mover o quitar un nodo
Quitar un nodo elimina sus puntos y su historial. Vale la pena leerlo dos veces antes de limpiar una lista.
Un nodo no se queda unido a un hub que no puede oír. Tras unos 150 segundos sin respuesta, se marca como no emparejado y empieza a pedir emparejarse de nuevo por su cuenta; si lo reinicia, lo pide enseguida. Así que mover un nodo a otro hub, o volver a emparejar uno que quitó, consiste en abrir la ventana de emparejamiento en el hub que quiera y después reiniciar el nodo, o simplemente esperar dos minutos y medio. Borrar su flash es una opción para empezar limpio, no un requisito.
⚠️ Esa es también la otra mitad de la advertencia anterior. Un nodo cualquiera al alcance que haya perdido su propio hub estará pidiendo emparejarse; así que una ventana abierta mientras enciende algo que no es suyo es una invitación a cualquier otro dispositivo que esté escuchando.
Y hay un detalle que sorprende a más de uno: un nodo no admite actualización inalámbrica (OTA). El hub sí se puede actualizar de forma inalámbrica desde la app; el nodo no. El firmware nuevo se carga por USB, igual que se cargó la primera vez, así que déjelo en un sitio al que todavía pueda llegar con un cable.
Qué no es un nodo
Es un emisor. No tiene pantalla ni interfaz web, no guarda un historial que pueda leer, y no hace nada por sí mismo si el hub desaparece, más allá de conservar sus períodos terminados hasta que el hub vuelva. La medición la hacen los módulos rbAmp conectados al nodo; el nodo los lee y lo reenvía.
En v1.1.7 tampoco trabaja con tres fases: la agrupación de fases corresponde al hub y a su propio módulo de entrada, y un nodo admite un conjunto monofásico.
⚠️ Un nodo no añade historial. Sus puntos comparten las mismas doce ranuras de historial que todo lo conectado al hub: un nodo que añada ocupa ranuras de puntos que ya guarda. → Qué cargas merecen una ranura de historial
Siguiente
- Sensors and modules · Points
- Qué cambió en la versión: RBgrid v1.1.7
- Preguntas → Soporte