Ga naar inhoud

Systeem

NAAM · LOCATIE · SLEUTELS · WACHTWOORDEN · ROL

Instellingen die de node zelf beschrijven: naam, locatie, eigenaar, sleutelpaar en wachtwoorden, plus de batterijcorrectie en de energiebesparing van de repeater.

Opmerking

Bron. Deze pagina is geverifieerd tegen de firmware zelf: MeshCore v1.17.1, commit d929643, 14 augustus 2026 — bestanden src/helpers/CommonCLI.cpp, src/helpers/CommonCLI.h, examples/simple_repeater/MyMesh.cpp, examples/simple_repeater/main.cpp, examples/simple_repeater/MyMesh.h, examples/simple_room_server/MyMesh.h, examples/simple_sensor/SensorMesh.h, src/MeshCore.h, src/helpers/AdvertDataHelpers.cpp, src/helpers/UTF8Helpers.h, en de officiële docs/cli_commands.md. Regelnummers verwijzen naar deze commit en zijn te reproduceren met tools/cli-commands.py.

Overzicht

De markeringen in de kolom Rol zijn uitgelegd in de CLI-referentie. Een lege cel betekent: werkt op repeater, room server en sensor.

Commando Rol Standaard Alleen serieel Bron
get name / set name <name> R repeater · RS Test BBS · S sensor ¹ CommonCLI.cpp r.523, r.837
get lat / set lat <degrees> / get lon / set lon <degrees> 0.0 CommonCLI.cpp r.606, r.610, r.841, r.843
get prv.key / set prv.key <private_key> — alleen get CommonCLI.cpp r.510, r.832
password <new_password> password CommonCLI.cpp r.256
get guest.password / set guest.password <password> effect: repeater, room server RS ROOM_PASSWORD ¹, anders leeg CommonCLI.cpp r.506, r.830
get owner.info / set owner.info <text> effect: repeater leeg CommonCLI.cpp r.668, r.876
get adc.multiplier / set adc.multiplier <value> 0.0 (waarde van het board) CommonCLI.cpp r.766, r.946
get public.key — CommonCLI.cpp r.902
get role — CommonCLI.cpp r.905
powersaving / powersaving on / powersaving off effect: repeater off CommonCLI.cpp r.401–419

Commando's

name

De naam in de adverts. Het veld is 32 bytes (CommonCLI.h r.27). De tekens [ ] \ : , ? * zijn niet toegestaan; dan is het antwoord Error, bad chars.

In de advert zelf is minder ruimte. Het hele appdata-blok is 32 bytes (MAX_ADVERT_DATA_SIZE, MeshCore.h r.12), waarvan één byte naar de vlaggen gaat en acht naar de locatie als die wordt meegestuurd. Er blijft dus 31 byte naam over zonder locatie en 23 byte met locatie. Wat niet past wordt afgekapt op een geldige UTF-8-codepointgrens (AdvertDataHelpers.cpp r.21, UTF8Helpers.h); een emoji of een letter met diakriet kost meer dan één byte en gaat dus in zijn geheel weg. Tot en met v1.16.0 werd de naam byte voor byte gekopieerd tot het blok vol was, waardoor een teken halverwege kon worden afgekapt.

Voorbeeld:

set name PE1HVH Repeater
  -> OK
get name
  -> > PE1HVH Repeater

¹ Terugvalwaarden van ADVERT_NAME; de meeste builds zetten een eigen naam.

lat / lon

Breedte- en lengtegraad in decimale graden, zonder controle op het bereik. get gebruikt dezelfde float-weergave als get radio. De locatie gaat mee in de adverts, afhankelijk van gps advert.

Voorbeeld:

set lat 52.5168
  -> OK
get lat
  -> > 52.5167999
set lon 6.083
  -> OK
get lon
  -> > 6.0830001

prv.key

Het sleutelpaar van de node. set verwacht de privésleutel als 128 hextekens (PRV_KEY_SIZE 64, MeshCore.h r.9), controleert hem, en antwoordt met de nieuwe public key; de wissel gaat in na een herstart. get werkt alleen via de seriële console. De officiële documentatie spreekt van 64 hextekens.

Voorbeeld:

set prv.key 00
  -> Error, bad key

Bij een geldige sleutel is het antwoord OK, reboot to apply! New pubkey: gevolgd door 64 hextekens.

password

Het beheerderswachtwoord, maximaal 15 tekens (CommonCLI.h r.29). Het antwoord herhaalt het nieuwe wachtwoord.

Voorbeeld:

password Zwolle2026
  -> password now: Zwolle2026

Waarschuwing

De standaard password is voor iedereen bekend. Zolang die staat, kan elke client met dat wachtwoord de node beheren.

guest.password

Het wachtwoord voor gewone deelnemers, maximaal 15 tekens (CommonCLI.h r.37). Repeater en room server gebruiken het bij het inloggen (simple_repeater/MyMesh.cpp r.104, simple_room_server/MyMesh.cpp r.348). Zie Inloggen en de ACL.

Voorbeeld:

set guest.password zwolle
  -> OK
get guest.password
  -> > zwolle

¹ Alleen als de build ROOM_PASSWORD zet (simple_room_server/MyMesh.cpp r.668–670). De officiële documentatie noemt leeg als standaard.

owner.info

Vrije tekst over de eigenaar, maximaal 119 tekens (CommonCLI.h r.65). Een | wordt opgeslagen als regeleinde en bij get weer als | getoond. Alleen de repeater doet er iets mee (simple_repeater/MyMesh.cpp r.177, r.373).

Voorbeeld:

set owner.info PE1HVH|Zwolle
  -> OK
get owner.info
  -> > PE1HVH|Zwolle

adc.multiplier

Correctiefactor voor de batterijmeting. 0 zet de waarde van het board terug. Ondersteunt het board het niet, dan is het antwoord Error: unsupported by this board; get geeft datzelfde antwoord als het board geen factor heeft.

Voorbeeld:

set adc.multiplier 1.05
  -> OK - multiplier set to 1.050
set adc.multiplier 0
  -> OK - using default board multiplier

public.key

De public key van de node als 64 hextekens.

Voorbeeld (voorbeeldsleutel uit tools/dm-example.py):

get public.key
  -> > EA1F69C38A415ABDD55590ECC796DE3D04FE6D80FAEE006A37021432804CBDCC

role

De rol waarvoor de firmware is gebouwd: repeater, room_server of sensor (FIRMWARE_ROLE in de drie rolbestanden).

Voorbeeld:

get role
  -> > repeater

powersaving

Laat de repeater slapen als er niets te doen is. Alleen de hoofdlus van de repeater leest de vlag (simple_repeater/main.cpp r.198). Het antwoord op powersaving on hangt af van het platform: op nRF52 on - Immediate effect, op ESP32 on - After 2 minutes, bij een build met bridge Bridge not supported en elders Board not supported. Zonder argument toont het commando on of off.

Voorbeeld (nRF52, zoals de SenseCap Solar):

powersaving on
  -> on - Immediate effect
powersaving
  -> on

Bronnen