Přeskočit na hlavní obsah

GeoSnake - Webové Rozhraní - Uživatelský Průvodce

Přehled​

Webové rozhraní GeoSnake poskytuje kompletní grafické ovládání zařízení přímo z webového prohlížeče. Rozhraní je optimalizováno pro desktop i mobilní zařízení a funguje v offline režimu.

Přístup:

  • URL: http://192.168.4.1 (když jste připojeni k WiFi AP)
  • SSID: STATOTEST-GEOSNAKE-XXXX (výchozí)

Hlavní Struktura​

Header (Záhlaví)​

┌─────────────────────────────────────────┐
│      [STATOTEST LOGO]                   │
│         GEOSNAKE                        │
│  Accelerometer Control System           │
└─────────────────────────────────────────┘
  • Logo: SVG logo Statotest
  • Název: GEOSNAKE
  • Podnázev: Accelerometer Control System
  • Barva: Modrý gradient (firemní barvy)

Rozhraní je rozděleno do 7 hlavních záložek:

  1. 📊 Dashboard - Přehled a rychlé ovládání
  2. ⚙️ Sensor Config - Konfigurace akcelerometru
  3. ⏰ Schedule - Plánování měření
  4. 📁 Files - Správa souborů
  5. 🔋 Power - Správa napájení
  6. 🏷️ Device - Konfigurace zařízení
  7. 📡 WiFi - WiFi nastavení

Navigace:

  • Kliknutím na záložku se zobrazí příslušný obsah
  • Aktivní záložka je zvýrazněna modře
  • Na mobilních zařízeních se záložky zobrazují pod sebou

📊 Dashboard (Hlavní Panel)​

Status Display (Zobrazení Stavu)​

┌─────────────────────────────────────────┐
│ Status: Stopped                         │
│ [červené pozadí = zastaveno]            │
│ [zelené pozadí = měření běží]           │
└─────────────────────────────────────────┘

Indikátory:

  • 🟢 Zelený - Měření probíhá
  • 🔴 Červený - Měření zastaveno

Informace:

  • Text: "Measuring" nebo "Stopped"
  • Automatická aktualizace každé 2 sekundy

Quick Control (Rychlé Ovládání)​

┌─────────────────────────────────────────┐
│ ▶️ Start Measurement                    │
│ ⏹️ Stop Measurement                     │
└─────────────────────────────────────────┘

Tlačítka:​

▶️ Start Measurement (Zelené tlačítko)

  • Funkce: Spustí měření akcelerometru
  • Kdy použít: Když chcete začít zaznamenávat data
  • Efekt:
    • Status se změní na "Measuring"
    • Začne se zapisovat na SD kartu
    • Vytvoří se nový CSV soubor
  • Požadavky: SD karta musí být vložena

⏹️ Stop Measurement (Červené tlačítko)

  • Funkce: Zastaví probíhající měření
  • Kdy použít: Když chcete ukončit záznam dat
  • Efekt:
    • Status se změní na "Stopped"
    • Aktuální soubor se uzavře
    • Data jsou bezpečně uložena

Current Settings (Aktuální Nastavení)​

Mřížka s 7 informačními kartami:

┌──────────────┬──────────────┬──────────────┬──────────────┐
│ ODR          │ Range        │ Target Freq  │ WiFi         │
│ 62.5 Hz      │ ±2g          │ 50 Hz        │ AP Mode      │
├──────────────┼──────────────┼──────────────┼──────────────┤
│ RTC Time     │ Firmware     │ SD Card                     │
│ 14:30:45     │ v1.2.0       │ Total/Free: 28.5/32.0 GB    │
└──────────────┴──────────────┴─────────────────────────────┘

Informační Karty:​

1. ODR (Output Data Rate)

  • Zobrazuje: Aktuální vzorkovací frekvence
  • Hodnoty: 3.906 Hz - 4000 Hz
  • Příklad: "62.5 Hz", "250 Hz"

2. Range (Měřící Rozsah)

  • Zobrazuje: Aktuální citlivost akcelerometru
  • Hodnoty: ±2g, ±4g, ±8g
  • Příklad: "±2g"

3. Target Freq (Cílová Frekvence)

  • Zobrazuje: Výstupní frekvence po decimaci
  • Hodnoty: 1-100 Hz
  • Příklad: "50 Hz"

4. WiFi

  • Zobrazuje: Stav WiFi připojení
  • Hodnoty:
    • "AP Mode" - Access Point režim
    • "Connected to [SSID]" - Připojeno k síti
    • "Disconnected" - Odpojeno
  • Příklad: "Connected to MyNetwork"

5. RTC Time (Čas z RTC)

  • Zobrazuje: Aktuální čas z DS3231 RTC
  • Formát: HH:MM:SS
  • Příklad: "14:30:45"
  • Aktualizace: Každé 2 sekundy

6. Firmware

  • Zobrazuje: Verze firmware
  • Formát: vX.Y.Z
  • Příklad: "v1.2.0"

7. SD Card (SD Karta)

  • Zobrazuje: Využití SD karty
  • Formát: "Free: X.X GB / Total: Y.Y GB"
  • Příklad: "Free: 28.5 GB / Total: 32.0 GB"
  • Aktualizace: Při načtení stránky

Measurement Statistics (Statistiky Měření)​

┌──────────────┬──────────────┬──────────────┬──────────────┐
│ Total Samples│ Files Created│ Elapsed Time │ Write Errors │
│ 125,000      │ 3            │ 2h 15m 30s   │ 0            │
└──────────────┴──────────────┴──────────────┴──────────────┘

Zobrazované Hodnoty:​

Total Samples (Celkový Počet Vzorků)

  • Počet zaznamenaných vzorků od začátku měření
  • Resetuje se při zastavení měření

Files Created (Vytvořené Soubory)

  • Počet CSV souborů vytvořených během měření
  • Nový soubor každou hodinu

Elapsed Time (Uplynulý Čas)

  • Doba trvání měření
  • Formát: Xh Ym Zs

Write Errors (Chyby Zápisu)

  • Počet chyb při zápisu na SD kartu
  • Mělo být 0 - pokud ne, zkontrolujte SD kartu

⚙️ Sensor Config (Konfigurace Senzoru)​

ADXL355 Configuration​

┌─────────────────────────────────────────┐
│ Output Data Rate (ODR)                  │
│ [Dropdown menu: 62.5 Hz]         ▼     │
├─────────────────────────────────────────┤
│ Measurement Range                       │
│ [Dropdown menu: ±2g]             ▼     │
├─────────────────────────────────────────┤
│ Target Output Frequency (Hz)            │
│ [━━━━━━●━━━━━━] 50 Hz                  │
│ [Apply Frequency]                       │
└─────────────────────────────────────────┘

1. Output Data Rate (ODR)​

Typ: Dropdown menu (rozbalovací seznam)

Možnosti:

4000 Hz    - Maximální frekvence
2000 Hz    - Vysoká frekvence
1000 Hz    - Vysoká frekvence
500 Hz     - Střední frekvence
250 Hz     - Střední frekvence
125 Hz     - Základní frekvence
62.5 Hz    - Výchozí (doporučeno)
31.25 Hz   - Nízká frekvence
15.625 Hz  - Velmi nízká frekvence
7.813 Hz   - Ultra nízká frekvence
3.906 Hz   - Minimální frekvence

Jak použít:

  1. Klikněte na dropdown
  2. Vyberte požadovanou frekvenci
  3. Nastavení se použije okamžitě

Doporučení podle aplikace:

  • Vibrace budov: 62.5 - 125 Hz
  • Strojní vibrace: 250 - 1000 Hz
  • Nárazové děje: 1000 - 4000 Hz
  • Pomalé pohyby: 7.813 - 31.25 Hz

2. Measurement Range​

Typ: Dropdown menu

Možnosti:

±2g  - Nejvyšší citlivost (výchozí)
±4g  - Střední rozsah
±8g  - Nejširší rozsah

Jak použít:

  1. Klikněte na dropdown
  2. Vyberte rozsah
  3. Nastavení se použije okamžitě

Scale faktory pro převod:

  • ±2g: 0.0000038147 g/LSB
  • ±4g: 0.0000076294 g/LSB
  • ±8g: 0.0000152588 g/LSB

Kdy použít který rozsah:

  • ±2g: Jemné vibrace, seismické měření, budovy
  • ±4g: Standardní vibrace, stroje
  • ±8g: Silné nárazy, vozidla, sport

3. Target Output Frequency​

Typ: Slider (posuvník) + numerická hodnota

Rozsah: 1 - 100 Hz
Výchozí: 50 Hz
Krok: 1 Hz

Jak použít:

  1. Posuňte slider na požadovanou hodnotu
  2. Sledujte aktuální hodnotu vpravo ("50 Hz")
  3. Klikněte Apply Frequency pro potvrzení

Co to dělá:

  • Softwarová decimace vzorků
  • ODR = vzorkovací frekvence senzoru
  • Target Freq = frekvence ukládaných vzorků
  • Příklad: ODR=125 Hz, Target=50 Hz → ukládá se každý 2.5 vzorek

Výhody:

  • Přesnější výstupní frekvence
  • Menší velikost souborů
  • Redukce šumu (průměrování)

4. X/Y/Z Axis Offset​

┌─────────────────────────────────────────┐
│ X-Axis Offset                           │
│ [  0  ] (range: -32768 to 32767)        │
├─────────────────────────────────────────┤
│ Y-Axis Offset                           │
│ [  0  ]                                 │
├─────────────────────────────────────────┤
│ Z-Axis Offset                           │
│ [  0  ]                                 │
├─────────────────────────────────────────┤
│ [Apply Offsets]                         │
└─────────────────────────────────────────┘

Funkce: Kalibrace offsetu pro jednotlivé osy

Jak použít:

  1. Zadejte hodnotu offsetu pro každou osu
  2. Klikněte Apply Offsets

Kdy použít:

  • Po kalibraci senzoru
  • Pro kompenzaci DC offsetu
  • Pro zlepšení přesnosti měření

Rozsah: -32768 až 32767 (raw hodnoty)

⏰ Schedule (Plánování Měření)​

┌─────────────────────────────────────────┐
│ Add New Schedule                        │
├─────────────────────────────────────────┤
│ Name                                    │
│ [Morning measurement         ]          │
├─────────────────────────────────────────┤
│ Start Date    [2024-12-07]              │
│ Start Time    [06:00:00]                │
├─────────────────────────────────────────┤
│ End Date      [2024-12-07]              │
│ End Time      [07:00:00]                │
│              OR                         │
│ Duration (sec) [3600        ]           │
├─────────────────────────────────────────┤
│ Preview:                                │
│ Start: 2024-12-07 06:00:00              │
│ End:   2024-12-07 07:00:00              │
│ Duration: 1 hour                        │
├─────────────────────────────────────────┤
│           [Add Schedule]                │
└─────────────────────────────────────────┘

Formulář pro Vytvoření Plánu​

Pole:​

1. Name (Název)

  • Typ: Textové pole
  • Max délka: 50 znaků
  • Příklady:
    • "Ranní měření"
    • "Víkendový test"
    • "Dlouhodobé monitorování"
  • Povinné: Ano

2. Start Date (Datum Začátku)

  • Typ: Date picker (výběr data)
  • Formát: YYYY-MM-DD
  • Příklad: 2024-12-07
  • Povinné: Ano

3. Start Time (Čas Začátku)

  • Typ: Time picker (výběr času)
  • Formát: HH:MM:SS
  • Příklad: 06:00:00
  • Povinné: Ano

4. End Date (Datum Konce)

  • Typ: Date picker
  • Formát: YYYY-MM-DD
  • Volitelné: Ano (pokud je zadána Duration)

5. End Time (Čas Konce)

  • Typ: Time picker
  • Formát: HH:MM:SS
  • Volitelné: Ano (pokud je zadána Duration)

6. Duration (Doba Trvání)

  • Typ: Číselné pole
  • Jednotka: Sekundy
  • Rozsah: 1 - 86400 (24 hodin)
  • Příklady:
    • 3600 = 1 hodina
    • 7200 = 2 hodiny
    • 86400 = 24 hodin
  • Volitelné: Ano (pokud je zadán End Date/Time)

Preview (Náhled)​

Zobrazuje vypočítané hodnoty před uložením:

  • Start: Datum a čas začátku
  • End: Datum a čas konce (vypočítaný)
  • Duration: Doba trvání v lidsky čitelném formátu

Příklad:

Preview:
Start: 2024-12-07 06:00:00
End:   2024-12-07 07:00:00
Duration: 1 hour

Tlačítko "Add Schedule"​

Funkce: Uloží plán do zařízení

Proces:

  1. Validace vstupů (datum/čas v budoucnosti)
  2. Odeslání na API endpoint /api/schedule
  3. Potvrzení nebo chybová hláška
  4. Refresh seznamu plánů

Omezení: Maximum 10 aktivních plánů

Seznam Plánů (Scheduled Measurements)​

┌─────────────────────────────────────────────────────────────┐
│ ID  Name                Start              End        Delete │
├─────────────────────────────────────────────────────────────┤
│ 0   Morning measurement 2024-12-07 06:00  07:00     [🗑️]   │
│ 1   Evening test        2024-12-07 18:00  19:30     [🗑️]   │
│ 2   Weekend monitoring  2024-12-09 00:00  23:59     [🗑️]   │
└─────────────────────────────────────────────────────────────┘

Sloupce:​

ID

  • Unikátní identifikátor plánu (0-9)

Name

  • Název plánu

Start

  • Datum a čas začátku
  • Formát: YYYY-MM-DD HH:MM

End

  • Čas konce (pokud je nastaven)
  • Formát: HH:MM
  • Prázdné: Pokud není časový limit

Delete (🗑️)

  • Tlačítko pro smazání plánu
  • Po kliknutí se zobrazí potvrzovací dialog

Stavy Plánu​

Plány jsou barevně odlišeny podle stavu:

🟢 Zelený - Aktivní (měření běží)
🔵 Modrý - Naplánovaný (čeká na start)
⚫ Šedý - Vypršelý (končil v minulosti)

Automatické Spouštění​

  • Zařízení kontroluje plány každou minutu
  • Při dosažení Start Time se automaticky spustí měření
  • Při dosažení End Time se automaticky zastaví měření
  • Plány se ukládají do NVS (přežijí restart)

📁 Files (Správa Souborů)​

┌─────────────────────────────────────────────────────────────┐
│ Current Path: /                              [🔄 Refresh]   │
├─────────────────────────────────────────────────────────────┤
│ ☑️ Select All   [⬇️ Download Selected]   [🗑️ Delete]      │
├─────────────────────────────────────────────────────────────┤
│ □ 📁 2024                                                   │
│   □ 📁 11                                                   │
│     □ 📁 25                                                 │
│       ☑️ 📄 data_20241125_140000.csv      1.2 MB  [⬇️][🗑️]│
│       ☑️ 📄 data_20241125_150000.csv      1.1 MB  [⬇️][🗑️]│
│   □ 📁 12                                                   │
│     □ 📁 07                                                 │
│       □ 📄 data_20241207_140000.csv       0.5 MB  [⬇️][🗑️]│
└─────────────────────────────────────────────────────────────┘

Horní Panel​

Current Path (Aktuální Cesta)

  • Zobrazuje aktuální složku
  • Formát: /2024/12/07
  • Klikatelné části pro navigaci zpět

🔄 Refresh (Obnovit)

  • Znovu načte seznam souborů
  • Aktualizuje velikosti a počty
  • Automaticky se volá při přepnutí na záložku Files

Ovládací Tlačítka​

☑️ Select All (Vybrat Vše)

  • Zaškrtne všechny soubory v aktuální složce
  • Druhé kliknutí odškrtne vše
  • Funguje i pro složky

⬇️ Download Selected (Stáhnout Vybrané)

  • Stáhne všechny zaškrtnuté položky
  • Online režim: Vytvoří ZIP archiv (vyžaduje JSZip z CDN)
  • Offline režim: Stahuje soubory postupně jednotlivě
  • Zobrazuje progress bar během stahování

🗑️ Delete Selected (Smazat Vybrané)

  • Smaže všechny zaškrtnuté položky
  • Zobrazí potvrzovací dialog
  • Nevratná operace!

Stromová Struktura​

Ikony:​

📁 Složka

  • Kliknutím se rozbalí/sbalí
  • Checkbox vybere všechny soubory ve složce
  • Šedá = prázdná složka
  • Modrá = obsahuje soubory

📄 Soubor

  • CSV soubor s daty
  • Zobrazuje název a velikost
  • Samostatné tlačítka Download a Delete

Seznam Souborů​

Pro každý soubor se zobrazuje:

☑️ 📄 data_20241207_140000.csv    1.2 MB    [⬇️] [🗑️]
│   │                              │         │    │
│   └─ Název souboru               │         │    └─ Smazat
│                                  │         └─ Stáhnout
│                                  └─ Velikost
└─ Checkbox

Interaktivní Prvky:​

Checkbox

  • Výběr souboru pro hromadné operace
  • Zelená = vybraný
  • Bílá = nevybraný

Název souboru

  • Formát: data_YYMMDD_HHMMSS.csv
  • Příklad: data_20241207_140000.csv
  • Obsahuje datum a čas vytvoření

Velikost

  • Formát: KB, MB, GB
  • Příklad: "1.2 MB"
  • Aktualizováno při Refresh

⬇️ Download (Stáhnout)

  • Stáhne konkrétní soubor
  • Otevře dialog "Save As"
  • Jméno souboru je předvyplněné

🗑️ Delete (Smazat)

  • Smaže konkrétní soubor
  • Zobrazí potvrzení
  • Po smazání zmizí ze seznamu

Otevření složky:

  • Klikněte na název složky
  • Obsah se zobrazí v podstromu

Návrat zpět:

  • Klikněte na nadřazenou složku v Current Path
  • Nebo použijte tlačítko "⬆️ Parent Directory" (pokud existuje)

Breadcrumb navigace:

/ > 2024 > 12 > 07
│   │      │    └─ Aktuální složka
│   │      └─ Kliknutím jdete na 12/
│   └─ Kliknutím jdete na 2024/
└─ Root (kořenový adresář)

Hromadné Stahování (ZIP)​

Online režim (s JSZip):

  1. Vyberte soubory/složky checkboxem
  2. Klikněte "Download Selected"
  3. Zobrazí se progress bar
  4. ZIP archiv se automaticky stáhne
  5. Název: geosnake_data_YYYYMMDD_HHMMSS.zip

Offline režim (bez JSZip):

  1. Vyberte soubory/složky
  2. Klikněte "Download Selected"
  3. Soubory se stahují postupně jeden po druhém
  4. Může trvat déle
  5. Prohlížeč může zeptat na každý soubor zvlášť

Progress indikátor:

Downloading... (3/10 files)
[████████░░░░░░░░░░] 30%

Download Celé Složky​

Funkce: Stažení všech souborů ve složce jedním kliknutím

Postup:

  1. Zaškrtněte checkbox u složky (např. 📁 25)
  2. Klikněte "Download Selected"
  3. Všechny soubory ve složce se zabalí do ZIP

Hierarchie v ZIP:

geosnake_data.zip
└── 2024/
    └── 11/
        └── 25/
            ├── data_20241125_140000.csv
            ├── data_20241125_150000.csv
            └── data_20241125_160000.csv

Hromadné Mazání​

Pozor! Nevratná operace!

Delete Selected:

  1. Vyberte soubory/složky
  2. Klikněte "Delete Selected"
  3. Potvrzovací dialog: 
    Delete 5 items?
    This action cannot be undone.
    [Cancel] [Delete]
  4. Po potvrzení se items smažou

Delete All Files:

  • Červené tlačítko na konci stránky
  • Smaže úplně všechno na SD kartě!
  • Dvojité potvrzení

Filtry a Třídění​

Filtr podle typu:

  • 📁 Show only folders
  • 📄 Show only files
  • 📊 Show all

Třídění:

  • 📅 By date (newest first)
  • 📝 By name (A-Z)
  • 📏 By size (largest first)

🔋 Power (Správa Napájení)​

┌─────────────────────────────────────────┐
│ Power Mode                              │
├─────────────────────────────────────────┤
│ ⚪ Normal Mode (160 MHz, no sleep)      │
│    Current consumption: ~200 mA         │
│                                         │
│ ⚪ Low Power Mode (80 MHz, light sleep) │
│    Current consumption: ~50-80 mA       │
│                                         │
│ [Set Power Mode]                        │
├─────────────────────────────────────────┤
│ Startup Mode (after hard reset)        │
│ [Normal ▼]                              │
├─────────────────────────────────────────┤
│ WiFi Power Management                   │
│ ☑️ Enable WiFi                          │
│ ☑️ WiFi Modem Sleep                     │
├─────────────────────────────────────────┤
│ Deep Sleep                              │
│ Duration (seconds): [3600    ]          │
│ [Enter Deep Sleep]                      │
└─────────────────────────────────────────┘

Power Mode (Výkonový Režim)​

Radio buttons (výběr jednoho):

⚪ Normal Mode​

  • CPU: 160 MHz (fixed)
  • Sleep: Žádný
  • Spotřeba: ~150-200 mA (s WiFi)
  • Použití: Maximální výkon
  • Vhodné pro:
    • Vysoké vzorkovací frekvence (1000+ Hz)
    • Webové rozhraní s aktivním použitím
    • Krátkodobá měření

⚪ Low Power Mode​

  • CPU: 10-80 MHz (dynamické scaling)
  • Sleep: Light sleep mezi úlohami
  • Spotřeba: ~40-80 mA
  • Použití: Bateriový provoz
  • Vhodné pro:
    • Dlouhodobá měření
    • Nižší frekvence (do 250 Hz)
    • Bateriový provoz

Tlačítko "Set Power Mode":

  • Uloží vybraný režim
  • Zařízení se restartuje za 2 sekundy!
  • Zobrazí odpočet: "Restarting in 2 seconds..."

Startup Mode​

Dropdown menu:

Normal  ▼
Low Power

Funkce: Určuje režim po hard resetu (stisk reset tlačítka, odpojení napájení)

Rozdíl od Power Mode:

  • Power Mode: Aktuální běžící režim
  • Startup Mode: Režim po příštím hard resetu

Použití:

  • Nastavte "Low Power" pro bateriový provoz
  • Zařízení bude vždy startovat v úsporném režimu

WiFi Power Management​

☑️ Enable WiFi​

Funkce: Zapne/vypne WiFi kompletně

Stavy:

  • ✅ Checked (Zapnuto): WiFi AP/STA je aktivní (~70-100 mA navíc)
  • ☐ Unchecked (Vypnuto): WiFi vypnuto (úspora ~70-100 mA)

Kdy vypnout:

  • Dlouhodobé měření na baterii
  • Ovládání pouze přes Bluetooth
  • Maximální úspora energie

⚠️ Upozornění: Po vypnutí WiFi není dostupné webové rozhraní!

☑️ WiFi Modem Sleep​

Funkce: WiFi usíná mezi beacony

Stavy:

  • ✅ Enabled: Modem sleep zapnut (úspora ~20-40 mA)
  • ☐ Disabled: WiFi stále aktivní (vyšší spotřeba, lepší odezva)

Výhody:

  • Úspora energie při zachování WiFi připojení
  • Stále lze používat webové rozhraní
  • Minimální vliv na odezvu

Nevýhody:

  • Mírně pomalejší ping (~10-50 ms)
  • Možné krátké výpadky při velkém zatížení

Doporučení:

  • ✅ Zapnout pro bateriový provoz
  • ☐ Vypnout pro nejvyšší výkon WiFi

Deep Sleep​

┌─────────────────────────────────────────┐
│ Deep Sleep Configuration                │
├─────────────────────────────────────────┤
│ Sleep Duration (seconds)                │
│ [3600          ] (1-86400)              │
│                                         │
│ Preview: Device will sleep for 1 hour  │
│                                         │
│ [Enter Deep Sleep] ⚠️                  │
└─────────────────────────────────────────┘

Duration (Doba Spánku)​

Typ: Číselné pole
Rozsah: 1 - 86400 sekund (1 sekunda - 24 hodin)
Výchozí: 3600 (1 hodina)

Příklady:

  • 60 = 1 minuta
  • 600 = 10 minut
  • 3600 = 1 hodina
  • 7200 = 2 hodiny
  • 43200 = 12 hodin
  • 86400 = 24 hodin

Preview (Náhled)​

Zobrazuje lidsky čitelnou dobu spánku:

Device will sleep for 1 hour
Device will sleep for 30 minutes
Device will sleep for 12 hours

Tlačítko "Enter Deep Sleep" ⚠️​

Funkce: Přejde do deep sleep režimu

⚠️ VAROVÁNÍ:

  • Zařízení se okamžitě vypne
  • Webové rozhraní nebude dostupné
  • Bluetooth nebude dostupné
  • Měření se zastaví
  • Probudí se až po uplynutí doby nebo hard resetu

Proces:

  1. Kliknutím zobrazí potvrzovací dialog
  2. "Device will enter deep sleep. Continue?"
  3. Po potvrzení se zařízení okamžitě vypne
  4. Probudí se po nastavené době
  5. Automaticky se restartuje

Spotřeba v deep sleep: ~10-50 µA

Probuzení:

  • Automaticky po uplynutí času
  • Stisk reset tlačítka
  • Odpojení a připojení napájení

Doporučené Kombinace​

Maximální výkon (laboratoř):

Power Mode: Normal
WiFi: ✅ Enabled
Modem Sleep: ☐ Disabled
Spotřeba: ~200 mA

Vyvážený režim:

Power Mode: Normal
WiFi: ✅ Enabled
Modem Sleep: ✅ Enabled
Spotřeba: ~120 mA

Úsporný s webem:

Power Mode: Low Power
WiFi: ✅ Enabled
Modem Sleep: ✅ Enabled
Spotřeba: ~60 mA

Maximální úspora (pouze BLE):

Power Mode: Low Power
WiFi: ☐ Disabled
Spotřeba: ~30-40 mA

Ultra úsporný (periodické měření):

1. Měření 10 minut (Low Power, WiFi off): ~40 mA
2. Deep Sleep 50 minut: ~0.01 mA
Průměrná spotřeba: ~8 mA

🏷️ Device (Konfigurace Zařízení)​

┌─────────────────────────────────────────┐
│ Device Configuration                    │
├─────────────────────────────────────────┤
│ BLE Device Name                         │
│ [STATOTEST-GEOSNAKE              ]      │
│                                         │
│ WiFi Access Point SSID                  │
│ [GeoSnake-Config                 ]      │
│                                         │
│ WiFi Access Point Password              │
│ [geosnake123                     ]      │
│                                         │
│ [Save Configuration]                    │
│                                         │
│ ⚠️ Device will restart after save      │
└─────────────────────────────────────────┘

Konfigurace Polí​

1. BLE Device Name​

Funkce: Název zařízení pro Bluetooth
Max délka: 31 znaků
Výchozí: STATOTEST-GEOSNAKE

Příklady:

  • GEOSNAKE-LAB-01
  • GEOSNAKE-FIELD-A
  • Accelerometer-Building-5

Pravidla:

  • Pouze ASCII znaky
  • Bez mezer (použijte - nebo _)
  • Mělo by být unikátní, pokud máte více zařízení

Použití:

  • Snadnější identifikace při více zařízeních
  • Organizace podle lokace nebo projektu

2. WiFi Access Point SSID​

Funkce: Název WiFi AP sítě
Max délka: 31 znaků
Výchozí: GeoSnake-Config

Příklady:

  • MyGeoSnake
  • Lab-ADXL355
  • Monitoring-Device-1

Pravidla:

  • Pouze ASCII znaky
  • Mezery jsou povoleny
  • Mělo by být popisné

3. WiFi Access Point Password​

Funkce: Heslo pro připojení k AP
Min délka: 8 znaků
Max délka: 63 znaků
Výchozí: geosnake123

Požadavky:

  • Minimálně 8 znaků
  • Doporučeno: Velká/malá písmena + čísla
  • Nepoužívejte slabá hesla (12345678, password)

Bezpečnostní tipy:

  • Změňte výchozí heslo!
  • Použijte kombinaci písmen, čísel, symbolů
  • Nezveřejňujte heslo

Tlačítko "Save Configuration"​

Funkce: Uloží změny do NVS (persistent storage)

Proces:

  1. Validace vstupů (délka, formát)
  2. Uložení do NVS
  3. Zobrazení zprávy: "✅ Configuration saved"
  4. Automatický restart za 3 sekundy
  5. Po restartu se použijí nové hodnoty

⚠️ Důležité:

  • Změny se projeví až po restartu
  • Poznamenejte si nové WiFi přihlašovací údaje
  • Pokud zapomenete heslo, musíte zařízení přeflashovat

Manuální Restart​

[Restart Device Now]

Funkce: Okamžitý restart zařízení

Kdy použít:

  • Po změně konfigurace
  • Pokud zařízení nereaguje správně
  • Pro aplikaci změn power mode

Proces:

  1. Kliknutí zobrazí potvrzení
  2. "Restart device now?"
  3. Po potvrzení se zařízení restartuje
  4. Trvá ~5-10 sekund

📡 WiFi (WiFi Nastavení)​

┌─────────────────────────────────────────────────────────────┐
│ WiFi Status                                                 │
├─────────────────────────────────────────────────────────────┤
│ Mode: Access Point + Station                               │
│ AP SSID: GeoSnake-Config                                   │
│ AP IP: 192.168.4.1                                         │
│                                                             │
│ Station Status: ✅ Connected                               │
│ Connected to: MyNetwork                                    │
│ IP Address: 192.168.1.100                                  │
│ Signal: -45 dBm (Excellent) ████████░░                     │
│ Internet: ✅ Available                                     │
│                                                             │
│ [Disconnect]                                               │
└─────────────────────────────────────────────────────────────┘

WiFi Status (Stav WiFi)​

Access Point (AP) Informace​

Mode: Zobrazuje aktivní režimy

  • "Access Point only"
  • "Station only"
  • "Access Point + Station" (dual mode)

AP SSID: Název vaší AP sítě
AP IP: IP adresa pro přístup k webovému rozhraní
Výchozí: 192.168.4.1

Station (STA) Informace​

Station Status: Stav připojení

Možné stavy:

  • ⚫ Disconnected - Odpojeno
  • 🟡 Connecting... - Připojování (max 30 sekund)
  • ✅ Connected - Připojeno k síti
  • ❌ Connection Failed - Připojení selhalo

Connected to: Název WiFi sítě (SSID)

IP Address: Přidělená IP adresa

  • Formát: 192.168.X.XXX
  • Použijte tuto adresu pro přístup v lokální síti

Signal: Síla signálu

-30 dBm: ████████████ Excellent
-45 dBm: ██████████░░ Very Good
-60 dBm: ████████░░░░ Good
-75 dBm: ████░░░░░░░░ Fair
-90 dBm: ██░░░░░░░░░░ Poor

Internet: Dostupnost internetu

  • ✅ Available - Funguje NTP sync, OTA update
  • ❌ Not Available - Pouze lokální síť

Tlačítko "Disconnect"​

Funkce: Odpojí se od WiFi sítě (STA mode)

Co se stane:

  • Odpojení od externí WiFi
  • AP režim zůstane aktivní
  • Webové rozhraní stále dostupné přes AP
  • IP adresa se změní zpět na 192.168.4.1

Connect to WiFi (Připojení k WiFi)​

┌─────────────────────────────────────────┐
│ Connect to WiFi Network                 │
├─────────────────────────────────────────┤
│ [Scan Networks]                         │
│                                         │
│ Available Networks:                     │
│ ⚪ MyNetwork        (-45 dBm) 🔒        │
│ ⚪ OfficeWiFi       (-52 dBm) 🔒        │
│ ⚪ GuestNetwork     (-68 dBm) 🔓        │
│                                         │
│ Or enter manually:                      │
│ SSID     [                    ]         │
│ Password [                    ] 👁️      │
│                                         │
│ [Connect]                               │
└─────────────────────────────────────────┘

Scan Networks (Skenování Sítí)​

Tlačítko: "Scan Networks"

Funkce: Vyhledá dostupné WiFi sítě

Proces:

  1. Kliknutím spustíte sken
  2. Zobrazí se "Scanning..." (5-10 sekund)
  3. Seznam nalezených sítí

Seznam obsahuje:

  • Radio button: Výběr sítě
  • SSID: Název sítě
  • Síla signálu: v dBm
  • Zabezpečení:
    • 🔒 Locked (WPA/WPA2) - vyžaduje heslo
    • 🔓 Open - otevřená síť

Třídění: Od nejsilnějšího k nejslabšímu signálu

Manuální Zadání​

SSID (Název sítě)

  • Textové pole
  • Max 32 znaků
  • Case-sensitive (rozlišuje velká/malá písmena)

Password (Heslo)

  • Typ: Password field (skryté znaky)
  • Min 8 znaků (pro WPA2)
  • 👁️ ikona: Zobrazit/skrýt heslo

Použití:

  • Pokud síť není viditelná ve scanu (hidden SSID)
  • Pro přesnější kontrolu

Tlačítko "Connect"​

Funkce: Spustí připojení k vybrané/zadané síti

Proces:

  1. Validace vstupů (SSID, heslo)
  2. Odeslání na /connect_wifi
  3. Zobrazení "Connecting..." (max 30 sekund)
  4. Status se aktualizuje na Connected/Failed
  5. Při úspěchu se zobrazí IP adresa

Možné výsledky:

  • ✅ Success: IP adresa přidělena
  • ❌ Wrong password: Nesprávné heslo
  • ❌ Network not found: SSID nenalezeno
  • ❌ Timeout: Síť neodpovídá

Advanced WiFi Settings​

┌─────────────────────────────────────────┐
│ Advanced Settings                       │
├─────────────────────────────────────────┤
│ DHCP Client:  ✅ Enabled                │
│                                         │
│ Static IP Configuration (if disabled):  │
│ IP:      [                    ]         │
│ Gateway: [                    ]         │
│ Netmask: [                    ]         │
│ DNS:     [                    ]         │
└─────────────────────────────────────────┘

DHCP (Dynamic Host Configuration Protocol):

  • ✅ Enabled (výchozí): IP se přidělí automaticky
  • ☐ Disabled: Manuální konfigurace

Kdy použít statickou IP:

  • Potřebujete konzistentní IP adresu
  • Port forwarding / firewall pravidla
  • Firemní síť s požadavky

Obecné Prvky GUI​

Notifikace a Dialogy​

Toast Notifikace​

Malé vyskakovací zprávy v pravém horním rohu:

┌────────────────────────┐
│ ✅ Measurement started │
└────────────────────────┘

Typy:

  • ✅ Success (zelená): Operace úspěšná
  • ℹ️ Info (modrá): Informace
  • ⚠️ Warning (žlutá): Varování
  • ❌ Error (červená): Chyba

Trvání: 3-5 sekund (automaticky zmizí)

Confirmation Dialogs (Potvrzovací Dialogy)​

┌─────────────────────────────────────────┐
│ Confirm Action                          │
├─────────────────────────────────────────┤
│ Are you sure you want to delete         │
│ all files?                              │
│                                         │
│ This action cannot be undone.           │
│                                         │
│           [Cancel]  [Confirm]           │
└─────────────────────────────────────────┘

Kdy se zobrazuje:

  • Mazání souborů/složek
  • Delete All Files
  • Restart zařízení
  • Enter Deep Sleep
  • Disconnect WiFi

Progress Bars (Ukazatele Průběhu)​

Downloading files...
[████████████░░░░░░░░] 60% (6/10)

Použití:

  • Stahování více souborů
  • OTA aktualizace
  • Načítání velkých seznamů

Zobrazuje:

  • Procenta dokončení
  • Počet dokončených/celkových položek
  • Aktuální operaci

Auto-refresh (Automatická Aktualizace)​

Některé části se aktualizují automaticky:

Každé 2 sekundy:

  • Dashboard → Status Display
  • Dashboard → Current Settings (RTC Time)
  • WiFi → WiFi Status

Při akci:

  • Files → Seznam souborů (po smazání/stažení)
  • Schedule → Seznam plánů (po přidání/smazání)
  • Stats → Statistiky (při běžícím měření)

Manuální refresh:

  • Tlačítko 🔄 Refresh v Files
  • F5 / Ctrl+R v prohlížeči

Klávesové Zkratky​

Webové rozhraní podporuje základní klávesové zkratky:

ZkratkaAkce
F5Refresh stránky
Ctrl+RRefresh stránky
EscZavřít dialog/modal
EnterPotvrdit (v dialozích)
TabNavigace mezi poli formuláře

Offline Režim​

Webové rozhraní je plně funkční i bez internetového připojení:

Funguje offline:

  • ✅ Všechny záložky a ovládací prvky
  • ✅ Základní stahování souborů (jednotlivě)
  • ✅ Všechna API volání (local network)

Vyžaduje internet:

  • ❌ ZIP stahování (vyžaduje JSZip z CDN)
  • ❌ NTP synchronizace času
  • ❌ OTA aktualizace firmware
  • ❌ Načítání externích fontů (fallback na systémové)

Fallback chování:

  • Pokud JSZip není dostupná → postupné stahování
  • Pokud NTP selže → použít manuální nastavení
  • Pokud OTA server není dostupný → zobrazí chybu

Tipy pro Efektivní Použití​

Pro Začátečníky​

  1. Start Simple:

    • Začněte v Dashboard
    • Použijte výchozí nastavení (ODR=62.5 Hz, Range=±2g)
    • Spusťte krátké testovací měření (1-2 minuty)

  2. Check Status Regularly:

    • Sledujte Write Errors (mělo být 0)
    • Kontrolujte volné místo na SD
    • Ověřte správný čas

  3. Download Often:

    • Pravidelně zálohujte data
    • Nepoužívejte plnou SD kartu
    • Testujte stahování na malých souborech

Pro Pokročilé​

  1. Optimize Settings:

    • Přizpůsobte ODR podle aplikace
    • Použijte decimaci pro menší soubory
    • Experimentujte s power modes

  2. Automate:

    • Vytvářejte plány pro pravidelná měření
    • Kombinujte s deep sleep
    • Použijte Bluetooth pro bezobslužný provoz

  3. Monitor Performance:

    • Sledujte statistiky
    • Kontrolujte Write Errors
    • Optimalizujte spotřebu

Pro Vývojáře​

  1. Use API:

    • Integrujte s vlastními aplikacemi
    • Automatizujte sběr dat
    • Vytvářejte custom dashboardy

  2. Batch Operations:

    • Stahujte více souborů najednou (ZIP)
    • Používejte bulk delete opatrně
    • Implementujte error handling

  3. Network Optimization:

    • Minimalizujte počet API calls
    • Používejte caching
    • Implementujte retry logiku

Řešení Problémů GUI​

Stránka se nenačte​

Problém: Prázdná stránka nebo "Cannot connect"

Řešení:

  1. Zkontrolujte WiFi připojení (SSID: GeoSnake-Config)
  2. Ověřte URL: http://192.168.4.1 (ne https!)
  3. Zkuste jiný prohlížeč
  4. Vypněte VPN
  5. Restartujte zařízení

Tlačítka nefungují​

Problém: Klikání nemá efekt

Řešení:

  1. Otevřete konzoli prohlížeče (F12)
  2. Zkontrolujte chyby v Console tab
  3. Vymažte cache (Ctrl+Shift+Del)
  4. Zkuste hard refresh (Ctrl+F5)
  5. Použijte jiný prohlížeč

Data se neaktualizují​

Problém: Zobrazené hodnoty jsou staré

Řešení:

  1. Klikněte Refresh (🔄)
  2. Zkontrolujte sílu WiFi signálu
  3. Přepněte na jinou záložku a zpět
  4. Refresh stránky (F5)
  5. Restartujte prohlížeč

Soubory se nestahují​

Problém: Download tlačítko nefunguje

Řešení:

  1. Zkontrolujte popup blocker (povolte popupy)
  2. Zkuste stáhnout jeden soubor (ne hromadně)
  3. Ověřte volné místo na disku počítače
  4. Zkuste jiný prohlížeč
  5. V offline režimu použijte postupné stahování

ZIP download nefunguje​

Problém: "JSZip not available" nebo chyba při ZIPování

Řešení:

  1. Zkontrolujte internetové připojení (JSZip z CDN)
  2. Použijte postupné stahování (automatický fallback)
  3. Stáhněte menší počet souborů najednou
  4. Ověřte volné místo v RAM prohlížeče

Podpora Prohlížečů​

Podporované Prohlížeče​

ProhlížečDesktopMobilPoznámka
Chrome✅ v90+✅ v90+Doporučeno
Firefox✅ v88+✅ v88+Doporučeno
Safari✅ v14+✅ v14+Některé omezení
Edge✅ v90+✅ v90+Chromium-based
Opera✅ v76+✅ v76+Chromium-based
IE 11❌-Nepodporováno

Doporučené Nastavení Prohlížeče​

Pro nejlepší výkon:

  • Povolte JavaScript
  • Povolte cookies
  • Povolte local storage
  • Povolte popupy pro 192.168.4.1
  • Vypněte ad blockery (může blokovat JSZip CDN)

Další Informace​

Související dokumentace:

Podpora:

Verze dokumentace: 1.0
Datum: 7. prosince 2024
Platí pro firmware: v1.2.0+