Menü Schließen

NET-Console

  • Serielle TCP-Bridge mit HMAC-SHA256-Challenge-Response-Authentifizierung
  • Port 2323
  • Einzelner Client, Klartextdaten, kein TLS-Overhead
  • Verwendet mbedtls/md.h (bereits in ESP-IDF enthalten)
  • Keine zusätzliche Bibliothek, kein Flash-Overhead
  • RAM-Bedarf während einer aktiven Sitzung: ~0 KB
    (gegenüber 36 KB für TLS-I/O-Puffer).
  • Author: Ralf Altenbrand (DH1FR), 05/2026

Die NET-Console wird von mit ESP32 basierender Node-Hardware unterstützt.

Das Kommunikations-Port 2323 wird auf der konfigurierte WiFi-Verbindung aktiviert welche als WEBService oder Gateway in Verwendung ist.

Kommandos zur Steuerung der Firmware

  • Aktivierung
    • –netconsole on/off
  • Statusabfrage
    • –netconsole
  • Passwort setzen
    • –passwd xxxxx (max. 14 Zeichen)
  • Passwort löschen
    • –passwd none 

 

Damit auf die Funktion des NET-Console-Ports (2323) zugegriffen werden kann benötigt man einen LINUX-, WINDOWS- oder MAC-TELNET-Client.

  • Windows
    • PUTTY
      • Host-Name aa9xxx-99.local (oder MeshCom-Node IP-Adresse)
      • Session Other: Telnet
      • Category: Terminal (Implicit CR in every LF) anhaken
    • TELNET Client für Windows nicht geeignet weil CR nach LF bei der Ausgabe nicht ergänzt wird
  • Linux
    • TELNET
      • telnet 192.168.100.24 2323
      • telnet aa9xxx-99.local 2323
  • MAC
    Der Telnet-Befehl ist auf modernen Macs standardmäßig nicht mehr installiert, da Telnet unverschlüsselt ist. Der einfachste Weg, den Client wieder auf Ihrem Mac verfügbar zu machen, ist die Installation über das Paketverwaltungsprogramm Homebrew.

    • telnet [Hostname/IP-Adresse] [Portnummer]
      • telnet 192.168.100.24 2323
      • telnet aa9xxx-99.local 2323

Die NETConsole nach connect ohne gesetztes Passwort:

root@MESHCOM:~# telnet oe1kbc-24.local 2323
Trying 192.168.100.24…
Connected to oe1kbc-24.local.
Escape character is ‚^]‘.
OK
MeshCom Console
Type –help for commands
–info (Befehle werden wie voa Serielle-Console eingegeben)

<<<Info wird angezeigt>>>

Die NETConsole nach connect mit gesetztes Passwort:

root@MESHCOM:~# telnet oe1kbc-55.local 2323
Trying 192.168.100.246…
Connected to oe1kbc-55.local.
Escape character is ‚^]‘.
NONCE: 3e62d1be9d352ffcbd2edcc5cfa07b36
passwort<cr>
OK
MeshCom Console
Type –help for commands
–info (Befehle werden wie voa Serielle-Console eingegeben)

<<<Info wird angezeigt>>>

TELNET Fenster schließen meldet sich vom MeshCom-Node wieder ab.

Es ist immer nur eine aktive Session mit einem MeshCom-Node möglich.

Für die Anmeldung mit Passwort steht auch ein Variante mit verschlüsseltem Passwort zur Verfügung

  • Protocol:
    • <- „NONCE: <32 hex chars>\r\n“
    • -> „<64 hex HMAC-SHA256(password, nonce)>\r\n“
    • <- „OK\r\n<banner>“  or  „FAIL\r\n“ + disconnect
  • Python helper (hmac_connect.py):
    • import sys, socket, hmac, hashlib
    • s = socket.create_connection((sys.argv[1], 2323))
    • nonce = bytes.fromhex(s.makefile().readline().split()[1].strip())
    • resp  = hmac.new(sys.argv[2].encode(), nonce, hashlib.sha256).hexdigest()
    • s.sendall((resp + chr(10)).encode()); print(s.makefile().readline())