Risoluzione problemi
Questa pagina raccoglie i messaggi di errore e di avviso più comuni che MotioForge Studio può
mostrare, con la spiegazione della causa e la procedura per risolverli.
I messaggi completi sono sempre visibili nella console porte.
Porte e connessione
| Messaggio | Causa | Soluzione |
|---|
[ERR] COM5: accesso negato |
La porta COM è in uso da un altro programma (IDE Arduino, monitor seriale, altra istanza di MotioForge Studio). |
Chiudi il programma che occupa la porta. Se il problema persiste, scollega e ricollega il cavo USB. |
[ERR] porta COM non trovata |
Il numero COM configurato non corrisponde a nessun dispositivo rilevato da Windows. |
Apri Gestione dispositivi → Porte (COM & LPT) per verificare il numero corretto. Aggiorna la configurazione nell'editor porte. |
[WRN] porta già aperta |
MotioForge Studio ha tentato di aprire una porta già attiva (es. avvio playback con porta già in uso). |
Messaggio non critico. Se la porta risponde correttamente il playback procede. Altrimenti usa Disconnetti dalla console e riprova. |
[ERR] timeout handshake |
La scheda DEIMOS collegata non ha risposto al messaggio di inizializzazione entro il tempo previsto. |
Verifica che il firmware sia aggiornato. Scollega e ricollega il cavo USB. Controlla che la scheda sia alimentata. |
[ERR] frame non valido ricevuto |
Dati corrotti o protocollo errato. La velocità baud configurata non corrisponde a quella dell'hardware. |
Verifica il baud rate nell'editor porte. Per DEIMOS deve essere 115200. Per Arduino PWM verifica lo sketch caricato. |
Servi ed elementi
| Messaggio | Causa | Soluzione |
|---|
[WRN] Servo "X" — posizione Y° fuori range |
Un segmento tenta di portare il servo a una posizione oltre i limiti Minimo/Massimo impostati nell'editor elementi. |
Modifica il segmento nell'editor segmento oppure aumenta i limiti di corsa nell'editor elementi. |
[WRN] elemento orfano: "X" |
Un segmento fa riferimento a un elemento che è stato eliminato o rinominato nel dominio. |
Aggiorna i segmenti che usano l'elemento mancante oppure ricrea l'elemento con lo stesso nome. |
[WRN] indirizzo duplicato: porta Y, indirizzo Z |
Due elementi del dominio hanno lo stesso indirizzo sulla stessa porta (due servi con ID=1, per esempio). |
Verifica gli indirizzi fisici nell'editor elementi. Ogni dispositivo deve avere un indirizzo univoco. |
[ERR] playback: porta non aperta |
Il playback è partito ma la porta necessaria non è riuscita ad aprirsi (errore silenzioso precedente). |
Controlla i messaggi precedenti nella console. Verifica la connessione hardware e riavvia il playback. |
Audio
| Messaggio | Causa | Soluzione |
|---|
[ERR] file audio non trovato: "percorso" |
Il file audio collegato a un segmento SOUND non esiste al percorso relativo salvato. |
Verifica che il file sia nella cartella audio/ del dominio. Riapri il segmento e seleziona il file corretto con Sfoglia. |
[ERR] formato audio non supportato |
Il file audio ha un formato non riconosciuto da MotioForge Studio (es. WMA, AIFF). |
Converti il file in WAV, MP3 o OGG usando qualsiasi convertitore gratuito (es. Audacity, VLC). |
[WRN] dispositivo audio non disponibile |
MotioForge Studio non riesce ad accedere al dispositivo audio di Windows (scheda audio disattiva o in uso). |
Verifica che un dispositivo audio sia selezionato e attivo in Windows → Impostazioni → Audio. |
Firmware DEIMOS
| Messaggio | Causa | Soluzione |
|---|
[ERR] caricamento firmware fallito: arduino-cli non trovato |
Lo strumento arduino-cli non è installato o non è nel PATH di sistema. |
MotioForge Studio include arduino-cli nelle sue risorse. Se l'errore persiste reinstalla MotioForge Studio o contatta il supporto. |
[ERR] caricamento firmware fallito: porta occupata |
La porta COM è ancora in uso da MotioForge Studio o da altro software. |
Disconnetti la porta dalla console prima di caricare il firmware. MotioForge Studio lo fa automaticamente dal dialogo firmware; se il problema persiste chiudi MotioForge Studio, ricollegati e riprova. |
[ERR] verifica integrità fallita |
Il file pacchetto firmware è corrotto o parzialmente scaricato. |
Reinstalla MotioForge Studio per ripristinare i file originali dei pacchetti firmware. |
[WRN] versione firmware non compatibile |
Il firmware caricato sulla scheda non corrisponde alla versione attesa dal protocollo MotioForge Studio. |
Aggiorna il firmware tramite Carica firmware DEIMOS usando il pacchetto incluso nella versione corrente di MotioForge Studio. |
Dominio e file
| Messaggio | Causa | Soluzione |
|---|
[ERR] impossibile caricare il dominio |
Il file domain.json è corrotto o scritto da una versione incompatibile di MotioForge Studio. |
Ripristina il dominio da un backup. Se non disponibile, crea un nuovo dominio e riconfigura manualmente. |
[WRN] animazione senza segmenti |
L'animazione selezionata non contiene nessun segmento. Il playback sarà immediato e silenzioso. |
Aggiungi almeno un segmento nell'editor principale prima di avviare il playback. |
[ERR] cartella domini non trovata |
La cartella configurata in Impostazioni → Percorsi non esiste o non è accessibile. |
Apri Impostazioni → Percorsi... e seleziona una cartella valida. MotioForge Studio la crea automaticamente se non esiste. |
Suggerimento: Attiva il flag Log I/O nella console porte per vedere tutti i frame
trasmessi e ricevuti in tempo reale. È il modo più diretto per diagnosticare problemi di comunicazione
con l'hardware.