| Name | Modified | Size | Downloads / Week |
|---|---|---|---|
| Heltec V4 | 2026-10-31 | ||
| Heltec V3 | 2026-10-31 | ||
| esp-flasher.html | 2026-11-12 | 349.1 kB | |
| README-clavier-4x3.md | 2026-10-31 | 12.5 kB | |
| THIRD-PARTY-NOTICES.md | 2026-10-31 | 4.8 kB | |
| TOPO.md | 2026-10-31 | 5.4 kB | |
| LICENSE | 2026-10-31 | 2.5 kB | |
| README.md | 2026-10-31 | 4.9 kB | |
| Totals: 8 Items | 379.2 kB | 0 |
Terminal MeshCore autonome – Heltec V4 + clavier 4x3
Ce patch reprend, dans le firmware companion MeshCore v1.18.0 (commit 81dbae5), l'interface de l'ancien terminal (ESP32 + clavier + OLED + Heltec companion). Le Heltec V4 seul fait tout : plus d'ESP32 séparé, plus de liaison série. L'interface comprend :
- l'écran de conversation comme écran principal ;
- plusieurs conversations (canaux et contacts), avec historique et défilement ;
- la saisie T9 multi-tap, avec accents ;
- l'envoi direct et l'accusé de réception ;
- un menu : contacts, canaux, advert, infos radio, effacement, pages d'état.
Le boîtier reste utilisable comme companion USB avec l'appli.
Câblage (7 fils, broches libres des connecteurs J2/J3)
| Clavier | GPIO | Connecteur |
|---|---|---|
| Ligne 1 (1 2 3) | 33 | J2-12 |
| Ligne 2 (4 5 6) | 47 | J2-13 |
| Ligne 3 (7 8 9) | 48 | J2-14 |
| Ligne 4 (* 0 #) | 6 | J3-17 |
| Colonne 1 (1 4 7 *) | 3 | J3-14 |
| Colonne 2 (2 5 8 0) | 4 | J3-15 |
| Colonne 3 (3 6 9 #) | 44 (RX) | J2-5 |
| Colonne 4 (A B C D), clavier 4x4 seulement | 43 (TX) | J2-6 |
Pas de résistance : les pull-up internes sont activées. Le GNSS, le LoRa et l'OLED ne sont pas touchés.
L'ordre des broches d'un clavier 4x3 varie : vérifie-le à l'ohmmètre, ou change les GPIO dans
platformio.ini (-D KEYPAD_R1=.. -D KEYPAD_R4=.. -D KEYPAD_C1=.. -D KEYPAD_C3=..).
Clavier 4x3 ou 4x4 : même firmware. La colonne A B C D (GPIO 43) est toujours lue ; avec un 4x3, rien n'y est câblé et elle reste inactive. Avec un 4x4, A B C D sont des raccourcis (doublons des commandes existantes) :
| Touche | Écran de conversation | Menus, listes, paramètres, radio | Pages d'état |
|---|---|---|---|
| A | Menu | Retour | Retour au chat |
| B (maintenu = continu) | Remonter l'historique | Monter | Page précédente |
| C (maintenu = continu) | Redescendre | Descendre | Page suivante |
| D | Conversation suivante (long : précédente) | OK | Action de la page |
Dans l'éditeur de nom et la saisie de fréquence : A = annuler, D = OK.
Principe des touches
Chaque touche agit au relâchement (appui court) ou après 0,8 s (appui long), jamais les deux. Maintenir 2 ou 8 fait défiler en continu.
Écran de conversation (écran principal)
Quand le GPS est allumé (Menu → Paramètres), une ligne en haut affiche l'heure locale et la position
(08:58 46.9901 3.1590), ou le nombre de satellites tant qu'il n'y a pas de fix (08:58 GPS: 7 sat).
Elle prend la place d'une ligne d'historique (3 au lieu de 4).
#Public +1 Abc <- conversation, non lus ailleurs, mode de saisie
-------------------------
Paul: Salut, ça va ? ↑ <- 4 lignes d'historique
moi√ oui et toi ?
... ↓
-------------------------
> Bonjour à tous_ <- saisie en cours
| Touche | Appui court | Appui long |
|---|---|---|
| 0 à 9 | Saisie T9 | 2 / 8 (maintenu) : remonter / redescendre dans l'historique · 4 / 6 : conversation précédente / suivante · 5 : contacts (nouvelle conversation privée) |
# |
Envoyer | Effacer toute la saisie |
* |
Effacer un caractère | Mode abc → Abc → ABC → 123 |
| PRG | Clic : conversation suivante · double-clic : précédente | Menu |
T9 (lettres validées après 0,9 s ou en passant à une autre touche) :
| 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 0 |
|---|---|---|---|---|---|---|---|---|---|
.,?!'-:;@/()1 |
abc2àâç | def3éèêë | ghi4îï | jkl5 | mno6ô | pqrs7 | tuv8ùû | wxyz9 | espace 0 |
- Messages envoyés :
moi> texte.moi√ texte= accusé reçu (messages privés uniquement). - Messages de canal :
Nom: texte. Messages privés : le texte seul (le nom est dans le titre). - Un message arrivé ailleurs affiche « Msg Nom » et incrémente le
+Ndu titre. Écran éteint et saisie vide, le terminal bascule directement sur la conversation du message. - Conversations : tous les canaux configurés, plus les contacts, jusqu'à 24 conversations de 40 lignes chacune (la conversation privée la plus ancienne est recyclée).
Sauvegarde en flash
L'historique est gardé dans la flash (SPIFFS, le même système de fichiers que les contacts et réglages MeshCore) :
- un fichier par conversation (
/kpc_00à/kpc_23, moins de 1 Ko chacun) et/kpc_stpour la conversation ouverte ; - écriture 10 s après la dernière modification (60 s au plus), et seulement des conversations modifiées ;
- écriture forcée avant l'hibernation et avant l'arrêt sur batterie faible ;
- au démarrage, on retrouve conversations, non lus, accusés
√et la conversation qui était ouverte.
Un redémarrage brutal (RST, coupure, reboot depuis l'appli) peut perdre les 10 dernières secondes. Un fichier abîmé par une coupure pendant l'écriture est ignoré et supprimé au démarrage suivant.
Menu (PRG long)
2 / 8 ou clic / double-clic PRG pour se déplacer ; 5, # ou PRG long pour choisir ; * pour revenir.
- Contacts (privé) : liste triée (favoris
*d'abord, puis par nom), répéteurs exclus. 4 / 6 = page, appui long 2 à 9 = saut au nom commençant par une lettre de la touche. - Canaux : ouvrir la conversation d'un canal.
- Nœuds entendus : les 16 derniers nœuds dont un advert a été reçu, le plus récent en haut, avec
leur type (C chat, R répéteur, S salon, T capteur) et l'âge de l'advert.
+= pas encore en contacts :#(ou 5 / PRG long) l'ajoute, un second#ouvre la conversation. - Advert voisins : annonce le module aux voisins directs (zéro saut).
- Advert réseau : annonce le module à tout le réseau (relayé par les répéteurs), pour que les autres puissent t'ajouter.
- Infos radio / GPS : nom, fréquence, SF, BW, CR, puissance, bruit, batterie, nombre de contacts, état du GPS ou position et altitude.
- Paramètres (2 / 8 pour choisir, 5 ou
#pour changer, 4 / 6 pour le fuseau) : - Nom : nom du module, celui que voient les autres (adverts, et
Nom: textedevant tes messages de canal). Choisir ouvre un éditeur T9 (mêmes touches que le chat ;#ou PRG long = enregistrer, PRG double-clic = annuler). 31 octets au plus, accents compris ; un advert part aussitôt pour annoncer le nouveau nom. (« moi » n'est que l'étiquette locale de tes messages dans l'historique.) - Radio : écran de réglage LoRa (voir « Radio » plus bas).
- Ajout auto : Oui (défaut MeshCore) = tout nœud entendu devient contact ; Non = on choisit dans « Nœuds entendus » (les règles par type réglées dans l'appli s'appliquent alors).
- GPS : Oui / Non (Non par défaut, pour économiser la batterie ; « absent » sans module) ;
- Position adverts : Oui / Non — joint la position du module à ses adverts (dernier fix connu si le GPS est éteint) ;
- Fuseau : UTC+1 par défaut ;
- Heure d'été UE : Oui par défaut (bascule automatique fin mars / fin octobre). En bas de l'écran : date et heure locales, pour vérifier.
- Effacer conversation : vide l'historique de la conversation affichée.
- Effacer tout : vide tout l'historique, en RAM et en flash (valider deux fois en moins de 3 s).
- Pages d'état : pages MeshCore d'origine (récents, radio, advert, GPS, découverte, hibernation).
Elles se manipulent au PRG ou avec 4 / 6 / 5 ;
#long = Select (découverte) ;*= retour au chat.
Radio (Paramètres → Radio)
Les paramètres LoRa ne sont pas verrouillés : ils sont modifiables depuis l'appli et maintenant depuis le clavier.
Valeurs par défaut du firmware (préférences effacées) : 869,618 MHz, BW 62,5 kHz, SF8, CR 4/5 (défaut MeshCore,
platformio.ini racine), consigne TX 10 dBm (≈ 22 dBm à l'antenne avec l'ampli du V4, d'après Heltec).
| Ligne | Commandes |
|---|---|
| Préréglage | 4 / 6 : « Actuel » (valeurs enregistrées) ↔ « Défaut MeshCore » |
| Fréquence | 4 / 6 : ±1 kHz ; 5 ou # : saisie en kHz (ex. 869618), # = OK, * = effacer |
| BW | 4 / 6 : 7,8 … 62,5 / 125 / 250 / 500 kHz |
| SF / CR / TX | 4 / 6 : SF 5-12, CR 4/5-4/8, TX −9 à 22 dBm (consigne du SX1262) |
| Appliquer | 5 ou # deux fois en moins de 4 s ; « HORS 863-870! » si la fréquence sort de la bande |
Rien n'est envoyé à la radio avant « Appliquer » ; * quitte sans rien changer. Les réglages doivent être ceux
de ton réseau local : un mauvais réglage coupe le module du maillage.
GPS
- Module GNSS sur le connecteur du V4 (GPIO 38/39, alimentation GPIO 34, reset GPIO 42), détecté au démarrage.
- Une fois le fix obtenu, le GPS met aussi l'horloge du nœud à l'heure (UTC). C'est ce qui date correctement les messages sans téléphone.
- Mise à l'heure « faible » (un seul satellite, sans position) : dès que le récepteur a décodé l'heure GPS,
il la met dans ses trames, même sans fix. Le terminal l'accepte si l'horloge n'a jamais été réglée, si la date
est plausible (2026-2045) et si 5 trames d'affilée avancent d'une seconde. L'heure s'affiche alors
~08:58. Erreur : moins de 0,1 s, voire quelques secondes tant que le récepteur n'a pas reçu la correction de secondes intercalaires. Le premier vrai fix remet l'heure exacte (puis toutes les 30 min). - Après une coupure de courant, l'horloge de l'ESP32 repart au 1er mars 2026 : elle est considérée non réglée
(
--:--) jusqu'à la mise à l'heure par le GPS ou l'appli. - L'état du GPS et le partage de position sont des réglages MeshCore (enregistrés avec les préférences du nœud) ;
le fuseau et l'heure d'été sont dans
/kpc_cfg. - L'advert (menu ou page d'état) part en zéro saut : seuls les voisins directs le reçoivent.
Ce qui a été retiré ou masqué
- Version USB : pas de Bluetooth ni de Wi-Fi compilés ; la page Bluetooth est masquée.
- L'écran d'aperçu des messages d'origine est remplacé par les conversations.
Limites
- Firmware non encore compilé pour l'ESP32 ni testé sur carte. Le code passe la vérification syntaxique ; le chat, la liste, le pilote clavier et la sauvegarde/relecture en flash ont été testés en simulation.
- Une seule tentative d'envoi (l'appli, elle, réessaie).
- Les messages envoyés depuis le clavier n'apparaissent pas dans l'historique de l'appli.
- « Nœuds entendus » ne garde que les adverts reçus depuis le démarrage (liste en RAM, 16 nœuds).
- Les émojis s'affichent
?. Les majuscules accentuées sans glyphe CP437 (À, È…) s'affichent sans accent. - Dans les 8 s après le démarrage, PRG long ouvre le mode de secours CLI (comportement d'origine).
Heltec V3 (sans GPS)
Même terminal, même firmware source, environnement Heltec_v3_companion_radio_usb_keypad
(ou Heltec_v3_companion_radio_ble_keypad). Le GPS est retiré à la compilation : pas de ligne GPS, pas de
réglage GPS ; l'heure vient de l'appli. Le câblage change, car le V3 utilise les GPIO 43/44 pour sa puce
USB-série et réserve 47/48/26 au GPS :
| Clavier | GPIO Heltec V3 | Connecteur |
|---|---|---|
| Ligne 1 (1 2 3 A) | 4 | J3 |
| Ligne 2 (4 5 6 B) | 5 | J3 |
| Ligne 3 (7 8 9 C) | 6 | J3 |
| Ligne 4 (* 0 # D) | 7 | J3 |
| Colonne 1 | 2 | J3 |
| Colonne 2 | 3 | J3 |
| Colonne 3 | 38 | J3 |
| Colonne 4 (4x4 seulement) | 39 | J3 |
pio run -e Heltec_v3_companion_radio_usb_keypad -t upload # ou -t mergebin
Flash de 8 Mo, données (contacts, canaux, réglages) en SPIFFS à 0x670000 : firmware.bin à 0x10000 les conserve.
Puissance par défaut du V3 : 22 dBm (SX1262 sans amplificateur externe).
Compilation et flash (Linux)
python3 -m venv ~/pio && source ~/pio/bin/activate && pip install platformio
git clone https://github.com/meshcore-dev/MeshCore.git && cd MeshCore
git checkout 81dbae5
git apply meshcore-v1.18.0-heltec_v4-keypad4x3.patch
pio run -e heltec_v4_companion_radio_usb_keypad -t upload # compile + flashe
pio run -e heltec_v4_companion_radio_usb_keypad -t mergebin # produit firmware(-merged).bin
firmware.bin: mise à jour, à écrire à 0x10000.firmware-merged.bin: carte vierge, à écrire à 0x0 ou via https://flasher.meshcore.io (Custom firmware).
Variante Bluetooth : -e heltec_v4_companion_radio_ble_keypad.
Réglages : KP_MAX_CONVS (24, 32 au plus), KP_HIST_LINES (40), KP_SAVE_DELAY_MS (10000),
KP_SAVE_MAX_MS (60000), KP_NO_PERSIST (désactive la sauvegarde), KEYPAD_MULTITAP_MS (900),
AUTO_OFF_MILLIS (60000).