Les options de configuration des canaux incluent le Index, les Rôles et les Paramètres. La configuration du canal utilise un message d'administration qui envoie un protobuf Channel, contenant soit un protobuf ChannelSettings soit un protobuf ModuleSettings.
Note : les Paramètres de canal (décrits sur cette page) ne doivent pas être confondus avec les Paramètres prédéfinis du modem.
Les Paramètres prédéfinis du modem consistent en la configuration du modem, incluant les paramètres de fréquence, le facteur d'étalement, la largeur de bande, et plus encore, applicables à la radio LoRa. Ces paramètres sont cohérents sur tous les canaux et ne peuvent pas être uniques à des canaux individuels.
En revanche, les Paramètres de canal fournissent des informations pour organiser les groupes de messages, activer le chiffrement optionnel et autoriser ou interdire la messagerie via les passerelles Internet. Ces paramètres sont uniques et configurables pour chaque canal.
Valeurs de configuration du canal
Index
L'indexation ne peut pas être modifiée.
| Index | Canal | Rôle par défaut | But |
| 0 | 1 | PRIMARY | Utilisé comme canal par défaut |
| 1 | 2 | DÉSACTIVÉ | Défini par l'utilisateur |
| 2 | 3 | DÉSACTIVÉ | Défini par l'utilisateur |
| 3 | 4 | DÉSACTIVÉ | Défini par l'utilisateur |
| 4 | 5 | DÉSACTIVÉ | Défini par l'utilisateur |
| 5 | 6 | DÉSACTIVÉ | Défini par l'utilisateur |
| 6 | 7 | DÉSACTIVÉ | Défini par l'utilisateur |
| 7 | 8 | DÉSACTIVÉ | Défini par l'utilisateur |
REMARQUE : Vous ne pouvez pas avoir de canaux DISABLED placés entre des canaux actifs comme PRIMARY et SECONDARY. Les canaux actifs doivent être en ordre consécutif.
Rôle
Chaque canal se voit attribuer l'un des trois rôles :
-
PRIMARY (1) C'est le premier canal créé lors de la configuration initiale. Un seul canal primary peut exister et ne peut pas être désactivé. Les diffusions périodiques, telles que la position et la télémétrie, sont envoyées exclusivement via ce canal.
-
SECONDARY (2) Ce canal peut modifier la clé de chiffrement (PSK).
-
DÉSACTIVÉ (0) Le canal n'est plus disponible pour utilisation, et ses paramètres sont réinitialisés par défaut.
REMARQUE : Bien que vous puissiez utiliser un canal PRIMARY différent et communiquer via des canaux SECONDARY portant le même nom et PSK, le hachage du nom du canal PRIMARY définit le créneau de fréquence LoRa. Ce créneau de fréquence détermine la fréquence réelle de transmission dans la bande. Pour garantir que les appareils avec des noms de canal PRIMARY différents transmettent sur la même fréquence, vous devez définir explicitement le créneau de fréquence LoRa.
Paramètres de configuration du canal
Les options Paramètres du canal incluent : Nom, PSK, Downlink activé, et Uplink activé. Ces paramètres de canal sont encapsulés dans le protobuf Channel en tant que protobuf ChannelSettings et transmis comme un message admin.
noms des canaux
Un identifiant court pour le canal. (< 12 octets)
| Nom réservé | But |
| "" (par défaut) | Si laissé vide sur le canal primaire, cela désigne le canal par défaut. |
| admin | Sur les canaux secondaires, le nom admin (sensible à la casse) désigne le canal admin utilisé pour administrer les nœuds via le mesh. Notez qu'il s'agit d'une fonctionnalité Legacy, voir Remote Admin pour plus de détails. |
NOTE : Pour communiquer sur le même canal avec d'autres appareils, des noms de canal correspondants sont essentiels. Par exemple, si votre appareil utilise le nom de canal LongFast, l'appareil avec lequel vous souhaitez communiquer doit également avoir un canal nommé LongFast.
PSK
La clé de chiffrement utilisée pour les canaux privés peut être spécifiée comme suit : elle peut être de 0 octet (pas de chiffrement), 16 octets (AES128), ou 32 octets (AES256). Le canal par défaut primaire utilise l'octet hexadécimal 0x01.
Note : Des PSK correspondants sont nécessaires pour communiquer sur le même canal avec d'autres appareils. Par exemple, si votre appareil utilise un canal avec le PSK par défaut AQ==, l'appareil avec lequel vous souhaitez communiquer doit également avoir un canal avec le même PSK.
Downlink activé
Si activé, les messages capturés depuis une passerelle de l'internet public seront transférés vers le mesh local. Par défaut, ce paramètre est false pour tous les canaux.
Uplink activé
Si activé, les messages du mesh seront transmis à l'internet public via la passerelle configurée de n'importe quel nœud. Ce paramètre est false par défaut pour tous les canaux.
Paramètres de configuration du canal
Les options des paramètres du module canal incluent la précision de la position. Ces paramètres sont intégrés dans le Channel protobuf en tant que ModuleSettings protobuf et sont envoyés comme un message admin.
Précision de la position
Le paramètre position_precision vous permet de contrôler le niveau de précision des données de localisation transmises via un canal spécifique. Cela peut être important pour la confidentialité, car il peut être nécessaire d'obscurcir la position exacte lors de l'envoi des données de position via certains canaux.
La valeur position_precision est un entier allant de 0 à 32 :
-
Une valeur de 0 indique que les données de localisation ne sont jamais envoyées via le canal donné.
-
Une valeur de 32 signifie que les données de localisation sont envoyées avec une précision totale.
-
Les valeurs intermédiaires représentent le nombre de bits de précision à envoyer, correspondant à une précision de position spécifique détaillée dans le tableau ci-dessous.
-
Veuillez noter que le serveur MQTT public filtre les positions précises.
Les applications clientes offrent différents niveaux de précision, permettant aux utilisateurs de choisir parmi une gamme pratique. Vous pouvez définir des valeurs sur toute la plage des entiers en utilisant le Python CLI. Pour des exemples sur la façon de définir différents niveaux de précision avec le CLI, consultez Définir la précision de la position.
| Bits de précision | Métrique | Impérial |
| 10 | 23,3 km | 14,5 miles |
| 11 | 11,7 km | 7,3 miles |
| 12 | 5,8 km | 3,6 miles |
| 13 | 2,9 km | 1,8 miles |
| 14 | 1,5 km | 4787 pieds |
| 15 | 729 m | 2392 pieds |
| 16 | 364 m | 1194 feet |
| 17 | 182 m | 597 feet |
| 18 | 91 m | 299 feet |
| 19 | 45 m | 148 feet |
Disponibilité de la configuration du client canal
Android
Les options de config canal sont disponibles sur Android.
L'onglet Configuration radio est disponible pour les tâches courantes, notamment :
-
Afficher votre configuration actuelle du canal avec le code QR et l'URL.
-
Créer ou modifier rapidement votre canal principal.
-
Sélectionner un préréglage de modem pour tous vos canaux, comme Longue portée ou Rapide.
Pour des instructions supplémentaires sur la configuration de votre canal principal, consultez la section Utilisation de l'application Android.
Appuyez sur "Modifier" pour accéder au Menu Canal, où vous pouvez :
-
Ajouter, supprimer ou modifier les canaux secondaires.
-
Créer ou modifier les clés de chiffrement.
-
Activer uplink et downlink pour les canaux individuels.
-
Activer les paramètres de position.
-
Définir la localisation précise (si la position est activée).
-
Ajuster la précision de la position (si la localisation précise est désactivée).
Apple
Un éditeur de canal est accessible dans les applications iOS, iPadOS et macOS sous Paramètres > Configuration radio > Canaux.
CLI
Conseil : Comme l'appareil redémarrera après chaque commande envoyée via le CLI, il est recommandé d'enchaîner les commandes en une seule lorsque vous définissez plusieurs valeurs dans une section de configuration. Exemple :
| meshtastic --ch-set name "My Channel" --ch-set psk random --ch-set uplink_enabled true --ch-index 4 |
Toutes les options de config de Channel sont disponibles dans le Python CLI. Des commandes exemples sont fournies ci-dessous :
Nom
Définir le nom du canal pour le canal PRINCIPAL
|
# without spaces |
PSK
Si vous utilisez Meshtastic pour échanger des messages que vous ne voulez pas que d'autres voient, vous devriez utiliser le paramètre random. Choisir default ou l'une des valeurs simple du tableau suivant utilisera des clés de chiffrement connues publiquement. Ces clés sont incluses dans le code source de Meshtastic, ce qui permet à quiconque d'intercepter les messages chiffrés avec elles. Bien qu'elles conviennent pour les tests et les canaux publics, elles ne sont pas sécurisées pour les communications privées.
| Paramètre | Comportement |
| none | Désactiver le chiffrement |
| default | Chiffrement par défaut (utiliser la clé de chiffrement faible) |
| random | Générez une clé de chiffrement sécurisée de 256 bits. Utilisez ce paramètre pour une communication privée. |
| simple0- simple254 | Utilise un encodage sur un seul octet pour le chiffrement |
-
Définir le chiffrement par défaut sur le canal PRIMARY
| meshtastic --ch-set psk default --ch-index 0 |
-
Définir le chiffrement aléatoire sur le canal PRIMARY
| meshtastic --ch-set psk random --ch-index 0 |
-
Définir le chiffrement sur un octet unique sur le canal PRIMARY
| meshtastic --ch-set psk simple15 --ch-index 0 |
-
Définir le chiffrement avec votre propre clé sur le canal PRIMARY
| meshtastic --ch-set psk 0x1a1a1a1a2b2b2b2b1a1a1a1a2b2b2b2b1a1a1a1a2b2b2b2b1a1a1a1a2b2b2b2b --ch-index 0 |
-
Définir le chiffrement avec votre propre clé sur le canal PRIMARY (encodée en Base64)
| meshtastic --ch-set psk base64:puavdd7vtYJh8NUVWgxbsoG2u9Sdqc54YvMLs+KNcMA= --ch-index 0 |
-
Désactiver le chiffrement sur le canal PRIMARY
| meshtastic --ch-set psk none --ch-index 0 |
NOTE : Utilisez ceci pour copier et coller la clé encodée en base64 (canal unique) depuis la commande meshtastic --info. Veuillez éviter d'utiliser le code omnibus (tous les canaux) ici, car ce n'est pas une clé valide.
Uplink / Downlink
Pour configurer les passerelles, veuillez consulter MQTT
-
Activer/Désactiver l'uplink sur le canal PRINCIPAL
| meshtastic --ch-set uplink_enabled true --ch-index 0 meshtastic --ch-set uplink_enabled false --ch-index 0 |
-
Activer/Désactiver le downlink sur le canal SECONDAIRE
| meshtastic --ch-set downlink_enabled true --ch-index 1 meshtastic --ch-set downlink_enabled false --ch-index 5 |
Configuration de la précision de position
Ceci est un paramètre par canal. Le paramètre --ch-index doit être spécifié pour définir la précision de position pour un canal spécifique, par exemple, --ch-index 0 pour le canal principal ou --ch-index 1 pour le canal secondaire 1.
-
Définir la précision de position à 13 bits (environ ±3 km)
| meshtastic --ch-set module_settings.position_precision 13 --ch-index 0 |
-
Définir la précision de position à pleine précision (32 bits)
| meshtastic --ch-set module_settings.position_precision 32 --ch-index 1 |
Web
Toutes les options de configuration du canal sont accessibles dans l'interface Web.
Code QR
Le code QR Meshtastic QR code (ou Channel URL) permet aux utilisateurs de partager rapidement les paramètres du canal et de LoRa, simplifiant ainsi le processus de configuration de plusieurs nœuds avec des paramètres de communication correspondants. Scanner un code QR applique tous les paramètres de canal et de configuration LoRa inclus, alors assurez-vous de vérifier ce que ces paramètres englobent avant de continuer. Ne scannez que les codes QR provenant de sources fiables.
Pour plus de détails, voir :
