> For the complete documentation index, see [llms.txt](https://docs.microside.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.microside.com/workshops/hackathon-curso-introductorio.md).

# Hackathon - Curso introductorio

Este curso introductorio te proporcionará los conocimientos fundamentales necesarios para el Hackathon - 2026. Aprenderás como utilizar la plataforma de XIDE con el entorno de desarrollo de Arduino®.

<figure><img src="https://177299348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbyV2zAlQAiqg46a3Lr8z%2Fuploads%2FMZneRunAO67F2qGSuwQh%2FX-NODE%20KIT%20XIDE%20HACKATHON.webp?alt=media&amp;token=0322e7de-67f7-4d1f-9219-b98ed2f6ef98" alt=""><figcaption></figcaption></figure>

### **Tabla de contenido**

1. [**Descripción del kit de hardware**](#i.-descripcion-del-kit-de-hardware)
   * [**1. ¿Qué es un zócalo mikroBUS?**](#id-1.-que-es-un-zocalo-mikrobus)
   * [**2. ¿Cómo ensamblar un sistema XIDE**](#id-2.-como-ensamblar-un-sistema-xide)
   * [**3.- ¿Cómo funciona el XBI01?**](#id-3.-como-funciona-el-xbi01)
2. [**Configuración del entorno de desarrollo (Arduino® IDE)**](#ii.-configuracion-del-entorno-de-desarrollo-arduino-r-ide)
   * [**1.- Preparación del XC01 R5-I Arduino® IDE**](#id-1.-preparacion-del-xc01-r5-i-arduino-r-ide)
   * [**2.- Uso de los pines mikroBUS del XC01 R5-I en el Arduino® IDE**](#id-2.-uso-de-los-pines-mikrobus-del-xc01-r5-i-en-el-arduino-r-ide)
   * [**3.- Plantilla de Arduino® IDE**](#id-3.-plantilla-de-arduino-r-ide)
3. [**Uso del XN03 - Entradas y Salidas Analógicas**](#iii.-uso-del-xn01-entradas-digitales)
   * [**Ejemplo de uso del XN03**](#ejemplo-de-uso-del-xn03)
4. [**Uso del XN13 - Relevador**](#iii.-uso-del-xn01-entradas-digitales-1)
   * [**Ejemplo de uso del XN13**](#ejemplo-de-uso-del-xn13)
5. [**Uso del XN14 - Fuente de alimentación 24 VDC**](#iii.-uso-del-xn01-entradas-digitales-2)
   * [**Ejemplo de uso del XN14**](#como-usar-el-xn14)
6. [**Uso del XN44 - Buzzer**](#iii.-uso-del-xn01-entradas-digitales-3)
   * [**Ejemplo de uso del XN44**](#ejemplo-de-uso-del-xn44)
7. [**App XIDE Launcher**](#iii.-uso-del-xn01-entradas-digitales-4)
   * [**XIDE App**](#xide-app)
8. [**Descargas**](#descargas)

## **I. Descripción del kit de hardware**

<table data-view="cards"><thead><tr><th align="center"></th><th></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td align="center"><mark style="color:green;"><strong>XC01 R5</strong></mark></td><td>Controlador WiFi &#x26; Bluetooth, compatible con Arduino IDE</td><td data-object-fit="contain"><a href="https://177299348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbyV2zAlQAiqg46a3Lr8z%2Fuploads%2FSHPt5q2y1Vj67cixlxh5%2FX-NODE%20%20MCU%20WIFI%20BLE%20R5%20MICROSIDE%20XIDE%2001.webp?alt=media&amp;token=d571ebad-18f0-429e-8cad-f614c781946c">xc01-product-image.webp</a></td><td><a href="https://docs.microside.com/plataforma-xide-iot/x-nodes/xc01-controlador-wifi-and-bluetooth/r5/x-node-xc01-esp32-s3-controlador-wifi-and-bluetooth.md">X-NODE / XC01 – ESP32-S3 Controlador WiFi &amp; Bluetooth</a></td></tr><tr><td align="center"><mark style="color:green;"><strong>XN03 - Analog Inputs / Outputs</strong></mark></td><td>Módulo expansor de salidas digitales</td><td data-object-fit="contain"><a href="https://177299348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbyV2zAlQAiqg46a3Lr8z%2Fuploads%2Fsv6tLve0Hux0WEhI2fN2%2Fuser-manual-product-image.webp?alt=media&amp;token=a3d46563-97e5-4ec5-94e2-d7bc541bc99a">xn03-r1-product-image.webp</a></td><td><a href="https://docs.microside.com/plataforma-xide-iot/x-nodes/xn03-entradas-salidas-analogicas.md">XN03 - Entradas/Salidas Analógicas</a></td></tr><tr><td align="center"><mark style="color:green;"><strong>XN44 - Buzzer</strong></mark></td><td>Módulo de transductor piezoeléctrico.</td><td data-object-fit="contain"><a href="https://177299348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbyV2zAlQAiqg46a3Lr8z%2Fuploads%2FDz309h1oQ3MRQ9W69WTk%2FX-NODE%20BUZZER%20XN44.webp?alt=media&amp;token=d9772200-3b9a-4499-8ac4-2cb49717b9d2">X-NODE BUZZER XN44.webp</a></td><td><a href="https://docs.microside.com/plataforma-xide-iot/x-nodes/xn01-entradas-digitales/r2/x-node-xn01-entradas-digitales.md">X-NODE / XN01 - Entradas Digitales</a></td></tr><tr><td align="center"><mark style="color:green;"><strong>XN13 - 1 x Relay</strong></mark></td><td>Módulo de 1 relevador</td><td data-object-fit="contain"><a href="https://177299348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbyV2zAlQAiqg46a3Lr8z%2Fuploads%2FuWuSHIsmTNDZEjbJcOfr%2FXN13%20-%20X-NODE%20Relay.webp?alt=media&amp;token=57c73937-91c4-42ab-8718-7674ce104ef3">XN13 - X-NODE Relay.webp</a></td><td><a href="https://docs.microside.com/plataforma-xide-iot/x-nodes/x-node-xn13-1-relevador/r1/x-node-xn13-1-relevador-10a.md">X-NODE / XN13 - 1 Relevador 10A</a></td></tr><tr><td align="center"><mark style="color:green;"><strong>XN14 - DC Power Supply</strong></mark></td><td>Fuente de alimentación 24V DC a 5/3.3 VDC</td><td data-object-fit="contain"><a href="https://177299348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbyV2zAlQAiqg46a3Lr8z%2Fuploads%2FWpDbicZUYGYpA0b3zR21%2FXN14%20-%20X-NODE%20Power%20Supply%20DC.webp?alt=media&amp;token=44c893d0-f5fb-431e-8d44-0b0a39221d13">XN14 - X-NODE Power Supply DC.webp</a></td><td><a href="https://docs.microside.com/plataforma-xide-iot/x-nodes/x-node-xn14-fuente-de-alimentacion-24v-dc.md">X-NODE / XN14 - Fuente de Alimentación 24V DC</a></td></tr><tr><td align="center"><mark style="color:green;"><strong>XBI01 - IIoTrainer</strong></mark></td><td>Tarjeta de expansión</td><td data-object-fit="contain"><a href="https://177299348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbyV2zAlQAiqg46a3Lr8z%2Fuploads%2F7PAuF3dUwTbCTfH7WCPH%2FXBI01%20-%20X-BOARD%20IIoTrainer.webp?alt=media&amp;token=4f80beb8-02bd-47cc-88fb-48edaf302ca6">XBI01 - X-BOARD IIoTrainer.webp</a></td><td><a href="https://docs.microside.com/plataforma-xide-iot/x-boards/x-board-xbi01-iiotrainer.md">X-BOARD / XBI01 - IIoTrainer</a></td></tr></tbody></table>

### **1.- ¿Qué es un zócalo mikroBUS?**

El estándar [mikroBUS™](https://www.mikroe.com/mikrobus) define el patillaje (pinout) de tarjetas de desarrollo y módulos de expansión, esta interfaz no requiere habilidades para soldar o para leer hojas de datos.

El estándar define 3 interfaces seriales de comunicación: SPI, I2C, UART, 3 señales digitales: Interrupción, Reset y PWM. 1 señal analógica. El patillaje de un zócalo [mikroBUS™](https://www.mikroe.com/mikrobus) se organiza como se muestra en la imagen.

<figure><img src="https://177299348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbyV2zAlQAiqg46a3Lr8z%2Fuploads%2F81HqaqUUgN6gyXwFroDz%2Fuser-manual-mikrobus-specification.png?alt=media&amp;token=275fceda-09fa-4728-9ccd-3862542317a0" alt=""><figcaption></figcaption></figure>

La plataforma XIDE está basada en este estándar, lo que permite al diseñador integrar un sistema de hardware en poco tiempo y le permite centrarse en construir la lógica de funcionamiento.

### **2.- ¿Cómo ensamblar un sistema XIDE?**

El ensamblaje de un sistema con XIDE solo requiere 3 pasos:

1. Identificar los módulos que se requieren en el sistema y escoger una tarjeta de expansión.
2. Colocar los módulos en una tarjeta de expansión con cuidado de insertarlos correctamente.
3. Programar el controlador del sistema.

<figure><img src="https://177299348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbyV2zAlQAiqg46a3Lr8z%2Fuploads%2F8UGQBeaMZSsFJcNFRi11%2Fuser-manual-assembly-instructions.jpg?alt=media&amp;token=81e4856a-da67-4f7e-a087-5a86de45f8e9" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Nota:** Se recomienda colocar el controlador del sistema (**XC01 R5-I**) en el **zócalo 5** de la tarjeta de expansión **XBI01 - IIoTrainer**. Lea el apartado [Conectores estándar mikroBUS™ en la sección 3.- ¿Cómo funciona el XBI01?](#id-3.-como-funciona-el-xbi01) para obtener más información.
{% endhint %}

### **3.- ¿Cómo funciona el XBI01?**

La tarjeta de expansión **X-BOARD IIoTrainer** es ideal para el desarrollo de prototipos y proyectos electrónicos, su diseño permite su inserción en una caja estanca IP65 ideal para proteger el sistema contra agua y polvo.

<figure><img src="https://177299348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbyV2zAlQAiqg46a3Lr8z%2Fuploads%2F7qjyyOqSX3McDsclOwqD%2FDescripcion%20del%20hardware%20X-BOARD-IIoTrainer.png?alt=media&amp;token=58f9c766-887f-4370-9794-b67cc2c2e61e" alt=""><figcaption></figcaption></figure>

1. Conectores estándar [mikroBUS™](https://www.mikroe.com/mikrobus) (El zócalo 5 está conectado en paralelo con los otros 4 zócalos).
2. Conectores JST compatibles con el estándar [Qwiic®](https://www.sparkfun.com/qwiic).
3. Doble header para configuración de los pines de los conectores [mikroBUS™](https://www.mikroe.com/mikrobus) (En la parte superior se muestran los pines de los zócalos 1 al 4, mientras que en la parte inferior los pines que están conectados en paralelo al zócalo 5).
4. Versión de hardware: R1.
5. Orificios para conexiones por debajo de la tarjeta
6. Conectores tipo clema de propósito general como expansor de señales para cables AWG de calibre 24 a 20.
7. Modelo de X-BOARD.

Más información sobre&#x20;

<details>

<summary>(1) Conectores estándar mikroBUS™</summary>

<figure><img src="https://177299348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbyV2zAlQAiqg46a3Lr8z%2Fuploads%2FR4JxiPTBeX3TE7RRReiR%2Fuser-manual-xbi01-mb-sockets.png?alt=media&amp;token=e8e8ccb1-0624-4d1d-97b8-96f87a649a4b" alt=""><figcaption></figcaption></figure>

El **XBI01 - IIoTrainer** cuenta con 5 zócalos [mikroBUS™](https://www.mikroe.com/mikrobus). Las comunicaciones seriales de todos los zócalos se encuentran conectadas (**SCK, MISO, MOSI, TX, RX, SDA, SCL**), por lo que su uso no requiere configuraciones adicionales.

Las señales digitales y analógicas: **ANx**, **RSTx**, **CSx**, **PWMx** y **INTx** se encuentran desconectadas. En la mayoría de los módulos de XIDE el uso de estas señales es innecesario para el funcionamiento básico, pero en algunos nodos es requerido, como es el caso del **XC03 - Red celular LTE y GNSS**, donde el encendido se controla con el pin **PK**. Para unir estas señales el usuario debe configurar el **doble header**, donde el zócalo marcado con el número **5** dispone de la mayor capacidad de personalización, por lo que se recomienda insertar el controlador del sistema en este zócalo.

</details>

<details>

<summary>(2) Conectores JST compatibles con el estándar Qwiic®</summary>

El estándar [Qwiic®](https://www.sparkfun.com/qwiic) permite interconectar tarjetas a través de un cable utilizando el protocolo I2C (**SDA, SCL**), los XNODE compatibles con este estándar incluyen dos conectores marcados con la leyenda "**qwiic**".

<img src="https://www.sparkfun.com/media/.renditions/wysiwyg/EcosystemPages/Qwiic/QwiicPinoutGraphic.jpg" alt="" width="375">

<figure><img src="https://www.sparkfun.com/media/wysiwyg/unnamed.jpg?format=webpll" alt=""><figcaption><p>Sistema con cables extensores Qwiic®</p></figcaption></figure>

</details>

<details>

<summary>(3) Doble header para configuración de los pines de los conectores mikroBUS™</summary>

El doble header en el **XBI01 - IIoTrainer** permite configurar y acceder las señales de los zócalos [mikroBUS™](https://www.mikroe.com/mikrobus).

<figure><img src="https://177299348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbyV2zAlQAiqg46a3Lr8z%2Fuploads%2FNz15YT1bGaVhCUcqa9Js%2Fuser-manual-xbi01-double-header.png?alt=media&amp;token=31315aa3-3a16-4b0f-95f4-6bfd46dd880b" alt=""><figcaption></figcaption></figure>

Los pines superiores corresponden a las señales de los primeros cuatro zócalos (1-5). Agrupadas por el tipo de señal: **INTx(1)**, **RSTx(2)**, **PWMx(3)**, **ANx(4)** y **CSx(5)**, en cada uno de estos grupos (excluyendo CSx) se encuentra además una señal CSn que puede utilizarse para el protocolo SPI (**MISO, MOSI, SCK**).

Los pines inferiores corresponden a las señales: **INT(6), RST(7), PWM(8), AN(9) y CS(5)** del **zócalo 5**. Esta distribución de pines permite unir las señales de este zócalo con cualquier señal de los otros 4 zócalos. Además, en cada señal (excepto la señal AN5), se encuentran dos pines marcados como **PD** (pull-down) y **PU** (pull-up), que se encuentran debajo de **GND** y **3.3V** respectivamente, estos pines tienen una resistencia de 10kOhm para definir el estado lógico de la señal.

Para conectar las señales de los pines superiores con los inferiores se recomienda utilizar un puente de 2.54mm (incluidos con el **XBI01 - IIoTrainer**) como se muestra en el siguiente gráfico.

<figure><img src="https://177299348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbyV2zAlQAiqg46a3Lr8z%2Fuploads%2FOSCu5CBYBJKqP21qRZ5n%2Fuser-manual-2_54mm_jumper.png?alt=media&amp;token=50290da6-5f84-4cb2-b381-b2983f9f6793" alt="" width="188"><figcaption></figcaption></figure>

</details>

<details>

<summary>(6) Conectores de propósito general como expansor de señales</summary>

Estos bloques de conectores tipo clema se encuentran aislados del resto de señales de el **XBI01 - IIoTrainer**, su propósito es permitir el cableado de señales externas.

<figure><img src="https://177299348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbyV2zAlQAiqg46a3Lr8z%2Fuploads%2FhVUesabhfyRBGO6flveO%2Fuser-manual-xbi01-terminal-blocks.png?alt=media&amp;token=e9c7ef85-ea27-4d4e-b5e8-16ce03713a72" alt=""><figcaption></figcaption></figure>

La tarjeta cuenta con 5 nodos aislados entre ellos: A, B, C, D y E, las clemas dentro de cada nodo se encuentran conectadas al mismo punto por lo que permite hacer empalmes de cables. El nodo A y el nodo B cuentan con cuatro clemas cada uno, los nodos C, D y E cuentan con solo dos clemas cada uno.

</details>

## **II. Configuración del entorno de desarrollo (Arduino® IDE)**

Para programar el controlador del sistema se requiere un entorno de desarrollo, el **XC01 R5-I** es compatible con:

1. **Espressif-IDE**: Entorno oficial de desarrollo para sistemas de *Espressif Systems*.
2. **Arduino® IDE**: Entorno simplificado para pruebas de concepto compatible con sistemas de *Espressif Systems*.

Para usuarios avanzados es posible utilizar el conjunto de herramientas del **SDK** (**ESP-IDF)** en el editor de código de su preferencia.

Este manual se centrará en la plataforma Arduino®.

### **1.- Preparación del XC01 R5-I Arduino® IDE**

<details>

<summary>Pasos para configurar el XC01 R5-I en Arduino® IDE</summary>

1. Descarga e instala Arduino® IDE.

<https://www.arduino.cc/en/software>

2. Ejecuta Arduino® IDE y da clic en "Gestor de tarjetas".

<figure><img src="https://177299348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbyV2zAlQAiqg46a3Lr8z%2Fuploads%2FNoLKuDPeaxzpQGwTvuFm%2Fuser-manual-arduino-step-2.png?alt=media&amp;token=05bb20ba-f4ad-4af2-a29f-402d5e69de49" alt=""><figcaption></figcaption></figure>

3. En el buscador ingresa: **esp32**. Selecciona la opción *esp32 by Espressif Systems* y presiona el botón **instalar**. Espera hasta que se finalice la instalación, este proceso puede demorar unos cuantos minutos dependiendo de su velocidad de descarga.

<figure><img src="https://177299348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbyV2zAlQAiqg46a3Lr8z%2Fuploads%2F18J088STYAyw3mTezzdp%2Fuser-manual-arduino-step-3.png?alt=media&amp;token=58767cec-78ac-44c2-9a9a-ac24d3e939b8" alt=""><figcaption></figcaption></figure>

4. Posteriormente da clic en **"Herramientas"** > **"Placa"** > **"esp32"** > **"ESP32S3 Dev Module"**.

<figure><img src="https://177299348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbyV2zAlQAiqg46a3Lr8z%2Fuploads%2F4rHMuknCoZEAiDM5BE0x%2Fuser-manual-arduino-step-4.png?alt=media&amp;token=f856d747-ae14-4a4e-8613-371896d5c526" alt=""><figcaption></figcaption></figure>

5. Por último, configura la tarjeta como se muestra en la imagen, selecciona el puerto asignado por el módulo y estará listo para usarse.

<figure><img src="https://177299348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbyV2zAlQAiqg46a3Lr8z%2Fuploads%2FXAKwYR7uLjLOf0Qanpav%2Fuser-manual-arduino-step-5.png?alt=media&amp;token=61305798-57cd-4da2-bc9d-6722dc93758f" alt=""><figcaption></figcaption></figure>

</details>

### **2. Uso de los pines mikroBUS del XC01 R5-I en el Arduino® IDE**

El XC01 R5-I cuenta con 12 pines expuestos, 7 reservados para comunicaciones seriales (**SCK, MISO, MOSI, TX, RX, SDA, SCL**) y 5 para uso de propósito general. Además, dispone de 1 pin interno adicional para controlar el LED integrado (GPIO16).

<figure><img src="https://177299348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbyV2zAlQAiqg46a3Lr8z%2Fuploads%2F4ETcLwq5gxPhZeN7yypp%2Fuser-manual-mikrobus-pinout-table.png?alt=media&amp;token=e539aaff-fa68-4b88-a0d9-35368c19b3a8" alt=""><figcaption></figcaption></figure>

### **3. Plantilla de Arduino® IDE**

<details>

<summary>Plantilla para usar el XC01 R5-I en Arduino® IDE</summary>

```cpp
#include <Arduino.h>
#include <Wire.h>
#include <SPI.h>

#define MIKROBUS_AN 4
#define MIKROBUS_RST 15
#define MIKROBUS_CS 6
#define MIKROBUS_SCK 8
#define MIKROBUS_MISO 18
#define MIKROBUS_MOSI 17
#define MIKROBUS_PWM 5
#define MIKROBUS_INT 7
#define MIKROBUS_RX 9
#define MIKROBUS_TX 10
#define MIKROBUS_SCL 13
#define MIKROBUS_SDA 12

#define BOARD_LED 16

void setup(){

  // mikroBUS GPIO
  pinMode( MIKROBUS_AN, OUTPUT );
  pinMode( MIKROBUS_RST, OUTPUT );
  pinMode( MIKROBUS_CS, OUTPUT );
  pinMode( MIKROBUS_PWM, OUTPUT );
  pinMode( MIKROBUS_INT, OUTPUT );
  pinMode( BOARD_LED, OUTPUT );

  digitalWrite( MIKROBUS_AN, HIGH );
  digitalWrite( MIKROBUS_RST, HIGH );
  digitalWrite( MIKROBUS_CS, HIGH );
  digitalWrite( MIKROBUS_PWM, HIGH );
  digitalWrite( MIKROBUS_INT, HIGH );
  digitalWrite( BOARD_LED, HIGH );

  // UART config
  Serial.begin( 115200 ); // USB/UART0
  Serial2.begin( 115200, SERIAL_8N1, MIKROBUS_RX, MIKROBUS_TX ); // mikroBUS
  
  // I2C config
  Wire.setPins( MIKROBUS_SDA, MIKROBUS_SCL ); // mikroBUS
  Wire.begin();

  // SPI config
  SPI.begin( MIKROBUS_SCK, MIKROBUS_MISO, MIKROBUS_MOSI ); // mikroBUS
}

void loop(){

  digitalWrite( MIKROBUS_AN, LOW );
  digitalWrite( MIKROBUS_RST, LOW );
  digitalWrite( MIKROBUS_CS, LOW );
  digitalWrite( MIKROBUS_PWM, LOW );
  digitalWrite( MIKROBUS_INT, LOW );

  delay( 1000 );

  digitalWrite( MIKROBUS_AN, HIGH );
  digitalWrite( MIKROBUS_RST, HIGH );
  digitalWrite( MIKROBUS_CS, HIGH );
  digitalWrite( MIKROBUS_PWM, HIGH );
  digitalWrite( MIKROBUS_INT, HIGH );

  delay( 1000 );

}

```

</details>

## **III. Uso del XN03 - Entradas y Salidas Analógicas** <a href="#iii.-uso-del-xn01-entradas-digitales" id="iii.-uso-del-xn01-entradas-digitales"></a>

El [**XN03 Analog Inputs-Outputs**](https://docs.microside.com/plataforma-xide-iot/x-nodes/xn03-entradas-salidas-analogicas/r2/x-node-xn03-entradas-salidas-analogicas.md) es un expansor de entradas y salidas analógicas que utiliza el protocolo I2C para leer hasta 4 señales analógicas y generar hasta 3 señales analógicas o PWM. Para realizar pruebas rápidas durante tus proyectos, el módulo ya integra en la placa un potenciómetro (conectado a una de las entradas analógicas) y un LED RGB para visualizar cambios de intensidad o color, además de contar con terminales para conectar sensores analógicos externos o controlar actuadores como motores y luces.

El siguiente fragmento de código describe cómo utilizar el [**XN03 Analog Inputs-Outputs**](https://docs.microside.com/plataforma-xide-iot/x-nodes/xn03-entradas-salidas-analogicas/r2/x-node-xn03-entradas-salidas-analogicas.md) en Arduino® IDE.

```
pot = Wire.read();

  // Enviar condición de inicio + dirección
  // + tipo operación
  Wire.beginTransmission(0x03);

  // Escribe la dirección del registro del canal 1 (0x01)
  Wire.write(0x01);
  // Escribir el valor del canal 1 (color rojo)
  Wire.write(rgb_color[0]);
  // Escribir de forma secuencial asigna el valor del canal 2 (verde)
  Wire.write(rgb_color[1]);
  // El canal 3 (azul)
  Wire.write(rgb_color[2]);
  // Y la intensidad
  Wire.write(pot);
```

Para utilizar el [**XN03 Analog Inputs-Outputs**](https://docs.microside.com/plataforma-xide-iot/x-nodes/xn03-entradas-salidas-analogicas/r2/x-node-xn03-entradas-salidas-analogicas.md) de forma programática se recomienda entender como [manipular bits en el lenguaje C++](https://www.luisllamas.es/cpp-operadores-bitwise/).

### Ejemplo de uso del XN03

<details>

<summary>Código de ejemplo con el XC01 R5</summary>

```
// Este ejemplo permite controlar la intensidad del 
// LED RGB del X-NODE utilizando el potenciómetro.

#include <Arduino.h>
#include <Wire.h>

// Configura este valor para cambiar el color RGB
const uint8_t rgb_color[] = { 227, 235, 23 };

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() {
  // Controla la intensidad del led RGB con el potenciómetro del XN03

  uint8_t bytes_recv = 0;
  uint8_t pot = 0;

  // Enviar condición de inicio + dirección
  // + tipo operación
  Wire.beginTransmission(0x03);
  // Escribe la dirección del registro del potenciómetro (0x1E)
  Wire.write(0x10);

  // Verificar si la operación fue exitosa
  if (Wire.endTransmission() != 0) {
    Serial.println("Error al solicitar el registro");
    delay(1000);
    return;
  }

  // Enviar condición de inicio + dirección
  // + tipo operación + cantidad de bytes a leer
  bytes_recv = Wire.requestFrom(0x03, 1);

  // Confirmar que se recibió 1 byte
  if (bytes_recv != 1) {
    Serial.println("Error al leer el registro");
    delay(1000);
    return;
  }

  pot = Wire.read();

  // Enviar condición de inicio + dirección
  // + tipo operación
  Wire.beginTransmission(0x03);

  // Escribe la dirección del registro del canal 1 (0x01)
  Wire.write(0x01);
  // Escribir el valor del canal 1 (color rojo)
  Wire.write(rgb_color[0]);
  // Escribir de forma secuencial asigna el valor del canal 2 (verde)
  Wire.write(rgb_color[1]);
  // El canal 3 (azul)
  Wire.write(rgb_color[2]);
  // Y la intensidad
  Wire.write(pot);

  if (Wire.endTransmission() != 0){
    Serial.println("Error al escribir el valor RGB");
    delay(1000);
  }

  delay(100);
}

```

</details>

## **IV. Uso del XN13 - Relevador** <a href="#iii.-uso-del-xn01-entradas-digitales" id="iii.-uso-del-xn01-entradas-digitales"></a>

El [**XN13 Relay**](https://docs.microside.com/plataforma-xide-iot/x-nodes/x-node-xn13-1-relevador/r2/x-node-xn13-1-relevador-8a.md) es un módulo de potencia que utiliza el protocolo I2C para controlar el encendido y apagado (ON/OFF) de cargas eléctricas externas, funcionando como un interruptor controlado digitalmente. A través de sus conectores tipo clema, permite conectar y accionar de forma segura dispositivos que requieren mayor voltaje o corriente (hasta 250 VAC o 30 VDC a 8 A), como lámparas, motores, electroválvulas o alarmas.

El siguiente fragmento de código describe cómo utilizar el [**XN13 Relay**](https://docs.microside.com/plataforma-xide-iot/x-nodes/x-node-xn13-1-relevador/r2/x-node-xn13-1-relevador-8a.md) en Arduino® IDE.

```
Wire.beginTransmission(0x0D);
  // Selecciona el registro
  Wire.write( 0x01 );
  // Apaga el relevador
  Wire.write(0x00);
```

Para utilizar el [**XN13 Relay**](https://docs.microside.com/plataforma-xide-iot/x-nodes/x-node-xn13-1-relevador/r2/x-node-xn13-1-relevador-8a.md) de forma programática se recomienda entender como [manipular bits en el lenguaje C++](https://www.luisllamas.es/cpp-operadores-bitwise/).

### Ejemplo de uso del XN13

<details>

<summary>Código de ejemplo con el XC01 R5</summary>

```
// Este ejemplo muestra el control de la salida
// del X-NODE encendiendo y apagando el relevador

#include <Arduino.h>
#include <Wire.h>

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() {
  
  Wire.beginTransmission(0x0D);
  // Selecciona el registro
  Wire.write( 0x01 );
  // Enciende el relevador
  Wire.write(0x01);

  // Verificar si la operación fue exitosa
  if (Wire.endTransmission() != 0) {
    Serial.println("Error");
    delay(5000);
    return;
  }

  delay(5000);

  Wire.beginTransmission(0x0D);
  // Selecciona el registro
  Wire.write( 0x01 );
  // Apaga el relevador
  Wire.write(0x00);

  // Verificar si la operación fue exitosa
  if (Wire.endTransmission() != 0) {
    Serial.println("Error");
    delay(5000);
    return;
  }

  delay(5000);
}

```

</details>

## **V. Uso del XN14 - Fuente de alimentación 24 VDC** <a href="#iii.-uso-del-xn01-entradas-digitales" id="iii.-uso-del-xn01-entradas-digitales"></a>

El [**XN14 Power Supply DC**](https://docs.microside.com/plataforma-xide-iot/x-nodes/x-node-xn14-fuente-de-alimentacion-24v-dc.md) es un módulo de alimentación con una entrada de 7 a 24 VDC y una salida regulada de 3.3V y 5V DC. Incluye un fusible de protección de 1 A e indicadores LED de estado, lo que permite energizar sistemas basados en XIDE de forma segura utilizando baterías o eliminadores de corriente continua de nivel industrial.

### ¿Cómo usar el XN14?

{% hint style="danger" %}
**¡PRECAUCIÓN, CONEXIÓN Y POLARIDAD!** **Nunca** conectes una fuente de alimentación en el conector *jack barrel* y otra en la terminal tipo clema al mismo tiempo, ya que puedes dañar los dispositivos. **Antes de energizar** usando la clema, verifica que el voltaje de tu fuente esté dentro del rango de 7 a 24 VDC y respeta la polaridad indicada en la tarjeta (+ y -) para evitar cortocircuitos.
{% endhint %}

Para alimentar el XN14 tienes dos opciones (utiliza solo una a la vez):

1. Conector Jack Barrel: Conecta directamente un eliminador de pared estándar de 7 a 24 VDC (con centro positivo).
2. Conector tipo clema: Con la fuente de alimentación apagada o desconectada, inserta el cable positivo (+) en la terminal marcada con + (o VIN) y el cable negativo (-) en la terminal GND, utilizando cable calibre 18 a 26 AWG y asegurando los tornillos.

Inserta el [**XN14 Power Supply DC**](https://docs.microside.com/plataforma-xide-iot/x-nodes/x-node-xn14-fuente-de-alimentacion-24v-dc.md) en el zócalo [mikroBUS™](https://www.mikroe.com/mikrobus), energiza tu fuente externa y verifica que los LEDs indicadores enciendan para confirmar que los voltajes de 3.3V y 5V están activos.

## **VI. Uso del XN44 - Buzzer** <a href="#iii.-uso-del-xn01-entradas-digitales" id="iii.-uso-del-xn01-entradas-digitales"></a>

El [**XN44 Buzzer**](https://docs.microside.com/plataforma-xide-iot/x-nodes/x-node-xn44-buzzer.md) es un generador de sonido que utiliza el protocolo I2C para emitir tonos audibles con frecuencia (de 31 Hz a 20 kHz) y duración configurables (de forma continua o desde 1 ms hasta 60 s). Es ideal para agregar alertas sonoras, alarmas, confirmaciones al presionar botones o melodías sencillas en tus proyectos sin necesidad de generar señales PWM manualmente desde tu controlador principal.

El siguiente fragmento de código describe cómo utilizar el [**XN44 Buzzer**](https://docs.microside.com/plataforma-xide-iot/x-nodes/x-node-xn44-buzzer.md) en Arduino® IDE.

```
void loop() {
  // Reproduce cada una de las notas de la escala
  for (uint8_t i = 0; i < sizeof(notes) / sizeof(notes[0]); i++) {

    // Enviar condición de inicio + dirección
    // + tipo operación
    Wire.beginTransmission(0x2C);
    // Escribe la dirección del registro TONE (0x01)
    Wire.write(0x01);
    // Escribe la frecuencia, primero el byte más significativo
    Wire.write(notes[i] >> 8);
    Wire.write(notes[i] & 0xFF);
    // Escribe la duración, primero el byte más significativo
    Wire.write(note_duration >> 8);
    Wire.write(note_duration & 0xFF);

    // Verificar si la operación fue exitosa
    if (Wire.endTransmission() != 0) {
      Serial.println("Error");
      delay(1000);
      return;
    }
```

Para utilizar el [**XN44 Buzzer**](https://docs.microside.com/plataforma-xide-iot/x-nodes/x-node-xn44-buzzer.md) de forma programática se recomienda entender como [manipular bits en el lenguaje C++](https://www.luisllamas.es/cpp-operadores-bitwise/).

### Ejemplo de uso del XN44

<details>

<summary>Código de ejemplo con el XC01 R5</summary>

```
// Este ejemplo reproduce una escala musical
// utilizando el buzzer del X-NODE.

#include <Arduino.h>
#include <Wire.h>

// Frecuencias (Hz) de las notas Do, Re, Mi, Fa, Sol, La, Si, Do
const uint16_t notes[] = { 262, 294, 330, 349, 392, 440, 494, 523 };

// Duración de cada nota (ms)
const uint16_t note_duration = 250;

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() {
  // Reproduce cada una de las notas de la escala
  for (uint8_t i = 0; i < sizeof(notes) / sizeof(notes[0]); i++) {

    // Enviar condición de inicio + dirección
    // + tipo operación
    Wire.beginTransmission(0x2C);
    // Escribe la dirección del registro TONE (0x01)
    Wire.write(0x01);
    // Escribe la frecuencia, primero el byte más significativo
    Wire.write(notes[i] >> 8);
    Wire.write(notes[i] & 0xFF);
    // Escribe la duración, primero el byte más significativo
    Wire.write(note_duration >> 8);
    Wire.write(note_duration & 0xFF);

    // Verificar si la operación fue exitosa
    if (Wire.endTransmission() != 0) {
      Serial.println("Error");
      delay(1000);
      return;
    }

    // El X-NODE reproduce el tono por su cuenta,
    // espera a que finalice antes de enviar la siguiente nota
    delay(note_duration + 50);
  }

  delay(1000);
}
```

</details>

## **VII. App XIDE Launcher** <a href="#iii.-uso-del-xn01-entradas-digitales" id="iii.-uso-del-xn01-entradas-digitales"></a>

<figure><img src="https://177299348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbyV2zAlQAiqg46a3Lr8z%2Fuploads%2FP0UjgPVMmQIB8XaU38W5%2Fimage.png?alt=media&amp;token=8dae9c67-70aa-4b2d-8ac2-df8bdd1514bf" alt=""><figcaption></figcaption></figure>

### XIDE App

**XIDE Launcher** es una plataforma web que permite configurar, controlar y monitorear los módulos X-NODE desde tu computadora sin necesidad de instalar programas adicionales. A través de su interfaz puedes detectar automáticamente los nodos conectados por comunicacion serial, visualizar en tiempo real las lecturas de los sensores (como temperatura, humedad o entradas analógicas/digitales) y enviar señales para activar salidas, relevadores o el buzzer con un clic, facilitando las pruebas de escritorio antes de armar la lógica final de tu proyecto.

{% hint style="info" %}
**¿Listo para comenzar?** Accede al lanzador oficial de XIDE para configurar tu entorno y realizar tu primera conexión con la guía de inicio rápido.
{% endhint %}

{% embed url="<https://xide-launcher.netlify.app/quick-start>" %}
Haz clic aquí para abrir la guía de inicio rápido de XIDE App
{% endembed %}

## Descargas

{% file src="/files/DTKbOp8GpF5F1loj3Hx7" %}
