LoRaWAN

The LoRaWAN I/O Server implements both a LoRaWAN Network and Application servers for the integration of a LoRaWAN network.

HSYCO acts as a server for one or more LoRaWAN gateways configured as standard Semtech packet forwarders. Communication is carried on UDP packets.

The implementation complies with the Semtech's paket forwarder protocol v4.0.1 and supports Class A end devices using unconfirmed data frames and ABP authentication.

HSYCO Configuration

Add a LORAWAN I/O Server in the I/O Servers section of the Settings and set its parameters:

Note that only one instance of the LORAWAN I/O Server is allowed and it consumes one item for each defined gateway from the I/O Servers license total.

High Availability

• Shutdown when inactive: defaults to true.

Options

ID	Default	Values	Description
localport		<port_number>	the IP port number used locally by HSYCO to listen for incoming UDP packets sent by the gateways
debug	false	true	print debugging information to the logs
		false	don't print debugging information to the logs

LoRaWAN Utility

Use the LoRaWAN Utility to automatically discover gateways and devices and setup the communication and functional parameters.

Gateways Configuration

Configure the gateway(s) as standard Semtech packet forwarder(s). Make sure the network configuration allows for the communication with HSYCO and use HSYCO's IP address and the port number specified in the "localport" option for the network server's configuration.

Datapoints

ID	Value	R/W	Description
connection	online	R	ready to receive packets
	offline	R	not ready
gw.<id>.lastseen	<ts>	R	timestamp of the last packet received from gateway <id>
gw.<id>.lastpull	<ts>	R	timestamp of the last "pull data" packet received from gateway <id>
gw.<id>.stat.time	<time>	R	UTC system time reported in the latest status message from gateway <id>
gw.<id>.stat.lati	<n>	R	GPS latitude in degree (float, N is +) reported in the latest status message from gateway <id>
gw.<id>.stat.long	<n>	R	GPS longitude in degree (float, E is +) reported in the latest status message from gateway <id>
gw.<id>.stat.alti	<n>	R	GPS altitude in meter reported in the latest status message from gateway <id>
gw.<id>.stat.rxnb	<n>	R	number of radio packets received reported in the latest status message from gateway <id>
gw.<id>.stat.rxok	<n>	R	number of radio packets received with a valid PHY CRC reported in the latest status message from gateway <id>
gw.<id>.stat.rxfw	<n>	R	number of radio packets forwarded reported in the latest status message from gateway <id>
gw.<id>.stat.ackr	<n>	R	percentage of upstream datagrams that were acknowledged reported in the latest status message from gateway <id>
gw.<id>.stat.dwnb	<n>	R	number of downlink datagrams received reported in the latest status message from gateway <id>
gw.<id>.stat.txnb	<n>	R	number of packets emitted reported in the latest status message from gateway <id>
dev.<id>.lastseen	<ts>	R	timestamp of the last packet received from device <id>
dev.<id>.fcnt.up	<n>	R	server-side uplink frame counter for device <id>. Used for frames validation. If never set and no frame has ever been received it is set to -1
		W	set the server-side downlink frame counter for device <id>
dev.<id>.fcnt.down	<n>	R	value of the last frame counter used to send a downlink to device <id>. If never set o no frame has ever been sent it is set to -1
		W	set the downlink frame counter for device <id>
dev.<id>.warning.data	0	R	the latest uplink frame from device <id> has been decoded correctly
	1	R	error decoding the latest uplink frame from device <id>
dev.<id>.warning.fcnt	0	R	the frame counter in the latest uplink frame from device <id> was valid
	n >= 10	R	the frame counter in the latest uplink frame from device <id> was not valid (n = 10: repetition)
dev.<id>.warning.mic	0	R	the message integrity code (MIC) in the latest uplink frame from device <id> was valid
	1	R	the message integrity code (MIC) in the latest uplink frame from device <id> was not valid
dev.<id>.queue.size	<n>	R	number of downlink frames in the device's queue
dev.<id>.error.tx	NONE	R	last downlink for device <id> was sent correctly to the gateway
	<err_code>	R	the gateway responded with the reported error code to the last downlink request for device <id>. Possible values are "TOO_LATE", "TOO_EARLY", "COLLISION_PACKET", "COLLISION_BEACON", "TX_FREQ", "TX_POWER", "GPS_UNLOCKED"

Release Notes

3.7.0

• initial release

---

LoRaWAN is a registered trademark of LoRa Alliance.

Semtech is a registered trademark of Semtech Corporation.