Detail brány

Detail brány poskytuje ucelený přehled o vybrané bráně a umožňuje spravovat všechny její související informace. Brána je klíčovým prvkem v síti LoRaWAN, který obousměrně přenáší data mezi koncovými zařízeními (jako jsou svítidla, senzory nebo čidla) a síťovým serverem. Slouží jako komunikační most zajišťující bezdrátový přenos dat na velké vzdálenosti.

Rozložení obrazovky

Na vrchní části obrazovky se nachází navigační panel. Pod ním je umístěn blok, který obsahuje:

Na levé straně název entity (jméno brány, např. "MikroTik")
Na pravé straně akční tlačítka:
- Smazat - umožňuje odstranění brány ze systému
- Upravit - otevře formulář pro editaci údajů brány

Pod tímto blokem se nachází záložky pro navigaci mezi různými sekcemi:

Základní informace - obsahuje základní údaje o bráně
Rámce - zobrazuje komunikační rámce procházející přes bránu

Základní informace

Záložka Základní informace zobrazuje detailní údaje o bráně.

Základní údaje

V této sekci jsou uvedeny základní identifikační údaje o bráně:

Název brány - název používaný pro identifikaci brány v systému (např. "MikroTik")
EUI (Extended Unique Identifier) - jedinečný identifikátor brány ve formátu hexadecimálního řetězce (např. "45:4e:49:4b:41:30:30:31")
Stav - aktuální stav připojení brány (online/offline) indikovaný barevným označením
Popis - doplňující informace o bráně (např. "Brána na střeše společnosti")
Poslední odpověď - datum a čas poslední komunikace brány se serverem
Interval statistik [sekundy] - frekvence odesílání statistických dat z brány (např. "30")

Na pravé straně sekce se nachází unikátní identifikátor brány (např. "#AhN6VLPrXsROMZFlhdmf"), který může být použit pro referenci v technické podpoře nebo při řešení problémů.

Umístění

Sekce Umístění zobrazuje geografické souřadnice brány:

Zeměpisná šířka - souřadnice zeměpisné šířky (např. "50.4788821219724")
Zeměpisná délka - souřadnice zeměpisné délky (např. "15.5020201206207")
Výška [m] - nadmořská výška v metrech (může být prázdná)

Pod těmito údaji je zobrazena interaktivní mapa s označením polohy brány. Mapa umožňuje přiblížení, oddálení a zobrazení různých vrstev pomocí ovládacích prvků na levé straně.

Rámce

Záložka Rámce zobrazuje komunikační LoRaWAN rámce, které byly přeneseny prostřednictvím této brány. Tyto rámce představují skutečnou komunikaci mezi koncovými zařízeními a síťovým serverem.

Automatická aktualizace

V pravém horním rohu sekce se nachází indikátor "Automaticky aktualizováno každou minutu", který informuje o tom, že seznam rámců je pravidelně obnovován pro zobrazení aktuálních dat.

Seznam rámců

Seznam rámců je zobrazen v tabulce s následujícími sloupečky:

Čas - datum a čas, kdy byl rámec odeslán nebo přijat
Typ - typ rámce s barevným označením směru:
- Unconfirmed Data Up - nepotvrzované data směrem nahoru (z koncového zařízení do sítě)
- Unconfirmed Data Down - nepotvrzované data směrem dolů (ze sítě do koncového zařízení)
- {} Acknowledge - potvrzení přijetí dat
Adresa zařízení - identifikátor koncového zařízení, které komunikovalo přes bránu
- Modrý bod ● před adresou označuje, že zařízení patří do vaší sítě a lze na něj kliknout pro zobrazení detailu zařízení
Data - dodatečné informace o komunikaci, jako jsou:
- fPort - číslo portu použitého pro komunikaci (např. "fPort: 16")
- RSSI - Received Signal Strength Indicator, síla přijatého signálu v dBm (např. "RSSI: -89 dBm")
- SNR - Signal-to-Noise Ratio, poměr signálu k šumu v dB (např. "SNR: 5.3 dB")

Typ je zobrazen jako tlačítko, které po kliknutí zobrazí detailní informace o rámci v pravém postranním panelu.

Detail rámce

Po kliknutí na tlačítko za řádkem se zobrazí detailní informace o daném rámci v pravém postranním panelu. Obsah panelu se liší podle typu rámce.

Detail downlink rámce

Detail downlink rámce (směr ze sítě do koncového zařízení) zobrazuje strukturované informace o rámci ve formátu JSON, včetně:

{
  "phy_payload": {
    "mhdr": {
      "m_type": "Unconfirmed Data Down"
    },
    "mic": [95, 47, 47, 79],
    "payload": {
      "f_port": 64,
      "fhdr": {
        "dev_addr": "89c77978",
        "f_cnt": 15603,
        "f_ctrl": {
          "ack": false,
          "adr": false,
          "adr_ack_req": false,
          "class_b": false,
          "f_opts_len": 0,
          "f_pending": false
        },
        "f_opts": []
      },
      "frm_payload": "36c107dc7a5ef1261b319a3a"
    }
  },
  "tx_info": {
    "frequency": 867500000,
    "modulation": {
      "lora": {
        "bandwidth": 125000,
        "spreading_factor": 12,
        "code_rate": "CR_4_5"
      }
    }
  },
  "rx_info": {
    "gateway_id": "454e494b41303031",
    "uplink_id": 42241,
    "gw_time": "2025-05-04T17:00:14.909426Z",
    "pc_time": "2025-05-04T17:00:14.955Z",
    "rssi": -111,
    "snr": -4.25,
    "channel": 5,
    "context": "gjCITA==",
    "crc_status": "CRC_OK"
  }
}

Detail uplink rámce

Detail uplink rámce (směr z koncového zařízení do sítě) zobrazuje podobné informace jako downlink, ale s rozdílem v obsahu a směru:

{
  "phy_payload": {
    "mhdr": {
      "m_type": "Unconfirmed Data Up"
    },
    "mic": [152, 42, 112, 153],
    "payload": {
      "f_port": 16,
      "fhdr": {
        "dev_addr": "00d3c7fb",
        "f_cnt": 336,
        "f_ctrl": {
          "ack": false,
          "adr": true,
          "adr_ack_req": false,
          "class_b": false,
          "f_opts_len": 0,
          "f_pending": false
        },
        "f_opts": []
      },
      "frm_payload": "cf4311900b7e58a1285de147b2aabfe5"
    }
  },
  "tx_info": {
    "frequency": 868100000,
    "modulation": {
      "lora": {
        "bandwidth": 125000,
        "spreading_factor": 7,
        "code_rate": "CR_4_5"
      }
    }
  },
  "rx_info": {
    "gateway_id": "454e494b41303031",
    "uplink_id": 1281,
    "gw_time": "2025-05-04T17:02:03.591297Z",
    "pc_time": "2025-05-04T17:02:03.611Z",
    "rssi": -97,
    "snr": 5.5,
    "rf_chain": 1,
    "context": "iKrl2w==",
    "crc_status": "CRC_OK"
  }
}

Detail acknowledge rámce

Detail acknowledge rámce zobrazuje informace o potvrzení přijetí dat:

{
  "gateway_id": "454e494b41303031",
  "downlink_id": 2825732308,
  "items": [
    {
      "status": "OK"
    }
  ]
}

Význam bran v systému

Brány hrají klíčovou roli v architektuře LoRaWAN sítě:

Přenos dat - zajišťují bezdrátovou komunikaci mezi koncovými zařízeními a serverovou infrastrukturou
Pokrytí území - strategicky umístěné brány poskytují pokrytí signálem pro rozsáhlé oblasti
Zpracování signálu - přijímají slabé signály ze vzdálených zařízení a předávají je do backendových systémů
Monitorování provozu - umožňují sledování kvality komunikace a diagnostiku problémů v síti

Princip LoRaWAN komunikace

Komunikační rámce zobrazené v systému POSEIDON City jsou předávány mezi následujícími komponentami:

Koncové zařízení ↔ Brána ↔ Chirpstack Gateway Bridge ↔ MQTT ↔ Chirpstack ↔ POSEIDON City

Tyto rámce jsou zachyceny při přenosu mezi Chirpstack Gateway Bridge a MQTT, což umožňuje sledovat kompletní komunikaci v síti.

Diagnostika pomocí rámců

Sekce rámců je užitečným nástrojem pro diagnostiku problémů v komunikaci:

Chybějící uplinky - zařízení neodesílá data
Chybějící downlinky - zařízení nepřijímá příkazy
Slabý signál (nízké RSSI) - možné problémy s dosahem nebo překážkami
Nízký SNR - rušení nebo nízká kvalita signálu

Rozložení obrazovky​

Základní informace​

Základní údaje​

Umístění​

Rámce​

Automatická aktualizace​

Seznam rámců​

Detail rámce​

Detail downlink rámce​

Detail uplink rámce​

Detail acknowledge rámce​

Význam bran v systému​