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

# Inicio rápido

> Cómo funciona PrimaSTEM — robot, mando, fichas. Inicio rápido.

PrimaSTEM es un kit educativo sin pantalla para aprender programación, lógica y matemáticas, para niños de 4 a 10+ años. Esta página explica brevemente **cómo funciona el dispositivo**.

<Note>
  **¿Aún no tienes el dispositivo? Pruébalo en tu navegador.** Abre el **[simulador web](https://simulator.primastem.com)** — una copia funcional del mando y el robot. Coloca fichas, pulsa **▶ Start** y observa cómo se ejecuta el robot mientras lees esta guía.
</Note>

## 1. Qué hay en la caja

<CardGroup cols={3}>
  <Card title="Robot" icon="bug">
    Robot-mariquita de madera sobre dos ruedas. Encima, una ranura para el rotulador. Altavoz, USB-C, Bluetooth.
  </Card>

  <Card title="Mando" icon="grid-3x3">
    Panel con ranuras emparejadas para el programa. Indicadores multicolor, botón ▶ Inicio/Parada, altavoz, USB-C, Bluetooth.
  </Card>

  <Card title="Fichas de código" icon="square-stack">
    Cuadrados de cartón con etiquetas NFC — cada una = un comando para el programa del robot.
  </Card>
</CardGroup>

## 2. Encendido

<Steps>
  <Step title="Enciende el robot, luego el mando" icon="power">
    Cada uno emite un sonido breve; el indicador verde de encendido en cada dispositivo = encendido.
  </Step>

  <Step title="Conectado = blanco" icon="check">
    Las ranuras disponibles del mando se iluminan en **blanco**, los ojos del robot parpadean en **blanco**. Listo.
  </Step>

  <Step title="Ambos en azul = hace falta emparejar" icon="bluetooth">
    Mantén pulsado **▶ Inicio** en el mando durante **más de 10 segundos** — los dispositivos se emparejan y el robot se reinicia.
  </Step>
</Steps>

**Pruébalo ya:** coloca una ficha **Adelante** en la primera ranura (cualquier celda de la pareja). Pulsa **▶ Inicio**. El robot avanza 15 cm y se detiene. *Ya es un programa — un solo comando.*

## 3. Cómo funciona un programa

El mando tiene **dos filas de ranuras emparejadas**. Colocas las fichas en las ranuras que se iluminan en blanco — eso es el programa. Pulsas **▶ Inicio** — el robot lo ejecuta.

<Frame caption="Diagrama del mando — las letras A–F se explican abajo">
  <img src="https://mintcdn.com/primastem/175QKR4CUet4QChM/images/book-1/control.excalidraw.svg?fit=max&auto=format&n=175QKR4CUet4QChM&q=85&s=5dba398e3c90a484ce94e70d4a23c3f8" alt="Mando con etiquetas A a F" width="731" height="398" data-path="images/book-1/control.excalidraw.svg" />
</Frame>

| Letra | Qué es                                                                            |
| :---: | --------------------------------------------------------------------------------- |
| **A** | **Programa principal** — 6 ranuras emparejadas, se ejecuta de izquierda a derecha |
| **B** | **▶ Inicio / Parada** — arranca; pulsar de nuevo durante el movimiento = parar    |
| **C** | **Función** — 5 ranuras emparejadas, se llama con la ficha «Función»              |
| **D** | Una **celda** del par                                                             |
| **E** | **Línea de ejecución** que conecta las celdas en pareja                           |
| **F** | **LED multicolor** en cada celda                                                  |

**Pareja = dos celdas lógicamente vinculadas.** El orden arriba/abajo no importa — el comando se puede colocar en cualquiera de las dos celdas, la repetición/número/aritmética en la otra. Si la segunda celda está vacía, se usan los valores por defecto: paso 15 cm y giro 90° — suficiente para los más pequeños.

Colores LED durante la ejecución:

|        ⚪ Blanco       |    🟢 Verde    |                   🔵 Azul                  |      🔴 Rojo     |
| :-------------------: | :------------: | :----------------------------------------: | :--------------: |
| Espera (ranura libre) | Comando puesto | Comando + número / repetición / aritmética | Error — se omite |

Las ranuras vacías y las parejas rojas se omiten. Los LED parpadean en la celda que se ejecuta en ese instante.

## 4. Fichas — por grupos

| Grupo          | Qué hacen las fichas                                                                                                                                          |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Movimiento** | Adelante · Atrás · Izquierda · Derecha                                                                                                                        |
| **Repetición** | Dos flechas en círculo + dentro puntos 2–6 (como un dado, para los pequeños) o con cifras. En pareja con un comando — lo repite.                              |
| **Números**    | `1`–`999`. Definen la distancia de movimiento en mm o el ángulo de giro en grados.                                                                            |
| **Aritmética** | `+N` `−N` `×N` `÷N` `√` `^N` — una ficha = operación + número. Modifica el valor guardado de movimiento o giro. ¡Un resultado negativo invierte la dirección! |
| **Función**    | Llama a la fila inferior como subprograma. Con ficha de repetición — se ejecuta el número indicado de veces.                                                  |
| **Paso**       | Ficha de servicio + Número = cambia el paso por defecto (por ejemplo número 100, en milímetros, para una cuadrícula de 10 cm). Se conserva al apagar.         |

## 5. Valores por defecto y valor guardado

<Note>
  **Adelante = 150 mm (15 cm), giro = 90°.** La ficha **«Paso»** cambia la distancia «por defecto» y se conserva al apagar. Útil para tableros de cualquier robot.

  Durante una sesión, cada comando de movimiento guarda **su propio** valor:

  * **un número** en la pareja con el comando → reemplaza el último valor guardado o el de por defecto
  * **una ficha aritmética** → lo modifica (`+`, `−`, `×`, `÷`, `√`, `^`)
  * **vacío** en la pareja → toma el último valor guardado o el de por defecto

  Los valores guardados se reinician al apagar el mando; el valor por defecto (paso) se mantiene.

  **Referencia rápida:**

  * `Adelante` solo        → 150 mm (15 cm) — por defecto
  * `Adelante` + `100`     → 100 mm — reemplaza
  * `Adelante` + `+50`     → 150 mm  (anterior 100 + 50) — modifica
  * `Izquierda` sola       → 90° — por defecto
  * `Izquierda` + `45`     → 45° — reemplaza
  * `Izquierda` + `−10`    → 35°  (anterior 45° − 10°) — modifica
</Note>

## 6. El robot dibuja lo que tú programas

Prueba estos ejemplos — verás de qué es capaz el dispositivo. Pon un rotulador en el centro del robot — **dibuja** mientras se mueve.

<CardGroup cols={2}>
  <Card title="Estrella — números + repetición">
    <Frame>
      <img src="https://mintcdn.com/primastem/175QKR4CUet4QChM/images/mathdrawings/star5.excalidraw.svg?fit=max&auto=format&n=175QKR4CUet4QChM&q=85&s=c1e74f5c6e250052fb044893df6badd8" alt="Programa de la estrella en el mando" width="578" height="398" data-path="images/mathdrawings/star5.excalidraw.svg" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/primastem/175QKR4CUet4QChM/images/mathdrawings/star5draw.excalidraw.svg?fit=max&auto=format&n=175QKR4CUet4QChM&q=85&s=ebf9e3259c9ff5cb9ba29dfab838cdab" alt="Estrella dibujada por el robot" width="394" height="389" data-path="images/mathdrawings/star5draw.excalidraw.svg" />
    </Frame>
  </Card>

  <Card title="Espiral — aritmética en bucle">
    <Frame>
      <img src="https://mintcdn.com/primastem/175QKR4CUet4QChM/images/mathdrawings/spiral.excalidraw.svg?fit=max&auto=format&n=175QKR4CUet4QChM&q=85&s=1722131b74e8beb966a89fefbbf80fd9" alt="Programa de la espiral en el mando" width="578" height="398" data-path="images/mathdrawings/spiral.excalidraw.svg" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/primastem/175QKR4CUet4QChM/images/mathdrawings/spiraldraw.excalidraw.svg?fit=max&auto=format&n=175QKR4CUet4QChM&q=85&s=cdd3a0c0ed5106c3f83ec98039a5267c" alt="Espiral dibujada por el robot" width="422" height="401" data-path="images/mathdrawings/spiraldraw.excalidraw.svg" />
    </Frame>
  </Card>
</CardGroup>

Más ejemplos en [Dibujos matemáticos](mathdrawings).

## 7. Cómo enseñar con PrimaSTEM

<Tip>
  **Introduce las fichas-comandos una a una, en este orden:**

  **Adelante → Giros → Repeticiones → Función → Números → Aritmética.**

  Cada siguiente — solo después de dominar la anterior. El plan completo de 12 sesiones con edad, duración y material para los más pequeños — en [Libro 1](book-1/book-1).

  **Trabajo en grupo:** recomendamos un kit por cada **2–3 niños**.

  **Tableros:** sirve cualquier cuadrícula hecha para otros robots educativos. El tamaño de la celda se establece con la ficha **«Paso»** y un número (por ejemplo 100, 120, 150, 200 mm).

  **Truco para 10 pasos en lugar de 6.** Coloca la ficha **Función \[ ]** en la última (6ª) ranura de la fila superior y fíjala con cinta de pintor. El programa funciona ahora como una larga cadena: 5 pasos arriba + 5 abajo = **10 pasos seguidos**. Útil para los pequeños que necesitan un programa más largo, pero a los que aún es pronto introducir la función como concepto.
</Tip>

## 8. Funciones adicionales

<CardGroup cols={2}>
  <Card title="Rotulador y dibujo" icon="pen-line">
    Inserta un rotulador en el robot — **dibuja** su recorrido en papel: desde una trayectoria simple hasta polígonos, estrellas, espirales y fractales.
  </Card>

  <Card title="Voz" icon="volume-2">
    El mando dice cada ficha — voz **en cualquier idioma local**, actualmente **17 admitidos**, ¡añadimos cualquier otro a petición! Ayuda a los pequeños y a los que aún no leen. Incluye letras del alfabeto y lugares (Casa, Escuela, Tienda, Bosque, etc.)
  </Card>

  <Card title="Pegatinas y tableros NFC sonoros" icon="map">
    Pega etiquetas NFC en tu tablero, programa desde el móvil cualquier sonido disponible. El robot tiene una antena debajo — al parar sobre una etiqueta, reproduce el sonido grabado.
  </Card>

  <Card title="Plataforma NFC abierta" icon="nfc">
    Crea tus propias fichas — cualquier etiqueta NFC de 13.56 MHz (baratas, se venden en cualquier marketplace) + un código de texto de nuestra documentación — todo junto lleva 10 segundos. Aplicación gratuita para móvil (NFC Tools).
  </Card>
</CardGroup>

## Qué leer a continuación

<CardGroup cols={2}>
  <Card title="Manual de usuario" icon="book-open" href="usermanual">
    Especificaciones técnicas completas, emparejamiento, calibración, seguridad.
  </Card>

  <Card title="Guía del profesor" icon="book" href="teachersguide">
    Pedagogía, uso en clase, conceptos de programación a través del juego.
  </Card>

  <Card title="Libro 1 — Lecciones" icon="graduation-cap" href="book-1/book-1">
    12 sesiones listas para los más pequeños — con edad, duración y material imprimible.
  </Card>

  <Card title="Fichas de comando" icon="nfc" href="nfc">
    Todos los códigos NFC — para crear tus propias fichas con el móvil.
  </Card>

  <Card title="Dibujos matemáticos" icon="pen-line" href="mathdrawings">
    Figuras geométricas, fractales, espirales — programas y resultados.
  </Card>

  <Card title="Diccionario de audio" icon="volume-2" href="sounds_reference">
    Palabras — lugares y conceptos, alfabeto, notas musicales, sonidos del sistema. Para grabar tus propias fichas y reproducir.
  </Card>
</CardGroup>
