From 27a8aeccfbeb2c46bdd535bd3f83c2fdc4471a79 Mon Sep 17 00:00:00 2001 From: Xavier Date: Fri, 26 Jun 2026 15:51:19 +0200 Subject: [PATCH] Actualiser README.md --- README.md | 106 ++++++++++++++++++++++++++++++++++++++++++------------ 1 file changed, 84 insertions(+), 22 deletions(-) diff --git a/README.md b/README.md index 667214b..faf6531 100755 --- a/README.md +++ b/README.md @@ -1,30 +1,92 @@ -## DAPRS 1.0 +# 📡 DAPRS 1.0 + +## 📌 Description +**DAPRS** est un outil conçu pour intégrer des fonctionnalités **APRS (Automatic Packet Reporting System)** dans un environnement **FreeDMR**. Il permet d'afficher et de gérer des données GPS via un **tableau de bord (dashboard)** et un service dédié. + +--- + +## 🛠 Prérequis + Composant | Description | + |-------------------------|-----------------------------------------------------------------------------| + | **FreeDMR** | Doit être installé sur votre système. | + | **Python 3** | Requiert Python pour exécuter les scripts. | + | **Droits root** | Nécessaire pour installer et activer le service `hbdaprs`. | + | **systemd** | Gestionnaire de services Linux (pour `hbdaprs.service`). | + +--- + +## 🚀 Installation + +### 1️⃣ Placement des fichiers +1. **Répertoire `dashboard`** : + Copiez-le dans : + +FreeDMR/script/ +2. **Fichiers `gps_*`** : +Copiez **tous les fichiers** commençant par `gps_` (ex: `gps_data.py`, `gps_data.cfg`, etc.) dans le répertoire principal : -## Version en production 1.0 +FreeDMR/ -## 1.0 +--- + +## ⚙️ Configuration + +### 1️⃣ Fichiers de configuration +Les fichiers suivants doivent être **édités** pour correspondre à votre environnement : +- **`gps_data.cfg`** : Paramètres de configuration des données GPS. +- **`dashboard_settings.py`** : Paramètres du tableau de bord (ex: couleurs, affichage, etc.). + +--- + +### 2️⃣ Service systemd (`hbdaprs.service`) +1. **Modifier le chemin** : +Ouvrez le fichier `hbdaprs.service` et remplacez : +```ini +ExecStart=/opt/FreeDMR/gps_data.py +``` -placer:
-le répertoire dashboard dans FreeDMR/script
-puis les fichiers:
-tout les fichier gps_* dans FreeDMR
- -les fichier de config sont:
-gps_data.cfg
-dashboard_settings.py

-puis éditer fichier pour le service hbdaprs.service
-changer
-/opt/FreeDMR/gps_data.py par votre chemin
-puis copier le fichier hbdaprs.service
-dans
-/lib/systemd/system
-puis
-sudo systemctl enable hbdaprs.service -

+par le chemin absolu vers votre fichier gps_data.py (ex: /home/user/FreeDMR/gps_data.py). -73 -Xavier \ No newline at end of file +Copier le fichier de service : +```bash +sudo cp hbdaprs.service /lib/systemd/system/ +``` + +Activer le service : +```bash +sudo systemctl enable hbdaprs.service +``` + +Démarrer le service (optionnel) : +```bash +sudo systemctl start hbdaprs.service +``` + +Vérifier le statut : +```bash +sudo systemctl status hbdaprs.service +``` + +📁 Structure du projet + +FreeDMR/
+├── script/
+│ └── dashboard/ # Répertoire du tableau de bord
+├── gps_data.py # Script principal pour les données GPS
+├── gps_data.cfg # Configuration des données GPS
+├── dashboard_settings.py # Configuration du dashboard
+└── hbdaprs.service # Fichier de service systemd
+ + +⚠️ Limitations + +Chemin absolu obligatoire : Le fichier hbdaprs.service doit pointer vers le bon chemin de gps_data.py. +Compatibilité : Testé avec FreeDMR et les systèmes utilisant systemd (Debian/Ubuntu, Raspberry Pi OS, etc.). +Droits : Assurez-vous que l'utilisateur exécutant le service a les permissions nécessaires pour accéder aux fichiers et répertoires. + +📜 Licence +Ce projet est sous licence MIT. Vous êtes libre de l'utiliser, le modifier et le distribuer.