initial commit site meshero.fr with hugo

This commit is contained in:
anael committed 2026-11-15 15:47:03 +01:00
commit 26073b413e
32 files changed
+1348

No files matched your search

+27
View File
@@ -0,0 +1,27 @@
---
title: "Documentation"
cascade:
type: docs
---
Retrouvez dans cette section les diverses documentations autour de MeshCore.
## Pour commencer
{{< cards cols="1" >}}
{{< card link="meshcore" title="Introduction à MeshCore" icon="book-open" subtitle="Les bases : principe, rôles, routage et réglages radio en France." >}}
{{< /cards >}}
## Les trois rôles
{{< cards >}}
{{< card link="companion" title="Companion" icon="user" subtitle="Votre appareil personnel pour envoyer et recevoir des messages." >}}
{{< card link="repeater" title="Repeater" icon="status-online" subtitle="Le nœud fixe qui étend la couverture du réseau." >}}
{{< card link="room-server" title="Room Server" icon="annotation" subtitle="Un espace de messages partagé, façon forum." >}}
{{< /cards >}}
## Gestion des mises à jour
{{< cards cols="1" >}}
{{< card link="ota_update" title="Over The Air updater" icon="tabler:file-signal" subtitle="Mettez à jour vos équipements à distance via Bluetooth" >}}
{{< /cards >}}
+90
View File
@@ -0,0 +1,90 @@
---
title: "Companion"
description: "Le Companion : votre appareil personnel pour envoyer et recevoir des messages MeshCore."
date: '2026-10-23T16:00:00+02:00'
weight: 2
cascade:
type: docs
---
Le **Companion** est le rôle que tout le monde utilise en premier : c'est votre appareil personnel, celui que vous emportez avec vous. \
Il vous sert à émettre et à recevoir des messages, et il se pilote depuis un téléphone, un navigateur web ou encore en mode « standalone ».
## Ce qu'il fait (et ne fait pas)
- Il **envoie et reçoit** vos messages, privés ou sur des canaux.
- Il **ne relaie pas** le trafic des autres : seuls les [répéteurs](/documentation/repeater/) portent les messages sur le réseau.
- Il ne s'annonce que lorsque **vous le décidez** (voir « Advert » plus bas).
Un companion tout seul ne fait donc pas un réseau : il a besoin d'autres companions à portée directe, ou d'au moins un répéteur à portée.
## Les deux variantes de firmware/connexion
| Variante | Connexion | Usage |
|---|---|---|
| **BLE Companion** | Bluetooth | La plus courante : appairage avec l'application sur smartphone |
| **USB Companion** | Câble USB | Connexion filaire à un ordinateur ou serveur |
## Ce qu'il vous faut
1. **Un appareil LoRa compatible** avec le firmware Companion. Certains sont vendus préinstallés, comme le [Wio Tracker L1 Pro](/materiel/wio-tracker-l1-pro/) que j'utilise.
2. **Une application** :
- l'application MeshCore ([android meshcore open](https://github.com/zjs81/meshcore-open) / [android meshcore](https://play.google.com/store/apps/details?id=com.liamcottle.meshcore.android&hl=en) ou [meshcore iOS](https://apps.apple.com/fr/app/meshcore/id6742354151)) ;
- le client web [app.meshcore.nz](https://app.meshcore.nz) ;
- des clients tiers existent également (par exemple [mishmesh](https://github.com/burakcan/MeshCore-mishmesh), un firmware qui permet de l'utiliser en mode « standalone »).
## Première mise en route
{{% steps %}}
### Installer le firmware (si besoin)
Avec le [flasher officiel](https://flasher.meshcore.io/), choisissez votre modèle d'appareil et la variante **Companion**. Si votre appareil est livré avec MeshCore, il est fort possible qu'il faille mettre à jour le firmware préinstallé.
### Appairer l'appareil
Activez le Bluetooth sur votre smartphone, ouvrez l'application MeshCore et sélectionnez l'appareil.
### Choisir un nom et régler la radio
Donnez un nom à votre companion, puis appliquez le preset **EU/UK (Narrow)** (869,618 MHz, BW 62,5 kHz, SF8, CR8).
### Envoyer un advert
Utilisez l'icône de signal de l'application pour vous annoncer. Les nœuds à portée apparaissent dans votre liste de contacts, et vous apparaissez dans la leur.
{{% /steps %}}
## Advert : comment on se découvre
Un **advert** est un paquet par lequel un nœud annonce sa présence. Pour un companion, il part uniquement à votre demande. On distingue :
- l'advert **local** (*zero-hop*), entendu seulement par les nœuds directement à portée ;
- l'advert **diffusé** (*flood*), relayé par les répéteurs sur tout le réseau.
Vous voyez les répéteurs et autres nœuds parce qu'eux s'annoncent régulièrement.
> [!TIP]
> Pour être vu des autres, **pensez à envoyer un advert !**
## Contacts et canaux
- **Messages privés** : ils vont d'un contact à un autre et sont chiffrés de votre appareil à celui de votre contact. Ils sont limités à 150 caractères.
- **Canaux** : le canal **Public** et les canaux **#hashtag** (par exemple `#test`) sont ouverts à toute personne qui connaît leur nom. Évitez d'y écrire des informations sensibles.
- **Canaux privés** : ils reposent sur une clé partagée entre les membres du groupe.
## GPS et carte
Si votre appareil a un GPS, vous pouvez partager votre position avec vos contacts.
> [!CAUTION]
> Une position partagée est visible de ceux qui la reçoivent.
## Administrer un répéteur ou un room server
Depuis le companion, vous pouvez vous connecter à un [répéteur](/documentation/repeater/) ou à un [room server](/documentation/room-server/) à distance, par radio, avec son mot de passe, et en modifier les réglages.
## Bon à savoir
- Même appareil, un seul rôle à la fois : changer de rôle implique de reflasher.
- Si la portée de votre companion est faible, vérifiez l'antenne et son emplacement avant tout autre réglage.
- Un companion reçoit surtout via les répéteurs : regardez la [carte des répéteurs](/repeteurs) pour voir ce qui couvre votre zone.
- Il est possible de mettre à jour votre companion directement via Bluetooth.
+82
View File
@@ -0,0 +1,82 @@
---
title: "Introduction à MeshCore"
description: "Comprendre MeshCore en quelques minutes : principe, rôles, routage et réglages radio en France."
date: '2026-10-23T14:22:43+02:00'
weight: 1
cascade:
type: docs
---
## C'est quoi MeshCore ?
MeshCore permet d'échanger des messages texte sans internet ni réseau mobile, en s'appuyant sur un réseau maillé (*mesh*).\
C'est un réseau communautaire où chacun participe à sa construction.\
À l'inverse du réseau mobile, avec lequel vous envoyez des SMS et dont les antennes sont ajoutées et maintenues par les opérateurs télécom qui vous facturent un abonnement.
Ici, vous achetez votre matos, il est à vous et vous ne payez pas d'abonnement. Vous pouvez meme participer à sa construction.
## Cas d'utilisation
- **Événements de masse** : si vous êtes déjà allé à un « gros » festival par exemple, vous connaissez le problème du « trop de monde, pas de réseau ».
- **Activités extérieures** : randonnée/trail en zone blanche.
- **Catastrophes naturelles** : séisme, inondation, incendie. Les infrastructures télécom ne fonctionnent plus.
- **Expérimentation technique** : juste s'amuser avec la technologie.
Pour l'utiliser, il faut :
- un **appareil compatible** (Heltec, RAK, LilyGo, Seeed…) sur lequel on installe MeshCore
- une **application** sur smartphone pour écrire et lire les messages. Par exemple [meshcore google playstore](https://play.google.com/store/apps/details?id=com.liamcottle.meshcore.android&hl=en) ou [meshcore-open github](https://github.com/zjs81/meshcore-open) ou encore [meshcore iOS](https://apps.apple.com/fr/app/meshcore/id6742354151) ou le client [web](https://app.meshcore.nz/).
## Les trois rôles
Contrairement à d'autres réseaux mesh où tous les nœuds se valent, MeshCore distingue des rôles précis, chacun avec son propre comportement. Cliquez sur une tuile pour voir la page détaillée.
{{< cards >}}
{{< card link="/documentation/companion/" title="Companion" icon="user" subtitle="Votre appareil personnel. Il se connecte à l'application (Bluetooth ou USB) pour envoyer et recevoir des messages. Il ne relaie pas le trafic des autres." >}}
{{< card link="/documentation/repeater/" title="Repeater" icon="status-online" subtitle="Un nœud fixe, placé idéalement en hauteur, qui retransmet les messages pour étendre la couverture. C'est l'infrastructure du réseau." >}}
{{< card link="/documentation/room-server/" title="Room Server" icon="annotation" subtitle="Une sorte de place publique : les clients s'y connectent pour déposer et relire des messages partagés sur le salon." >}}
{{< /cards >}}
La conséquence pratique est importante : **la couverture du réseau dépend surtout du placement des répéteurs**, pas du nombre de companions.
## Comment circule un message ?
MeshCore utilise un routage hybride :
1. Le **premier message** vers un destinataire est diffusé (*flood*) via les répéteurs pour découvrir un chemin.
2. Le chemin emprunté est mémorisé.
3. Les messages suivants sont envoyés **le long de ce chemin connu**, sans être rediffusés partout.
4. Si le chemin ne fonctionne plus, le réseau retombe sur la diffusion.
Résultat : moins d'occupation du canal radio, ce qui compte beaucoup sur une bande partagée et limitée en temps d'émission.
> [!NOTE]
> Le chemin peut être défini manuellement.
## Réglages radio en France
La communauté française utilise le preset **EU/UK (Narrow)** :
| Paramètre | Valeur |
|---|---|
| Fréquence | 869,618 MHz |
| Bande passante | 62,5 kHz |
| Spreading Factor | SF8 |
| Coding Rate | CR8 |
La bande 868 MHz est partagée et soumise à des règles (puissance, temps d'émission). Le réseau est commun : un mauvais réglage gêne les autres utilisateurs.
## Outils utiles
| Besoin | Adresse |
|---|---|
| Installer un firmware | [flasher.meshcore.io](https://flasher.meshcore.io) |
| Configurer un répéteur par USB | [config.meshcore.io](https://config.meshcore.io) |
| Documentation technique | [docs.meshcore.io](https://docs.meshcore.io) |
| Carte des nœuds | [map.meshcore.io](https://map.meshcore.io) |
| Informations France | [meshcore.fr](https://meshcore.fr) |
## Pour aller plus loin
- Voir [les répéteurs](/repeteurs/) sur la carte.
- Lire mes [tests de matériel](/materiel/).
+104
View File
@@ -0,0 +1,104 @@
---
date: '2026-10-24T14:20:58+02:00'
title: 'OTA Update'
weight: 5
cascade:
type: docs
---
# Comment mettre à jour mon équipement à distance ?
Une fois qu'on a flashé le firmware de notre companion, répéteur ou room server, vous allez vous poser la question :
**Mais comment met-on à jour à distance ?**
Cela se passe en 2 étapes :
1. Installer un bootloader alternatif pour faciliter l'installation des futures mises à jour.
2. Installer la mise à jour, lors de sa sortie, via Bluetooth.
> [!NOTE]
> Forcément, si vous venez de flasher votre équipement avec la dernière version de MeshCore, vous n'avez pas de mise à jour à appliquer.
> Cela vous aidera lorsque les prochaines versions sortiront.
# Prérequis
* Avoir un appareil MeshCore
* Un câble USB pour connecter votre équipement à votre ordinateur
# C'est parti !
1. Mettre votre équipement en mode UF2 DFU
> [!NOTE]
> Pour la plupart des équipements, il suffit de :
> 1. Brancher votre appareil à votre ordinateur
> 2. Appuyer rapidement deux fois sur le bouton reset (en moins de 0,5 seconde)
> 3. Un lecteur USB va alors apparaître sur votre PC
> [!TIP]
> Certains équipements entrent dans ce mode d'une façon différente.\
> Par exemple, pour le T1000E, il faut débrancher et rebrancher rapidement le câble USB.
![landscape](/images/dfu-mode2.gif)
> [!IMPORTANT]
> Si vous avez un PC sous Windows, n'oubliez pas d'installer les pilotes.
2. Vérifier la version actuellement installée (optionnel)
- Entrez en mode UF2 DFU (voir précédemment)
- Ouvrez le fichier INFO_UF2.TXT avec votre éditeur de texte
> [!NOTE]
> Celui-ci contient des informations sur votre firmware actuel.
3. Télécharger le bootloader OTAFix
- Aller sur le [flasher MeshCore](https://flasher.meshcore.io)
- Sélectionner votre appareil
- Sélectionner votre rôle (companion ou répéteur)
- Un lien de téléchargement du bootloader va apparaître en violet
Vous pouvez le télécharger directement : le fichier s'appelle « update-xxxx.uf2 ».
> [!TIP]
> Vous pouvez aussi récupérer la release sur le [GitHub](https://github.com/oltaco/Adafruit_nRF52_Bootloader_OTAFIX/releases).
4. Installation du bootloader
Faites glisser-déposer le fichier « update-xxxx.uf2 » dans le lecteur UF2 DFU de votre équipement. Celui-ci va s'installer directement, puis redémarrer.
5. Attendez le redémarrage, et c'est bon.
> [!TIP]
> Vous pouvez vérifier en retournant en mode UF2 DFU. Ouvrez le fichier INFO_UF2.TXT.\
> Si vous voyez **OTAFIX** dans le contenu, la mise à jour s'est bien passée.
[source](https://blog.meshcore.io/2026/04/06/otafix-bootloader)
# Prochaine étape
Maintenant que le fix est installé, il est possible de mettre à jour vos équipements par **Bluetooth**.
1. Télécharger le nouveau firmware
Depuis le [flasher web](https://flasher.meshcore.io/), sélectionnez votre équipement.\
Choisissez le rôle [répéteur](/documentation/repeater) ou [room server](/documentation/room-server). Enfin, téléchargez la dernière version disponible au format **.zip**.
2. Connectez-vous à votre équipement et allez dans le CLI.
Tapez la commande
```shell
start ota
```
À partir de ce moment, le Bluetooth va s'activer sur l'équipement.
3. Lancer l'application [nRF DFU android](https://play.google.com/store/apps/details?id=no.nordicsemi.android.dfu) / [nRF DFU iOS](https://apps.apple.com/us/app/nrf-device-firmware-update/id1624454660)
4. Dans l'application, allez dans « settings ».
Appliquez les paramètres suivants :
* Packet receipts notification - ON
* Number of packets - 8
* Request high MTU (Android only) - OFF
* Disable resume - ON
* Prepare object delay - 0 ms
* Force scanning - ON
5. Lancer la mise à jour
* Sélectionnez le **.zip** téléchargé à l'étape 1
* Sélectionnez votre appareil (visible en Bluetooth dans la liste)
* Appuyez sur « Start » pour démarrer (comptez une dizaine de minutes)
À la fin, votre équipement redémarre.\
C'est tout !\
Vous pouvez vérifier que vous êtes bien sur la dernière version depuis le CLI avec la commande :
```shell
ver
```
[source](https://blog.meshcore.io/2026/04/02/nrf-ota-update)
+127
View File
@@ -0,0 +1,127 @@
---
title: "Repeater"
description: "Le répéteur MeshCore : le nœud fixe qui fait la couverture du réseau. Rôle, installation, réglages et bonnes pratiques."
date: '2026-10-23T16:10:00+02:00'
weight: 3
cascade:
type: docs
---
Le **répéteur** (*repeater*) est l'infrastructure du réseau. C'est un nœud fixe, généralement placé en hauteur, dont le seul travail est de **retransmettre les messages** pour étendre la portée.
{{< callout type="info" >}}
Dans MeshCore, ce sont les répéteurs qui portent le trafic, pas les companions. La qualité d'un réseau dépend donc surtout de **où** ils sont placés.
{{< /callout >}}
## Comment il se comporte
- Il ne retransmet **pas** tout ce qu'il entend : il transmet ce qui doit l'être, notamment les messages sur un chemin connu qui passe par lui.
- Il s'annonce **automatiquement** à intervalles réguliers, ce qui permet aux companions de le découvrir.
- Il se gère à distance, par radio, depuis un companion, ou par USB.
## Bien le placer
Le placement compte plus que la puissance ou le matériel.
- **Hauteur et dégagement** : toit, mât, point haut avec vue dégagée dans la direction à couvrir.
- **Antenne** : une bonne antenne, bien orientée et bien raccordée, apporte plus qu'un réglage de puissance.
- **Obstacles** : bâtiments, relief et végétation dense sont des freins au signal.
- **Alimentation** : prise secteur, ou panneau solaire et batterie pour les sites isolés.
## Mise en service
{{% steps %}}
### Flasher le firmware Repeater
Avec le [flasher officiel](https://flasher.meshcore.io), choisissez votre modèle et le firmware **Repeater**.
N'oubliez pas de formater l'appareil la 1re fois.
### Configurer par USB
Utilisez [config.meshcore.io](https://config.meshcore.io) (ou la console série du flasher) pour régler la radio sur le preset **EU/UK (Narrow)** et donner un nom à votre répéteur.
### Changer les mots de passe
- Configurez un mot de passe d'administration **robuste**.
- Laissez le mot de passe invité vide (cela permet aux utilisateurs de récupérer la télémétrie de l'appareil).
### Synchroniser l'horloge
Réglez l'heure du répéteur depuis l'application ou la console.
### Envoyer un advert et tester
Envoyez un advert depuis le répéteur, puis vérifiez qu'il apparaît dans la liste d'un de vos companions.
{{% /steps %}}
{{< callout type="warning" >}}
Avant de monter le répéteur sur un mât, **testez l'administration à distance** depuis un companion. Une fois installé en hauteur, il sera plus compliqué d'y revenir par câble USB.
{{< /callout >}}
> [!TIP]
> Pensez à suivre [cette procédure](/documentation/ota_update), afin d'activer la mise à jour à distance.
## Réglages courants
Les commandes se tapent dans la console du répéteur (série) ou depuis l'administration à distance. Quelques-unes parmi les plus utiles :
| Commande | Rôle |
|---|---|
| `advert` | Envoie un advert diffusé (flood) |
| `advert.zerohop` | Envoie un advert local |
| `set advert.interval <minutes>` | Intervalle des adverts locaux (60 à 240 min) |
| `set flood.advert.interval <heures>` | Intervalle des adverts diffusés (3 à 168 h) |
| `set dutycycle 10` | Configure un duty cycle de 10 % |
| `password <nouveau>` | Change le mot de passe admin |
| `set guest.password <mot de passe>` | Définit le mot de passe invité |
| `reboot` | Redémarre le nœud |
La liste complète est dans la [documentation officielle des commandes](https://docs.meshcore.io/cli_commands).
### Exemple de réglages communautaires
La [communauté française](https://www.meshcore.fr/) recommande les réglages suivants :
```text
set advert.interval 240
set flood.advert.interval 24
set agc.reset.interval 4
set multi.acks 1
set dutycycle 10
set path.hash.mode 1
set loop.detect minimal
set flood.max.advert 8
set flood.max.unscoped 5
region def eu europe fr
region default fr
region home fr
region save
set repeat on
set guest.password ''
clock sync
reboot
```
Ces valeurs sont données à titre d'**exemple**.
> [!IMPORTANT]
> Les adverts diffusés consomment du temps d'antenne pour tout le monde ; plus l'intervalle est court, plus le réseau est chargé.
## Identifiant et chemins
Dans l'historique du trajet d'un message, chaque répéteur est repéré par les premiers caractères de sa clé publique. Deux répéteurs avec le même préfixe créent de la confusion.
## Régions
Les répéteurs peuvent être rattachés à des **régions** (par exemple France, puis région, puis département) pour limiter la propagation des messages à une zone utile. Les noms et la structure sont définis par chaque communauté locale.
## Règles du jeu
Le réseau est partagé et la bande 868 MHz est réglementée (puissance, temps d'émission). Respectez le preset communautaire et le duty cycle, et ne multipliez pas les répéteurs au même endroit sans concertation.
## Et le room server ?
Un [room server](/documentation/room-server/) n'est pas fait pour servir de répéteur ! C'est un appareil qui sert à poster des messages dans un salon public.
+83
View File
@@ -0,0 +1,83 @@
---
title: "Room Server"
description: "Le Room Server MeshCore : un espace de messages partagé, façon forum ou BBS, accessible par radio."
date: '2026-10-23T16:20:00+02:00'
weight: 4
cascade:
type: docs
---
Le **Room Server** est le rôle le plus particulier de MeshCore. C'est un petit **serveur de messages** de type forum : les gens s'y connectent depuis leur [companion](/documentation/companion/), déposent des messages dans un espace partagé et lisent ceux des autres, même s'ils n'étaient pas connectés au moment de leur publication.
## À quoi ça sert
Un canal classique ne garde rien : si vous n'êtes pas à l'écoute, vous manquez le message. Un room server **conserve** les messages, ce qui le rend utile pour :
- un **tableau d'affichage** local (infos pratiques, météo, annonces) ;
- un **groupe** ou une association qui veut un fil de discussion persistant ;
- un **événement** (randonnée, rassemblement) où tout le monde n'est pas toujours à portée.
## Comment ça marche
- Le room server est un **nœud fixe**, installé comme un répéteur, que l'on contacte par radio.
- Le client s'y **connecte** avec un mot de passe, puis peut lire et poster.
- À la connexion, le client reçoit les **32 derniers messages qu'il n'avait pas encore vus**.
- Les messages d'un room server sont limités à 150 caractères.
## Accès et mots de passe
| Mot de passe | Droits | Restriction de connexion |
|---|---| ---|
| **Admin** | Administrer le room server (réglages, accès) | Y appliquer un mot de passe fort |
| **Invité** | Se connecter à la room et y poster | **NE PAS** appliquer de mot de passe |
> [!NOTE]
> Le room server peut aussi être réglé en **lecture seule**, ce qui autorise une connexion sans mot de passe sans pouvoir poster.
## Mise en service
{{% steps %}}
### Flasher le firmware Room Server
Pour flasher votre équipement, choisissez votre modèle d'appareil et le firmware **Room Server**.
Deux possibilités :
- Le flasher officiel : rien de spécial.
- Le flasher [communautaire Gessaman](https://observer.gessaman.com/) : intéressant si vous souhaitez envoyer des [données sur internet](https://livemap.mesh.chaun14.fr/). Cela permet de monitorer le réseau afin de voir ce qui se passe, et où, par exemple. L'avantage de ce flasher, c'est que des **presets** sont préinstallés.
Un preset est une préconfiguration qui permet à votre room server d'être aussi un **Observer** et d'envoyer des [données sur internet](https://analyzer.letsmesh.net/packets). Cela nécessite un équipement connecté à internet (par exemple un Heltec V4 connecté au [Wi-Fi](https://observer.gessaman.com/webconfig)).
Il vous suffit de suivre la [documentation officielle](https://observer.gessaman.com/docs#broker-presets) pour les activer en CLI.
Vous disposez de plusieurs emplacements de preset.
Pour configurer meshmapper sur le slot 3 :
```shell
set mqtt3.preset meshmapper
```
### Configurer la radio et les mots de passe
Comme pour un [répéteur](/documentation/repeater/) : preset **EU/UK (Narrow)**, nom du nœud, mot de passe admin, mot de passe invité vide.
### Envoyer un advert
Envoyez un advert pour que les companions voient la room dans leur liste de contacts.
### Se connecter depuis un companion
Ajoutez le room server comme contact, ouvrez-le et saisissez le mot de passe. Les messages en attente arrivent ensuite.
{{% /steps %}}
## Peut-il aussi faire répéteur ?
Techniquement oui, avec la commande `set repeat on`. Ce n'est **ni recommandé ni encouragé** : un room server qui répète n'a pas toutes les fonctions du firmware Repeater, notamment en administration à distance. Le plus simple et le plus fiable est de dédier un appareil au [répéteur](/documentation/repeater/) et un autre au room server.
## Administration à distance
Comme pour un répéteur, on peut administrer un room server à distance depuis un companion, ou par USB avec la console série. Les commandes sont en grande partie les mêmes que celles du répéteur : voir la [documentation officielle](https://docs.meshcore.io/cli_commands).
## Bon à savoir
- Un room server ne sert à rien tout seul : il faut des gens à portée, directement ou via des répéteurs.
- Il stocke des messages.
- Placez-le comme un répéteur, en hauteur et bien dégagé, si vous voulez qu'il soit joignable de loin.