Dépannage¶
Cette page présente les problèmes courants que vous pouvez rencontrer en utilisant le HALPI2, et la manière de les résoudre.
Problèmes d'alimentation et de démarrage¶
Le système ne s'allume pas¶
Symptômes : aucune activité des LED, aucun signe de vie après le raccordement de l'alimentation.
- Vérifiez au multimètre, sur le connecteur E7T, que la tension d'entrée est dans la plage admise (11–32 V CC).
- Contrôlez les raccordements du câble d'alimentation — assurez-vous que le connecteur E7T est bien enfoncé.
- Si vous alimentez l'appareil par le bus NMEA 2000, vérifiez que le limiteur de courant est réglé sur 0,9 A et que le réseau peut fournir un courant suffisant.
- Ouvrez le boîtier et recherchez des dommages visibles ou des connexions internes desserrées.
LED en arc-en-ciel¶
Symptômes : les LED défilent en arc-en-ciel et n'atteignent jamais un état stable.
Le motif arc-en-ciel signifie que le contrôleur est sous tension mais que le CM5 n'est pas détecté. Cela peut se produire si :
- le Compute Module n'est pas installé ou n'est pas correctement enfoncé ;
- le Compute Module est défectueux ;
-
un appareil raccordé injecte des tensions parasites qui empêchent le CM5 de démarrer — essayez de débrancher le câble HDMI.
-
Débranchez tous les écrans HDMI et redémarrez pour écarter l'hypothèse des tensions parasites.
- Si le problème persiste, ouvrez le boîtier et vérifiez que le module CM5 est bien enfoncé dans son connecteur — cela suppose de déposer la carte porteuse.
Les LED restent jaunes¶
Symptômes : les LED passent du rouge (charge) au jaune (sous tension) mais n'atteignent jamais le vert.
L'état jaune signifie que le contrôleur a mis le CM5 sous tension et attend la réponse du démon. Si les LED restent jaunes, soit le système d'exploitation ne démarre pas, soit le démon HALPI n'est pas installé.
- Vérifiez que le sélecteur de mode de démarrage est en position « Normal » — la LED jaune située à côté s'allume lorsque le mode est réglé sur « Abnormal » (démarrage USB).
- Raccordez un écran en HDMI pour voir les erreurs de démarrage ou l'invite de connexion.
- Vérifiez que le SSD NVMe est bien enfoncé dans son emplacement M.2.
- Si le système démarre correctement, vérifiez que le démon est installé :
systemctl status halpid - Si le démon est installé mais ne tourne pas, consultez ses journaux :
journalctl -u halpid -e
Le système s'arrête de façon inattendue¶
Symptômes : le système se met hors tension sans intervention, alors que l'alimentation externe est raccordée.
- Contrôlez la stabilité de la tension d'entrée — de brèves chutes sous le seuil déclenchent la temporisation de coupure. Suivez
V_inen temps réel avechalpi status. - Inspectez le câble d'alimentation à la recherche de connexions desserrées ou de conducteurs abîmés susceptibles de provoquer un contact intermittent.
- Si vous alimentez l'appareil par le bus NMEA 2000, vérifiez que la tension du réseau reste stable en charge. D'autres appareils gourmands sur le réseau peuvent provoquer des chutes de tension.
Mise à jour du firmware échouée ou annulée¶
Si le système redémarre dans les 30 secondes suivant une mise à jour du firmware, celui-ci revient automatiquement à la version précédente, par sécurité.
- Vérifiez la version actuelle du firmware :
halpi get firmware_version - Relancez la mise à jour :
sudo apt update && sudo apt install --reinstall halpi2-firmware - Une fois la mise à jour installée, effectuez un arrêt propre :
sudo shutdown -h now - Attendez la mise hors tension complète avant de rebrancher — laissez au moins 30 secondes avant le redémarrage suivant pour ne pas déclencher le mécanisme de retour arrière.
Problèmes de réseau et d'interfaces¶
Aucune donnée NMEA 2000¶
Symptômes : candump can0 n'affiche rien, ou Signal K ne reçoit aucune donnée.
-
Vérifiez l'état de l'interface CAN :
L'interface doit êtreUP. Si elle estDOWN, activez-la : -
Observez la LED RX sur la carte porteuse — elle doit clignoter lorsqu'il y a du trafic sur le réseau. Si la LED RX reste éteinte :
- vérifiez le raccordement du câble Micro-C et la position du connecteur en T ;
- assurez-vous que le réseau NMEA 2000 est alimenté et que d'autres appareils émettent ;
- vérifiez que le cavalier de terminaison 120 Ω n'est pas activé sur un réseau NMEA 2000.
-
Si la LED RX clignote mais que
candumpn'affiche rien, le problème est logiciel. Vérifiez la configuration de l'interface CAN : -
Recherchez des erreurs sur le bus CAN :
Un nombre d'erreurs élevé suggère un problème de câblage, un débit incorrect ou une contention sur le bus.
Aucune donnée NMEA 0183 sur le RS-485¶
Symptômes : aucune donnée sur /dev/ttyAMA4, ou l'appareil raccordé ne répond pas.
- Ouvrez le boîtier et observez les LED de l'interface RS-485 — la LED RX doit clignoter à la réception de données.
- Vérifiez que le port série existe et est accessible :
- Contrôlez la polarité du câblage — le RS-485 utilise une signalisation différentielle sur les lignes A et B. Une inversion de A et B empêche toute communication.
Le lien Ethernet ne s'établit pas¶
- Vérifiez le câble Ethernet et le connecteur RJ45. Essayez un autre câble.
- Ouvrez le boîtier et observez les LED Ethernet pour connaître l'état du lien.
- Vérifiez l'état du lien :
ip link show eth0 - Si le lien est actif mais qu'aucune adresse IP n'est attribuée, vérifiez le DHCP :
sudo dhclient eth0 - En configuration IP fixe, vérifiez les réglages dans
/etc/network/interfacesou dans NetworkManager.
Problèmes liés au système d'exploitation¶
Impossible de se connecter en SSH¶
- Vérifiez que SSH est activé :
sudo systemctl status ssh - Vérifiez la connectivité réseau — l'appareil répond-il au ping ?
- SSH est activé par défaut sur les images HaLOS sans écran et sur OpenPlotter. Sur les variantes HaLOS Desktop et sur Raspberry Pi OS, SSH s'active avec
raspi-config.
Le système est lent ou se fige¶
-
Vérifiez la température du processeur — une température ambiante extrême peut provoquer un bridage thermique. Utilisez :
Une température supérieure à 80 °C indique un problème thermique. Essayez de réduire la température ambiante ou d'améliorer la circulation d'air autour du boîtier. -
Vérifiez l'utilisation de la mémoire :
free -h - Vérifiez l'espace disque :
df -h— un SSD NVMe plein dégrade fortement les performances. - Recherchez les processus emballés :
topouhtop
L'heure est fausse après une coupure¶
Le HALPI2 dispose d'une horloge temps réel (RTC) avec pile de sauvegarde, qui conserve l'heure pendant les coupures. Si l'horloge se réinitialise :
- Vérifiez la pile de la RTC — elle peut être à remplacer si l'appareil est resté longtemps hors tension.
- Vérifiez la synchronisation NTP lorsque le réseau est disponible :
timedatectl status - Réglez l'heure manuellement si nécessaire :
sudo timedatectl set-time "2025-01-15 14:30:00"
Diagnostic par les LED¶
Les motifs des LED permettent d'identifier rapidement l'état du système :
| Symptôme | Motif des LED | Cause probable |
|---|---|---|
| Le système ne démarre pas | Aucune LED | Pas d'alimentation d'entrée ou défaut matériel |
| Bloqué au démarrage | Remplissage rouge progressif | Supercondensateurs encore en charge — patientez |
| Bloqué au démarrage | Motif arc-en-ciel | CM5 non détecté — vérifiez la mise en place du module et débranchez les écrans |
| Reste au jaune | Jaune fixe | Le système ne démarre pas ou le démon n'est pas installé |
| Arrêt inattendu | Vert/jaune défilant | Perte d'alimentation détectée — vérifiez l'alimentation d'entrée |
| Surtension | LED 1 clignotant en rouge | Tension d'entrée trop élevée (plus de 32 V) |
| Défaut | Toutes les LED clignotant en rouge | Défaut matériel — contactez le fabricant |
Voir aussi
- Motifs des LED : voir LED d'état
- Gestion de l'alimentation : voir Gestion de l'alimentation et procédures d'arrêt
- Gestion du démon : voir le Guide logiciel
- Détails de l'interface CAN : voir Interfaces et connectivité
- Détails de l'interface RS-485 : voir Interfaces et connectivité