# Primeros pasos

Bienvenido a CanoFlash. Esta guía explica la configuración del dispositivo y la carga de ROMs. Para crear un juego online, empieza por la [guía del SDK](/es/docs/sdk/getting-started).

## Quick Start

1. Crea tu cuenta en la web haciendo login con Google.
2. Vincula el número de serie de tu dongle desde la pestaña **Dongles**.
3. Crea un repositorio en la pestaña **Almacén** y añade alguna ROM.
4. **Enciende el dongle** pulsando su botón.
5. **Pon la GBA en modo Multiboot** (lee la sección de abajo, es crítico).
6. Deja el dongle en **Multiboot**: detectará la GBA y enviará el menú automáticamente. Cada pulsación corta avanza en el ciclo **Multiboot → GBA → Online → Multiboot**.
7. ¡A jugar!

## 1. Login en la web

Abre **Mi panel** y pulsa **Entrar con Google**. Solo necesitamos tu nombre, correo y foto de perfil para identificarte.

## 2. Vincular el dongle

En la pestaña **Dongles** del panel introduce:

- El **número de serie** del dispositivo, con formato `CFX-XXXXXX`
- Un nombre para reconocerlo
- Una nota opcional (color, dueño, etc.)

Para conectar con los servicios online, configura una red Wi-Fi de **2,4 GHz** desde el [menú de GBA](doc:gba-menu).

## 3. Crear un repositorio

Un *repositorio* es tu almacén de ROMs. Puedes:

- **Crearlo desde cero** y añadir ROMs por URL
- **Importar una carpeta de Google Drive** que ya tengas con tus juegos
- **Suscribirte a un repositorio compartido** mediante un token de 12 caracteres

## 4. Encender el dongle

> Antes de encender, lee la sección de [**Batería**](doc:battery) para asegurarte de que tienes el formato correcto (16340 o 18350).

El dongle **no tiene interruptor**: se enciende **pulsando una vez su botón**. La pantalla OLED se ilumina y entra en **modo Multiboot**, con Wi-Fi encendido. Más adelante explicamos cómo se apaga.

Conecta también el cable Link del dongle al puerto Link de la GBA.

![Plano técnico del dongle CanoFlash con el botón de encendido y el conector del cable Link señalados](/docs/img/dongle-overview.webp?v=b9e7b268d710)

## 5. ⚠️ Cómo entrar en el modo Multiboot de la GBA

> Este es **el paso más importante**. Léelo con calma una vez y verás que es muy sencillo.

Para que la GBA pueda recibir el menú CanoFlash, tiene que arrancar en su **modo Multiboot oficial de Nintendo**. El procedimiento son solo dos pasos:

1. **Enciende la GBA** con el cable Link del dongle ya conectado.
2. **Mantén pulsados Select + Start** hasta que en la pantalla aparezca el **logo de Game Boy fijo**, sin moverse ni desaparecer. Cuando lo veas estable, suéltalos.

A partir de ahí la GBA está esperando a que alguien le envíe algo por el cable Link. Con el dongle en **Multiboot**, la detección y el envío del menú CanoFlash son automáticos. Si muestra otro modo, pulsa el botón hasta que aparezca **CanoFlash Multiboot**.

![GBA conectada al dongle CanoFlash mostrando el logo de Game Boy fijo, lista para recibir el Multiboot](/docs/img/gba-multiboot-ready.webp)

> Si sueltas Select + Start demasiado pronto, la GBA arrancará el cartucho que tenga puesto (o la pantalla de "Game Pak Error" si no hay ninguno). Si te ha pasado, simplemente apaga la GBA y vuelve a intentarlo.

Esto funciona así porque el modo Multiboot está integrado en la BIOS de la propia consola. CanoFlash usa ese mecanismo oficial para meter su menú en los 256 KB de RAM de la GBA sin necesidad de cartucho dedicado.

## Los tres modos del dongle

Cada **pulsación corta** avanza en el ciclo **Multiboot → GBA → Online → Multiboot**.
El Wi-Fi permanece encendido en los tres modos. Cambiar de modo no desconecta la red.

### 1. Multiboot

Es el modo inicial tras encender el dispositivo. Espera una GBA preparada para
recibir el menú y lo envía automáticamente. Al terminar pasa a GBA; una pulsación
corta durante la espera también permite pasar directamente a GBA. Si detecta un
juego del SDK ya arrancado, cambia directamente a Online, incluso durante los
reintentos de Multiboot.

### 2. GBA

Atiende los comandos del menú. Al arrancar un cartucho, el Link queda libre hasta
que el juego solicite una conexión con el SDK. Al detectarlo o abrir una sesión,
pasa automáticamente a Online. También puedes pasar a Online con el botón.

### 3. Online

Espera la conexión de un juego del SDK o atiende su sesión. Puedes seleccionarlo
con el botón antes de pulsar Conectar en el juego. La pantalla muestra
**CanoFlash Online** mientras espera y **Partida en red** al abrir la sesión.

Cerrar la sesión desde el juego mantiene el dongle en Online, listo para volver
a conectar. Pulsar el botón en Online cierra la sesión y vuelve a Multiboot.

## Cómo apagar el dongle

El dongle **no tiene interruptor**. Hay tres formas de apagarlo:

- **Pulsación larga del botón** durante 3 segundos o más.
- **Apagado automático**: tras 30 segundos sin actividad de la GBA o del botón, entra en *deep sleep*. Una sesión del SDK con comunicación activa evita este apagado. Si el enlace desaparece durante 60 segundos, la sesión se cierra y comienza una nueva espera de 30 segundos.
- **Desde el menú principal de la GBA**: la opción **Apagar** del menú principal de CanoFlash pide confirmación antes de enviar la orden al dongle.

Al apagarse también se apaga la radio Wi-Fi. Para volver a encenderlo, pulsa el botón. El modo técnico de recuperación, accesible al mantener el botón durante el arranque, conserva su funcionamiento aislado sin Wi-Fi.
