# Logiciel AmicalsatDecoder 

## Contexte 

**Amicalsat Decoder** helps to decode data from **Amicalsat** Satellite and send them to databases (SatNogs & AMSAT-F) 

## Téléchargement

The software can be downloaded  :

### Windows

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

### Linux

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

## Prerequisite 

  in order to decode data, you need to have the following assets:  
  * one receiver  
  *  AFSK 1200 bauds demodulator with TCP KISS interface ( [Soundmodem](http://uz7.ho.ua/packetradio.htm) ou Direwolf](https://github.com/wb2osz/direwolf)  ) 

  
## Installation 

After downloaded the sofware :   

### Windows

  Select the AmicalsatDecoderWithJRE.zip file and uncompress it.


### Linux

 Uncompress the file with the following command :

```
    tar -xzvf AmicalsatDecoderWithJRE.gz
```
For some Linux distribution like Unbuntu, the following library should be added :

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

## Running software


 In the software directory : 

### pour windows

 * clic twice on  "launchAmicalsat.bat "
 * or launch the script in widows cmd console
```      
      launchAmicalsat.bat
``` 
### pour linux 

 * launch the script :  
 ```
    ./LaunchAmicalsatDecoder.sh
 ```
 
  

After few seconds, the software display :  

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


## configuration needed to send data  

Selectionnez l'onglet Configuration

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

 **1** : allows you to indicate your callsign
 
 **2** : Allows you to indicate the latitude of the station in XX.XXS format for South or XX.XXN for North.

 **3** : Allows you to indicate the longitude of the station in XX.XXE format for East or XX.XXW for West

 **4** : if the box is checked, the frame sending to the Amicalsat database will be enabled. Data in 2,3 and 5 will be used.

 **5** : text used in the SIDS protocol to identify the source

 **6** : If the box is checked, the frame sending to the SatnoGs database will be enabled. Data in 2,3 and 7 will be used

 **7** : text used in the SIDS protocol to identify the source

 **8** : Saves the configuration in a text file located in the Config. The configuration is taken into account immediately.


When you running the software the next time, the same configuration is used.

The data are sent to Two data base 
* Amsat-F experimental data base :  [https://amsat.electrolab.fr/](https://amsat.electrolab.fr/)
* SatNogs data base : [Satnogs](https://db.satnogs.org/satellite/99836/) 


## Modem connection and send data to data base  

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

 **0** : if the software has access to the Internet, it will look for the latest information and indicate if a new version is available. The assignment of the TLE Number will be automatically updated.

 **1** : IP address of the soundmodem, by default localhost

 **2** : Port, default 8100

 **3** : Start allows you to connect to Soundmodem. Soundmodem must have been launched before.

Pressing the start button 3 starts the connection with the modem
 

 
 ![MMI-Configuration]( ApplicationAmicalsat/src/site/images/AmicalsatDecoder-2.jpg)
 
 **1** : the result of the connection is displayed

 * Connected to modem : the connection is made, the software is ready to receive a frame
 * TCP DISCONNECTED: the connection has been interrupted, no possibility to connect to modem. Verified that modem is running and configured correctly
 **2** : The Stop button stops the connection with modem. This will be effective after receiving a frame
 **3** : Allows you to save the received frames in a file. It is saved in the data directory at the root where the software was installed.


 ## Question 
 
 A dedicated folder on AMSAT-Francophone forum is set : [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/)