Mobilní aplikace Telemetrie

Aplikace Telemetrie (Android) slouží ke konfiguraci IoT senzorových jednotek (nRF52/nRF54) přes Bluetooth Low Energy a k volitelnému připojení k účtu služby Telemetrie.online.

První spuštění a oprávnění

Při prvním spuštění aplikace potřebuje tato oprávnění:

Zařízení v okolí / Bluetooth — nutné pro vyhledávání a připojení k senzorům.
Poloha — Android ji vyžaduje pro BLE skenování na starších verzích systému; aplikace polohu nikam neodesílá.

Bez udělených oprávnění nelze skenovat. Oprávnění lze dodatečně povolit v nastavení systému (Aplikace → Telemetrie → Oprávnění).

Vyhledání zařízení (záložka Zařízení)

Otevřete záložku Zařízení — skenování se spustí automaticky (indikace „Skenování BLE…"). Ručně jej spustíte/zastavíte modrým tlačítkem + / ■ vpravo dole.
Nalezené jednotky se zobrazují jako karty s názvem (např. NRF54_1A2B), typem senzoru, verzí firmwaru a sílou signálu (RSSI).
Klepnutím na kartu se k zařízení připojíte.

Zařízení většinu času spí

Kvůli úspornému režimu jednotka vysílá jen krátce (~10 sekund) po svém periodickém probuzení, po stisku resetu nebo po GPIO alarmu. Pokud ji nevidíte, počkejte na její další cyklus, nebo ji probuďte resetem.

Detail zařízení

Po připojení aplikace načte všechny hodnoty ze zařízení. Nahoře vidíte model (typ senzoru), MAC adresu, firmware, napětí baterie a sílu signálu.

Záložka Přehled — živá data (naměřená hodnota, baterie, důvod probuzení, perioda měření), měřicí kanál a tlačítka Nastavení zařízení a Odpojit. Ikonou ↻ obnovíte hodnoty.
Záložka Informace — souhrn: název, jmenovka, firmware, hardwarové ID, ICCID SIM karty, důvod posledního probuzení, surová naměřená hodnota.
Tužka v horní liště — přejmenování zařízení (uloží se přímo do jednotky).

Info

Zařízení se po ~30 sekundách nečinnosti samo odpojí a usne — aplikace vás vrátí na seznam. Nejde o chybu.

80GHz radar — živý přenos

Má-li jednotka nastavený typ senzoru 80GHz radar, objeví se v Přehledu přepínač Živý přenos vzdálenosti. Po zapnutí se měřená vzdálenost (mm) průběžně aktualizuje (~20× za sekundu).

Nastavení zařízení

Otevřete modrým tlačítkem Nastavení zařízení v detailu. Změny se uloží až tlačítkem ULOŽIT ZMĚNY.

Konfigurace senzorů

Položka	Význam
Interval měření	Jak často jednotka měří, v milisekundách (1 000 – 3 600 000).
Typ senzoru	Žádný · I2C · UART · Analogové napětí · Binární vstup · Binární čítač · Alarm wake-up · 80GHz radar.
I2C adresa	Jen pro typ I2C (dekadicky, např. 72 = 0x48).
UART baud rate	Jen pro typ UART.
Vynulovat čítač	Jen pro Binární čítač — vynuluje počet pulzů.

Komunikace (odesílání dat na server)

Položka	Význam
UDP server / port	Cíl, kam jednotka odesílá naměřená data (FCSP protokol). Port 1–65535.
MQTT server, APN	Připraveno pro budoucí LTE přenos.
AES-128 klíč	Šifrovací klíč — zadejte přesně 32 hexadecimálních znaků a odešlete ikonou ⬆. Klíč je z bezpečnostních důvodů jen pro zápis — nelze jej zpětně zobrazit.

Další nastavení a příkazy

Název zařízení (max 32 znaků) a jmenovka — volný popis umístění/účelu (max 48 znaků).
FCSP test — jednotka ihned odešle testovací šifrovaný paket na nastavený UDP server (vyžaduje vyplněný server, port a AES klíč).
OTA update — přepne jednotku do režimu aktualizace firmwaru (DFU) a restartuje ji.
Restartovat zařízení — okamžitý restart. Po restartu/OTA se spojení ukončí — to je očekávané.

Účet Telemetrie.online (volitelné)

Přihlášení není povinné — konfigurace přes Bluetooth funguje i bez něj. Účet zpřístupní cloudové funkce (přehledy, historii měření a alarmy — postupně doplňováno).

Přihlásíte se v Nastavení → Přihlásit se e-mailem a heslem, nebo tlačítkem Pokračovat přes Google.
Zapomenuté heslo: klepněte na Zapomněli jste heslo? a zadejte e-mail — přijde vám odkaz na obnovu.
Odhlášení: v Nastavení klepněte na svůj účet a potvrďte.
Hláška „Dokončete registraci kliknutím na odkaz v e-mailu" znamená, že účet ještě nemá ověřenou e-mailovou adresu.

Vzhled aplikace

V Nastavení → Vzhled aplikace zvolíte světlý režim, tmavý režim, nebo automatiku podle systému. Rychlý přepínač tmavého režimu je také dole v bočním menu.

Řešení potíží

Problém	Řešení
Zařízení se v seznamu neobjevuje	Jednotka nejspíš spí — vysílá jen ~10 s po probuzení. Počkejte na další cyklus nebo ji probuďte resetem. Zkontrolujte také zapnutý Bluetooth a udělená oprávnění.
Spojení se po půl minutě přeruší	Normální chování — jednotka šetří baterii a po nečinnosti usne. Připojte se znovu.
Nelze uložit AES klíč	Klíč musí mít přesně 32 hex znaků (0–9, a–f).
„Příliš mnoho pokusů" při přihlášení	Ochrana účtu — počkejte minutu a zkuste to znovu.
„Server není dostupný"	Zkontrolujte připojení k internetu. Konfigurace přes Bluetooth funguje i offline.
Přihlášení přes Google selže	Zkontrolujte, že máte v telefonu přihlášený Google účet a aktuální Google Play služby.

Časté dotazy

Musím mít účet, abych mohl/a konfigurovat senzory? Ne. Bluetooth konfigurace je plně funkční bez přihlášení.

Kde zjistím hardwarové ID jednotky? V detailu zařízení na záložce Informace (položka Hardware ID). Stejné ID používá server pro párování dat.

Proč aplikace chce polohu? Požadavek systému Android pro BLE skenování. Aplikace polohu nesleduje ani neukládá.

Jak aktualizuji firmware jednotky? V Nastavení zařízení → Příkazy → OTA update; jednotka se přepne do DFU režimu. Samotné nahrání firmwaru probíhá nástrojem nRF Connect / DFU utilitou dle pokynů výrobce.