De configuratieopties voor kanalen omvatten Index, Rollen en Instellingen. Kanaalconfiguratie maakt gebruik van een admin-bericht dat een Kanaal protobuf verzendt, dat ofwel een ChannelSettings of een ModuleSettings protobuf bevat.
Opmerking: Kanaalinstellingen (beschreven op deze pagina) mogen niet worden verward met Modem Preset Instellingen.
Modem Preset Instellingen bestaan uit de modemconfiguratie, inclusief frequentie-instellingen, spreidingsfactor, bandbreedte en meer, toepasbaar op de LoRa-radio. Deze instellingen zijn consistent over alle kanalen en kunnen niet uniek zijn voor individuele kanalen.
In tegenstelling hiermee bieden Kanaal Instellingen informatie voor het organiseren van berichtgroepen, inschakelen van optionele encryptie en toestaan of weigeren van berichten via internetgateways. Deze instellingen zijn uniek en configureerbaar voor elk kanaal.
Kanaalconfiguratiewaarden
Index
Indexering kan niet worden gewijzigd.
| Index | Kanaal | Standaardrol | Doel |
| 0 | 1 | PRIMARY | Gebruikt als standaardkanaal |
| 1 | 2 | DISABLED | Door gebruiker gedefinieerd |
| 2 | 3 | DISABLED | Door gebruiker gedefinieerd |
| 3 | 4 | DISABLED | Door gebruiker gedefinieerd |
| 4 | 5 | DISABLED | Door gebruiker gedefinieerd |
| 5 | 6 | DISABLED | Door gebruiker gedefinieerd |
| 6 | 7 | DISABLED | Door gebruiker gedefinieerd |
| 7 | 8 | DISABLED | Door gebruiker gedefinieerd |
NOTE: Je kunt geen DISABLED-kanalen tussen actieve kanalen zoals PRIMARY en SECONDARY plaatsen. Actieve kanalen moeten in opeenvolgende volgorde staan.
Rol
Elk kanaal krijgt een van de drie rollen toegewezen:
-
PRIMARY (1) Dit is het eerste kanaal dat tijdens de initiële setup is aangemaakt. Er kan slechts één primary-kanaal bestaan en dit kan niet worden uitgeschakeld. Periodieke uitzendingen, zoals positie en telemetrie, worden uitsluitend via dit kanaal verzonden.
-
SECONDARY (2) Dit kanaal kan de encryptiesleutel (PSK) wijzigen.
-
DISABLED (0) Het kanaal is niet langer beschikbaar voor gebruik en de instellingen worden teruggezet naar de standaardwaarden.
NOTE: Hoewel je een ander PRIMARY-kanaal kunt gebruiken en kunt communiceren via SECONDARY-kanalen met dezelfde naam en PSK, bepaalt de hash van de naam van het PRIMARY-kanaal de LoRa-frequentieslot. Deze frequentieslot bepaalt de daadwerkelijke transmissiefrequentie binnen de band. Om ervoor te zorgen dat apparaten met verschillende PRIMARY-kanaalnamen op dezelfde frequentie uitzenden, moet je expliciet de LoRa-frequentieslot instellen.
Kanaalconfiguratieparameters
De Channel Settings opties omvatten: Name, PSK, Downlink Enabled, en Uplink Enabled. Deze kanaalinstellingen zijn ingekapseld binnen de Channel protobuf als een ChannelSettings protobuf en worden verzonden als een admin message.
kanaalnamen
Een korte identificatie voor het kanaal. (< 12 bytes)
| Gereseveerde naam | Doel |
| "" (standaard) | Als deze leeg wordt gelaten op het Primary-kanaal, duidt dit het standaardkanaal aan. |
| admin | Op secundaire kanalen duidt de naam admin (hoofdlettergevoelig) het admin-kanaal aan dat wordt gebruikt om nodes via het mesh te beheren. Let op, dit is een Legacy-functie, zie Remote Admin voor details. |
OPMERKING: Om te communiceren op hetzelfde kanaal met andere apparaten zijn overeenkomende kanaalnamen essentieel. Bijvoorbeeld, als jouw apparaat de kanaalnaam LongFast gebruikt, moet het apparaat waarmee je wilt communiceren ook een kanaal hebben met de naam LongFast.
PSK
De encryptiesleutel die wordt gebruikt voor privékanalen kan als volgt worden gespecificeerd: het kan 0 bytes zijn (geen encryptie), 16 bytes (AES128), of 32 bytes (AES256). Het Primary default channel gebruikt de hex byte 0x01.
Opmerking: Overeenkomende PSK's zijn noodzakelijk voor communicatie op hetzelfde kanaal met andere apparaten. Bijvoorbeeld, als jouw apparaat een kanaal gebruikt met de standaard PSK van AQ==, moet het apparaat waarmee je wilt communiceren ook een kanaal hebben dat dezelfde PSK gebruikt.
Downlink ingeschakeld
Indien ingeschakeld, worden berichten die zijn opgevangen via een openbare internet gateway doorgestuurd naar het lokale mesh. Standaard is deze instelling voor alle kanalen false.
Uplink ingeschakeld
Indien ingeschakeld, worden berichten van het mesh via de geconfigureerde gateway van een willekeurige node naar het openbare internet verzonden. Deze instelling is standaard false voor alle kanalen.
Kanaalconfiguratie-instellingen
De opties voor kanaalmodule-instellingen omvatten positie precisie. Deze instellingen zijn opgenomen in de Channel protobuf als een ModuleSettings protobuf en worden verzonden als een admin message.
Positienauwkeurigheid
De position_precision instelling stelt je in staat het precisieniveau van locatiegegevens die via een specifiek kanaal worden verzonden te regelen. Dit kan belangrijk zijn voor privacy, omdat het nodig kan zijn om de exacte locatie te verhullen bij het verzenden van positiedata via bepaalde kanalen.
De position_precision waarde is een geheel getal tussen 0 en 32:
-
Een waarde van 0 geeft aan dat locatiegegevens nooit worden verzonden via het opgegeven kanaal.
-
Een waarde van 32 betekent dat locatiegegevens worden verzonden met volledige precisie.
-
Tussenliggende waarden geven het aantal precisiebits aan dat wordt verzonden, overeenkomend met een specifieke positieprecisie zoals gedetailleerd in de onderstaande tabel.
-
Houd er rekening mee dat de publieke MQTT server precieze posities filtert.
De clientapplicaties bieden verschillende precisieniveaus, waardoor gebruikers kunnen kiezen uit een praktisch bereik. Je kunt waarden instellen over het volledige bereik van gehele getallen met de Python CLI. Voor voorbeelden over het instellen van verschillende precisieniveaus met de CLI, zie Position Precision instellen.
| Precisiebits | Metrisch | Imperiaal |
| 10 | 23,3 km | 14,5 mijl |
| 11 | 11,7 km | 7,3 mijl |
| 12 | 5,8 km | 3,6 mijl |
| 13 | 2,9 km | 1,8 mijl |
| 14 | 1,5 km | 4787 voet |
| 15 | 729 m | 2392 voet |
| 16 | 364 m | 1194 feet |
| 17 | 182 m | 597 feet |
| 18 | 91 m | 299 feet |
| 19 | 45 m | 148 feet |
Beschikbaarheid van kanaalklantenconfiguratie
Android
Channel Config opties zijn beschikbaar op Android.
Het tabblad Radio Configuration is beschikbaar voor veelvoorkomende taken, waaronder:
-
Bekijk je huidige kanaalconfiguratie QR-code en URL.
-
Snel je primaire kanaal aanmaken of wijzigen.
-
Selecteer een modempreset voor al je kanalen, zoals Long Range of Fast.
Voor extra instructies over het instellen van je primaire kanaal, zie de sectie Android App Usage.
Tik op "Bewerken" om toegang te krijgen tot het Kanaalmenu, waar je kunt:
-
Voeg secundaire kanalen toe, verwijder ze of wijzig ze.
-
Maak encryptiesleutels aan of wijzig ze.
-
Schakel uplink en downlink in voor individuele kanalen.
-
Schakel positie instellingen in.
-
Stel precieze locatie in (als positie is ingeschakeld).
-
Pas positieprecisie aan (als precieze locatie is uitgeschakeld).
Apple
Een kanaalbewerker is toegankelijk in de iOS-, iPadOS- en macOS-applicaties onder Instellingen > Radio Configuratie > Kanalen.
CLI
Tip: Aangezien het apparaat na elk commando dat via de CLI wordt verzonden opnieuw opstart, wordt aanbevolen om commando's samen te voegen als één commando bij het instellen van meerdere waarden in een configuratiesectie. Voorbeeld:
| meshtastic --ch-set name "My Channel" --ch-set psk random --ch-set uplink_enabled true --ch-index 4 |
Alle Channel config opties zijn beschikbaar in de Python CLI. Voorbeeldcommando's worden hieronder gegeven:
Naam
Stel kanaalnaam in voor het PRIMAIRE kanaal
|
# zonder spaties |
PSK
Als je Meshtastic gebruikt om berichten uit te wisselen die je niet wilt dat anderen zien, moet je de random instelling gebruiken. Het kiezen van default of een van de simple waarden uit de volgende tabel maakt gebruik van publiek bekende encryptiesleutels. Deze sleutels zijn opgenomen in de broncode van Meshtastic, waardoor het voor iedereen mogelijk is om berichten die hiermee zijn versleuteld te onderscheppen. Hoewel ze geschikt zijn voor testen en openbare kanalen, zijn ze niet veilig voor privécommunicatie.
| Instelling | Gedrag |
| none | Encryptie uitschakelen |
| default | Standaardversleuteling (gebruik de zwakke versleutelingssleutel) |
| random | Genereer een veilige 256-bit versleutelingssleutel. Gebruik deze instelling voor privécommunicatie. |
| simple0- simple254 | Gebruikt een enkele byte codering voor versleuteling |
-
Stel versleuteling in op standaard op het PRIMAIRE kanaal
| meshtastic --ch-set psk default --ch-index 0 |
-
Stel versleuteling in op willekeurig op het PRIMAIRE kanaal
| meshtastic --ch-set psk random --ch-index 0 |
-
Stel versleuteling in op een enkele byte op het PRIMAIRE kanaal
| meshtastic --ch-set psk simple15 --ch-index 0 |
-
Stel versleuteling in op je eigen sleutel op het PRIMAIRE kanaal
| meshtastic --ch-set psk 0x1a1a1a1a2b2b2b2b1a1a1a1a2b2b2b2b1a1a1a1a2b2b2b2b1a1a1a1a2b2b2b2b --ch-index 0 |
-
Stel versleuteling in op je eigen sleutel op het PRIMAIRE kanaal (Base64 gecodeerd)
| meshtastic --ch-set psk base64:puavdd7vtYJh8NUVWgxbsoG2u9Sdqc54YvMLs+KNcMA= --ch-index 0 |
-
Versleuteling uitschakelen op het PRIMAIRE kanaal
| meshtastic --ch-set psk none --ch-index 0 |
OPMERKING: Gebruik dit om de base64-gecodeerde (enkel kanaal) sleutel van de meshtastic --info opdracht te kopiëren en plakken. Vermijd het gebruik van de omnibus (alle kanalen) code hier, omdat dit geen geldige sleutel is.
Uplink / Downlink
Voor het configureren van gateways, zie MQTT
-
Uplink in-/uitschakelen op PRIMAIR kanaal
| meshtastic --ch-set uplink_enabled true --ch-index 0 meshtastic --ch-set uplink_enabled false --ch-index 0 |
-
Downlink in-/uitschakelen op SECUNDAIR kanaal
| meshtastic --ch-set downlink_enabled true --ch-index 1 meshtastic --ch-set downlink_enabled false --ch-index 5 |
Positienauwkeurigheid configureren
Dit is een per-kanaal instelling. De parameter --ch-index moet worden opgegeven om de positienauwkeurigheid voor een specifiek kanaal in te stellen, bijvoorbeeld --ch-index 0 voor het primaire kanaal of --ch-index 1 voor het secundaire kanaal 1.
-
Stel positienauwkeurigheid in op 13 bits (ongeveer ±3 km)
| meshtastic --ch-set module_settings.position_precision 13 --ch-index 0 |
-
Stel positienauwkeurigheid in op volledige precisie (32 bits)
| meshtastic --ch-set module_settings.position_precision 32 --ch-index 1 |
Web
Alle Channel config-opties zijn toegankelijk in de Web UI.
QR-code
De Meshtastic QR-code (of Channel URL) stelt gebruikers in staat om snel kanaal- en LoRa-instellingen te delen, waardoor het proces van het configureren van meerdere nodes met overeenkomende communicatie-instellingen wordt vereenvoudigd. Het scannen van een QR-code past alle inbegrepen kanaalinstellingen en LoRa-configuratie-instellingen toe, dus zorg ervoor dat u bekijkt wat deze instellingen omvatten voordat u doorgaat. Scan alleen QR-codes van vertrouwde bronnen.
Voor meer details, zie:
