# Arborisis Repeater Heltec V3 1.4.1 BE

Version candidate du 11 octobre 2026, issue du répéteur custom Arborisis et du
moteur MeshCore v1.17.1. Cible : Heltec WiFi LoRa 32 V3 (ESP32-S3 / SX1262).
Console USB et administration par le mesh depuis un autre compagnon ; pas de
connexion Bluetooth directe. Les commandes et l'administration MeshCore d'origine,
la calibration, le CAD et les régions sont conservés. Les ajouts Arborisis pour
l'observation USB, les sentinelles et leurs mises à jour par le mesh ne sont pas
inclus dans cette image ; leurs anciens fichiers de réglages restent sur la carte.

## Batterie externe USB

Le mode `powerbank` est activé par défaut, y compris lors de la migration des
anciens réglages Arborisis. Il bloque la veille du processeur, utilise 240 MHz,
maintient l'OLED allumé à contraste maximal et ajoute une charge CPU bornée à
1 ms par tour de boucle, suivie d'une restitution de 1 ms au système. Le relais
et la réception sont servis entre ces périodes. Il ne lance ni Wi-Fi ni Bluetooth
et n'ajoute aucun paquet LoRa pour maintenir l'alimentation.

Réglage depuis le menu PRG : **Batterie USB : maintien / éco**, ou par console :

```text
get powerbank
set powerbank on
set powerbank off
```

Le choix est sauvegardé dans `/arbo_repeater.json`, avec sauvegarde transactionnelle.
`off` rend la fréquence CPU à 80 MHz et rétablit les réglages d'écran et de veille.
Utiliser `off` sur une batterie LiPo ou une alimentation dont le mode faible courant
garantit déjà le maintien : `on` augmente la consommation et réduit l'autonomie.

Ce correctif logiciel vise les batteries qui coupent sous un faible courant.
Le seuil et le délai de coupure dépendent du modèle : le maintien **ne peut pas être
garanti sans mesure sur la batterie utilisée**. Si elle coupe encore, utiliser son
mode faible courant permanent ou un adaptateur de maintien de charge USB adapté.
Ne pas augmenter la puissance LoRa ni les annonces pour essayer de la maintenir.

## Profil Belgique

L'[IBPT B01-23](https://www.ibpt.be/file/cc73d96153bbd5448a56f19d925d05b1379c7f21/3a32bbf04a46bed4de560b2292819f29e685b70a/25-11-b-fr.pdf#page=21)
fixe 869,4–869,65 MHz, 500 mW p.a.r. et permet une limite de temps d'émission de
10 % comme alternative aux techniques d'accès. Ce firmware utilise cette limite ;
le CAD n'est pas présenté comme une conformité LBT/AFA.

- Défaut : 869,618 MHz, BW 62,5 kHz, SF8, CR 4/8.
- Canal nominal entièrement dans la bande ; paramètres hors bande refusés en USB,
  administration distante et `tempradio`. Les anciennes préférences sont corrigées.
- TX plafonné à 22 dBm conduits et limité selon le gain d'antenne déclaré. Cette
  image suppose 2,15 dBi et aucune perte de câble ; ajuster TX pour une autre antenne.
- Quota maximal de 360 s sur une heure glissante, tous paquets compris. Le menu
  propose 10 %, 5 %, 2 % et 1 %. Les commandes au-dessus de 10 % sont refusées.
- Réservation sauvegardée avant TX dans `/be-airtime-a` et `/be-airtime-b`, compatible
  avec les compagnons BE. Au redémarrage, la dette maximale reste conservée durant
  une heure d'activité, avec jusqu'à une minute de marge. Une dette illisible bloque
  TX ; un échec d'écriture conserve les paquets en attente, avec réception disponible.
- Le montage du stockage ne formate jamais automatiquement. Une identité présente
  mais illisible n'est pas remplacée. `clear stats` conserve la dette radio.

La marge nominale de 750 Hz au bord supérieur ne remplace pas une mesure du spectre.
Le logiciel ne constitue pas une certification RED/CE de l'ensemble carte/antenne.

## Installation

Téléchargements : [arborisis.com/firmwares#repeater](https://arborisis.com/firmwares#repeater).

Le `.bin` applicatif se programme à `0x10000` uniquement si la table des partitions
correspond et si app0 est le slot actif. Sauvegarder l'identité et les réglages avant
de quitter le firmware officiel. L'image complète `-merged.bin` à `0x0` sert à une
première installation ; elle remplace les partitions et peut effacer NVS.
Ne pas utiliser `erase_flash` pour une mise à jour. La table produite est fournie.
Sur une carte vierge, si la console affiche `Storage unavailable`, saisir
`INIT-EMPTY-STORAGE` à 115200 bauds pour créer le stockage puis redémarrer.
Cette commande efface le stockage : ne pas l'utiliser pour tenter de récupérer
une carte contenant une identité ou des données à préserver.

## Vérifications et limites

Tests du dispatcher réel avec ASan/UBSan, vérification des commandes et du stockage
de quota interrompu, tests natifs des réglages et calibration, et scénario du vrai
code OLED sur simulateur. Compilation ESP32-S3 et tailles de partitions contrôlées.
Le binaire est contrôlé pour conserver les points d'entrée d'administration
MeshCore et exclure les commandes d'observation et le moteur sentinelle.
Les captures viennent du simulateur. L'archive source et les SHA-256 correspondent
aux fichiers compilés.

Aucun appareil n'a été flashé pour cette version. Restent à vérifier sur matériel :
courant USB et maintien plusieurs heures sur la batterie choisie, température,
réception/relais sous charge, spectre et puissance avec l'antenne, conservation des
données et coupures pendant les écritures. Ces points sont signalés sur le site.