DAPRS/README.md
2026-06-26 15:51:19 +02:00

93 lines
3.0 KiB
Markdown
Executable File
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 📡 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 :
FreeDMR/
---
## ⚙️ 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
```
par le chemin absolu vers votre fichier gps_data.py (ex: /home/user/FreeDMR/gps_data.py).
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/<br>
├── script/<br>
│ └── dashboard/ # Répertoire du tableau de bord<br>
├── gps_data.py # Script principal pour les données GPS<br>
├── gps_data.cfg # Configuration des données GPS<br>
├── dashboard_settings.py # Configuration du dashboard<br>
└── hbdaprs.service # Fichier de service systemd<br>
⚠️ 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.