Menü Schließen

UDP-Schnittstelle für externe Client-Software

Es werden Text- und Positions-Meldungen welche über LoRa-RX oder UDP-Eingang vom MeshCom-Server an die externe UDP-Schnittstelle als JSON-Protokoll gesendet und es werden Text-Meldungen welche von der externen UDP-Schnittstelle einlagen an die LoRa-TX oder UDP zum MeshCom-Server gesendet.

Protokoll der externen Schnittstelle

  • senden an den externen Client vai UDP-Port 1799
    • Positionen
      • {„src_type“:“node/udp/lora„,“type“:“pos„,“src“:“<source_path>“,“msg“:““,“lat“:<lat>,“lat_dir“:“N/S„,
        „long“:<lon>,“long_dir“:“W/E„,“aprs_symbol“:“<SYM>“,“<aprs_symbol_group>“:“<GROUP>“,
        „hw_id“:“<MAC>“,“msg_id“:“<msg_id>“,“alt“:<alt>,“batt“:<batt_proz>}

        • node…Meldung kommt vom LoRa-RX
        • udp…Meldung kommt vom MeshCom-Server
        • lora…Meldung kommt vom LoRa-RX
        • msg_id…wird als hexadezimal dargestellt
    • Textmeldungen
      • {„src_type“:“node/udp/lora„,“type“:“msg„,“src“:“<source_path>“,
        „dst“:“<destination_path>“,“msg“:“<payload>“,“msg_id“:“<msg_id>“}
        • node…Meldung kommt vom LoRa-RX
        • udp…Meldung kommt vom MeshCom-Server
        • lora…Meldung kommt vom LoRa-RX
  • empfangen vom externen Client
    • Textmeldungen
      • {„type“:“msg„,“dst“:“<destination_path>“,“msg“:“<payload>“}
  • Definitionen
    • <source_path> ein oder mehrere Rufzeichen
      • Beispiele:
        • OE1ABC-1
          • Dieses Rufzeichen wurde direkt gehört
        • OE1ABC-1,OE1XOR-12
          •  OE1ABC-1 wurde via OE1XOR gehört
    • <destination_path>
      • an Alle
        • * (Stern)
      • an eine Gruppe
        • 10…99999 (zwei bis 5-stellig)
      • an ein direktes Rufzeichen
        • OE1KBC-12
    • <payload>
      • gültiger UTF-8 Zeichensatz
      • max. 150 Zeichen
    • <msg_id>
      • eindeutige Meldungsnummer
        • Sollte aus MAC-Adresse und zumindest 3-stelliger fortlaufenden Zahl bestehen
    • <lat>
    • <lon>
      • Breitengrad und Längengrad in 99.9999 Dezimal-Darstellung
    • N/S
    • W/E
      • Festlegung in welchem Quadrant die Geo-Positionsdaten gelten.
    • APRS-Symbole laut APRS-Symbol Tabelle
    • <batt_proz>
      • 0-100

Aktivierung der externen UDP-Schnittstelle:

Das UDP-Port wird über USB-Schnittstelle des Nodes aktiviert:

  • Verbindungsparameter zu externem Client
    • –-extudpip 255.255.255.255
  • UDP-Port 1799 aktivieren
    • –-extudp on

 

  • UDP-Port 1799 deaktivieren
    • –-extudp off

Notwendige sonstige Einstellungen

Damit eine UDP-Schnittstelle aufgebaut werden kann ist die WiFi-Schnittstelle zu definieren.

  • –setssid WIFIssid
  • –setpwd WIFIpasswort

Wenn die eigene WiFi-Schnittstelle nicht die IP-Adresse via DHCP vom WiFi-Router (AP) bekommen dann kann diese auch fixiert werden.

  • –setownip 255.255.255.255
  • –setowngw 255.255.255.255
  • –setownms 255.255.255.255

Die händisch vergebene IP-Adresse muss eine aus dem Heim-Netzwerk, welche frei ist, sein. Die Angabe des Gateways muss die Adresse den WiFi-Routers sein. Die Maske muss passen zum Heim-Netzwerk gesetzt werden.