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

# Primeros pasos

> De la bienvenida a la primera señal exportada o reproducida.

## 1. Entrar

Al abrir la web aparece la **bienvenida**: a la izquierda qué es la app, a la
derecha lo que se puede hacer. Sin sesión iniciada la ventana no se puede
cerrar —ni con `Esc`, ni con clic afuera, ni con la cruz— y el panel derecho
muestra el formulario de entrada.

Hay tres formularios encadenados:

<Steps>
  <Step title="Crear cuenta">
    Nombre, correo y contraseña repetida. Se valida que el nombre no esté
    vacío, que el correo tenga forma de correo y que las dos contraseñas
    coincidan.
  </Step>

  <Step title="Iniciar sesión">
    Correo y contraseña.
  </Step>

  <Step title="Recuperar contraseña">
    Solo el correo. Contesta siempre lo mismo, exista o no la cuenta.
  </Step>
</Steps>

<Note>
  Tu sesión queda recordada, así que la próxima vez que abras la web entras
  directo.
</Note>

## 2. Elegir por dónde empezar

Con la sesión iniciada, el panel derecho ofrece cuatro tarjetas:

| Tarjeta            | Qué hace                                                            |
| ------------------ | ------------------------------------------------------------------- |
| **Nuevo proyecto** | Pregunta el modo —digital o analógico— y abre un proyecto en blanco |
| **Abrir proyecto** | Lista los proyectos guardados en la cuenta                          |
| **Cuenta**         | Datos de la cuenta y suscripción                                    |
| **Configuración**  | Preferencias del editor                                             |

También se puede cerrar la bienvenida e **ir al editor** tal como quedó.

## 3. Dibujar la señal

<Tabs>
  <Tab title="Digital">
    1. La línea de tiempo arranca con **dos canales** y **16 pasos** (el valor
       por defecto, ajustable en Configuración).
    2. Clic en una casilla para ponerla en alto o bajo.
    3. Arrastrar para seleccionar un tramo; `Shift + clic` extiende la
       selección.
    4. Con la selección hecha, la barra de abajo habilita **Copiar, Cortar,
       Pegar, Etiqueta, Eliminar, Insertar, Alternar, Invertir, División y
       Desfase**.
    5. `+` y `−` agregan y quitan pasos. `Z` ajusta el zoom a la pantalla.

    Detalle completo en [Edición digital](/editor/edicion-digital).
  </Tab>

  <Tab title="Analógico">
    1. Clic sobre una **divisora** para clavar un punto de conexión a la altura
       que marque el control **Eje Y**.
    2. Entre dos puntos consecutivos queda tendida una **cuerda**, recta de
       fábrica.
    3. Clic en la cuerda para seleccionarla: se habilitan **Eje X** (dónde se
       agarra), **Eje Y** (a qué altura se estira) y **Radio** (cuánto se
       redondea el pico).
    4. Doble clic sobre un punto lo elimina.

    Detalle completo en [Edición analógica](/editor/edicion-analogica).
  </Tab>
</Tabs>

## 4. Organizar los canales

El botón **Canales** de la cabecera abre el organizador: hasta **16 canales**,
de los que la línea de tiempo dibuja **4 a la vez**. Ahí se los reordena
arrastrando, se les cambia el color, se los oculta, se los duplica y se los
elimina.

Ver [Canales](/editor/canales).

## 5. Sacar la señal afuera

<Tabs>
  <Tab title="A un archivo">
    Botón **Exportar** de la cabecera, o la tecla `G`.

    1. Se elige el nombre del archivo.
    2. En analógico, la **resolución**: 8, 10, 12 o 16 bits.
    3. Opcionalmente se incluyen los **canales ocultos**.
    4. Opcionalmente se agregan **metadatos**: voltaje, tiempo de paso (µs) y
       ciclos (RPM). Todos los campos son opcionales.

    Baja un `.txt`. Ver [Exportar el proyecto](/exportar/exportar-proyecto).
  </Tab>

  <Tab title="A un ESP32">
    Botón **Dispositivo** de la cabecera.

    1. Cargar el firmware en la placa (una sola vez).
    2. **Elegir puerto** → el navegador lista los puertos serie.
    3. **Enviar señal** → la señal entera viaja a la memoria del equipo.
    4. **Iniciar señal** → el equipo la reproduce por sus salidas.

    Ver [Conectar el dispositivo](/dispositivo/conectar).
  </Tab>
</Tabs>

## Atajos que conviene saber desde el principio

| Tecla               | Qué hace                                     |
| ------------------- | -------------------------------------------- |
| `?` o `H`           | Abre la ayuda de atajos                      |
| `S`                 | Selecciona el paso del centro de la pantalla |
| `Espacio`           | Alterna alto / bajo                          |
| `Z` o `Ctrl+0`      | Ajusta el zoom a la pantalla                 |
| `G`                 | Exportar                                     |
| `Ctrl+Z` / `Ctrl+Y` | Deshacer / rehacer                           |

La lista entera está en [Atajos de teclado](/editor/atajos).
