Changelog
Release 8.0
RDTP-16304
LRC to Application Server Tunnel Interface
Uplink Frame Report
New field is added:
PayloadEncryption
: Encryption status of the reported LoRaWAN® payload:- 0 = the payload reported in
payload_hex
is in clear text. - 1 = the payload reported in
payload_hex
is encrypted with the device's AppSKey.
- 0 = the payload reported in
Release 7.3
RDTP-18706
LRC to Application Server Tunnel Interface
Uplink Frame Report
The uplink frame report is enhanced when the packet is routed through a relay:
Lrrid
andLrrs.Lrr.Lrrid
: virtual LRR ID allocated to the relay by the LRCRelayid
andLrrs.Lrr.Relayid
: DevEUI of the relayLrrLAT
andLrrLON
: not setLrrESP
,LrrRSSI
andLrrSNR
: ESP/RSSI/SNR measured by the relayBaseStationData
: not set
Downlink Frame Sent Report
The downlink frame sent report is enhanced when the packet is routed through a relay:
Lrrid
: virtual LRR ID allocated to the relay by the LRCRelayid
: DevEUI of the relayDeliveryFailedCause4
: new field to specify the failure cause on RXRTransmissionSlot
: new value 4 (RXR)BaseStationData
: not set
RDTP-20502
LRC to Application Server Tunnel Interface
Uplink Frame Report
New field is added:
LostUplinksAS
: Number of uplink frames lost since the reporting of the previous uplink frame for the same device:- When >0: some uplink frames have been lost and the field provides the number of those uplink frames
- When 0: no uplink frames have been lost
- When <0: some lost uplink frames have been received late and the field provides the negative number of those uplink frames
RDTP-22131
LRC to Application Server Tunnel Interface
Uplink Frame Report
New field is added:
MaxWaitASResps
: Maximum delay in milliseconds for the application server to send a downlink payload on RX1/RX2.
Release 7.2
RDTP-8479
LRC to Application Server Tunnel Interface
All Reports
CustomerData
field is now included in all reports.
The domains associated with the device are reported in CustomerData
field.
Uplink Frame Report / Downlink Frame Sent Report
New field is added:
BaseStationData
: Base Station properties set by provisioning. Only reported for the best LRR when it belongs to the device's owner. Contains the domains associated with the base station.
RDTP-14913
LRC to Application Server Tunnel Interface
Uplink Frame Report
Added new properties:
Lrrs.Lrr.ForwardingNetID
: The NetID of the forwarding NS, when a third-party roaming fNS was used to route the packet.Lrrs.Lrr.ForwardingNSID
: The NSID of the forwarding NS, when a third-party roaming fNS was used to route the packet using LoRaWAN® BE 1.1.
RDTP-15819
LRC to Application Server Tunnel Interface
All Reports
The device name is reported in CustomerData
field.
Uplink Frame Report / Downlink Frame Sent Report
The base station name is reported in BaseStationData
field.
Release 7.1
RDTP-7558
LRC to Application Server Tunnel Interface
All Reports
Uplink/Downlink HTTP connectivity: Custom HTTP headers may be defined in the Generic Application configuration. When defined, custom HTTP headers are included in all HTTP requests transmitted by the LRC.
RDTP-9946
LRC to Application Server Tunnel Interface
Downlink Frame Sent Report
Added Semtech basic station failure causes in DeliveryFailedCause1
and DeliveryFailedCause2
fields.
RDTP-18302
LRC to Application Server Tunnel Interface
Downlink Frame Sent Report
Added new failure cause in DeliveryFailedCause3
field:
- D9: "No eligible LRR found because all have been discarded by the LRC"
Release 7.0
RDTP-2274
LRC to Application Server Tunnel Interface
Uplink Frame Report / Downlink Frame Sent Report
Tags associated with the device are reported in the CustomerData
field.
RDTP-9925
LRC to Application Server Tunnel Interface
Multicast Summary Report
New Multicast Summary report
RDTP-13402
LRC to Application Server Tunnel Interface
Uplink Frame Report / Downlink Frame Sent Report
Added new properties:
-
Roaming
: Indicates the type of roaming, when a third-party roaming fNS was used to route the packet.- 1: Passive roaming
- 2: Handover roaming (not yet implemented)
-
ForwardingNetID
: The NetID of the forwarding NS, when a third-party roaming fNS was used to route the packet. -
ForwardingNSID
: The NSID of the forwarding NS, when a third-party roaming fNS was used to route the packet using LoRaWAN® BE 1.1.
Release 6.1
LRC to Application Server Tunnel Interface
Uplink Frame Report
The Lrrs
field reports up to 10 LRRs which reported the packet before the expiration of the 250 ms deduplication window.
The DevLocTime
, DevLAT
, DevLON
, DevAlt
, DevLocRadius
, DevAltRadius
, DevNorthVel
, DevEastVel
, DevLocDilution
, DevAltDilution
and DevUlFCntUpUsed
fields report the last known geolocation.
The NwGeolocAlgo
and NwGeolocAlgoUsed
fields provide information about the algorithm used to compute the network geolocation.
The DriverCfg
field reports the metadata for driver selection.
The LrrESP
field reports the ESP measured by the best LRR.
Applicative payloads smaller than or equal to the DummyPayloadMaxSize
value configured in the Device Profile are not reported.
An uplink packet is reported to the Application Server when it toggles the Class B state of the device
Location Report
New Location report
Application Server to LRC Tunnel Interface
Downlink Frame
An API v2 implementing new HTTP response codes is available.
Payload
and FPort
query parameters are optional when the FlushDownlinkQueue
query parameter is set to 1: in this case no downlink payload is inserted in the AS downlink queue of the device after the purge.
A new Downlink Frame HTTP response code is returned when the downlink token bucket limit is reached and the DROP strategy is used:
-
API v1:
350 "Token bucket limit reached"
-
API v2:
409 {"code":121,"message":"Token bucket limit reached"}
FPort
value 225 is allowed.
Release 6.0
LRC to Application Server Tunnel Interface
Uplink Frame Report
The DynamicClass
field reports the LoRaWAN® class currently used by the Device.
The ClassBPeriodicity
field reports the Class B periodicity in seconds requested by the device.
The Frequency
field reports the frequency in MHz of the radio channel used to receive the frame.
Downlink Frame Sent Report
The TransmissionSlot
field reports the slot used for downlink frame transmission.
The DeliveryFailedCause3
field provides information about the downlink delivery status on ping slot for Class B devices.
The CorrelationID
field is an identifier used to correlate the downlink frame sent report with the unicast downlink frame previously submitted.
The Frequency
field reports the frequency in MHz of the radio channel used to send the frame.
Notification Report
Added new Notification report.
Application Server to LRC Tunnel Interface
Downlink Frame
The CorrelationID
query parameter is an identifier used to correlate the downlink frame with the associated downlink frame sent report or multicast summary reports.
Added new Downlink Frame HTTP response code: 350 "Invalid CorrelationID. Must be a 64 bits hexadecimal value encoded as string"
.
Updated Downlink Frame HTTP response code: 350 "Invalid LoRa port"
.
Release 5.2.2
LRC to Application Server Tunnel Interface
Downlink Frame Sent Report
New A5
delivery failed cause for radio board error.
Release 5.1
LRC to Application Server Tunnel Interface
Uplink Frame Report
The ConfAFCntDn
field reports the applicative downlink counter CONFIRMED by the device when LoRaWAN® 1.1 is used.
The AFCntDn
field reports the applicative downlink counter to be used for the next downlink frame when LoRaWAN® 1.1 is used.
The TxPower
field reports the transmission conductive power or EIRP of the device.
The NbTrans
field reports the number of transmissions for each uplink message computed by the LRC.
Downlink Frame Sent Report
The AFCntDn
field reports the applicative downlink counter for this packet when LoRaWAN® 1.1 is used.
Application Server to LRC Tunnel Interface
Downlink Frame
The AFCntDn
query parameter provides the applicative downlink counter to be used for the downlink frame when the application server encrypts the payload and LoRaWAN® 1.1 is used.
Release 5.0
LRC to Application Server Tunnel Interface
Uplink Frame Report
The Lrrid
XML element now reports the ID of the LRR that received the packet with the best SNR.
The Lrrs
XML element now reports 3 LRRs which received the packet with the best SNR.
Downlink Frame Sent Report
New DC
delivery failed cause for No GPS-synchronized LRR detected by the LRC.
New DD
delivery failed cause for No LRR connected detected by the LRC.
New DE
delivery failed cause for DC not allowed by the peering operator.
Application Server to LRC Tunnel Interface
Downlink Frame
New HTTP response codes.
Release 4.3
LRC to Application Server Tunnel Interface
Downlink Frame Sent Report
New DB
delivery failed cause for max downlink dwell time check. Max downlink dwell time is defined per RF Region in the LoRaWAN® specification.