Rychlý průvodce zařízením STICKER
Tento průvodce popisuje, jak zařízení STICKER zapnout, zprovoznit a aktivovat a připojit ho ke zvolenému síťovému serveru LoRaWAN (ChirpStack, The Things Stack nebo vlastní backend).
Než začnete
Co je STICKER
STICKER je otevřená IoT platforma založená na SoC STM32WL s integrovanou konektivitou LoRaWAN a softwarově volitelným proprietárním režimem LoRa P2P. Je to kompaktní senzorová platforma na baterie postavená na Zephyr RTOS, na které běží katalogové aplikace jako STICKER Clime, Input a Motion.
Technické podrobnosti najdete v popisu hardwaru.
Co budete potřebovat
- Zařízení STICKER (varianta Clime / Input / Motion)
- Dvě baterie AA (alkalické nebo lithiové, 1,5 V)
- Bránu LoRaWAN v dosahu
- Síťový server LoRaWAN (ChirpStack / TTS / vlastní LNS)
- Telefon s NFC a nainstalovanou aplikací HARDWARIO Manager
Užitečné odkazy
- Průvodce mobilní aplikací pro NFC: HARDWARIO Manager
- Dekodér STICKER: ttn.js na GitHubu
- Přehled produktových listů HARDWARIO: hardwario.com/resources/datasheets
Krok 1: Určete variantu zařízení STICKER
Zařízení STICKER se dodává s nahranou jednou z katalogových aplikací:
- STICKER Clime: Měření teploty, vlhkosti, osvětlenosti a barometrického tlaku.
Dokumentace → - STICKER Input: Externí senzory (1-Wire, Machine Probe) a průmyslové vstupy (impulzy S0, logika 0–30 V).
Dokumentace → - STICKER Motion: Detekce pohybu PIR s extrémně nízkou spotřebou a sledování zrychlení ve třech osách.
Dokumentace →
Krok 2: Zapnutí a výchozí stav z výroby (v1.4.0+)
- Otevřete krabičku a vložte dvě baterie AA podle značek polarity.
- Sledujte startovní sekvenci LED: červená (0,5 s) → žlutá (0,5 s) → zelená (1,5 s).
Od firmwaru v1.4.0 se zařízení STICKER dodává s vypnutým rádiem (radio-mode vypnutý), aby se baterie nevybíjela během přepravy. Zařízení se po vložení baterií nepokusí připojit k síti LoRaWAN. Nevysílá, dokud ho v kroku 3 neaktivujete přes NFC.
- Signalizace stavovou LED: Po startu LED bliká 1× žlutě každé 3 sekundy: zařízení běží normálně, ale rádio je vypnuté.
Krok 3: Konfigurace a aktivace přes NFC
Zařízení STICKER se konfiguruje přiložením telefonu, bez kabelu, bez programátoru a bez softwaru na počítači. Funguje to i bez vložených baterií: pole NFC zařízení napájí dost dlouho na to, aby si nastavení uložilo.
Začněte rychlým průvodcem aplikace HARDWARIO Manager, který popisuje instalaci aplikace, zapnutí NFC a první přiložení.
- Nainstalujte aplikaci a zapněte NFC. STICKER se konfiguruje z telefonu s Androidem.
- Přidejte zařízení do seznamu Saved STICKERs, aby aplikace znala jeho secret key. STICKER totiž odpovídá jen šifrovaným kanálem.
- Přečtěte klíče. Otevřete STICKER → LoRaWAN keys a přiložte telefon k zařízení. Zapište si DevEUI, JoinEUI (AppEUI) a AppKey pro OTAA, nebo DevAddr a klíče relace pro ABP.
- Zapište konfiguraci. Otevřete STICKER → Configuration, v sekci LoRaWAN nastavte region, režim aktivace a klíče, přepněte
radio-modena LoRaWAN a dalším přiložením konfiguraci zapište zpět.
Kde je který krok popsaný
| Co děláte | Návod |
|---|---|
| Instalace aplikace a zapnutí NFC | Instalace aplikace |
| Správné držení telefonu (a krok navíc se zvednutím a druhým přiložením na iOS) | STICKER přes NFC |
| Přidání zařízení a jeho secret key | Saved STICKERs |
| Čtení informací o zařízení a klíčů LoRaWAN | Informace o zařízení a klíče LoRaWAN |
| Čtení, úprava a zápis konfigurace | Konfigurace |
| Konfigurace zařízení bez vložených baterií | Konfigurace vypnutého zařízení |
| Stejné nastavení pro celou sérii zařízení | Šablony |
Co vám LED řekne po přiložení
| LED | Význam | Co dělat |
|---|---|---|
| Deset zelených bliknutí | Zařízení konfiguraci přijalo | Nic. Zápis se povedl |
| Rychlé červené blikání zhruba 2 sekundy | Přiložení bylo odmítnuto. Aplikace použila špatný secret key nebo token, nebo byl požadavek zopakovaný či poškozený. Do zařízení se nic nezapsalo | Zkontrolujte, že je zařízení v seznamu Saved STICKERs uložené se správným secret key, a přiložte telefon znovu |
| Heartbeat se změní z 1× žluté na žlutou + červenou | Rádio je zapnuté a zařízení se připojuje | Počkejte. Připojení může trvat i několik pokusů |
| Heartbeat se ustálí na 1× zelené | Připojeno. Zařízení odesílá payload Device Info on Join | Nic. Zařízení je v provozu |
Krok 4: Registrace na síťovém serveru LoRaWAN
ChirpStack v4
- Zaregistrujte zařízení pomocí DevEUI, JoinEUI a AppKey získaných z aplikace HARDWARIO Manager.
- Přiřaďte dekodér payloadu STICKER.
- Postupujte podle úplného návodu: integrace se síťovým serverem ChirpStack.
The Things Stack (TTS / TTN)
- Přidejte nové koncové zařízení pomocí klíčů OTAA nebo ABP získaných z aplikace HARDWARIO Manager.
- Naimportujte dekodér payloadu.
- Postupujte podle úplného návodu: integrace s The Things Stack.
Krok 5: Kontrola po uvedení do provozu
Po registraci a připojení:
- Zkontrolujte uplinky: Ověřte, že do dashboardu síťového serveru dorazil úvodní uplink Device Info (verze firmwaru, stav baterie, příčina resetu) i pravidelné pakety s daty ze senzorů.
- Zkontrolujte stav LED: Jedno zelené bliknutí každé 3 sekundy potvrzuje kvalitní spojení se sítí a bezproblémový provoz.
- Upravte intervaly: Intervaly vzorkování a odesílání dolaďte přes NFC v aplikaci HARDWARIO Manager nebo příkazy přes downlink LoRaWAN (fPort 85).
Pokud používáte STICKER Input, projděte si před připojením externích sond pokyny ke svorkovnici a přepínačům DIP: průvodce zapojením STICKER Input.
Kontrolní seznam při potížích
LED je jediná zpětná vazba, kterou STICKER na místě poskytuje, a proto podle ní nejrychleji poznáte, co zařízení dělá. Tabulky níže uvádějí všechny vzory ve firmwaru v1.4.0. Většina bliknutí je kvůli úspoře baterie záměrně velmi krátká (5–10 ms), čekejte tedy spíš krátký záblesk než zřetelné bliknutí. Úplný přehled včetně časování najdete v části Signalizace LED.
Stavový heartbeat – jeden vzor každé 3 sekundy
Vždy se ukáže jen jeden vzor. Firmware tyto stavy kontroluje v uvedeném pořadí a platí první shoda, takže závažnější stav překryje méně závažný.
| Vzor LED | Co znamená | Co dělat |
|---|---|---|
| 1× zelená | Normální provoz, připojeno a v pořádku | Nic. To je cílový stav |
| Zelená, pak žlutá | Totéž, ale v zařízení běží sestavení firmwaru debug | U vývojových kusů je to v pořádku; pro nasazení nahrajte sestavení release |
| 1× červená | Je aktivní alarm | Aktivní alarmy přečtete na obrazovce Device info, pak projděte pravidla alarmů |
| 1× žlutá | Rádio vypnuté parametrem radio-mode. Výchozí stav z výroby | Zapište konfiguraci LoRaWAN se zapnutým rádiem (krok 3) |
| 2× žlutá, ~200 ms od sebe | Zhoršené spojení. Kontroly spojení selhávají, ale relace stále trvá | Zkontrolujte pokrytí bránou a umístění antény; jakmile se spojení obnoví, zařízení se zotaví samo |
| 1× žlutá, pak 1× červená ~200 ms poté | Připojuje se nebo znovu připojuje a od sítě nedostává odpověď | Zkontrolujte blízkost brány, frekvenční plán / region a shodu DevEUI, JoinEUI a AppKey se síťovým serverem |
| Červená a žlutá střídavě, dvakrát | Uloženou konfiguraci nešlo načíst. Identita i zprovoznění jsou pryč a zařízení běží na výchozích hodnotách z výroby | Zapište celou konfiguraci znovu přes NFC v aplikaci HARDWARIO Manager; pokud se stav opakuje, zařízení potřebuje servis |
| Vůbec nic | Zařízení je buď v hlubokém spánku (všechny kanály zhasnuté; je to očekávané, nejde o závadu), nebo nemá napájení | Pokud nespí, zkontrolujte polaritu baterií a vyměňte je |
Během přiložení NFC
Když je telefon přiložený k zařízení, LED krok za krokem ukazuje průběh výměny dat.
| LED | Co znamená | Co dělat |
|---|---|---|
| Zelená, svítí | Telefon je v poli NFC | Nehýbejte telefonem |
| Rychlé zelené blikání (~90 ms) | Příkaz se zpracovává | Nehýbejte telefonem |
| Rychlé červené blikání 2 s, pak zhasne | Příkaz odmítnut: špatný secret key nebo vendor token, zopakovaný nebo poškozený požadavek. Do zařízení se nic nezapsalo | Zkontrolujte, že je zařízení uložené se správným secret key, viz Saved STICKERs, a přiložte telefon znovu |
| Zelená a žlutá, svítí | Odpověď je zapsaná a zařízení čeká, až si ji telefon přečte | Nehýbejte telefonem; na iOS telefon zvedněte a přiložte znovu, když vás k tomu dialog skenování vyzve |
| Deset zelených bliknutí, 100 ms svítí / 100 ms nesvítí | Zařízení konfiguraci úspěšně přijalo | Nic |
| Zhasnuto | Výměna skončila, telefon je oddálený | Nic |
Červené blikání při odmítnutí je dobré znát: bez něj by odmítnutý příkaz vypadal pro toho, kdo drží telefon, stejně jako úspěšný. Červené bliknutí během přiložení vždy znamená, že se nic nezapsalo.
Start, vstupy a kalibrace
| Kdy | Vzor LED | Co znamená |
|---|---|---|
| Zapnutí | Červená 0,5 s → žlutá 0,5 s → zelená 1,5 s (celkem ~5 s) | Normální start; zároveň ukazuje, že fungují všechny tři kanály. Pokud sekvenci uvidíte nečekaně, zařízení se restartovalo |
| Vstup se aktivuje | Zelená, pak oranžová. Každá 50 ms | Sepnul vstup zařízení STICKER Input nebo Hallův spínač |
| Vstup se vrátí do klidu | Oranžová, pak zelená. Každá 50 ms | Tentýž vstup zase rozepnul |
| Žádná signalizace vstupů | (zhasnuto) | Tato pomůcka pro uvádění do provozu se hodinu po zapnutí sama vypne; pokud ji při testování potřebujete znovu, odpojte zařízení od napájení a znovu ho připojte |
| Vstup do kalibrace | Pět rychlých oranžových bliknutí | Spouští se režim kalibrace |
| Probíhající kalibrace | 1× oranžová každou sekundu | Běží 120 minut, pak se zařízení samo restartuje |
Potíže, které LED neukáže
| Příznak | Co zkontrolovat |
|---|---|
| Na síťovém serveru nepřicházejí uplinky, ale heartbeat je 1× zelená | Zařízení je připojené a běží. Zkontrolujte, že uplink dorazí až do aplikace a že je v síťovém serveru (ChirpStack nebo The Things Stack) přiřazený dekodér payloadu |
| Uplinky přicházejí, ale dekódují se jako surové bajty | Chybí kodek ttn.js, nebo je přiřazený pro špatný směr, viz návod k nastavení příslušného síťového serveru |
| Telefon zařízení nikdy nepřečte | Pomalu pohybujte telefonem okolo jeho antény NFC (obvykle v horní části zadní strany telefonu) a ověřte, že je NFC zapnuté, viz Instalace aplikace |
| Uplinky jsou příliš časté nebo příliš řídké | Upravte intervaly vzorkování a odesílání přes NFC, nebo příkazem přes downlink na fPort 85 |