IoT over LoRaWAN/Sigfox

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

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

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

-

rx.userdata.payload

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 Sigfox

• None - správa obsahuje priamo payload - zatiaľ nevyužité

-

Base16 + Base64 encoding

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

-

rx.gwrx[1].time

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

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

-

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

-

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

YES/NO

NO

Parametre špecifické pre Connection Type=MQTT Client.

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

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

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

+/+/+/up

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

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

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

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#}

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

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

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

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

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

Connection Type

Kerlink IoT Station SPN

Mote Field Name

rx.moteeui

Payload Field Name

rx.userdata.payload

Payload Encoding

Base16 + Base64 encoding

Time Field Name

rx.gwrx[1].time

Time Mask

yyyy-mm-dd hh:mi:ss

Frame Type Field Name

Frame Type Field Required Value

Connection Type

MQTT client

Mote Field Name

dev_id alebo hardware_serial

Payload Field Name

payload_raw

Payload Encoding

Base64 encoding

Time Field Name

metadata.time

Time Mask

yyyy-mm-dd hh:mi:ss.mss

Frame Type Field Name

Frame Type Field Required Value

MQTT User Name

ipesoft-test

MQTT Password

***

MQTT Topic Filter

+/+/+/up

MQTT Client ID

D2000kom

MQTT Clean Session Flag

NO

MQTT Publish Format

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

MQTT Publish QoS

QoS_0, QoS_1, QoS_2

MQTT Ping Interval

60

MQTT Reply Timeout

20

MQTT Wait Timeout

00.100

MQTT Max. Wait Retry

3

Connection Type

MQTT client

Mote Field Name

EUI

Payload Field Name

data

Payload Encoding

Base16 encoding

Time Field Name

ts

Time Mask

UNIXMS

Frame Type Field Name

cmd

Frame Type Field Required Value

rx

MQTT User Name

MQTT Password

MQTT Topic Filter

com/ipesoft/iot

MQTT Client ID

D2000kom

MQTT Clean Session Flag

NO

MQTT Publish Format

MQTT Publish QoS

QoS_1

MQTT Ping Interval

60

MQTT Reply Timeout

20

MQTT Wait Timeout

00.100

MQTT Max. Wait Retry

3

Connection Type

MQTT client

Mote Field Name

devEUI

Payload Field Name

dataHex

Payload Encoding

Base16 encoding

Time Field Name

timeStamp

Time Mask *

yyyy-mm-ddThh:mi:ss.mss

Frame Type Field Name

Frame Type Field Required Value