Přeskočit na hlavní obsah
Firmware v1.4.0

Sestavování NFC konfiguračních šablon pro intervaly, základy LoRaWAN a senzory platí i pro v1.3.x. Sloty pravidel alarmů a formát AppConfigMessage v šabloně (přečíslovaná protobuf pole, kódování v nativních bajtech) míří na připravovaný firmware STICKER v1.4.0.

Generátor konfiguračních šablon

Níže si sestavte konfigurační šablonu pro zařízení STICKER: otevřete sekci, zaškrtněte požadovaná nastavení, nastavte jejich hodnoty a nástroj je zakóduje do payloadu AppConfigMessage, který zařízení přijímá přes NFC. Výsledek se zobrazí jako hexadecimální řetězec a QR kód, a hex existující šablony můžete vložit zpět a dekódovat ho do formuláře.

Zakódují se jen zaškrtnutá nastavení, takže šablona nese právě to, co zvolíte, a lze ji použít na mnoha zařízeních. Formulář pokrývá jen nastavení vhodná pro šablony; identita a tajné údaje jednotlivých zařízení (sériové číslo, klíče a EUI pro LoRaWAN, klíče session, ROM kódy 1-Wire a podobně) jsou záměrně vynechané, protože je mezi zařízeními sdílet nelze.

Open a section and tick the settings to include. Hover or focus a setting to see what it does and its allowed values.
LoRaWAN basics
Radio region for the LoRaWAN band: EU868, US915 or AU915.
US915/AU915 sub-band. 0 to 8 (default 2); 0 enables all channels.
LoRaWAN sync word: PUBLIC or PRIVATE network.
Join method: OTAA (over-the-air activation) or ABP (activation by personalization).
Application
s
How often the device measures. 5 to 3600 s, or 0 to sample once right before each report.
s
How often the device sends an uplink. 60 to 86400 s (default 900).
Store-and-forward: record readings to flash for later replay. Default off.
Which channels to record when history is enabled (default Temperature + Humidity). A channel whose capability is off is not recorded.
mV
Voltage below which a low-battery alarm fires, in millivolts (default 2400 = 2.4 V).
Permit the vendor-token "Vendor reset" on this device. Default on.
Factory calibration mode. Leave off for normal operation.
Sensors
Enable the hall-left sensor.
Enable the hall-right sensor.
Enable input A.
Enable input B.
Enable the light sensor.
Enable the barometer.
Enable the PIR detector.
Enable the 1-Wire bus and auto-detect probes.
Enable the accelerometer.
Accelerometer motion detection: OFF, LOW, MEDIUM or HIGH.
Enable the hall-left pulse totalizer.
Enable the hall-right pulse totalizer.
Enable the input-A pulse totalizer.
Enable the input-B pulse totalizer.
Alarms
s
Minimum seconds between alarm uplinks. 0 to 3600 s; 0 disables the limit.
s
How long the red LED stays on when an alarm fires. 1 to 60 s (default 10).
No alarm rule yet. Add one to include it in the template.
AppConfigMessage hex · 0 byte(s)
(no settings selected)
Template (JSON)
(no settings selected)
Select at least one setting to generate a QR code.
Replaces the current selection. Settings outside this form are ignored.

This is the plaintext config template (an AppConfigMessage protobuf). On a production device the NFC Configurator encrypts it per device before writing it over NFC.

Jak ho používat​

  1. Otevřete sekci (LoRaWAN basics, Interval, Sensors nebo Alarms; ve výchozím stavu jsou sbalené) a zaškrtněte požadovaná nastavení. Po najetí myší nebo zaměření na nastavení se zobrazí krátká nápověda s jeho významem a povolenými hodnotami.
  2. Čísla se kontrolují na rozsah (například vzorkovací interval 5 až 3600 s, interval reportu 60 až 86400 s); hodnota mimo rozsah se označí a do payloadu se nedostane, dokud ji neopravíte.
  3. U Alarms klikněte na + Add alarm rule a přidejte slot (až 16), pak zvolte jeho zdroj a veličinu a nastavte prahy. Pravidlo odeberete přes Remove, nebo nastavte Action na Clear slot a slot se na zařízení vymaže. Bez přidaných pravidel šablona žádné alarmy nenese.
  4. Zkopírujte hexadecimální řetězec, nebo použijte QR kód (nese tentýž hex), a šablonu si uložte či nasdílejte.
  5. Existující šablonu prohlédnete tak, že její hex vložíte do Read a template from hex a kliknete na Load template. Formulář včetně případných pravidel alarmů se naplní tím, co šablona obsahuje, a sekce, které nastavuje, se automaticky rozbalí, abyste viděli, co se změnilo (nastavení mimo tento formulář se ignorují).
Tohle je šablona v plaintextu

Zobrazené bajty jsou nezašifrovaný AppConfigMessage. Na běžném zařízení musí být payload tagu zašifrovaný secret key zařízení (AES-CCM), takže tenhle hex nelze zapsat přímo do produkčního zařízení STICKER. Aplikace HARDWARIO Manager to šifrování pro dané zařízení udělá za vás, když zapisuje konfiguraci. Surový payload přijme přímo jen validační build v plaintextu.

Poznámky k polím
  • Přepínače jsou explicitní: schopnost nastavená na off zapíše tuto schopnost = false, nenechá ji nedotčenou. Zaškrtávejte řádek jen u nastavení, která má šablona nést.
  • Čísla mají povolený rozsah v nápovědě a validují se. Vzorkovací interval přijímá i 0 (vzorek těsně před každým reportem) a limit alarmů přijímá 0 (vypnuto).
  • Pravidla alarmů se kódují do stejných 17bajtových zabalených slotů, jaké používá generátor downlink příkazů a shell příkaz alarm; tady je ale sestavíte editorem pravidel místo vkládání hexu.

Úplný seznam konfigurovatelných parametrů a jejich význam najdete v Konfiguračních parametrech. Načtení hotové šablony do aplikace a její zápis do zařízení popisují Šablony a Instalace aplikace.