5.6 Creation / Modification of a Channel (NewChannelReq,
- NewChannelAns, DlChannelReq, DlChannelAns)
19
©2016 LoRa™ Alliance Page 27 of 70
The authors reserve the right to change specifications without notice.
LoRaWAN Specification
- The NewChannelReq command can be used to either modify the parameters of an existing
- bidirectional channel or to create a new one. The command sets the center frequency of the
- new channel and the range of uplink data rates usable on this channel:
Size (bytes) | 1 | 3 | 1 |
---|---|---|---|
NewChannelReq Payload | ChIndex | Freq | DrRange |
4
5 The channel index (ChIndex) is the index of the channel being created or modified.
- Depending on the region and frequency band used, the LoRaWAN specification imposes
- default channels which must be common to all devices and cannot be modified by the
- NewChannelReq command (cf. Chapter 6). If the number of default channels is**N, the
- default channels go from 0 to N-1, and the acceptable range for ChIndex is N to 15. A
- device must be able to handle at least 16 different channel definitions. In certain region the
- device may have to store more than 16 channel definitions.
12
- The frequency (Freq) field is a 24 bits unsigned integer. The actual channel frequency in Hz
- is 100 x Freq whereby values representing frequencies below 100 MHz are reserved for
- future use. This allows setting the frequency of a channel anywhere between 100 MHz to
- 1.67 GHz in 100 Hz steps. A Freq value of 0 disables the channel. The end-device has to
- check that the frequency is actually allowed by its radio hardware and return an error
- otherwise.
19
- The data-rate range (DrRange) field specifies the uplink data-rate range allowed for this
- channel. The field is split in two 4-bit indexes:
Bits | 7:4 | 3:0 |
---|---|---|
DrRange | MaxDR | MinDR |
22
- Following the convention defined in Section 5.2 the minimum data rate (MinDR) subfield
- designate the lowest uplink data rate allowed on this channel. For example 0 designates
- DR0 / 125 kHz. Similarly, the maximum data rate (MaxDR) designates the highest uplink
- data rate. For example, DrRange = 0x77 means that only 50 kbps GFSK is allowed on a
- channel and DrRange = 0x50 means that DR0 / 125 kHz to DR5 / 125 kHz are supported.
28 The newly defined or modified channel is enabled and can immediately be used for
- communication. The RX1 downlink frequency is set equal to the uplink frequency.
- The end-device acknowledges the reception of a NewChannelReq by sending back a
31 | NewChannelAns command. The payload of | this message contains the following | |||
---|---|---|---|---|---|
32 | information: | ||||
Size (bytes) | 1 | ||||
NewChannelAns Payload | Status | ||||
33 |
34 The status (Status) bits have the following meaning:
Bits | 7:2 | 1 | 0 | |||||
---|---|---|---|---|---|---|---|---|
Status | RFU | Data rate | Channel | |||||
range ok | frequency ok | |||||||
35 | ||||||||
Bit = 0 | Bit = 1 | |||||||
Data rate range ok | The designated data rate | The data rate range is | ||||||
range exceeds the ones | compatible with the | |||||||
currently defined for this end- | possibilities of the end- | |||||||
device | device |
©2016 LoRa™ Alliance Page 28 of 70
The authors reserve the right to change specifications without notice.
LoRaWAN Specification | ||||||
---|---|---|---|---|---|---|
Channel frequency ok | The device cannot use this | The device is able to use this | ||||
1 | frequency | frequency. | ||||
Table 9: NewChannelAns status bits signification |
- If either of those 2 bits equals 0, the command did not succeed and the new channel has not
- been created.
4
5 The DlChannelReq command allows the network to associate a different downlink 6 frequency to the RX1 slot. This command is applicable for all the geographic regions
- supporting the NewChannelReq command (for example EU and China, but not for US or
- Australia as described in the LoRaWAN Regional Parameters document [PARAMS]).
- The command sets the center frequency used for the downlink RX1 slot, as follows:
10
Size (bytes) | 1 | 3 |
---|---|---|
DlChannelReq Payload | ChIndex | Freq |
11
- The channel index (ChIndex) is the index of the channel whose downlink frequency is
- modified
- The frequency (Freq) field is a 24 bits unsigned integer. The actual downlink frequency in Hz
- is 100 x Freq whereby values representing frequencies below 100 MHz are reserved for
- future use. The end-device has to check that the frequency is actually allowed by its radio
- hardware and return an error otherwise.
18 The end-device acknowledges the reception of a DlChannelReq by sending back a
- DlChannelAns command. The DlChannelAns command shall be added in the FOpt field of
- all uplinks until a downlink packet is received by the end-device. This guarantees that even
- in presence of uplink packet loss, the network is always aware of the downlink frequencies
- used by the end-device.
- The payload of this message contains the following information:
Size (bytes) | 1 |
---|---|
DlChannelAns Payload | Status |
24
25 The status (Status) bits have the following meaning:
Bits | 7:2 | 1 | 0 | |||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Status | RFU | Uplink frequency | Channel | |||||||||
exists | frequency ok | |||||||||||
26 | ||||||||||||
27 | ||||||||||||
Bit = 0 | Bit = 1 | |||||||||||
Channel frequency ok | The device cannot use this | The device is able to use | ||||||||||
frequency | this frequency. | |||||||||||
The uplink frequency is not | The uplink frequency of | |||||||||||
Uplink frequency | defined for this channel , the | the channel is valid | ||||||||||
downlink frequency can only be | ||||||||||||
exists | ||||||||||||
set for a channel that already has | ||||||||||||
a valid uplink frequency | ||||||||||||
©2016 LoRa™ Alliance Page 29 of 70
The authors reserve the right to change specifications without notice.
LoRaWAN Specification
1 Table 10: DlChannelAns status bits signification
2