Come configurare un SSD NVMe con Raspberry Pi M.2 HAT+

Prerequisiti & Hardware Necessario

• Hardware: Raspberry Pi 5, alimentatore USB-C PD da 27 W, Raspberry Pi M.2 HAT+ o Raspberry Pi M.2 HAT+ Compact, SSD NVMe M.2 con connettore M key e formato compatibile, cavo FPC e distanziali inclusi nel kit. Per la scheda: Raspberry Pi 5 4GB con alimentatore ufficiale.
• Compatibilità fisica: M.2 HAT+ standard supporta SSD M key nei formati 2230 e 2242; M.2 HAT+ Compact supporta il formato 2230. Un SSD M.2 SATA o un SSD M key 2280 non diventano compatibili con un adattatore che non li supporta.
• Software: Raspberry Pi OS 64-bit o Home Assistant OS compatibile con il metodo di installazione scelto, Raspberry Pi Imager e firmware Raspberry Pi aggiornato. Il Raspberry Pi è il computer, HAT e SSD sono hardware, Raspberry Pi Imager è il software di scrittura.
• Precauzioni: spegni completamente e scollega il Raspberry Pi prima del montaggio. Non inserire o rimuovere il cavo FPC sotto tensione e non forzare il connettore M.2.

Procedura passo-passo

1. Aggiorna Raspberry Pi OS e firmware. Avvia temporaneamente il Pi da microSD e completa:

   sudo apt update
   sudo apt full-upgrade -y
   rpi-eeprom-update

   Se il firmware non è aggiornato, esegui sudo rpi-eeprom-update -a e riavvia con sudo reboot. Non interrompere l’alimentazione durante l’aggiornamento EEPROM.

2. Prepara il montaggio. Spegni il sistema con sudo poweroff, scollega l’alimentatore e attendi che i LED siano spenti. Installa i distanziali, il GPIO stacking header previsto dal modello HAT+ e il dissipatore attivo prima di fissare la scheda.
3. Collega il cavo PCIe FPC. Solleva i fermi del connettore sul Raspberry Pi 5 e sull’HAT. Inserisci il cavo fino in battuta, con i contatti orientati come indicato dalla documentazione della scheda; richiudi entrambi i fermi senza piegare o torcere il cavo.
4. Installa l’SSD NVMe. Inserisci il modulo nel connettore M.2 con un’inclinazione leggera, poi abbassalo e fissalo con la vite in dotazione. Non stringere eccessivamente e non applicare forza laterale al PCB.
5. Avvia e verifica il rilevamento PCIe. Riaccendi il Raspberry Pi e controlla:

   lsblk -o NAME,SIZE,MODEL,TRAN,FSTYPE,MOUNTPOINTS
   sudo dmesg | grep -iE 'nvme|pcie'

   Il disco deve comparire come dispositivo /dev/nvme0n1 o con una denominazione equivalente. Non usare nomi dedotti: identifica sempre il disco con lsblk prima di scriverlo.

6. Scrivi il sistema operativo sull’NVMe. Da un altro computer apri Raspberry Pi Imager, seleziona il modello Raspberry Pi 5, il sistema operativo e l’SSD NVMe come destinazione. La scrittura cancella il disco selezionato: controlla due volte il nome dell’unità prima di confermare.
7. Configura l’ordine di avvio. Se il Raspberry Pi continua ad avviare la microSD, avvia da essa e apri:

   sudo raspi-config

   Seleziona Advanced Options → Boot Order → NVMe/USB boot, esci con Finish e riavvia. Se non inserisci una microSD, un Pi 5 aggiornato può avviarsi direttamente dall’NVMe collegato all’HAT+.

8. Controlla il sistema avviato.

   findmnt /
   lsblk -o NAME,SIZE,FSTYPE,MOUNTPOINTS
   cat /sys/block/nvme0n1/device/model

   La riga di findmnt / deve riferirsi alla partizione root sull’NVMe. Se hai mantenuto la microSD inserita, verifica che non sia ancora lei a fornire il filesystem principale.

9. Testa il riavvio e il raffreddamento. Esegui sudo reboot e controlla che il Pi torni online senza microSD. Verifica anche la temperatura con vcgencmd measure_temp; l’NVMe usa il bus PCIe 2.0 a singola corsia, con picco teorico di circa 500 MB/s, e PCIe Gen 3 non è certificato per Raspberry Pi 5.
10. Conserva una copia di ripristino. Mantieni una microSD con un sistema di soccorso e un backup dei dati applicativi. Un SSD NVMe non sostituisce il backup: la velocità e l’affidabilità del supporto non impediscono cancellazioni o guasti.

Verifica del funzionamento

La configurazione è corretta quando il comando lsblk mostra l’SSD, il kernel registra il dispositivo NVMe senza errori PCIe, findmnt / indica la partizione root sull’NVMe e il Raspberry Pi 5 si riavvia senza microSD. Controlla inoltre che il cavo FPC sia completamente inserito, che i LED di alimentazione/attività dell’HAT si comportino normalmente e che non compaiano errori di I/O con sudo journalctl -k -b | grep -iE 'nvme|pcie|error'.

Problemi comuni

Problema	Causa	Soluzione
L’SSD non compare in lsblk	Cavo FPC inserito male, SSD incompatibile o HAT non alimentato	Spegni tutto, ricontrolla orientamento e inserimento del cavo, formato M.2 e compatibilità M key.
Il Pi avvia ancora dalla microSD	Ordine EEPROM non impostato su NVMe o microSD prioritaria	Usa raspi-config per impostare NVMe/USB boot e verifica il dispositivo root con findmnt /.
Errore di I/O durante l’avvio	Alimentazione insufficiente, cavo FPC danneggiato o SSD instabile	Usa alimentatore USB-C PD da 27 W, sostituisci il cavo se necessario e prova l’SSD con firmware aggiornato.
SSD M.2 2280 non entra	Il Raspberry Pi M.2 HAT+ standard non supporta il formato 2280	Usa un SSD 2230/2242 compatibile oppure un HAT specifico per 2280, verificandone pinout e alimentazione.
Il sistema è instabile con PCIe Gen 3	Gen 3 non certificato su Raspberry Pi 5	Resta alla modalità PCIe Gen 2 predefinita; non modificare il parametro Gen 3 per inseguire prestazioni non garantite.

FAQ essenziali

Posso usare lo stesso HAT NVMe su Raspberry Pi 4?

Il Raspberry Pi M.2 HAT+ ufficiale è progettato per l’interfaccia PCIe del Raspberry Pi 5. Non collegarlo a un Pi 4 senza una scheda e un cablaggio espressamente compatibili con quel modello.

Devo formattare manualmente l’SSD prima di usare Raspberry Pi Imager?

No. Raspberry Pi Imager prepara il supporto e sovrascrive il disco selezionato. La formattazione manuale è necessaria solo per scenari diversi, come usare l’NVMe esclusivamente come disco dati.