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