Qué son las gVar

Las variables globales (gVar) son el estado compartido de un proyecto. Viven en la plataforma y se sincronizan en tiempo real: un thing las escribe y un artefacto las lee o las escribe de vuelta. Son el puente entre el hardware y la web.

Dos tipos

Escalares

Un valor único: número, texto o booleano. Representan el “último estado”.

// Desde el boardCode de un thing
varG.temperatura = 23.5;
varG.estado = "ok";
varG.encendido = true;

Cuando reasignas un escalar, su nuevo valor se propaga a todo el que lo observe.

Series

Una lista de valores con marca de tiempo. Sirven para historiales y gráficas. Cada serie tiene un compañero de tiempos: si la serie se llama temperaturas, sus tiempos viven en temperaturas_time, alineados punto a punto.

// Desde el boardCode de un thing
pushData("temperaturas", 23.5);

pushData añade el valor y su marca de tiempo a la vez. Por eso es la forma correcta de alimentar una serie: los tiempos quedan siempre alineados con los valores.

Ventana de las series

La plataforma conserva una ventana de los últimos puntos de cada serie, no un historial infinito. Un artefacto siempre debe tratar una serie como potencialmente recortada: el primer punto que ves puede no ser el primero que existió. Para ejes de tiempo, usa los tiempos que entrega la serie, no su posición en el arreglo (lo veremos en Series y gráficas).

El ciclo de ida y vuelta

Thing  ──(varG / pushData)──►  gVar  ──(observe / read)──►  Artefacto
Thing  ◄──────(varG)────────  gVar  ◄──────(write)───────  Artefacto

• El thing publica lecturas (escalares y series).
• El artefacto las muestra en vivo y, si tiene permiso, escribe una gVar para enviar una orden de vuelta al thing.

A dónde seguir

• Visibilidad y permisos — qué gVar ve y puede escribir un artefacto.
• Programación de artefactos — leer, observar y escribir gVar desde una web app.