Puntos

Visión general

Un point es algo que mide: su acometida, un circuito, un aparato. Cada point está vinculado a un canal de un módulo rbAmp. El hub guarda sus valores en vivo, su historial y su coste según su tarifa.

Hay tres tipos de points:

• Bus de tensión: la tensión que mide el módulo. Es la referencia de la potencia de cada point.
• Entrada (Main): su suministro, la conexión a la red. Muestra toda su acometida: lo que importa, exporta y paga. (El coste se calcula para cada point.)
• Points normales: todo lo demás, como circuitos y aparatos.

La entrada y el bus de tensión se crean por usted y no se pueden eliminar: "The main input and the voltage bus cannot be deleted." Por defecto, la entrada es el módulo 0, canal I0. El rol de entrada no se puede cambiar desde la aplicación.

Los propios módulos, y cómo añadir uno, están en la página Sensors and modules.

La página Points

Abra Management → Points. La página muestra sus módulos rbAmp, sus points y los canales libres. Arriba están Add a module (véase Adding modules) y Refresh.

Mientras carga la página puede ver "Device is initializing — retrying…" (el hub acaba de arrancar), o "Couldn't load sensors." con Retry. "No sensors detected." significa que el hub no ha encontrado ningún módulo.

Avisos del bus

Los módulos comparten un bus I2C. Si algo falla en él, aparece un aviso arriba:

Secciones

La página tiene estas secciones, en este orden:

1. Remote nodes (ESP-NOW): en un hub que puede manejar nodos, esta sección está arriba: la radio del hub para nodos y una tarjeta por cada nodo emparejado. Los canales de un nodo son points como cualquier otro (véase Remote nodes).
2. rbAmp modules (n): una tarjeta por módulo (véase Module cards).
3. Points (n): sus points vinculados, cada uno como un mosaico en vivo. Bajo cada mosaico figura su dirección, "module m · channel · I2C bus b · 0xaddr · model" (para una entrada trifásica: "module m · L1–L3 (3 phases) · I2C bus b"), y un botón Unbind.
4. Free sensors (n): canales que aún no pertenecen a ningún point, cada uno con un botón Bind. No se ofrece un canal que el módulo instalado no tiene. Cuando todos los canales están ocupados, la página dice: "No free channels. To add a point, connect another rbAmp module or unbind a point you don't need."

Desvincular un point

Unbind quita un point de su canal. La entrada, una entrada de respaldo y el bus de tensión no tienen botón Unbind, y su rol no se puede cambiar desde la aplicación.

La aplicación le pide confirmación. El point deja de medirse y sale de la visión general; el canal del sensor queda libre y se puede volver a vincular. Unbind y Delete point (en la página del point) son la misma acción: ambas quitan el point y borran su historial guardado para siempre. Si puede necesitar sus registros más adelante, descárguelos antes en History (CSV).

Si no se puede contactar con el hub, la aplicación dice "Couldn't unbind the point" o "Unbind request failed (device unreachable?)".

Vincular un point

Pulse Bind en un sensor libre. El diálogo Bind sensor as a point muestra arriba la dirección del sensor ("Module m · channel · I2C bus b · 0xaddr").

Al pie: "Home Assistant entities for the new point appear after the hub restarts."

Roles

Generation y Storage no se ofrecen en los canales de módulos BASIC. Grid input y Backup input no están en esta lista: el rol de entrada no se puede cambiar desde la aplicación.

Medir un point de generación

Monte la pinza exactamente igual que las demás: la flecha en el sentido normal del flujo, que en un circuito de generación va del inversor hacia la casa. No hay pinza invertida, ni cableado especial, ni interruptor de software que ajustar. El rol hace el resto: desde la firmware v1.1.5, un point de Generation cuenta el flujo en el sentido de la flecha — desde la fuente hacia los consumidores — como producción; por eso marca potencia negativa y su energía va a Energy out.

⚠️ La potencia negativa en un point de generación es correcta — no la "arregle". Para eso existe el rol. Girar la pinza para que el signo salga positivo es la única forma de estropear un point de generación bien montado: la producción pasa entonces a Energy in, y Produced se queda en cero.

Sí hay dos cosas que pueden salir mal:

• invert_sign heredado de una firmware anterior. Antes de v1.1.5, un point de Generation lo necesitaba para leer la producción. Tras actualizar, bórrelo (POST /api/v1/units/<id> {"invert_sign": false}); si no, el point vuelve a leer consumo: invert_sign invierte el resultado además del rol.
• El tipo de canal equivocado. Los canales de un módulo BASIC cuentan solo consumo — no ven la exportación — por eso Generation y Storage no se ofrecen en ellos. La producción necesita un canal que mida el sentido. Qué módulos miden el sentido: the rbAmp module guide.

Phase

La fase fija a qué línea del suministro se atribuye la carga del canal en los resúmenes por línea. En un módulo BASIC, todos los canales usan la única entrada de tensión del módulo, sea cual sea la fase elegida.

Las opciones dependen de su suministro:

• todavía no hay sistema eléctrico configurado: sin definir, L1, L2, L3, 3 phases;
• monofásico: sin definir, L1;
• trifásico: sin definir, L1, L2, L3, 3 phases, L1–L2 (two-pole), L2–L3 (two-pole), L3–L1 (two-pole).

Una opción marcada "not validated on hardware" aún no se ha comprobado en hardware real. Una entrada trifásica es un módulo STD-U3I3 con Use as the three-phase input en su tarjeta de módulo (véase Sensors and modules).

Reutilizar un ID

Si elige el ID de un point eliminado, el diálogo avisa de que Home Assistant y MQTT conocen el point por su ID y continuarán su historial antiguo como un único point. Si el canal alimenta ahora otra carga, ponga un ID nuevo. El botón dice entonces Bind with the previous ID. Desde la firmware v1.1.6, el hub borra con el point el registro de medición neta de un point eliminado, así que un ID reutilizado empieza su crédito en cero; en v1.1.5 y anteriores heredaba el saldo de crédito y el saldo del periodo del point eliminado.

Mensajes

• "This point will show live values only: the hub keeps history for 12 points." — las 12 plazas de historial están ocupadas. El point sigue mostrando valores en vivo.
• "ID «id» is already used by another point." — elija otro ID.
• "Could not bind" / "Bind request failed (device unreachable?)" — compruebe la conexión con el hub e inténtelo de nuevo.

Un point que vincule con el hub en marcha empieza a guardar historial tras el siguiente reinicio. El hub guarda el historial de cada point por hora y construye días, meses y años a partir de las horas, así que al vincular no hay ningún ajuste de historial que elegir.

La página de un point

Toque un mosaico de point para abrir su página.

Cabecera

Back, el nombre del point y una línea "role · source · status". La fuente es rbAmp o rbAmp BASIC. El estado es normal, no data o no such channel on the module.

Las etiquetas bajo la cabecera indican lo que el point puede medir:

• measures import and export, consumption only o consumption only (BASIC module);
• current only — monitoring, not energy metering: un módulo solo de corriente;
• energy kept across restarts;
• phase: phase.

Alertas

Cuando algo necesita atención, aparece una alerta bajo la cabecera:

Valores en vivo

Voltage (en un point trifásico, la media de fases), Current (la suma de fases), Power y, si la fuente los mide, Reactive y PF. Una tensión a más de un 10 % del nominal aparece marcada en rojo como low o high. La exportación se muestra como "↑ W" en el color de exportación.

Una entrada trifásica añade una tabla Per phase (U3I3): L1, L2, L3 con tensión, corriente, potencia, potencia reactiva y PF.

Tendencia

Un pequeño gráfico con Power, Voltage o Energy, por Hours, Days o Weeks. Muestra los últimos 48 puntos en líneas y las últimas 24 barras en energía. Los points de generación dibujan su producción como positiva. As a table abre los mismos datos en History.

Contadores

No se muestran para módulos solo de corriente.

• Imported today, con "≈ dinero" al precio medio de compra del día;
• Exported today (o Produced today en un point de generación), con su valor, si es mayor que cero;
• Total imported;
• Total exported (o Produced in total), si es mayor que cero; no en módulos BASIC.

Estación de carga

Un point con el rol Charging station muestra además Current session: Status y Energy today.

El estado se deriva de la potencia del point, en cualquier canal — también en uno rbAmp normal; no interviene ningún controlador de estación, y la etiqueta lleva la descripción "derived from power". Muestra Charging mientras la potencia del point supera el umbral de carga — el propio de la estación, si no el del hub, y si no 500 W — y Available por debajo. Energy today es la importación del point en el día, y el hub no guarda un historial de carga por sesión.

Configuración del point

Al pie, Point setup abre los ajustes del point (véase Point settings), los Technical details (IDs y canal, útiles para soporte) y Delete point.

Delete point pide confirmación: el point deja de medirse y sale de la visión general y de la lista de points, y su historial guardado se borra para siempre — desde la firmware v1.1.6, junto con su registro de medición neta. El canal del sensor queda libre y se puede volver a vincular. Después vuelve a Points. Si puede necesitar sus registros más adelante, descárguelos antes en History (CSV). La entrada y el bus de tensión no se pueden eliminar.

Ajustes del point

Point settings guarda solo los campos que cambió. Mientras tenga cambios sin guardar, Save y Cancel se quedan abajo en la pantalla; si intenta salir, la aplicación le pregunta antes. No hay un modo de edición aparte.

Fixed in v1.1.4: en la firmware del hub v1.1.3 y anteriores, en revisiones del chip ESP32 anteriores a la v3, renombrar un point podía hacer que desapareciera tras el siguiente reinicio, junto con su historial. Actualice el hub a v1.1.4 antes de renombrar points. Para ver la revisión de su chip, conecte la placa por USB y ejecute python -m esptool --chip esp32 -p <PORT> chip_id: la salida muestra, por ejemplo, "ESP32-D0WD (revision v1.1)".

Points dentro de otros points

Desde la firmware v1.1.8, un point se puede marcar como medido dentro de otro. Úselo siempre que una de sus pinzas ya incluya a otra: un subcuadro y un circuito alimentado desde él, un contador troncal y una carga detrás de él. El campo lo dice en una línea: "If this load sits behind another point's meter (a sub-panel with its own meter, say), pick that point. Its power then counts once, in that point, and not again in the rest of the input."

Qué cambia y qué no:

• los totales del hub no cambian — se toman en la entrada y nunca dependieron de sus points;
• la cifra no medida deja de restar dos veces la carga interior. Sin la marca, el subcuadro y la carga que contiene se restan ambos de la entrada, así que lo no medido sale más bajo de lo que es, y en un cuadro bien medido puede resultar negativo. → Economics

⚠️ Marque el point interior, no el exterior. El ajuste dice "este point ya está dentro de aquel". Ponerlo al revés describe un cuadro que no tiene.

Al borrar un point — también al quitar el nodo que lo llevaba — los points que contenía vuelven a ser de primer nivel, de modo que la cifra se corrige sola en lugar de conservar en silencio un point padre que ya no existe.

Por la API se hace con PATCH /api/v1/units/{id} y {"inside": <point id>}; 0, "" o null lo quitan, y units-config informa de inside para cada point.

Comprobaciones de límites e interruptores

• Por encima de 1000 kW: la aplicación le pide revisar las unidades (el campo está en kW) y no guarda.
• Más de lo que permite el interruptor, o (en la entrada) muy por debajo: la aplicación avisa y ofrece un valor coherente calculado a partir del interruptor, la tensión nominal y el número de conductores.
• Si el interruptor está por encima del límite del sensor, la aplicación avisa de que la corriente por encima del límite se recorta y la medición cuenta de menos: monte un sensor de mayor calibre. El límite es la corriente a partir de la cual la pinza empieza a recortar, tal como la informa el hub — en pinzas SCT-013 unos 16 % por encima de su calibre, es decir unos 11.6 A para una pinza de 10 A — y es el extremo superior del rango "accurate … A" que aparece en la tarjeta del módulo y en Point settings. Una pinza con el calibre del interruptor no avisa. Cuando el hub no informa de esa cifra no hay rango ni aviso, que es el caso de los sensores emparejados de fábrica de un módulo STD. En la aplicación v1.1.4 y anteriores, la comprobación usaba un límite un 10 % por debajo del calibre de la pinza, así que avisaba incluso cuando el calibre era igual al del interruptor.

Sensor de corriente

En un canal SCT, elija la pinza realmente montada. El nuevo modelo se aplica de inmediato y el módulo se reinicia; el hub no. Si el canal se calibró de fábrica con su sensor, esa calibración se pierde y no se puede restaurar, así que cambie el modelo solo si realmente hay montado otro sensor. En un módulo de la serie CT, o en un módulo sin calibrar, el modelo no se puede elegir. Los modelos admitidos aparecen en Channel CT model.

Tras guardar

• "Point settings saved."
• Tras un cambio de rol: "Saved. The role applies immediately; history depth for the new role takes effect after the device reboots."
• "Not saved: …" con el motivo. Si el hub necesita un token de administrador, la aplicación lo indica.

Lo que guarda el hub para cada point

Cada registro contiene:

• valores eléctricos: tensión, corriente y potencia medias, potencia reactiva y aparente, factor de potencia, frecuencia, y el mínimo y el máximo de tensión, corriente y potencia;
• energía: importada y exportada en el periodo, más los contadores de vida útil;
• coste y valor de exportación según su tarifa;
• una marca de calidad: por ejemplo, un periodo parcial, un reloj sin sincronizar o un hueco.

Cuánto tiempo se guarda el historial

Todo está en la memoria flash propia del hub; no hace falta ningún módulo de almacenamiento.

Cuántos points guardan historial

Hasta 12 points guardan historial (los primeros doce que añadió). Los points a partir del decimotercero muestran valores en vivo pero no guardan historial.

Un point que vincule con el hub en marcha empieza a guardar historial tras el siguiente reinicio: la aplicación se lo recuerda ("Restart the hub to start its history").

Leer los datos

• History muestra un point por hora, día o mes (véase History). La tendencia en la página del point también puede mostrar semanas.
• Economics muestra el coste y el valor de exportación de un point por periodo (véase Tariffs).
• La API REST y la exportación CSV ofrecen los mismos registros (véase Source & API).

Resolución de problemas

Un point no muestra datos

• Compruebe que el módulo está conectado y que su tarjeta aparece en Points → rbAmp modules (véase Sensors and modules).
• Compruebe que el point está vinculado al canal donde está la pinza.
• Si la página muestra un aviso del bus, véase Bus warnings.

Las lecturas de un point parecen erróneas

• Compruebe el modelo de pinza en los canales SCT (Current sensor) y que la pinza esté en su propio canal.
• Compruebe el sentido de la pinza según la marca de flecha (véase la documentación de los módulos rbAmp).

Un point desapareció tras un reinicio

• Si lo renombró con la firmware v1.1.3 o anterior: es un fallo conocido en revisiones del ESP32 anteriores a la v3, corregido en v1.1.4 (véase Point settings). Actualice el hub y vuelva a vincular el canal como un point nuevo.

Un point tiene valores en vivo pero no historial

• Si lo añadió con el hub en marcha, reinicie el hub.
• Puede ser el decimotercero o posterior: solo doce points guardan historial, los del hub y los de sus nodos en conjunto.
• Compruebe que la hora del hub está puesta (véase Time). Los registros sin fecha real se omiten.

La cifra no medida es negativa o muy pequeña

• Uno de sus points ya lo mide otro — un subcuadro y un circuito detrás de él. Marque el interior como measured inside del exterior (firmware v1.1.8, véase Points inside other points arriba).
• Un circuito productor vinculado con el rol equivocado cae en el bloque incorrecto: la generación no es una línea y nunca se resta. → Economics

Un point de generación muestra consumo

• Desde la firmware v1.1.5 el propio rol fija el sentido; un invert_sign heredado de una firmware anterior lo invierte de nuevo. Bórrelo (véase Roles).

El point de un nodo perdió su nombre, rol o calibres tras un reinicio

• Esto se corrigió en la firmware v1.1.8: los points de nodo se reconstruyen desde la lista de nodos al arrancar, y hasta v1.1.8 su nombre, rol, calibres, orientación de la pinza y measured inside volvían a valores por defecto. En v1.1.7 y anteriores, vuelva a ajustarlos tras cada reinicio, o actualice el hub. → Remote nodes

No puedo poner «Measured inside»

• El destino debe ser un point existente, distinto de este y de la entrada, y la cadena no puede volver atrás formando un bucle. El campo solo aparece desde la firmware v1.1.8.