# 6. Préparation de la carte SD

La carte SD est optionnelle mais fortement recommandée pour les cartes et la persistance des données.

**Format requis : FAT32**

---

## Structure des dossiers

```
/LoRa_Tracker/
├── config.json          ← Configuration de l'appareil
├── stats.json           ← Statistiques des stations
├── MapTiles/            ← Tuiles raster (JPEG/PNG)
│   └── REGION/
│       └── Z8/
│           └── X/
│               └── Y.jpg
├── VectMaps/            ← Tuiles vectorielles (NAV)
│   └── REGION/
│       ├── Z9.nav
│       ├── Z10.nav
│       └── ...
└── GPX/                 ← Traces enregistrées
    └── track_YYYYMMDD_HHMMSS.gpx
```

---

## Tuiles raster (JPEG/PNG)

Les tuiles raster sont des images OpenStreetMap standard (format XYZ/TMS). Elles s'affichent pour les niveaux de zoom faibles (Z6 à Z8).

### Méthode 1 : Interface graphique avec MOBAC (Mobile Atlas Creator)
C'est la méthode la plus simple. Utilisez **[MOBAC](https://mobac.sourceforge.io/)** :

1. Lancer MOBAC et sélectionner la source : **OpenStreetMap Mapnik**
2. Sélectionner la zone géographique souhaitée sur la carte avec la souris
3. Cocher les niveaux de zoom : **6, 7, 8** si vous envisagez l'utilisation des tuiles vectorielles et ajoutez **10, 12, 14** si vous utilsez exclusivement les tuiles raster (bitmap/image)
4. Choisir le format de sortie : **OSMTracker tile storage**
5. Cliquer sur **Create atlas**
6. Copier le contenu du dossier généré vers la carte SD : `/LoRa_Tracker/MapTiles/VOTRE_REGION/`

Pour les heureux utilisateurs Linux, vous pouvez vous servir du programme de copie de masse de **JGauchia masscopy** situé dans `tools/mass_copy/`

### Méthode 2 : Ligne de commande avec Python (Avancée)
Le code source du projet inclut un script prêt à l'emploi. Nécessite Python installé sur votre machine.

Ouvrez un terminal dans le dossier du code source :
```bash
cd tools/
# Télécharger les tuiles pour l'Île-de-France (niveaux 6, 7, 8)
python download_tiles.py --region IDF --zoom 6,7,8

# Voir la liste des régions préconfigurées (France)
python download_tiles.py --list
```
*Le script créera un dossier `output_dir/` qu'il suffira de copier sur votre carte SD.*

### Nommage des fichiers
```
/LoRa_Tracker/MapTiles/FRANCE/Z8/X/Y.jpg
```

---

## Tuiles vectorielles (NAV)

Les tuiles NAV offrent un rendu plus détaillé à haut zoom (Z9+). Elles sont issues du travail de JGauchia [IceNav-v3](https://github.com/jgauchia/IceNav-v3).

### Génération
Les fichiers `.nav` se génèrent depuis des données OpenStreetMap avec l'outil de conversion [Tile-Generator](https://github.com/moricef/Tile-Generator/tree/devel_pack).
```
/LoRa_Tracker/VectMaps/FRANCE_SUD/Z9.nav
/LoRa_Tracker/VectMaps/FRANCE_SUD/Z10.nav
...
/LoRa_Tracker/VectMaps/FRANCE_SUD/Z15.nav
```

> Un seul fichier `.nav` par niveau de zoom et par région.

---

## Fonts ou Polices

Le dossier Fonts est nécessire pour afficher les labels des lieux et cours d'eau sur les tuiles vectorielles.

Il se télécharge ici : [drive.proton.me](https://drive.proton.me/urls/0XNF9NTB80#YnaYhRwwFNg6) Mot de passe: F4MLV
Il suffit de le placer sur la carte SD dans le dossier LoRa_Tracker/

---

## Symbols APRS

Le dossier Symbols est nécessire pour afficher les icônes APRS sur la carte
Il se télécharge ici : [drive.proton.me](https://drive.proton.me/urls/4981A66GT0#gXYCCcbvrpgd) Mot de passe: F4MLV
Il suffit de le placer sur la carte SD dans le dossier LoRa_Tracker/

---

## Sans carte SD

Le tracker fonctionne sans SD card avec des fonctionnalités réduites :

| Fonction | Sans SD |
|----------|---------|
| Carte raster | Fond gris uniquement |
| Carte vectorielle | Non disponible |
| Symboles APRS sur carte | Cercles rouges |
| Messages | Non persistants (perdus au reboot) |
| Stats stations | Non persistantes |
| Traces GPX | Non disponibles |
| Configuration | Sauvegardée en flash interne |