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

Konfigurační šablony NFC pro intervaly, základní nastavení LoRaWAN a senzory fungují i s verzí v1.3.x. Sloty pravidel alarmů a formát AppConfigMessage v šabloně (přečíslovaná pole protobuf, kódování v nativních bajtech) jsou určené pro 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. Hexadecimální řetězec existující šablony můžete naopak vložit a dekódovat zpět do formuláře.

Zakódují se jen zaškrtnutá nastavení, takže šablona obsahuje právě to, co zvolíte, a lze ji použít pro mnoho zařízení. 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 relace, kódy ROM senzorů 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 generátor 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í. Když na nastavení najedete myší nebo na něj přesunete fokus, zobrazí se krátká nápověda s jeho významem a povolenými hodnotami.
  2. U čísel se kontroluje rozsah (například interval vzorkování 5 až 3600 s, interval odesílání 60 až 86400 s); hodnota mimo rozsah se označí a do payloadu se nedostane, dokud ji neopravíte.
  3. V sekci Alarms přidejte slot tlačítkem + Add alarm rule (nejvýše 16), zvolte jeho zdroj a veličinu, nastavte hodnoty pravidla a Dwell (s), dobu držení v sekundách, kterou používají všechny druhy pravidel (0 až 3600, viz Parametr dwell). Pravidlo s dobou držení mimo tento rozsah se označí a do payloadu se nezahrne, dokud ji neopravíte. Pravidlo odeberete tlačítkem Remove; když nastavíte Action na Clear slot, šablona daný slot v zařízení vymaže. Bez přidaných pravidel šablona žádné alarmy neobsahuje.
  4. Zkopírujte hexadecimální řetězec, nebo použijte QR kód (obsahuje tentýž řetězec), a šablonu uložte nebo sdílejte.
  5. Existující šablonu prohlédnete tak, že její hexadecimální řetězec vložíte do pole 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í).
Toto je nešifrovaná šablona

Zobrazené bajty jsou nezašifrovaný AppConfigMessage. Na běžném zařízení musí být payload tagu zašifrovaný pomocí secret key zařízení (AES-CCM), takže tento řetězec nelze zapsat přímo do produkčního zařízení STICKER. Aplikace HARDWARIO Manager payload pro konkrétní zařízení zašifruje za vás, když zapisuje konfiguraci. Surový payload přijme přímo jen validační sestavení firmwaru bez šifrování.

Poznámky k polím
  • Přepínače se zapisují vždy: schopnost nastavená na off se zapíše jako false, nezůstane beze změny. Zaškrtněte jen řádky nastavení, která má šablona obsahovat.
  • U čísel nápověda uvádí povolený rozsah a hodnoty se kontrolují. Interval vzorkování přijímá i 0 (vzorek těsně před každým odesláním) a limit alarmů přijímá 0 (vypnuto).
  • Pravidla alarmů se kódují do stejných 17bajtových binárních slotů, jaké používá Generátor příkazů přes downlink a příkaz shellu alarm; tady je ale místo vkládání hexadecimálních řetězců sestavíte v editoru pravidel.

Úplný seznam konfigurovatelných parametrů a jejich význam najdete v přehledu konfiguračních parametrů. Jak hotovou šablonu načíst do aplikace a zapsat do zařízení, popisují stránky Šablony a Instalace aplikace.