13. Dépannage
Règle générale : AstroTools ne laisse jamais passer un problème en silence et ne plante pas sur un fichier abîmé. Au démarrage, tous les problèmes trouvés sont regroupés dans une seule fenêtre d'avertissement ; pendant la séance, ils s'ajoutent au compteur ⚠ ✖ et à la console (chapitre 11).
13.1 La fenêtre d'avertissement au démarrage
Elle commence par « Premier démarrage, ou données supprimées », donne le dossier des données, puis une ligne par problème, et propose d'ouvrir le dossier. (AstroTools ne peut pas savoir si c'est un premier démarrage ou si des fichiers ont disparu : les deux cas se ressemblent.)
| Ligne | Ce qui s'est passé | Quoi faire |
|---|---|---|
| dossier absent : recréé… | premier démarrage, ou dossier supprimé ou renommé | rien si c'est le premier démarrage ; sinon remets ton dossier (chapitre 12) |
| équipement absent… | equipment.json supprimé |
AstroTools écrit aussitôt un fichier vide : remets ta sauvegarde si tu en as une |
équipement illisible… une copie a été gardée : …equipment.json.bad |
le fichier est abîmé (modifié à la main, coupure) | AstroTools démarre avec un équipement vide. Le .bad contient l'ancien texte : corrige-le ou remets ta sauvegarde, AstroTools fermé |
| équipement créé par une version plus récente… | tu as lancé une ancienne version après une plus récente | le matériel est chargé, mais des informations récentes peuvent être ignorées : utilise la version la plus récente |
| équipement inaccessible (droits d'accès, ou fichier ouvert ailleurs)… | le fichier existe mais ne s'ouvre pas | AstroTools n'enregistre rien pendant la séance, pour ne pas écraser ton vrai fichier. Ferme l'autre programme (Excel…) ou rétablis les droits, puis relance |
| sources illisibles / inaccessibles / écrites par un AstroTools plus récent | même chose pour sources.json |
même chose ; la copie est sources.json.bad |
| préférences absentes / illisibles… | prefs.dat supprimé, abîmé, ou venu d'un autre PC |
rien : langue, thème et fenêtre repartent par défaut, et sont réenregistrés à la fermeture |
| config.ini absent : recréé à partir du modèle… | config.ini supprimé |
rien : il est revenu avec les valeurs du modèle ; refais tes réglages si tu en avais |
| config.ini absent, et modèle introuvable… | config.ini et le modèle du dossier du programme manquent |
réinstalle le programme (chapitre 1) ; en attendant, valeurs par défaut |
| config.ini inaccessible… | le fichier ne s'ouvre pas | valeurs par défaut ; ferme l'autre programme, relance |
Un fichier inaccessible n'est jamais traité comme abîmé : il n'est ni copié ni modifié.
13.2 Messages pendant l'utilisation
| Message | Cause | Quoi faire |
|---|---|---|
| « Impossible d'enregistrer l'équipement : … » | equipment.json en lecture seule, disque plein… |
la modification reste à l'écran mais n'est pas enregistrée ; corrige la cause (Propriétés du fichier, décocher Lecture seule), puis refais la modification |
| « Cette modification n'est pas enregistrée… » | equipment.json était inaccessible au démarrage |
voir 13.1 |
| « Les sources ne sont pas enregistrées… » / « Impossible d'enregistrer les sources : … » | même chose pour sources.json |
même chose |
| « Le champ « Nom » est obligatoire. » | nom vide dans le matériel ou une sélection | donne un nom |
| « Le préfixe « … » est déjà utilisé par une autre source. » | deux sources avec le même préfixe | choisis un autre préfixe |
| « Seuls a-z, 0-9, - et _ sont permis… » | espace, majuscule ou accent dans un préfixe ou un alias | corrige (pegasus, pas Pégasus) |
| « Hôte invalide… » | espace ou « / » dans l'hôte | un nom de machine (X1PRO) ou une adresse IP, rien d'autre |
| « L'alias « … » est déjà utilisé dans cette source. » | deux appareils avec le même alias | choisis un autre alias (double-clic dans la colonne Alias) |
| « Donne d'abord un alias à cet appareil. » | appareil à l'état « alias à saisir » | double-clic dans la colonne Alias |
| « … : valeur attendue de type … » | valeur du mauvais type dans le détail d'un champ | tape un nombre pour un nombre, vrai / faux pour un booléen |
| « Dépendance refusée : elle créerait une boucle… » | A dépend de B qui dépend de A | retire une des deux dépendances |
| « filters.json est illisible (copié en filters.json.bad)… » | fichier des sélections abîmé | AstroTools fermé, remets ta sauvegarde ou corrige le fichier ; les sélections ne sont pas enregistrées d'ici là |
| « n sélection(s) illisible(s) de filters.json ignorée(s) » | une sélection abîmée dans un fichier par ailleurs bon | les autres marchent ; enregistre de nouveau la sélection concernée |
13.3 Une source ne répond pas
Voir chapitre 6, section 6.6 (Pegasus) et chapitre 7, section 7.7 (NINA). En résumé :
- Tester d'abord : il dit si le logiciel répond.
- « injoignable » : nom de machine, machine éteinte ou hors réseau, logiciel arrêté.
- « pas de réponse en 5 s » : logiciel arrêté ou mauvais port (le pare-feu de la machine distante ne répond pas du tout). Le délai se règle dans la fiche (Délai max).
- Un seul appareil sans réponse : regarde-le dans Unity ou NINA ; les autres sont lus normalement.
- Réponses brutes… montre exactement ce qui a été demandé et répondu.
Une interrogation qui échoue n'efface jamais d'appareil ni de champ.
13.4 Acquisition et graphique
Les messages de la page Acquisition, des fenêtres de graphique et de la page WebSocket sont expliqués au chapitre 14, section 14.7. Une source coupée pendant une acquisition ne demande rien : l'enregistrement reprend tout seul à son retour (section 14.4).
13.5 Signaler un problème
Écris à astrotools@michelfabre.ch (l'adresse est aussi dans Aide > À propos). Donne :
1. ce que tu faisais (chapitre et étape du manuel si possible) ;
2. ce que tu as vu, avec une capture d'écran ;
3. la version (Aide > À propos) ;
4. le fichier de log du jour (vue Console > Ouvrir le dossier des logs) ;
5. pour une source : une capture des Réponses brutes (Enregistrer…), relue avant envoi.