História stránky

...

Konfigurácia linky File/IO:
- Vstupný súbor: cesta k adresáru, kde budú umiestnené dáta (JSON súbory) stiahnuté zo Sigfox cloudu. Môže byť použitá symbolická konštanta #APPDIR#, ktorá udáva aplikačný adresár, napr. #APPDIR#\/Sigfox_input
  (alebo #APPDIR#/Sigfox_input v prípade Linuxuplatná syntax pre Windows aj Linux).
- Archívny adresár: cesta k adresáru, kde budú umiestnené súbory po spracovaní. KOM proces dátové súbory po spracovaní presunie do podadresárov tohto adresára, ktoré budú mať názov podľa názvu stanice (napr. B.Sigfox_1) a k menu súboru pridá časovú značku udávajúcu čas spracovania (napr. zo súboru msg_21FDA7.txt spraví súbor msg_21FDA7_2018-10-26-06-26-08.txt).
  Podobne ako pre vstupný súbor môže byť použitá symbolická konštanta #APPDIR#, napr. #APPDIR#\Sigfox_archiv
  Pozn 1: chybné súbory alebo súbory, pre ktoré nebola identifikovaná žiadna stanica, budú po spracovaní presunuté do podadresára BAD.
  Pozn 2: pokiaľ archívny adresár nie je zadaný, všetky súbory budú po spracovaní vymazané.

...

Payload Field Name

Parameter

Popis

Jednotka / rozmer

Náhradná hodnota

Kotva

	ct
	ct

Connection Type

Typ spojenia medzi D2000 KOM procesom a druhou stranou (LoRaWAN gateway, sieťový server, cloud).
Aktuálne podporené sú:

Kerlink IoT Station SPN (JSON via UDP packets): komunikácia s Kerlink IoT Station s firmware SPN (Small Private Network). Linka musí byť typu SerialOverUDP Device Redundant.
MQTT Client (JSON via MQTT): komunikácia so sieťovým serverom alebo cloudom pomocou MQTT protokolu. Linka musí byť typu TCP/IP-TCP
Sigfox Client (JSON via HTTPS): komunikácia s cloudom Sigfox

-

Kerlink IoT Station SPN

Kotva

	mf
	mf

Mote Field Name

Názov poľa s identifikátorom LoRaWAN zariadenia (mote).
Pozn: Pre JSON správy, ktoré môžu byť štruktúrované, je podporená syntax level1.level2.level3 ..., napr. rx.moteeui a pokiaľ obsahujú polia (indexované od 1) tak aj level1[index1].level2[index2].level3 ..., napr. rx.gwrx[1].time. Príklady viď popis meraných bodov typu Envelope.

-

rx.moteeui

Pozn: Pre dátové súbory Sigfox, ktoré môžu obsahovať aj viacero hodnôt (historických) je možné použiť aj index 0 resp. prázdny index (napr. data[].device). Toto vyjadruje, že sa majú spracovať všetky prvky poľa.

-

rx.moteeui

Kotva

	pf
	pf

Kotva

pf

Názov poľa s payloadom. Viď poznámku poznámky pri parametri Mote Field Name.

-

rx.userdata.payload

Kotva

	pe
	pe

Payload Encoding

Spôsob kódovania payloadu v správe. Podporené kódovania:

Base16 + Base64 encoding (Kerlink SPN) - pre Connection Type=Kerlink IoT Station SPN
Base64 encoding (TheThings.network) - pre Connection Type=MQTT Client pri komunikácii s cloudom TheThings.network
Base16 encoding (Loriot, Slovanet, Sigfox) - pre Connection Type=MQTT Client pri komunikácii s cloudami LoRaWan(Loriot Slovanet) a SlovanetSigfox
None - správa obsahuje priamo payload - zatiaľ nevyužité

-

Base16 + Base64 encoding

Kotva

	tf
	tf

Time Field Name

Názov poľa s časovou značkou. Ak pole nie je nájdené, hodnotám je priradený aktuálny čas. Viď poznámku poznámky pri parametri Mote Field Name.

-

rx.gwrx[1].time

Kotva

	tm
	tm

Time Mask

Maska pre parsovanie hodnoty v poli s časovou značkou.
Pozn: od nastavení časových parametrov stanice závisí, či je čas interpretovaný ako lokálny alebo UTC s nakonfigurovaným offsetom.
Špeciálne masky sú:

UNIX - číselná hodnota vyjadruje počet sekúnd od epochy 00:00:00 01.01.1970 UTC.
UNIXMS - číselná hodnota vyjadruje počet milisekúnd od epochy 00:00:00.000 01.01.1970 UTC.

-

yyyy-mm-dd hh:mi:ss

Kotva

	ftf
	ftf

Frame Type Field Name

Názov poľa, ktoré označuje typ správy. Ak je hodnota prázdna, typ správy sa nerozlišuje. (Napr. cloud Loriot posiela správy rozličného typu.)

-

Kotva

	ftv
	ftv

Frame Type Field Required Value

Ak je rozlišovanie typu správy aktívne (vyplnený parameter Frame Type Field Name), typ správy musí byť zhodný s uvedenou hodnotou. Inak je správa ignorovaná.

-

Kotva

	fd
	fd

Full Debug

Zapnutie podrobných výpisov o posielaní a prijímaní hodnôt.

YES/NO

NO

Parametre špecifické pre Connection Type=MQTT Client.

Kotva

	un
	un

MQTT User Name

Viď popis parametra User Name v dokumentácii MQTT protokolu.

Kotva

	pw
	pw

MQTT Password

Viď popis parametra Password v dokumentácii MQTT protokolu.

Kotva

	tc
	tc

MQTT Topic Filter

Viď popis parametra Topic Filter v dokumentácii MQTT protokolu.

+/+/+/up

Kotva

	pq
	pq

MQTT Subscribe QoS

Viď popis parametra Subscribe QoS v dokumentácii MQTT protokolu.

Kotva

	ci
	ci

MQTT Client ID

Viď popis parametra Client ID v dokumentácii MQTT protokolu.

Kotva

	cs
	cs

MQTT Clean Session Flag

Viď popis parametra Clean Session Flag v dokumentácii MQTT protokolu.

Kotva

	mp
	mp

MQTT Publish Format

Formát JSON správy použitej pri zápise hodnoty. Obsah meraného bodu typu Write bude zakódovaný (v závislosti od parametra Payload Encoding) a vložený do tejto správy, kde nahradí reťazec #PAY#.
Náhradná hodnota "{"port":1, "confirmed":false, "payload_raw":#PAY#} bola vyskúšaná pri posielaní údajov do cloudu TheThings.Network.

-

"{"port":1, "confirmed":false, "payload_raw":#PAY#}

Kotva

	pq
	pq

MQTT Publish QoS

Viď popis parametra Publish QoS v dokumentácii MQTT protokolu.

Kotva

	pi
	pi

MQTT Ping Interval

Viď popis parametra Ping Interval v dokumentácii MQTT protokolu.

Kotva

	rt
	rt

MQTT Reply Timeout

Viď popis parametra Reply Timeout v dokumentácii MQTT protokolu.

Kotva

	wt
	wt

MQTT Wait Timeout

Viď popis parametra Wait Timeout v dokumentácii MQTT protokolu.

Kotva

	mwr
	mwr

MQTT Max. Wait Retry

Viď popis parametra Max. Wait Retry v dokumentácii MQTT protokolu.

...

* Pozn.: Odoslaná hodnota je v lokálnom čase, je potrebné podľa toho nastaviť časové parametre príslušných staníc.

...

Parametre linky otestované pre Connection Type=Sigfox Client (JSON via HTTPS) voči Sigfox cloudu

Parameter	Hodnota
Connection Type	Sigfox Client (JSON via HTTPS)
Mote Field Name	data[].device
Payload Field Name	data[].data
Payload Encoding	Base16 encoding (Slovanet, Loriot, Sigfox)
Time Field Name	data[].time
Time Mask	UNIX
Frame Type Field Name
Frame Type Field Required Value

Kotva
komunikacna_stanica
komunikacna_stanica
Konfigurácia komunikačnej stanice

...

Komunikačný protokol "IoT over LoRaWAN".
Adresa stanice: adresa stanice je identifikátor konkrétneho zariadenia (mote), ktorý sa nachádza v poli Mote Field Name.
- pre Connection Type=Kerlink IoT Station SPN je adresa textová reprezentácia 8-bajtovej LoRaWAN adresy (napr. 00-00-00-00-21-1a-e3-c8)
- Pre Connection Type=MQTT Client môže byť adresa textová reprezentácia 8-bajtovej LoRaWAN adresy (napr. 0018B2000000147D) alebo symbolická adresa definovaná v rámci MQTT servera (napr. fieldtestdevice)
- pre Connection Type=Sigfox Client (JSON via HTTPS) je adresa identifikátor zariadenia (napr. 21FDA5)

Kotva
stanica_parametre
stanica_parametre
Parametre protokolu stanice

Dialóg konfigurácia stanice - pole Parameter protokolu.
Ovplyvňujú niektoré voliteľné parametre protokolu. Môžu byť zadané nasledovné parametre protokolu stanice:

Tab. č. 2

Parameter

Popis

Jednotka

Náhradná hodnota

Kotva

	dt
	dt

Device Type

Typ LoRaWAN zariadenia. Každý typ zariadenia môže mať vlastnú štruktúru prenášaných dát (payload). Zoznam podporovaných zariadení bude postupne narastať.
Aktuálne podporené zariadenia sú:

None - žiadne zariadenie
OEM device - parsovanie payloadu je vykonávané externou dll knižnicou
Adeunis RF Field Test Device - testovacie zariadenie posielajúce GPS údaje o polohe a údaje o teplote
SolidusTech IndoorUNI Sensor - bytový merač teploty a vlhkosti
SolidusTech miniUNI DS18B20 Sensor - merač teploty pre vonkajšie prostredie
Adeunis RF LoRaWAN TEMP (ARF8180BA) - exteriérový merač teploty s dvomi nezávislými čidlami.
Codea WZU-SG (Landis+Gyr Ultraheat T550) - rádiomodul WZU-SG firmy Codea pre merače tepla Landis+Gyr UH50/UC50/T550

-

None

Kotva

	ed
	ed

External Dll Name

Názov externej DLL knižnice s kódom pre parsovanie payloadu pre Device Type=OEM device.

-

Kotva

	nd
	nd

No Data Timeout

Timeout, po ktorom stanica prejde do chybového stavu, ak neboli prijaté žiadne dáta.

hh:mi:ss

01:00:00

Kotva

	mt
	mt

MQTT Topic (for writing)

Topic použitý pri zápise hodnoty (pre Connection Type=MQTT client).
Pozn: pre užívateľa ipesoft-test a zariadenie fieldtestdevice bol otestovaný voči TheThings.network zápis s MQTT_TOPIC=ipesoft-test/devices/fieldtestdevice/down.

-

Kotva

	dc
	dc

Sigfox Download Command File

Pre Sigfox: cesta k súboru pre sťahovanie dát z cloudu Sigfox do adresára (parameter Vstupný súbor linky typu File I/O) aj s prípadnými parametrami. Cesta môže obsahovať (podobne ako parameter Vstupný súbor) obsahovať symbolickú konštantu #APPDIR# (aplikačný adresár) ako aj #ADDR# (adresa stanice), aby bolo možné použiť jediný súbor na obsluhu viacerých staníc.
Príklad pre Windows: #APPDIR#/Sigfox_cmd/get.bat #ADDR#
Príklad pre Linux: /bin/sh #APPDIR#/Sigfox_cmd/get.sh #ADDR#
Pozn: tento parameter nie je potrebné zadávať, pokiaľ sa o sťahovanie dát stará nezávislý mechanizmus.

Samotné sťahovanie môže využívať utilitu curl na vykonanie HTTPS GET dotazu voči web serveru Sigfox.

Príklad súboru get.bat pre platformu Windows (sťahuje sa cez proxy server, vypína sa overovanie identity servera, xxx:yyy je meno a heslo užívateľa v cloude Sigfox):

rem default count=1, possible to download upto 100 values
set count=1
rem ID of device is 1st parameter
set id=%1
c:\utils\curl.exe --proxy http://proxy:3128 --insecure -u xxx:yyy -o msg_%id%.txt https://backend.sigfox.com/api/devices/%id%/messages?limit=%count%

Príklad súboru get.sh pre platformu Linux (je nutné explicitne zadať, že súbory sa sťahujú napr. do adresára Sigfox_input):

#/bin/sh
# default count=1, possible to download upto 100 values
count=1
base=$(dirname "$0")
#ID of device is 1st parameter
id=$1
#name of downloaded data file (including directory)
datafile=$base/../Sigfox_input/msg_$id.txt
/usr/bin/curl --proxy http://proxy:3128 --insecure -u xxx:yyy -o $datafile https://backend.sigfox.com/api/devices/$id/messages?limit=$count

Kotva

	t
	t

Sigfox Download Timeout

Pre Sigfox: timeout na sťahovanie dát príkazomSigfox Download Command File. Pokiaľ sťahovanie trvá dlhšie, stanica prejde do chybového stavu.

sec

30

Komunikačný protokol "IoT over LoRaWAN".
Adresa stanice: adresa stanice je identifikátor konkrétneho zariadenia (mote), ktorý sa nachádza v poli Mote Field Name.
- pre Connection Type=Kerlink IoT Station SPN je adresa textová reprezentácia 8-bajtovej LoRaWAN adresy (napr. 00-00-00-00-21-1a-e3-c8)
- Pre Connection Type=MQTT Client môže byť adresa textová reprezentácia 8-bajtovej LoRaWAN adresy (napr. 0018B2000000147D) alebo symbolická adresa definovaná v rámci MQTT servera (napr. fieldtestdevice)

...

Dialóg konfigurácia stanice - pole Parameter protokolu.
Ovplyvňujú niektoré voliteľné parametre protokolu. Môžu byť zadané nasledovné parametre protokolu stanice:

Tab. č. 2

Device TypeExternal Dll NameNo Data TimeoutMQTT Topic (for writing)

Kotva
Parameter	Popis	Jednotka	Náhradná hodnota
dt	dt	Typ LoRaWAN zariadenia. Každý typ zariadenia môže mať vlastnú štruktúru prenášaných dát (payload). Zoznam podporovaných zariadení bude postupne narastať. Aktuálne podporené zariadenia sú: None - žiadne zariadenie OEM device - parsovanie payloadu je vykonávané externou dll knižnicou Adeunis RF Field Test Device - testovacie zariadenie posielajúce GPS údaje o polohe a údaje o teplote SolidusTech IndoorUNI Sensor - bytový merač teploty a vlhkosti SolidusTech miniUNI DS18B20 Sensor - merač teploty pre vonkajšie prostredie Adeunis RF LoRaWAN TEMP (ARF8180BA) - exteriérový merač teploty s dvomi nezávislými čidlami.	-	None
Kotva
ed	ed	Názov externej DLL knižnice s kódom pre parsovanie payloadu pre Device Type=OEM device.	-
Kotva
nd	nd	Timeout, po ktorom stanica prejde do chybového stavu, ak neboli prijaté žiadne dáta.	hh:mi:ss	01:00:00
Kotva
mt	mt	Topic použitý pri zápise hodnoty (pre Connection Type=MQTT client). Pozn: pre užívateľa ipesoft-test a zariadenie fieldtestdevice bol otestovaný voči TheThings.network zápis s MQTT_TOPIC=ipesoft-test/devices/fieldtestdevice/down.	-

Kotva
merany_bod
merany_bod
Konfigurácia meraných bodov

...

Strom stránky

Porovnávané verzie

Stará verzia 6

Nová verzia 7

Kľúč

Kotva
komunikacna_stanica
komunikacna_stanica
Konfigurácia komunikačnej stanice

Kotva
stanica_parametre
stanica_parametre
Parametre protokolu stanice

Kotva
merany_bod
merany_bod
Konfigurácia meraných bodov

Strom stránky

História stránky

Porovnávané verzie

Stará verzia 6

Nová verzia 7

Kľúč

Kotvakomunikacna_stanicakomunikacna_stanicaKonfigurácia komunikačnej stanice

Kotvastanica_parametrestanica_parametreParametre protokolu stanice

Kotvamerany_bodmerany_bodKonfigurácia meraných bodov

Kotva
komunikacna_stanica
komunikacna_stanica
Konfigurácia komunikačnej stanice

Kotva
stanica_parametre
stanica_parametre
Parametre protokolu stanice

Kotva
merany_bod
merany_bod
Konfigurácia meraných bodov