> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oryx.mechatronstudio.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Generador UART

> Crear conversaciones serie TX y RX con cualquier combinación de los formatos disponibles.

UART envía datos por una línea serie. Cada carácter empieza con un **bit de arranque**, sigue con los **bits de datos**, puede llevar un **bit de paridad** y termina con **uno o dos bits de parada**. El generador dibuja todo eso a partir de tus mensajes: **un paso de la línea de tiempo equivale a un bit**.

Puedes crear todo el universo de señales UART que admite el editor: cualquier combinación de bits de datos, paridad, parada, orden y polaridad disponibles; mensajes de texto o bytes, TX y RX, pausas y hasta **ocho puertos UART** si tienes canales suficientes. Cada puerto puede ocupar dos canales, uno por dirección.

## Crear tu primera conversación

**1. Abre UART**

En modo digital, pulsa **Generadores → UART**. El formato inicial es `8N1`: ocho bits de datos, sin paridad y un bit de parada.

**2. Elige TX o RX**

**TX** es lo que envía tu dispositivo; **RX**, lo que recibe como respuesta. Se dibujan en líneas distintas.

**3. Escribe un mensaje**

Deja el modo **Texto** y escribe `AT` en TX. Pulsa **Enter** o **Agregar a la señal**. Cambia a RX y agrega `OK`. El chat muestra la petición a la derecha y la respuesta a la izquierda; los bits aparecen en la línea de tiempo.

**4. Mira un carácter**

En `8N1`, cada carácter ocupa **10 pasos**: arranque + 8 datos + parada. Usa **Ver en la señal** en un mensaje para encontrarlo. También puedes abrir la [lectura UART](https://docs.oryx.mechatronstudio.com/protocolos/uart.md) para entender las barras de arranque, datos y parada.

## Cómo escribir los datos

| Modo | Qué escribes | Para qué sirve |
| - | - | - |
| **Texto** | `Hola`, `AT\r\n` o `\x1B` | Comandos y texto; admite secuencias como `\n`, `\r`, `\t` y `\xFF` |
| **Hexadecimal (`0x`)** | `55 AA 01 FF` | Bytes exactos, incluso los que no se ven como letras |
| **Decimal (`123`)** | `85 170 1 255` | Los mismos valores escritos en base diez |

El botón de **fin de línea** agrega automáticamente nada, `\n`, `\r` o `\r\n` al final de **cada mensaje de texto**. Es útil para comandos que esperan Enter, como muchos comandos AT. Puedes cambiarlo también en los ajustes. En los modos numéricos no se agrega.

> [!NOTE]
>
> Con **5 o 6 bits de datos**, el modo Texto no está disponible: usa hexadecimal o decimal. Un valor numérico que no cabe en los bits elegidos no se transmite y el panel lo indica. Si un carácter de texto excede el ancho elegido, el panel avisa que se truncará.

## Ajustar la forma de cada carácter

Abre el botón de formato de la franja superior, que muestra algo como `8N1`. Hay accesos rápidos para `8N1`, `8E1`, `7E1` y `8N2`; también puedes combinar los controles uno por uno.

| Ajuste | Opciones | Qué cambia |
| - | - | - |
| **Bits de datos** | 5, 6, 7, 8 o 9 | Cuántos bits lleva cada carácter |
| **Paridad** | Ninguna, par, impar, siempre 1 o siempre 0 | Agrega un bit para comprobar o fijar su valor |
| **Bits de parada** | 1 o 2 | Cuánto dura el cierre del carácter |
| **Orden de bits** | LSB o MSB primero | Qué extremo del número sale primero; LSB es el UART habitual |
| **Polaridad** | Normal o invertida | En normal el reposo es alto; en invertida es bajo |

Por ejemplo, `8E1` usa ocho bits de datos, paridad par y una parada. El formato afecta a todos los mensajes UART del panel. La polaridad invertida sirve para representar una línea RS-232 tal como se ve en el cable.

## Puertos, pausas y simultaneidad

El selector **UART 1** permite agregar más puertos, hasta ocho. Cada uno tiene su propio **TX** y **RX**. Para agregar el siguiente, primero debe haber un mensaje en el puerto actual; cada línea necesita un canal disponible. Desde las opciones del puerto puedes ver sus canales, cambiar su color, intercambiar TX y RX o eliminar el puerto. Eliminarlo también borra sus mensajes y canales.

En **Ajustes → Pausas**, **Entre caracteres** deja la línea en reposo dentro de un mensaje y **Entre mensajes** separa transmisiones. El panel mantiene estas pausas dentro del intervalo que permite leer cada mensaje como una unidad distinta. Por defecto los caracteres van juntos y hay **50 pasos** entre mensajes.

Cada puerto toma sus canales con su dirección: **TX transmite y RX recibe**. Al ejecutar en el ESP32, lo que escribes por RX es la respuesta esperada: el equipo la escucha y la compara (ver [Recepción](https://docs.oryx.mechatronstudio.com/dispositivo/recepcion.md)).

El botón **En paralelo** hace que un mensaje empiece junto al anterior cuando usa una línea libre, por ejemplo TX y RX o dos puertos distintos. Si esa misma línea está ocupada, el panel lo coloca a continuación y lo indica.

> [!NOTE]
>
> Aquí eliges la forma de los bits, no los baudios. Al reproducir en un dispositivo, la velocidad en **bps** determina cuánto dura cada paso: por ejemplo, 9600 o 115200 bps.

## Cambiar lo que ya creaste

En cada mensaje puedes **verlo en la señal, editarlo, duplicarlo, moverlo, eliminarlo o cambiar TX por RX**. Si cambias el formato o el fin de línea, revisa el recuento de bytes y los avisos del chat: el generador vuelve a construir la señal con los ajustes nuevos.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.