História stránky

• 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

• 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 Sigfox
• None - správa obsahuje priamo payload - zatiaľ nevyužité

• 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.

• 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

Pre Sigfox: cesta k súboru pre sťahovanie dát z cloudu Sigfox do vstupného adresára (daného parametrom Vstupný súbor linky typu File I/O) aj s prípadnými parametrami. Cesta môže obsahovať (podobne ako parameter Vstupný súbor) symbolickú konštantu #APPDIR# (aplikačný adresár) a navyše 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

Pozn: pred spustením KOM procesu je možné príkazové súbory upraviť a zväčšiť parameter count až na hodnotu 100, čo spôsobí, že bude načítaná nielen najnovšia hodnota, ale aj predchádzajúce (až 99) historické hodnoty. Potom, po prvom stiahnutí, je možné parameter count zmenšiť na 1.

Merané body parsované z payloadu. Adresa (Address) závisí od typu zariadenia (parameter Device Type). Adresa nie je citlivá na malé/veľké písmená.
Špeciálnym prípadom je nevyplnená adresa - takýto meraný bod bude obsahovať celý payload (po príslušnom dekódovaní v závislosti od parametra Payload Encoding).
Nasledujúce tabuľky udávajú adresy pre jednotlivé typy zariadení:

Adresy payloadu pre typ zariadenia OEM Device
adresa záleží od konkrétnej implementácie (dll knižnice).

Adresy payloadu pre typ zariadenia Adeunis RF Field Test Device

Adresy payloadu pre typ zariadenia SolidusTech IndoorUNI Sensor

Adresy payloadu pre typ zariadenia SolidusTech miniUNI DS18B20 Sensor

Adresy payloadu pre typ zariadenia Adeunis RF LoRaWAN TEMP (ARF8180BA)

Adresy payloadu pre typ zariadenia Codea WZU-SG (Landis+Gyr Ultraheat T550). Podporený je formát správy "A" (aktuálne hodnoty posielané raz denne).

{ 
  "rx": {
    "moteeui": "00-00-00-00-00-1e-fc-1d", 
    "userdata": {
        "seqno": 77, 
        "port": 1, 
        "payload": "NzM3RjAwZTgwMA==", 
        "motetx": {
            "freq": 868500000,
	    "modu": "LoRa",
	    "datr": "SF7BW125",
	    "codr": "4/5"
	}
     },
     "gwrx": [
        {
         "time": "2017-07-05 16:06:52",
	 "chan": 2,
	 "rfch": 0,
	 "rssi": -33,
	 "lsnr": 7.5
        }
     ]
  }
}
	

{
  "app_id":"ipesoft-test",
  "dev_id":"fieldtestdevice",
  "hardware_serial":"0018B2000000147D",
  "port":2,
  "counter":549,
  "payload_raw":"niNJElVwAYQ5UBYfBBBN",
  "metadata":{
    "time":"2017-08-10T08:12:26.06860368Z",
    "frequency":867.5,
    "modulation":"LORA",
    "data_rate":"SF7BW125",
    "coding_rate":"4/5",
    "gateways":[
      {
        "gtw_id":"eui-000000000003080b",
	"timestamp":705621508,
	"time":"2017-08-10T08:12:26.434682Z",
	"channel":5,
	"rssi":-34,
	"snr":7.8,
	"latitude":49.20927,
	"longitude":18.73184,
	"altitude":359
      }
    ]
  }
}