Skip to content

Commit

Permalink
Change gitbook doc's framework
Browse files Browse the repository at this point in the history
  • Loading branch information
twowinter committed Jan 1, 2019
1 parent 9e7b8f0 commit 5a17d37
Show file tree
Hide file tree
Showing 27 changed files with 122 additions and 122 deletions.
185 changes: 93 additions & 92 deletions SUMMARY.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,96 +2,97 @@

* [前言](README.md)

* [第1章 介绍](eBook/1 Introduction.md)
* [1.1 LoRaWAN Classes](eBook/1 Introduction.md#1.1)
* [1.2 文档约定](eBook/1 Introduction.md#1.2)

* [第2章 LoRaWAN Classes 类型介绍](eBook/2 Introduction on LoRaWAN options.md)
* [2.1 LoRaWAN Classes](eBook/2 Introduction on LoRaWAN options.md#2.1)
* [2.2 文档范围](eBook/2 Introduction on LoRaWAN options.md#2.2)

* [CLASS A - ALL END-DEVICE 所有终端](eBook/CLASS A - ALL END-DEVICE.md)

* [第3章 PHY 帧格式](eBook/3 Physical Message Formats.md)
* [3.1 上行消息](eBook/3 Physical Message Formats.md#3.1)
* [3.2 下行消息](eBook/3 Physical Message Formats.md#3.2)
* [3.3 接收窗口](eBook/3 Physical Message Formats.md#3.3)
* [3.3.1 第一接收窗口的信道,数据速率和启动](eBook/3 Physical Message Formats.md#3.3.1)
* [3.3.2 第二接收窗口的信道,数据速率和启动](eBook/3 Physical Message Formats.md#3.3.2)
* [3.3.3 接收窗口的持续时间](eBook/3 Physical Message Formats.md#3.3.3)
* [3.3.4 接收方在接收窗口期间的处理](eBook/3 Physical Message Formats.md#3.3.4)
* [3.3.5 网络发送消息给终端](eBook/3 Physical Message Formats.md#3.3.5)
* [3.3.6 接收窗口的重要事项](eBook/3 Physical Message Formats.md#3.3.6)

* [第4章 MAC帧格式](eBook/4 MAC Message Formats.md)
* [4.1 MAC层](eBook/4 MAC Message Formats.md#4.1)
* [4.2 MAC头(MHDR字段)](eBook/4 MAC Message Formats.md#4.2)
* [4.2.1 第一接收窗口的信道,数据速率和启动](eBook/4 MAC Message Formats.md#4.2.1)
* [4.2.2 数据消息的主版本(Major位字段)](eBook/4 MAC Message Formats.md#4.2.2)
* [4.3 MAC载荷(MACPayload)](eBook/4 MAC Message Formats.md#4.3)
* [4.3.1 帧头(FHDR)](eBook/4 MAC Message Formats.md#4.3.1)
* [4.3.2 端口字段(FPort)](eBook/4 MAC Message Formats.md#4.3.2)
* [4.3.3 MAC帧载荷加密(FRMPayload)](eBook/4 MAC Message Formats.md#4.3.3)
* [4.4 消息校验码(MIC)](eBook/4 MAC Message Formats.md#4.4)

* [第5章 MAC命令](eBook/5 MAC Commands.md)
* [5.1 Link Check 命令 (LinkCheckReq, LinkCheckAns)](eBook/5 MAC Commands.md#5.1)
* [5.2 Link ADR 命令(LinkADRReq, LinkADRAns)](eBook/5 MAC Commands.md#5.2)
* [5.3 终端发射占空比(DutyCycleReq, DutyCycleAns)](eBook/5 MAC Commands.md#5.3)
* [5.4 接收窗口参数(RXParamSetupReq,RXParamSetupAns)](eBook/5 MAC Commands.md#5.4)
* [5.5 终端状态(DevStatusReq, DevStatusAns)](eBook/5 MAC Commands.md#5.5)
* [5.6 信道的创建和修改(NewChannelReq, NewChannelAns, DlChannelReq, DlChannelAns)](eBook/5 MAC Commands.md#5.6)
* [5.7 TX 和 RX 之间的延时设置(RXTimingSetupReq, RXTimingSetupAns)](eBook/5 MAC Commands.md#5.7)
* [5.8 终端发送参数(TxParamSetupReq, TxParamSetupAns)](eBook/5 MAC Commands.md#5.8)

* [第6章 终端激活](eBook/6 End-Device Activation.md)
* [6.1 终端激活后的数据存储](eBook/6 End-Device Activation.md#6.1)
* [6.2 空中激活 OTAA](eBook/6 End-Device Activation.md#6.2)
* [6.2.1 终端 ID (DevEUI)](eBook/6 End-Device Activation.md#6.2.1)
* [6.2.2 应用密钥(AppKey)](eBook/6 End-Device Activation.md#6.2.2)
* [6.2.3 加网流程](eBook/6 End-Device Activation.md#6.2.3)
* [6.2.4 Join-request 消息](eBook/6 End-Device Activation.md#6.2.4)
* [6.2.5 Join-accept 消息](eBook/6 End-Device Activation.md#6.2.5)
* [6.3 独立激活 ABP](eBook/6 End-Device Activation.md#6.3)

* [第7章 重传退避](eBook/7 Retransmissions back-off Activation.md)

* [CLASS B – BEACON 信标](eBook/CLASS B - BEACON.md)

* [第8章 Class B 介绍](eBook/8 Introduction to Class B.md)

* [第9章 下行同步网络的原理](eBook/9 Principle of synchronous network initiated downlink.md)

* [第10章 Class B 模式的上行帧](eBook/10 Uplink frame in Class B mode.md)

* [第11章 Class B 模式的下行帧(Class B选项)](eBook/11 Downlink Ping frame format.md)

* [第12章 信标的获得和追踪](eBook/12 Beacon acquisition and tracking.md)

* [第13章 Class B下行时隙时序](eBook/13 Class B Downlink slot timing.md)
* [13.1 定义](eBook/13 Class B Downlink slot timing.md#13.1)
* [13.2 时隙随机化](eBook/13 Class B Downlink slot timing.md#13.2)

* [第14章 Class B MAC命令](eBook/14 Class B MAC commands.md)
* [14.1 PingSlotInfoReq MAC命令](eBook/14 Class B MAC commands.md#14.1)
* [14.2 BeaconFreReq MAC命令](eBook/14 Class B MAC commands.md#14.2)
* [14.3 PingSlotChannelReq MAC命令](eBook/14 Class B MAC commands.md#14.3)
* [14.4 BeaconTimingReq MAC命令](eBook/14 Class B MAC commands.md#14.4)
* [14.5 BeaconTimingAns MAC命令](eBook/14 Class B MAC commands.md#14.5)

* [第15章 信标(Class B选项)](eBook/15 Beaconing[Class B option].md)
* [15.1 信标物理层](eBook/15 Beaconing[Class B option].md#15.1)
* [15.2 信标物理帧格式](eBook/15 Beaconing[Class B option].md#15.2)
* [15.3 信标 GwSpecific 域格式](eBook/15 Beaconing[Class B option].md#15.3)
* [15.4 信标准确的时隙](eBook/15 Beaconing[Class B option].md#15.4)
* [15.5 网络下行链路路由更新要求](eBook/15 Beaconing[Class B option].md#15.5)

* [第16章 Class B单播/多播下行信道频率](eBook/16 Class B unicast & multicast downlink channel frequencies.md)
* [16.1 欧盟 863-870MHz ISM 频段](eBook/16 Class B unicast & multicast downlink channel frequencies.md#16.1)
* [16.2 美国 902-928MHz ISM 频段](eBook/16 Class B unicast & multicast downlink channel frequencies.md#16.2)

* [CLASS C - CONTINUOUSLY LISTENING 持续接收](eBook/CLASS C – CONTINUOUSLY LISTENING.md)
* [第17章 持续接收的终端](eBook/17 Class C Continuously listening end-device.md)
* [17.1 Class C 的第二接收窗口持续时间](eBook/17 Class C Continuously listening end-device.md#17.1)
* [17.2 Class C 对多播下行的处理](eBook/17 Class C Continuously listening end-device.md#17.2)
* [第1章 介绍](chapter/1 Introduction.md)
* [1.1 LoRaWAN Classes](chapter/1 Introduction.md#1.1)
* [1.2 文档约定](chapter/1 Introduction.md#1.2)

* [第2章 LoRaWAN Classes 类型介绍](chapter/2 Introduction on LoRaWAN options.md)
* [2.1 LoRaWAN Classes](chapter/2 Introduction on LoRaWAN options.md#2.1)
* [2.2 文档范围](chapter/2 Introduction on LoRaWAN options.md#2.2)

* [CLASS A - ALL END-DEVICE 所有终端](chapter/CLASS A - ALL END-DEVICE.md)

* [第3章 PHY 帧格式](chapter/3 Physical Message Formats.md)
* [3.1 上行消息](chapter/3 Physical Message Formats.md#3.1)
* [3.2 下行消息](chapter/3 Physical Message Formats.md#3.2)
* [3.3 接收窗口](chapter/3 Physical Message Formats.md#3.3)
* [3.3.1 第一接收窗口的信道,数据速率和启动](chapter/3 Physical Message Formats.md#3.3.1)
* [3.3.2 第二接收窗口的信道,数据速率和启动](chapter/3 Physical Message Formats.md#3.3.2)
* [3.3.3 接收窗口的持续时间](chapter/3 Physical Message Formats.md#3.3.3)
* [3.3.4 接收方在接收窗口期间的处理](chapter/3 Physical Message Formats.md#3.3.4)
* [3.3.5 网络发送消息给终端](chapter/3 Physical Message Formats.md#3.3.5)
* [3.3.6 接收窗口的重要事项](chapter/3 Physical Message Formats.md#3.3.6)

* [第4章 MAC帧格式](chapter/4 MAC Message Formats.md)
* [4.1 MAC层](chapter/4 MAC Message Formats.md#4.1)
* [4.2 MAC头(MHDR字段)](chapter/4 MAC Message Formats.md#4.2)
* [4.2.1 第一接收窗口的信道,数据速率和启动](chapter/4 MAC Message Formats.md#4.2.1)
* [4.2.2 数据消息的主版本(Major位字段)](chapter/4 MAC Message Formats.md#4.2.2)
* [4.3 MAC载荷(MACPayload)](chapter/4 MAC Message Formats.md#4.3)
* [4.3.1 帧头(FHDR)](chapter/4 MAC Message Formats.md#4.3.1)
* [4.3.2 端口字段(FPort)](chapter/4 MAC Message Formats.md#4.3.2)
* [4.3.3 MAC帧载荷加密(FRMPayload)](chapter/4 MAC Message Formats.md#4.3.3)
* [4.4 消息校验码(MIC)](chapter/4 MAC Message Formats.md#4.4)

* [第5章 MAC命令](chapter/5 MAC Commands.md)
* [5.1 Link Check 命令 (LinkCheckReq, LinkCheckAns)](chapter/5 MAC Commands.md#5.1)
* [5.2 Link ADR 命令(LinkADRReq, LinkADRAns)](chapter/5 MAC Commands.md#5.2)
* [5.3 终端发射占空比(DutyCycleReq, DutyCycleAns)](chapter/5 MAC Commands.md#5.3)
* [5.4 接收窗口参数(RXParamSetupReq,RXParamSetupAns)](chapter/5 MAC Commands.md#5.4)
* [5.5 终端状态(DevStatusReq, DevStatusAns)](chapter/5 MAC Commands.md#5.5)
* [5.6 信道的创建和修改(NewChannelReq, NewChannelAns, DlChannelReq, DlChannelAns)](chapter/5 MAC Commands.md#5.6)
* [5.7 TX 和 RX 之间的延时设置(RXTimingSetupReq, RXTimingSetupAns)](chapter/5 MAC Commands.md#5.7)
* [5.8 终端发送参数(TxParamSetupReq, TxParamSetupAns)](chapter/5 MAC Commands.md#5.8)

* [第6章 终端激活](chapter/6 End-Device Activation.md)
* [6.1 终端激活后的数据存储](chapter/6 End-Device Activation.md#6.1)
* [6.2 空中激活 OTAA](chapter/6 End-Device Activation.md#6.2)
* [6.2.1 终端 ID (DevEUI)](chapter/6 End-Device Activation.md#6.2.1)
* [6.2.2 应用密钥(AppKey)](chapter/6 End-Device Activation.md#6.2.2)
* [6.2.3 加网流程](chapter/6 End-Device Activation.md#6.2.3)
* [6.2.4 Join-request 消息](chapter/6 End-Device Activation.md#6.2.4)
* [6.2.5 Join-accept 消息](chapter/6 End-Device Activation.md#6.2.5)
* [6.3 独立激活 ABP](chapter/6 End-Device Activation.md#6.3)

* [第7章 重传退避](chapter/7 Retransmissions back-off Activation.md)

* [CLASS B – BEACON 信标](chapter/CLASS B - BEACON.md)

* [第8章 Class B 介绍](chapter/8 Introduction to Class B.md)

* [第9章 下行同步网络的原理](chapter/9 Principle of synchronous network initiated downlink.md)

* [第10章 Class B 模式的上行帧](chapter/10 Uplink frame in Class B mode.md)

* [第11章 Class B 模式的下行帧(Class B选项)](chapter/11 Downlink Ping frame format.md)

* [第12章 信标的获得和追踪](chapter/12 Beacon acquisition and tracking.md)

* [第13章 Class B下行时隙时序](chapter/13 Class B Downlink slot timing.md)
* [13.1 定义](chapter/13 Class B Downlink slot timing.md#13.1)
* [13.2 时隙随机化](chapter/13 Class B Downlink slot timing.md#13.2)

* [第14章 Class B MAC命令](chapter/14 Class B MAC commands.md)
* [14.1 PingSlotInfoReq MAC命令](chapter/14 Class B MAC commands.md#14.1)
* [14.2 BeaconFreReq MAC命令](chapter/14 Class B MAC commands.md#14.2)
* [14.3 PingSlotChannelReq MAC命令](chapter/14 Class B MAC commands.md#14.3)
* [14.4 BeaconTimingReq MAC命令](chapter/14 Class B MAC commands.md#14.4)
* [14.5 BeaconTimingAns MAC命令](chapter/14 Class B MAC commands.md#14.5)

* [第15章 信标(Class B选项)](chapter/15 Beaconing[Class B option].md)
* [15.1 信标物理层](chapter/15 Beaconing[Class B option].md#15.1)
* [15.2 信标物理帧格式](chapter/15 Beaconing[Class B option].md#15.2)
* [15.3 信标 GwSpecific 域格式](chapter/15 Beaconing[Class B option].md#15.3)
* [15.4 信标准确的时隙](chapter/15 Beaconing[Class B option].md#15.4)
* [15.5 网络下行链路路由更新要求](chapter/15 Beaconing[Class B option].md#15.5)

* [第16章 Class B单播/多播下行信道频率](chapter/16 Class B unicast & multicast downlink channel frequencies.md)
* [16.1 欧盟 863-870MHz ISM 频段](chapter/16 Class B unicast & multicast downlink channel frequencies.md#16.1)
* [16.2 美国 902-928MHz ISM 频段](chapter/16 Class B unicast & multicast downlink channel frequencies.md#16.2)

* [CLASS C - CONTINUOUSLY LISTENING 持续接收](chapter/CLASS C – CONTINUOUSLY LISTENING.md)

* [第17章 持续接收的终端](chapter/17 Class C Continuously listening end-device.md)
* [17.1 Class C 的第二接收窗口持续时间](chapter/17 Class C Continuously listening end-device.md#17.1)
* [17.2 Class C 对多播下行的处理](chapter/17 Class C Continuously listening end-device.md#17.2)

File renamed without changes.
File renamed without changes.
File renamed without changes.
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ Class B 模式的设备也许会短暂性地无法接收信标(超出与网关

在 “beacon-less” 的情况下,单播、多播还有信标接收时隙都必须逐步地扩大接收窗口时间以容纳终端可能的时钟漂移。

![](Pictures/beacon-less_temporary_operation.png)
![](/img/beacon-less_temporary_operation.png)

### <a name="12.2">12.2 beacon-less 接收操作的延长</a>

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@

两个连续的信标起始点之间的间隔称为信标周期。信标帧的传输以 **BEACON_RESERVED** 时间间隔的起始端对齐。每个信标都有一个保护时间间隔,在该时间间隔之内是没有 ping 时隙的。保护间隔的长度对应于允许帧在空中的最长时间。这样就能保证在保护时间之前的一个 ping 时隙内发起的下行数据帧总是有时间去完成传输而不与信标的传输发生冲突。因此用于ping时隙的时间间隔是从 **BEACON_RESERVED** 时间间隔的末尾节点到下一 **BEACON_GUARD** 时间间隔的起始节点。

![](Pictures/Beacon_timing.png)
![](/img/Beacon_timing.png)
图 12 :信标时序

<table>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -253,4 +253,4 @@ Frequency 字段和Class A协议中定义的 **NewChannelReq** MAC 命令有着

30ms x (Delay+1) > RTime >= 30ms x Delay

在信标交替使用多个信道的网络中,**“Channel”**字段是下一个信标广播所使用的信道编号。对于信标广播频率固定的网络来说,这个字段值为0。
在信标交替使用多个信道的网络中,**“Channel”**字段是下一个信标广播所使用的信道编号。对于信标广播频率固定的网络来说,这个字段值为0。
File renamed without changes.
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ Class C 终端会尽可能地使用 RX2 窗口来监听。按照 Class A 的规

Class C 设备执行和 Class A 一样的两个接收窗口,但它们没有关闭 RX2 ,除非他们需要再次发送数据。因此它们几乎可以在任意时间用 RX2 来接收下行消息,包括MAC命令和ACK传输的下行消息。另外在发送结束和 RX1 开启之间还打开了一个短暂的RX2窗口。

![](Pictures/lorawan_ClassCed_reception_slot_timing.png)
![](/img/lorawan_ClassCed_reception_slot_timing.png)

图13.Class C 终端的接收时隙时序图

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ LoRa 是由Semtech面向长距离、低功耗、低速率应用而开发的无

LoRa网络包含基础LoRaWAN(称之为Class A)和可选功能(Class B,Class C):

![](Pictures/lorawan_classes.png)
![](/img/lorawan_classes.png)
图1.LoRaWAN Classes

- **双向传输终端(Class A):** Class A 的终端在每次上行后都会紧跟两个短暂的下行接收窗口,以此实现双向传输。终端基于自身通信需求来安排传输时隙,在随机时间的基础上具有较小的变化(即ALOHA协议)。这种Class A 操作为应用提供了最低功耗的终端系统,只要求应用在终端上行传输后的很短时间内进行服务器的下行传输。服务器在其他任何时间进行的下行传输都得等终端的下一次上行。
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,7 @@ PHDR,PHDR_CRC 及载荷 CRC 域都通过射频收发器加入。

每个上行传输后终端都要开两个短的接收窗口。接收窗口开始时间的规定,是以传输结束时间为参考。

![](Pictures/lorawan_ed_receive_slot_timing.png)
![](/img/lorawan_ed_receive_slot_timing.png)

图4.终端接收时隙的时序图

Expand Down
File renamed without changes.
42 changes: 21 additions & 21 deletions eBook/5 MAC Commands.md → chapter/5 MAC Commands.md
Original file line number Diff line number Diff line change
Expand Up @@ -194,27 +194,27 @@
<tr>
<td><b>Size (bytes)</b></td>
<td>1</td>
<td>2</td>
<td>1</td>
<td>2</td>
<td>1</td>
</tr>
<tr>
<td><b>LinkADRReq Payload</b></td>
<td>DataRate_TXPower</td>
<td>ChMask</td>
<td>Redundancy</td>
<td>ChMask</td>
<td>Redundancy</td>
</tr>
</table>

<table>
<tr>
<td><b>Bits</b></td>
<td>[7:4]</td>
<td>[3:0]</td>
<td>[3:0]</td>
</tr>
<tr>
<td><b>DataRate_TXPower</b></td>
<td>DataRate</td>
<td>TXPower</td>
<td>TXPower</td>
</tr>
</table>

Expand Down Expand Up @@ -251,14 +251,14 @@ ChMask 字段的对应位如果设置为1,则表示对应的信道可以进行
<tr>
<td><b>Bits</b></td>
<td>7</td>
<td>[6:4]</td>
<td>[3:0]</td>
<td>[6:4]</td>
<td>[3:0]</td>
</tr>
<tr>
<td><b>Redundancy bits</b></td>
<td>RFU</td>
<td>ChMaskCntl</td>
<td>NbTrans</td>
<td>ChMaskCntl</td>
<td>NbTrans</td>
</tr>
</table>

Expand Down Expand Up @@ -286,41 +286,41 @@ NS(网络服务器)可能会在单个下行帧中包含多个 LinkAdrReq 命令
<tr>
<td><b>Bits</b></td>
<td>[7:3]</td>
<td>2</td>
<td>1</td>
<td>0</td>
<td>2</td>
<td>1</td>
<td>0</td>
</tr>
<tr>
<td><b>Status bits</b></td>
<td>RFU</td>
<td>Power ACK</td>
<td>Data rate ACK</td>
<td>Channel mask ACK</td>
<td>Power ACK</td>
<td>Data rate ACK</td>
<td>Channel mask ACK</td>
</tr>
</table>

LinkADRAns 的 Status 位域按照如下定义:

<table>
<tr>
<td><b> /b></td>
<td> </td>
<td><b>Bit = 0</b></td>
<td><b>Bit = 1</b></td>
<td><b>Bit = 1</b></td>
</tr>
<tr>
<td><b>Channel mask ACK</b></td>
<td>所发的 channel mask 使能了未定义的信道或者禁用了所有信道。命令被丢弃,终端状态不变。</td>
<td>所发的 channel mask 已成功解析,已按照 mask 设置了当前的信道状态。</td>
<td>所发的 channel mask 已成功解析,已按照 mask 设置了当前的信道状态。</td>
</tr>
<tr>
<td><b>Data rate ACK</b></td>
<td>所请求的数据速率,终端无法识别,或者无法应用在当前信道中(不支持任何使能的信道)。命令被丢弃,终端状态不变。</td>
<td>数据速率成功设置。</td>
<td>数据速率成功设置。</td>
</tr>
<tr>
<td><b>Power ACK</b></td>
<td>所请求的发射功率不能在终端上执行。命令被丢弃,终端状态不变。</td>
<td>功率等级成功设置。</td>
<td>功率等级成功设置。</td>
</tr>
</table>

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -173,5 +173,4 @@ join-request 消息不用加密。

独立激活终端,意味着 DevAddr 和两个会话密钥 NwkSKey 和 AppSKey 直接存储在终端中,而不是DevEUI,AppEUI,AppKey。终端在一开始就配置好了入网必要的信息。

每个终端必须要有唯一的 NwkSKey 和 AppSKey。这样,一个设备的密钥被破解也不会造成其他设备的安全性危险。创建那些密钥的过程中,密钥不允许通过公开可用信息获得(例如节点地址)。

每个终端必须要有唯一的 NwkSKey 和 AppSKey。这样,一个设备的密钥被破解也不会造成其他设备的安全性危险。创建那些密钥的过程中,密钥不允许通过公开可用信息获得(例如节点地址)。
File renamed without changes.
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,6 @@

下面这张图展示了beacon接收时隙和ping时隙。

![](Pictures/lorawan_classb_rx_ping_slot_timing.png)
![](/img/lorawan_classb_rx_ping_slot_timing.png)

在这个示例中,指定beacon周期是128秒,ping接收时隙的周期是32秒。大部分时候server并没有使用ping时隙,因此终端可以在接入信道时监听下是否有前导码,如果没有则立即关闭接收窗口。如果监测到前导码,则射频会持续接收,直到下行帧解调完毕。MAC层随后处理数据帧,检查确认地址域匹配和MIC校验有效之后再转发给应用层。
File renamed without changes.
File renamed without changes.
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes

0 comments on commit 5a17d37

Please sign in to comment.