# X-NODE / XN04 – Sensores Temperatura/Humedad/Luminosidad


Comprar	https://www.microside.com/shop/x-node-temperatura-humedad-luminosidad-32

El **X-NODE Temp-Hum / Lum** es un módulo que permite realizar mediciones de 3 variables ambientales: **Temperatura, Humedad y Luz Ambiental**. Ideal para proyectos IoT que requieren control y monitoreo de sistemas cerrados, como aire acondicionado, cámaras de refrigeración, o ajustes automáticos de iluminación. Este módulo simplifica los diseños al reducir la necesidad de múltiples dispositivos, ofreciendo una solución compacta y eficiente para aplicaciones de monitoreo. ### **TABLA DE CONTENIDO** 1. [**¿Cómo funciona?**](#i.-como-funciona) 2. [**Descripción del hardware**](#ii.-descripcion-del-hardware) 3. [**Especificaciones**](#iii.-especificaciones) 4. [**Pinout**](#iv.-pinout) 5. [**Modo de uso**](#v.-modo-de-uso) * [**Protocolo UART**](#protocolo-uart) * [**Ejemplo UART Arduino Framework**](#ejemplo-uart-arduino-framework) * [**Protocolo I2C**](#protocolo-i2c) * [**Ejemplo I2C Arduino Framework**](#ejemplo-i2c-arduino-framework) 6. [**Descargas**](#vi.-descargas) * [**Esquemático**](https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbyV2zAlQAiqg46a3Lr8z%2Fuploads%2FcFaznEDQxatEy6prNwMl%2Fschematic.pdf?alt=media\&token=bff01aea-d514-49e9-8d7b-c41ae9a939ef) * [**Dimensiones**](https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbyV2zAlQAiqg46a3Lr8z%2Fuploads%2FEAvXcjTy4yVAr0qRZMzF%2Fdimensions.pdf?alt=media\&token=0d1a1c2b-f723-4763-bdcd-eb254c8511f1) ## **I. ¿Cómo funciona?** El **X-NODE Temp-Hum / Lum** es un módulo que combina 2 sensores: un [SHT40](https://sensirion.com/resource/datasheet/sht4x) de [Sensirion®](https://sensirion.com/) para medir temperatura/humedad ambiental y un [LTR-329ALS](https://optoelectronics.liteon.com/upload/download/DS86-2014-0006/LTR-329ALS-01_DS_V1.pdf) de [LITEON®](https://www.liteon.com/en) para medir luminosidad en interiores; con un controlador integrado permite obtener estas variables utilizando una serie de comandos *ASCII*. **X-NODE Temp-Hum / Lum** es compatible con el estándar [mikroBUS™](https://www.mikroe.com/mikrobus) de [Mikroe®](https://www.mikroe.com/) para un uso fácil con un gran ecosistema de kits para desarrollo de hardware, también posee conectores JST compatibles con el estándar [Qwiic®](https://www.sparkfun.com/qwiic) de [SparkFun®](https://www.sparkfun.com/) para una comunicación entre diversos módulos y tarjetas de desarrollo por medio del protocolo I2C de manera rápida y sencilla. ## **II. Descripción del hardware**

1. Sensor [SHT40](https://sensirion.com/resource/datasheet/sht4x) de [Sensirion®](https://sensirion.com/) 2. Conectores JST compatibles con [Qwiic®](https://www.sparkfun.com/qwiic) 3. Sensor [LTR-329ALS](https://optoelectronics.liteon.com/upload/download/DS86-2014-0006/LTR-329ALS-01_DS_V1.pdf) de [LITEON®](https://www.liteon.com/en) 4. Controlador en hardware 5. Puertos de comunicación UART <> I2C 6. Modelo de X-NODE 7. Tipo de X-NODE 8. Conectores estándar [mikroBUS™](https://www.mikroe.com/mikrobus) 9. Jumper pad para habilitar la comunicación I2C nativa\* de los sensores. 10. Versión de hardware: R2 11. Componentes principales en el X-NODE {% hint style="info" %} **Nota:** El **X-NODE Temp-Hum / Lum** incluye un controlador en hardware para simplificar la implementación, sin embargo, si desea utilizar el protocolo nativo I2C de los sensores deberá enviar el comando para apagar el controlador por hardware y soldar los pads I2C-EN (9). {% endhint %} ## **III. Especificaciones**


Tipo	Sensor de temperatura, humedad y luz ambiental
Aplicaciones	Desarrollo de sistemas de IoT que requieran control y monitoreo dentro de sistemas cerrados, como aire acondicionado, cámaras de refrigeración, o ajustes automáticos de iluminación.
Módulo 1	SHT40
Fabricante	Sensirion®
Módulo 2	LTR-329ALS
Fabricante	LITEON®
Características	* Sensor de temperatura y humedad con detección de 0 °C a 85 °C con una precisión típica de +/- 0.2 °C y +/- 1.8% RH, calibración automática, consumo de 0.5 mA y alta relación señal/ruido. * Sensor de luz ambiental con detección de 0.01 a 64 klx, supresión de ruido a 50 Hz/60 Hz y consumo típico de 90µA.
Interfaz	UART, I2C
Compatibilidad	Estándar mikroBUS™ y estándar Qwiic®
Tamaño	41 x 25.4 x 20.5 mm
Voltaje	3.3 V

{% hint style="info" %} Para la información técnica completa, puedes descargar las especificaciones de cada fabricante en los siguientes enlaces: [SHT40](https://sensirion.com/resource/datasheet/sht4x) - [LTR-329ALS](https://optoelectronics.liteon.com/upload/download/DS86-2014-0006/LTR-329ALS-01_DS_V1.pdf) {% endhint %} ## **IV. Pinout** La siguiente tabla muestra el pinout del **X-NODE Temp-Hum / Lum** con respecto al estándar [**mikroBUS™**](https://www.mikroe.com/mikrobus) (este último se encuentra en las dos columnas del centro).

## **V. Modo de uso** Para un uso fácil y rápido del X-NODE se puede hacer a través de los comandos en formato ASCII que proporciona el controlador en hardware integrado mediante una comunicación serial UART o de forma más avanzada a través del protocolo I2C. ### Protocolo UART #### Configuración La comunicación UART utiliza la siguiente configuración: * Velocidad de comunicación: 115,200 bps * Paridad: Ninguna * Bits de datos: 8 * Bits de paro: 1 #### Sintaxis El protocolo UART permite enviar instrucciones en texto plano *ASCII*. Cada instrucción se compone del identificador del X-NODE, un comando y un final de línea. **Identificador** El identificador **ID**, se conforma por el modelo del X-NODE, que puede localizar en el punto 6 del apartado Descripción de hardware y se complementa con un índice, que puede ser una letra del abecedario, por defecto es la letra **A**, siendo posible configurarlo hasta la letra **Z**. Para poder conectar más de un módulo del mismo modelo en un sistema, deberá configurar un identificador único para cada módulo, brindando la posibilidad de conectar hasta 26 módulos del mismo modelo a través del protocolo UART\*.

{% hint style="warning" %} **Nota:** A partir de este punto se usará el índice predeterminado del **X-NODE Temp-Hum / Lum** para el resto del manual: **XN04A**. {% endhint %} **Lista de comandos**


XN04A?	Verifica si se estableció una comunicación con éxito. Respuesta si la comunicación fue exitosa: OK Respuesta si ocurrió un error en la comunicación XN04A=Error Ejemplo: XN04A=3 Códigos de error: 1: Error con el sensor de temperatura/humedad 2: Error con el sensor de luminosidad 3: Error con ambos sensores
XN04A+V	Obtiene la versión del firmware actual que integra el X-NODE. Respuesta: XN04A=Versión Ejemplo: XN04A=2.0.0
XN04A+ID=(A-Z)	Cambia el índice del ID por una letra diferente del abecedario de la A a la Z, la nueva letra debe ser en mayúscula. Una vez modificado, para volver a cambiarlo es necesario colocar el ID con el nuevo índice. Respuesta: OK Ejemplo de envío: XN04C+ID=H
XN04A+TW=(1-126)	Cambia la dirección I2C que viene de fábrica por uno diferente, esta configuración solo tiene efecto si no se ha deshabilitado el driver en hardware. La nueva dirección se escribe en decimal seleccionando un valor de 1 a 126. Respuesta: OK Ejemplo de envío: XN04A+TW=28
XN04A+GT	Obtiene el valor de Temperatura del sensor. Retorna con el valor final en °C con dos decimales. Respuesta: XN04A=VAL Ejemplo: XN04A=27.81
XN04A+GH	Obtiene el valor de Humedad del sensor. Retorna con un valor relativo (%) de humedad. Respuesta: XN04A=VAL Ejemplo: XN04A=80
XN04A+GL	Obtiene el valor de Luminosidad del sensor. Retorna con un valor de luminosidad ambiental en Luxes. Respuesta: XN04A=VAL Ejemplo: XN04A=198

#### Comandos avanzados


XN04A+ETW=(0-1)	Habilita (1) o deshabilita (0) la interfaz I2C del dispositivo. Nota: Esta configuración es volátil, desconectar el dispositivo del suministro de energía o enviar el comando de reinicio restaurará la interfaz I2C. Respuesta: OK Ejemplo de envío: XN04A+ETW=0
XN04A+SLP	Habilita el modo de descanso profundo del dispositivo para reducir el consumo de energía, durante el descanso profundo el dispositivo no responderá a comandos UART, para despertar el dispositivo envíe un lógico bajo (0) al pin WAKEUP/UPDI Respuesta: OK Ejemplo de envío: XN04A+SLP
XN04A+RST	Reinicia el dispositivo, los valores no volátiles (ej. ID, address I2C) se conservarán y los valores volátiles volverán a su configuración por defecto. Respuesta: OK
XN04A+SP	Permite configurar la precisión del sensor de temperatura/humedad en alta (H)* (valor por defecto), media (M) o baja (L), precisiones más bajas permiten capturar información nueva con mayor frecuencia. Respuesta: OK Ejemplo de envío: XN04A+SP=L
XN04A+SH	Permite encender (1) o apagar (0) el calefactor del sensor de humedad. Utilice este comando cuando las mediciones de humedad sean incorrectas, habilite el calefactor al menos durante 2 horas para garantizar la reparación del sensor de humedad Respuesta: OK Ejemplo de envío: XN04A+SH=0
XN04A+SG	Permite configurar la ganancia del sensor de luminosidad en 1 (1-64k lux) (valor por defecto), 2 (1-32k lux), 4 (1-16k lux), 8 (1-8k lux), 48 (1-1.3k lux) y 96 (1-600 lux), ganancias más altas tiene rangos menores con una mayor precisión Respuesta: OK Ejemplo de envío: XN04A+SG=96
XN04A+SD	Permite encender (1) o apagar (0) el controlador por hardware de los sensores Respuesta: OK Ejemplo de envío: XN04A+SD=1
XN04A+SN	Permite leer el número de serie del sensor de temperatura y humedad Respuesta: XN04A=<SERIE> Ejemplo: XN04A=4294900000

En la lectura de temperatura, humedad, luminosidad existen respuestas para la detección de errores: * **ERROR:** El sensor presentó un error de comunicación. * **OL:** El valor de luminosidad desbordó el registro, configure un valor de ganancia más pequeño si es posible. * **MEASURING:** No ha finalizado la lectura del sensor, espere al menos 20 milisegundos mientras el sensor se inicializa. * **HW\_DRIVER\_OFF:** El controlador en hardware no está habilitado. #### Final de línea El X-NODE solo responderá a un comando cuando se envíe un conjunto de caracteres finalizadores de línea, cada comando debe terminar con estos caracteres: **\** * CR significa retorno de carro (carriage return), este carácter se utiliza para indicar a un sistema que la entrada de texto debe moverse al principio. * LF significa alimentación de línea (line feed), este carácter le indica a un sistema que la entrada de texto corresponde a una nueva línea. La combinación de ambos caracteres es una manera común con el que las computadoras representan una nueva línea, por ejemplo, en un procesador de texto para separar párrafos. En el caso del X-NODE los caracteres **\**, se utilizan para identificar cuando se ha terminado de enviar un comando. Si el identificador corresponde al nodo, el comando existe y se finaliza con los caracteres **\**, entonces el nodo enviará una respuesta. Dependiendo del sistema, deberá configurar el envío de estos caracteres de maneras diferentes. #### Ejemplo UART Arduino Framework {% hint style="info" %} Código de ejemplo para el [**XC01 - R5**](https://docs.microside.com/plataforma-xide-iot/x-nodes/xc01-controlador-wifi-and-bluetooth/r5/x-node-xc01-esp32-s3-controlador-wifi-and-bluetooth), revisa el manual para utilizar nuestro [XC01 - R5 en **Arduino IDE/PlatformIO**](https://docs.microside.com/plataforma-xide-iot/xc01-controlador-wifi-and-bluetooth/r5/x-node-xc01-esp32-s3-controlador-wifi-and-bluetooth#configuracion-para-platformio-en-vs-code) {% endhint %} ```cpp #include "Arduino.h" float getVariable( const char * command ){ // Limpiamos el buffer if (Serial2.available()) { Serial2.read(); } // Envía el comando Serial2.print(command); Serial2.println(); // Espera hasta recibir una respuesta String variable_value = Serial2.readStringUntil('\n'); // Si la respuesta comienza por el ID // entonces la comunicación fue exitosa if (!variable_value.startsWith("XN04A=")) { Serial.println("Error"); return NAN; } // Convierte el valor en ASCII a un valor decimal return variable_value.substring(variable_value.indexOf('=') + 1).toFloat(); } void setup() { // Inicializa el monitor serial Serial.begin(115200); // Inicializa la comunicación UART en el puerto MikroBUS Serial2.begin(115200, SERIAL_8N1, 9, 10); } void loop() { // Obtiene los valores de variables ambientales // Envía el comando para obtener la temperatura // Los caracteres \r\n representan los caracteres // en el lenguaje de programación C/C++ float temp = getVariable("XN04A+GT\r\n"); // Envía el comando para obtener la humedad float hum = getVariable("XN04A+GH\r\n"); // Envía el comando para obtener la luminosidad float lum = getVariable("XN04A+GL\r\n"); Serial.print("Temp: "); Serial.print(temp); Serial.println(" °C"); Serial.print("Hum: "); Serial.print(hum); Serial.println(" %"); Serial.print("Lum: "); Serial.print(lum); Serial.println(" lx"); delay(1000); } ``` ### Protocolo I2C Para poder establecer comunicación se debe conocer la dirección I2C del X-NODE, el valor de fábrica es 0x04. Las direcciones I2C suelen representarse en sistema **hexadecimal**, asegúrese de utilizar el sistema numérico adecuado. #### Configuración * Velocidad de comunicación: 100 kHz - 400 kHz * Address: 7 bits {% hint style="info" %} **Nota:** Verifica que no cuentes con otro dispositivo con la misma dirección (Address) en el BUS I2C, de ser así recuerda que el X-NODE puede cambiar su dirección I2C con el comando **XN04A+TW=(1-126)**. {% endhint %} #### Escritura Para escribir en un registro del **X-NODE Temp-Hum / Lum** el maestro I2C debe generar las siguientes operaciones: 1. Enviar una **condición de inicio**: El maestro genera un lógico bajo (0) en el pin SDA, mientras SCL permanece en alto (1). 2. Enviar la dirección del **X-NODE**: El maestro envía la dirección de 7 bits. 3. Enviar el **tipo de operación**: El maestro indica si la operación es de lectura (0) o de escritura (1). 4. Esperar una señal de **reconocimiento (ACK)**: El maestro espera a recibir un lógico bajo (0), como confirmación (Acknowledgment) que exista un dispositivo con la dirección enviada previamente en el BUS I2C. Si no se recibe respuesta (1), significa que hubo un error en la comunicación o la dirección es incorrecta. 5. Escribir **n bytes** de datos: El maestro escribirá en secuencias de 8 bits (1 byte) y en orden del bit más significativo primero (MSB) n cantidad de bytes que desea escribir en el registro, el dispositivo enviará una señal de **reconocimiento (ACK)** por cada byte escrito. 6. Enviar una **condición de paro**: El maestro debe liberar el BUS I2C generando un lógico alto (1) en el pin SDA mientras que SCL se encuentra en un lógico alto (1). #### Lectura Para leer en un registro del **X-NODE Temp-Hum / Lum** el maestro I2C debe generar las siguientes operaciones: 1. Enviar una **condición de inicio**: El maestro genera un lógico bajo (0) en el pin SDA, mientras SCL permanece en alto (1). 2. Enviar la dirección del **X-NODE**: El maestro envía la dirección de 7 bits. 3. Enviar el **tipo de operación**: El maestro indica si la operación es de lectura (0) o de escritura (1). 4. Esperar una señal de **reconocimiento (ACK)**: El maestro espera a recibir un lógico bajo (0), como confirmación (Acknowledgment) que exista un dispositivo con la dirección enviada previamente en el BUS I2C. Si no se recibe respuesta (1), significa que hubo un error en la comunicación o la dirección es incorrecta. 5. Leer **n bytes** de datos: El dispositivo enviará secuencias de 8 bits (1 byte) y en orden del bit más significativo primero (MSB) n cantidad de bytes, al recibir un byte, el maestro deberá generar una señal de **reconocimiento (ACK)** para solicitar 1 byte más, o una señal de **no reconocimiento (NACK)** para indicar que ha finalizado la transmisión y solicitar el dispositivo que libere el BUS. 6. Enviar una **condición de paro**: El maestro debe liberar el BUS I2C generando un lógico alto (1) en el pin SDA mientras que SCL se encuentra en un lógico alto (1). #### Lista de registros En un dispositivo I2C los registros son direcciones de memoria que permiten configurar u obtener datos del dispositivo. Existen dos tipos de operaciones: de lectura (R) y de escritura (W).

Registro	Dirección	Tipo	No. Bytes	Descripción
TEMP	0x01	R	2	Permite obtener el valor de temperatura en grados °C*100, dividir este valor por 100 obtiene la medición en °C
HUM	0x02	R	2	Permite obtener el valor de humedad relativa * 100, dividir este valor por 100 obtiene la medición en humedad relativa porcentual (0-100%)
LUM	0x03	R	2	Permite obtener el valor de luminosidad ambiental (ALS) en Luxes
HEATER	0x04	R/W	1	Permite encender (1) o apagar (0) el calefactor del sensor de humedad. Utilice este comando cuando las mediciones de humedad sean incorrectas, habilite el calefactor al menos durante 2 horas para garantizar la reparación del sensor de humedad
PRECISION	0x05	R/W - NV	1	Permite configurar la precisión del sensor de temperatura/humedad en alta (3)* (valor por defecto), media (2) o baja (1), precisiones más bajas permiten capturar información nueva con mayor frecuencia
GAIN	0x06	R/W - NV	1	Permite configurar la ganancia del sensor de luminosidad en 1 (1-64k lux) (valor por defecto), 2 (1-32k lux), 4 (1-16k lux), 8 (1-8k lux), 48 (1-1.3k lux) y 96 (1-600 lux), ganancias más altas tiene rangos menores con una mayor precisión
SERIAL_NUM	0x07	R	4	Permite leer el número de serie del sensor de temperatura y humedad
DRIVER	0x36	R/W - NV	1	Permite encender (1) o apagar (0) el controlador por hardware de los sensores
STAT	0x37	R	1	Estado del XNODE, 0x00 si no hay errores, cualquier otro valor significa error en la comunicación. Códigos de error: 1: Error con el sensor de temperatura/humedad 2: Error con el sensor de luminosidad 3: Error con ambos sensores
FW	0x38	R	3	Versión de firmware, en versión mayor, menor y parche: 0x02.0x00.0x00
UART_ID	0x39	R/W - NV	1	Permite leer y escribir el índice del ID por una letra diferente del abecedario de la A (0x41) a la Z (0x5A)
TW_ADD	0x3A	R/W - NV	1	Permite leer y escribir la dirección I2C del dispositivo por uno diferente de 1 (0x01) a 126 (0x7D)
UART_EN	0x3B	W	1	Habilita (0x01) o deshabilita (0x00) la interfaz UART del dispositivo
SLEEP	0x3C	W	1	Habilita (0x01) o deshabilita (0x00) el descanso profundo del dispositivo, el dispositivo despertará si el maestro escribe la dirección I2C del dispositivo en el BUS
RESET	0x3D	W	1	Si se escribe un 0x01 reinicia el dispositivo
WHO_AM_I	0x3E	R	2	El primer byte es el modelo del XNODE, el segundo byte es la revisión de hardware

**Registros No volatiles (NV)** Los registros no volatiles se guardan en la memoria EEPROM del dispositivo, lo que significa que conservarán los valores escritos en ellos incluso si el dispositivo se apaga. **Estructura del registro TEMP, HUM, LUM:** En la lectura de temperatura, humedad, luminosidad existen valores reservados para la detección de errores: * **0xFFFF:** El sensor presentó un error de comunicación. * **0xFFFE:** El valor de luminosidad desbordó el registro, configure un valor de ganancia más pequeño si es posible. * **0xFFFD:** No ha finalizado la lectura del sensor, espere al menos 20 milisegundos mientras el sensor se inicializa. * **0xFFFC:** El controlador en hardware no está habilitado.

#### Ejemplo I2C Arduino Framework {% hint style="info" %} Código de ejemplo para el [**XC01 - R5**](https://docs.microside.com/plataforma-xide-iot/x-nodes/xc01-controlador-wifi-and-bluetooth/r5/x-node-xc01-esp32-s3-controlador-wifi-and-bluetooth), revisa el manual para utilizar nuestro [XC01 - R5 en **Arduino IDE/PlatformIO**](https://docs.microside.com/plataforma-xide-iot/xc01-controlador-wifi-and-bluetooth/r5/x-node-xc01-esp32-s3-controlador-wifi-and-bluetooth#configuracion-para-platformio-en-vs-code) {% endhint %} ```cpp #include #include void setup() { // Inicializa el monitor serial Serial.begin(115200); // Configura los pines de la comunicación I2C Wire.setPins( 12, 13 ); // Inicializa la comunicación I2C Wire.begin(); } void loop() { // Obtiene los valores de variables ambientales float temperature; float humidity; int lum; Wire.beginTransmission(0x04); Wire.write(0x01); if ( Wire.endTransmission() != 0) { delay(1000); return; } if (Wire.requestFrom(0x04, 2) != 2) { delay(1000); return; } // Dividir entre 100 para obtener el valor en grados Celsius temperature = ( (Wire.read() << 8) | Wire.read() )/100.0f; Wire.beginTransmission(0x04); Wire.write(0x02); if ( Wire.endTransmission() != 0) { delay(1000); return; } if (Wire.requestFrom(0x04, 2) != 2) { delay(1000); return; } // Dividir entre 100 para obtener el valor en humedad relativa porcentual humidity = ( (Wire.read() << 8) | Wire.read() )/100.0f; Wire.beginTransmission(0x04); Wire.write(0x03); if ( Wire.endTransmission() != 0) { delay(1000); return; } if (Wire.requestFrom(0x04, 2) != 2) { delay(1000); return; } lum = ((Wire.read() << 8) | Wire.read()); Serial.print("Temperatura:"); Serial.print(temperature); Serial.println(" C"); Serial.print("Humedad:"); Serial.print(humidity); Serial.println(" %"); Serial.print("Luminosidad: "); Serial.print(lum); Serial.println(" lx"); delay(1000); } ``` ## **VI. Descargas**


Esquemático	https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbyV2zAlQAiqg46a3Lr8z%2Fuploads%2FcFaznEDQxatEy6prNwMl%2Fschematic.pdf?alt=media&token=bff01aea-d514-49e9-8d7b-c41ae9a939ef
Dimensiones	https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbyV2zAlQAiqg46a3Lr8z%2Fuploads%2FEAvXcjTy4yVAr0qRZMzF%2Fdimensions.pdf?alt=media&token=0d1a1c2b-f723-4763-bdcd-eb254c8511f1

--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.microside.com/plataforma-xide-iot/x-nodes/xn04-sensores-temperatura-humedad-luminosidad/r2/x-node-xn04-sensores-temperatura-humedad-luminosidad.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.