在之前的项目中，一直使用 LoRa 通信。很早之前就想写写文章记录一下学习过程。怎奈一直是一知半解的状态，想写不敢写！LoRa 这个东西在国内用的貌似不是太多。
  对于无线通信，各个国家或者地区都有严格的限制。例如，我们国家就有<<中华人民共和国无线电频率划分规定>>。前两年，工信部出了个指导意见还是啥东西来着，差点把 LoRa 搞黄了！LoRa 是工作在免费频段的。关于免费频段各个国家或者地区是有区别的！我们国家的各种规定在工信部官网可以找到！废话不多说，想要了解 LoRa 是啥的自己去搜索，我们重点说用法！

LoRa 和 LoRaWAN

  在介绍使用之前，我们必须要先区分好这两个概念！LoRa 是低功耗广域网通信技术中的一种，而按照 LoRa 联盟官方白皮书《what is LoRaWAN》的介绍，LoRaWAN 是为 LoRa 远距离通信网络设计的一套通讯协议和系统架构。类比于我们的网络通信，LoRa 定了物理层，而 LoRaWAN 定义了 MAC 层、数据链路层。LoRaWAN 定义了一套通信系统的架构，底层使用的是 LoRa 通信。这个应该就和我们的网络协议栈差不多吧。
  在我们的实际使用中，我们可以仅仅使用 LoRa 进行最基本的通信，通信的应用层协议则有我们自己定义。当然，我们的通信只能和我们自己定义的应用层协议的设备通信。Semtech 出了好几款 LoRa 收发器芯片供我们选择。当然也可以按照 LoRaWAN 的要求来实现系统中的通信，这个就要复杂好多了，完整的 LoRaWAN 网络架构中包含了终端、网关、NS(网络服务器)、应用服务器这四个部分。

  当前有好多公司都出了各种各样的 LoRa 模块以及 LoRa 网关模块。我的环境是自己画的 LoRa 模块，使用了的芯片时 SX1276。我这里也不需要 LoRaWAN。

驱动

  首先，我们需要知道 Semtech 的 LORA 芯片支持 LORA 模式和 FSK 模式，所以驱动中是包含对这两种模式的处理的。目前，Semtech 官网有两款驱动，一款是旧的驱动，驱动内部只实现了对于 LoRa 芯片的基本操作，另一个款是最新的包含对 LoRa 芯片的基本操作和 LoRaWAN 定义的实现。老版驱动 Semtech 已经停止更新了，也不建议用在新的生成环境中。两种驱动对比如下图：

这里我们重点来介绍一下旧版的驱动。下面来具体说说移植！

驱动架构

驱动的架构并不复杂，如下图所示：

在初始化阶段，驱动内部首先将全部寄存器的值读取到 uint8_t SX1276Regs[0x70]; 中，而后所有接口的操作都是按照上面的图，先修改 uint8_t SX1276Regs[0x70]; 中的寄存器，然后在通过 SPI 将 uint8_t SX1276Regs[0x70]; 中的数据写入到芯片中。我们以 sx1276 为例来说明一下：

• sx1276.h/c：该文件主要是以上两种模式（LORA、FSK）的统一的对外接口。通过 radio.h 中宏 LORA 是否为 1 区分以上两种模式。此外该文件中还定义了一个与芯片中寄存器一一对应的全局变量 uint8_t SX1276Regs[0x70];。
• sx1276-LoRaMisc.c/h：该文件主要是提供一些 LORA 参数的设置接口
• sx1276-LoRa.c/h：该文件定义了 LORA 寄存器以及各种寄存器的具体数值、LORA 的初始化及配置，LORA 处理状态机。

下面是对各文件（夹）的一个简单的介绍：

 *          src
 *          │  main.c       这其中有个给出了使用方法（初始化、收发数据等），作为参考在自己的项目中使用。!!!知道如何测试后删除即可!!!
 *          ├─platform
 *          │  │  platform.h        在此文件中对驱动进行配置。!!!这个必须要保留!!!
 *          │  ├─bleeper            以下这些平台自己在移植时其实我们就需要其中的某个文件即可。所以所谓的平台对我自己的项目来说根本无用。
 *          │  ├─stm32libs          其他代码文件都是一些针对测试开发版的文件，我们不需要。
 *          │  ├─sx1200dvk          因为，我们自己的项目中必然有自己的实现。
 *          │  ├─sx1243ska          其实，最终我们就需要其中一个文件：xxx-Hal.c（根据自己的芯片类型）
 *          │  └─sx12xxEiger     <- 这里以它为例，我们只需要以下文件，其他平台（以上俩目录）的文件和该目录下类似。!!!都不需要使用，直接删除即可!!!
 *          │      │  sx1232-Hal.c
 *          │      │  sx1272-Hal.c
 *          │      │  sx1276-Hal.c   我们仅需要自己选择的芯片对应的硬件抽象层文件，根据自己的MCU修改里面的代码（各GPIO、函数中的SPI接口）即可。!! 函数名不能更改!!
 *          └─radio   这个是 LORA的驱动源码，针对每个不同信号芯片的不同调制模式都有独立文件。!!!必须根据自己的LoRa芯片选择对应文件。!!!
 *                  radio.c      对于不同LORA芯片的部分操作接口的封装。这两文件非常简单。
 *                  radio.h
 *                  !!-----这里省略其他文件，其他文件与以下文件类似。以sx1276来进行说明------!!
 *                  sx1276-Fsk.c     Fsk模式的源码文件，主要就是对Fsk模式下各寄存器的读写函数
 *                  sx1276-Fsk.h
 *                  sx1276-FskMisc.c  Fsk模式的参数配置函数
 *                  sx1276-FskMisc.h
 *                  sx1276-Hal.h    硬件抽象层对应的头文件，对应的.c文件在platform目录下，这俩文件主要就是初始化LORA使用的GPIO及SPI通信。函数在.h文件中以给出。只需要根据自己的平台实现.c文件即可。
 *                  sx1276-LoRa.c   LoRa 模式的源码文件，主要就是LORA模式下各寄存器的读写函数。注意：LoRa模式下可以读取Fsk模式的寄存器。
 *                  sx1276-LoRa.h
 *                  sx1276-LoRaMisc.c LoRa 模式的参数配置函数，用户可以直接使用该文件的中的函数对LoRa进行配置（例如频率、带款等等）。
 *                  sx1276-LoRaMisc.h
 *                  sx1276.c      主要是以上两种模式（LORA、FSK）的统一的对外接口。通过 radio.h 中宏 LORA 是否为 1 区分以上两种模式
 *                  sx1276.h

驱动文件整理

  移植的第一步就是整理源码文件。旧源代码在使用 Ride 7 作为 IDE（Ride 7 使用 gcc-arm 作为编译器）写出来的，所以在源码中有些 Ride 7 的文件。下面我们整理一下需要的驱动文件：

配置

移植的第二步就是修改驱动的配置项！

platform.h

  由于源码实际是一个 Ride 7 项目示例，同时针对多个测试平台（开发板）的，因此配置文件中有一些和测试平台相关的代码。我习惯于不再代码中残留一些无用的代码，所以该清理的清理。清理后如下：

/*!
 * Radio choice. Please uncomment the wanted radio and comment the others
 * or add/change wanted radio definition on the compiler Defines option
 * 这里其实就是选择使用的 LORA 芯片型号，我们使用的是 SX1278，其与SX1276基本一样。Semtech 给出的驱动源码中，SX1278 可以直接使用 SX1276 的驱动源码。
 * 后面也会看到，所有驱动文件的名字均为 SX1276 开头的文件名，却没有一个是 SX1278 开头的文件。具体原因也是这里所说的原因。
 * 但是，需要对源码进行一定的修改，具体修改见下面的说明！
 */
//#define USE_SX1232_RADIO
//#define USE_SX1272_RADIO
#define USE_SX1276_RADIO
//#define USE_SX1243_RADIO

/*!
 * Module choice. There are three existing module with the SX1276.
 * Please set the connected module to the value 1 and set the others to 0
 * 这个模块选择：这里主要是指Semtech官方给出的不同的外围电路设计用例。因为其给出的三种电路设计中，使用的芯片引脚等时有区别的。
 * 因此，这里需要根据硬件设计。来选择合适的模块。以下三种硬件电路设计用例，可直接在Semtech官网找到！
 * 以下几个宏值，仅在调用初始化时才会用到，具体可查看函数void SX1276LoRaInit( void );这里也需要注意：频率的问题，源码对于不同频率，
 * 其会选择不同的配置。
 */
#ifdef USE_SX1276_RADIO
#define MODULE_SX1276RF1IAS                         0
#define MODULE_SX1276RF1JAS                         0
#define MODULE_SX1276RF1KAS                         1
#endif

整理之后，就上面两个宏值是必须的！对于每个宏上面的注释已经很详细了，不再多说！

sx1276-Hal.c

  这个文件看名字就知道，负责实现驱动库与实际芯片的通信的封装。如果看源码中的示例文件，会发现其中也是很多和测试平台相关的配置。同样该清理的清理，最终该文件大体可以分为两大部分：

1. 包含自己需要的头文件
   
2. 实现必须的函数接口。函数接口总的可以分为四大类：

   1. LORA 芯片使用 MCU 的 IO 的配置及复位。函数 void SX1276InitIo(void) 用来初始化使用的各 IO。函数 void SX1276SetReset( uint8_t state ) 用来复位模块。

   2. SPI 通信使用的接口。LORA 芯片是使用 SPI 进行通信的。

      • void SX1276Write( uint8_t addr, uint8_t data );
      • void SX1276Read(uint8_t addr, uint8_t *data)
      • void SX1276WriteBuffer(uint8_t addr, uint8_t *buffer, uint8_t size)
      • void SX1276ReadBuffer( uint8_t addr, uint8_t *buffer, uint8_t size )
      • void SX1276WriteFifo( uint8_t *buffer, uint8_t size )
      • void SX1276ReadFifo( uint8_t *buffer, uint8_t size )

      我们只需要根据自己的 SPI 的配置，修改 void SX1276ReadBuffer( uint8_t addr, uint8_t *buffer, uint8_t size ) 和 void SX1276WriteBuffer(uint8_t addr, uint8_t *buffer, uint8_t size) 即可，其他几个接口都是直接调用上面这俩接口的！不知道为啥驱动库要放出这么多函数。

   3. LORA 芯片 独立 IO 的配置。LORA 芯片有几个 IO 是需要直接和 MCU 相连的，这些 IO 的高低状态指示了 LORA 芯片的一些工作状态。

      • inline uint8_t SX1276ReadDio0( void )
      • inline uint8_t SX1276ReadDio1( void )
      • inline uint8_t SX1276ReadDio2( void )
      • inline uint8_t SX1276ReadDio3( void )
      • inline uint8_t SX1276ReadDio4( void )
      • inline uint8_t SX1276ReadDio5( void )

      需要注意的是，根据我们的需求，以上 5 个 IO 并不一定全部使用。例如我的就只使用 DIO0、DIO1、DIO3。至于如果选择，在手册中有说明这 5 个 IO 的说明。

   4. 天线切换接口。inline void SX1276WriteRxTx( uint8_t txEnable )。在 Semtech 给出的设计原理图中，是需要进行天线状态的切换的！如果是买的其他厂家的现成的模块，可能不需要该函数，留空即可！

sx1276-Hal.h

  还是由于驱动测试遗留的问题，我们必须要修改该文件中的部分代码。清理一些测试过程中引入的文件，同时定义一个函数函数。具体如下：

这个文件如果设计的足够好的话，是不需要用户来更改的！

至此，LORA 的驱动移植完成了，接下来就是在自己的开发环境中添加使用的文件、头文件路径，然后编译即可！

使用

  驱动库通过 radio.h/c 对驱动库的接口进行了封装。正常的初始化、收发数据等都是使用 tRadioDriver 中的函数指针。当然，该结构体仅仅是封装了部分接口。有些功能接口我们还是需要直接使用对应驱动库头文件中的函数。

1. 首先调用初始化驱动库
   
2. 周期调用 Radio->Process() 以处理驱动库的状态机
   
3. 收发数据 Radio->GetRxPacket( const void *buffer, uint16_t size ); 和 Radio->SetTxPacket( const void *buffer, uint16_t size );

注意

1. 只有 LORA 参数都一致的情况下，两者才能通信！
2. 默然情况下，LORA 驱动内部是开启了低速率优化的。
   

参考

最后

以上就是老迟到酸奶为你收集整理的LoRa 之一 旧版驱动（sx12xxDrivers-V2.1.0）移植及驱动架构详解LoRa 和 LoRaWAN驱动驱动架构驱动文件整理配置使用注意参考的全部内容，希望文章能够帮你解决LoRa 之一 旧版驱动（sx12xxDrivers-V2.1.0）移植及驱动架构详解LoRa 和 LoRaWAN驱动驱动架构驱动文件整理配置使用注意参考所遇到的程序开发问题。

如果觉得靠谱客网站的内容还不错，欢迎将靠谱客网站推荐给程序员好友。