Přeskočit na hlavní obsah

Payload a dekodér

Zařízení STICKER posílá data jako krátké binární uplinky (zprávy ze zařízení) a dekodér na síťovém serveru je převádí na JSON. Na této stránce zjistíte, co který uplink nese, kde dekodér získat a jak vypadají dekódovaná data.

Co uplink nese, poznáte podle čísla fPort, které má každá zpráva LoRaWAN.

fPortObsah
2Telemetrie: pravidelná měření a k nim hlášení navíc po alarmu nebo příkazu
3Alarmový report: alarmové události s časem a hodnotou
85Uplink Info (informace o zařízení), uplink s nastavením (hlavní parametry), odpovědi na příkazy a vyčtené záznamy historie. Tento port používají i příkazy do zařízení.
10Jen v kalibračním režimu (test ve výrobě)
  • Telemetrie začíná napětím baterie, příznakem boot (true v prvním hlášení po startu) a stavem alarmů. Za nimi následují hodnoty všech zapnutých senzorů.
  • Jednotky: dekodér vrací hodnoty v běžných jednotkách, například °C, %, hPa, lx a V.
  • Části: kolik bajtů se vejde do jednoho uplinku, závisí na přenosové rychlosti, a ta je u zařízení daleko od brány nízká. Hlášení, které se nevejde, se rozdělí na části odeslané zhruba 3 s po sobě. Dekodér každou část označí, například "pages": "1/2".
  • LoRa P2P: ProXimos Hub dekóduje stejné uplinky stejným dekodérem, viz Režim LoRa P2P.

Chybějící hodnoty​

Klíč s hodnotou null znamená, že senzor je zapnutý, ale nemá platné měření, například kvůli odpojené sondě. Když klíč úplně chybí, je senzor v nastavení vypnutý.

Dekodér​

Dekodér je soubor ttn.js z repozitáře firmwaru STICKER, viz ttn.js na GitHubu. Samotné vydání na GitHubu obsahuje jen soubory firmwaru, dekodér ne.

  • Instalace: na síťovém serveru nastavte soubor jako formátovač payloadu pro uplink i downlink, viz The Things Stack a ChirpStack v4.
  • Příkazy: když soubor slouží i jako formátovač downlinků, můžete příkazy zařazovat do fronty v JSON, viz Příkazy přes downlink. ChirpStack v3 soubor použije jen k dekódování uplinků, proto tam příkazy posílejte v hex.
  • Bez spojování: dekodér zpracuje každý uplink samostatně a části nikdy nespojuje. Části odpovědi spojí až vaše aplikace podle DevEUI, fPortu a pořadového čísla.

Příklady​

  • Alarmový report (fPort 3): pole alarms obsahuje každou změnu s údaji slot, channel, rule (u vestavěného alarmu null), event (activate nebo deactivate), type, value a time. Pole total udává počet všech změn, včetně těch, které se do reportu nevešly. Dokud zařízení nemá nastavené hodiny, mají všechna pole time hodnotu null.
  • Vyčtené záznamy historie (fPort 85): každý history_frame nese pole records se záznamy, z nichž každý má svůj čas time a uložené hodnoty, a také seq vašeho požadavku.

Kdy zařízení tyto zprávy posílá, popisují stránky Alarmy a Historie a čítače.

Příklad telemetrie

Hlášení ze zařízení se zapnutým akcelerometrem a oběma Hallovými spínači (fPort 2). Baterie má 3,36 V, teplota je 23,65 °C a vlhkost 54 %. Hodnoty Hallových spínačů se posílají, i když oba čítače ukazují 0, protože jsou spínače zapnuté.

0108a801100018fa24206c4002900100980104a00100a80104
{
"voltage": 3.36,
"boot": false,
"alarm_status": 0,
"alarm_status_flags": [],
"temperature": 23.65,
"humidity": 54,
"orientation": 2,
"hall_left_count": 0,
"hall_left_is_active": true,
"hall_right_count": 0,
"hall_right_is_active": true
}
Příklad uplinku Info

Hlavní pole dekódovaného uplinku Info (fPort 85): sestavení release, doba běhu 42 s, baterie 3062 mV a žádné aktivní alarmy.

011a13080228d285d8cc04302a50f617580570808004
{
"info": {
"fw_version": "2.0.0",
"build_type_name": "main",
"debug": false,
"serial_number": 1234567890,
"uptime_s": 42,
"battery": 3062,
"active_alarms": []
}
}