expLORA Gateway Lite - Uživatelská dokumentace

Úvod

expLORA Gateway Lite je zařízení, které slouží jako brána mezi bezdrátovými LoRa senzory a vaší domácí sítí. Gateway umožňuje sběr dat z různých typů senzorů, jejich zobrazení ve webovém rozhraní a nyní také automatickou integraci s Home Assistant prostřednictvím protokolu MQTT.

Hlavní funkce

• Příjem a dekódování dat z LoRa senzorů
• Webové rozhraní pro konfiguraci a monitorování
• Podpora různých typů senzorů (CLIMA, CARBON, METEO)
• Automatické rozpoznávání senzorů v Home Assistant přes MQTT
• Duální režim WiFi (přístupový bod + klient)
• JSON a CSV API pro integraci s jinými systémy

První spuštění

Při prvním spuštění vytvoří Gateway WiFi přístupový bod s názvem ve formátu "expLORA-GW-XXXXXX". Připojte se k této síti a otevřete webový prohlížeč na adrese 192.168.4.1. Budete automaticky přesměrováni na konfigurační stránku.

Konfigurace WiFi

1. V menu vyberte "WiFi Setup"
2. Zadejte SSID a heslo vaší domácí WiFi sítě
3. Vyberte správné časové pásmo pro vaši lokalitu
4. Klikněte na "Save and Restart"

Gateway se nyní restartuje a pokusí se připojit k vaší síti. Pokud se připojení nezdaří, Gateway zůstane v režimu přístupového bodu a můžete konfiguraci provést znovu.

Aktualizace firmware

1. Připojte zařízení k počítači pomocí USB a zajistěte stabilní napájení během celé aktualizace.
2. Otevřete webový prohlížeč (ideálně Google Chrome) a přejděte na adresu https://pajenicko.cz/webflash/.
3. Klikněte na tlačítko Připojit / Connect a v zobrazeném dialogu vyberte odpovídající sériový port zařízení. Potvrďte přístup.
4. Po dokončení procesu se zařízení automaticky restartuje. Neodpojujte kabel ani neobnovujte stránku, dokud se aktualizace nedokončí.
5. Po restartu můžete zařízení znovu nakonfigurovat nebo ověřit jeho provoz podle potřeby.

Přidání a správa senzorů

Pro přidání nového senzoru postupujte následovně:

1. V menu vyberte "Sensors"
2. Klikněte na tlačítko "Add New Sensor"
3. Vyplňte formulář:
   • Sensor Name: Libovolný název pro identifikaci senzoru
   • Device Type: Typ zařízení (CLIMA, CARBON, METEO)
   • Serial Number: Sériové číslo senzoru
   • Device Key: Klíč pro dešifrování dat
   • Custom URL: Volitelná adresa pro zasílání dat (podporuje placeholdery)
4. Klikněte na "Add Sensor"

Úprava a mazání senzorů

Na stránce "Sensors" můžete spravovat existující senzory:

• Pro úpravu senzoru klikněte na tlačítko "Edit" u příslušného senzoru
• Pro smazání senzoru klikněte na tlačítko "Delete" (vyžaduje potvrzení)

Konfigurace MQTT pro Home Assistant

Nastavení MQTT

1. V menu vyberte "MQTT"
2. Zaškrtněte políčko "Enable MQTT" pro aktivaci funkce
3. Zadejte adresu MQTT brokeru (typicky IP adresa vašeho Home Assistant serveru nebo "homeassistant.local")
4. Zadejte port (standardně 1883)
5. Pokud váš MQTT broker vyžaduje autentizaci, zadejte uživatelské jméno a heslo
6. Klikněte na "Save MQTT Settings"

Integrace s Home Assistant

Po nastavení MQTT a připojení Gateway k WiFi bude zařízení automaticky:

1. Připojeno k MQTT brokeru Home Assistant
2. Publikovat informace o dostupných senzorech pro automatické rozpoznání
3. Pravidelně odesílat data ze senzorů

Všechny senzory se automaticky zobrazí v Home Assistant jako samostatné entity, seskupené podle zařízení. Není potřeba žádná další konfigurace v Home Assistant.

Přehled webového rozhraní

Home

Domovská stránka zobrazuje základní informace o stavu Gateway a aktuální hodnoty ze všech připojených senzorů.

WiFi Setup

Umožňuje konfiguraci WiFi připojení a časového pásma.

Sensors

Správa senzorů - přidávání, úprava a mazání.

MQTT

Konfigurace MQTT pro integraci s Home Assistant.

Logs

Zobrazení systémových logů a nastavení úrovně logování.

API

Dokumentace API a přístup k datům ve formátech JSON a CSV.

Reboot

Restartování Gateway.

Podporované typy senzorů

CLIMA

Senzor teploty, vlhkosti a atmosférického tlaku.

• Teplota (°C)
• Relativní vlhkost (%)
• Atmosférický tlak (hPa)

CARBON

Senzor CO2, teploty a vlhkosti.

• Koncentrace CO2 (ppm)
• Teplota (°C)
• Relativní vlhkost (%)

METEO

Meteorologická stanice.

• Teplota (°C)
• Relativní vlhkost (%)
• Atmosférický tlak (hPa)
• Rychlost větru (m/s)
• Směr větru (stupně)
• Úhrn srážek (mm)
• Intenzita srážek (mm/h)
• Denní úhrn srážek (mm) - resetuje se o půlnoci

Použití API

Gateway poskytuje API pro přístup k datům ze senzorů v různých formátech.

JSON API

Adresa: /api nebo /api?format=json

Vrací data ze všech senzorů v JSON formátu. Příklad odpovědi:

{
  "version": "1.0.2",
  "time": "2025-05-05 12:34:56",
  "status": "connected",
  "sensors": [
    {
      "name": "Obývák",
      "type": 1,
      "typeName": "BME280",
      "serialNumber": "0xABCDEF",
      "lastSeen": 300,
      "temperature": 21.50,
      "humidity": 45.20,
      "pressure": 1013.20,
      "batteryVoltage": 3.82,
      "rssi": -72
    }
  ]
}

CSV API

Adresa: /api?format=csv

Vrací data ze všech senzorů v CSV formátu, vhodném pro import do tabulkových procesorů nebo databází.

Filtrování podle senzoru

Můžete filtrovat data podle konkrétního senzoru pomocí parametru sensor:

/api?sensor=0xABCDEF

Kde 0xABCDEF je sériové číslo senzoru v hexadecimálním formátu.

Řešení problémů

Gateway se nepřipojuje k WiFi

1. Zkontrolujte, zda jsou SSID a heslo zadány správně
2. Ujistěte se, že vaše WiFi síť je v dosahu
3. Zkuste Gateway restartovat
4. Pokud problém přetrvává, připojte se k AP režimu a zkontrolujte logy

Senzory se nezobrazují v Home Assistant

1. Zkontrolujte, zda je MQTT správně nastaveno a povoleno
2. Ověřte, že Home Assistant má správně nakonfigurovaný MQTT integraci
3. Zkontrolujte, zda Gateway může komunikovat s MQTT brokerem (podívejte se do logů)
4. Restartujte Gateway pro opětovné odeslání discovery informací

Gateway nepřijímá data ze senzorů

1. Ujistěte se, že senzory jsou správně nakonfigurovány (sériové číslo a klíč)
2. Zkontrolujte, zda jsou senzory v dosahu Gateway
3. Ověřte, že baterie v senzorech jsou nabité
4. Zkontrolujte logy pro možné chybové zprávy

Technické specifikace

• Procesor: ESP32-S3
• Bezdrátové rozhraní: WiFi 2.4GHz, LoRa 868MHz
• Napájení: USB-C, 5V
• Maximální počet senzorů: 20
• Verze firmware: 1.0.5

Aktualizace firmware

Aktuální firmware nejjednodušeji nahrajete ze stránky https://pajenicko.cz/webflash/ (stačí připojit GW do počítače, otevřít tuto stránku a můžete aktualizovat)

Aktualizace firmware lze provést přes OTA (Over-The-Air) nebo pomocí USB připojení.

OTA aktualizace

1. V menu vyberte "Reboot"
2. Po restartu se připojte na adresu http://[IP-adresa]:3232
3. Přihlaste se heslem "admin"
4. Nahrajte nový firmware a postupujte podle pokynů