> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kode.diy/llms.txt
> Use this file to discover all available pages before exploring further.

# Inicio rápido

> Guía rápida para comprender el Kode Dot y empezar con las aplicaciones.

# Qué es el Kode Dot

El Kode Dot es el **mejor dispositivo maker del mercado.** Se trata de un dispositivo **todo en uno, de tamaño de bolsillo y con capacidad de IA,** que te permite aprender a programar electrónica y sistemas embebidos mientras **construyes y haces realidad tus ideas.**

Integra el **hardware más avanzado y lo combina con kodeOS**, nuestro sistema operativo de código abierto, que te permite **guardar tu código en aplicaciones y compartirlas con la comunidad.**

Las principales características técnicas del Kode Dot son:

| Característica   | Descripción                                                  |
| ---------------- | ------------------------------------------------------------ |
| Microcontrolador | **ESP32-S3** - 32MB de flash y 8 MB de PSRAM                 |
| Pantalla         | AMOLED 2.13"                                                 |
| Led              | RGB Direccionable                                            |
| Botones          | Pad de 4 botones + 2 botones                                 |
| Audio            | **Micrófono y altavoz**                                      |
| Almacenamiento   | microSD                                                      |
| IMU              | **IMU** de 6 ejes + **magnetómetro** de 3 ejes               |
| Conectividad     | WiFi - Bluetooth - ESP-NOW - **2.4GHz**                      |
| Conectores       | **USB-C** - **Superior de 20 pines** - **Trasero magnético** |

<Frame caption="Parte frontal y trasera del Kode Dot">
  <img width="600" src="https://mintcdn.com/kodediy/XTX2YJaXd-8SFLrS/images/kode-dot/quickstart/kode-dot-render.png?fit=max&auto=format&n=XTX2YJaXd-8SFLrS&q=85&s=c8d5b77aa0411254b42ecc1c8e2bcf0c" data-path="images/kode-dot/quickstart/kode-dot-render.png" />
</Frame>

## Qué hay en la caja

Cuando compres el Kode Dot, en la caja te llegarán:

* 1x **Kode Dot**
* 1x **cable de carga y programación**
* 3x **pegatinas**
* 1x **manual de inicio rápido**

<Frame caption="Kode Dot y extras">
  <img width="600" src="https://mintcdn.com/kodediy/XTX2YJaXd-8SFLrS/images/kode-dot/quickstart/inside-box.png?fit=max&auto=format&n=XTX2YJaXd-8SFLrS&q=85&s=c9e69cfe2b99ce095ecec7bf7e808cce" data-path="images/kode-dot/quickstart/inside-box.png" />
</Frame>

## Cómo encender el Kode Dot

Nada más sacar el Kode Dot de la caja, **pulsa el botón de abajo a la derecha durante 2 segundos para encenderlo.**

No tienes que preocuparte de apagarlo ya que **automáticamente** detectará cuando no lo estás usando y entrará en **modo suspensión.**

<Tip>Si no vas a usar tu Kode Dot durante un **largo peridodo de tiempo**, puedes pulsar el botón de abajo a la derecha durante **5 segundos** para apagarlo por completo.</Tip>

## Lanza tu primera aplicación

Prueba a lanzar tu primera aplicación siguiendo estos pasos:

<Steps>
  <Step title="Entra al menú de aplicaciones">
    Desliza el dedo **hacia la izquierda** para entrar en el **menú de aplicaciones.** Aquí, aparecerán todas las categorías en las que se agrupan las aplicaciones. Desliza hacia abajo y selecciona el apartado de **"Games"**.
  </Step>

  <Step title="Lanza la aplicación">
    Aqui te aparecerán todas las aplicaciones que hay en el apartado de "Games". Selecciona la **aplicación "Snake"** para lanzarla.
  </Step>

  <Step title="Información de la aplicación">
    En esta pantalla verás el **título de la aplicación y una pequeña descripción.** Confirma que quieres lanzar la aplicación **pulsando "YES".**
  </Step>

  <Step title="Disfruta del juego">
    Tu **Kode Dot se reiniciará** y ya podrás **empezar a jugar al mítico Snake.**
  </Step>
</Steps>

<Tip>Para salir de la aplicación, pulsa el botón de abajo a la derecha a la vez que el pad izquierdo.</Tip>

## Crea tu primera aplicación

### Preparar Entorno

Subir tu código y convertirlo en una aplicación es muy sencillo, vamos a poner de ejemplo cómo se hace con Arduino IDE.

<Steps>
  <Step title="Instala Arduino IDE">
    Entra en el siguiente [enlace](https://www.arduino.cc/en/software/) y descarga e instala el IDE de Arduino.
  </Step>

  <Step title="Instala las placas de ESP32">
    Abre Arduino IDE y en el *Administrador de placas* busca e instala las placas de **ESP32**.

    <img src="https://mintcdn.com/kodediy/XTX2YJaXd-8SFLrS/images/kode-dot/quickstart/board-manager.png?fit=max&auto=format&n=XTX2YJaXd-8SFLrS&q=85&s=6d2b795bd3a81135aa0d420b4e6315ac" alt="Administrador de placas" width="1402" height="879" data-path="images/kode-dot/quickstart/board-manager.png" />
  </Step>

  <Step title="Selecciona el Kode Dot como placa">
    Selecciona el Kode Dot como placa en "Tools > Board > esp32 > Kode Dot".

    <img src="https://mintcdn.com/kodediy/XTX2YJaXd-8SFLrS/images/kode-dot/quickstart/kode-dot-board.png?fit=max&auto=format&n=XTX2YJaXd-8SFLrS&q=85&s=6bca2c57aa2b40cd6a3fc5fd22e613a9" alt="Selecciona Kode Dot" width="1920" height="1080" data-path="images/kode-dot/quickstart/kode-dot-board.png" />
  </Step>
</Steps>

### Sube tu código y crea la aplicación

<Steps>
  <Step title="Copia el siguiente código de ejemplo">
    Copia este código de ejemplo en el Arduino IDE. Este código imprime información del chip ESP32-S3 en el monitor serie cada 3 segundos.

    ```cpp esp32s3_info.ino lines icon="microchip" theme={null}
    void setup() {
      Serial.begin(115200); /* Inicia la comunicación serie a 115200 baudios */
    }

    void loop() {
      /* Imprime modelo y revisión del chip ESP32 */
      Serial.printf("ESP32 Chip model = %s Rev %d\n", ESP.getChipModel(), ESP.getChipRevision());

      /* Imprime la cantidad de núcleos del chip */
      Serial.printf("This chip has %d cores\n", ESP.getChipCores());

      /* Imprime el identificador único del chip */
      Serial.print("Chip ID: "); 
      Serial.println(ESP.getEfuseMac()); 

      /* Espera 3 segundos antes de repetir */
      delay(3000); 
    }
    ```
  </Step>

  <Step title="Conecta tu Kode Dot y sube el código">
    Desliza el **dedo hacia la derecha** en el Kode Dot para entrar en el **menú de subir código**. Al conectar tu Kode Dot al ordenador, en el Arduino IDE te saldrá en la **lista de dispositivos** y dándole al botón de **"Upload"** se subirá el código.
  </Step>

  <Step title="Crea la aplicación">
    Ahora en el **menú de subir código del Kode Dot**, te saldrá la opción de **ejecutar el código que acabas de subir o crear una aplicación.** Selecciona la opción de **"Create App"**. Por defecto, se guardará en la categoría de **"General"**.
  </Step>

  <Step title="Comprueba la aplicación">
    Ve al menú de aplicaciones, entra en la categoría de **"General"** y ya te **aparecerá tu aplicación recién creada** lista para ser lanzada.
  </Step>
</Steps>
