Telemetría con gVar

La telemetría de un thing —lo que mide y el estado que reporta— se publica en gVar. Estas páginas explican qué es gVar, cómo se usa desde el boardCode y cómo viaja por dentro. (El lado web —cómo un artefacto lee o escribe gVar— se cubre en Artefactos; aquí nos centramos en el thing.)

Qué es gVar

gVar es el almacén de variables compartidas del proyecto, en tiempo real. Es el punto de encuentro entre la placa y el resto de la plataforma: el thing publica ahí sus lecturas y su estado, y lee de ahí las órdenes que le mandan (desde un tablero, un artefacto o el Copiloto).

• Es del proyecto: las variables son compartidas, no privadas de un trozo de código. Ponles nombres claros y propios.
• Guarda dos tipos de variable:
  • Escalares — un único valor (el último). Para estados y mediciones actuales.
  • Series — una lista de valores con marca de tiempo. Para historiales y gráficas.
• Desde el boardCode lo usas a través del objeto global varG.

varG: tu acceso a gVar desde el boardCode

varG es un objeto normal de JavaScript que representa el gVar del proyecto. Escribir en él publica; leer de él te da el valor actual (que pudo haber escrito tu placa o alguien desde la web):

varG.temperatura = 23.5;         // publicar (escribir)
const encendido = varG.encender; // leer (puede venir de un tablero/artefacto)

Las partes de esta sección

• Escalares — el último valor.
• Series con pushData — historial con tiempo, el companion _time, reiniciar y la ventana de 2500 puntos.
• Cómo se propaga — el motor que envía los cambios cada 500 ms.
• Recibir valores y órdenes — el thing reacciona a lo que se escribe desde la web.
• Patrones y errores típicos — buenas prácticas, un ejemplo completo y los fallos más comunes.