Menu Chiudi

Interfaccia UDP per software client esterno

I messaggi di testo e di posizione inviati dal server MeshCom tramite LoRa-RX o l'ingresso UDP vengono trasmessi all'interfaccia UDP esterna nel formato JSON, mentre i messaggi di testo ricevuti dall'interfaccia UDP esterna vengono inviati tramite LoRa-TX o UDP al server MeshCom.

Protocollo dell'interfaccia esterna

  • inviare al client esterno tramite la porta UDP 1799
    • Posizioni
      • {„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>,“firmware“:“<fw_num>“,“fw_sub“:“<fw_sub>,“rssi“:<int>,“snr“:<int>“
        }

        • nodo… Il messaggioproviene dal ricevitore LoRa
        • udp… Il messaggioproviene dal server MeshCom
        • lora… Il messaggioproviene dal ricevitore LoRa
        • msg_id…vienerappresentato in formato esadecimale
        • fw_num…Firmwaredel nodo
        • fw_sub…Informazioni aggiuntive sul firmwaredalla A alla Z
    • Messaggi di testo
      • {„src_type“:“node/udp/lora„,“type“:“msg„,“src“:“<source_path>“,
        „dst“:“<destination_path>“,“msg“:“<payload>“,“msg_id“:“<msg_id>“,“firmware“:“<fw_num>“,“fw_sub“:“<fw_sub>“},“rssi“:<int>,“snr“:<int>“
        • nodo… Il messaggioproviene dal ricevitore LoRa
        • udp… Il messaggioproviene dal server MeshCom
        • lora… Il messaggioproviene dal ricevitore LoRa
        • fw_num…Firmwaredel nodo
        • fw_sub…Informazioni aggiuntive sul firmwaredalla A alla Z
    • Telemetria (utilizzata solo per il proprio nodo e ricevuta direttamente tramite LoRa) pos (trasmissione di ulteriori segnalazioni)
      • {„src_type“:“nodo„, „type“: „:“tele„,,“src“:“Percorso sorgente“,”temp1“:9,99,”temp2“:9,99,”ehm“:9,99,”qfe“;999,9,”qnh“:999,9,”gas“:9.9,”CO₂„:9.9}
        • node… La telemetriaproviene dal Node
        • tele…TipoTelemetria
  • ricevuto dal client esterno
        • Messaggi di testo
          • {„type“:“msg„,“dst“:“<destination_callsgin_or_group_or_*>“,“msg“:“<payload>“}
  • Definizioni
    • <source_path> ein oder mehrere Rufzeichen
      • Esempi:
        • OE1ABC-1
          • Questo segnale di chiamata è stato udito direttamente
        • OE1ABC-1, OE1XOR-12
          •  OE1ABC-1 è stato ascoltato tramite OE1XOR
    • <destination_path>
      • A tutti
        • * (Stern)
      • a un gruppo
        • 10…99999 (da due a cinque cifre)
      • a un indicativo di chiamata diretto
        • OE1KBC-12
    • <payload>
      • set di caratteri UTF-8 valido
      • max. 150 caratteri
    • <msg_id>
      • numero univoco del messaggio
        • Deve essere composto dall'indirizzo MAC e da un numero progressivo di almeno 3 cifre
    • <lat>
    • <lon>
      • Latitudine e longitudine con 99,9999 cifre decimali
    • N/S
    • W/E
      • Definizione del quadrante a cui si riferiscono i dati di geolocalizzazione.
    • Simboli APRS secondo la tabella dei simboli APRS
    • <batt_proz>
      • 0-100

Attivazione dell'interfaccia UDP esterna:

La porta UDP viene attivata tramite l'interfaccia USB del nodo:

  • Parametri di connessione al client esterno
    • –-extudpip 255.255.255.255
  • Attivare la porta UDP 1799
    • –-extudp on

 

  • Disattivare la porta UDP 1799
    • –-extudp off

Altre impostazioni necessarie

Per poter stabilire una connessione UDP, è necessario definire l'interfaccia Wi-Fi.

  • –setssid WIFIssid
  • –setpwd password Wi-Fi

Se la propria interfaccia Wi-Fi non riceve l'indirizzo IP tramite DHCP dal router Wi-Fi (AP), è possibile impostarlo in modo statico.

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

L'indirizzo IP assegnato manualmente deve essere un indirizzo libero della rete domestica. Come gateway va indicato l'indirizzo del router Wi-Fi. La subnet mask deve essere impostata in modo da corrispondere alla rete domestica.