Die Konfiguration eines Nodes kann über das Self-Service-Portal oder über USB verändert werden.

Manche Einstellungen benötigen einen Neustart des Nodes um wirksam zu werden.

===== USB-Konfiguration =====

Für die Konfiguration über USB wird eine Software benötigt, die über einen seriellen Port ein Terminal bereitstellen kann, wie z.B.:
  * [[https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html|PuTTY]]
  * [[https://pyserial.readthedocs.io/en/latest/tools.html#module-serial.tools.miniterm|PySerial miniterm]]

Der Node muss über die rechte USB-C-Buchse, direkt links neben dem Ethernet-Port, mit dem Computer verbunden werden. Die linke USB-C-Buchse kann für diesen Zweck nicht verwendet werden.

Für die serielle Verbindung müssen in der Software die folgenden Parameter eingestellt werden:
  * Name des seriellen Ports (z.B. ''COM3'' unter Windows oder ''/dev/ttyACM0'' unter Linux)
  * Baudrate: 115200
  * Datenbits: 8
  * Parität: None/N/Keine
  * Stoppbits: 1

Nach dem Öffnen der Verbindung sollte beim Drücken der Eingabetaste ein Prompt erscheinen, z.B.:
<code>
node1234>
</code>

Es können nun Befehle eingegeben oder per Copy&Paste eingefügt werden. Es werden zwischendurch aber auch Logzeilen ausgegeben. Sollte während der Eingabe eines Befehls eine Logzeile ausgegeben werden, kann die Eingabe trotzdem normal fortgesetzt werden.

===== Konfigurationsbefehle =====

==== config_get ====

Syntax: ''config_get <Parameter>''

Liest den Wert des angegebenen Parameters und gibt ihn auf dem Terminal aus.

==== config_set ====

Syntax: ''config_set <Parameter> <Wert>''

Setzt den angegebenen Config-Parameter auf den angegebenen Wert. Der neue Wert wird sofort im Flash gespeichert.

==== config_clear ====

Syntax: ''config_clear <Parameter>''

Löscht den Wert des angegebenen Parameters, falls zuvor ein Wert gesetzt wurde. Das Löschen des Werts wird sofort im Flash angewendet.

===== Beispiele =====

==== Statische IP ====

Um auf dem Ethernet-Interface eine statische IP einzurichten, müssen die folgenden Parameter gesetzt werden:
  * ''ethip'' – IP-Adresse
  * ''ethnm'' – Subnetzmaske
  * ''ethgw'' – Standardgateway
  * ''ethdns0'' – Primärer DNS-Server
  * ''ethdns1'' – Sekundärer DNS-Server
  * ''ethdns2'' – Tertiärer DNS-Server (optional)

Um z.B. die IP-Adresse **192.168.123.45** mit Präfixlänge **/24**, dem Gateway **192.168.123.1**, und den DNS-Servern **8.8.8.8** und **1.1.1.1** zu konfigurieren, sind die folgenden Befehle notwendig:
<code>
config_set ethip 192.168.123.45
config_set ethnm 255.255.255.0
config_set ethgw 192.168.123.1
config_set ethdns0 8.8.8.8
config_set ethdns1 1.1.1.1
</code>

Die vollständige Liste der config Parameter ist hier in der Firmware: [[https://codeberg.org/opentrafficmap/its-g5-receiver-firmware/src/branch/main/main/config.c#L63]]