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

> Crear buses SDA y SCL con dispositivos, lecturas, escrituras y respuestas.

I2C usa dos líneas: **SDA** lleva los datos y **SCL** marca cuándo se leen. Un **maestro** inicia la conversación con un **dispositivo** identificado por su dirección. El generador dibuja en ambos canales START, dirección, bits de lectura o escritura, datos, respuestas ACK o NACK y STOP.

Puedes crear todo el universo de señales I2C disponible en el generador: direcciones de **7 o 10 bits**, escrituras, lecturas, sondeos, START repetidos, dispositivos que no responden, NACK en datos, varios maestros, arbitraje, modo de alta velocidad, reloj retenido y hasta **ocho buses** cuando hay canales. Cada bus necesita **dos canales**, uno SDA y otro SCL.

## Crear tu primera transferencia

**1. Abre I2C**

En modo digital, pulsa **Generadores → I2C**. Empieza en **I2C 1**.

**2. Agrega un dispositivo**

Pulsa **Agregar un dispositivo al bus** y elige uno de los ejemplos o escribe su dirección, como `0x3C`. También puedes escribir `@` en el cuadro del mensaje y elegirlo de la lista. El dispositivo queda en el grupo del bus.

**3. Elige la operación y los bytes**

Selecciona **Escribe** para enviar datos al dispositivo. En modo hexadecimal, escribe por ejemplo `00 AF` y pulsa **Enter** o **Agregar a la señal**. El generador dibuja START, dirección, ACK, los dos bytes y STOP.

**4. Comprueba las líneas**

Usa **Ver en la señal** para seleccionar el tramo en SDA y SCL. En el chat, los mensajes enviados aparecen a la derecha y las lecturas a la izquierda.

## Dispositivos y direcciones

La barra del grupo reúne los dispositivos del bus. Puedes agregar uno de los modelos comunes o crear uno **por dirección**, ponerle nombre y color, mencionarlo con `@`, o quitarlo. Cada dirección identifica a un dispositivo del mismo bus; el panel impide duplicarla. El límite del generador es **128 dispositivos por bus**.

| Dirección | Cómo escribirla | Ejemplo |
| - | - | - |
| **7 bits** | De `0x00` a `0x77`, salvo `0x04` a `0x07`, reservadas para códigos de maestro Hs | `0x3C` |
| **10 bits** | De `0x000` a `0x3FF`; escribe tres dígitos hexadecimales | `0x1A5` |

Algunas hojas de datos muestran la dirección de **8 bits**, que ya incluye el bit de lectura o escritura. Si escribes por ejemplo `0x78`, el panel sugiere la dirección de 7 bits `0x3C`.

> [!NOTE]
>
> **No responde** en un dispositivo simula que está desconectado: responde con NACK en la dirección de todos sus mensajes. Puedes cambiar también la respuesta de un mensaje concreto desde su control **ACK o NACK**.

> [!TIP]
>
> El generador deja **SCL en TX** y **SDA como línea compartida (TX/RX)**. Al ejecutar en el ESP32, el equipo maneja SDA en drenaje abierto, la suelta en los acuses y en los bytes que lee, y compara lo que contesta el dispositivo real con lo dibujado (ver [Recepción](https://docs.oryx.mechatronstudio.com/dispositivo/recepcion.md)).

## Qué puede decir un mensaje

| Control | Qué hace |
| - | - |
| **Escribe** | El maestro envía los bytes; el dispositivo confirma con ACK |
| **Lee** | El dispositivo entrega los bytes indicados; el maestro termina el último con NACK |
| **Texto, hexadecimal o decimal** | Tres maneras de introducir los mismos datos; por ejemplo `00 AF` en hexadecimal |
| **Solo la dirección** | Con **Escribe** y el cuadro vacío, pulsa el botón de agregar: crea un sondeo como el de un escáner I2C |
| **ACK o NACK** | Deja la respuesta normal, simula un NACK de dirección o el rechazo de un byte de escritura; tras el NACK se libera el bus |
| **START repetido** | Continúa con el mismo maestro sin soltar el bus; útil para escribir el número de registro y leer su contenido |
| **Hs** | Envía primero el código de maestro al ritmo normal, luego un START repetido y continúa al ritmo de alta velocidad |

### Ejemplo: leer un registro

**1. Indica el registro**

Menciona el dispositivo, elige **Escribe** e introduce el número del registro, por ejemplo `00`. Agrega el mensaje.

**2. Pide su valor**

Elige **Lee**, introduce los bytes que devolverá el dispositivo, por ejemplo `19 2A`, y activa **START repetido** antes de agregar. El bus no se libera entre los dos mensajes.

## Varios buses y maestros

El selector **I2C 1** agrega buses hasta un máximo de ocho, siempre que haya dos canales libres para cada uno. Cada bus conserva sus propios SDA, SCL, dispositivos y ritmo. Para agregar el siguiente, primero agrega un mensaje al bus actual. En las opciones del bus puedes ver sus canales, cambiar su color o eliminarlo; al eliminarlo se borran sus mensajes, dispositivos y canales.

Puedes agregar hasta **ocho maestros por bus**. El primero representa el micro habitual. Elige **Quién habla** para atribuir cada mensaje a uno de ellos. Si dos maestros distintos empiezan al mismo tiempo en el mismo bus con **En paralelo**, la señal muestra el **arbitraje**: uno gana; el otro reintenta cuando el bus queda libre. Si envían exactamente lo mismo, en el cable aparece una sola transferencia. En buses distintos, **En paralelo** permite transferencias simultáneas sin arbitraje.

> [!NOTE]
>
> **START repetido** y **En paralelo** son alternativas para un mismo mensaje. El START repetido solo se aplica si el mensaje anterior es del mismo bus y maestro, y no terminó en NACK.

## Ritmo, pausas y una señal ya dibujada

En **Ajustes** puedes cambiar **Entre mensajes** (pasos con SDA y SCL en alto entre STOP y START) y el ritmo **por bus**:

| Ajuste | Qué cambia |
| - | - |
| **Pasos por bit** | Tiempo de cada bit: por defecto son **2 pasos**, uno con SCL bajo y otro con SCL alto |
| **Reloj retenido tras cada ACK** | Pasos adicionales en que el dispositivo mantiene SCL bajo (*clock stretching*) |
| **Pasos por bit en Hs** | Ritmo de los bits de mensajes en modo de alta velocidad |

La velocidad de reproducción de los pasos determina la velocidad real del bus. Si ya dibujaste SDA y SCL, el panel puede **leer el bus ya dibujado**: elige qué canal cumple cada función y pulsa **Leer mensajes**. Si encuentra transferencias, las muestra en el chat. Un aviso señala detalles de un dibujo manual que el chat no puede representar; al cambiar algo desde el generador, el bus se rearma a partir de los mensajes y puedes deshacerlo.

Para interpretar los campos y los errores de una transferencia, consulta la [lectura I2C](https://docs.oryx.mechatronstudio.com/protocolos/i2c.md).


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