Přeskočit na hlavní obsah

Společné funkce

Katalogové aplikace mají řadu společných funkcí, například chování tlačítka nebo práci s nastavením.

Konfigurace režimu sítě​

Firmware některých katalogových aplikací umí komunikovat přes síť NB-IoT/LTE i LoRaWAN. Takový firmware po zapnutí neodesílá žádná data, LED bliká žlutě a je potřeba nastavit správný režim rádia.

Nastavení app mode je zatím potřeba u těchto katalogových aplikací:

Ve výchozím stavu zařízení nepoužívá žádné rádio (režim none) a je potřeba nastavit konfigurační parametr mode.

  • app config mode lte pro síť NB-IoT/LTE
  • app config mode lrw pro síť LoRaWAN

Poté změny uložte příkazem config save. Zařízení se restartuje a použije správnou síť.

Výchozí režim LTE​

Od firmwaru v3.5.0 je výchozím režimem LTE LTE-M s přechodem na NB-IoT (lte-m,nb-iot). Zařízení se nejprve pokusí připojit přes LTE-M, a pokud LTE-M není dostupné, přejde na NB-IoT.

Chování tlačítka​

Aplikace přiřazují tlačítku na základní desce různé akce. Kterou akci zařízení provede, určuje počet stisků tlačítka za sebou. Před provedením akce zařízení CHESTER blikne oranžovou LED tolikrát, kolikrát bylo tlačítko stisknuto. K dispozici jsou tyto akce:

Počet stiskůAkce
1Okamžité odeslání dat
2Okamžité vzorkování dat
3Okamžité vzorkování, agregace a odeslání dat
4Restart zařízení
5Zapnutí zátěžové LED na 2 minuty

Chování LED​

Po zapnutí zařízení CHESTER svítí LED červeně, dokud se aplikace neinicializuje. Potom každých pět sekund blikne zelená LED na znamení, že aplikace běží.

Pokud LED bliká žlutě, je potřeba nastavit, které rádio se má použít.

Výchozí konfigurace​

Výchozí konfigurace, jak ji vypíše příkaz app config show:

app config interval-sample 60
app config interval-aggreg 300
app config interval-report 1800

Konfiguraci změníte příkazem app config a uložíte příkazem config save. Příklad:

app config interval-sample 120
app config interval-aggreg 600
config save

Tím se změny uloží a aplikace se restartuje. Po restartu nové nastavení ověříte příkazem app config show.

Výchozí konfiguraci obnovíte příkazem config reset. Ve vzácných případech, kdy konzole zařízení CHESTER není dostupná, můžete konfiguraci resetovat ručně: podržte tlačítko během startu zařízení. Asi po 5 sekundách začne zařízení rychle blikat. Když teď tlačítko pustíte, reset proběhne. Pokud tlačítko držíte dál, dokud zařízení nepřestane blikat, reset se zruší.

pozor

Reset konfigurace vymaže i parametry připojení k sítím LTE a LoRaWAN, takže zařízení CHESTER pak nemusí být schopné komunikovat.

Konfiguraci můžete měnit i na dálku přes HARDWARIO Cloud, a to downlinkovým příkazem Config. Příkaz config save se z cloudu neposílá.

Detekce CHESTER-Z za běhu​

Od firmwaru v3.5.4 umí některé aplikace rozpoznat záložní modul CHESTER-Z za běhu. Stejný binární soubor firmwaru tak funguje s nainstalovaným modulem CHESTER-Z i bez něj.

  • Když zařízení při startu modul CHESTER-Z najde, automaticky zapne funkce záložního napájení (sledování vstupu DC, napětí záložní baterie, události připojení a odpojení).
  • Když modul CHESTER-Z chybí, funkce záložního napájení se bez hlášení vynechají a na ostatní funkce to nemá žádný vliv.
  • Samostatné varianty firmwaru „Z“ proto už nejsou potřeba: například CHESTER Clime teď pokrývá i to, co dřív obstarával CHESTER Clime Z.

Aplikace s detekcí CHESTER-Z za běhu:

poznámka

Ostatní aplikace dostanou detekci modulu Z za běhu postupně v dalších verzích firmwaru.

Cloudové metriky​

Skupina příkazů shellu cloud slouží k diagnostice komunikace s cloudem. Příkaz cloud metrics vypíše statistiky komunikace:

cloud metrics

Výpis obsahuje počty zpráv uplink a downlink, počty fragmentů, počty chyb s časovými značkami a časy posledních úspěšných operací. Hodí se k diagnostice problémů s připojením v terénu.

Subsystém BLE Tag​

informace

Zařízení CHESTER umí přijímat data také z Bluetooth tagů (subsystém Teltonika EYE Sensor) a bezdrátově tak měřit teplotu a vlhkost.
Jak tuto funkci zapnout a nastavit, popisuje stránka Bluetooth tagy.

Rozptyl intervalu hlášení​

Pravidelné odesílání dat v intervalu interval-report má záměrný rozptyl (jitter). Když je blízko sebe hodně zařízení CHESTER se stejným intervalem, díky rozptylu nevysílají všechna ve stejnou chvíli. Rozptyl je náhodný v rozsahu ±20 % hodnoty interval-report.

Je-li například interval-report nastavený na 100 sekund, může mezi dvěma pravidelnými zprávami uplynout 80 (-20 %) až 120 (+20 %) sekund.

V aplikacích, které posílají více agregovaných hodnot, má rozptyl vedlejší účinek: zpráva někdy obsahuje méně nebo více agregovaných hodnot, než byste čekali. Chybějící hodnoty se neztrácejí, přijdou v následující zprávě.

Na události, jako je stisk tlačítka nebo změna vstupu, se rozptyl nevztahuje. Ty se hlásí okamžitě.

Příkazy shellu​

Kromě výše uvedených příkazů nabízí shell řadu dalších. Vypíšete je příkazem help.

Příklad výstupu příkazu help z aplikace CHESTER Clime:

help
You can try to call commands with <-h> or <--help> parameter for more information.

Available commands:
  accel    :Accelerometer commands.
  aggreg   :Aggregate data immediately
  app      :Application commands.
  backup   :Backup module commands
  batt     :Battery commands.
  ble      :BLE commands.
  button   :Button commands.
  cloud    :Cloud commands.
  config   :Configuration commands.
  flash    :Flash shell commands
  gpio     :GPIO commands
  help     :Prints the help message.
  hygro    :Hygrometer commands.
  i2c      :I2C commands
  info     :Device information commands.
  kernel   :Kernel commands
  led      :LED commands.
  log      :Commands for controlling logger
  lrw      :LoRaWAN commands.
  lte      :LTE commands.
  mcuboot  :MCUboot commands
  rtc      :RTC commands for date/time operations.
  sample   :Sample immediately.
  send     :Send data immediately.
  therm    :Thermometer commands.
  w1       :1-Wire bus commands

Od firmwaru v3.5.0 obsahují všechny aplikace tyto diagnostické příkazy shellu:

  • i2c: operace na sběrnici I2C (skenování, čtení, zápis) pro diagnostiku hardwaru
  • mcuboot: příkazy bootloaderu MCUboot pro správu firmwaru
  • gpio: ovládání a kontrola pinů GPIO
  • w1: skenování sběrnice 1-Wire a výpis zařízení
  • backup: stav záložního modulu CHESTER-Z (sériové číslo, revize HW, napětí, stav vstupu DC)
  • cloud: příkazy pro komunikaci s cloudem včetně cloud metrics pro diagnostiku připojení

Záloha konfigurace v1.x.x → v2.x.x​

Před aktualizací staršího firmwaru v1.x.x na v2.x.x je nutné zálohovat konfiguraci aplikace. Nejdůležitější je to u aplikace CHESTER Current, jejíž konfigurace obsahuje kalibrační koeficienty proudových transformátorů.

Pokud zálohu zapomenete udělat, data se neztratí, dokud v novějším firmwaru nespustíte příkaz config save. Musíte ale dočasně nahrát zpět starší firmware, který starou konfiguraci přečte, a po aktualizaci firmwaru stejnou konfiguraci zadat znovu.

Ve starém firmwaru zadejte do konzole app config show a zkopírujte všechny konfigurační položky. V mobilní aplikaci HARDWARIO Manager i v nástroji HARDWARIO CLI na počítači stačí text aktuální konfigurace označit a zkopírovat do schránky nebo do textového editoru.

Po aktualizaci na novější firmware vložte stejné řádky do konzole. V aplikaci HARDWARIO Manager i v HARDWARIO CLI můžete vložit všechny řádky najednou do vstupního řádku a stisknout Enter; příkazy se provedou jeden po druhém. Příkazem app config show ověřte, že se konfigurace nastavila správně, a nezapomeňte změny uložit příkazem config save.