Guide Meshtastic - Configuration Meshtastic LoRa

Les options de config LoRa incluent : Région, Utiliser Préréglage, Préréglage Modem, Nombre max de sauts, Puissance d'émission, Largeur de bande, Facteur d'étalement, Taux de codage, Décalage de fréquence, Transmission activée, Canal de fréquence, Ignorer le tableau entrant, Ignorer MQTT, Outrepasser la limite du cycle de service, Gain RX boosté SX126x, Outrepasser la fréquence, et Ventilateur PA désactivé. Cette configuration utilise un message admin envoyant un protobuf Config.LoRa.
Note : Pour communiquer efficacement, les appareils dans un maillage doivent partager des paramètres Région et Préréglage Modem identiques ou avoir des paramètres personnalisés de modem identiques.

Valeurs de configuration LoRa

Note : Assurez-vous de régler le paramètre lora.region de votre appareil pour respecter les limites légales dans votre région.
  • Région : Définit la région pour votre nœud, la valeur par défaut étant non définie. Si elle n'est pas définie, le nœud affichera un message et ne pourra pas transmettre de paquets.
Code de région Description Plage de fréquences (MHz) Cycle de service (%) Limite de puissance (dBm)
UNSET Non serti N/A N/A N/A
États-Unis États-Unis 902.0 - 928.0 100 30
EU_433 Union européenne 433MHz 433.0 - 434.0 10 12
EU_868 Union européenne 868MHz 869.4 - 869.65 10 27
CN Chine 470.0 - 510.0 100 19
JP Japon 920.8 - 927.8 100 16
ANZ Australie & Nouvelle-Zélande 915.0 - 928.0 100 30
KR Corée 920.0 - 923.0 100
TW Taïwan 920.0 - 925.0 100 27
RU Russie 868.7 - 869.2 100 20
PO Inde 865.0 - 867.0 100 30
NZ_865 Nouvelle-Zélande 865MHz 864.0 - 868.0 100 36
TH Thaïlande 920.0 - 925.0 100 16
UA_433 Ukraine 433MHz 433.0 - 434.7 10 10
UA_868 Ukraine 868MHz 868.0 - 868.6 1 14
MY_433 Malaisie 433MHz 433.0 - 435.0 100 20
MY_919 Malaisie 919MHz 919.0 - 924.0 100 27
SG_923 Singapour 923MHz 917.0 - 925.0 100 20
LORA_24 Bande 2,4 GHz dans le monde entier 2400.0 - 2483.5 100 10
REMARQUE : EU_433 et EU_868 doivent respecter un cycle de service maximal de 10 %, calculé chaque minute sur une base glissante d'une heure. Votre appareil cessera de transmettre si la limite est atteinte.
  • Utiliser Préréglage : Lorsqu'il est activé, les champs Préréglage du Modem seront utilisés ; sinon, les valeurs pour la Largeur de bande, le Facteur d'étalement et le Taux de codage seront prises à partir de leurs entrées manuelles respectives.
  • Préréglage du modem : La valeur par défaut est non défini (LONG_FAST). Les préréglages sont des configurations prédéfinies (Largeur de bande, Facteur d'étalement et Taux de codage) qui influencent la vitesse et la portée des messages, offrant un compromis pour la plupart des utilisateurs. Les préréglages optimisent soit la vitesse soit la portée selon la situation : SHORT_TURBO (le plus rapide, largeur de bande la plus élevée, temps d'air le plus court, portée la plus courte ; non légal dans toutes les régions en raison de la largeur de bande de 500 kHz). / SHORT_FAST / SHORT_SLOW / MEDIUM_FAST / MEDIUM_SLOW / LONG_FAST (par défaut) / LONG_MODERATE / LONG_SLOW / VERY_LONG_SLOW (le plus lent, largeur de bande la plus faible, temps d'air le plus long, portée la plus longue ; non recommandé pour un usage régulier).
  • Nombre max de sauts : Le nombre maximum de sauts ne peut pas dépasser 7, avec une valeur par défaut de 3, ce qui convient à la plupart des applications.
  • Puissance d'émission : Réglez à zéro pour utiliser la puissance continue maximale légale par défaut, évitant d'endommager le matériel. Dans la plupart des cas, zéro est recommandé. Les unités sont en dBm.
  • Largeur de bande : Certaines valeurs de largeur de bande sont traduites par le firmware en valeurs flottantes appropriées :
Valeur spéciale Interprété comme
31 31,25 kHz
62 62,5 kHz
200 203,125 kHz
400 406,25 kHz
800 812,5 kHz
1600 1625,0 kHz
REMARQUE : Les valeurs < 62,5 kHz peuvent nécessiter un TCXO sur certains matériels.
  • Facteur d'étalement : Un nombre de 7 à 12 représentant le nombre de chirps par symbole comme (1 << \text{spread_factor}).
  • Taux de codage : C'est le dénominateur du taux de codage ; par exemple, pour 4/5, la valeur est 5.
  • Décalage de fréquence : Destiné aux utilisateurs avancés avec un équipement spécialisé ; la plupart devraient éviter de l'utiliser. Ce paramètre ajoute un décalage de fréquence à la fréquence centrale pour corriger les erreurs d'étalonnage.
  • Transmission activée : Cette option permet d'activer ou de désactiver la transmission (TX) depuis la radio LoRa ; utile pour les échanges d'antenne et les tests. Par défaut à true.
  • Emplacement de fréquence : Contrôle la fréquence matérielle utilisée pour la transmission, représentée par un emplacement entre 1 et NUM_SLOTS (maximum basé sur la région et le préréglage du modem). Le réglage à 0/UNSET revient à l'ancienne méthode de détermination de la fréquence.
  • Ignorer le tableau entrant : Pour les tests, vous pouvez empêcher un nœud d'écouter certains nœuds spécifiques (simulant une portée hors de portée). Les paquets provenant des numéros de nœud dans ce tableau seront ignorés.
  • Ignorer MQTT : Mettre cette option à true permet à l'appareil d'ignorer tous les messages LoRa envoyés via MQTT. Cela ne s'applique que lorsque votre appareil et le nœud MQTT ont au moins la version du firmware 2.2.19.
  • OK pour MQTT : Les valeurs acceptables sont true ou false (par défaut false). Mettre à true signifie que vous autorisez l'envoi de vos paquets aux courtiers MQTT. Si false, les nœuds sont invités à ne pas transmettre les paquets. Cela fonctionne uniquement avec les canaux utilisant les clés defaultpsk et eventpsk ; c'est ignoré dans les canaux avec des clés personnalisées.
Astuce : Ce n'est pas une mesure cryptographique mais une demande polie appliquée dans le firmware officiel.
  • Remplacer Limite de cycle de service : Réglez sur true pour ignorer la limite horaire du cycle de service en Europe, ce qui pourrait entraîner des violations réglementaires. Par défaut, c'est false, ce qui signifie que l'appareil arrêtera la transmission de données lorsqu'il atteindra la limite.
  • Gain RX boosté SX126x : Cette option permet aux puces SX126x d'utiliser un peu plus de puissance pour améliorer la sensibilité RX.
  • Remplacer la fréquence : Pour les utilisateurs avancés et les opérateurs radio HAM licenciés. Lorsqu'activé, l'appareil ignore les calculs de canal et utilise la fréquence spécifiée (le décalage de fréquence s'applique toujours). Assurez-vous de respecter les lois locales et activez le mode HAM tout en désactivant le chiffrement.
  • Ventilateur PA désactivé : Si réglé sur true, cela désactive le ventilateur PA intégré utilisant la broche définie dans RF95_FAN_EN.

Disponibilité du client de configuration LoRa

Android

Les options de config LoRa sont accessibles sur Android.
  1. Ouvrez l'application Meshtastic.
  2. Naviguez vers : Ellipse verticale (trois points en haut à droite) > Configuration radio > LoRa.

Pomme

Toutes les options de config LoRa sont disponibles sur iOS, iPadOS et macOS dans Réglages > Configuration Radio > LoRa.

CLI

Les commandes de config LoRa sont accessibles dans le CLI Python. Des exemples de commandes sont fournis ci-dessous :
Paramètre Valeurs acceptables Par défaut
lora.modem_preset LONG_FAST, LONG_SLOW, VERY_LONG_SLOW, MEDIUM_SLOW, MEDIUM_FAST, SHORT_SLOW, SHORT_FAST, SHORT_TURBO LONG_FAST
lora.use_preset false, true FALSE
lora.region UNSET, US, EU_433, EU_868, CN, JP, ANZ, KR, TW, RU ,IN, NZ_865, TH, LORA_24, UA_433, UA_868, MY_433, MY_919, SG_923 UNSET
lora.bandwidth 31, 62, 125, 250, 500 250
lora.spread_factor 7, 8, 9, 10, 11, 12 12
lora.coding_rate 5, 6, 7, 8 8
lora.frequency_offset 0 à 1000000 0
lora.hop_limit 1,2,3,4,5,6,7 3
lora.tx_power 0 à 30 0
lora.tx_enabled false, true VRAI
lora.channel_num 0, 1 à NUM_CHANNELS 0
lora.ignore_mqtt false, true FALSE
lora.config_ok_to_mqtt true, false FALSE
lora.override_duty_cycle false, true FALSE
lora.sx126x_rx_boosted_gain false, true FALSE
lora.override_frequency Toute fréquence prise en charge par la radio LoRA. Veuillez respecter les règles et réglementations locales 0
  • Définir le préréglage du modem
 meshtastic --set lora.modem_preset LONG_FAST
 meshtastic --set lora.modem_preset MEDIUM_FAST
  • Définir la région
 meshtastic --set lora.region US
 meshtastic --set lora.region EU_433
  • Définir la limite de saut
 meshtastic --set lora.hop_limit 2
  • Ignorer le cycle de service
 meshtastic --set lora.override_duty_cycle true
 meshtastic --set lora.override_duty_cycle false
REMARQUE : Comme l'appareil redémarrera après chaque commande envoyée via le CLI, il est recommandé de chaîner les commandes ensemble lorsqu'on définit plusieurs valeurs dans une section de configuration. Par exemple :
 meshtastic --set lora.region US --set lora.modem_preset LONG_FAST

Web

Toutes les options de config LoRa sont disponibles dans l'interface Web.

Barre latérale

Dernier article

Cette section ne contient actuellement aucun contenu. Ajoutez du contenu à cette section en utilisant la barre latérale.

Inscrivez-vous à notre newsletter

Obtenez les dernières informations sur nos produits et offres spéciales.