RFM95 LoRa模块sx1276技术资料包

+-----------------------------------------------------------------------------+ | SX12xx drivers V2.1.0 SX12xx 驱动 V2.1.0| +-----------------------------------------------------------------------------+ This package currently supports the following radio drivers: 此包目前支持一下无线驱动 - SX1232 - SX1272 - FSK modem 频移键控模式 - LoRa modem ( Application default ) lora模式 (默认应用) - SX1276 - FSK modem - LoRa modem ( Application default ) 1. Introduction 1.介绍 ------------------------------------------------------------------------------- The SX12xx drivers are included in a project made for the SX12xxEiger platform. SX12XX驱动包含一个基于SX12XX平台的工程中 The SX12xxEiger platform is based on the OPEN4 platform from RAISONANCE. 这个 SX12xxEiger 平台 是基于开源的RAISONANCE The platform can use a STM32F103, a STM32F407 or a STM32F429 microcontroller ( ARM Cortex-M based microcontrollers ). 这个SX12XXEiger平台 可以使用STM32F103，STM32F407 或者STM32F429 微型控制器(ARM cortex-M内核微型控制器) Semtech has done an extension board for the OPEN4 platform which enables the control of the SX12xx RF chip SM modules. Semtech公司已经为OPEN4平台可以控制SX12XX射频芯片做了一个扩展板 The project included is a RIDE 7 project. RIDE is an IDE made by RAISONANCE. 这个工程包含了一个RIDE 7工程，RIDE是一个通过RAISONANCE设计的IDE The project is also compatible with KEIL toolchain from ARM. The user can select either of the project depending of its toolchain. 这个工程也兼容keil for arm工具，用户可以选择不同的工具 The project contains the low level drivers needed to control the extension board peripherals as well as the SX12xx RF chip drivers. The demonstration application is a simple PING-PONG. 该工程包括控制扩展板外设的底层应用程序以及sx12xx射频芯片的驱动程序，这个演示程序是一个简单的 乒乓球实例 By default the PING-PONG app acts as Master. If another Master is already running the application will switch automatically to Slave and the PING-PONG starts. 默认这个乒乓应用作为主机，如果另一个主机已经运行了将会自动的切换为从机，乒乓开始 2. Radio drivers description 2.无线驱动描述 ------------------------------------------------------------------------------- The radio interface for the application is manged by the src\radio\radio.c file. 应用程序的无线接口在src\radio\radio.c文件中 The RadioDriverInit function must be updated with selected radio ( SX1232, SX1272, SX1276 ) functions. 无线驱动初始化功能必须根据选择的无线(SX1232,1272,1276)功能更新 The drivers have been made to operate on several hardware platforms: 这个驱动已经可以在以下几个平台运行 - the SX12xxEiger platform - the SX12000DVK platform - the "Bleeper" The radio selection is done by commenting/uncomenting the USE_SX12XX_RADIO definitions in src\platform\platform.h file 无线的选择是在 src\platform\platform.h文件中 Example: 例如 In order to select SX1272 with LoRa modem one must modify 为了选择SX1272工作在lora模式，一下必须修改 src\platform\platform.h file as follows: /*! * Radio choice. Please uncomment the wanted radio and comment the others *无线选择，请将需要的去掉注释 */ //#define USE_SX1232_RADIO #define USE_SX1272_RADIO //#define USE_SX1276_RADIO In the case of the SX1276, it is also essential to select the module connected. 在SX1276事例中这也是必不可缺少的选择模块连接 This is due to the fact that there are three different module with different RF matching tailored for different frequency bands. 基于事实，这里有三个不同的模块具有不同的RF来匹配不同的频段 /*! * Module choice. There are three existing module with the SX1276. 这里有三个已经存在的SX1276模式 * Please set the connected module to the value 1 and set the others to 0 请选择一个模式设置为1，其他的设置为0 */ #define MODULE_SX1276RF1IAS 0 #define MODULE_SX1276RF1JAS 0 #define MODULE_SX1276RF1KAS 1 For SX1272 and SX1276 radio devices, one must also choose the modem to be used. 如果是SX1272和SX1278 无线驱动，必须选择一个模式使用 In order to select the LoRa modem driver one must modify src\radio\radio.h as follows: 为了选在Lora模式驱动，一下必须修改 在src\radio\radio.h文件中 /*! * SX1272 and SX1276 General parameters definition SX1272和SX1276 公用的参数定义 */ #define LORA 1 // [0: OFF, 1: ON] The drivers can also 2.1 Specific radio drivers description 2.1 特殊的无线驱动描述 ------------------------------------------------------------------------------- The specific radio driver is split in several parts in order to ease the portability. 这个特殊的无线驱动为了方便一直已经分割成了几块 2.1.1 SX1232 driver 2.1.1 SX1232 驱动 ------------------------------------------------------------------------------- The SX1232 driver is split in 2 parts SX1232驱动已经分割成了2块 1. Generic SX1232 driver. 1. 通用的SX1232 驱动 ( src\radio\SX1232.c and src\radio\SX1232-Misc.c ) 2. SX1272 HAL ( Hardware Abstraction Layer ). 2. SX1272 硬件抽象层 ( src\platform\sx12xxEiger\SX1272-Hal.c ) 1. The generic SX1232 driver implements at least the functions required by the RadioDriver structure defined in src\radio\radio.h file 1. 这个通用的SX1232 驱动实现最基本的功能 需要通过定义在src\radio\radio.h文件中的无线驱动结构体 In order to change generic settings one must modify the following parameters in file src\radio\SX1232.c 为了改变通用的设置一下在src\radio\SX1232.c文件中的参数必须修改 The default parameters are all set into a structure which is fairly easy to update for any system. 这些参数都设置进了结构体，这样在任何系统中更新起来非常的简单 tFskSettings FskSettings = { 870000000, // RFFrequency RF频率 9600, // Bitrate 比特率 50000, // Fdev 20, // Power 发射功率 100000, // RxBw 接收频带宽度 150000, // RxBwAfc 接收频率自动控制 true, // CrcOn CRC校验标志位 true, // AfcOn 自动频率控制标志位 255 // PayloadLength 有效符合长度 }; REMARK: All other parameters can be changed by modifying the SX1232Init function located in src\radio\SX1232.c file 注意：所有其他参数可以通过修改位于src\radio\SX1232.c文件中的SX1232Init初始化功能修改 2. The HAL makes the SX1232 driver platform independent. 2.硬件抽象层使SX1232驱动平台独立 One must modify each function inside this file 必须修改每一个包含在这个文件中的功能 ( src\platform\sx12xxEiger\SX1232-Hal.c ) 进而试用所使用的平台 ( src\platform\sx12xxEiger\SX1232-Hal.c ) according to the platform used. 2.1.2 SX1272 driver version 2.0.0 2.1.2 SX1272 驱动版本 2.0.0 ------------------------------------------------------------------------------- The SX1272 driver is split in 4 parts 这个SX1272驱动被分割成了4块 1. Generic SX1272 driver. 1. 通用的 SX1272驱动(驱动调用接口) ( src\radio\SX1272.c ) 2. SX1272 FSK modem driver. 2. FSK调制模驱动 ( src\radio\SX1272-Fsk.