> ## 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.

# Recepción (canales RX)

> Dibujar la respuesta que esperas, ejecutarla en el ESP32 y ver si llegó, llegó mal o no llegó.

Un canal puede **transmitir** o **recibir**. Lo que dibujas o generas en un
canal **TX** es lo que el equipo emite; lo que dibujas en un canal **RX** es lo
que **esperas recibir**. Al ejecutar, el equipo emite los TX, escucha los RX y
Oryx compara lo que llegó con lo dibujado.

El dibujo y la edición son iguales en los dos: la diferencia está solo en qué
hace el equipo con cada canal.

| Dirección | Rótulo | Qué hace el equipo |
| - | - | - |
| **Transmisión** | `TX ↑` | Emite el dibujo por el pin del canal (lo de siempre) |
| **Recepción** | `RX ↓` | No maneja la línea: la escucha (o, en analógico, la mide con el ADC) y la compara con el dibujo |
| **Compartida** | `TX/RX ↕` | Emite su parte y escucha la del otro lado, en drenaje abierto (la SDA de I2C) |

> [!NOTE]
>
> La recepción está disponible en **todos los planes**, también en Básico:
> configurar canales RX, ejecutar, comparar respuestas, ver los diagnósticos y
> exportar con datos de recepción.

## Convertir un canal

**1. Abre los ajustes del canal**

En la tarjeta de nombre del canal, el botón de la derecha (la paleta, o el
rótulo `TX`/`RX` cuando el proyecto ya tiene canales que reciben).

**2. Elige la dirección**

**TX**, **RX** o **TX/RX**. El dibujo no cambia.

También se cambia en **Canales** (el organizador), desde el mismo desplegable
del color. El cambio se guarda con el proyecto, se deshace con `Ctrl + Z` y
viaja al duplicar, compartir, guardar como plantilla, importar y exportar.

Mientras ningún canal recibe, la línea de tiempo se ve como siempre. Con al
menos uno, todos los canales muestran su rótulo `TX ↑` o `RX ↓` junto al
nombre: se distingue por el texto y la flecha, no por el color, que sigue
siendo el de la señal.

### Los generadores asignan la dirección solos

| Generador | Canales |
| - | - |
| **UART** | `TX` transmite, `RX` recibe |
| **SPI** | Reloj, MOSI, CS y D/C transmiten; `MISO` recibe (Oryx es el controlador) |
| **I2C** | `SCL` transmite; `SDA` es compartida (`TX/RX`) |
| PWM, Step/Dir, encoders, CKP/CMP, ondas, ecuaciones | Transmiten |

La dirección se pone cuando el generador **toma** el canal. Si después la
cambias a mano, se respeta: editar mensajes o volver a generar no la pisa. Los
canales creados a mano empiezan en TX.

> [!TIP]
>
> Para probar el equipo desde el **lado del periférico SPI** (Oryx responde por
> MISO y escucha MOSI), invierte a mano los canales: reloj, MOSI y CS a RX,
> MISO a TX. La exportación estructurada lo toma como rol *periférico*.

## Una conversación TX/RX con UART

**1. Arma el pedido**

En el generador UART, escribe el mensaje por **TX** (por ejemplo `AT\r`).

**2. Dibuja la respuesta esperada**

Escribe en **RX** la respuesta que debe devolver el dispositivo
(`OK\r\n`), donde la esperas en el tiempo. El canal RX ya queda como
recepción.

**3. Ejecuta**

Abre **Dispositivo**, conecta el ESP32 y pulsa **Iniciar**. El equipo emite
TX y escucha RX durante la primera vuelta de la señal.

**4. Lee el resultado**

En la sección **Recepción** del panel aparece el veredicto de cada canal
RX, con lo esperado y lo recibido. **Capturar otra vuelta** repite la
prueba sin detener la señal.

Conecta el **TX del dispositivo** al pin del canal **RX** de Oryx, y el
**RX del dispositivo** al pin del canal **TX**, con la masa en común.

## Resultados

| Veredicto | Qué significa |
| - | - |
| **Correcto** | Llegó lo esperado |
| **Incorrecto** | Llegó otra cosa: otro valor, datos de más, flancos de más |
| **Sin respuesta** | No llegó nada válido en la vuelta capturada (o, en I2C, nadie acusó la dirección) |
| **Incompleto** | Lo que llegó coincide, pero faltó el final |
| **Error de comunicación** | La recepción tuvo una falla identificable: paridad, framing, break |
| **Falla de captura** | El problema fue de la captura y no de la respuesta: la señal se detuvo a mitad de vuelta, el enlace se cortó o llegaron más flancos de los que el equipo puede guardar |

Cada veredicto viene con su causa cuando la captura la muestra:

| Causa | Ejemplo |
| - | - |
| Valor inesperado | *se esperaba 0x4B 'K' y llegó 0x4E 'N'* |
| Longitud incorrecta | *se esperaban 3 datos y llegaron 2* |
| Timeout | *no llegó nada en la vuelta capturada* |
| Paridad / framing / break | *error de framing en el carácter 2* |
| NACK | *nadie acusó en la transferencia 1* |
| Flanco faltante o de más | *faltó un flanco ↑ cerca del paso 11* (señales sin protocolo) |
| Fuera de tolerancia | *fuera de la tolerancia en el 15,8 % de las muestras* (analógicas) |
| Otra frecuencia | *se esperaban 4 ciclos y llegaron 8* (analógicas) |

Oryx no afirma una causa que el equipo no puede ver: por ejemplo, no informa
un CRC si el protocolo no lo lleva.

### Cómo se compara

* **UART, SPI e I2C se comparan por contenido**: bytes, palabras de MISO,
  direcciones, lecturas y acuses, con los mismos intérpretes que dibujan las
  barras del editor. Una respuesta que llega algo más tarde que lo dibujado
  sigue siendo correcta.
* **Las señales sin protocolo se comparan por flancos**: cada flanco esperado
  tiene que aparecer, con el mismo sentido, a menos de **1 paso** de donde se
  dibujó.
* **Las analógicas se comparan contra la curva**: cada muestra tiene que caer
  a menos de **5 % de la escala** (0,165 V) de la curva dibujada, en algún
  punto a menos de 1 paso. Hasta un 2 % de muestras fuera se toma como ruido
  y solo se avisa. Además se cuentan los ciclos para avisar si la frecuencia
  es otra.
* Lo esperado y lo recibido se muestran juntos en un dibujo chico, con las
  diferencias marcadas.

### SPI e I2C

* **SPI**: el equipo emite reloj, MOSI y CS, y compara cada palabra de MISO con
  la dibujada.
* **I2C**: el equipo emite SCL y maneja SDA en **drenaje abierto**. En las
  escrituras suelta la línea en los acuses; en las lecturas, en los bytes que
  manda el periférico. Lo que llega se compara como transferencias (dirección,
  datos, ACK/NACK). El bus necesita sus resistencias de pull-up.

## Señales analógicas

En un proyecto analógico, un canal **RX** es la curva que esperas **medir**.
Al ejecutar no sale por el DAC: el equipo la mide con su ADC mientras
reproduce los canales TX, una vuelta por arranque, igual que en digital. Un
proyecto analógico puede tener solo canales RX: el equipo no emite nada y
mide durante lo que dura la curva.

| Entrada | ESP32 clásico | ESP32-S3 |
| - | - | - |
| 1.ª | GPIO 34 | GPIO 1 |
| 2.ª | GPIO 35 | GPIO 2 |
| 3.ª | GPIO 32 | GPIO 8 |
| 4.ª | GPIO 33 | GPIO 9 |

> [!NOTE]
>
> El **ESP32-S3** no tiene DAC: en analógico no emite nada, pero **sí mide**.
> Con un S3, los canales TX de una señal analógica no salen (el panel lo avisa)
> y los RX se miden igual. Sirve para usarlo como medidor de una señal que
> genera otro equipo.

Los canales RX se asignan en orden a esas entradas, que el panel muestra junto
a cada canal. La altura del canal es **0 a 3,3 V** en el pin, la misma escala
con que el DAC emite: una curva dibujada al medio espera 1,65 V.

* Cada vuelta se toman hasta **2000 muestras por entrada**, repartidas a lo
  largo de la vuelta y como mucho una cada **200 µs** (con varias entradas,
  menos seguido). El panel dice cada cuántos pasos hubo una muestra: si la
  curva cambia más rápido que eso, baja la velocidad.
* Se mide con el **ADC1** y la calibración del chip. El ADC del ESP32 es
  impreciso cerca de 0 V y por encima de \~3,1 V: deja margen en esos extremos.

## Requisitos y límites

| Qué | Detalle |
| - | - |
| Firmware | El firmware de enlace **con recepción**. Uno anterior no escucha: si la señal tiene canales RX, Oryx no la envía y lo avisa, para que el equipo no maneje una línea que es del otro lado |
| Canales | Digitales: solo los canales con pin (los 8 primeros). Analógicos: hasta 4 (las entradas del ADC) |
| Analógicas | El ESP32 clásico emite y mide; el S3 solo mide. Hasta 2000 muestras por vuelta y entrada, una cada 200 µs como mucho; rango útil \~0,1–3,1 V |
| Velocidad | Cada flanco se marca con una interrupción (precisión de unos µs). Con pasos de menos de **10 µs** la captura puede correr flancos: el panel lo avisa |
| Captura | La primera vuelta de cada arranque, desde su comienzo. Cambiar la velocidad a mitad de una vuelta capturada la corre |
| I2C | Sin estiramiento del reloj: SCL lo maneja el equipo |
| SPI | Una línea por sentido (sin Dual/Quad/Octal en la captura) |
| Reproductor microSD | No recibe. Si un archivo trae canales RX, esos pines quedan como entradas y no se manejan |

> [!WARNING]
>
> Las salidas del ESP32 son de **3,3 V**. Un dispositivo de 5 V necesita
> adaptación de nivel en las líneas que llegan al equipo.

## Exportar con recepción

* **Oryx Signal Format (.osf)**: si la señal entera es UART, SPI o I2C, se ofrece
  como opción recomendada. Describe operaciones (escribir, esperar, leer) con
  las respuestas esperadas. Ver [Oryx Signal Format (.osf)](https://docs.oryx.mechatronstudio.com/exportar/json-protocolos.md).
* **TXT, CSV y JSON por pasos**: llevan qué columnas son RX. Ver
  [Formato digital](https://docs.oryx.mechatronstudio.com/exportar/formato-digital.md#canales-rx).


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