Transparent — Introducción
Transparent es el modo en que tu placa corre tu propio programa (lo escribes en el Arduino IDE) y sus variables se sincronizan solas con la plataforma. A diferencia de frvn —donde la plataforma controla la placa por ti y tú escribes el código en el editor web— en Transparent el control vive en tu sketch: tú declaras qué variables se comparten y en qué sentido, y la librería se encarga del resto.
No hay “enviar” ni “recibir” a mano: declaras una variable, dices si va de la placa a la plataforma, de la plataforma a la placa, o en ambos sentidos, y la librería la mantiene sincronizada. Del lado web (boardCode) la lees y la escribes por su nombre.
Cuándo usar Transparent
Sección titulada «Cuándo usar Transparent»- Ya tienes (o quieres escribir) un sketch de Arduino propio.
- Necesitas lógica que corra en la placa en tiempo real o a alta frecuencia (por ejemplo, muestrear un sensor 100 veces por segundo).
- Usas hardware o librerías que prefieres manejar tú en el firmware.
Si en cambio quieres ir rápido sin escribir firmware y que la plataforma controle los pines, usa frvn. Un thing usa uno u otro modo, nunca los dos a la vez.
Variables y direcciones
Sección titulada «Variables y direcciones»En Transparent trabajas con variables declaradas, no con canales manuales. Cada variable tiene una dirección que define quién la escribe y quién la observa:
| Dirección | Significado | Ejemplo típico |
|---|---|---|
DEVICE_TO_GATEWAY (d2g) | la placa reporta; la plataforma observa | un sensor, un estado |
GATEWAY_TO_DEVICE (g2d) | la plataforma manda; la placa aplica | un actuador, un setpoint |
BIDIRECTIONAL (bi) | ambos lados pueden escribirla | un objetivo editable desde los dos lados |
Los dos lados
Sección titulada «Los dos lados»Transparent siempre tiene dos lados que comparten las mismas variables:
| Lado | Dónde se escribe | Con qué |
|---|---|---|
| La placa (MCU) | en el Arduino IDE, en tu sketch | la librería Transparent (macro TPT_VAR) |
| El thing (boardCode) | en el editor web del thing | el objeto global tpt |
- En la placa: ver La librería de Arduino y API del MCU.
- En el thing: ver boardCode.
- Los tipos de dato de cada variable están en Tipos de datos.
- Ejemplos completos de ambos lados en Ejemplos.
Lo que no tienes que hacer
Sección titulada «Lo que no tienes que hacer»La conexión, el “apretón de manos” inicial, el catálogo de variables y el chequeo de salud entre la placa y la plataforma los maneja la librería sola. Tú solo declaras variables y las usas: en la placa las editas, en el thing las lees y las escribes.