Sencurio

1. Úvod a popis produktu

1.1 Co je Sencurio?

Sencurio je pokročilý monitoringový systém založený na mmWave radarové technologii, navržený speciálně pro bezpečný dohled nad seniory a osobami vyžadujícími péči. Na rozdíl od tradičních kamerových systémů, Sencurio pracuje výhradně s radarovými daty, což zajišťuje 100% soukromí - žádné obrazy osob nejsou nikdy zachyceny ani ukládány.

1.2 Klíčové vlastnosti

Vlastnost	Popis
Bezkontaktní monitoring	Nepotřebuje nositelná zařízení ani kamera
Detekce pádů	4-vrstvý pipeline s AI klasifikací
Vitalní funkce	Měření dechu (6-30 BPM) a srdečního tepu (48-150 BPM)
Sledování spánku	REM/Light/Deep/Awake fáze + sleep score
AI rutiny	Učení vzorců po 7 dnech, anomálie score 0-100
Více platforem	Web, desktop (Windows), mobilní aplikace (iOS/Android)

1.3 Architektura systému

Systém Sencurio se skládá z několika komponent:

Sencurio zařízení - ESP32-S3 + TI IWR6843 mmWave radar
Sencurio Monitor - Desktopová aplikace pro Windows (kalibrace, 3D vizualizace)
Web Dashboard - Prohlížení stavu a alertů v prohlížeči
Mobilní aplikace - iOS/Android pro pečovatele na cestách
Backend API - Laravel REST API + MQTT broker

            Poznámka k soukromí: Sencurio je navržen s ohledem na GDPR. Radarová data 
            neumožňují identifikaci osob, systém neukládá žádné vizuální záznamy. Veškerá data jsou 
            šifrována při přenosu i uložení.
        

2. Technické specifikace

2.1 Hardware zařízení

Mikrokontrolér ESP32-S3 (Dual-core Xtensa LX7, 240 MHz, 512 KB SRAM, 8 MB PSRAM)

Radarový senzor TI IWR6843AOP (60-64 GHz FMCW mmWave, 3 vysílače / 4 přijímače)

Konektivita Wi-Fi 802.11 b/g/n, Bluetooth 5.0 (BLE), USB 2.0 (CP210x)

Napájení 5V DC, 2A (USB-C nebo DC jack)

Rozměry 85 × 55 × 25 mm (včetně krytu)

Provozní teplota 0°C až +50°C

2.2 Radarové specifikace

Parametr	Hodnota	Poznámka
Frekvenční rozsah	60 - 64 GHz	FMCW modulace
Maximální dosah	9 metrů	Konfigurovatelné (6m/9m módy)
Rozlišení vzdálenosti	~4 cm	Závisí na konfiguraci
Rozlišení rychlosti	~0.1 m/s	Doppler měření
Úhel záběru (azimut)	±70°	Horizontální
Úhel záběru (eleváce)	±70°	Vertikální
Max. počet cílů	20 osob	Současná detekce
Obnovovací frekvence	10 Hz	10 snímků za sekundu

2.3 Přesnost měření

Měření	Přesnost	Rozsah
Pozice (X, Y, Z)	±5 cm	0 - 9 m
Rychlost	±0.1 m/s	-10 až +10 m/s
Dechová frekvence	±1 BPM	6 - 30 BPM
Srdeční tep	±3 BPM	48 - 150 BPM
Výška osoby	±10 cm	0.5 - 2.5 m

2.4 Spotřeba a napájení

Režim	Odběr proudu	Výkon
Aktivní monitoring	~350 mA	~1.75 W
Režim spánku (radar off)	~50 mA	~0.25 W
Špičkový odběr	~500 mA	~2.5 W

Důležité: Pro spolehlivý provoz použijte kvalitní napájecí zdroj (min. 5V/2A). Nedostatečné napájení může způsobovat nestabilitu Wi-Fi a výpadky MQTT.

3. Instalační příručka

3.1 Požadavky na instalaci

Napájení 5V DC, min. 2A (USB-C nebo 5.5mm DC jack)
Wi-Fi síť 2.4 GHz (802.11 b/g/n)
MQTT broker (lokální nebo cloudový)
Prostor pro montáž: stěna nebo strop, min. 2.5m výška

3.2 Montáž zařízení

3.2.1 Doporučená pozice

Typ instalace	Výška	Úhel	Poznámka
Stropní montáž	2.5 - 3.5 m	0° (kolmo dolů)	Nejlepší pokrytí místnosti
Nástěnná montáž	2.0 - 2.5 m	15-30° dolů	Vhodné pro menší prostory
Rohová polička	2.0 - 3.0 m	45° dolů	Pro menší místnosti

3.2.2 Instalační kroky

Výběr pozice: Ujistěte se, že zařízení má čistý výhled do monitorované oblasti. Vyhněte se kovovým překážkám přímo před radarem.
Upevnění: Použijte přiložený držák a šrouby M3. Pro stropní montáž použijte hmoždinky odpovídající nosnosti min. 2 kg.
Napájení: Připojte napájecí zdroj 5V/2A. LED indikátor se rozsvítí modře (boot režim), poté zeleně (připraveno k provisioning).
Provisioning: Použijte mobilní aplikaci Sencurio nebo desktop monitor pro nastavení Wi-Fi a MQTT brokeru.

            Tip pro montáž: Pro optimální detekci pádů doporučujeme stropní montáž. 
            Zařízení umístěné na stropě dokáže nejlépe detekovat změnu výšky osoby a rozlišit pád 
            od běžné aktivity.
        

3.3 Zapojení konektorů

3.3.1 Pinout hlavního konektoru (8-pin)

Pin 1: VCC (+5V) - Napájení hlavního obvodu
Pin 2: GND - Zem
Pin 3: UART_TX - ESP32 TX (3.3V logika)
Pin 4: UART_RX - ESP32 RX (3.3V logika)
Pin 5: USB_DP - USB Data+
Pin 6: USB_DM - USB Data-
Pin 7: RST_N - Reset (active low)
Pin 8: BOOT - Boot mode selection

3.3.2 Debug UART (3-pin header)

Pin 1: GND
Pin 2: TX (3.3V) - Výstup logů
Pin 3: RX (3.3V) - Vstup pro konfiguraci

3.4 Konektivita

3.4.1 Wi-Fi konfigurace

Zařízení podporuje WPA2/WPA3 autentizaci. Pro provisioning použijte:

Mobilní aplikace: BLE provisioning průvodce (doporučeno)
USB sériový port: JSON konfigurace přes terminal
Sencurio Monitor: Desktop aplikace s GUI průvodcem

3.4.2 MQTT broker

Parametr	Hodnota
Protokol	MQTT v3.1.1 / v5.0
Port (TLS)	8883
Port (bez TLS)	1883 (vývoj pouze)
Autentizace	Uživatelské jméno / heslo nebo mTLS
QoS	0 (telemetry), 1 (alerty)

3.5 LED indikace

Barva/Stav	Význam
Modrá (bliká)	Bootování / inicializace
Zelená (svítí)	Připraveno k provisioning / standby
Zelená (bliká)	Wi-Fi připojeno, čeká na MQTT
Bílá (svítí)	Plně připojeno (Wi-Fi + MQTT)
Žlutá (bliká)	Detekována přítomnost v místnosti
Červená (bliká)	Chyba / varování
Fialová (svítí)	OTA aktualizace probíhá

Bezpečnostní upozornění: Před montáží vždy odpojte napájecí zdroj. Zařízení obsahuje citlivou elektroniku - vyhněte se kontaktu s vodou nebo extrémními teplotami.

4. API dokumentace

4.1 MQTT témata

Zařízení identifikujte pomocí {deviceId} - MAC adresa WiFi STA bez dvojteček (12 znaků, malá hex). Toto ID odpovídá poli devices.serial_number v backendové databázi.

4.1.1 Publish témata (zařízení → broker)

Topic	Popis	QoS
`sencurio/{deviceId}/telemetry`	Radarová telemetrie (point cloud, targets)	0
`sencurio/{deviceId}/alert`	Alert události (pád, anomálie)	1
`sencurio/{deviceId}/vital`	Vitalní funkce (dech, tep)	0
`sencurio/{deviceId}/sleep`	Spánková data (fáze, skóre)	0
`sencurio/{deviceId}/heartbeat`	Pravidelné heartbeat (každých 30s)	0
`sencurio/{deviceId}/ota/status`	Stav OTA aktualizace	0
`sencurio/{deviceId}/desktop/rsp`	Odpověď na desktop ping	1

4.1.2 Subscribe témata (broker → zařízení)

Topic	Popis
`sencurio/{deviceId}/config/cmd`	Konfigurační příkazy (radar cfg, zóny)
`sencurio/{deviceId}/ota/url`	OTA aktualizace - URL firmwaru
`sencurio/{deviceId}/desktop/req`	Ping požadavky z desktop monitoru

4.2 Struktury zpráv

4.2.1 Telemetrie (sencurio/{deviceId}/telemetry)

{
  "frame_number": 12345,
  "tlv_present": [6, 7, 8],
  "presence": true,
  "target_count": 2,
  "targets": [
    {
      "id": 1,
      "x": 1.2345,
      "y": 2.5678,
      "z": 0.8901,
      "vx": 0.12,
      "vy": -0.05,
      "vz": 0.0,
      "ax": 0.01,
      "ay": 0.02,
      "az": 0.0,
      "height": 1.75,
      "z_center": 0.9,
      "min_z": 0.1
    }
  ],
  "points": [
    {
      "x": 1.234,
      "y": 2.567,
      "z": 0.89,
      "velocity": 0.5,
      "snr": 15.5,
      "noise": 8.2,
      "target_id": 1,
      "tlv": 6
    }
  ]
}

Pole	Typ	Popis
`frame_number`	number	Sekvenční číslo snímku radar
`tlv_present`	array	Detekované TLV typy v rámci
`presence`	boolean	Přítomnost v zóně
`target_count`	number	Počet sledovaných cílů (max 20)
`targets`	array	Pole sledovaných objektů
`points`	array	Point cloud data (max 60 bodů)

4.2.2 Alert - pád (sencurio/{deviceId}/alert)

{
  "type": "fall_confirmed",
  "severity": "high",
  "height": 1.72,
  "velocity": 4.5
}

4.2.3 Vitalní funkce (sencurio/{deviceId}/vital)

{
  "breathing_bpm": 16.5,
  "heart_bpm": 72.0,
  "anomaly_score": 15
}

4.2.4 Spánek (sencurio/{deviceId}/sleep)

{
  "stage": "deep",
  "rem_min": 45,
  "light_min": 120,
  "deep_min": 90,
  "awake_min": 15,
  "score": 85,
  "bed_exits": 2
}

4.3 Desktop Ping protokol

Desktop ping umožňuje ověřit dostupnost zařízení přes MQTT bez odesílání telemetrie.

Požadavek (publikujte na): `sencurio/{deviceId}/desktop/req`

{
  "v": 2,
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "ts": 1712345678,
  "hmac": "a1b2c3d4e5f6..."
}

Odpověď (přijde na): `sencurio/{deviceId}/desktop/rsp`

{
  "v": 2,
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "ok": true,
  "device_id": "aabbccddeeff",
  "fw_version": "1.0.0",
  "wifi_sta": true,
  "mqtt": true,
  "api_key_set": true
}

HMAC kanonický řetězec:

2\n{request_id}\n{ts}\nping\n

4.4 Konfigurace přes USB

Provisioning přes USB UART (921600 baud, 8N1):

{"cfg":1,"wifi":{"ssid":"MojeWiFi","pass":"heslo123"},"mqtt":"mqtt://192.168.1.10:1883","api_key":"tajny_klic"}

4.5 REST API endpointy (backend)

Endpoint	Metoda	Popis
`/api/v1/auth/login`	POST	Přihlášení (JWT token)
`/api/v1/patients`	GET/POST	Správa pacientů
`/api/v1/devices`	GET/POST	Správa zařízení
`/api/v1/alerts`	GET	Seznam alertů
`/api/v1/telemetry`	GET	Historie telemetrie
`/api/v1/devices/{id}/radar-config`	POST	Nahrání radar .cfg

API klíč: Pro HMAC autentizaci použijte API klíč uložený v zařízení. Tento klíč je generován při provisioning a slouží k ověření příkazů z backendu.

5. FAQ pro integrátory

5.1 Obecné otázky

Q: Potřebuji pro provoz kameru?

A: Ne. Sencurio pracuje výhradně s radarovými daty. Žádná kamera není potřeba a žádné vizuální záznamy nejsou vytvářeny.

Q: Funguje to bez internetu?

A: Lokální režim přes desktopový monitor ano - stačí lokální MQTT broker. Cloudové funkce (push notifikace, web dashboard) vyžadují připojení k internetu.

Q: Jaká je životnost zařízení?

A: MTBF > 50 000 hodin. Při běžném provozu doporučujeme kontrolu každých 12 měsíců.

5.2 Technické otázky

Q: Jak změním radarovou konfiguraci?

A: Nahrajte .cfg soubor přes API endpoint /api/v1/devices/{id}/radar-config nebo přes Sencurio Monitor desktop aplikaci. Konfigurace se aplikuje okamžitě.

Q: Může jedno zařízení pokrýt více místností?

A: Jedno zařízení pokrývá jednu místnost (dosah až 9m). Pro více místností použijte více zařízení s oddělenými MQTT tématy.

Q: Jak funguje detekce pádů?

A: 4-vrstvý pipeline: (1) Fyzický model - detekce rychlé změny výšky, (2) Temporální analýza - ověření trajektorie, (3) Inaktivita - ověření nehybnosti po pádu, (4) TFLite klasifikátor - AI potvrzení. Severity: POSSIBLE → CONFIRMED → CRITICAL.

Q: Jak přesné je měření vitalních funkcí?

A: Dechová frekvence ±1 BPM, srdeční tep ±3 BPM. Přesnost závisí na poloze osoby, vzdálenosti od radaru a kvalitě signálu. Nejlepší výsledky jsou při statickém ležení/spaní ve vzdálenosti 1-3 m.

5.3 Integrace a API

Q: Mám vlastní MQTT broker - jak integrovat?

A: Nakonfigurujte URI brokera přes provisioning JSON. Zařízení publikuje na standardních Sencurio tématech. Pro zpracování dat použijte náš MQTT bridge nebo implementujte vlastní listener.

Q: Jak získám přístup k API?

A: Registrujte se na web dashboardu, vytvořte zařízení a získejte JWT token přes /api/v1/auth/login. Pro zařízení použijte API klíč generovaný při provisioning.

Q: Podporujete Webhooky?

A: Přímo ne - použijte MQTT nebo WebSocket (Laravel Reverb). Alternativně implementujte vlastní middleware na backendu.

5.4 Troubleshooting

Q: Zařízení se nepřipojuje k Wi-Fi

A: Zkontrolujte:

2.4 GHz síť (5 GHz není podporováno)
Správné heslo (max 64 znaků)
Signal strength (min. -70 dBm)
Zkuste blíže k routeru pro provisioning

Q: MQTT se odpojuje

A: Ověřte:

Dostupnost brokeru (ping test)
Port a TLS nastavení
Přihlašovací údaje nebo certifikáty
Napájení zařízení (nedostatečný proud)

Q: Falešné detekce pádů

A: Upravte prahy v konfiguraci, zkontrolujte montážní výšku, vyhněte se kovovým překážkám před radarem. Přidejte vícevrstvou validaci v backendu.

5.5 GDPR a bezpečnost

Q: Jak jsou data chráněna?

A: Všechna data jsou šifrována TLS (MQTT/WSS) nebo mTLS. Uložená data v databázi jsou izolována per-user. Audit logy pro veškeré přístupy.

Q: Mohu exportovat data pacienta?

A: Ano, API endpoint /api/v1/patients/{id}/export poskytuje JSON/CSV export všech telemetrických dat pro GDPR požadavky.

Q: Jak smazat data?

A: DELETE request na /api/v1/patients/{id} s kaskádovým smazáním všech souvisejících dat. Alternativně anonymizace přes ?anonymize=true.

6. Kontaktní informace pro podporu

6.1 Technická podpora

Kanál	Kontakt	Dostupnost
Email	[email protected]	Po-Pá, 8:00-18:00 CET
Telefon	+420 123 456 789	Po-Pá, 9:00-17:00 CET
Web	https://sencurio.cz/podpora	24/7 - dokumentace, FAQ

6.2 Prodej a B2B

Kanál	Kontakt
Email	[email protected]
B2B dotazy	[email protected]
Velkoobchod	+420 123 456 790

6.3 Užitečné odkazy

Web: https://sencurio.cz
Web Dashboard: https://app.sencurio.cz
Dokumentace: https://docs.sencurio.cz
GitHub: https://github.com/carewave/sencurio
Status page: https://status.sencurio.cz

6.4 Komunitní zdroje

Developer forum: https://forum.sencurio.cz
Discord: https://discord.gg/sencurio
Stack Overflow: Tag sencurio-radar

Integrátoři a partneři: Pro přístup k OEM dokumentaci, SDK a prioritní podpoře kontaktujte [email protected]. Nabízíme školení, certifikaci a technickou podporu na místě.

6.5 Záruka a servis

Typ	Podmínky
Záruka	24 měsíců na zařízení, 12 měsíců na baterii
RMA proces	Vyplňte formulář na webu, do 48h odpověď
Servisní středisko	Praha, Brno, Ostrava

Obsah