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

# Generators

> Create protocol signals from messages and settings without drawing every bit by hand.

**Generators** turn a conversation into digital signals. You write messages and choose how devices communicate; Oryx draws the bits on the timeline. The chat and the signal show the same exchange.

With [UART](https://docs.oryx.mechatronstudio.com/en/generators/uart.md) and [I2C](https://docs.oryx.mechatronstudio.com/en/generators/i2c.md), you can create **the full range of signals these generators support**: different frames, data, addresses, replies, pauses, and simultaneous conversations. Combine the settings to build anything from a simple exchange to several ports or buses at once. Each guide describes its available options.

> [!NOTE]
>
> UART and I2C generators work in **digital mode**. Available ports, buses, and channels also depend on the editor and your plan.

## On your phone

The phone follows the same steps as the computer —welcome, new project, the
signal and testing it—, and the signal is built with the generators.

**1. New project**

On the welcome screen, **New project** asks how to start, just like on the
computer: **Design a signal with a generator** shows the types (choose
**Digital** or **Analog** and tap one) and **Import** brings an image or a
file; when it is done, the optimizer says what signal it is and opens it
in its generator.

**2. Write or adjust**

The generator opens full screen; the chat ones (UART, I2C, SPI, equations)
take the whole height, like a messaging app. Tap a message to see its
actions. A signal is made with **a single generator**: to combine several,
continue on your PC.

**3. View signal**

**View signal**, in the top bar, opens the signal page: play it, zoom in,
read the protocol interpreter under each channel, save it, export it or
test it on the device. It turns on once something is drawn.

Back goes from the signal to the generator, and from the generator to the
welcome screen, which shows your signal under **Pick up where you left off**
with **Keep editing**, **View signal** and **Save** (below, smaller, what you
need to start another project). Opening the signal from there is just for
looking: back returns to the welcome screen. To draw by hand cell by cell, continue on your computer: the
same signal is waiting for you there.

## Get started

**1. Open Generators**

In the digital editor, click **Generators** beside the timeline and choose **UART** or **I2C**.

**2. Set up the exchange**

In UART, choose **TX** for a sent message or **RX** for a reply. In I2C, add or mention a device and choose **Write** or **Read**.

**3. Type and add**

Enter text, hexadecimal bytes (`0x`), or decimal numbers (`123`). A draft appears in the signal while you type. Press **Enter** or the add button to commit it.

**4. Inspect the signal**

Each message shows its byte and step counts. Use **Show in the signal** to locate it. The [protocol interpreter](https://docs.oryx.mechatronstudio.com/en/protocols/introduction.md) explains the fields beneath the channels.

## Work with messages

You can **edit, duplicate, reorder, or delete** a message. The panel redraws its lines when you change the conversation or settings. **Clear all** removes the generator's messages. Messages are saved with the project so the chat returns when you reopen it.

> [!WARNING]
>
> If you edit a signal by hand and the generator can no longer read it, the panel warns you. Your next generator change rebuilds its lines from the chat messages. You can undo that change.

> [card] [UART generator](https://docs.oryx.mechatronstudio.com/en/generators/uart.md)
>
> TX and RX messages, character formats, multiple ports, and pauses.

> [card] [I2C generator](https://docs.oryx.mechatronstudio.com/en/generators/i2c.md)
>
> Devices, addresses, reads, writes, and multiple buses.


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