Tipos de datos y direcciones

Transparent sincroniza variables con tipo. El tipo lo fija la declaración en la placa (TPT_VAR), así que no hay sorpresas de conversión: una variable de texto siempre es texto, una numérica siempre es número.

Tipos soportados

Tipo C++ (placa)	En el boardCode (JS)
bool	booleano
int / unsigned int	número entero
long / unsigned long	número entero
float / double	número decimal
String	texto

• No hay arrays. En v2 cada variable es un escalar. Para series, reporta un valor y acumúlalo en el thing con pushData (ver boardCode).
• Enteros de 64 bits (long long, int64_t) no están soportados: convértelos a unsigned long o a double antes de asignarlos a la variable.

Ancho de los enteros según la placa

int y unsigned int cambian de tamaño según la placa:

Tipo	Arduino (Uno/Nano/Mega)	ESP32 / ESP32-S3
int	16 bits (−32768 … 32767)	32 bits
unsigned int	16 bits (0 … 65535)	32 bits
long / unsigned long	32 bits	32 bits

La plataforma conoce tu placa y valida el rango: un valor fuera del rango del tipo se descarta con un aviso. Si necesitas enteros grandes en Arduino, usa long / unsigned long.

El desbordamiento ocurre en la placa, no en la plataforma

La validación de rango de la plataforma solo aplica a lo que llega por el cable. Si un cálculo desborda el tipo dentro de la placa —por ejemplo un contador int que pasa de 32767 en Arduino— el valor ya se corrompió antes de transmitirse y la plataforma recibe un número que cabe en el tipo pero puede no corresponder al cálculo original: no hay forma de detectarlo después.

Peor aún, el desbordamiento de enteros con signo en C++ es comportamiento indefinido (referencia del estándar): el compilador no garantiza el wraparound. Para contadores, acumuladores o milisegundos de tiempo en Arduino usa siempre long / unsigned long (32 bits), no int.

Cómo se comporta cada dirección

Dirección	En la placa	En el thing
DEVICE_TO_GATEWAY (d2g)	escribes la variable → se reporta	la lees (o la recibes con onUpdate)
GATEWAY_TO_DEVICE (g2d)	la lees (la escribe la plataforma)	la escribes con tpt.var o varG enlazado
BIDIRECTIONAL (bi)	escribes y lees	escribes y lees; gana el último cambio

Detalles a tener en cuenta

• Decimales “limpios”. 23.50 llega como 23.5 y 5.0 como 5.
• Entrada de decimales en el editor visual. En los campos numéricos (delta, valor inicial) puedes usar coma o punto como separador decimal (0,5 o 0.5); el valor se normaliza al salir del campo, sin depender del idioma del navegador.
• Texto (String). Los saltos de línea y caracteres especiales viajan intactos (la librería los codifica y decodifica por ti). Un texto muy largo se recorta al tamaño de línea de la placa (127 bytes en Arduino, 255 en ESP32, menos el nombre de la variable). El aviso de recorte solo aparece cuando hay un canal libre para emitirlo: al recortar del thing a la placa, y al recortar en la placa por WiFi (ESP32). Al recortar en la placa por serial es silencioso, porque ahí el propio puerto serie es el canal de datos y un aviso lo corrompería. Mantén los textos cortos.
• Una variable, un tipo. El tipo lo fija la declaración; no cambia en caliente.
• Nombres: empiezan por letra, hasta 32 caracteres, solo letras, números, - y _.

Recomendación rápida

• Telemetría de la placa (sensores, estado) → variable d2g; en el thing la enlazas a varG con bindGVar o la acumulas con pushData desde onUpdate.
• Órdenes desde el thing a la placa → variable g2d (booleano para encender/apagar, número para un setpoint).
• Un valor editable desde ambos lados → variable bi.