Files

91 lines
4.5 KiB
Markdown

---
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.