Přeskočit na hlavní obsah

The Things Stack

The Things Stack (TTS) je spravovaný síťový server LoRaWAN od společnosti The Things Industries, dostupný jako veřejná cloudová služba (TTS Cloud / Community Edition) nebo jako privátní podnikové nasazení.

Předpoklady
  1. Ujistěte se, že máte přístup k aktivní instanci The Things Stack a v dosahu funkční bránu LoRaWAN.
  2. Než v TTS vytvoříte profily koncových zařízení, přečtěte přes NFC klíče zařízení v aplikaci HARDWARIO Manager.

Klíče zařízení a jejich načtení přes NFC​

Než zařízení STICKER zaregistrujete v The Things Stack, přečtěte přes NFC jeho výrobní klíče v aplikaci HARDWARIO Manager. Nepotřebujete kabel ani programátor, stačí přiložit telefon k zařízení.

S aplikací začínáte?

Projděte si nejdřív rychlého průvodce aplikací HARDWARIO Manager: instalaci aplikace, zapnutí NFC a udělení oprávnění, o která aplikace požádá. STICKER se čte telefonem s Androidem nebo iOS a NFC.

  1. Uložte zařízení, aby aplikace měla jeho secret key. STICKER odpovídá jen šifrovaným kanálem, takže bez klíče aplikace nic nepřečte. Každé zařízení přidáte jen jednou (viz Saved STICKERs) a od té doby aplikace klíč doplňuje sama.
  2. Otevřete STICKER → LoRaWAN keys a zvolte Read LoRaWAN keys.
  3. Přiložte telefon. Zadní stranou telefonu se dotkněte krabičky zařízení STICKER a vteřinu či dvě se nehýbejte. Anténa NFC bývá u horní části zadní strany telefonu; pokud se nic nestane, pomalu telefonem v tom místě pohybujte. S firmwarem v2.0.0 stačí jedno přiložení s telefonem v klidu, na Androidu i na iOS stejně. Celý postup přiložení a to, co během výměny ukazuje LED, popisuje STICKER přes NFC.
  4. Zapište si klíče, které aplikace ukáže. Které to budou, závisí na režimu aktivace: DevEUI, JoinEUI (AppEUI) a AppKey pro OTAA, nebo DevEUI, DevAddr a klíče relace pro ABP, viz Informace o zařízení a klíče LoRaWAN.
  5. Zkontrolujte, že je rádio zapnuté. V STICKER → Configuration musí být v sekci LoRaWAN parametr radio-mode nastavený na LoRaWAN, aby se zařízení po registraci začalo připojovat k síti; z výroby se totiž dodává s vypnutým rádiem. Viz Konfigurace a Šablony, pokud chcete celé sérii zařízení nastavit totéž.

Volba metody aktivace​

Režim aktivacePopisPotřebné údaje
OTAA (bezdrátová aktivace) (doporučeno)Dynamické vyjednání klíčů relace při připojení. Nejvyšší úroveň zabezpečení.DevEUI, JoinEUI (AppEUI), AppKey
ABP (aktivace personalizací)Předem přidělené statické klíče relace. Procedura Join se úplně vynechává.DevAddr, NwkSKey, AppSKey

Formátovač payloadu a konfigurace downlinků​

Při registraci koncového zařízení STICKER v TTS:

  • Formátovač uplinku: V Payload Formatters → Uplink přiřaďte oficiální dekodér payloadu STICKER (ttn.js). Ten dekóduje standardní data ze senzorů na fPort 2 a systémové a alarmové zprávy na fPort 3.
  • Formátovač downlinku: V Payload Formatters → Downlink přiřaďte ttn.js, aby se payloady v JSON pro správu na dálku kódovaly na fPort 85 (viz Příkazy přes downlink).
  • Odpovědi a ohlášení na fPort 85: Kromě odpovědí na příkazy nese fPort 85 také Info a settings-info, které zařízení posílá samo po každém startu nebo připojení k síti a pak každých interval-announce hodin (výchozí 24 h). Odpověď, která se nevejde do jednoho rámce, přijde jako několik stránek se stejným seq; dekodér každou označí pages: "i/N" a kdo potřebuje celou odpověď, spojí stránky podle DevEUI, fPortu a seq.
Verze dekodéru

Používejte ttn.js ze stejného vydání firmwaru, jaké mají vaše zařízení. Firmware v2.0.0 změnil kódování alarmů a 1-Wire, ale bajt verze payloadu zůstal 0x01, takže dekodér oba formáty podle samotného payloadu nerozliší. Flotila, která kombinuje zařízení s v1.4.x a v2.0.0, potřebuje dekodér, který formát volí podle verze firmwaru hlášené v Info zařízení.