ManuelUtilisateur.md

# Logiciel AmicalsatDecoder 

## Contexte 

Avec l’équipe du projet Amicalsat, un logiciel de décodage des télémesure a été réalisé. 

## Téléchargement

Le logiciel est téléchargeable via les liens suivants :

### Windows

* [AmicalsatDecoderWithJRE.zip](http://site.amsat-f.org/download/117267/)

### Linux

* [AmicalsatDecoderWithJRE.gz](http://site.amsat-f.org/download/117292/)

## Prérequis 

Pour recevoir les trames d'Amicalsat, il est nécessaire d’avoir
  * un récepteur 
  * un démodulateur AFSK 1200 bauds avec une interface TCP KISS ( [Soundmodem](http://uz7.ho.ua/packetradio.htm) ou Direwolf](https://github.com/wb2osz/direwolf)  ) 
  
## Installation 

Une fois le fichier téléchargé, décompressez le fichier dans un répertoire de votre choix. 

### Windows

 Sélectionner le fichier, clic droit et ensuite extraire le fichier 



### Linux

 Par ligne de commande :
 
```
      tar -xzvf AmicalsatDecoderWithJRE.gz
```
    
Pour certaine distribution Linux, il faut installer la bibliothéque libjpeg .

```
      sudo apt-get install libjpeg62
```

## lancement du logiciel

Allez dans le répertoire où vous avez décompressé le fichier téléchargé. 

### pour windows 

 * cliquez deux fois sur le fichier "launchAmicalsat.bat "
 * ou lancer le sript
```      
      launchAmicalsat.bat
```
 
### pour linux 

 * lancer le script :  

```
    ./LaunchAmicalsatDecoder.sh
``` 

Au bout de quelques secondes, l'interface du logiciel s'affiche 

![MMI]( ApplicationAmicalsat/src/site/images/AmicalsatDecoder-.jpg)


## configuration pour envoyer les données 

Selectionnez l'onglet Configuration

![MMI-Configuration]( ApplicationAmicalsat/src/site/images/AmicalsatDecoder-3.jpg)

 **1** : permet d’indiquer son indicatif
 
 **2** : permet d’indiquer la latitude de la station au format XX.XXS  pour Sud ou XX.XXN pour le Nord.

 **3** : permet d’indiquer la longitude de la station au format XX.XXE  pour East ou XX.XXW pour l’Ouest

 **4** : si la case est cochée, l’envoie de trame vers la base de données Entrysat sera activé. Les données en 2,3 et 5 seront utilisées.

 **5** : texte utilisé dans le protocole SIDS pour identifier la source

 **6** :si la case est cochée, l’envoie de trame vers la base de données SatnoGs sera activé. Les données en 2,3 et 7 seront utilisées

 **7** : texte utilisé dans le protocole SIDS pour identifier la source

 **8** : Sauvegarde le configuration dans un fichier texte situé dans le répertoire Config.  La configuration est prise en compte immédiatement.


Les données seront envoyées sur deux base de données :
 *  Base de données expérimentale [AMSAT-F](https://amsat.electrolab.fr/)
 *  Base de données [SatNogs](https://db.satnogs.org/satellite/99836/) 

Au prochain lancement, le logiciel reprendra les données de configuration sauvegardées


## Connection au modem & réception des données 

![MMI-Configuration]( ApplicationAmicalsat/src/site/images/AmicalsatDecoder-1.jpg)

 **0** : si le logiciel a accès à internet, il ira chercher les dernières informations et indiquera si une nouvelle version est disponible. L’affectation du Numéro TLE sera automatiquement mis à jours. 
 
 **1** : Adresse IP du démodulateur , par défaut localhost
 
 **2** : Port , par défaut 8100 pour Soundmodem 
 
 **3** :  Start permet de se connecter à démodulateur . Le démodulateur doit avoir été lancé avant.
 
 L’appuie sur  le bouton start 3 lance la connexion avec le démodulateur
 
 ![MMI-Configuration]( ApplicationAmicalsat/src/site/images/AmicalsatDecoder-2.jpg)
 
 **1** : le résultat de la connexion s’affiche
 
   * Connected to modem : la connexion est réalisé, le logiciel est prêt a recevoir une trame
   * TCP DISCONNECTED : la connexion a été interrompue, pas possibilité de se connecté à soundmodem. Vérifié que soundmodem est bien lancé et configuré.

 **2** : le bouton Stop permet d’arrêter la connexion avec soundmodem. Ce sera effectif après la réception d’une trame

 **3** : permet de sauvegarder les trames reçues dans un fichier. Il est enregistré dans le répertoire data à la racine ou a été installé le logiciel.


 ## Questions 
 
 Une rubrique dédié sur le Forum de l'AMSAT-Francophone est à votre disposition : [Rubrique AmicalsatDecoder](http://forum.amsat-f.org/forumdisplay.php?fid=36)
  
 
 ## License
[GNU Lesser General Public License v2.1](http://choosealicense.com/licenses/lgpl-2.1/)