Nota

Benvenuto nella community Facebook SunFounder Raspberry Pi, Arduino ed ESP32!

Ottieni supporto tecnico e aiuto nella risoluzione dei problemi.
Impara e condividi progetti, suggerimenti e tutorial.
Accedi in anteprima a nuovi prodotti e aggiornamenti.
Goditi sconti esclusivi e omaggi.

👉 Unisciti a noi qui: [here]

FAQ

Risoluzione rapida dei problemi

Schermo OLED non funziona → Lo schermo OLED non funziona?
LED RGB non funzionano → I LED RGB non funzionano?
Ventole GPIO non funzionano → Le ventole GPIO non funzionano?
Ventola CPU non gira → La ventola CPU non gira?
Dashboard non mostra dati → La Dashboard non mostra dati
SSD NVMe non rilevato → Il modulo NVMe PIP non funziona?

1. Hardware

Sistemi compatibili

Sistemi testati su Raspberry Pi 5:

Pulsante di accensione

Il pulsante di accensione estende il pulsante originale del Raspberry Pi 5 e si comporta in modo simile.

Pressione breve: Accensione / riattivazione OLED / cambio pagina OLED.
Tieni premuto 2 secondi: Arresto sicuro (richiede 1. Configurazione dell’arresto per disattivare l’alimentazione GPIO).
Tieni premuto 5 secondi: Arresto forzato.

Estremità dei tubi di rame sul dissipatore a torre

Le estremità appiattite dei tubi di calore in rame a forma di U fanno parte del normale processo di produzione e sono progettate per permettere ai tubi di calore di passare attraverso le alette in alluminio.

Raspberry Pi AI HAT+

Il Raspberry Pi AI HAT+ non è compatibile con il Pironman 5.

Il kit Raspberry Pi AI combina il Raspberry Pi M.2 HAT+ e il modulo acceleratore AI Hailo.

Puoi staccare il modulo acceleratore AI Hailo dal kit Raspberry Pi AI e inserirlo direttamente nel modulo NVMe PIP del Pironman 5.

Posso usare la funzione di interruttore a vibrazione del Pironman5 Max?

Dalla v1.3.6, la riattivazione OLED usa il pulsante di accensione. Devi rimuovere il ponticello dell’interruttore a vibrazione per evitare di occupare i pin GPIO del Raspberry Pi e prevenire potenziali conflitti. Verifica se questo ponticello esiste; in caso contrario, ignora questo avviso.

2. Raffreddamento e ventole

La ventola CPU non gira?

La ventola CPU del Pironman 5 è controllata dal sistema Raspberry Pi. La velocità della ventola CPU dipende dalla temperatura della CPU del Raspberry Pi 5.

Curva predefinita della ventola CPU:

< 50°C: Spenta (0%)
50°C+: Velocità bassa (30%)
60°C+: Velocità media (50%)
67,5°C+: Velocità alta (70%)
75°C+: Velocità massima (100%)

Controlla la temperatura attuale della CPU (esempio di output: temp=48.7'C):

vcgencmd measure_temp

Puoi controllare manualmente la ventola CPU con i seguenti comandi:

pinctrl FAN_PWM op dl   # Attiva ventola (attivo basso)
pinctrl FAN_PWM op dh   # Disattiva ventola (attivo alto)
pinctrl FAN_PWM a0      # Modalità automatica

Puoi anche regolare le soglie di temperatura della ventola CPU modificando:

nano /boot/firmware/config.txt

Aggiungi:

dtparam=cooling_fan=on
dtparam=fan_temp0=40000
dtparam=fan_temp0_hyst=10000
dtparam=fan_temp0_speed=125

Questa configurazione avvia la ventola CPU a 40°C con livello di velocità PWM 125.

Dopo aver salvato il file, riavvia il Raspberry Pi per applicare le modifiche.

Le ventole GPIO non funzionano?

Per prima cosa, controlla se il ponticello FAN sulla scheda IO Expander è installato correttamente.

Quindi imposta le ventole GPIO in modalità Sempre attive e verifica se iniziano a girare.

sudo pironman5 -gm 0

Puoi anche collegare le ventole GPIO direttamente ai pin 5V e GND del Raspberry Pi per testarle.

Se le ventole girano normalmente quando collegate direttamente, il problema potrebbe essere legato alla scheda IO Expander. Contattaci per ulteriore assistenza.

Se il problema persiste, apri la pagina Log della Dashboard e verifica i messaggi di errore. Puoi anche inviarci il seguente file di log:

cat /var/log/pironman5/pironman5.log

3. OLED e RGB

Lo schermo OLED non funziona?

Se lo schermo OLED non visualizza nulla o mostra informazioni errate, segui questi passaggi di risoluzione:

Assicurati che il cavo FPC dello schermo OLED sia collegato saldamente. Si consiglia di ricollegare lo schermo OLED e poi accendere il dispositivo.
Verifica che il Raspberry Pi esegua un sistema operativo supportato.

Vedi Sistemi compatibili.
Al primo avvio, lo schermo OLED potrebbe mostrare solo blocchi di pixel. Segui le istruzioni in 4. Configurazione o Installazione del Software per completare la configurazione prima che possa visualizzare informazioni corrette.
Usa il seguente comando per verificare se l’indirizzo I2C 0x3C dell’OLED viene rilevato:
```
sudo i2cdetect -y 1
```
- Se l’indirizzo I2C 0x3C viene rilevato, riavvia il servizio Pironman 5:
```
sudo systemctl restart pironman5.service
```
- Se l’indirizzo non viene rilevato, abilita I2C:
```
sudo nano /boot/firmware/config.txt
```
  Aggiungi:
```
dtparam=i2c_arm=on
```
  Salva il file e riavvia il Raspberry Pi.
Se il problema persiste, inviaci il seguente file di log:
```
cat /var/log/pironman5/pironman5.log
```

I LED RGB non funzionano?

I due pin sull’IO Expander sopra J9 sono usati per collegare i LED RGB a GPIO10. Assicurati che il ponticello su questi due pin sia installato correttamente.
Verifica che il Raspberry Pi esegua un sistema operativo supportato.

Vedi Sistemi compatibili.
Esegui il seguente comando per abilitare SPI:
```
sudo raspi-config
```
Vai a:

3 Opzioni di interfaccia → I3 SPI → SÌ

Quindi riavvia il Raspberry Pi.
Se il problema persiste, inviaci il seguente file di log:
```
cat /var/log/pironman5/pironman5.log
```

Come personalizzare il display OLED?

Se vuoi personalizzare il display OLED, ad esempio aggiungendo visualizzazioni di immagini personalizzate a 2-4 cifre, puoi modificare i file delle pagine OLED in uno dei seguenti modi.

Metodo 1: Modificare direttamente i file installati
1. Elenca i file delle pagine OLED:
```
ls /opt/pironman5/venv/lib/python3.13/site-packages/pm_auto/addons/oled/pages/
```
2. Modifica i file Python desiderati.
3. Riavvia il servizio per applicare le modifiche:
```
sudo systemctl restart pironman5.service
```

Metodo 2: Clonare e reinstallare ``pm_auto``

Clona il repository pm_auto:

git clone -b 1.4.x https://github.com/sunfounder/pm_auto/

Dopo aver apportato le modifiche, reinstalla il pacchetto modificato:

sudo /opt/pironman5/venv/bin/pip3 uninstall pm_auto -y && \
sudo /opt/pironman5/venv/bin/pip3 install ~/pm_auto --no-build-isolation && \
sudo chown -R pironman5:pironman5 /opt/pironman5

Riavvia il servizio:

sudo systemctl restart pironman5.service

Test e debug

Per visualizzare i log di esecuzione:
```
journalctl -xefu pironman5.service
```
Puoi anche fermare il servizio ed eseguirlo manualmente per test più rapidi:
```
sudo systemctl stop pironman5.service
sudo systemctl restart pironman5.service
```

4. Dashboard e software

La Dashboard non mostra dati

Se la Dashboard non mostra dati, apri prima la pagina Log della Dashboard e verifica se ci sono messaggi di errore relativi a influxdb.

Gli errori comuni includono:

database not found
failed to connect to influxdb
connection refused
timeout

Puoi provare i seguenti passaggi per risolvere il problema.

Pulisci la cache del browser o riapri la pagina Dashboard in modalità Incognito/Privata.

Verifica se i seguenti servizi sono in esecuzione:

sudo systemctl status pironman5 --no-pager
sudo systemctl status influxdb --no-pager

Entrambi i servizi dovrebbero mostrare:

active (running)

Se uno dei servizi non funziona correttamente, riavviali:
```
sudo systemctl restart influxdb
sudo systemctl restart pironman5
```
Quindi attendi circa 30 secondi e aggiorna la pagina Dashboard.
Verifica se il database pironman5 esiste:
```
influx
```
Quindi esegui:
```
SHOW DATABASES;
```
Dovresti vedere:
```
pironman5
_internal
```
Se il database è mancante o corrotto, prova a cancellare i dati storici dalla Dashboard usando:

Impostazioni → Cancella tutti i dati
Se il problema persiste dopo aver provato tutti i passaggi precedenti, consigliamo di reinstallare Raspberry Pi OS e il software Pironman 5.

Come disabilitare la Dashboard web

Una volta completata l’installazione del modulo pironman5, potrai accedere alla Visualizzazione e Controllo dalla Dashboard.

Se non hai bisogno di questa funzione e vuoi ridurre l’uso di CPU e RAM, puoi disabilitare la dashboard durante l’installazione aggiungendo il flag --disable-dashboard.

cd ~/pironman5
sudo python3 install.py --disable-dashboard

Se hai già installato pironman5, puoi rimuovere il modulo Dashboard e influxdb:

/opt/pironman5/env/bin/pip3 uninstall pm-dashboard influxdb
sudo apt purge influxdb
sudo systemctl restart pironman5

Come disinstallare e reinstallare il software Pironman 5

Disinstalla il software pironman5 attuale:

cd ~/pironman5
sudo python3 install.py --uninstall

Riavvia il Raspberry Pi come richiesto, quindi rimuovi la directory pironman5:
```
cd ~/
sudo rm -rf pironman5
```

Esegui il seguente comando per reinstallare il software per il tuo modello Pironman 5:

curl -sSL "https://raw.githubusercontent.com/sunfounder/sunfounder-installer-scripts/main/pironman5/install.sh" | sudo bash

Come controllare i componenti con il comando `pironman5`

Puoi fare riferimento al seguente tutorial per controllare i componenti della serie Pironman 5 usando il comando pironman5.

Controllo con Comandi

5. Avvio e archiviazione

Se configuro OMV, posso ancora usare le funzioni del Pironman5?

Sì, OpenMediaVault è configurato sul sistema Raspberry Pi. Segui i passaggi di Configurazione su Raspberry Pi OS/Ubuntu/Kali Linux/Homebridge per continuare la configurazione.

Il PI5 non si avvia (LED rosso)?

Questo problema può essere causato da un aggiornamento di sistema, modifiche all’ordine di avvio o un bootloader corrotto. Prova i seguenti passaggi per risolvere il problema:

Controlla la connessione dell’adattatore USB-HDMI
- Verifica attentamente se l’adattatore USB-HDMI è collegato saldamente al PI5.
- Prova a scollegare e ricollegare l’adattatore USB-HDMI.
- Quindi ricollega l’alimentazione e verifica se il PI5 si avvia correttamente.
Testa il PI5 fuori dal case
- Se ricollegare l’adattatore non risolve il problema:
- Rimuovi il PI5 dal case della serie Pironman 5.
- Alimenta il PI5 direttamente con l’adattatore di alimentazione (senza il case).
- Verifica se può avviarsi normalmente.
Ripristina il bootloader
- Se il PI5 ancora non si avvia, il bootloader potrebbe essere corrotto. Segui questa guida: 2. Aggiornare il bootloader e scegli se avviare da scheda SD o NVMe/USB.
- Inserisci la scheda SD preparata nel PI5, accendilo e attendi almeno 10 secondi. Una volta completato il ripristino, rimuovi e riformatta la scheda SD.
- Quindi usa Raspberry Pi Imager per flashare l’ultimo Raspberry Pi OS e prova ad avviare di nuovo.

Il modulo NVMe PIP non funziona?

Assicurati che il cavo FPC che collega il modulo NVMe PIP al Raspberry Pi 5 sia fissato saldamente.
Verifica che il tuo SSD sia correttamente fissato al modulo NVMe PIP.
Controlla lo stato dei LED del modulo NVMe PIP:

Dopo aver verificato tutti i collegamenti, accendi il Pironman 5 MAX e osserva i due indicatori sul modulo NVMe PIP:
- LED PWR: Dovrebbe essere acceso.
- LED STA: Dovrebbe lampeggiare per indicare il normale funzionamento.
- Se il LED PWR è acceso ma il LED STA non lampeggia, indica che l’SSD NVMe non è riconosciuto dal Raspberry Pi.
- Se il LED PWR è spento, cortocircuita i pin «Force Enable» sul modulo. Se il LED PWR si accende, potrebbe indicare un cavo FPC allentato o una configurazione di sistema non supportata per NVMe.
Verifica che il tuo SSD NVMe abbia un sistema operativo correttamente installato. Vedi: 3. Installazione del Sistema Operativo.
Se il problema persiste, inviaci il seguente file di log:
```
cat /var/log/pironman5/pironman5.log
```

Come cambiare l’ordine di avvio del Raspberry Pi usando i comandi

Se hai già effettuato l’accesso al tuo Raspberry Pi, puoi cambiare l’ordine di avvio usando i comandi.

3. Configurare l’avvio dall’SSD

Come modificare l’ordine di avvio con Raspberry Pi Imager

Oltre a modificare BOOT_ORDER nella configurazione EEPROM, puoi anche usare Raspberry Pi Imager per cambiare l’ordine di avvio.

2. Aggiornare il bootloader

Come copiare il sistema dalla scheda SD a un SSD NVMe

Se non disponi di un adattatore NVMe-USB, puoi prima installare il sistema su una scheda Micro SD, quindi copiare il sistema sull’SSD NVMe dopo aver avviato con successo.

Copiare il sistema operativo da Micro SD a SSD NVMe

6. Utilizzo avanzato

Come rimuovere la pellicola protettiva

Due pannelli in acrilico sono inclusi nella confezione, entrambi coperti da pellicola protettiva gialla/trasparente su entrambi i lati per prevenire graffi.

La pellicola protettiva potrebbe essere difficile da rimuovere. Usa un cacciavite per sollevare delicatamente un angolo, quindi stacca con attenzione l’intera pellicola.