Documentation du programme SATDOC de F6BVP - version 2.8.1 sous Linux - 14 novembre 2004

Ce document est destiné aux opérateurs de BBS (sysops)


SATDOC est un programme complémentaire du logiciel BBS de F6FBB.
Mais on peut aussi l'utiliser seul.

Tout d'abord pour en vérifier le bon fonctionnement copiez le fichier ans.txt dans le même répertoire que satdoc et tapez

./satdoc ans.txt 

ou bien

./satdoc -i ans.txt

ans.txt comporte des bulletins de l'AMSAT NEWS SERVICE qui donnent des informations utiles sur les satellites en service diffusées par Internet ou paquet radio.

Dans le premier cas SATDOC va créer des fichiers nnnnn.sat avec le numéro NASA de chaque satellite comme nom de fichier.

Dans le second cas (option -i) SATDOC nommera les fichiers au nom de chaque satellite.
Cette option est plus utile pour une consultation locale des fichiers.

INTRODUCTON


Merci à Mike N1JEZ qui a courtoisement accepté ma proposition de modifier ses bulletins ANS à partir du numéro ANS-292 et dont vous avez peut être noté le changement.

J'ai demande à Mike d'introduire une ligne comportant le numéro de catalogue après la ligne d'identification de chaque satellite. 
Un peu comme dans les bulletins d'éléments képleriens de l'AMSAT.

Ce numéro de catalogue ouvre en effet la voie au traitement automatise de l'information sur chaque satellite en vue de mettre à jour les fichiers documentaires présents dans les serveurs BBS type F6FBB.

SATDOC parcoure le fichier AMSAT.TXT exporté par le système de courrier de la BBS, et recherche la présence des bulletins AMSAT NEWS SERVICE dans le but d'y récupérer les informations pertinentes de chaque satellite.

Chaque objet en orbite se voit en effet attribuer un numéro de catalogue international par la NASA. Ceci permet de construire un nom de fichier
non équivoque à partir de ce numéro et de l'extension .SAT A l'inverse, les noms des satellites peuvent être multiples et ambigus.

COMMENT LE SYSOP DOIT-IL INSTALLER ET CONFIGURER LE SYSTEME DE MISE A JOUR DOCUMENTAIRE

Si vous avez déjà mis en place le logiciel AJOURSAT pour la mise à jour des éléments képleriens des satellites, vous pouvez sauter le paragraphe suivant.

Vous devez créer un BBS fictif nomme AMSAT dans le fichier BBS.SYS
Le fichier amsat.fwd de forward pour ce BBS fictif AMSAT devra ressembler a ceci  (noter la ligne de ----- obligatoire en fin de fichier) :

A AMSAT
*
   G KEPLER
   G AMSAT
   P @
   c /usr/local/var/ax25/fbb/sat/amsat.txt
   B AMSAT
   F AMSAT
   F KEP
   F KEPS
   F KEPLER
   F SAT
   F SATTV
   F SATELL
-----------

Ainsi AMSAT.TXT collectera tous les messages ayant une documentation sur les satellites (fréquences, changement de mode, information de lancements etc...)

Les SYSOPs doivent ensuite ajouter un appel au programme SATDOC dans le script de maintenance juste avant l'appel a AJOURSAT avec AMSAT.TXT comme argument. 
Le résultat du fonctionnement du programme est écrit dans le fichier SATDOC.RES

-------------extrait du script de la procédure de maintenance-------------

if [ -e $FBBDIR/sat/amsat.txt ]
        then
    cd $FBBDIR/sat/
    /usr/local/bin/satdoc amsat.txt > $FBBDIR/satdoc.res
    /usr/local/bin/satdoc -i amsat.txt >> $FBBDIR/satdoc.res
    /usr/local/bin/ajoursat amsat.txt /n /d60 > $FBBDIR/ajoursat.res
    /usr/local/bin/ajoursat amsat.txt /a /d60 >> $FBBDIR/ajoursat.res
        rm amsat.txt
fi

------------fin de l'extrait-----------

Donc, dès qu'un bulletin ANS est recupéré par la BBS, les nouvelles et les documentations sur les satellites seront automatiquement transcrits dans des fichiers au numéro et au nom du satellite.

Dès lors un utilisateur du BBS peut récupérer cette information à la demande.
après connexion, les commandes pour accéder au service satellite du serveur sont :

F pour passer le BBS en mode serveur et
T pour entrer dans le sous menu satellite.

Ensuite les choix possibles sont :

C pour lire les nouvelles et documentations individuelles des satellites
P pour lire les éléments képleriens
T pour obtenir une prévision de passage de satellite

Dans ma BBS les programmes exécutables de service sont dans les répertoire /usr/local/bin/ ou /usr/local/sbin
Veuillez configurer vos fichiers AMSAT.FWD et de maintenance en fonction de votre propre configuration d'installation.

La version la plus récente du logiciel se trouve sur :

http://f6bvp.free.fr/logiciels/satdoc/

MODIFICATION FACULTATIVE DU LOGICIEL BBS de F6FBB

Afin de faciliter la consultation des informations documentaires j'ai propose récemment une modification (patch) du logiciel BBS de F6FBB.
Anciennement la BBS listait tous les satellites de la banque de données, même si aucune documentation n'était présente, ce qui pouvait être long, fastidieux et frustrant à consulter.
Avec ma modification le programme affiche une '*' en face des noms des satellites ayant un fichier documentaire.

La modification est disponible ici :

http://f6bvp.free.fr/logiciels/satdoc/patch_fbb.txt
Appliquez ce patch au fichier source console.c et recompilez le programme xfbbd en lançant la commande 'make' à partir du répertoire racine contenant les sources.
 Pour toute information complémentaire ou demande d'aide contactez moi via courriel : f6bvp**at**free.fr