Installare Linux su ESP32‑S31: guida passo passo
Scopri come far girare un kernel Linux 6.18 su ESP32‑S31. Guida completa con passaggi, strumenti necessari e consigli per risolvere i problemi più comuni.

Cosa ti serve
- ESP32‑S31 (modello con MMU)
- Scheda di sviluppo con connettività Wi‑Fi 6
- Computer con Linux per compilare il kernel
- Toolchain RISC‑V (gcc, binutils, make)
- USB‑to‑UART per il debug
- Connessione a Internet per scaricare i pacchetti
- Tempo: 4–6 ore per l’intero processo
Passi
- Clona il repository ufficiale di Espressif: git clone https://github.com/espressif/esp32s31-linux e spostati nella cartella.
- Installa il toolchain RISC‑V e le dipendenze: sudo apt-get install git make gcc-riscv64-unknown-elf (o equivalente).
- Compila il kernel Linux 6.18 con la configurazione predefinita: make menuconfig, scegli “ESP32‑S31” come target, salva e make per generare vmlinux.
- Costruisci l’immagine di boot con U‑Boot: make uboot, poi crea il file esp32s31.img con il kernel e l’immagine di U‑Boot.
- Carica l’immagine sul dispositivo: collega l’ESP32‑S31 al PC via USB‑to‑UART, avvia il bootloader con esptool.py --chip esp32s31 write_flash 0x1000 esp32s31.img.
- Riavvia il chip e accedi tramite SSH: ssh root@esp32s31.local (la password predefinita è “root”).
Se qualcosa non va
- Il boot fallisce: verifica che l’indirizzo di flash sia corretto (0x1000) e che l’immagine sia stata scritta senza errori.
- Il kernel non si avvia: controlla che la configurazione CONFIG_RISCV_MMU=y sia abilitata.
- Connessione SSH non funziona: assicurati che il Wi‑Fi sia configurato correttamente nel file network.conf e che il dispositivo sia nella stessa rete.
- La memoria è insufficiente: il kernel può terminare con “OOM”; prova a ridurre i moduli caricati.
Per approfondire i componenti hardware e le opzioni di configurazione, visita la nostra sezione informatica.
Domande frequenti
Quanto tempo ci vuole?
Il processo completo, dalla clonazione del repo alla configurazione di rete, richiede circa 4–6 ore, a seconda della velocità del computer.
Serve un tecnico?
No, con le istruzioni passo‑passo è possibile completare l’installazione da solo, purché si abbia familiarità con la linea di comando.
Funziona su altri sistemi operativi?
Il toolchain è disponibile per Linux; per macOS è necessario installare Homebrew e i pacchetti corrispondenti. Su Windows è più complesso e non è consigliato.
Quali sono i limiti rispetto a un Raspberry Pi?
La memoria RAM è di soli 512 MB, non c’è GPU e molte interfacce sono ancora sperimentali, quindi non è adatto per desktop o applicazioni grafiche intensive.
