KissTool : Différence entre versions

De AMSAT-F.org
Sauter à la navigation Sauter à la recherche
 
Ligne 1 : Ligne 1 :
−
==Contexte==
+
Voici la version du manuel d'utilisation de KissTool au format **MediaWiki**, prête à être copiée sur un wiki.
−
Ce logiciel a été créé initialement pour aider à récupérer des trames de télémesures au format AX25 pour permettre de les analyser ou de les envoyer vers des bases de données.
 
  
−
==Fonctionalités==
+
== Manuel d'utilisation de KissTool ==
  
−
Le logiciel permet de :
+
'''Version 4.0.0''' | JOSAST - Java Open Source Amateur Satellite Toolkit | AMSAT-Francophone
  
−
* capturer des données issue d’un démodulateur compatible du protocole TCP KISS (soundmodem par exemple)
+
-----
−
* Analyser les données reçues pour identifier l’indicatif du satellite et si l’analyse des données est présente affiche les données décodées sous forme de tableau
 
−
* Transférer les données reçues vers une base de données utilisant le protocole SIDS ( eg AMSAT-F, Satnogs, Picsat)
 
−
* sauvegarder les données dans des fichiers au fomat binaire ou au format json
 
  
−
==Téléchargement==
+
=== 1. Aperçu ===
  
−
Le logiciel est téléchargeable via les liens suivants :
+
KissTool est une application de bureau destinée aux opérations satellites amateurs. Elle capture les trames de télémétrie au format AX.25 à partir d'un ou plusieurs modems logiciels, décode les données satellitaires et les transmet aux bases de données mondiales SIDS (Satellite Information Distribution System).
−
+
 
−
* WINDOWS   [https://site.amsat-f.org/download/118784/?tmstv=1679352601 AMSATF-KisstoolWithJRE.zip]
+
==== Caractéristiques principales ====
−
* LINUX [https://site.amsat-f.org/download/118791/?tmstv=1680942313 AMSATF-KisstoolWithJRE.tgz]
+
 
 +
  * '''Support multi-modem''' — Connexion simultanée à plusieurs démodulateurs TCP KISS.
 +
  * '''Identification automatique des satellites''' — Reconnaît les satellites à partir des indicatifs AX.25.
 +
  * '''Décodeurs extensibles''' — Décodeurs de télémétrie spécifiques aux satellites chargés au moment de l'exécution via SPI.
 +
  * '''Rapports SIDS''' — Transfert automatique vers AMSAT-F, SatNogs et des points de terminaison personnalisés.
 +
  * '''Tableau de bord en direct''' — Surveillance en temps réel des modems, des satellites et des bases de données.
 +
  * '''Archivage des données''' — Sauvegarde des trames reçues sous forme de fichiers binaires bruts ou JSON.
 +
 
 +
=== 2. Prérequis ===
 +
 
 +
==== Matériel ====
 +
 
 +
  * Un récepteur radio capable de recevoir les signaux satellites.
 +
  * Une interface audio ou un SDR connecté au récepteur.
 +
 
 +
==== Logiciel ====
 +
 
 +
  * Un démodulateur fournissant une interface '''TCP KISS''', tel que [[http://uz7.ho.ua/packetradio.htm](http://uz7.ho.ua/packetradio.htm) UZ7HO SoundModem].
 +
   * Java 25 ou supérieur (inclus dans la distribution pré-packagée).
 +
 
 +
=== 3. Installation ===
 +
 
 +
==== Téléchargement ====
 +
 
 +
{| class="wikitable"
 +
\! Plateforme \!\! Lien
 +
|-
 +
| Windows || [[https://site.amsat-f.org/download/117659/](https://site.amsat-f.org/download/117659/) AMSATF-KisstoolWithJRE.zip]
 +
|-
 +
| Linux || [[https://site.amsat-f.org/download/117663/](https://site.amsat-f.org/download/117663/) AMSATF-KisstoolWithJRE.gz]
 +
|}
 +
 
 +
==== Windows ====
 +
 
 +
# Téléchargez le fichier ZIP.
 +
 
 +
# Faites un clic droit sur le fichier et sélectionnez '''Extraire tout...'''.
 +
 
 +
# Choisissez un répertoire de destination.
 +
 
 +
==== Linux ====
 +
 
 +
Extrayez l'archive depuis un terminal :
 +
\<syntaxhighlight lang="bash"\>
 +
tar -xzvf AMSATF-KisstoolWithJRE.gz
 +
\</syntaxhighlight\>
 +
 
 +
=== 4. Lancement de KissTool ===
 +
 
 +
Naviguez vers le répertoire où vous avez extrait le fichier téléchargé.
 +
 
 +
==== Windows ====
 +
 
 +
Double-cliquez sur \<code\>launchKISSTOOL.bat\</code\>, ou lancez-le depuis une invite de commande :
 +
 
 +
\<pre\>
 +
launchKISSTOOL.bat
 +
\</pre\>
 +
 
 +
==== Linux ====
 +
 
 +
Lancez le script de démarrage :
 +
\<syntaxhighlight lang="bash"\>
 +
./launchKISSTOOL.sh
 +
\</syntaxhighlight\>
 +
 
 +
=== 5. Interface de l'application ===
 +
 
 +
L'interface est organisée avec une '''barre d'en-tête''' en haut, un '''espace de travail à onglets''' au centre, et une '''barre d'état''' en bas.
 +
 
 +
==== 5.1 Barre d'en-tête ====
 +
 
 +
La barre d'en-tête permet de visualiser l'état général et les commandes principales :
 +
 
 +
{| class="wikitable"
 +
\! Élément \!\! Description
 +
|-
 +
| '''Modems: 0''' || Nombre de modems logiciels configurés.
 +
|-
 +
| '''DB Status''' || Trois cercles de couleur indiquant l'état des bases de données SIDS. Vert = en ligne, rouge = inaccessible, gris = désactivé.
 +
|-
 +
| '''RX''' || Nombre total de trames reçues depuis le dernier START.
 +
|-
 +
| '''To DB''' || Nombre total de trames transmises avec succès aux bases de données SIDS.
 +
|-
 +
| '''Sat''' || Nom du dernier satellite identifié.
 +
|-
 +
| '''START''' || Bouton vert — se connecte à tous les modems configurés.
 +
|-
 +
| '''Silence Mode''' || Case à cocher — réduit les logs à l'écran aux avertissements et erreurs uniquement.
 +
|}
 +
 
 +
=== 6. Onglet Configuration ===
 +
 
 +
L'onglet Configuration contient plusieurs sections repliables.
 +
 
 +
==== 6.1 Station & Location (Station et Position) ====
 +
 
 +
Ces valeurs identifient la station de réception pour les rapports SIDS.
 +
 
 +
{| class="wikitable"
 +
\! Champ \!\! Format \!\! Description
 +
|-
 +
| '''Callsign''' || Texte libre || Votre indicatif radioamateur. Ne peut être vide.
 +
|-
 +
| '''Latitude''' || \<code\>XX.XXN\</code\> ou \<code\>XX.XXS\</code\> || Exemple : \<code\>48.85N\</code\> pour Paris.
 +
|-
 +
| '''Longitude''' || \<code\>XX.XXE\</code\> ou \<code\>XX.XXW\</code\> || Exemple : \<code\>2.35E\</code\> pour Paris.
 +
|}
 +
 
 +
\<blockquote\>'''Note importante :''' Vous devez cliquer sur le bouton '''SAVE ALL CONFIGURATION''' pour enregistrer vos modifications de façon permanente.\</blockquote\>
 +
 
 +
=== 7. Dépannage ===
 +
 
 +
  * '''Connexion modem échouée :''' Vérifiez que le modem logiciel (ex: UZ7HO) est lancé avant de cliquer sur START.
 +
  * '''Pas de décodage :''' Vérifiez si un décodeur est présent pour ce satellite dans l'onglet SPI.
 +
  * '''Erreur SIDS :''' Vérifiez que votre indicatif et vos coordonnées respectent strictement le format (ex: lettre N/S/E/W obligatoire).
 +
 
 +
=== 8. Support ===
 +
 
 +
  * '''Forum :''' [[http://forum.amsat-f.org/forumdisplay.php?fid=36](http://forum.amsat-f.org/forumdisplay.php?fid=36) AMSAT-Francophone — Section KissTool]
 +
  * '''Code source :''' [[https://code.electrolab.fr/xtof/josast](https://code.electrolab.fr/xtof/josast) Dépôt JOSAST]
 +
 
 +
-----
 +
 
 +
''Licence : GNU Lesser General Public License v2.1''

Version actuelle datée du 18 avril 2026 à 17:02

Voici la version du manuel d'utilisation de KissTool au format **MediaWiki**, prête à être copiée sur un wiki.

Manuel d'utilisation de KissTool

Version 4.0.0 | JOSAST - Java Open Source Amateur Satellite Toolkit | AMSAT-Francophone

1. Aperçu

KissTool est une application de bureau destinée aux opérations satellites amateurs. Elle capture les trames de télémétrie au format AX.25 à partir d'un ou plusieurs modems logiciels, décode les données satellitaires et les transmet aux bases de données mondiales SIDS (Satellite Information Distribution System).

Caractéristiques principales

 * Support multi-modem — Connexion simultanée à plusieurs démodulateurs TCP KISS.
 * Identification automatique des satellites — Reconnaît les satellites à partir des indicatifs AX.25.
 * Décodeurs extensibles — Décodeurs de télémétrie spécifiques aux satellites chargés au moment de l'exécution via SPI.
 * Rapports SIDS — Transfert automatique vers AMSAT-F, SatNogs et des points de terminaison personnalisés.
 * Tableau de bord en direct — Surveillance en temps réel des modems, des satellites et des bases de données.
 * Archivage des données — Sauvegarde des trames reçues sous forme de fichiers binaires bruts ou JSON.

2. Prérequis

Matériel

 * Un récepteur radio capable de recevoir les signaux satellites.
 * Une interface audio ou un SDR connecté au récepteur.

Logiciel

 * Un démodulateur fournissant une interface TCP KISS, tel que [[1](http://uz7.ho.ua/packetradio.htm) UZ7HO SoundModem].
 * Java 25 ou supérieur (inclus dans la distribution pré-packagée).

3. Installation

Téléchargement

\! Plateforme \!\! Lien
Windows [[2](https://site.amsat-f.org/download/117659/) AMSATF-KisstoolWithJRE.zip]
Linux [[3](https://site.amsat-f.org/download/117663/) AMSATF-KisstoolWithJRE.gz]

Windows

  1. Téléchargez le fichier ZIP.
  1. Faites un clic droit sur le fichier et sélectionnez Extraire tout....
  1. Choisissez un répertoire de destination.

Linux

Extrayez l'archive depuis un terminal : \<syntaxhighlight lang="bash"\> tar -xzvf AMSATF-KisstoolWithJRE.gz \</syntaxhighlight\>

4. Lancement de KissTool

Naviguez vers le répertoire où vous avez extrait le fichier téléchargé.

Windows

Double-cliquez sur \<code\>launchKISSTOOL.bat\</code\>, ou lancez-le depuis une invite de commande :

\<pre\> launchKISSTOOL.bat \</pre\>

Linux

Lancez le script de démarrage : \<syntaxhighlight lang="bash"\> ./launchKISSTOOL.sh \</syntaxhighlight\>

5. Interface de l'application

L'interface est organisée avec une barre d'en-tête en haut, un espace de travail à onglets au centre, et une barre d'état en bas.

5.1 Barre d'en-tête

La barre d'en-tête permet de visualiser l'état général et les commandes principales :

\! Élément \!\! Description
Modems: 0 Nombre de modems logiciels configurés.
DB Status Trois cercles de couleur indiquant l'état des bases de données SIDS. Vert = en ligne, rouge = inaccessible, gris = désactivé.
RX Nombre total de trames reçues depuis le dernier START.
To DB Nombre total de trames transmises avec succès aux bases de données SIDS.
Sat Nom du dernier satellite identifié.
START Bouton vert — se connecte à tous les modems configurés.
Silence Mode Case à cocher — réduit les logs à l'écran aux avertissements et erreurs uniquement.

6. Onglet Configuration

L'onglet Configuration contient plusieurs sections repliables.

6.1 Station & Location (Station et Position)

Ces valeurs identifient la station de réception pour les rapports SIDS.

\! Champ \!\! Format \!\! Description
Callsign Texte libre Votre indicatif radioamateur. Ne peut être vide.
Latitude \<code\>XX.XXN\</code\> ou \<code\>XX.XXS\</code\> Exemple : \<code\>48.85N\</code\> pour Paris.
Longitude \<code\>XX.XXE\</code\> ou \<code\>XX.XXW\</code\> Exemple : \<code\>2.35E\</code\> pour Paris.

\<blockquote\>Note importante : Vous devez cliquer sur le bouton SAVE ALL CONFIGURATION pour enregistrer vos modifications de façon permanente.\</blockquote\>

7. Dépannage

 * Connexion modem échouée : Vérifiez que le modem logiciel (ex: UZ7HO) est lancé avant de cliquer sur START.
 * Pas de décodage : Vérifiez si un décodeur est présent pour ce satellite dans l'onglet SPI.
 * Erreur SIDS : Vérifiez que votre indicatif et vos coordonnées respectent strictement le format (ex: lettre N/S/E/W obligatoire).

8. Support

 * Forum : [[4](http://forum.amsat-f.org/forumdisplay.php?fid=36) AMSAT-Francophone — Section KissTool]
 * Code source : [[5](https://code.electrolab.fr/xtof/josast) Dépôt JOSAST]

Licence : GNU Lesser General Public License v2.1

Récupérée de « https://wiki.amsat-f.org/index.php?title=KissTool&oldid=92 »