semtech驱动源码SX12xxDrivers-2.0.0

+-----------------------------------------------------------------------------+ | SX12xx drivers V2.0.0 | +-----------------------------------------------------------------------------+ This package currently supports the following radio drivers: - SX1232 - SX1272 - FSK modem - LoRa modem ( Application default ) - SX1276 - FSK modem - LoRa modem ( Application default ) 1. Introduction ------------------------------------------------------------------------------- The SX12xx drivers are included in a project made for the SX12xxEiger platform. The SX12xxEiger platform is based on the OPEN4 platform from RAISONANCE. The platform can use a STM32F407 or STM32F103 microcontroller ( ARM Cortex-M based microcontrollers ). Semtech has done an extension board for the OPEN4 platform which enables the control of the SX12xx RF chip SM modules. The project included is a RIDE 7 project. RIDE is an IDE made by RAISONANCE. The project is also compatible with KEIL toolchain from ARM. The user can select either of the project depending of its toolchain. 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. 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 ------------------------------------------------------------------------------- The radio interface for the application is manged by the src\radio\radio.c file. The RadioDriverInit function must be updated with selected radio ( SX1232, SX1272, SX1276 ) functions. 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 Example: In order to select SX1272 with LoRa modem one must modify 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. This is due to the fact that there are three different module with different RF matching tailored for different frequency bands. /*! * 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 */ #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. In order to select the LoRa modem driver one must modify src\radio\radio.h as follows: /*! * SX1272 and SX1276 General parameters definition */ #define LORA 1 // [0: OFF, 1: ON] The drivers can also 2.1 Specific radio drivers description ------------------------------------------------------------------------------- The specific radio driver is split in several parts in order to ease the portability. 2.1.1 SX1232 driver ------------------------------------------------------------------------------- The SX1232 driver is split in 2 parts 1. Generic SX1232 driver. ( src\radio\SX1232.c and src\radio\SX1232-Misc.c ) 2. SX1272 HAL ( Hardware Abstraction Layer ). ( 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 In order to change generic settings one must modify the following parameters in file 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 9600, // Bitrate 50000, // Fdev 20, // Power 100000, // RxBw 150000, // RxBwAfc true, // CrcOn true, // AfcOn 255 // PayloadLength }; REMARK: All other parameters can be changed by modifying the SX1232Init function located in src\radio\SX1232.c file 2. The HAL makes the SX1232 driver platform independent. One must modify each function inside this file ( src\platform\sx12xxEiger\SX1232-Hal.c ) according to the platform used. 2.1.2 SX1272 driver version 2.0.0 ------------------------------------------------------------------------------- The SX1272 driver is split in 4 parts 1. Generic SX1272 driver. ( src\radio\SX1272.c ) 2. SX1272 FSK modem driver. ( src\radio\SX1272-Fsk.c and src\radio\SX1272-FskMisc.c ) 3. SX1272 LoRa modem driver. ( src\radio\SX1272-LoRa.c and src\radio\SX1272-LoRaMisc.c ) 4. SX1272 HAL ( Hardware Abstraction Layer ). ( src\platform\sx12xxEiger\SX1272-Hal.c ) 1. The generic SX1272 driver implements at least the functions required by the RadioDriver structure defined in src\radio\radio.h file. It offers also the same interface for the FSK or the LoRa modem. In order to choose which modem to use one must modify the src\radio\radio.h file as follows: - For FSK modem #define LORA 0 - For LoRa modem #define LORA 1 2. The FSK modem driver handles the SX1272 as a FSK modem In order to change generic FSK modem settings one must modify the following parameters in file src\radio\SX1272-Fsk.c tFskSettings FskSettings = { 870000000, // RFFrequency 9600, // Bitrate 50000, // Fdev 20, // Power 100000, // RxBw 150000, // RxBwAfc true, // CrcOn true, // AfcOn 255 // PayloadLength (set payload size to the maximum for // variable mode, else set the exact payload length) }; REMARK: All other parameters can be changed by modifying the SX1272FskInit function located in src\radio\SX1272-Fsk.c file 3. The LoRa modem driver handles the SX1272 as a LoRa modem In order to change generic LoRa modem settings one must modify the following parameters in file src\radio\SX1272-LoRa.c tLoRaSettings LoRaSettings = { 870000000, // RFFrequency 20, // Power 2, // SignalBw [0: 125 kHz, 1: 250 kHz, 2: 500 kHz, // 3: Reserved] 7, // SpreadingFactor [6: 64, 7: 128, 8: 256, 9: 512, // 10: 1024, 11: 2048, 12: 4096 chips] 2, // ErrorCoding [1: 4/5, 2: 4/6, 3: 4/7, 4: 4/8] true, // CrcOn false, // ImplicitHeaderOn 1, // RxSingleOn 0, // FreqHopOn 4, // HopPeriod 100, // TxPacketTimeout 100, // RxPacketTimeout 4 // PayloadLength }; 4. The HAL makes the SX1272 driver platform independent. One must modify each function inside this file ( src\platform\sx12xxEiger\SX1272-Hal.c ) according to the platform used. 2.1.3 SX1276 driver version V2.0.0 ------------------------------------------------------------------------------- The SX1276 drivers are very similar to the SX1272 drivers. In fact, most of the drive