logo资料库

LoRaWAN协议说明书1.0.3.pdf

第1页 / 共74页
第2页 / 共74页
第3页 / 共74页
第4页 / 共74页
第5页 / 共74页
第6页 / 共74页
第7页 / 共74页
第8页 / 共74页
资料共74页,剩余部分请下载后查看
LoRaWAN™ 1.0.3 Specification Copyright © 2018 LoRa Alliance, Inc. All rights reserved. NOTICE OF USE AND DISCLOSURE Copyright © LoRa Alliance, Inc. (2017). All Rights Reserved. The information within this document is the property of the LoRa Alliance (“The Alliance”) and its use and disclosure are subject to LoRa Alliance Corporate Bylaws, Intellectual Property Rights (IPR) Policy and Membership Agreements. Elements of LoRa Alliance specifications may be subject to third party intellectual property rights, including without limitation, patent, copyright or trademark rights (such a third party may or may not be a member of LoRa Alliance). The Alliance is not responsible and shall not be held responsible in any manner for identifying or failing to identify any or all such third party intellectual property rights. This document and the information contained herein are provided on an “AS IS” basis and THE ALLIANCE DISCLAIMS ALL WARRANTIES EXPRESS OR IMPLIED, INCLUDING BUT NOTLIMITED TO (A) ANY WARRANTY THAT THE USE OF THE INFORMATION HEREINWILL NOT INFRINGE ANY RIGHTS OF THIRD PARTIES (INCLUDING WITHOUTLIMITATION ANY INTELLECTUAL PROPERTY RIGHTS INCLUDING PATENT, COPYRIGHT OR TRADEMARK RIGHTS) OR (B) ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE,TITLE OR NONINFRINGEMENT. IN NO EVENT WILL THE ALLIANCE BE LIABLE FOR ANY LOSS OF PROFITS, LOSS OF BUSINESS, LOSS OF USE OF DATA, INTERRUPTION OFBUSINESS, OR FOR ANY OTHER DIRECT, INDIRECT, SPECIAL OR EXEMPLARY, INCIDENTIAL, PUNITIVE OR CONSEQUENTIAL DAMAGES OF ANY KIND, IN CONTRACT OR IN TORT, IN CONNECTION WITH THIS DOCUMENT OR THE INFORMATION CONTAINED HEREIN, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH LOSS OR DAMAGE. The above notice and this paragraph must be included on all copies of this document that are made. LoRa Alliance, Inc. 3855 SW 153rd Drive Beaverton, OR 97007 Note: All Company, brand and product names may be trademarks that are the sole property of their respective owners. 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 ©2018 LoRa™ Alliance Page 1 of 74 The authors reserve the right to change specifications without notice.
LoRaWAN 1.0.3 Specification LoRaWAN™ 1.0.3 Specification Authored by the LoRa Alliance Technical Committee Chairs: N.SORNIN (Semtech), A.YEGIN(Actility) Editor: N.SORNIN(Semtech) Contributors: A.BERTOLAUD (Gemalto), J.CATALANO (Kerlink), J.DELCLEF (ST Microelectronics), V.DELPORT (Microchip Technology), P.DUFFY (Cisco), F.DYDUCH (Bouygues Telecom), T.EIRICH (TrackNet), L.FERREIRA (Orange), S.GHAROUT(Orange), O.HERSENT (Actility), A.KASTTET (Homerider Systems), D.KJENDAL (Senet), V.KLEBAN (Everynet), J.KNAPP (TrackNet), T.KRAMP (TrackNet), M.KUYPER (TrackNet), P.KWOK (Objenious), M.LEGOURIEREC (Sagemcom), C.LEVASSEUR (Bouygues Telecom), M.LUIS (Semtech), M.PAULIAC (Gemalto), P.PIETRI (Orbiwise), D.SMITH (MultiTech), R.SOSS(Actility), T.TASHIRO (M2B Communications), P.THOMSEN (Orbiwise), A.YEGIN (Actility) Version: V1.0.3 Date: March 20, 2018 Status: Final release 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 ©2018 LoRa™ Alliance Page 2 of 74 The authors reserve the right to change specifications without notice.
LoRaWAN 1.0.3 Specification 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 4 5 Contents 1 2 Introduction .................................................................................................................. 7 1.1 LoRaWAN Classes .................................................................................................. 7 1.2 Conventions ............................................................................................................. 8 Introduction on LoRaWAN options ............................................................................... 9 2.1 LoRaWAN Classes .................................................................................................. 9 2.2 Specification scope ................................................................................................ 10 Class A – All end-devices ................................................................................................... 11 Physical Message Formats ........................................................................................ 12 3 3.1 Uplink Messages .................................................................................................... 12 3.2 Downlink Messages ............................................................................................... 12 3.3 Receive Windows................................................................................................... 12 3.3.1 First receive window channel, data rate, and start ............................................ 13 3.3.2 Second receive window channel, data rate, and start ....................................... 13 3.3.3 Receive window duration .................................................................................. 13 3.3.4 Receiver activity during the receive windows .................................................... 13 3.3.5 Network sending a message to an end-device ................................................. 13 3.3.6 Important notice on receive windows ................................................................ 14 3.3.7 Receiving or transmitting other protocols .......................................................... 14 MAC Message Formats ............................................................................................. 15 4.1 MAC Layer (PHYPayload) ...................................................................................... 15 4.2 MAC Header (MHDR field) ..................................................................................... 15 4.2.1 Message type (MType bit field) ......................................................................... 16 4.2.2 Major version of data message (Major bit field) ................................................ 16 4.3 MAC Payload of Data Messages (MACPayload) .................................................... 17 4.3.1 Frame header (FHDR) ...................................................................................... 17 4.3.2 Port field (FPort) ............................................................................................... 20 4.3.3 MAC Frame Payload Encryption (FRMPayload) ............................................... 21 4.4 Message Integrity Code (MIC)................................................................................ 21 MAC Commands........................................................................................................ 22 5.1 Link Check commands (LinkCheckReq, LinkCheckAns) ........................................ 23 5.2 Link ADR commands (LinkADRReq, LinkADRAns) ................................................ 24 5.3 End-Device Transmit Duty Cycle (DutyCycleReq, DutyCycleAns) .......................... 26 5.4 Receive Windows Parameters (RXParamSetupReq, RXParamSetupAns) ............ 26 5.5 End-Device Status (DevStatusReq, DevStatusAns) ............................................... 27 5.6 Creation / Modification of a Channel (NewChannelReq, NewChannelAns, 6 DlChannelReq, DlChannelAns) .............................................................................. 28 5.7 Setting delay between TX and RX (RXTimingSetupReq, RXTimingSetupAns) ...... 30 5.8 End-device transmission parameters (TxParamSetupReq, TxParamSetupAns) .... 30 5.9 DeviceTime commands (DeviceTimeReq, DeviceTimeAns) ................................... 31 End-Device Activation ................................................................................................ 33 6.1 Data Stored in the End-device after Activation ....................................................... 33 6.1.1 End-device address (DevAddr) ......................................................................... 33 6.1.2 Application identifier (AppEUI) .......................................................................... 33 6.1.3 Network session key (NwkSKey) ...................................................................... 33 6.1.4 Application session key (AppSKey) .................................................................. 33 6.2 Over-the-Air Activation ........................................................................................... 34 6.2.1 End-device identifier (DevEUI) ......................................................................... 34 6.2.2 Application key (AppKey) ................................................................................. 34 6.2.3 Join procedure.................................................................................................. 34 ©2018 LoRa™ Alliance Page 3 of 74 The authors reserve the right to change specifications without notice.
115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 LoRaWAN 1.0.3 Specification 6.2.4 Join-request message ...................................................................................... 34 6.2.5 Join-accept message........................................................................................ 35 6.3 Activation by Personalization ................................................................................. 37 7 Retransmissions back-off ........................................................................................... 38 Class B – Beacon ............................................................................................................... 39 8 Introduction to Class B ............................................................................................... 40 9 Principle of synchronous network initiated downlink (Class-B option) ......................... 41 10 Uplink frame in Class B mode .................................................................................... 44 11 Downlink Ping frame format (Class B option) ............................................................. 45 11.1 Physical frame format ............................................................................................ 45 11.2 Unicast & Multicast MAC messages ....................................................................... 45 11.2.1 Unicast MAC message format .......................................................................... 45 11.2.2 Multicast MAC message format ........................................................................ 45 12 Beacon acquisition and tracking ................................................................................. 46 12.1 Minimal beacon-less operation time ....................................................................... 46 12.2 Extension of beacon-less operation upon reception ............................................... 46 12.3 Minimizing timing drift ............................................................................................. 46 13 Class B Downlink slot timing ...................................................................................... 48 13.1 Definitions .............................................................................................................. 48 13.2 Slot randomization ................................................................................................. 49 14 Class B MAC commands ........................................................................................... 50 14.1 PingSlotInfoReq ..................................................................................................... 50 14.2 BeaconFreqReq ..................................................................................................... 51 14.3 PingSlotChannelReq .............................................................................................. 52 14.4 BeaconTimingReq & BeaconTimingAns ................................................................. 53 15 Beaconing (Class B option) ........................................................................................ 54 15.1 Beacon physical layer ............................................................................................ 54 15.2 Beacon frame content ............................................................................................ 54 15.3 Beacon GwSpecific field format .............................................................................. 55 15.3.1 Gateway GPS coordinate:InfoDesc = 0, 1 or 2 ................................................. 56 15.3.2 NetID+GatewayID ............................................................................................ 56 15.4 Beaconing precise timing ....................................................................................... 56 15.5 Network downlink route update requirements ......................................................... 57 16 Class B unicast & multicast downlink channel frequencies ......................................... 58 16.1 Single channel beacon transmission ...................................................................... 58 16.2 Frequency-hopping beacon transmission ............................................................... 58 Class C – Continuously listening ......................................................................................... 59 17 Class C: Continuously listening end-device................................................................ 60 17.1 Second receive window duration for Class C ......................................................... 60 17.2 Class C Multicast downlinks ................................................................................... 61 Support information ............................................................................................................. 62 18 Examples and Application Information ....................................................................... 63 18.1 Uplink Timing Diagram for Confirmed Data Messages ........................................... 63 18.2 Downlink Diagram for Confirmed Data Messages .................................................. 63 18.3 Downlink Timing for Frame-Pending Messages ..................................................... 64 18.4 Data-Rate Adaptation during Message Retransmissions........................................ 65 19 Recommendation on contract to be provided to the network server by the end- device provider at the time of provisioning .......................................................................... 67 20 Recommendation on finding the locally used channels .............................................. 68 21 Revisions ................................................................................................................... 69 21.1 Revision 1.0 ........................................................................................................... 69 21.2 Revision 1.0.1 ........................................................................................................ 69 21.3 Revision 1.0.2 ........................................................................................................ 69 ©2018 LoRa™ Alliance Page 4 of 74 The authors reserve the right to change specifications without notice.
LoRaWAN 1.0.3 Specification 21.4 Revision 1.0.3 ........................................................................................................ 70 22 Glossary .................................................................................................................... 71 23 Bibliography ............................................................................................................... 72 23.1 References............................................................................................................. 72 24 NOTICE OF USE AND DISCLOSURE ....................................................................... 73 Tables Table 1: PHY payload format .............................................................................................. 15 Table 2: MAC message types ............................................................................................. 16 Table 3: Major list ................................................................................................................ 16 Table 4: FPort list ................................................................................................................ 21 Table 5: MAC commands .................................................................................................... 23 Table 6: Channel state table ............................................................................................... 24 Table 7: LinkADRAns status bits signification ..................................................................... 26 Table 8: RX2SetupAns status bits signification ................................................................... 27 Table 9: Battery level decoding ........................................................................................... 27 Table 10: NewChannelAns status bits signification ............................................................. 29 Table 11: DlChannelAns status bits signification ................................................................. 30 Table 12: Del mapping table ............................................................................................... 30 Table 13: Beacon timing ..................................................................................................... 48 Table 14 : Class B slot randomization algorithm parameters ............................................... 49 Table 15 : Class B MAC command table ............................................................................. 50 Table 16 : beacon infoDesc index mapping ......................................................................... 55 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 Figures Figure 1: LoRaWAN Classes ................................................................................................ 9 Figure 2: Uplink PHY structure ............................................................................................ 12 Figure 3: Downlink PHY structure ....................................................................................... 12 Figure 4: End-device receive slot timing. ............................................................................. 13 Figure 5: Radio PHY structure (CRC* is only available on uplink messages) ...................... 15 Figure 6: PHY payload structure ......................................................................................... 15 Figure 7: MAC payload structure ......................................................................................... 15 Figure 8: Frame header structure ........................................................................................ 15 Figure 9: LoRa message format elements ........................................................................... 15 Figure 11 : DeviceTimeAns payload format ......................................................................... 32 Figure 12: Beacon reception slot and ping slots .................................................................. 43 Figure 13 : class B FCtrl fields ............................................................................................ 44 Figure 14 : beacon-less temporary operation ...................................................................... 46 Figure 15: Beacon timing .................................................................................................... 48 Figure 16 : PingSlotInfoReq payload format ........................................................................ 50 Figure 17 : BeaconFreqReq payload format ........................................................................ 51 Figure 18 : BeaconFreqAns payload format ........................................................................ 51 Figure 19 : PingSlotChannelReq payload format ................................................................. 52 Figure 20 : PingSlotFreqAns payload format ....................................................................... 52 Figure 21 : beacon physical format ..................................................................................... 54 Figure 22 : beacon frame content........................................................................................ 54 Figure 23 : example of beacon CRC calculation (1) ............................................................ 54 ©2018 LoRa™ Alliance Page 5 of 74 The authors reserve the right to change specifications without notice.
LoRaWAN 1.0.3 Specification 215 216 217 218 219 220 221 222 223 224 225 Figure 24 : example of beacon CRC calculation (2) ............................................................ 55 Figure 25 : beacon GwSpecific field format ......................................................................... 55 Figure 26 : beacon Info field format , infoDesc = 0,1,2 ........................................................ 56 Figure 27 : beacon Info field format, infoDesc=3 ................................................................. 56 Figure 28: Class C end-device reception slot timing. ........................................................... 61 Figure 29: Uplink timing diagram for confirmed data messages .......................................... 63 Figure 30: Downlink timing diagram for confirmed data messages ...................................... 64 Figure 31: Downlink timing diagram for frame-pending messages, example 1 .................... 64 Figure 32: Downlink timing diagram for frame-pending messages, example 2 .................... 65 Figure 33: Downlink timing diagram for frame-pending messages, example 3 .................... 65 ©2018 LoRa™ Alliance Page 6 of 74 The authors reserve the right to change specifications without notice.
226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 1 Introduction LoRaWAN 1.0.3 Specification This document describes the LoRaWAN™ network protocol which is optimized for battery- powered end-devices that may be either mobile or mounted at a fixed location. LoRaWAN networks typically are laid out in a star-of-stars topology in which gateways1 relay messages between end-devices2 and a central network server at the backend. Gateways are connected to the network server via standard IP connections while end- devices use single-hop LoRa™ or FSK communication to one or many gateways.3 All communication is generally bi-directional, although uplink communication from an end- device to the network server is expected to be the predominant traffic. Communication between end-devices and gateways is spread out on different frequency channels and data rates. The selection of the data rate is a trade-off between communication range and message duration, communications with different data rates do not interfere with each other. LoRa data rates range from 0.3 kbps to 50 kbps. To maximize both battery life of the end-devices and overall network capacity, the LoRa network infrastructure can manage the data rate and RF output for each end-device individually by means of an adaptive data rate (ADR) scheme. End-devices may transmit on any channel available at any time, using any available data rate, as long as the following rules are respected:  The end-device changes channel for every transmission. The resulting frequency diversity makes the system more robust to interferences. in a pseudo-random fashion  The end-device respects the maximum transmit duty cycle relative to the sub-band used and local regulations.  The end-device respects the maximum transmit duration (or dwell time) relative to the sub-band used and local regulations. Note: Maximum transmit duty-cycle and dwell time per sub-band are region specific and are defined in the LoRaWAN ¨regional phyLayer definition document 1.1 LoRaWAN Classes All LoRaWAN devices implement at least the Class A functionality as described in this document. In addition they MAY implement options named Class B, Class C as also described in this document or others to be defined. In all cases, they must remain compatible with Class A. 1 Gateways are also known as concentrators or base stations. 2 End-devices are also known as motes. 3 Support for intermediate elements – repeaters – is not described in the document, however payload restrictions for encapsulation overhead are included in this specification. A repeater is defined as using LoRaWAN as its backhaul mechanism. ©2018 LoRa™ Alliance Page 7 of 74 The authors reserve the right to change specifications without notice.
LoRaWAN 1.0.3 Specification 259 260 261 1.2 Conventions MAC commands are written LinkCheckReq, bits and bit fields are written FRMPayload, constants are written RECEIVE_DELAY1, variables are written N. 262 In this document, 263 264 265  The octet order for all multi-octet fields is little endian and  EUI are 8 bytes multi-octet fields and are transmitted as little endian.  By default, RFU bits are set to zero ©2018 LoRa™ Alliance Page 8 of 74 The authors reserve the right to change specifications without notice.
分享到:
收藏