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

# Avvio rapido

> Come funziona PrimaSTEM — robot, pulsantiera, tessere. Avvio rapido.

PrimaSTEM è un kit educativo senza schermo per imparare programmazione, logica e matematica, per bambini dai 4 ai 10+ anni. Questa pagina spiega in breve **come funziona il dispositivo**.

<Note>
  **Non hai ancora il dispositivo? Provalo nel browser.** Apri il **[simulatore web](https://simulator.primastem.com)** — una copia funzionante della pulsantiera e del robot. Posiziona le tessere, premi **▶ Start** e guarda il robot in azione mentre leggi questa guida.
</Note>

## 1. Cosa c'è nella scatola

<CardGroup cols={3}>
  <Card title="Robot" icon="bug">
    Robot-coccinella di legno su due ruote. Sopra, un foro per il pennarello. Altoparlante, USB-C, Bluetooth.
  </Card>

  <Card title="Pulsantiera" icon="grid-3x3">
    Pannello con celle accoppiate per il programma. Indicatori multicolore, pulsante ▶ Start/Stop, altoparlante, USB-C, Bluetooth.
  </Card>

  <Card title="Tessere di codice" icon="square-stack">
    Quadrati di cartone con etichette NFC — ognuna = un comando del programma del robot.
  </Card>
</CardGroup>

## 2. Accensione

<Steps>
  <Step title="Accendi il robot, poi la pulsantiera" icon="power">
    Ognuno emette un breve suono; l'indicatore verde di accensione su ciascun dispositivo = acceso.
  </Step>

  <Step title="Connesso = bianco" icon="check">
    Le celle disponibili della pulsantiera si illuminano di **bianco**, gli occhi del robot lampeggiano di **bianco**. Pronto.
  </Step>

  <Step title="Entrambi blu = serve l'abbinamento" icon="bluetooth">
    Tieni premuto **▶ Start** sulla pulsantiera per **più di 10 secondi** — i dispositivi si abbinano e il robot si riavvia.
  </Step>
</Steps>

**Provalo subito:** metti una tessera **Avanti** nella prima cella (una qualsiasi della coppia). Premi **▶ Start**. Il robot avanza di 15 cm e si ferma. *È già un programma — un solo comando.*

## 3. Come funziona un programma

La pulsantiera ha **due righe di celle accoppiate**. Metti le tessere nelle celle che si accendono di bianco — questo è il programma. Premi **▶ Start** — il robot lo esegue.

<Frame caption="Schema della pulsantiera — le lettere A–F sono spiegate sotto">
  <img src="https://mintcdn.com/primastem/175QKR4CUet4QChM/images/book-1/control.excalidraw.svg?fit=max&auto=format&n=175QKR4CUet4QChM&q=85&s=5dba398e3c90a484ce94e70d4a23c3f8" alt="Pulsantiera con etichette da A a F" width="731" height="398" data-path="images/book-1/control.excalidraw.svg" />
</Frame>

| Lettera | Cos'è                                                                        |
| :-----: | ---------------------------------------------------------------------------- |
|  **A**  | **Programma principale** — 6 celle accoppiate, eseguite da sinistra a destra |
|  **B**  | **▶ Start / Stop** — avvia; premuto di nuovo durante il movimento = stop     |
|  **C**  | **Funzione** — 5 celle accoppiate, richiamate dalla tessera «Funzione»       |
|  **D**  | Una **cella** della coppia                                                   |
|  **E**  | **Linea di esecuzione** che collega le celle accoppiate                      |
|  **F**  | **LED multicolore** su ogni cella                                            |

**Coppia = due celle logicamente collegate.** L'ordine sopra/sotto non conta — il comando può andare in una qualsiasi delle due celle, la ripetizione/numero/aritmetica nell'altra. Se la seconda cella è vuota, si usano i valori predefiniti: passo 15 cm e rotazione 90° — sufficienti per i piccoli.

Colori dei LED durante l'esecuzione:

|        ⚪ Bianco       |     🟢 Verde     |                    🔵 Blu                   |     🔴 Rosso     |
| :-------------------: | :--------------: | :-----------------------------------------: | :--------------: |
| Attesa (cella libera) | Comando inserito | Comando + numero / ripetizione / aritmetica | Errore — saltato |

Le celle vuote e le coppie rosse vengono saltate. I LED lampeggiano sulla cella in esecuzione in quel momento.

## 4. Tessere — per gruppi

| Gruppo          | Cosa fanno le tessere                                                                                                                                              |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Movimento**   | Avanti · Indietro · Sinistra · Destra                                                                                                                              |
| **Ripetizione** | Due frecce in cerchio + dentro punti 2–6 (come un dado, per i piccoli) o con cifre. In coppia con un comando — lo ripete.                                          |
| **Numeri**      | `1`–`999`. Impostano la distanza di movimento in mm o l'angolo di rotazione in gradi.                                                                              |
| **Aritmetica**  | `+N` `−N` `×N` `÷N` `√` `^N` — una tessera = operazione + numero. Modifica il valore salvato di movimento o rotazione. Un risultato negativo inverte la direzione! |
| **Funzione**    | Richiama la riga in basso come sottoprogramma. Con tessera di ripetizione — viene eseguita il numero indicato di volte.                                            |
| **Passo**       | Tessera di servizio + Numero = cambia il passo predefinito (per esempio numero 100, in millimetri, per griglia da 10 cm). Si conserva allo spegnimento.            |

## 5. Valori predefiniti e valore salvato

<Note>
  **Avanti = 150 mm (15 cm), rotazione = 90°.** La tessera **«Passo»** cambia la distanza «predefinita» e la conserva dopo lo spegnimento. Comodo per i tabelloni di gioco di altri robot.

  Durante una sessione, ogni comando di movimento conserva il **proprio** valore salvato:

  * **un numero** nella coppia con il comando → sostituisce l'ultimo valore salvato o quello predefinito
  * **una tessera aritmetica** → lo modifica (`+`, `−`, `×`, `÷`, `√`, `^`)
  * **vuoto** nella coppia → prende l'ultimo valore salvato o quello predefinito

  I valori salvati si azzerano allo spegnimento della pulsantiera; il valore predefinito (passo) resta.

  **Riferimento rapido:**

  * `Avanti` da solo       → 150 mm (15 cm) — predefinito
  * `Avanti` + `100`       → 100 mm — sostituisce
  * `Avanti` + `+50`       → 150 mm  (precedente 100 + 50) — modifica
  * `Sinistra` da sola     → 90° — predefinito
  * `Sinistra` + `45`      → 45° — sostituisce
  * `Sinistra` + `−10`     → 35°  (precedente 45° − 10°) — modifica
</Note>

## 6. Il robot disegna ciò che programmi

Prova questi esempi — vedrai di cosa è capace il dispositivo. Inserisci un pennarello al centro del robot — **disegna** mentre si muove.

<CardGroup cols={2}>
  <Card title="Stella — numeri + ripetizione">
    <Frame>
      <img src="https://mintcdn.com/primastem/175QKR4CUet4QChM/images/mathdrawings/star5.excalidraw.svg?fit=max&auto=format&n=175QKR4CUet4QChM&q=85&s=c1e74f5c6e250052fb044893df6badd8" alt="Programma della stella sulla pulsantiera" 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="Stella disegnata dal robot" width="394" height="389" data-path="images/mathdrawings/star5draw.excalidraw.svg" />
    </Frame>
  </Card>

  <Card title="Spirale — aritmetica in un ciclo">
    <Frame>
      <img src="https://mintcdn.com/primastem/175QKR4CUet4QChM/images/mathdrawings/spiral.excalidraw.svg?fit=max&auto=format&n=175QKR4CUet4QChM&q=85&s=1722131b74e8beb966a89fefbbf80fd9" alt="Programma della spirale sulla pulsantiera" 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="Spirale disegnata dal robot" width="422" height="401" data-path="images/mathdrawings/spiraldraw.excalidraw.svg" />
    </Frame>
  </Card>
</CardGroup>

Altri esempi nella sezione [Disegni matematici](mathdrawings).

## 7. Come insegnare con PrimaSTEM

<Tip>
  **Introduci le tessere-comandi una alla volta, in questo ordine:**

  **Avanti → Rotazioni → Ripetizioni → Funzione → Numeri → Aritmetica.**

  Ciascuna successiva — solo dopo aver padroneggiato la precedente. Il piano completo di 12 lezioni con età, durata e materiali per i piccoli — nel [Libro 1](book-1/book-1).

  **Lavoro di gruppo:** consigliamo un kit ogni **2–3 bambini**.

  **Tabelloni:** va bene qualsiasi griglia fatta per altri robot educativi. La dimensione della cella si imposta con la tessera **«Passo»** e un numero (per esempio 100, 120, 150, 200 mm).

  **Trucco per 10 passi invece di 6.** Metti la tessera **Funzione \[ ]** nell'ultima (6ª) cella della riga superiore e fissala con nastro carta. Il programma scorre ora come una lunga catena: 5 passi sopra + 5 sotto = **10 passi di fila**. Comodo per i piccoli che hanno bisogno di un programma più lungo, ma per i quali è ancora presto introdurre la funzione come concetto.
</Tip>

## 8. Funzionalità aggiuntive

<CardGroup cols={2}>
  <Card title="Pennarello e disegno" icon="pen-line">
    Inserisci un pennarello nel robot — **disegna** il suo percorso sulla carta: da una traiettoria semplice fino a poligoni, stelle, spirali e frattali.
  </Card>

  <Card title="Voce" icon="volume-2">
    La pulsantiera pronuncia ogni tessera — voce **in qualsiasi lingua locale**, attualmente **17 supportate**, ne aggiungiamo altre su richiesta! Aiuta i piccoli e chi non legge ancora. Include lettere dell'alfabeto e luoghi (Casa, Scuola, Negozio, Bosco, ecc.)
  </Card>

  <Card title="Etichette NFC sonore e tabelloni" icon="map">
    Incolla le etichette NFC sul tuo tabellone, programma dal telefono qualsiasi suono disponibile. Il robot ha un'antenna sotto — fermandosi su un'etichetta riproduce il suono registrato.
  </Card>

  <Card title="Piattaforma NFC aperta" icon="nfc">
    Crea le tue tessere — qualsiasi etichetta NFC 13.56 MHz (economiche, in vendita su tutti i marketplace) + un codice di testo dalla nostra documentazione — in tutto ci vogliono 10 secondi. App gratuita per telefono (NFC Tools).
  </Card>
</CardGroup>

## Cosa leggere dopo

<CardGroup cols={2}>
  <Card title="Manuale d'uso" icon="book-open" href="usermanual">
    Specifiche tecniche complete, abbinamento, calibrazione, sicurezza.
  </Card>

  <Card title="Guida per l'insegnante" icon="book" href="teachersguide">
    Pedagogia, uso in classe, concetti di programmazione attraverso il gioco.
  </Card>

  <Card title="Libro 1 — Lezioni" icon="graduation-cap" href="book-1/book-1">
    12 lezioni pronte per i piccoli — con età, durata e materiali stampabili.
  </Card>

  <Card title="Tessere-comando" icon="nfc" href="nfc">
    Tutti i codici NFC — per creare le proprie tessere con il telefono.
  </Card>

  <Card title="Disegni matematici" icon="pen-line" href="mathdrawings">
    Figure geometriche, frattali, spirali — programmi e risultati.
  </Card>

  <Card title="Dizionario audio" icon="volume-2" href="sounds_reference">
    Parole — luoghi e concetti, alfabeto, note musicali, suoni di sistema. Per registrare le proprie tessere e riprodurre.
  </Card>
</CardGroup>
