# 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


## 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 :  
 
    LanchAmicalsatDecoder.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


## 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/)