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 pro firmware v2.0.0: ttn.js na GitHubu. Formát payloadu ve v2.0.0 se liší od v1.4.x, takže pokud máte v síti zařízení s oběma verzemi, musíte dekodér volit podle verze firmwaru, kterou zařízení hlásí v Device Info, ne podle payloadu
- 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 dva externí vstupy, každý nastavitelný jako digitální, analogový 0–24 V nebo impulzní S0 (
cap-gpio-mode,cap-gpio-input-a/cap-gpio-input-b).
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. Jedno přiložení stačí na celé čtení nebo zápis: držte telefon v klidu, dokud výměna dat neskončí.
Od firmwaru v2.0.0 procházejí všechny příkazy NFC schránkou (mailboxem) čipu NFC, která funguje jen za běhu zařízení. Nejdřív vložte baterie. Zařízení bez baterií nebo s vybitou baterií se v telefonu ukáže jako prázdný tag.
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 i z iPhonu, na obou stejně.
- Přidejte zařízení do seznamu Saved STICKERs, aby aplikace znala jeho secret key. STICKER totiž na požadavky na konfiguraci a klíče 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 (jedno přiložení, telefon v klidu) | 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 |
| Stejné nastavení pro celou sérii zařízení | Šablony |
Co vám LED řekne po přiložení
| LED | Význam | Co dělat |
|---|---|---|
| Zelená a žlutá na 2 sekundy | Přiložení skončilo a jeho poslední výměna dat se povedla | Nic. Pokud zápis vyžaduje restart, následuje startovní sekvence |
| Červená na 2 sekundy | Poslední výměna dat selhala. Požadavek byl odmítnut ještě před provedením (špatný secret key nebo token, zopakovaný nebo poškozený rámec; v tom případě se nic nezapíše), nebo se odpověď nedostala do telefonu. Příkaz, na který zařízení odpoví chybou, například kvůli hodnotě mimo rozsah, skončí zeleně a žlutě; chybu ukáže aplikace | 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í odešle payload Device Info a po něm uplink settings-info se svým hlavním nastavením (oba na fPort 85) | 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), po něm uplink settings-info a také pravidelné pakety s daty ze senzorů. Dvojici Device Info a settings-info zařízení posílá znovu každých
interval-announcehodin (výchozí hodnota 24 h), takže síť má vždy aktuální kopii jeho konfigurace. - Zkontrolujte stav LED: Jedno zelené bliknutí každé 3 sekundy potvrzuje, že je zařízení připojené, kontroly spojení procházejí a není aktivní žádný alarm.
- 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 v2.0.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 |
|---|---|---|
| Č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 |
| 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 |
| 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á | Rádio vypnuté: radio-mode off (výchozí stav z výroby), radio-mode p2p na zařízení bez klíčů pro P2P (nenastavený AppKey nebo DevEUI), nebo region LoRaWAN, který tento obraz firmwaru nepodporuje | Zapište konfiguraci LoRaWAN nebo P2P se zapnutým rádiem (krok 3) |
| 1× červená | Je aktivní alarm | Aktivní alarmy přečtete na obrazovce Device info, pak projděte pravidla alarmů |
| 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 |
| Vůbec nic | Buď je kus s firmwarem debug v hlubokém spánku (všechny kanály zhasnuté; je to očekávané, nejde o závadu), nebo zařízení nemá napájení, nebo se při zapnutí samo vypnulo, protože napětí baterie bylo pod 1,8 V | 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í (nejvýš 5 s) | Telefon je v poli NFC, relace ještě nezačala | Nehýbejte telefonem |
| Zelená, bliká (~90 ms) | Probíhá relace: telefon a zařízení si vyměňují příkazy | Nehýbejte telefonem |
| Zelená a žlutá, 2 s | Relace skončila, poslední výměna dat se povedla | Nic |
| Červená, 2 s | Relace skončila, poslední výměna dat selhala: požadavek byl odmítnut ještě před provedením (špatný secret key nebo vendor token, zopakovaný nebo poškozený rámec; v tom případě se nic nezapíše), nebo se odpověď nedostala do telefonu | Zkontrolujte, že je zařízení uložené se správným secret key, viz Saved STICKERs, a přiložte telefon znovu |
| Zhasnuto | Výměna dat skončila | Nic |
Červený výsledek je dobré znát: bez něj by neúspěšná výměna dat vypadala pro toho, kdo drží telefon, stejně jako úspěšná. Příkaz, po kterém se zařízení restartuje (uložení, reset, restart), nejdřív ukáže svůj výsledek a teprve pak následuje startovní sekvence. Příkaz, na který zařízení odpoví chybou (například kvůli hodnotě mimo rozsah), skončí zeleně a žlutě; chybu ukáže aplikace.
Start, vstupy a kalibrace
| Kdy | Vzor LED | Co znamená |
|---|---|---|
| Zapnutí | Červená 0,5 s → žlutá 0,5 s → zelená 1,5 s (celkem ~3 s) | Normální start; zároveň ukazuje, že fungují všechny tři kanály. Zařízení během sekvence dál startuje, takže ho nezdržuje. Pokud sekvenci uvidíte nečekaně, zařízení se restartovalo |
| Zapnutí s baterií pod 1,8 V | Startovní sekvence, pak 5 s červené blikání každých 200 ms, 1 s trvale červená, pak zhasne | Baterie je vybitá. Zařízení se samo vypne a zůstane vypnuté, dokud baterie nevyměníte nebo zařízení neresetujete signálem NRST |
| 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 | Ověřte, že je zařízení napájené: bez baterií nebo s vybitou baterií se ukáže jako prázdný tag. Pak 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 |