7. Source NINA

But : lire l'équipement de NINA (caméra, roue à filtres, focuser, guidage, monture…) et l'historique de ses images.

7.1 Avant de commencer

• NINA est lancé (version 3.x) avec le plugin Advanced API installé et activé (dans NINA : Plugins, puis les options du plugin Advanced API). Par défaut, le plugin répond sur le port 1888.
• Ton équipement est connecté dans NINA (onglet Équipement de NINA). AstroTools ne connecte rien.
• Ton PC et la machine de NINA sont sur le même réseau ; un pare-feu éventuel laisse passer le port 1888.

7.2 Ajouter la source

1. Vue Sources et acquisition, page Sources.
2. Ajouter ▾ > NINA (Advanced API). Préfixe nina, port 1888.
3. Hôte : le nom de la machine de NINA (X1PRO), ou localhost si NINA tourne sur ce PC.
4. Tester. Tu dois voir « NINA (Advanced API) répond : version 2.2.15.2, NINA 3.2.0.9001, en … ms » (la version du plugin, puis celle de NINA).

7.3 Choisir les appareils

1. Interroger. AstroTools liste 12 appareils, toujours les mêmes : camera, filterwheel, focuser, guider, mount, flatdevice, rotator, switch, weather, safetymonitor, dome, plus images (l'historique des images, section 7.6). La ligne de résultat dit « 12 appareil(s) trouvé(s), dont n connecté(s)… ». Aucun n'est coché, sauf images, toujours coché et grisé (section 7.6).
2. Cocher les appareils connectés coche d'un clic tous les appareils connectés dans NINA. Décoche ensuite ce que tu lis déjà par une autre source (par exemple weather et switch si tu lis l'Uranus et l'UPBv3 par Pegasus, chapitre 5, section 5.6).
3. Interroger à nouveau : chaque appareil coché est lu, par sa propre adresse.
4. Page Champs (chapitre 8) pour choisir et décrire les champs, puis Enregistrer.

Tout décocher décoche tous les appareils de la source d'un clic, pour repartir d'un choix propre. Les alias et les champs sont gardés ; rien n'est enregistré avant Enregistrer (et Annuler les modifications remet les cases comme avant).

Durée : une interrogation NINA prend de l'ordre d'une demi-seconde pour quelques centaines de champs.

7.4 Un appareil par catégorie

NINA n'a qu'un appareil actif par catégorie (une caméra, une monture…). Dans AstroTools, une catégorie est donc un appareil, et sa clé est la catégorie (camera). Les colonnes Nom et Nom complet montrent le matériel réel (« ZWO ASI2600MC Pro »).

Appareil non connecté

Une catégorie sans équipement connecté dans NINA est non connecté :

• s'il n'est pas coché (dôme, rotateur que tu n'as pas) : il est grisé, en silence, sans alerte ni message. C'est le cas normal ;
• s'il est coché (tu voulais le lire, mais la caméra a été déconnectée) : la ligne de résultat le signale en couleur d'alerte (« 1 non connecté(s) (camera) »), il n'est pas lu, et ses champs passent « non observé » : ils sont gardés, sans valeur. Reconnecte-le dans NINA puis Interroger : tout revient.

AstroTools ne prend jamais les valeurs d'un appareil non connecté (NINA en renvoie de fausses : température 0, etc.).

Appareil changé

Si tu changes de matériel dans NINA (autre caméra, ou le simulateur de caméra de NINA), le nom renvoyé change. AstroTools affiche alors « ⚠ appareil changé : ZWO ASI2600MC Pro → … » et la ligne de résultat le rappelle. L'alerte reste d'une interrogation à l'autre, pour que tu ne la manques pas.

Les champs et réglages de l'appareil sont gardés. Une fois que tu as vérifié que c'est voulu : clique la ligne de l'appareil, puis Prendre en compte, et Enregistrer. L'alerte disparaît.

7.5 Particularités des valeurs NINA

• « NaN » : NINA envoie parfois le texte "NaN" au lieu d'un nombre (vent, pluie, FWHM des étoiles de la station météo…). AstroTools le lit comme « pas de valeur » : la colonne Valeur reste vide, l'état est « invalide », et le champ reste de type nombre, donc utilisable en graphique quand une vraie mesure arrive.
• Listes de configuration ignorées : la liste des filtres de la roue (avec leurs décalages d'autofocus), des gains, des modes de binning, de lecture, de suivi… ne bougent pas pendant la nuit et ne sont pas proposées. Pour la roue à filtres, seul le filtre actif compte : SelectedFilter.Name et SelectedFilter.Id. Ces listes restent visibles dans les réponses brutes (chapitre 10).
• Guidage : guider.RMSError.Total.Arcseconds (et RA, Dec, en pixels et en ″) sont les valeurs calculées par PHD2, avec sa focale de guidage. AstroTools ne recalcule rien. En simulation, sans focale déclarée dans PHD2, les secondes d'arc valent 0 : c'est normal. LastGuideStep.* n'existe que pendant le guidage : guidage arrêté, ces champs passent « absent de la réponse », ce qui est vrai ; ils restent décrits et cochés.
• Les autres listes (sorties de l'UPBv3 vues par NINA, par exemple) sont dépliées par position : switch.ReadonlySwitches[6].Value.

7.6 L'historique des images (images)

L'appareil images n'est pas un équipement mais un journal : NINA y ajoute une ligne à chaque pose (HFR, nombre d'étoiles, filtre, température, gain, médiane, date, nom du fichier…). Ses champs décrivent une image.

Depuis la version 0.7.1, AstroTools connaît d'avance ces champs (ceux que documente l'Advanced API) : ils apparaissent dans la page Champs dès que l'appareil images existe, même si NINA n'a encore fait aucune pose. Ils ont un libellé intégré (« HFR », « Étoiles », « Temp. capteur », « Durée de pose »…) et des règles intégrées (un HFR doit être plus grand que 0, un nombre d'étoiles 0 ou plus…) : il n'y a rien à régler, le détail du champ est grisé.

• Interroger (ou Rafraîchir dans la page Champs) lit la dernière pose. Après une série de 7 poses _0000 à _0006, Filename vaut le nom du fichier …_0006.fits.
• Le nombre d'images n'est pas un champ : il se voit dans les réponses brutes (image-history?count=true répond n, puis la lecture de l'index n-1).
• Date est en temps universel (UTC) : en été, 2 h de moins que l'heure affichée par l'Explorateur Windows.
• Filename est le nom seul, sans le dossier.
• Si NINA vient de démarrer et n'a encore aucune pose, la ligne de résultat dit « pas encore d'entrée : images » ; ce n'est pas une panne, ses champs restent « non observé ».

Pour enregistrer toutes les poses de la nuit, une ligne par image, coche Images dans la page Acquisition (chapitre 14, section 14.8). La case de l'appareil images (page Sources) et ses cases Enreg. (page Champs) sont cochées et grisées : ce ne sont pas d'autres commandes. C'est la case Images qui décide ; chaque image est alors écrite en entier.

Deux sources NINA actives (par exemple ta NINA et le simulateur, pour un test) : une séance ne prend les images que d'une source NINA. Avec Toutes, décoche Active sur la source NINA à laisser de côté (page Sources), ou choisis la bonne source dans Sources à acquérir.

7.7 Si ça ne répond pas

Comme pour Pegasus, une interrogation qui échoue n'efface jamais rien.