6. Source Pegasus Unity

But : lire les boîtiers Pegasus (Uranus, UPBv3…) gérés par Pegasus Unity.

6.1 Avant de commencer

• Unity est lancé sur la machine où sont branchés les boîtiers (par exemple X1PRO), et les boîtiers sont alimentés.
• Ton PC et cette machine sont sur le même réseau.
• Unity répond sur le port 32000. Si un pare-feu est actif sur la machine distante, il doit laisser passer ce port.

6.2 Ajouter la source

1. Vue Sources et acquisition, page Sources.
2. Ajouter ▾ > Pegasus Unity. La source apparaît avec le préfixe pegasus, l'hôte localhost, le port 32000, un délai de 5 s, Active cochée. La barre d'état dit « Source ajoutée (pas encore enregistrée) ».
3. Hôte : tape le nom de la machine d'Unity (X1PRO), ou laisse localhost si Unity tourne sur ce PC.
4. Tester. Tu dois voir « Pegasus Unity répond : version 3.0.167.1, en … ms ». Sinon, voir section 6.6.

6.3 Choisir les boîtiers

1. Interroger. La première fois, AstroTools liste seulement les boîtiers : « 2 appareil(s) trouvé(s). Coche ceux à utiliser, puis Interroger à nouveau. » Les boîtiers apparaissent dans la grille, avec leur alias proposé (uranus, upbv3), état « nouveau », non cochés.
2. Coche, dans la colonne Utiliser, les boîtiers à lire.
3. Interroger à nouveau. Pour chaque boîtier coché, AstroTools démarre son pilote dans Unity puis lit son rapport. La ligne de résultat donne le nombre d'appareils lus et de champs trouvés.
4. Va sur la page Champs (chapitre 8) pour choisir et décrire les champs.
5. Enregistrer.

Le démarrage des pilotes : c'est ce que fait Unity quand tu cliques sur un appareil ; un pilote déjà démarré n'est pas perturbé. Seuls les boîtiers cochés sont démarrés : AstroTools ne touche pas à ce que tu ne lui demandes pas. Unity ne sait pas arrêter un pilote : il reste démarré jusqu'à une coupure de courant des boîtiers.

Durée : une interrogation Pegasus prend de l'ordre d'une seconde et demie pour deux boîtiers (découverte, démarrage, rapport de chaque boîtier).

6.4 Ce qu'il faut savoir sur les boîtiers Pegasus

• Reconnaissance par la clé : chaque boîtier a une uniqueKey (colonne Clé) qui ne change pas, même après un redémarrage d'Unity ou une coupure de courant. C'est elle qui permet à AstroTools de le retrouver.
• Boîtier débranché : à l'interrogation suivante, il est « indisponible » et ses champs passent « non observé » ; tout est gardé. Rebranche-le (et redémarre-le dans Unity si besoin), Interroger : il revient avec son alias et ses réglages.
• Boîtier remplacé : un nouveau boîtier a une nouvelle clé, donc il apparaît comme nouveau (et l'ancien comme indisponible). Si son alias proposé est déjà pris par l'ancien, change d'abord l'alias de l'ancien (double-clic dans la colonne Alias, par exemple uranus_ancien), puis donne uranus au nouveau : tes identifiants restent les mêmes.
• Valeurs « pas de mesure » : certains boîtiers envoient une valeur bidon quand ils n'ont pas de mesure (9999.9999 pour une sonde absente, 0 pour la luminosité de l'Uranus). Déclare-les dans le détail du champ (chapitre 8, section 8.4), pour qu'elles ne soient jamais prises pour de vraies mesures.
• Sonde externe de l'UPBv3 : le point de rosée externe n'a de sens que si la sonde est branchée. Utilise une dépendance (chapitre 8, section 8.5).

6.5 Deux sources Pegasus

Rare, mais possible (un Unity au jardin, un autre à l'intérieur) : Ajouter ▾ > Pegasus Unity une seconde fois. AstroTools propose le préfixe pegasus2 ; deux sources ne peuvent jamais avoir le même préfixe.

Pour le simulateur (chapitre 10), crée une source à part (préfixe pegsim, hôte localhost) : tu ne mélanges jamais simulation et vraies mesures.

6.6 Si ça ne répond pas

Une interrogation qui échoue n'efface jamais rien : appareils et champs décrits restent.