add communication/lora.md

docs/doc/communication/LORA.md

@@ -1 +1,132 @@
 # LORA
+
+## 模块介绍
+
+### CRF1278-L3 Lora模块
+
+<center>
+
+![LORA](./imagesrc/lora.png)
+
+</center>
+
+CRF1278-L3模块是一款高性能、低功耗、远距离的微功率射频前端数据收发模块，模块采用未调制载波来进行线性调频的LoRa扩频调制技术，使能量分散到更广泛的频段，完美解决了小数据量在复杂环境中的超远距通信问题。该模块具有体积小、功耗低、传输距离远、抗干扰能力强等特点，可根据实际应用情况有多种天线方案可供选配，模块未配置MCU 芯片，可方便客户二次开发，客户开发过程中不需要了解太复杂的射频知识，只需要调试底层SPI通信就可以轻松的应用此模块。  
+
+相对传统调制技术，CRF1278-L3模块在抑制同频干扰的性能方面也具有明显优势，解决了传统设计方案无法同时兼顾距离、抗扰和功耗的弊端。  
+
+模块尺寸为16.6mm×16.6mm×2.7mm，接口类型为邮票孔（2mm间距），通讯距离为5KM@250bps（空旷环境下最大功率）。
+
+### 规格参数
+
+<table>
+<tr>
+<th>参数</th>
+<th>额定值</th>
+<th>单位</th>
+<th>备注</th>
+</tr>
+<tr>
+<td>电源电压</td>
+<td>2.0~3.6</td>
+<td>V</td>
+<td>在20dB配置下电压不能小于2.4V</td>
+</tr>
+<tr>
+<td>工作湿度</td>
+<td>10%~90%</td>
+<td>/</td>
+<td>无冷凝</td>
+</tr>
+<tr>
+<td>工作频率</td>
+<td>455~510</td>
+<td>MHz</td>
+<td>可在主程序中配置</td>
+</tr>
+<tr>
+<td>初始频偏</td>
+<td>±5</td>
+<td>KHz</td>
+<td>在25°C下</td>
+</tr>
+<tr>
+<td>最大发射功率</td>
+<td>19±1</td>
+<td>dBm</td>
+<td>用户可编程自定义</td>
+</tr>
+<tr>
+<td>接收灵敏度</td>
+<td>-136</td>
+<td>dBm</td>
+<td>/</td>
+</tr>
+<tr>
+<td>调制方式</td>
+<td>LoRa/FSK/OOK</td>
+<td>/</td>
+<td>LoRa调制性能更优</td>
+</tr>
+<tr>
+<td rowspan="2">通信速率</td>
+<td>1.2~32.768kbps@OOK</td>
+<td>/</td>
+<td>用户可编程自定义</td>
+</tr>
+<tr>
+<td>0.2~37.5kbps@LoRa</td>
+<td>/</td>
+<td>低速率下（<5kbps）推荐使用LoRa调制</td>
+</tr>
+<tr>
+<td>通讯距离</td>
+<td>5Km@250bps</td>
+<td>/</td>
+<td>测试条件为最大输出功率及空旷环境</td>
+</tr>
+</table>
+
+### 模块引脚说明
+
+<center>
+
+![LORA COMPONENT](./imagesrc/lora_component.png)
+
+</center>
+
+| 引脚符号 | 功能说明 |
+| --- | --- |
+| SCK | SPI时钟 |
+| MISO | SPI串行数据输入\输出 |
+| MOSI | SPI串行数据输出\输入 |
+| NSS | SPI片选 |
+| NC | 悬空脚 |
+| GND | 地 |
+| ANT | 射频输出 |
+| VBAT | 电源 |
+| DIO5 | ModeReady、ClkOut |
+| DIO3 | CadDone、ValidHeader、PayloadCrcError |
+| DIO2 | FhssChangeChannel |
+| DIO1 | RxTimeout、FhssChangeChannel、CadDetected |
+| NRST | 硬件复位 |
+
+
+
+## 模块配置和代码树
+
+[*]　Using lora SX1278　　　　--->　(使用 lora SX1278)  
+　　　(spi10)　SX1278 spi device　(NEW)　　　　　--->                                                                                                    
+　　　(10)　RESET pin number of lora　(NEW)　　　--->                                                                                                               	   
+　　　(10)　DO0 pin number of lora　(NEW)　　　　--->                                                                                                      
+　　　(10)　DO1 pin number of lora　(NEW)　　　　--->                                                                                                      
+　　　(10)　DO2 pin number of lora　(NEW)　　　　--->                                                                                                      
+　　　(10)　DO3 pin number of lora　(NEW)　　　　--->                                                                                                      
+　　　(10)　DO4 pin number of lora　(NEW)　　　　--->                                                                                                      
+　　　(10)　DO5 pin number of lora　(NEW)　　　　--->
+
+
+<center>
+
+![LORA COMPONENT](./imagesrc/lora_config.png)
+
+</center>