diff --git a/draft-ietf-lpwan-schc-over-lorawan.md b/draft-ietf-lpwan-schc-over-lorawan.md deleted file mode 100644 index 08b3e28..0000000 --- a/draft-ietf-lpwan-schc-over-lorawan.md +++ /dev/null @@ -1,1135 +0,0 @@ ---- -stand_alone: true -ipr: trust200902 -docname: draft-ietf-lpwan-schc-over-lorawan-latest -cat: std -pi: - symrefs: 'yes' - sortrefs: 'yes' - strict: 'yes' - compact: 'yes' - toc: 'yes' -title: Static Context Header Compression (SCHC) over LoRaWAN -abbrev: SCHC-over-LoRaWAN -wg: lpwan Working Group -author: -- ins: O. Gimenez - name: Olivier Gimenez - org: Semtech - street: 14 Chemin des Clos - city: Meylan - country: France - email: ogimenez@semtech.com - role: editor -- ins: I. Petrov - name: Ivaylo Petrov - org: Acklio - street: 1137A Avenue des Champs Blancs - city: 35510 Cesson-Sevigne Cedex - country: France - email: ivaylo@ackl.io - role: editor -normative: - RFC2119: - RFC8174: - RFC4291: - RFC4493: - RFC8724: - lora-alliance-spec: - title: LoRaWAN Specification Version V1.0.4 - author: - name: LoRa Alliance - date: 10.2020 - target: https://lora-alliance.org/resource_hub/lorawan-104-specification-package/ -informative: - RFC8064: - RFC8065: - RFC8376: - lora-alliance-remote-multicast-set: - title: LoRaWAN Remote Multicast Setup Specification Version 1.0.0 - author: - name: LoRa Alliance - date: 09.2018 - target: https://lora-alliance.org/sites/default/files/2018-09/remote_multicast_setup_v1.0.0.pdf - ---- abstract - -The Static Context Header Compression (SCHC) specification describes generic -header compression and fragmentation techniques for Low Power Wide Area -Networks (LPWAN) technologies. SCHC is a generic mechanism designed for great -flexibility so that it can be adapted for any of the LPWAN technologies. - -This document specifies a profile of RFC8724 to use SCHC in LoRaWAN® networks, -and provides elements such as efficient parameterization and modes of -operation. - ---- middle - -# Introduction {#Introduction} - -SCHC specification [RFC8724] describes -generic header compression and fragmentation techniques that can be used on all -Low Power Wide Area Networks (LPWAN) technologies defined in -{{RFC8376}}. Even though those technologies share a great -number of common features like star-oriented topologies, network architecture, -devices with mostly quite predictable communications, etc; they do have some -slight differences with respect to payload sizes, reactiveness, etc. - -SCHC provides a generic framework that enables those devices to communicate on -IP networks. However, for efficient performance, some parameters -and modes of operation need to be set appropriately for each of the LPWAN -technologies. - -This document describes the parameters and modes of operation when -SCHC is used over LoRaWAN networks. LoRaWAN protocol is specified by the -LoRa® Alliance in {{lora-alliance-spec}} - -# Terminology - -The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", -"SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this -document are to be interpreted as described in BCP 14 {{RFC2119}} {{RFC8174}} -when, and only when, they appear in all capitals, as shown here. - -This section defines the terminology and acronyms used in this document. For -all other definitions, please look up the SCHC specification -[RFC8724]. - -- DevEUI: Device Extended Unique Identifier, an IEEE EUI-64 identifier - used to identify the device during the - procedure while joining the network (Join Procedure). It is assigned by the - manufacturer or the device owner and provisioned on the Network Gateway. -- DevAddr: a 32-bit non-unique identifier assigned to a device either: - - - Statically: by the device manufacturer in *Activation by Personalization* - mode. - - Dynamically: after a Join Procedure by the Network Gateway in *Over The - Air Activation* mode. - -- Downlink: LoRaWAN term for a frame transmitted by the network and - received by the device. -- EUI: Extended Unique Identifier -- LoRaWAN: LoRaWAN is a wireless technology based on Industrial, - Scientific, and Medical (ISM) radio bands that is used for long-range, - low-power, low-data-rate applications developed by the LoRa Alliance, a - membership consortium: [https://www.lora-alliance.org](https://www.lora-alliance.org). -- FRMPayload: Application data in a LoRaWAN frame. -- MSB: Most Significant Byte -- OUI: Organisation Unique Identifier. IEEE assigned prefix for EUI. -- RCS: Reassembly Check Sequence. Used to verify the integrity of the - fragmentation-reassembly process. -- RX: Device's reception window. -- RX1/RX2: LoRaWAN class A devices open two RX windows following an - uplink, called RX1 and RX2. -- SCHC gateway: The LoRaWAN Application Server that manages translation - between IPv6 network and the Network Gateway (LoRaWAN Network - Server). -- Tile: Piece of a fragmented packet as described in [RFC8724] section 8.2.2.1 -- Uplink: LoRaWAN term for a frame transmitted by the device and received - by the network. - -# Static Context Header Compression Overview - -This section contains a short overview of SCHC. For a detailed description, -refer to the full specification [RFC8724]. - -It defines: - -1. Compression mechanisms to avoid transporting information known by both - sender and receiver over the air. Known information is part of the - "context". This component is called SCHC Compressor/Decompressor (SCHC C/D). -2. Fragmentation mechanisms to allow SCHC Packet transportation on small, and - potentially variable, MTU. This component is called SCHC Fragmentation/Reassembly - (SCHC F/R). - -Context exchange or pre-provisioning is out of scope of this document. - -~~~~ - Device App -+----------------+ +----+ +----+ +----+ -| App1 App2 App3 | |App1| |App2| |App3| -| | | | | | | | -| UDP | |UDP | |UDP | |UDP | -| IPv6 | |IPv6| |IPv6| |IPv6| -| | | | | | | | -|SCHC C/D and F/R| | | | | | | -+--------+-------+ +----+ +----+ +----+ - | +---+ +----+ +----+ +----+ . . . - +~ |RGW| === |NGW | == |SCHC| == |SCHC|...... Internet .... - +---+ +----+ |F/R | |C/D | - +----+ +----+ -|<- - - - LoRaWAN - - ->| -~~~~ -{: #Fig-archi title='Architecture'} - -{{Fig-archi}} represents the architecture for compression/decompression, it is -based on {{RFC8376}} terminology. The device is sending applications flows -using IPv6 or IPv6/UDP protocols. These flows might be compressed by a Static -Context Header Compression Compressor/Decompressor (SCHC C/D) to reduce headers -size and fragmented by the SCHC Fragmentation/Reassembly (SCHC F/R). -The resulting information is sent on a layer two -(L2) frame to an LPWAN Radio Gateway (RGW) that forwards the frame to a Network -Gateway (NGW). The NGW sends the data to a SCHC F/R for reassembly, if -required, then to SCHC C/D for decompression. The SCHC C/D shares the same rules with the -device. The SCHC C/D and F/R can be located on the Network Gateway (NGW) or in -another place as long as a communication is established between the NGW and the SCHC -F/R, then SCHC F/R and C/D. The SCHC C/D and F/R in the device and the SCHC gateway MUST -share the same set of rules. After decompression, the packet can be sent on the Internet to -one or several LPWAN Application Servers (App). - -The SCHC C/D and F/R process is bidirectional, so the same principles can -be applied to the other direction. - -In a LoRaWAN network, the RGW is called a Gateway, the NGW is Network Server, -and the SCHC C/D and F/R are an Application Server. It can be provided by -the Network Gateway or any third party software. {{Fig-archi}} can be mapped in -LoRaWAN terminology to: - -~~~~ - End Device App -+--------------+ +----+ +----+ +----+ -|App1 App2 App3| |App1| |App2| |App3| -| | | | | | | | -| UDP | |UDP | |UDP | |UDP | -| IPv6 | |IPv6| |IPv6| |IPv6| -| | | | | | | | -|SCHC C/D & F/R| | | | | | | -+-------+------+ +----+ +----+ +----+ - | +-------+ +-------+ +-----------+ . . . - +~ |Gateway| === |Network| == |Application|..... Internet .... - +-------+ |server | |server | - +-------+ | F/R - C/D | - +-----------+ -|<- - - - - LoRaWAN - - - ->| -~~~~ -{: #Fig-archi-lorawan title='SCHC Architecture mapped to LoRaWAN'} - - -#LoRaWAN Architecture - -An overview of LoRaWAN {{lora-alliance-spec}} protocol and architecture is -described in {{RFC8376}}. The mapping between the LPWAN -architecture entities as described in [RFC8724] -and the ones in {{lora-alliance-spec}} is as follows: - - o Devices are LoRaWAN End Devices (e.g. sensors, - actuators, etc.). There can be a very high density of devices per - radio gateway (LoRaWAN gateway). This entity maps to the LoRaWAN end-device. - - o The Radio Gateway (RGW), which is the endpoint of the constrained - link. This entity maps to the LoRaWAN Gateway. - - o The Network Gateway (NGW) is the interconnection node between the - Radio Gateway and the SCHC gateway (LoRaWAN Application server). This - entity maps to the LoRaWAN Network Server. - - o SCHC C/D and F/R are handled by LoRaWAN Application Server; ie the LoRaWAN - application server will do the SCHC C/D and F/R. - - o The LPWAN-AAA Server is the LoRaWAN Join Server. Its role is to manage and - deliver security keys in a secure way, so that the devices root key is never exposed. - -~~~~ - (LPWAN-AAA Server) - () () () | +------+ - () () () () / \ +---------+ | Join | - () () () () () / \======| ^ |===|Server| +-----------+ - () () () | | <--|--> | +------+ |Application| - () () () () / \==========| v |=============| Server | - () () () / \ +---------+ +-----------+ - End-devices Gateways Network Server (SCHC C/D and F/R) - (devices) (RGW) (NGW) -~~~~ -{: #Fig-LPWANarchi title='LPWAN Architecture'} - -*Note*: {{Fig-LPWANarchi}} terms are from LoRaWAN, with {{RFC8376}} terminology in brackets. - -SCHC Compressor/Decompressor (SCHC C/D) and SCHC Fragmentation/Reassembly (SCHC F/R) -are performed on the LoRaWAN end-device and the Application Server (called -SCHC gateway). While the point-to-point link between the device and the -Application Server constitutes a single IP hop, the ultimate end-point of the -IP communication may be an Internet node beyond the Application Server. -In other words, the LoRaWAN Application Server (SCHC gateway) acts as the -first hop IP router for the device. The Application Server and Network -Server may be co-located, which effectively turns the Network/Application -Server into the first hop IP router. - - -## Device classes (A, B, C) and interactions - -The LoRaWAN MAC layer supports 3 classes of devices named A, B and C. All -devices implement the Class A, some devices may implement Class B or -Class C. Class B and Class C are mutually exclusive. - -* Class A: The Class A is the simplest class of devices. The device is - allowed to transmit at any time, randomly selecting a communication channel. - The Network Gateway may reply with a downlink in one of the 2 receive windows - immediately following the uplinks. Therefore, the Network Gateway cannot initiate a - downlink, it has to wait for the next uplink from the device to get a - downlink opportunity. The Class A is the lowest power consumption class. -* Class B: Class B devices implement all the functionalities of Class A - devices, but also schedule periodic listen windows. Therefore, opposed to the - Class A devices, Class B devices can receive downlinks that are initiated by the - Network Gateway and not following an uplink. There is a trade-off between the - periodicity of those scheduled Class B listen windows and the power - consumption of the device: if the periodicity is high downlinks from the NGW - will be sent faster, but the device wakes up more often: it will have higher - power consumption. -* Class C: Class C devices implement all the functionalities of Class A - devices, but keep their receiver open whenever they are not transmitting. - Class C devices can receive downlinks at any time at the expense of a higher - power consumption. Battery-powered devices can only operate in Class C for a - limited amount of time (for example for a firmware upgrade over-the-air). - Most of the Class C devices are grid powered (for example Smart Plugs). - -## Device addressing - -LoRaWAN end-devices use a 32-bit network address (devAddr) to communicate with -the Network Gateway over-the-air, this address might not be unique in a LoRaWAN -network. Devices using the same devAddr are distinguished by the Network -Gateway based on the cryptographic signature appended to every LoRaWAN frame. - -To communicate with the SCHC gateway, the Network Gateway MUST identify the -devices by a unique 64-bit device identifier called the DevEUI. - -The DevEUI is assigned to the device during the manufacturing process by the -device's manufacturer. It is built like an Ethernet MAC address by -concatenating the manufacturer's IEEE OUI field with a vendor unique number. -e.g.: 24-bit OUI is concatenated with a 40-bit serial number. -The Network Gateway translates the devAddr into a DevEUI in the uplink -direction and reciprocally on the downlink direction. - -~~~~ - -+--------+ +---------+ +---------+ +----------+ -| Device | <=====> | Network | <====> | SCHC | <======> | Internet | -| | devAddr | Gateway | DevEUI | Gateway | IPv6/UDP | | -+--------+ +---------+ +---------+ +----------+ - -~~~~ -{: #Fig-LoRaWANaddresses title='LoRaWAN addresses'} - -## General Frame Types - -LoRaWAN implements the possibility to send confirmed or unconfirmed frames: - -* Confirmed frame: - The sender asks the receiver to acknowledge the frame. -* Unconfirmed frame: - The sender does not ask the receiver to acknowledge the frame. - -As SCHC defines its own acknowledgment mechanisms, SCHC does not require -the use of LoRaWAN Confirmed frames (MType=0b100 as per -{{lora-alliance-spec}}) - -## LoRaWAN MAC Frames - -In addition to regular data frames, LoRaWAN implements JoinRequest and JoinAccept -frame types, which are used by a device to join a network: - -* JoinRequest: - This frame is used by a device to join a network. It contains the device's - unique identifier DevEUI and a random nonce that will be used for session key - derivation. -* JoinAccept: - To on-board a device, the Network Gateway responds to the JoinRequest - issued by a device with a JoinAccept frame. That frame is - encrypted with the device's AppKey and contains (amongst other fields) - the network's major settings and a random nonce used to derive the session - keys. -* Data: - MAC and application data. Application data are protected with AES-128 - encryption. MAC related data are AES-128 encrypted with another key. - -## LoRaWAN FPort - -The LoRaWAN MAC layer features a frame port field in all frames. This field -(FPort) is 8 bits long and the values from 1 to 223 can be used. It allows -LoRaWAN networks and applications to identify data. - -## LoRaWAN empty frame {#lorawan-empty-frame} - -A LoRaWAN empty frame is a LoRaWAN frame without FPort (cf {{lorawan-schc-payload}}) -and FRMPayload. - -## Unicast and multicast technology - -LoRaWAN technology supports unicast downlinks, but also multicast: a packet -sent over LoRaWAN radio link can be received by several devices. It is -useful to address many devices with same content, either a large binary -file (firmware upgrade), or same command (e.g: lighting control). -As IPv6 is also a multicast technology this feature can be used to address a -group of devices. - -_Note 1_: IPv6 multicast addresses must be defined as per [RFC4291]. LoRaWAN -multicast group definition in a Network Gateway and the relation between those -groups and IPv6 groupID are out of scope of this document. - -_Note 2_: LoRa Alliance defined {{lora-alliance-remote-multicast-set}} as -the RECOMMENDED way to setup multicast groups on devices and create a synchronized -reception window. - -# SCHC-over-LoRaWAN - -## LoRaWAN FPort and RuleID {#lorawan-schc-payload} - -The FPort field is part of the SCHC Message, as shown in -{{Fig-lorawan-schc-payload}}. The SCHC C/D and the SCHC F/R SHALL concatenate -the FPort field with the LoRaWAN payload to recompose the SCHC Message. - -~~~~ - -| FPort | LoRaWAN payload | -+ ------------------------ + -| SCHC Message | - -~~~~ -{: #Fig-lorawan-schc-payload title='SCHC Message in LoRaWAN'} - -Note: SCHC Message is any datagram sent by SCHC C/D or F/R layers. - -A fragmented datagram with application payload transferred from device to -Network Gateway, is called an uplink fragmented datagram. It uses an FPort for data uplink -and its associated SCHC control downlinks, named FPortUp in this document. The -other way, a fragmented datagram with application payload transferred from -Network Gateway to device, is called downlink fragmented datagram. It uses another -FPort for data downlink and its associated SCHC control uplinks, named FPortDown -in this document. - -All RuleID can use arbitrary values inside the FPort range allowed by LoRaWAN -specification and MUST be shared by the device and SCHC gateway prior to -the communication with the selected rule. -The uplink and downlink fragmentation FPorts MUST be different. - -## Rule ID management {#rule-id-management} - -RuleID MUST be 8 bits, encoded in the LoRaWAN FPort as described in -{{lorawan-schc-payload}}. LoRaWAN supports up to 223 application FPorts in -the range \[1;223\] as defined in section 4.3.2 of {{lora-alliance-spec}}, it implies -that RuleID MSB SHOULD be inside this range. An application can send non SCHC -traffic by using FPort values different from the ones used for SCHC. - -In order to improve interoperability, RECOMMENDED fragmentation RuleID values are: - -* RuleID = 20 (8-bit) for uplink fragmentation, named FPortUp. -* RuleID = 21 (8-bit) for downlink fragmentation, named FPortDown. -* RuleID = 22 (8-bit) for which SCHC compression was not possible (i.e., no matching -compression Rule was found), as described in {{RFC8724}} section 6. - -FPortUp value MUST be different from FPortDown. -The remaining RuleIDs are available for compression. RuleIDs are shared between -uplink and downlink sessions. A RuleID not in the set(s) of FPortUp or FPortDown -means that the fragmentation is not used, thus, on reception, the SCHC Message -MUST be sent to the SCHC C/D layer. - -The only uplink frames using the FPortDown port are the fragmentation SCHC -control messages of a downlink fragmented datagram (for example, SCHC ACKs). -Similarly, the only downlink frames using the FPortUp port are the -fragmentation SCHC control messages of an uplink fragmented datagram. - -An application can have multiple fragmented datagrams between a device and one -or several SCHC gateways. A set of FPort values is REQUIRED for each SCHC gateway -instance the device is required to communicate with. The application can use -additional uplinks or downlink fragmented parameters but SHALL implement at -least the parameters defined in this document. - -The mechanism for context distribution across devices and gateways is -outside the scope of this document. - -## Interface IDentifier (IID) computation {#IID} - -In order to mitigate the risks described in [rfc8064] and [rfc8065], -implementation MUST implement the following algorithm and SHOULD use it. - -1. key = LoRaWAN AppSKey -2. cmac = aes128_cmac(key, DevEUI) -3. IID = cmac[0..7] - -aes128_cmac algorithm is described in [rfc4493]. It has been chosen as it is -already used by devices for LoRaWAN protocol. - -As AppSKey is renewed each time a device joins or rejoins a LoRaWAN network, -the IID will change over time; this mitigates privacy, location tracking and -correlation over time risks. Join periodicity is defined at the application -level. - -Address scan risk is mitigated thanks to AES-128, which provides enough entropy -bits of the IID. - -Using this algorithm will also ensure that there is no correlation between the -hardware identifier (IEEE-64 DevEUI) and the IID, so an attacker cannot use -manufacturer OUI to target devices. - -Example with: - -* DevEUI: 0x1122334455667788 -* appSKey: 0x00AABBCCDDEEFF00AABBCCDDEEFFAABB - -~~~~ -1. key: 0x00AABBCCDDEEFF00AABBCCDDEEFFAABB -2. cmac: 0xBA59F4B196C6C3432D9383C145AD412A -3. IID: 0xBA59F4B196C6C343 -~~~~ -{: #Fig-iid-computation-example title='Example of IID computation.'} - -There is a small probability of IID collision in a LoRaWAN network. If this occurs, -the IID can be changed by rekeying the device at L2 level (ie: trigger a LoRaWAN -join). -The way the device is rekeyed is out of scope of this document and left to the -implementation. - -Note: Implementation also using another IID source MUST ensure that the -same IID is shared between the device and the SCHC gateway in the -compression and decompression of the IPv6 address of the device. - -## Padding - -All padding bits MUST be 0. - -## Decompression {#Decomp} - -SCHC C/D MUST concatenate FPort and LoRaWAN payload to retrieve the SCHC Packet -as per {{lorawan-schc-payload}}. - -RuleIDs matching FPortUp and FPortDown are reserved for SCHC Fragmentation. - -## Fragmentation {#Frag} - -The L2 Word Size used by LoRaWAN is 1 byte (8 bits). -The SCHC fragmentation over LoRaWAN uses the ACK-on-Error mode for uplink -fragmentation and Ack-Always mode for downlink fragmentation. A LoRaWAN -device cannot support simultaneous interleaved fragmented datagrams in -the same direction (uplink or downlink). - -The fragmentation parameters are different for uplink and downlink -fragmented datagrams and are successively described in the next sections. - -### DTag {#DTag} - -[RFC8724] section 8.2.4 describes the possibility to interleave several -fragmented SCHC datagrams for the same RuleID. This is not used in SCHC over -LoRaWAN profile. A device cannot interleave several fragmented SCHC datagrams -on the same FPort. This field is not used and its size is 0. - -Note: The device can still have several parallel fragmented datagrams with -more than one SCHC gateway thanks to distinct sets of FPorts, cf {{rule-id-management}}. - -### Uplink fragmentation: From device to SCHC gateway - -In this case, the device is the fragment transmitter, and the SCHC gateway -the fragment receiver. A single fragmentation rule is defined. -SCHC F/R MUST concatenate FPort and LoRaWAN payload to retrieve the SCHC -Packet, as per {{lorawan-schc-payload}}. - -* SCHC fragmentation reliability mode: `ACK-on-Error`. -* SCHC header size is two bytes (the FPort byte + 1 additional byte). -* RuleID: 8 bits stored in LoRaWAN FPort. cf {{rule-id-management}} -* DTag: Size T=0 bit, not used. cf {{DTag}} -* Window index: 4 windows are used, encoded on M = 2 bits -* FCN: The FCN field is encoded on N = 6 bits, so WINDOW_SIZE = 63 tiles - are allowed in a window. -* Last tile: it can be carried in a Regular SCHC Fragment, alone in an All-1 SCHC - Fragment or with any of these two methods. Implementation must ensure that: - * The sender MUST ascertain that the receiver will not receive - the last tile through both a Regular SCHC Fragment and an All-1 SCHC - Fragment during the same session. - * If the last tile is in All-1 SCHC message: current L2 MTU MUST be big enough to fit - the All-1 header and the last tile. -* Penultimate tile MUST be equal to the regular size. -* RCS: Use recommended calculation algorithm in [RFC8724] (§8.2.3. Integrity Checking). -* Tile: size is 10 bytes. -* Retransmission timer: Set by the implementation depending on the application - requirements. The default RECOMMENDED duration of this timer is 12 hours; - this value is mainly driven by application requirements and MAY be - changed by the application. -* Inactivity timer: The SCHC gateway implements an "inactivity timer". The - default RECOMMENDED duration of this timer is 12 hours; this value is mainly - driven by application requirements and MAY be changed by the application. -* MAX_ACK_REQUESTS: 8. -With this set of parameters, the SCHC fragment header is 16 bits, -including FPort; payload overhead will be 8 bits as FPort is already a part of -LoRaWAN payload. MTU is: _4 windows * 63 tiles * 10 bytes per tile = 2520 bytes_ - -In addition to the per-rule context parameters specified in [RFC8724], -for uplink rules, an additional context parameter is added: whether or -not to ack after each window. -For battery powered devices, it is RECOMMENDED to use the ACK mechanism at the -end of each window instead of waiting until the end of all windows: - -* The SCHC receiver SHOULD send a SCHC ACK after every window even if there is no - missing tile. -* The SCHC sender SHOULD wait for the SCHC ACK from the SCHC receiver before sending -tiles from the next window. If the SCHC ACK is not received, it SHOULD send a SCHC -ACK REQ up to MAX_ACK_REQUESTS times, as described previously. - -This will avoid useless uplinks if the device has lost network coverage. - -For non-battery powered devices, the SCHC receiver MAY also choose to send a SCHC -ACK only at the end of all windows. This will reduce downlink load on the LoRaWAN -network, by reducing the number of downlinks. - -SCHC implementations MUST be compatible with both behaviors, and this selection is -part of the rule context. - -#### Regular fragments - -~~~~ - -| FPort | LoRaWAN payload | -+ ------ + ------------------------- + -| RuleID | W | FCN | Payload | -+ ------ + ------ + ------ + ------- + -| 8 bits | 2 bits | 6 bits | | - -~~~~ -{: #Fig-fragmentation-header-long-all0 title='All fragments except the last one. SCHC header size is 16 bits, including LoRaWAN FPort.'} - - -#### Last fragment (All-1) - -~~~~ - -| FPort | LoRaWAN payload | -+ ------ + ---------------------------- + -| RuleID | W | FCN=All-1 | RCS | -+ ------ + ------ + --------- + ------- + -| 8 bits | 2 bits | 6 bits | 32 bits | - -~~~~ -{: #Fig-fragmentation-header-all1-no-tile title='All-1 SCHC Message: the last fragment without last tile.'} - -~~~~ - -| FPort | LoRaWAN payload | -+ ------ + ---------------------------------------------------------- + -| RuleID | W | FCN=All-1 | RCS | Last tile | Opt. padding | -+ ------ + ------ + --------- + ------- + ------------ + ------------ + -| 8 bits | 2 bits | 6 bits | 32 bits | 1 to 80 bits | 0 to 7 bits | - -~~~~ -{: #Fig-fragmentation-header-all1-last-tile title='All-1 SCHC Message: the last fragment with last tile.'} - -#### SCHC ACK - -~~~~ - -| FPort | LoRaWAN payload | -+ ------ + --------------------------+ -| RuleID | W | C = 1 | padding | -| | | | (b'00000) | -+ ------ + ----- + ----- + --------- + -| 8 bits | 2 bit | 1 bit | 5 bits | - -~~~~ -{: #Fig-frag-header-long-schc-ack-rcs-ok title='SCHC ACK format, correct RCS check.'} - -~~~~ -| FPort | LoRaWAN payload | -+ ------ + --------------------------------- + ---------------- + -| RuleID | W | C = 0 | Compressed bitmap | Optional padding | -| | | | (C = 0) | (b'0...0) | -+ ------ + ----- + ----- + ----------------- + ---------------- + -| 8 bits | 2 bit | 1 bit | 5 to 63 bits | 0, 6 or 7 bits | - -~~~~ -{: #Fig-frag-header-long-schc-ack-rcs-fail title='SCHC ACK format, failed RCS check.'} - - -Note: Because of the bitmap compression mechanism and L2 byte alignment, only -the following discrete values are possible for the compressed bitmap size: 5, 13, 21, 29, 37, 45, 53, 61, 62 and 63. -Bitmaps of 63 bits will require 6 bits of padding. - -#### Receiver-Abort - -~~~~ - -| FPort | LoRaWAN payload | -+ ------ + -------------------------------------------- + -| RuleID | W = b'11 | C = 1 | b'11111 | 0xFF (all 1's) | -+ ------ + -------- + ------+-------- + ----------------+ -| 8 bits | 2 bits | 1 bit | 5 bits | 8 bits | - next L2 Word boundary ->| <-- L2 Word --> | - -~~~~ -{: #Fig-fragmentation-receiver-abort title='Receiver-Abort format.'} - - -#### SCHC acknowledge request - -~~~~ - -| FPort | LoRaWAN payload | -+------- +------------------------- + -| RuleID | W | FCN = b'000000 | -+ ------ + ------ + --------------- + -| 8 bits | 2 bits | 6 bits | - - -~~~~ -{: #Fig-fragmentation-schc-ack-req title='SCHC ACK REQ format.'} - - - -### Downlink fragmentation: From SCHC gateway to device - -In this case, the device is the fragmentation receiver, and the SCHC gateway the -fragmentation transmitter. The following fields are common to all devices. -SCHC F/R MUST concatenate FPort and LoRaWAN payload to retrieve the SCHC -Packet as described in {{lorawan-schc-payload}}. - -* SCHC fragmentation reliability mode: - * Unicast downlinks: ACK-Always. - * Multicast downlinks: No-ACK, reliability has to be ensured by the upper - layer. This feature is OPTIONAL and may not be implemented by SCHC gateway. -* RuleID: 8 bits stored in LoRaWAN FPort. cf {{rule-id-management}} -* DTag: Size T=0 bit, not used. cf {{DTag}} -* FCN: The FCN field is encoded on N=1 bit, so WINDOW_SIZE = 1 tile. -* RCS: Use recommended calculation algorithm in [RFC8724] (§8.2.3. Integrity Checking). -* Inactivity timer: The default RECOMMENDED duration of this timer is 12 hours; - this value is mainly driven by application requirements and MAY be changed by - the application. - -The following parameters apply to ACK-Always (Unicast) only: - -* Retransmission timer: See {{downlink-retransmission-timer}}. -* MAX_ACK_REQUESTS: 8. -* Window index (unicast only): encoded on M=1 bit, as per [RFC8724]. - -As only 1 tile is used, its size can change for each downlink, and will be -the currently available MTU. - -Class A devices can only receive during an RX slot, following the transmission of an -uplink. Therefore the SCHC gateway cannot initiate communication (e.g., start a new SCHC -session). In order to create a downlink opportunity it is RECOMMENDED for -Class A devices to send an uplink every 24 hours when no SCHC session is -started, this is application specific and can be disabled. The RECOMMENDED uplink -is a LoRaWAN empty frame as defined {{lorawan-empty-frame}}. -As this uplink is to open an RX window, any LoRaWAN uplink frame from the device -MAY reset this counter. - -_Note_: The Fpending bit included in LoRaWAN protocol SHOULD NOT be used for -SCHC-over-LoRaWAN protocol. It might be set by the Network Gateway for other -purposes but not SCHC needs. - -#### Regular fragments - -~~~~ - -| FPort | LoRaWAN payload | -+ ------ + ------------------------------------ + -| RuleID | W | FCN = b'0 | Payload | -+ ------ + ----- + --------- + ---------------- + -| 8 bits | 1 bit | 1 bit | X bytes + 6 bits | - -~~~~ -{: #Fig-fragmentation-downlink-header-all0 title='All fragments but the last one. Header size 10 bits, including LoRaWAN FPort.'} - - -#### Last fragment (All-1) - -~~~~ - -| FPort | LoRaWAN payload | -+ ------ + --------------------------- + ------------------------- + -| RuleID | W | FCN = b'1 | RCS | Payload | Opt padding | -+ ------ + ----- + --------- + ------- + ----------- + ----------- + -| 8 bits | 1 bit | 1 bit | 32 bits | 6 to X bits | 0 to 7 bits | - -~~~~ -{: #Fig-fragmentation-downlink-header-all1 title='All-1 SCHC Message: the last fragment.'} - -#### SCHC ACK - -~~~~ - -| FPort | LoRaWAN payload | -+ ------ + ---------------------------------- + -| RuleID | W | C = b'1 | Padding b'000000 | -+ ------ + ----- + ------- + ---------------- + -| 8 bits | 1 bit | 1 bit | 6 bits | - -~~~~ -{: #Fig-frag-downlink-header-schc-ack-rcs-ok title='SCHC ACK format, RCS is correct.'} - - -~~~~ - -| FPort | LoRaWAN payload | -+ ------ + ------------------------------------------------- + -| RuleID | W | C = b'0 | Bitmap = b'1 | Padding b'000000 | -+ ------ + ----- + ------- + ------------ + ---------------- + -| 8 bits | 1 bit | 1 bit | 1 bit | 5 bits | - -~~~~ -{: #Fig-frag-downlink-header-schc-ack-rcs-fail title='SCHC ACK format, RCS is incorrect.'} - -#### Receiver-Abort - -~~~~ - -| FPort | LoRaWAN payload | -+ ------ + ---------------------------------------------- + -| RuleID | W = b'1 | C = b'1 | b'111111 | 0xFF (all 1's) | -+ ------ + ------- + ------- + -------- + --------------- + -| 8 bits | 1 bit | 1 bits | 6 bits | 8 bits | - next L2 Word boundary ->| <-- L2 Word --> | - - -~~~~ -{: #Fig-fragmentation-downlink-header-abort title='Receiver-Abort packet (following an All-1 SCHC Fragment with incorrect RCS).'} - -#### Downlink retransmission timer {#downlink-retransmission-timer} - -Class A and Class B or Class C devices do not manage retransmissions and timers -the same way. - -##### Class A devices - -Class A devices can only receive in an RX slot following the transmission of an -uplink. - -The SCHC gateway implements an inactivity timer with a RECOMMENDED duration -of 36 hours. For devices with very low transmission rates (example 1 packet a -day in normal operation), that duration may be extended: it is application -specific. - -RETRANSMISSION_TIMER is application specific and its RECOMMENDED value is -INACTIVITY_TIMER/(MAX_ACK_REQUESTS + 1). - -**SCHC All-0 (FCN=0)** - -All fragments but the last have an FCN=0 (because window size is 1). Following -an All-0 SCHC Fragment, the device MUST transmit the SCHC ACK message. It MUST transmit up to -MAX_ACK_REQUESTS SCHC ACK messages before aborting. In order to progress the -fragmented datagram, the SCHC layer should immediately queue for transmission -those SCHC ACK if no SCHC downlink have been received during RX1 and RX2 window. -LoRaWAN layer will respect the applicable local spectrum regulation. - -_Note_: The ACK bitmap is 1 bit long and is always 1. - -**SCHC All-1 (FCN=1)** - -SCHC All-1 is the last fragment of a datagram, the corresponding SCHC ACK -message might be lost; therefore the SCHC gateway MUST request a retransmission -of this ACK when the retransmission timer expires. To open a downlink -opportunity the device MUST transmit an uplink every -RETRANSMISSION_TIMER/(MAX_ACK_REQUESTS * SCHC_ACK_REQ_DN_OPPORTUNITY). -The format of this uplink is application specific. It is RECOMMENDED for a -device to send an empty frame (see {{lorawan-empty-frame}}) but it is application -specific and will be used by the NGW to transmit a potential SCHC ACK REQ. -SCHC_ACK_REQ_DN_OPPORTUNITY is application specific and its recommended value -is 2. It MUST be greater than 1. This allows to open a downlink opportunity to -any downlink with higher priority than the SCHC ACK REQ message. - -_Note_: The device MUST keep this SCHC ACK message in memory until it receives -a downlink SCHC Fragmentation Message (with FPort == FPortDown) that is not a SCHC ACK REQ: it indicates that -the SCHC gateway has received the SCHC ACK message. - -#### Class B or Class C devices - -Class B devices can receive in scheduled RX slots or in RX slots following the -transmission of an uplink. Class C devices are almost in constant reception. - -RECOMMENDED retransmission timer value: - -* Class B: 3 times the ping slot periodicity. -* Class C: 30 seconds. - -The RECOMMENDED inactivity timer value is 12 hours for both Class B and Class -C devices. - -## SCHC Fragment Format - -### All-0 SCHC fragment - -**Uplink fragmentation (Ack-On-Error)**: - -All-0 is distinguishable from a SCHC ACK REQ as [RFC8724] states *This condition -is also met if the SCHC Fragment Header is a multiple of L2 Words*; this -condition met: SCHC header is 2 bytes. - -**Downlink fragmentation (Ack-always)**: - -As per [RFC8724] the SCHC All-1 MUST contain the last tile, implementation must -ensure that SCHC All-0 message Payload will be at least the size of an L2 Word. - -### All-1 SCHC fragment - -All-1 is distinguishable from a SCHC Sender-Abort as [RFC8724] states *This -condition is met if the RCS is present and is at least the size of an L2 Word*; -this condition met: RCS is 4 bytes. - -### Delay after each LoRaWAN frame to respect local regulation - -This profile does not define a delay to be added after each LoRaWAN frame, local -regulation compliance is expected to be enforced by LoRaWAN stack. - -# Security Considerations - -This document is only providing parameters that are expected to be best -suited for LoRaWAN networks for [RFC8724]. IID -security is discussed in {{IID}}. As such, this document does not contribute to -any new security issues beyond those already identified in -[RFC8724]. -Moreover, SCHC data (LoRaWAN payload) are protected at the LoRaWAN level by an AES-128 -encryption with a session key shared by the device and the SCHC gateway. These session keys are renewed at each -LoRaWAN session (ie: each join or rejoin to the LoRaWAN network) - -# IANA Considerations - -This document has no IANA actions. - -# Acknowledgements -{:numbered="false"} - -Thanks to all those listed in the Contributors section for the excellent text, -insightful discussions, reviews and suggestions, and also to (in -alphabetical order) Dominique Barthel, Arunprabhu Kandasamy, Rodrigo Muñoz, -Alexander Pelov, Pascal Thubert, Laurent Toutain for useful design -considerations, reviews and comments. - -# Contributors -{:numbered="false"} - -Contributors ordered by family name. - -Vincent Audebert -EDF R&D -Email: vincent.audebert@edf.fr - -Julien Catalano -Kerlink -Email: j.catalano@kerlink.fr - -Michael Coracin -Semtech -Email: mcoracin@semtech.com - -Marc Le Gourrierec -Sagemcom -Email: marc.legourrierec@sagemcom.com - -Nicolas Sornin -Semtech -Email: nsornin@semtech.com - -Alper Yegin -Actility -Email: alper.yegin@actility.com - ---- back - -# Examples - -In following examples "applicative data" refers to the IPv6 payload sent by the -application to the SCHC layer. - -## Uplink - Compression example - No fragmentation - -This example represents an applicative data going through SCHC over LoRaWAN, -no fragmentation required - -An applicative data of 78 bytes is passed to SCHC compression layer. Rule 1 -is used by SCHC C/D layer, allowing to compress it to 40 bytes and 5 bits: 1 byte -RuleID, 21 bits residue + 37 bytes payload. - -~~~~ -| RuleID | Compression residue | Payload | Padding=b'000 | -+ ------ + ------------------- + --------- + ------------- + -| 1 | 21 bits | 37 bytes | 3 bits | -~~~~ -{: #Fig-example-uplink-no-fragmentation-payload-schc-message title='Uplink example: SCHC Message'} - -The current LoRaWAN MTU is 51 bytes, although 2 bytes FOpts are used by -LoRaWAN protocol: 49 bytes are available for SCHC payload; no need for -fragmentation. The payload will be transmitted through FPort = 1. - -~~~~ -| LoRaWAN Header | LoRaWAN payload (40 bytes) | -+ ------------------------- + --------------------------------------- + -| | FOpts | RuleID=1 | Compression | Payload | Padding=b'000 | -| | | | residue | | | -+ ---- + ------- + -------- + ----------- + --------- + ------------- + -| XXXX | 2 bytes | 1 byte | 21 bits | 37 bytes | 3 bits | -~~~~ -{: #Fig-example-uplink-no-fragmentation-compression title='Uplink example: LoRaWAN packet'} - -## Uplink - Compression and fragmentation example - -This example represents an applicative data going through SCHC, with -fragmentation. - -An applicative data of 300 bytes is passed to SCHC compression layer. Rule 1 -is used by SCHC C/D layer, allowing to compress it to 282 bytes and 5 bits: 1 byte -RuleID, 21 bits residue + 279 bytes payload. - -~~~~ -| RuleID | Compression residue | Payload | -+ ------ + ------------------- + --------- + -| 1 | 21 bits | 279 bytes | -~~~~ -{: #Fig-example-uplink-fragmentation-schc-message title='Uplink example: SCHC Message'} - -The current LoRaWAN MTU is 11 bytes, 0 bytes FOpts are used by LoRaWAN -protocol: 11 bytes are available for SCHC payload + 1 byte FPort field. -SCHC header is 2 bytes (including FPort) so 1 tile is sent in first -fragment. - -~~~~ -| LoRaWAN Header | LoRaWAN payload (11 bytes) | -+ -------------------------- + -------------------------- + -| | RuleID=20 | W | FCN | 1 tile | -+ -------------- + --------- + ----- + ------ + --------- + -| XXXX | 1 byte | 0 0 | 62 | 10 bytes | -~~~~ -{: #Fig-example-uplink-fragmentation-lorawan-packet-1 title='Uplink example: LoRaWAN packet 1'} - -~~~~ -Content of the tile is: -| RuleID | Compression residue | Payload | -+ ------ + ------------------- + ----------------- + -| 1 | 21 bits | 6 bytes + 3 bits | -~~~~ -{: #Fig-example-uplink-fragmentation-lorawan-packet-1-tile-content title='Uplink example: LoRaWAN packet 1 - Tile content'} - -Next transmission MTU is 11 bytes, although 2 bytes FOpts are used by -LoRaWAN protocol: 9 bytes are available for SCHC payload + 1 byte FPort -field, a tile does not fit inside so LoRaWAN stack will send only FOpts. - -Next transmission MTU is 242 bytes, 4 bytes FOpts. 23 tiles are transmitted: - -~~~~ -| LoRaWAN Header | LoRaWAN payload (231 bytes) | -+ --------------------------------------+ --------------------------- + -| | FOpts | RuleID=20 | W | FCN | 23 tiles | -+ -------------- + ------- + ---------- + ----- + ----- + ----------- + -| XXXX | 4 bytes | 1 byte | 0 0 | 61 | 230 bytes | -~~~~ -{: #Fig-example-uplink-fragmentation-lorawan-packet-2 title='Uplink example: LoRaWAN packet 2'} - -Next transmission MTU is 242 bytes, no FOpts. All 5 remaining tiles are -transmitted, the last tile is only 2 bytes + 5 bits. Padding is added for -the remaining 3 bits. - -~~~~ -| LoRaWAN Header | LoRaWAN payload (44 bytes) | -+ ---- + ---------- + ----------------------------------------------- + -| | RuleID=20 | W | FCN | 5 tiles | Padding=b'000 | -+ ---- + ---------- + ----- + ----- + --------------- + ------------- + -| XXXX | 1 byte | 0 0 | 38 | 42 bytes+5 bits | 3 bits | -~~~~ -{: #Fig-example-uplink-fragmentation-lorawan-packet-3 title='Uplink example: LoRaWAN packet 3'} - -Then All-1 message can be transmitted: - -~~~~ -| LoRaWAN Header | LoRaWAN payload (44 bytes) | -+ ---- + -----------+ -------------------------- + -| | RuleID=20 | W | FCN | RCS | -+ ---- + ---------- + ----- + ----- + ---------- + -| XXXX | 1 byte | 0 0 | 63 | 4 bytes | -~~~~ -{: #Fig-example-uplink-fragmentation-lorawan-packet-4 title='Uplink example: LoRaWAN packet 4 - All-1 SCHC message'} - -All packets have been received by the SCHC gateway, computed RCS is -correct so the following ACK is sent to the device by the SCHC receiver: - -~~~~ -| LoRaWAN Header | LoRaWAN payload | -+ -------------- + --------- + ------------------- + -| | RuleID=20 | W | C | Padding | -+ -------------- + --------- + ----- + - + ------- + -| XXXX | 1 byte | 0 0 | 1 | 5 bits | -~~~~ -{: #Fig-example-uplink-fragmentation-lorawan-packet-5 title='Uplink example: LoRaWAN packet 5 - SCHC ACK'} - -## Downlink - -An applicative data of 155 bytes is passed to SCHC compression layer. Rule 1 -is used by SCHC C/D layer, allowing to compress it to 130 bytes and 5 bits: 1 byte -RuleID, 21 bits residue + 127 bytes payload. - -~~~~ -| RuleID | Compression residue | Payload | -+ ------ + ------------------- + --------- + -| 1 | 21 bits | 127 bytes | -~~~~ -{: #Fig-example-downlink-fragmentation-schc-message title='Downlink example: SCHC Message'} - -The current LoRaWAN MTU is 51 bytes, no FOpts are used by LoRaWAN -protocol: 51 bytes are available for SCHC payload + FPort field => it -has to be fragmented. - -~~~~ -| LoRaWAN Header | LoRaWAN payload (51 bytes) | -+ ---- + ---------- + -------------------------------------- + -| | RuleID=21 | W = 0 | FCN = 0 | 1 tile | -+ ---- + ---------- + ------ + ------- + ------------------- + -| XXXX | 1 byte | 1 bit | 1 bit | 50 bytes and 6 bits | -~~~~ -{: #Fig-example-downlink-fragmentation-lorawan-packet-1 title='Downlink example: LoRaWAN packet 1 - SCHC Fragment 1'} - -Content of the tile is: - -~~~~ -| RuleID | Compression residue | Payload | -+ ------ + ------------------- + ------------------ + -| 1 | 21 bits | 48 bytes and 1 bit | -~~~~ -{: #Fig-example-downlink-fragmentation-lorawan-packet-1-tile-content title='Downlink example: LoRaWAN packet 1: Tile content'} - -The receiver answers with a SCHC ACK: - -~~~~ -| LoRaWAN Header | LoRaWAN payload | -+ ---- + --------- + -------------------------------- + -| | RuleID=21 | W = 0 | C = 1 | Padding=b'000000 | -+ ---- + --------- + ----- + ----- + ---------------- + -| XXXX | 1 byte | 1 bit | 1 bit | 6 bits | -~~~~ -{: #Fig-example-downlink-fragmentation-lorawan-packet-2 title='Downlink example: LoRaWAN packet 2 - SCHC ACK'} - -The second downlink is sent, two FOpts: - -~~~~ -| LoRaWAN Header | LoRaWAN payload (49 bytes) | -+ --------------------------- + ------------------------------------- + -| | FOpts | RuleID=21 | W = 1 | FCN = 0 | 1 tile | -+ ---- + ------- + ---------- + ----- + ------- + ------------------- + -| XXXX | 2 bytes | 1 byte | 1 bit | 1 bit | 48 bytes and 6 bits | -~~~~ -{: #Fig-example-downlink-fragmentation-lorawan-packet-3 title='Downlink example: LoRaWAN packet 3 - SCHC Fragment 2'} - -The receiver answers with an SCHC ACK: - -~~~~ -| LoRaWAN Header | LoRaWAN payload | -+ ---- + --------- + -------------------------------- + -| | RuleID=21 | W = 1 | C = 1 | Padding=b'000000 | -+ ---- + --------- + ----- + ----- + ---------------- + -| XXXX | 1 byte | 1 bit | 1 bit | 6 bits | -~~~~ -{: #Fig-example-downlink-fragmentation-lorawan-packet-4 title='Downlink example: LoRaWAN packet 4 - SCHC ACK'} - -The last downlink is sent, no FOpts: - -~~~~ -| LoRaWAN Header | LoRaWAN payload (37 bytes) | -+ ---- + ------- + --------------------------------------------------- + -| | RuleID | W | FCN | RCS | 1 tile | Padding | -| | 21 | 0 | 1 | | | b'00000 | -+ ---- + ------- + ----- + ----- + ------- + --------------- + ------- + -| XXXX | 1 byte | 1 bit | 1 bit | 4 bytes | 31 bytes+1 bits | 5 bits | -~~~~ -{: #Fig-example-downlink-fragmentation-lorawan-packet-5 title='Downlink example: LoRaWAN packet 5 - All-1 SCHC message'} - -The receiver answers to the sender with an SCHC ACK: - -~~~~ -| LoRaWAN Header | LoRaWAN payload | -+ ---- + --------- + -------------------------------- + -| | RuleID=21 | W = 0 | C = 1 | Padding=b'000000 | -+ ---- + --------- + ----- + ----- + ---------------- + -| XXXX | 1 byte | 1 bit | 1 bit | 6 bits | -~~~~ -{: #Fig-example-downlink-fragmentation-lorawan-packet-6 title='Downlink example: LoRaWAN packet 6 - SCHC ACK'} diff --git a/draft-ietf-lpwan-schc-over-lorawan.xml b/draft-ietf-lpwan-schc-over-lorawan.xml deleted file mode 100644 index d1ce0fa..0000000 --- a/draft-ietf-lpwan-schc-over-lorawan.xml +++ /dev/null @@ -1,1318 +0,0 @@ - - - - - - - - - - - - - - - - Static Context Header Compression (SCHC) over LoRaWAN - - - Semtech -
- - 14 Chemin des Clos - Meylan - France - - ogimenez@semtech.com -
- - - Acklio -
- - 1137A Avenue des Champs Blancs - 35510 Cesson-Sevigne Cedex - France - - ivaylo@ackl.io -
- - - - - - lpwan Working Group - - - - - -The Static Context Header Compression (SCHC) specification describes generic -header compression and fragmentation techniques for Low Power Wide Area -Networks (LPWAN) technologies. SCHC is a generic mechanism designed for great -flexibility so that it can be adapted for any of the LPWAN technologies. - -This document specifies a profile of RFC8724 to use SCHC in LoRaWAN® networks, -and provides elements such as efficient parameterization and modes of -operation. - - - - - - - - - - - -
- -SCHC specification describes -generic header compression and fragmentation techniques that can be used on all -Low Power Wide Area Networks (LPWAN) technologies defined in -. Even though those technologies share a great -number of common features like star-oriented topologies, network architecture, -devices with mostly quite predictable communications, etc; they do have some -slight differences with respect to payload sizes, reactiveness, etc. - -SCHC provides a generic framework that enables those devices to communicate on -IP networks. However, for efficient performance, some parameters -and modes of operation need to be set appropriately for each of the LPWAN -technologies. - -This document describes the parameters and modes of operation when -SCHC is used over LoRaWAN networks. LoRaWAN protocol is specified by the -LoRa Alliance® in - -
-
- -The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, -“SHOULD NOT”, “RECOMMENDED”, “NOT RECOMMENDED”, “MAY”, and “OPTIONAL” in this -document are to be interpreted as described in BCP 14 -when, and only when, they appear in all capitals, as shown here. - -This section defines the terminology and acronyms used in this document. For -all other definitions, please look up the SCHC specification -. - - - DevEUI: Device Extended Unique Identifier, an IEEE EUI-64 identifier -used to identify the device during the -procedure while joining the network (Join Procedure). It is assigned by the -manufacturer or the device owner and provisioned on the Network Gateway. - DevAddr: a 32-bit non-unique identifier assigned to a device either: - Statically: by the device manufacturer in Activation by Personalization -mode. - Dynamically: after a Join Procedure by the Network Gateway in Over The -Air Activation mode. - - Downlink: LoRaWAN term for a frame transmitted by the network and -received by the device. - EUI: Extended Unique Identifier - LoRaWAN: LoRaWAN is a wireless technology based on Industrial, -Scientific, and Medical (ISM) radio bands that is used for long-range, -low-power, low-data-rate applications developed by the LoRa Alliance, a -membership consortium: https://www.lora-alliance.org. - FRMPayload: Application data in a LoRaWAN frame. - MSB: Most Significant Byte - OUI: Organisation Unique Identifier. IEEE assigned prefix for EUI. - RCS: Reassembly Check Sequence. Used to verify the integrity of the -fragmentation-reassembly process. - RX: Device’s reception window. - RX1/RX2: LoRaWAN class A devices open two RX windows following an -uplink, called RX1 and RX2. - SCHC gateway: The LoRaWAN Application Server that manages translation -between IPv6 network and the Network Gateway (LoRaWAN Network -Server). - Tile: Piece of a fragmented packet as described in section 8.2.2.1 - Uplink: LoRaWAN term for a frame transmitted by the device and received -by the network. - - -
-
- -This section contains a short overview of SCHC. For a detailed description, -refer to the full specification . - -It defines: - - - Compression mechanisms to avoid transporting information known by both -sender and receiver over the air. Known information is part of the -“context”. This component is called SCHC Compressor/Decompressor (SCHC C/D). - Fragmentation mechanisms to allow SCHC Packet transportation on small, and -potentially variable, MTU. This component is called SCHC Fragmentation/Reassembly -(SCHC F/R). - - -Context exchange or pre-provisioning is out of scope of this document. - -
| -]]>
- - represents the architecture for compression/decompression, it is -based on terminology. The device is sending applications flows -using IPv6 or IPv6/UDP protocols. These flows might be compressed by a Static -Context Header Compression Compressor/Decompressor (SCHC C/D) to reduce headers -size and fragmented by the SCHC Fragmentation/Reassembly (SCHC F/R). -The resulting information is sent on a layer two -(L2) frame to an LPWAN Radio Gateway (RGW) that forwards the frame to a Network -Gateway (NGW). The NGW sends the data to a SCHC F/R for reassembly, if -required, then to SCHC C/D for decompression. The SCHC C/D shares the same rules with the -device. The SCHC C/D and F/R can be located on the Network Gateway (NGW) or in -another place as long as a communication is established between the NGW and the SCHC -F/R, then SCHC F/R and C/D. The SCHC C/D and F/R in the device and the SCHC gateway MUST -share the same set of rules. After decompression, the packet can be sent on the Internet to -one or several LPWAN Application Servers (App). - -The SCHC C/D and F/R process is bidirectional, so the same principles can -be applied to the other direction. - -In a LoRaWAN network, the RGW is called a Gateway, the NGW is Network Server, -and the SCHC C/D and F/R are an Application Server. It can be provided by -the Network Gateway or any third party software. can be mapped in -LoRaWAN terminology to: - -
| -]]>
- -
-
- -An overview of LoRaWAN protocol and architecture is -described in . The mapping between the LPWAN -architecture entities as described in -and the ones in is as follows: - -o Devices are LoRaWAN End Devices (e.g. sensors, - actuators, etc.). There can be a very high density of devices per - radio gateway (LoRaWAN gateway). This entity maps to the LoRaWAN end-device. - -o The Radio Gateway (RGW), which is the endpoint of the constrained - link. This entity maps to the LoRaWAN Gateway. - -o The Network Gateway (NGW) is the interconnection node between the - Radio Gateway and the SCHC gateway (LoRaWAN Application server). This - entity maps to the LoRaWAN Network Server. - -o SCHC C/D and F/R are handled by LoRaWAN Application Server; ie the LoRaWAN - application server will do the SCHC C/D and F/R. - -o The LPWAN-AAA Server is the LoRaWAN Join Server. Its role is to manage and - deliver security keys in a secure way, so that the devices root key is never exposed. - -
| +------+ |Application| - () () () () / \==========| v |=============| Server | - () () () / \ +---------+ +-----------+ - End-devices Gateways Network Server (SCHC C/D and F/R) - (devices) (RGW) (NGW) -]]>
- -Note: terms are from LoRaWAN, with terminology in brackets. - -SCHC Compressor/Decompressor (SCHC C/D) and SCHC Fragmentation/Reassembly (SCHC F/R) -are performed on the LoRaWAN end-device and the Application Server (called -SCHC gateway). While the point-to-point link between the device and the -Application Server constitutes a single IP hop, the ultimate end-point of the -IP communication may be an Internet node beyond the Application Server. -In other words, the LoRaWAN Application Server (SCHC gateway) acts as the -first hop IP router for the device. The Application Server and Network -Server may be co-located, which effectively turns the Network/Application -Server into the first hop IP router. - -
- -The LoRaWAN MAC layer supports 3 classes of devices named A, B and C. All -devices implement the Class A, some devices may implement Class B or -Class C. Class B and Class C are mutually exclusive. - - - Class A: The Class A is the simplest class of devices. The device is -allowed to transmit at any time, randomly selecting a communication channel. -The Network Gateway may reply with a downlink in one of the 2 receive windows -immediately following the uplinks. Therefore, the Network Gateway cannot initiate a -downlink, it has to wait for the next uplink from the device to get a -downlink opportunity. The Class A is the lowest power consumption class. - Class B: Class B devices implement all the functionalities of Class A -devices, but also schedule periodic listen windows. Therefore, opposed to the -Class A devices, Class B devices can receive downlinks that are initiated by the -Network Gateway and not following an uplink. There is a trade-off between the -periodicity of those scheduled Class B listen windows and the power -consumption of the device: if the periodicity is high downlinks from the NGW -will be sent faster, but the device wakes up more often: it will have higher -power consumption. - Class C: Class C devices implement all the functionalities of Class A -devices, but keep their receiver open whenever they are not transmitting. -Class C devices can receive downlinks at any time at the expense of a higher -power consumption. Battery-powered devices can only operate in Class C for a -limited amount of time (for example for a firmware upgrade over-the-air). -Most of the Class C devices are grid powered (for example Smart Plugs). - - -
-
- -LoRaWAN end-devices use a 32-bit network address (devAddr) to communicate with -the Network Gateway over-the-air, this address might not be unique in a LoRaWAN -network. Devices using the same devAddr are distinguished by the Network -Gateway based on the cryptographic signature appended to every LoRaWAN frame. - -To communicate with the SCHC gateway, the Network Gateway MUST identify the -devices by a unique 64-bit device identifier called the DevEUI. - -The DevEUI is assigned to the device during the manufacturing process by the -device’s manufacturer. It is built like an Ethernet MAC address by -concatenating the manufacturer’s IEEE OUI field with a vendor unique number. -e.g.: 24-bit OUI is concatenated with a 40-bit serial number. -The Network Gateway translates the devAddr into a DevEUI in the uplink -direction and reciprocally on the downlink direction. - -
| Network | <====> | SCHC | <======> | Internet | -| | devAddr | Gateway | DevEUI | Gateway | IPv6/UDP | | -+--------+ +---------+ +---------+ +----------+ - -]]>
- -
-
- -LoRaWAN implements the possibility to send confirmed or unconfirmed frames: - - - Confirmed frame: -The sender asks the receiver to acknowledge the frame. - Unconfirmed frame: -The sender does not ask the receiver to acknowledge the frame. - - -As SCHC defines its own acknowledgment mechanisms, SCHC does not require -the use of LoRaWAN Confirmed frames (MType=0b100 as per -) - -
-
- -In addition to regular data frames, LoRaWAN implements JoinRequest and JoinAccept -frame types, which are used by a device to join a network: - - - JoinRequest: -This frame is used by a device to join a network. It contains the device’s -unique identifier DevEUI and a random nonce that will be used for session key -derivation. - JoinAccept: -To on-board a device, the Network Gateway responds to the JoinRequest -issued by a device with a JoinAccept frame. That frame is -encrypted with the device’s AppKey and contains (amongst other fields) -the network’s major settings and a random nonce used to derive the session -keys. - Data: -MAC and application data. Application data are protected with AES-128 -encryption. MAC related data are AES-128 encrypted with another key. - - -
-
- -The LoRaWAN MAC layer features a frame port field in all frames. This field -(FPort) is 8 bits long and the values from 1 to 223 can be used. It allows -LoRaWAN networks and applications to identify data. - -
-
- -A LoRaWAN empty frame is a LoRaWAN frame without FPort (cf ) -and FRMPayload. - -
-
- -LoRaWAN technology supports unicast downlinks, but also multicast: a packet -sent over LoRaWAN radio link can be received by several devices. It is -useful to address many devices with same content, either a large binary -file (firmware upgrade), or same command (e.g: lighting control). -As IPv6 is also a multicast technology this feature can be used to address a -group of devices. - -Note 1: IPv6 multicast addresses must be defined as per . LoRaWAN -multicast group definition in a Network Gateway and the relation between those -groups and IPv6 groupID are out of scope of this document. - -Note 2: LoRa Alliance defined as -the RECOMMENDED way to setup multicast groups on devices and create a synchronized -reception window. - -
-
-
- -
- -The FPort field is part of the SCHC Message, as shown in -. The SCHC C/D and the SCHC F/R SHALL concatenate -the FPort field with the LoRaWAN payload to recompose the SCHC Message. - -
- -Note: SCHC Message is any datagram sent by SCHC C/D or F/R layers. - -A fragmented datagram with application payload transferred from device to -Network Gateway, is called an uplink fragmented datagram. It uses an FPort for data uplink -and its associated SCHC control downlinks, named FPortUp in this document. The -other way, a fragmented datagram with application payload transferred from -Network Gateway to device, is called downlink fragmented datagram. It uses another -FPort for data downlink and its associated SCHC control uplinks, named FPortDown -in this document. - -All RuleID can use arbitrary values inside the FPort range allowed by LoRaWAN -specification and MUST be shared by the device and SCHC gateway prior to -the communication with the selected rule. -The uplink and downlink fragmentation FPorts MUST be different. - -
-
- -RuleID MUST be 8 bits, encoded in the LoRaWAN FPort as described in -. LoRaWAN supports up to 223 application FPorts in -the range [1;223] as defined in section 4.3.2 of , it implies -that RuleID MSB SHOULD be inside this range. An application can send non SCHC -traffic by using FPort values different from the ones used for SCHC. - -In order to improve interoperability, RECOMMENDED fragmentation RuleID values are: - - - RuleID = 20 (8-bit) for uplink fragmentation, named FPortUp. - RuleID = 21 (8-bit) for downlink fragmentation, named FPortDown. - RuleID = 22 (8-bit) for which SCHC compression was not possible (i.e., no matching -compression Rule was found), as described in section 6. - - -FPortUp value MUST be different from FPortDown. -The remaining RuleIDs are available for compression. RuleIDs are shared between -uplink and downlink sessions. A RuleID not in the set(s) of FPortUp or FPortDown -means that the fragmentation is not used, thus, on reception, the SCHC Message -MUST be sent to the SCHC C/D layer. - -The only uplink frames using the FPortDown port are the fragmentation SCHC -control messages of a downlink fragmented datagram (for example, SCHC ACKs). -Similarly, the only downlink frames using the FPortUp port are the -fragmentation SCHC control messages of an uplink fragmented datagram. - -An application can have multiple fragmented datagrams between a device and one -or several SCHC gateways. A set of FPort values is REQUIRED for each SCHC gateway -instance the device is required to communicate with. The application can use -additional uplinks or downlink fragmented parameters but SHALL implement at -least the parameters defined in this document. - -The mechanism for context distribution across devices and gateways is -outside the scope of this document. - -
-
- -In order to mitigate the risks described in and , -implementation MUST implement the following algorithm and SHOULD use it. - - - key = LoRaWAN AppSKey - cmac = aes128_cmac(key, DevEUI) - IID = cmac[0..7] - - -aes128_cmac algorithm is described in . It has been chosen as it is -already used by devices for LoRaWAN protocol. - -As AppSKey is renewed each time a device joins or rejoins a LoRaWAN network, -the IID will change over time; this mitigates privacy, location tracking and -correlation over time risks. Join periodicity is defined at the application -level. - -Address scan risk is mitigated thanks to AES-128, which provides enough entropy -bits of the IID. - -Using this algorithm will also ensure that there is no correlation between the -hardware identifier (IEEE-64 DevEUI) and the IID, so an attacker cannot use -manufacturer OUI to target devices. - -Example with: - - - DevEUI: 0x1122334455667788 - appSKey: 0x00AABBCCDDEEFF00AABBCCDDEEFFAABB - - -
- -There is a small probability of IID collision in a LoRaWAN network. If this occurs, -the IID can be changed by rekeying the device at L2 level (ie: trigger a LoRaWAN -join). -The way the device is rekeyed is out of scope of this document and left to the -implementation. - -Note: Implementation also using another IID source MUST ensure that the -same IID is shared between the device and the SCHC gateway in the -compression and decompression of the IPv6 address of the device. - -
-
- -All padding bits MUST be 0. - -
-
- -SCHC C/D MUST concatenate FPort and LoRaWAN payload to retrieve the SCHC Packet -as per . - -RuleIDs matching FPortUp and FPortDown are reserved for SCHC Fragmentation. - -
-
- -The L2 Word Size used by LoRaWAN is 1 byte (8 bits). -The SCHC fragmentation over LoRaWAN uses the ACK-on-Error mode for uplink -fragmentation and Ack-Always mode for downlink fragmentation. A LoRaWAN -device cannot support simultaneous interleaved fragmented datagrams in -the same direction (uplink or downlink). - -The fragmentation parameters are different for uplink and downlink -fragmented datagrams and are successively described in the next sections. - -
- - section 8.2.4 describes the possibility to interleave several -fragmented SCHC datagrams for the same RuleID. This is not used in SCHC over -LoRaWAN profile. A device cannot interleave several fragmented SCHC datagrams -on the same FPort. This field is not used and its size is 0. - -Note: The device can still have several parallel fragmented datagrams with -more than one SCHC gateway thanks to distinct sets of FPorts, cf . - -
-
- -In this case, the device is the fragment transmitter, and the SCHC gateway -the fragment receiver. A single fragmentation rule is defined. -SCHC F/R MUST concatenate FPort and LoRaWAN payload to retrieve the SCHC -Packet, as per . - - - SCHC fragmentation reliability mode: ACK-on-Error. - SCHC header size is two bytes (the FPort byte + 1 additional byte). - RuleID: 8 bits stored in LoRaWAN FPort. cf - DTag: Size T=0 bit, not used. cf - Window index: 4 windows are used, encoded on M = 2 bits - FCN: The FCN field is encoded on N = 6 bits, so WINDOW_SIZE = 63 tiles -are allowed in a window. - Last tile: it can be carried in a Regular SCHC Fragment, alone in an All-1 SCHC -Fragment or with any of these two methods. Implementation must ensure that: - - The sender MUST ascertain that the receiver will not receive -the last tile through both a Regular SCHC Fragment and an All-1 SCHC -Fragment during the same session. - If the last tile is in All-1 SCHC message: current L2 MTU MUST be big enough to fit -the All-1 header and the last tile. - - Penultimate tile MUST be equal to the regular size. - RCS: Use recommended calculation algorithm in (§8.2.3. Integrity Checking). - Tile: size is 10 bytes. - Retransmission timer: Set by the implementation depending on the application -requirements. The default RECOMMENDED duration of this timer is 12 hours; -this value is mainly driven by application requirements and MAY be -changed by the application. - Inactivity timer: The SCHC gateway implements an “inactivity timer”. The -default RECOMMENDED duration of this timer is 12 hours; this value is mainly -driven by application requirements and MAY be changed by the application. - MAX_ACK_REQUESTS: 8. -With this set of parameters, the SCHC fragment header is 16 bits, -including FPort; payload overhead will be 8 bits as FPort is already a part of -LoRaWAN payload. MTU is: 4 windows * 63 tiles * 10 bytes per tile = 2520 bytes - - -In addition to the per-rule context parameters specified in , -for uplink rules, an additional context parameter is added: whether or -not to ack after each window. -For battery powered devices, it is RECOMMENDED to use the ACK mechanism at the -end of each window instead of waiting until the end of all windows: - - - The SCHC receiver SHOULD send a SCHC ACK after every window even if there is no -missing tile. - The SCHC sender SHOULD wait for the SCHC ACK from the SCHC receiver before sending -tiles from the next window. If the SCHC ACK is not received, it SHOULD send a SCHC -ACK REQ up to MAX_ACK_REQUESTS times, as described previously. - - -This will avoid useless uplinks if the device has lost network coverage. - -For non-battery powered devices, the SCHC receiver MAY also choose to send a SCHC -ACK only at the end of all windows. This will reduce downlink load on the LoRaWAN -network, by reducing the number of downlinks. - -SCHC implementations MUST be compatible with both behaviors, and this selection is -part of the rule context. - -
- -
- -
-
- -
- -
- -
-
- -
- -
- -Note: Because of the bitmap compression mechanism and L2 byte alignment, only -the following discrete values are possible for the compressed bitmap size: 5, 13, 21, 29, 37, 45, 53, 61, 62 and 63. -Bitmaps of 63 bits will require 6 bits of padding. - -
-
- -
| <-- L2 Word --> | - -]]>
- -
-
- -
- -
-
-
- -In this case, the device is the fragmentation receiver, and the SCHC gateway the -fragmentation transmitter. The following fields are common to all devices. -SCHC F/R MUST concatenate FPort and LoRaWAN payload to retrieve the SCHC -Packet as described in . - - - SCHC fragmentation reliability mode: - - Unicast downlinks: ACK-Always. - Multicast downlinks: No-ACK, reliability has to be ensured by the upper -layer. This feature is OPTIONAL and may not be implemented by SCHC gateway. - - RuleID: 8 bits stored in LoRaWAN FPort. cf - DTag: Size T=0 bit, not used. cf - FCN: The FCN field is encoded on N=1 bit, so WINDOW_SIZE = 1 tile. - RCS: Use recommended calculation algorithm in (§8.2.3. Integrity Checking). - Inactivity timer: The default RECOMMENDED duration of this timer is 12 hours; -this value is mainly driven by application requirements and MAY be changed by -the application. - - -The following parameters apply to ACK-Always (Unicast) only: - - - Retransmission timer: See . - MAX_ACK_REQUESTS: 8. - Window index (unicast only): encoded on M=1 bit, as per . - - -As only 1 tile is used, its size can change for each downlink, and will be -the currently available MTU. - -Class A devices can only receive during an RX slot, following the transmission of an -uplink. Therefore the SCHC gateway cannot initiate communication (e.g., start a new SCHC -session). In order to create a downlink opportunity it is RECOMMENDED for -Class A devices to send an uplink every 24 hours when no SCHC session is -started, this is application specific and can be disabled. The RECOMMENDED uplink -is a LoRaWAN empty frame as defined . -As this uplink is to open an RX window, any LoRaWAN uplink frame from the device -MAY reset this counter. - -Note: The Fpending bit included in LoRaWAN protocol SHOULD NOT be used for -SCHC-over-LoRaWAN protocol. It might be set by the Network Gateway for other -purposes but not SCHC needs. - -
- -
- -
-
- -
- -
-
- -
- -
- -
-
- -
| <-- L2 Word --> | - - -]]>
- -
-
- -Class A and Class B or Class C devices do not manage retransmissions and timers -the same way. - -
- -Class A devices can only receive in an RX slot following the transmission of an -uplink. - -The SCHC gateway implements an inactivity timer with a RECOMMENDED duration -of 36 hours. For devices with very low transmission rates (example 1 packet a -day in normal operation), that duration may be extended: it is application -specific. - -RETRANSMISSION_TIMER is application specific and its RECOMMENDED value is -INACTIVITY_TIMER/(MAX_ACK_REQUESTS + 1). - -SCHC All-0 (FCN=0) - -All fragments but the last have an FCN=0 (because window size is 1). Following -an All-0 SCHC Fragment, the device MUST transmit the SCHC ACK message. It MUST transmit up to -MAX_ACK_REQUESTS SCHC ACK messages before aborting. In order to progress the -fragmented datagram, the SCHC layer should immediately queue for transmission -those SCHC ACK if no SCHC downlink have been received during RX1 and RX2 window. -LoRaWAN layer will respect the applicable local spectrum regulation. - -Note: The ACK bitmap is 1 bit long and is always 1. - -SCHC All-1 (FCN=1) - -SCHC All-1 is the last fragment of a datagram, the corresponding SCHC ACK -message might be lost; therefore the SCHC gateway MUST request a retransmission -of this ACK when the retransmission timer expires. To open a downlink -opportunity the device MUST transmit an uplink every -RETRANSMISSION_TIMER/(MAX_ACK_REQUESTS * SCHC_ACK_REQ_DN_OPPORTUNITY). -The format of this uplink is application specific. It is RECOMMENDED for a -device to send an empty frame (see ) but it is application -specific and will be used by the NGW to transmit a potential SCHC ACK REQ. -SCHC_ACK_REQ_DN_OPPORTUNITY is application specific and its recommended value -is 2. It MUST be greater than 1. This allows to open a downlink opportunity to -any downlink with higher priority than the SCHC ACK REQ message. - -Note: The device MUST keep this SCHC ACK message in memory until it receives -a downlink SCHC Fragmentation Message (with FPort == FPortDown) that is not a SCHC ACK REQ: it indicates that -the SCHC gateway has received the SCHC ACK message. - -
-
-
- -Class B devices can receive in scheduled RX slots or in RX slots following the -transmission of an uplink. Class C devices are almost in constant reception. - -RECOMMENDED retransmission timer value: - - - Class B: 3 times the ping slot periodicity. - Class C: 30 seconds. - - -The RECOMMENDED inactivity timer value is 12 hours for both Class B and Class -C devices. - -
-
-
-
- -
- -Uplink fragmentation (Ack-On-Error): - -All-0 is distinguishable from a SCHC ACK REQ as states This condition -is also met if the SCHC Fragment Header is a multiple of L2 Words; this -condition met: SCHC header is 2 bytes. - -Downlink fragmentation (Ack-always): - -As per the SCHC All-1 MUST contain the last tile, implementation must -ensure that SCHC All-0 message Payload will be at least the size of an L2 Word. - -
-
- -All-1 is distinguishable from a SCHC Sender-Abort as states This -condition is met if the RCS is present and is at least the size of an L2 Word; -this condition met: RCS is 4 bytes. - -
-
- -This profile does not define a delay to be added after each LoRaWAN frame, local -regulation compliance is expected to be enforced by LoRaWAN stack. - -
-
-
-
- -This document is only providing parameters that are expected to be best -suited for LoRaWAN networks for . IID -security is discussed in . As such, this document does not contribute to -any new security issues beyond those already identified in -. -Moreover, SCHC data (LoRaWAN payload) are protected at the LoRaWAN level by an AES-128 -encryption with a session key shared by the device and the SCHC gateway. These session keys are renewed at each -LoRaWAN session (ie: each join or rejoin to the LoRaWAN network) - -
-
- -This document has no IANA actions. - -
-
- -Thanks to all those listed in the Contributors section for the excellent text, -insightful discussions, reviews and suggestions, and also to (in -alphabetical order) Dominique Barthel, Arunprabhu Kandasamy, Rodrigo Muñoz, -Alexander Pelov, Pascal Thubert, Laurent Toutain for useful design -considerations, reviews and comments. - -
-
- -Contributors ordered by family name. - -Vincent Audebert -EDF R&D -Email: vincent.audebert@edf.fr - -Julien Catalano -Kerlink -Email: j.catalano@kerlink.fr - -Michael Coracin -Semtech -Email: mcoracin@semtech.com - -Marc Le Gourrierec -Sagemcom -Email: marc.legourrierec@sagemcom.com - -Nicolas Sornin -Semtech -Email: nsornin@semtech.com - -Alper Yegin -Actility -Email: alper.yegin@actility.com - -
- - - - - - - - - - - - - - -Key words for use in RFCs to Indicate Requirement Levels - - -In many standards track documents several words are used to signify the requirements in the specification. These words are often capitalized. This document defines these words as they should be interpreted in IETF documents. This document specifies an Internet Best Current Practices for the Internet Community, and requests discussion and suggestions for improvements. - - - - - - - - - - -Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words - - -RFC 2119 specifies common key words that may be used in protocol specifications. This document aims to reduce the ambiguity by clarifying that only UPPERCASE usage of the key words have the defined special meanings. - - - - - - - - - - -IP Version 6 Addressing Architecture - - - -This specification defines the addressing architecture of the IP Version 6 (IPv6) protocol. The document includes the IPv6 addressing model, text representations of IPv6 addresses, definition of IPv6 unicast addresses, anycast addresses, and multicast addresses, and an IPv6 node's required addresses.This document obsoletes RFC 3513, "IP Version 6 Addressing Architecture". [STANDARDS-TRACK] - - - - - - - - - -The AES-CMAC Algorithm - - - - - -The National Institute of Standards and Technology (NIST) has recently specified the Cipher-based Message Authentication Code (CMAC), which is equivalent to the One-Key CBC MAC1 (OMAC1) submitted by Iwata and Kurosawa. This memo specifies an authentication algorithm based on CMAC with the 128-bit Advanced Encryption Standard (AES). This new authentication algorithm is named AES-CMAC. The purpose of this document is to make the AES-CMAC algorithm conveniently available to the Internet Community. This memo provides information for the Internet community. - - - - - - - - - -SCHC: Generic Framework for Static Context Header Compression and Fragmentation - - - - - - -This document defines the Static Context Header Compression and fragmentation (SCHC) framework, which provides both a header compression mechanism and an optional fragmentation mechanism. SCHC has been designed with Low-Power Wide Area Networks (LPWANs) in mind.SCHC compression is based on a common static context stored both in the LPWAN device and in the network infrastructure side. This document defines a generic header compression mechanism and its application to compress IPv6/UDP headers.This document also specifies an optional fragmentation and reassembly mechanism. It can be used to support the IPv6 MTU requirement over the LPWAN technologies. Fragmentation is needed for IPv6 datagrams that, after SCHC compression or when such compression was not possible, still exceed the Layer 2 maximum payload size.The SCHC header compression and fragmentation mechanisms are independent of the specific LPWAN technology over which they are used. This document defines generic functionalities and offers flexibility with regard to parameter settings and mechanism choices. This document standardizes the exchange over the LPWAN between two SCHC entities. Settings and choices specific to a technology or a product are expected to be grouped into profiles, which are specified in other documents. Data models for the context and profiles are out of scope. - - - - - - - - - LoRaWAN Specification Version V1.0.4 - - - - - - - - - - - - - - - - - - -Recommendation on Stable IPv6 Interface Identifiers - - - - - -This document changes the recommended default Interface Identifier (IID) generation scheme for cases where Stateless Address Autoconfiguration (SLAAC) is used to generate a stable IPv6 address. It recommends using the mechanism specified in RFC 7217 in such cases, and recommends against embedding stable link-layer addresses in IPv6 IIDs. It formally updates RFC 2464, RFC 2467, RFC 2470, RFC 2491, RFC 2492, RFC 2497, RFC 2590, RFC 3146, RFC 3572, RFC 4291, RFC 4338, RFC 4391, RFC 5072, and RFC 5121. This document does not change any existing recommendations concerning the use of temporary addresses as specified in RFC 4941. - - - - - - - - - -Privacy Considerations for IPv6 Adaptation-Layer Mechanisms - - -This document discusses how a number of privacy threats apply to technologies designed for IPv6 over various link-layer protocols, and it provides advice to protocol designers on how to address such threats in adaptation-layer specifications for IPv6 over such links. - - - - - - - - - -Low-Power Wide Area Network (LPWAN) Overview - - -Low-Power Wide Area Networks (LPWANs) are wireless technologies with characteristics such as large coverage areas, low bandwidth, possibly very small packet and application-layer data sizes, and long battery life operation. This memo is an informational overview of the set of LPWAN technologies being considered in the IETF and of the gaps that exist between the needs of those technologies and the goal of running IP in LPWANs. - - - - - - - - - LoRaWAN Remote Multicast Setup Specification Version 1.0.0 - - - - - - - - - - - -
- -In following examples “applicative data” refers to the IPv6 payload sent by the -application to the SCHC layer. - -
- -This example represents an applicative data going through SCHC over LoRaWAN, -no fragmentation required - -An applicative data of 78 bytes is passed to SCHC compression layer. Rule 1 -is used by SCHC C/D layer, allowing to compress it to 40 bytes and 5 bits: 1 byte -RuleID, 21 bits residue + 37 bytes payload. - -
- -The current LoRaWAN MTU is 51 bytes, although 2 bytes FOpts are used by -LoRaWAN protocol: 49 bytes are available for SCHC payload; no need for -fragmentation. The payload will be transmitted through FPort = 1. - -
- -
-
- -This example represents an applicative data going through SCHC, with -fragmentation. - -An applicative data of 300 bytes is passed to SCHC compression layer. Rule 1 -is used by SCHC C/D layer, allowing to compress it to 282 bytes and 5 bits: 1 byte -RuleID, 21 bits residue + 279 bytes payload. - -
- -The current LoRaWAN MTU is 11 bytes, 0 bytes FOpts are used by LoRaWAN -protocol: 11 bytes are available for SCHC payload + 1 byte FPort field. -SCHC header is 2 bytes (including FPort) so 1 tile is sent in first -fragment. - -
- -
- -Next transmission MTU is 11 bytes, although 2 bytes FOpts are used by -LoRaWAN protocol: 9 bytes are available for SCHC payload + 1 byte FPort -field, a tile does not fit inside so LoRaWAN stack will send only FOpts. - -Next transmission MTU is 242 bytes, 4 bytes FOpts. 23 tiles are transmitted: - -
- -Next transmission MTU is 242 bytes, no FOpts. All 5 remaining tiles are -transmitted, the last tile is only 2 bytes + 5 bits. Padding is added for -the remaining 3 bits. - -
- -Then All-1 message can be transmitted: - -
- -All packets have been received by the SCHC gateway, computed RCS is -correct so the following ACK is sent to the device by the SCHC receiver: - -
- -
-
- -An applicative data of 155 bytes is passed to SCHC compression layer. Rule 1 -is used by SCHC C/D layer, allowing to compress it to 130 bytes and 5 bits: 1 byte -RuleID, 21 bits residue + 127 bytes payload. - -
- -The current LoRaWAN MTU is 51 bytes, no FOpts are used by LoRaWAN -protocol: 51 bytes are available for SCHC payload + FPort field => it -has to be fragmented. - -
- -Content of the tile is: - -
- -The receiver answers with a SCHC ACK: - -
- -The second downlink is sent, two FOpts: - -
- -The receiver answers with an SCHC ACK: - -
- -The last downlink is sent, no FOpts: - -
- -The receiver answers to the sender with an SCHC ACK: - -
- -
-
- - - - - - - diff --git a/rfc9011.xml b/rfc9011.xml new file mode 100644 index 0000000..f84d6dd --- /dev/null +++ b/rfc9011.xml @@ -0,0 +1,1623 @@ + + + + + + + + Static Context Header Compression and Fragmentation (SCHC) over LoRaWAN + + + Semtech +
+ + 14 Chemin des Clos + Meylan + France + + ogimenez@semtech.com +
+ + + Acklio +
+ + 1137A Avenue des Champs Blancs + Cesson-Sévigné Cedex + 35510 + France + + ivaylo@ackl.io +
+ + + lpwan Working Group + +header compression +compression +fragmentation +static context +rule-based +LPWAN +LPWANs +low power +low-power +LoRa +LoRaWAN +IoT +Internet of Things +adaptation layer +UDP +IPv6 +sensor network +wireless sensor network +802.15.4 +constrained network +constrained node +constrained-node network +SCHC + + + The Static Context Header Compression and fragmentation (SCHC) specification (RFC 8724) describes + generic header compression and fragmentation techniques for Low-Power + Wide Area Network (LPWAN) technologies. SCHC is a generic mechanism + designed for great flexibility so that it can be adapted for any of the + LPWAN technologies. + + This document specifies a profile of RFC 8724 to use SCHC in + LoRaWAN networks and provides elements such as efficient + parameterization and modes of operation. + + + +
+ Introduction + The SCHC specification describes +generic header compression and fragmentation techniques that can be used on all +Low-Power Wide Area Network (LPWAN) technologies defined in +. Even though those technologies share a great +number of common features like star-oriented topologies, network architecture, +devices with communications that are mostly quite predictable, etc., they do have some +slight differences with respect to payload sizes, reactiveness, etc. + SCHC provides a generic framework that enables those devices to communicate on +IP networks. However, for efficient performance, some parameters +and modes of operation need to be set appropriately for each of the LPWAN +technologies. + This document describes the parameters and modes of operation when + SCHC is used over LoRaWAN networks. The LoRaWAN protocol is specified by + the LoRa Alliance in . +
+
+ Terminology + + The key words "MUST", "MUST NOT", + "REQUIRED", "SHALL", "SHALL + NOT", "SHOULD", "SHOULD NOT", + "RECOMMENDED", "NOT RECOMMENDED", + "MAY", and "OPTIONAL" in this document are + to be interpreted as described in BCP 14 when, and + only when, they appear in all capitals, as shown here. + + This section defines the terminology and abbreviations used in this document. For +all other definitions, please look up the SCHC specification +. + + + +
+ +
AppKey: +
+
Application Key. An AES-128 root key specific to each device. +
+ +
AppSKey: +
+
Application Session Key. An AES-128 key derived from the AppKey for +each new session. It is used to encrypt the payload field of a LoRaWAN +applicative frame. +
+ + + +
DevAddr: +
+
A 32-bit non-unique identifier assigned to a device either: +
+
Statically: +
+
by the device manufacturer in "Activation-by-Personalization" + mode, or +
+
Dynamically: +
+
after a LoRaWAN "Join Procedure" by the Network Gateway in "Over-the-Air-Activation" mode. +
+
+
+ + + +
DevEUI: +
+
Device Extended Unique Identifier, an IEEE EUI-64 identifier used to +identify the device during the procedure while joining the network (Join +Procedure). It is assigned by the manufacturer or the device owner and +provisioned on the Network Gateway. +
+ + +
Downlink: +
+
A LoRaWAN term for a frame transmitted by the network and received by the device. +
+ + +
EUI: +
+
Extended Unique Identifier +
+ +
FRMPayload: +
+
Application data in a LoRaWAN frame +
+ + +
IID: +
+
Interface Identifier +
+ + +
LoRaWAN: +
+
LoRaWAN is a wireless technology based on Industrial, Scientific, and +Medical (ISM) radio bands that is used for long-range, low-power, +low-data-rate applications developed by the LoRa Alliance, a membership +consortium: . +
+ + +
MSB: +
+
Most Significant Byte +
+ +
NGW: +
+
Network Gateway +
+ + +
OUI: +
+
Organizationally Unique Identifier. IEEE-assigned prefix for EUI. +
+ + +
RCS: +
+
Reassembly Check Sequence. Used to verify the integrity of the fragmentation-reassembly process. +
+ +
RGW: +
+
Radio Gateway +
+ +
RX: +
+
A device's reception window. +
+ +
RX1/RX2: +
+
LoRaWAN class A devices open two RX windows following an uplink, called "RX1" and "RX2". +
+ +
SCHC C/D: +
+
SCHC Compression/Decompression +
+ +
SCHC F/R: +
+
SCHC Fragmentation/Reassembly +
+ +
SCHC gateway: +
+
The LoRaWAN Application Server that manages translation between an IPv6 +network and the Network Gateway (LoRaWAN Network Server). +
+ +
Tile: +
+
A piece of a fragmented packet as described in . +
+ +
Uplink: +
+
LoRaWAN term for a frame transmitted by the device and received by the network. +
+ + +
+ +
+
+ SCHC Overview + This section contains a short overview of SCHC. For a detailed + description, refer to the full specification . + It defines: + +
  1. Compression mechanisms to avoid + transporting information known by both sender and receiver over the + air. Known information is part of the "context". This component is + called the "SCHC Compression/Decompression" (SCHC C/D).
    2. +
  2. Fragmentation mechanisms to allow SCHC Packet transportation on a + small, and potentially variable, MTU. This component is called the "SCHC + Fragmentation/Reassembly" (SCHC F/R).
    3. +
+ Context exchange or pre-provisioning is out of scope of this document. +
+ Architecture + + | +]]> +
+ represents the + architecture for compression/decompression; it is based on the terminology from . The device is sending + application flows using IPv6 or IPv6/UDP protocols. These flows might + be compressed by a SCHC C/D to reduce header size, and fragmented + by the SCHC F/R. The resulting + information is sent on a Layer 2 (L2) frame to an LPWAN Radio Gateway + (RGW) that forwards the frame to a Network Gateway (NGW). The NGW sends + the data to a SCHC F/R for reassembly, if required, then to a SCHC C/D for + decompression. The SCHC C/D shares the same rules with the device. The + SCHC C/D and SCHC F/R can be located on the NGW or in + another place as long as a communication is established between the NGW + and the SCHC F/R, then SCHC F/R and SCHC C/D. The SCHC C/D and SCHC F/R in the + device and the SCHC gateway MUST share the same set of + rules. After decompression, the packet can be sent on the Internet to + one or several LPWAN Application Servers (App). + The SCHC C/D and SCHC F/R process is bidirectional, so the same principles + can be applied to the other direction. + In a LoRaWAN network, the RGW is called a "Gateway", the NGW is a + "Network Server", and the SCHC C/D and SCHC F/R are one or more + "Application Servers". + + Application servers can be provided by the NGW or any third-party + software. can be mapped in + LoRaWAN terminology to: + + +
+ SCHC Architecture Mapped to LoRaWAN + | +]]> +
+
+
+ LoRaWAN Architecture + An overview of the LoRaWAN protocol and architecture is described in . The mapping between the LPWAN + architecture entities as described in and the ones in is as follows: +
    +
  • Devices are LoRaWAN End Devices (e.g., sensors, actuators, etc.). There +can be a very high density of devices per radio gateway (LoRaWAN +gateway). This entity maps to the LoRaWAN end device. +
    • + +
  • The RGW is the endpoint of the constrained +link. This entity maps to the LoRaWAN Gateway. +
    • + +
  • The NGW is the interconnection node between the Radio +Gateway and the SCHC gateway (LoRaWAN Application Server). This entity maps to +the LoRaWAN Network Server. +
    • + +
  • The SCHC C/D and SCHC F/R are handled by the LoRaWAN Application Server. +
    • + +
  • The LPWAN-AAA Server is the LoRaWAN Join Server. Its role is to manage and +deliver security keys in a secure way so that the devices root key is never +exposed. +
    • +
+ +
+ LPWAN Architecture + | +------+ |Application| + () () () () / \==========| v |=============| Server | + () () () / \ +---------+ +-----------+ + End devices Gateways Network Server (SCHC C/D and F/R) + (devices) (RGW) (NGW) +]]> +
+ + The SCHC C/D and SCHC F/R are performed on the LoRaWAN end + device and the Application Server (called the SCHC gateway). While the + point-to-point link between the device and the Application Server + constitutes a single IP hop, the ultimate endpoint of the IP + communication may be an Internet node beyond the Application Server. In + other words, the LoRaWAN Application Server (SCHC gateway) acts as the + first-hop IP router for the device. The Application Server and Network + Server may be co-located, which effectively turns the + Network/Application Server into the first-hop IP router. +
+ Device Classes (A, B, C) and Interactions + + The LoRaWAN Medium Access Control (MAC) layer supports three + classes of devices named A, B, and C. All devices implement Class + A, and some devices may implement Class B or Class C. Class B and Class C + are mutually exclusive. + +
+ +
Class A: +
+
Class A is the simplest class of devices. The device is allowed to +transmit at any time, randomly selecting a communication channel. The Network +Gateway may reply with a downlink in one of the two receive windows immediately +following the uplinks. Therefore, the Network Gateway cannot initiate a +downlink; it has to wait for the next uplink from the device to get a downlink +opportunity. Class A is the lowest power consumption class. +
+ +
Class B: +
+
Class B devices implement all the functionalities of Class A devices but +also schedule periodic listen windows. Therefore, as opposed to Class A +devices, Class B devices can receive downlinks that are initiated by the +Network Gateway and not following an uplink. There is a trade-off between the +periodicity of those scheduled Class B listen windows and the power +consumption of the device: + + +
+ +
High periodicity:
+
Downlinks from the NGW will be sent faster but the device wakes up more +often and power consumption is increased.
+ +
Low periodicity:
+
Downlinks from the NGW will have higher latency but lower power consumption.
+
+ + + +
+ +
Class C: +
+
Class C devices implement all the functionalities of Class A devices but +keep their receiver open whenever they are not transmitting. Class C devices +can receive downlinks at any time at the expense of a higher power +consumption. Battery-powered devices can only operate in Class C for a limited +amount of time (for example, for a firmware upgrade over-the-air). Most of the +Class C devices are grid powered (for example, Smart Plugs). +
+ +
+ +
+
+ Device Addressing + LoRaWAN end devices use a 32-bit network address (DevAddr) to + communicate with the Network Gateway over the air; this address might + not be unique in a LoRaWAN network. Devices using the same DevAddr are + distinguished by the Network Gateway based on the cryptographic + signature appended to every LoRaWAN frame. + To communicate with the SCHC gateway, the Network Gateway + MUST identify the devices by a unique 64-bit device + identifier called the "DevEUI". + The DevEUI is assigned to the device during the manufacturing + process by the device's manufacturer. It is built like an Ethernet MAC + address by concatenating the manufacturer's IEEE OUI field with a + vendor unique number. For example, a 24-bit OUI is concatenated with a 40-bit + serial number. The Network Gateway translates the DevAddr into a + DevEUI in the uplink direction and reciprocally on the downlink + direction. +
+ LoRaWAN Addresses + | Network | <====> | SCHC | <======> | Internet | +| | DevAddr | Gateway | DevEUI | Gateway | IPv6/UDP | | ++--------+ +---------+ +---------+ +----------+ +]]> +
+
+
+ General Frame Types + LoRaWAN implements the possibility to send confirmed or unconfirmed frames: + +
+ +
Confirmed frame: +
+
The sender asks the receiver to acknowledge the frame. +
+ +
Unconfirmed frame: +
+
The sender does not ask the receiver to acknowledge the frame. +
+ +
+ + As SCHC defines its own acknowledgment mechanisms, SCHC does not require +the use of LoRaWAN Confirmed frames (FType = 0b100 as per +). +
+
+ LoRaWAN MAC Frames + In addition to regular data frames, LoRaWAN implements JoinRequest and JoinAccept +frame types, which are used by a device to join a network: +
+ +
JoinRequest: +
+
This frame is used by a device to join a network. It contains the device's +unique identifier DevEUI and a random nonce that will be used for session key +derivation. +
+ +
JoinAccept: +
+
To onboard a device, the Network Gateway responds to the JoinRequest +issued by a device with a JoinAccept frame. That frame is encrypted with the +device's AppKey and contains (among other fields) the network's major +settings and a random nonce used to derive the session keys. +
+ +
Data: +
+
This refers to MAC and application data. Application data is protected with AES-128 +encryption. MAC-related data is AES-128 encrypted with another key. +
+ +
+ +
+
+ LoRaWAN FPort + The LoRaWAN MAC layer features a frame port field in all frames. This field +(FPort) is 8 bits long and the values from 1 to 223 can be used. It allows +LoRaWAN networks and applications to identify data. +
+
+ LoRaWAN Empty Frame + A LoRaWAN empty frame is a LoRaWAN frame without FPort (cf. ) and FRMPayload. +
+ +
+ Unicast and Multicast Technology + LoRaWAN technology supports unicast downlinks but also multicast; a + multicast packet sent over a LoRaWAN radio link can be received by several + devices. It is useful to address many devices with the same content: + either a large binary file (firmware upgrade) or the same command (e.g., + lighting control). As IPv6 is also a multicast technology, this + feature can be used to address a group of devices. + + + + +
+
+
+ SCHC over LoRaWAN +
+ LoRaWAN FPort and RuleID + The FPort field is part of the SCHC Message, as shown in +. The SCHC C/D and the SCHC F/R SHALL concatenate +the FPort field with the LoRaWAN payload to recompose the SCHC Message. +
+ SCHC Message in LoRaWAN + +
+ + A fragmented datagram with application payload transferred from device to +Network Gateway is called an "uplink-fragmented datagram". It uses an FPort for data uplink +and its associated SCHC control downlinks, named "FPortUp" in this document. The +other way, a fragmented datagram with application payload transferred from +Network Gateway to device is called a "downlink-fragmented datagram". It uses another +FPort for data downlink and its associated SCHC control uplinks, named "FPortDown" +in this document. + + All RuleIDs can use arbitrary values inside the FPort range allowed + by the LoRaWAN specification and + MUST be shared by the device and SCHC gateway prior to + the communication with the selected rule. The uplink and downlink + fragmentation FPorts MUST be different. +
+
+ RuleID Management + The RuleID MUST be 8 bits and encoded in the LoRaWAN + FPort as described in . + + + + LoRaWAN supports up to 223 application FPorts in + the range [1..223] as defined in Section 4.3.2 of ; it implies that the RuleID MSB + SHOULD be inside this range. An application can send + non-SCHC traffic by using FPort values different from the ones used + for SCHC. + In order to improve interoperability, RECOMMENDED fragmentation RuleID values are: +
    +
  • RuleID = 20 (8-bit) for uplink fragmentation, named FPortUp.
    • +
  • RuleID = 21 (8-bit) for downlink fragmentation, named FPortDown.
    • +
  • RuleID = 22 (8-bit) for which SCHC compression was not possible (i.e., no matching +compression Rule was found), as described in .
    • +
+ + + The FPortUp value MUST be different from the FPortDown value. The + remaining RuleIDs are available for compression. RuleIDs are shared + between uplink and downlink sessions. A RuleID not in the set(s) of + FPortUp or FPortDown means that the fragmentation is not used; thus, + on reception, the SCHC Message MUST be sent to the SCHC + C/D layer. + The only uplink frames using the FPortDown port are the + fragmentation SCHC control messages of a downlink-fragmented datagram + (for example, SCHC ACKs). Similarly, the only downlink frames using + the FPortUp port are the fragmentation SCHC control messages of an + uplink-fragmented datagram. + An application can have multiple fragmented datagrams between a device and one +or several SCHC gateways. A set of FPort values is REQUIRED for each SCHC gateway +instance the device is required to communicate with. The application can use +additional uplinks or downlink-fragmented parameters but SHALL implement at +least the parameters defined in this document. + The mechanism for context distribution across devices and gateways is +outside the scope of this document. +
+ + + +
+ Interface IDentifier (IID) Computation + In order to mitigate the risks described in and , +implementations MUST implement the following algorithm and SHOULD use it. +
  1. key = LoRaWAN AppSKey
    2. +
  2. cmac = aes128_cmac(key, DevEUI)
    3. +
  3. IID = cmac[0..7]
    4. +
+ The aes128_cmac algorithm is described in . It has been chosen as it is already used by + devices for the LoRaWAN protocol. + + As AppSKey is renewed each time a device joins or rejoins a LoRaWAN + network, the IID will change over time; this + mitigates privacy concerns, for example, location tracking or correlation + over time. Join periodicity is defined at the application level. + + Address-scan risk is mitigated thanks to the entropy added to + the IID by the inclusion of AppSKey. + Using this algorithm will also ensure that there is no correlation + between the hardware identifier (DevEUI) and the IID, so an + attacker cannot use the manufacturer OUI to target devices. + Example with: +
    +
  • DevEUI: 0x1122334455667788
    • +
  • AppSKey: 0x00AABBCCDDEEFF00AABBCCDDEEFFAABB
    • +
+
+ Example of IID Computation + + +
+ + There is a small probability of IID collision in a LoRaWAN + network. If this occurs, the IID can be changed by rekeying the device + at the L2 level (i.e., triggering a LoRaWAN join). The way the device is + rekeyed is out of scope of this document and left to the + implementation. + +
+
+ Padding + All padding bits MUST be 0. +
+
+ Decompression + The SCHC C/D MUST concatenate FPort and LoRaWAN payload + to retrieve the SCHC Packet as per . + RuleIDs matching FPortUp and FPortDown are reserved for SCHC fragmentation. +
+
+ Fragmentation + The L2 Word Size used by LoRaWAN is 1 byte (8 bits). The SCHC + fragmentation over LoRaWAN uses the ACK-on-Error mode for uplink + fragmentation and ACK-Always mode for downlink fragmentation. A + LoRaWAN device cannot support simultaneous interleaved fragmented + datagrams in the same direction (uplink or downlink). + The fragmentation parameters are different for uplink- and + downlink-fragmented datagrams and are successively described in the + next sections. +
+ DTag + + describes the possibility to interleave several + fragmented SCHC datagrams for the same RuleID. This is not used in + the SCHC-over-LoRaWAN profile. A device cannot interleave several + fragmented SCHC datagrams on the same FPort. This field is not used, + and its size is 0. + +
+
+ + Uplink Fragmentation: From Device to SCHC Gateway + In this case, the device is the fragment transmitter and the SCHC + gateway is the fragment receiver. A single fragmentation rule is + defined. The SCHC F/R MUST concatenate FPort and LoRaWAN + payload to retrieve the SCHC Packet, as per . + +
+ +
SCHC fragmentation reliability mode: +
+
ACK-on-Error. +
+ +
SCHC header size: +
+
2 bytes (the FPort byte + 1 additional byte). +
+ +
RuleID: +
+
8 bits stored in the LoRaWAN FPort (cf. ). +
+ +
DTag: +
+
Size T = 0 bits, not used (cf. ). +
+ +
Window index: +
+
4 windows are used, encoded on M = 2 bits. +
+ +
FCN: +
+
The FCN field is encoded on N = 6 bits, so WINDOW_SIZE = 63 tiles +are allowed in a window. +
+ + +
Last tile: +
+
It can be carried in a Regular SCHC Fragment, alone in an All-1 SCHC +Fragment, or with any of these two methods. Implementations must ensure that: +
    + +
  • The sender MUST ascertain that the receiver will not + receive the last tile through both a Regular SCHC Fragment and an All-1 + SCHC Fragment during the same session. +
    • +
  • If the last tile is in an All-1 SCHC Message, the current L2 MTU + MUST be big enough to fit the All-1 header and the last + tile. +
    • + +
+
+ +
Penultimate tile: +
+
MUST be equal to the regular size. +
+ +
RCS: +
+
Use the recommended calculation algorithm in , Integrity Checking. +
+ +
Tile: +
+
Size is 10 bytes. +
+ +
Retransmission timer: +
+
Set by the implementation depending on the application + requirements. The default RECOMMENDED duration of this + timer is 12 hours; this value is mainly driven by application requirements + and MAY be changed by the application. +
+ +
Inactivity timer: +
+
The SCHC gateway implements an "inactivity timer". The default + RECOMMENDED duration of this timer is 12 hours; this value + is mainly driven by application requirements and MAY be + changed by the application. +
+ +
MAX_ACK_REQUESTS: +
+
8. With this set of parameters, the SCHC Fragment Header is 16 bits, + including FPort; payload overhead will be 8 bits as FPort is already a + part of LoRaWAN payload. MTU is: 4 windows * 63 tiles * 10 bytes per + tile = 2520 bytes. +
+ + +
+ + In addition to the per-rule context parameters specified in , +for uplink rules, an additional context parameter is added: whether or +not to ack after each window. +For battery powered devices, it is RECOMMENDED to use the ACK mechanism at the +end of each window instead of waiting until the end of all windows: +
    +
  • The SCHC receiver SHOULD send a SCHC ACK after every window even if there is no +missing tile.
    • +
  • The SCHC sender SHOULD wait for the SCHC ACK + from the SCHC receiver before sending tiles from the next + window. If the SCHC ACK is not received, it SHOULD + send a SCHC ACK REQ up to MAX_ACK_REQUESTS times, as described + previously.
    • +
+ This will avoid useless uplinks if the device has lost network coverage. + For non-battery powered devices, the SCHC receiver + MAY also choose to send a SCHC ACK only at the end + of all windows. This will reduce downlink load on the LoRaWAN + network by reducing the number of downlinks. + SCHC implementations MUST be compatible with both behaviors, and this selection is +part of the rule context. +
+ Regular Fragments + + is an example of a regular frament for all fragments except + the last one. SCHC Header Size is 16 Bits, including the + LoRaWAN FPort. + +
+ All Fragments Except the Last One. + +
+
+
+ Last Fragment (All-1) + Following figures are examples of All-1 messages. + is without the last tile, + is with the last tile. + +
+ All-1 SCHC Message without Last Tile + +
+
+ All-1 SCHC Message with Last Tile + +
+
+
+ + SCHC ACK +
+ SCHC ACK Format - Correct RCS Check + +
+
+ SCHC ACK Format - Incorrect RCS Check + +
+ +
+
+ Receiver-Abort +
+ Receiver-Abort Format + | <-- L2 Word --> | +]]> +
+
+
+ SCHC Acknowledge Request +
+ SCHC ACK REQ Format + +
+
+
+
+ Downlink Fragmentation: From SCHC Gateway to Device + In this case, the device is the fragmentation receiver and the + SCHC gateway is the fragmentation transmitter. The following fields are + common to all devices. The SCHC F/R MUST concatenate + FPort and LoRaWAN payload to retrieve the SCHC Packet as described + in . + +
+ +
SCHC fragmentation reliability mode: +
+
+
    +
  • +
    + +
    Unicast downlinks: +
    +
    ACK-Always. +
    +
    Multicast downlinks: +
    + +
    No-ACK; reliability has to be ensured by the upper layer. This feature is +OPTIONAL for the SCHC gateway and REQUIRED for the device. +
    + +
    +
    • +
+ +
+ +
RuleID: +
+
8 bits stored in the LoRaWAN FPort (cf. ). +
+ +
DTag: +
+
Size T = 0 bit, not used (cf. ). +
+ +
FCN: +
+
The FCN field is encoded on N = 1 bit, so WINDOW_SIZE = 1 tile. +
+ +
RCS: +
+
Use the recommended calculation algorithm in , Integrity Checking. +
+ +
Inactivity timer: +
+
The default RECOMMENDED duration of this timer is 12 hours; +this value is mainly driven by application requirements and MAY +be changed by the application. +
+ + +
+ + + The following parameters apply to ACK-Always (Unicast) only: + + +
+ +
Retransmission timer: +
+
See . +
+ +
MAX_ACK_REQUESTS: +
+
8. +
+ +
Window index (unicast only): +
+
encoded on M = 1 bit, as per . +
+ +
+ + + As only one tile is used, its size can change for each downlink and + will be the currently available MTU. + Class A devices can only receive during an RX slot, following the + transmission of an uplink. Therefore, the SCHC gateway cannot + initiate communication (e.g., start a new SCHC session). In order to + create a downlink opportunity, it is RECOMMENDED for + Class A devices to send an uplink every 24 hours when no SCHC + session is started; this is application specific and can be + disabled. The RECOMMENDED uplink is a LoRaWAN empty + frame as defined in . As this uplink is sent only to open an RX window, any + LoRaWAN uplink frame from the device MAY reset this + counter. + + +
+ Regular Fragments + + is an example of a regular frament for all fragments except + the last one. SCHC Header Size is 10 Bits, including the + LoRaWAN FPort. + +
+ All Fragments but the Last One. + +
+
+
+ Last Fragment (All-1) +
+ All-1 SCHC Message: The Last Fragment + +
+
+
+ SCHC ACK +
+ SCHC ACK Format - Correct RCS Check + +
+
+ SCHC ACK Format - Incorrect RCS Check + +
+
+
+ Receiver-Abort + + is an example of a Receiver-Abort packet, following an All-1 + SCHC Fragment with incorrect RCS. + +
+ Receiver-Abort Packet + | <-- L2 Word --> | +]]> +
+
+
+ Downlink Retransmission Timer + + Class A, Class B, and Class C devices do not manage + retransmissions and timers the same way. + +
+ Class A Devices + Class A devices can only receive in an RX slot following the + transmission of an uplink. + The SCHC gateway implements an inactivity timer with a + RECOMMENDED duration of 36 hours. For devices + with very low transmission rates (for example, 1 packet a day in + normal operation), that duration may be extended; it is + application specific. + RETRANSMISSION_TIMER is application specific and its + RECOMMENDED value is + INACTIVITY_TIMER/(MAX_ACK_REQUESTS + 1). + SCHC All-0 (FCN = 0) + All fragments but the last have an FCN = 0 (because the window size + is 1). Following an All-0 SCHC Fragment, the device + MUST transmit the SCHC ACK message. It + MUST transmit up to MAX_ACK_REQUESTS SCHC ACK + messages before aborting. In order to progress the fragmented + datagram, the SCHC layer should immediately queue for + transmission those SCHC ACK messages if no SCHC downlink has been + received during the RX1 and RX2 windows. The LoRaWAN layer will respect + the applicable local spectrum regulation. + + + SCHC All-1 (FCN = 1) + + + SCHC All-1 is the last fragment of a datagram, and the + corresponding SCHC ACK message might be lost; therefore, the SCHC + gateway MUST request a retransmission of this ACK + when the retransmission timer expires. To open a downlink + opportunity, the device MUST transmit an uplink + every interval of RETRANSMISSION_TIMER/(MAX_ACK_REQUESTS * + SCHC_ACK_REQ_DN_OPPORTUNITY). The format of this uplink is + application specific. It is RECOMMENDED for a + device to send an empty frame (see ), but it is + application specific and will be used by the NGW to transmit a + potential SCHC ACK REQ. SCHC_ACK_REQ_DN_OPPORTUNITY is + application specific and its recommended value is 2. It + MUST be greater than 1. This allows the opening of a + downlink opportunity to any downlink with higher priority than + the SCHC ACK REQ message. + +
+
+
+ Class B or Class C Devices + Class B devices can receive in scheduled RX slots or in RX + slots following the transmission of an uplink. Class C devices are + almost in constant reception. + RECOMMENDED retransmission timer values are: + +
+ +
Class B: +
+
3 times the ping slot periodicity. +
+ +
Class C: +
+
30 seconds. +
+ +
+ + + The RECOMMENDED inactivity timer value is 12 + hours for both Class B and Class C devices. +
+
+
+
+ SCHC Fragment Format +
+ All-0 SCHC Fragment + Uplink Fragmentation (Ack-on-Error): + All-0 is distinguishable from a SCHC ACK REQ, as states "This condition is also + met if the SCHC Fragment Header is a multiple of L2 Words", the + following condition being met: SCHC header is 2 bytes. + Downlink fragmentation (ACK-Always): + As per , SCHC All-1 + MUST contain the last tile, and implementations + MUST ensure that SCHC All-0 message Payload will be + at least the size of an L2 Word. +
+
+ All-1 SCHC Fragment + All-1 is distinguishable from a SCHC Sender-Abort, as states "This condition is met + if the RCS is present and is at least the size of an L2 Word", + the following condition being met: RCS is 4 bytes. +
+
+ Delay after Each LoRaWAN Frame to Respect Local Regulation + This profile does not define a delay to be added after each + LoRaWAN frame; local regulation compliance is expected to be + enforced by the LoRaWAN stack. +
+ +
+
+
+ Security Considerations + This document is only providing parameters that are expected to be best +suited for LoRaWAN networks for . IID +security is discussed in . As such, this document does not contribute to +any new security issues beyond those already identified in +. +Moreover, SCHC data (LoRaWAN payload) are protected at the LoRaWAN level by an AES-128 +encryption with a session key shared by the device and the SCHC gateway. These session keys are renewed at each +LoRaWAN session (i.e., each join or rejoin to the LoRaWAN network). +
+
+ IANA Considerations + This document has no IANA actions. +
+ + + + + References + + Normative References + + + + + + + + + + + LoRaWAN 1.0.4 Specification Package + + LoRa Alliance + + + + + + + Informative References + + + + + + + LoRaWAN Remote Multicast Setup Specification v1.0.0 + + LoRa Alliance + + + + + + + + +
+ Examples + In the following examples, "applicative data" refers to the IPv6 payload + sent by the application to the SCHC layer. +
+ Uplink - Compression Example - No Fragmentation + This example represents an applicative data going through SCHC over + LoRaWAN; no fragmentation required. + An applicative data of 78 bytes is passed to the SCHC compression + layer. Rule 1 is used by the SCHC C/D layer, allowing to compress it + to 40 bytes and 5 bits: 1 byte RuleID, 21 bits residue + 37 bytes + payload. + +
+ Uplink Example: SCHC Message + +
+ The current LoRaWAN MTU is 51 bytes, although 2-byte FOpts are + used by the LoRaWAN protocol: 49 bytes are available for SCHC payload; no + need for fragmentation. The payload will be transmitted through FPort + = 1. + +
+ Uplink Example: LoRaWAN Packet + +
+
+
+ Uplink - Compression and Fragmentation Example + This example represents an applicative data going through SCHC, with +fragmentation. + An applicative data of 300 bytes is passed to the SCHC compression layer. Rule 1 +is used by the SCHC C/D layer, allowing to compress it to 282 bytes and 5 bits: 1 byte +RuleID, 21 bits residue + 279 bytes payload. +
+ Uplink Example: SCHC Message + +
+ The current LoRaWAN MTU is 11 bytes; 0-byte FOpts are used by + the LoRaWAN protocol: 11 bytes are available for SCHC payload + 1 byte + FPort field. The SCHC header is 2 bytes (including FPort), so 1 tile is + sent in the first fragment. +
+ Uplink Example: LoRaWAN Packet 1 + +
+ The tile content is described in + +
+ Uplink Example: First Tile Content + +
+ Next transmission MTU is 11 bytes, although 2-byte FOpts are used + by the LoRaWAN protocol: 9 bytes are available for SCHC payload + 1 + byte FPort field, a tile does not fit inside so the LoRaWAN stack will + send only FOpts. + Next transmission MTU is 242 bytes, 4-byte FOpts. 23 tiles are transmitted: +
+ Uplink Example: LoRaWAN Packet 2 + +
+ Next transmission MTU is 242 bytes, no FOpts. All 5 remaining tiles are +transmitted, the last tile is only 2 bytes + 5 bits. Padding is added for +the remaining 3 bits. +
+ Uplink Example: LoRaWAN Packet 3 + +
+ Then All-1 message can be transmitted: +
+ Uplink Example: LoRaWAN Packet 4 - All-1 SCHC Message + +
+ All packets have been received by the SCHC gateway, computed RCS is +correct so the following ACK is sent to the device by the SCHC receiver: +
+ Uplink Example: LoRaWAN Packet 5 - SCHC ACK + +
+
+
+ Downlink + An applicative data of 155 bytes is passed to the SCHC compression layer. Rule 1 +is used by the SCHC C/D layer, allowing to compress it to 130 bytes and 5 bits: 1 byte +RuleID, 21 bits residue + 127 bytes payload. +
+ Downlink Example: SCHC Message + +
+ The current LoRaWAN MTU is 51 bytes; no FOpts are used by the + LoRaWAN protocol: 51 bytes are available for SCHC payload + FPort + field; the applicative data has to be fragmented. + + +
+ Downlink Example: LoRaWAN Packet 1 - SCHC Fragment 1 + +
+ The tile content is described in + + + + +
+ Downlink Example: First Tile Content + +
+ The receiver answers with a SCHC ACK: +
+ Downlink Example: LoRaWAN Packet 2 - SCHC ACK + +
+ The second downlink is sent, two FOpts: +
+ Downlink Example: LoRaWAN Packet 3 - SCHC Fragment 2 + +
+ The receiver answers with a SCHC ACK: +
+ Downlink Example: LoRaWAN Packet 4 - SCHC ACK + +
+ The last downlink is sent, no FOpts: +
+ Downlink Example: LoRaWAN Packet 5 - All-1 SCHC Message + +
+ The receiver answers to the sender with a SCHC ACK: +
+ Downlink Example: LoRaWAN Packet 6 - SCHC ACK + +
+
+
+ +
+ Acknowledgements + Thanks to all those listed in the Contributors Section for the + excellent text, insightful discussions, reviews, and suggestions, and + also to (in alphabetical order) , + , , , , and for + useful design considerations, reviews, and comments. + LoRaWAN is a registered trademark of the LoRa Alliance. +
+ + +
+ Contributors + Contributors ordered by family name. + + + + + EDF R&D +
+ + + + + vincent.audebert@edf.fr +
+ + + + Kerlink +
+ + + + + j.catalano@kerlink.fr +
+ + + + Semtech +
+ + + + + mcoracin@semtech.com +
+ + + + + Sagemcom +
+ + + + + marc.legourrierec@sagemcom.com +
+ + + + Chirp Foundation +
+ + + + + nicolas.sornin@chirpfoundation.org +
+ + + + Actility +
+ + + + + alper.yegin@actility.com +
+ + +
+ + +