Channel

Kanaalconfiguratie

De kanaalconfiguratie-opties zijn: **Index**, **Rollen**, en **Instellingen**. Kanaalconfiguratie gebeurt door een admin-bericht te sturen met een `Channel` protobuf, die op zijn beurt een `ChannelSettings` of `ModuleSettings` protobuf bevat.

Let op: de “Kanaalinstellingen” op deze pagina moeten niet verward worden met de modem-presetinstellingen. De modem-presetinstellingen (frequentie, spreiding, bandbreedte, etc.) gelden *voor alle* kanalen en **kunnen niet uniek per kanaal zijn**. Kanaalinstellingen (zoals encryptie, uplink/downlink, kanaalnaam) **zijn wel** uniek per kanaal.

Kanaalconfiguratiewaarden

Index

De kanaalindex loopt van 0 tot 7. De indexering kan niet gewijzigd worden.

Index	Kanaal	Standaardrol	Doel
0	1	PRIMARY	Gebruikt als standaard (primary) kanaal
1	2	DISABLED	Door gebruiker te definiëren
2	3	DISABLED	Door gebruiker te definiëren
3	4	DISABLED	Door gebruiker te definiëren
4	5	DISABLED	Door gebruiker te definiëren
5	6	DISABLED	Door gebruiker te definiëren
6	7	DISABLED	Door gebruiker te definiëren
7	8	DISABLED	Door gebruiker te definiëren

Opmerking: Je mag geen “DISABLED” kanalen tussen actieve kanalen hebben (zoals tussen PRIMARY en SECONDARY). Actieve kanalen moeten opeenvolgend zijn.

Rol (Role)

Elk kanaal krijgt één van drie mogelijke rollen:

1. `PRIMARY` of `1`

Dit is het eerste kanaal dat tijdens de initiële configuratie wordt aangemaakt.

Er kan maar één PRIMARY bestaan, en deze kan niet uitgeschakeld worden.

Periodieke uitzendingen zoals positie en telemetrie worden alleen via dit kanaal gedaan.

1. `SECONDARY` of `2`

Kan een andere encryptiesleutel (PSK) hebben dan het PRIMARY-kanaal.

1. `DISABLED` of `0`

Het kanaal is niet beschikbaar voor gebruik.

De instellingen worden gereset naar standaard.

Opmerking: hoewel je kunt communiceren via SECONDARY kanalen met dezelfde naam & PSK, bepaalt een hash van de PRIMARY kanaalnaam welke frequentieslot gebruikt wordt. Als apparaten verschillende PRIMARY-kanaalnamen hebben, maar je wilt toch dat ze op dezelfde frequentie uitzenden, moet je de LoRa frequentieslot handmatig instellen.

Kanaalinstellingen (Channel Settings)

De kanaalinstellingen omvatten: **Naam (Name)**, **PSK (encryptiesleutel)**, **Downlink Enabled**, en **Uplink Enabled**. Deze instellingen zitten in de `ChannelSettings` binnen de `Channel` protobuf.

= Naam (Name)

Een korte identificator voor het kanaal (minder dan 12 bytes).

Gereserveerde naam	Doel
`""` (leeg)	Als leeg op het primaire kanaal, wordt dit het “default” kanaal
`admin`	Op secondary kanalen: deze naam “admin” (hoofdlettergevoelig) betekent het beheer-kanaal binnen de mesh.

Opmerking: De kanaalnaam *moet* overeenkomen bij apparaten om op hetzelfde kanaal te kunnen communiceren.

= PSK (encryptiesleutel)

De encryptiesleutel voor privékanalen. Toegestane lengtes: 0 bytes (geen encryptie), 16 bytes (AES128), of 32 bytes (AES256). De primaire standaard PSK is `0x01`.

Opmerking: PSK’s moeten overeenkomen tussen apparaten om te kunnen communiceren op hetzelfde kanaal.

= Downlink Enabled

Wanneer ingeschakeld: berichten van een **publieke** internetgateway worden doorgestuurd naar het lokale mesh. Standaard uitgeschakeld voor alle kanalen.

= Uplink Enabled

Wanneer ingeschakeld: berichten van het mesh worden doorgestuurd naar het publieke internet via een geconfigureerde gateway. Standaard uitgeschakeld voor alle kanalen.

Module-instellingen per kanaal

Naast de basis kanaalinstellingen kunnen kanalen module-instellingen hebben. Eén belangrijke is **position_precision** (positieprecisie).

Positieprecisie (Position Precision)

Met de instelling `position_precision` kun je het detailniveau van locatiegegevens instellen dat over dat kanaal wordt verzonden. Dit kan nuttig zijn voor privacy: je kunt minder precieze posities verschaffen op bepaalde kanalen.

Waarden: integer tussen 0 en 32

• 0 → locatiegegevens worden nooit verzonden via dat kanaal
• 32 → volledige precisie
• Tussen 0 en 32 → aantal bits van precisie

Let op: publieke MQTT-servers filteren gedetailleerde posities. De clients bieden gebruiksvriendelijke grenzen, maar via de CLI kun je elk getal instellen.

Beschikbaarheid van kanaalconfiguratie in clients

Beschikbaar in:

• Android
• Apple (iOS, iPadOS, macOS)
• CLI
• Web UI

Android

Kanaalconfiguratie-opties zijn beschikbaar in de Android-app. Via het tabblad Radio Configuration kun je:

1. Je huidige kanaalconfiguratie bekijken (QR-code & URL)
2. Snel primaire kanaal maken of wijzigen
3. Modem preset voor alle kanalen selecteren

Tap “Edit” om:

• Secondary kanalen toe te voegen, te verwijderen of wijzigen
• Encryptiesleutels aan te passen
• Uplink / Downlink per kanaal in te schakelen
• Positie inschakelen of uitschakelen
• Nauwkeurigheid van positie instellen

Apple

De iOS / iPadOS / macOS apps bieden kanaal-editor via: Instellingen > Radio Configuration > Channels

CLI

Alle kanaalconfiguratie-opties zijn beschikbaar via de Python CLI.

Voorbeeldcommando’s:

meshtastic --ch-set name "MijnKanaal" --ch-set psk random --ch-set uplink_enabled true --ch-index 4

meshtastic --ch-set name MyChannel --ch-index 0

meshtastic --ch-set psk default --ch-index 0
meshtastic --ch-set psk random --ch-index 0
meshtastic --ch-set psk simple15 --ch-index 0

meshtastic --ch-set uplink_enabled true --ch-index 0
meshtastic --ch-set downlink_enabled false --ch-index 1

Om positieprecisie in te stellen:

meshtastic --ch-set module_settings.position_precision 13 --ch-index 0

meshtastic --ch-set module_settings.position_precision 32 --ch-index 1

Web

Alle kanaalconfiguratie-opties zijn beschikbaar in de Web UI.