Leer y observar

Hay dos formas de consumir una gVar: leerla una vez o observarla en vivo. Para una UI que refleja el estado del hardware, casi siempre quieres observar.

const { gvar } = window.Undercromo;

Leer una vez

// Un valor concreto (asíncrono)
const t = await gvar.read("temperatura");

// Todo el estado visible
const todo = await gvar.read();

// Versión síncrona, desde la copia local (tras la primera carga)
const t2 = gvar.peek("temperatura");

Usa read/peek para lecturas puntuales (al hacer clic, al calcular algo). Para mantener la pantalla al día, observa.

Observar escalares (recomendado)

observe ejecuta tu callback cada vez que el valor cambia. Con { immediate: true } también lo ejecuta una vez al suscribirte, con el valor actual:

const stop = gvar.observe("temperatura", (valor) => {
  document.querySelector("#temp").textContent = valor;
}, { immediate: true });

observe devuelve una función para dejar de observar:

stop(); // cancela la suscripción

Varias claves a la vez

gvar.observe(["temperatura", "humedad"], (valor, clave) => {
  document.querySelector("#" + clave).textContent = valor;
}, { immediate: true });

El callback recibe (valor, clave), así sabes cuál cambió.

Observar series

Para series usa observeSeries; recibes el snapshot completo de la serie:

gvar.observeSeries("temperaturas", (serie) => {
  // serie.values, serie.timestamps, serie.totalLength
  console.log("puntos:", serie.values.length);
}, { immediate: true });

Para graficar, mejor proyéctala: ver Series y gráficas.

Observar, no encuestar

Evita bucles tipo setInterval(() => gvar.peek(...)). El runtime ya te avisa de los cambios con observe/observeSeries: es más eficiente y tu UI no parpadea ni se queda atrás.