上一周我們開通了「軟件包大賞」欄目，第一期推薦的——LIBMODBUS軟件包（ps：點擊即可跳轉查看第一期）獲得了很多開發者的好評，還有很多人留言表示libmodbus的代碼非常易懂，軟件包也非常好用他們很喜歡。在此，我們為廣大開發者感謝一下libmodbus軟件包貢獻者——南京工程學院學生馬龍偉。也希望有余力者也可以積極的參與到軟件包貢獻中來。

本周，我們為大家精選的SX12XX Lora芯片軟件包出自RT-Thread社區的老伙伴——樊曉杰之手，不久之后他還會推出下一版的軟件包哦~ 下面，就進入正文吧：

RT-Thread新增の軟件包 / 2

0130

軟件包貢獻者：樊曉杰

資深嵌入式工程師，RT-Thread 死忠粉

樊曉杰，RT-Thread 忠實粉絲，也是我們留言區的老面孔。搞嵌入式相關產品已有5年，目前從事IoT嵌入式設備信息安全相關開發工作。

在2014年時候，第一次聽說了RT-Thread，當時想利用業余時間DIY一個聯網的收音機，在網絡上搜索相關信息，就加到了魔笛的那個網絡收音機的群里，嘗試著熟悉代碼，在stm32103上跑，但由于水平有限，當時覺得入門的確有困難，然后就沒有下文了。

再一次聽說RT-Thread是2017年，在北航的嵌入式專家何小慶老師舉辦的嵌入式聯誼會上。那年的聯誼會邀請到了慶科mico ,華為LiteOS,還有RT-Thread的大咖，共同探討IoT OS 的相關話題，我也是在那時候見到熊大真人，最后還向他咨詢了嵌入式AI相關の問題。也因為那次的機緣，開始持續關注RT-Thread 進展，參見線下活動、線上學習營、做分享等，到現在成為忠實粉絲，成為開發者，積極貢獻代碼，想想也是緣分啊，挺有意思的。

在我眼里，RT-Thread 開源技術社區，是一個真正可以提高開發者的水平的社區，無論是源碼 ，還是開發文檔，都是絕好參考資料，都可以在反復的閱讀實踐中，有所收獲，有所提高。尤其是，這里聚集了國內樂于分享的牛人，可以一起溝通交流。看到這么多厲害的榜樣，便也立志要和他們一樣，在技術領域深耕并成為在嵌入式系統研發領域的高手。（★論壇地址：https://www.rt-thread.org/qa/forum.php）與此同時，也愈發感覺學好、用好RT-Thread為它投入時間，值得！最后，再次感謝RT-Thread 團隊為營造這么好的開源技術社區所有的付出！你們就是我的榜樣！接下來，就從應用場景入手聊一聊這個軟件包吧

SX12XX Lora

圖片來源網絡

1、軟件包簡介：

SX12XX 軟件包是基于 semtech 官網Firmware Drivers V2.1.0代碼庫的移植實現，目前只支持 SX1278 LoRa設備。該軟件包在原代碼庫功能的基礎上，對接 RT-Thread SPI 設備驅動框架，實現參數的配置和數據的讀取。

項目地址：http://packages.rt-thread.org/itemDetail.html?package=sx12xx（請復制至外部瀏覽器打開）

使用背景：

使用低功耗廣域網 Lora 技術的場景越來越多，是物聯網時代不可或缺的無線傳輸技術，功耗低，傳輸距離遠，組網方便，是它的顯著特點。使用這個軟件包，可以通過RT-Thread SPI設備驅動框架將Semtech SX12XX 系列的 Lora 芯片快速驅動起來，后續可方便的驗證兩個Lora 模塊的遠通信距離及與Lora 網關之間的通信，也是這個軟件包下一個版本的目標。

1.1 目錄結構：

SX12XX 軟件包目錄結構如下所示：

1.2許可證：

SX12XX 軟件包遵循 Apache-2.0 許可，詳見 LICENSE 文件。

1.3依賴：

RT-Thread 3.1.1+

SPI 驅動：sx12xx 設備使用 SPI 進行數據通訊，需要系統 SPI 驅動框架支持；

PIN 驅動：用于處理設備復位和中斷引腳；

2、獲取軟件包

使用 SX12XX 軟件包需要在 RT-Thread 的包管理中選中它，具體路徑如下：

1RT-Threadonlinepackages2peripherallibrariesanddrivers--->3sx12xx:SemtechLoRaRFchipdriverlibrary--->

進入 sx12xx 軟件包的配置菜單按自己的需求進行具體的配置

1sx12xx:SemtechLoRaRFchipdriverlibrary---> 2SX12XXdevicetype(SX1278LSD4RF-2F717N30)---> 3SX12XXdeviceconfigure---> 4(spi10)SPIdevicename 5(10)ResetPINnumber 6(103)DO0PINnumber 7(104)DO1PINnumber 8(105)DO2PINnumber 9(106)DO3PINnumber10(107)DO4PINnumber11(108)DO5PINnumber12[]Enablesx12xxsample13Version(latest)--->

SX12XX device type：配置支持的設備類型（目前只支持 SX1278 利爾達 LSD4RF-2F717N30 LoRa 模塊 ）

SX12XX device configure：配置使用設備的參數

SPI device name：配置使用 SPI 的設備名稱（注意需設置為非 SPI 總線設備）

Reset PIN number：配置設備連接的復位引腳號（根據實際使用引腳號修改）

DO0~5 PIN number：配置設備連接的中斷引腳號（同上）

Enable sx12xx sample： 配置使用示例代碼

Version：軟件包版本選擇

3、使用 軟件包:

3.1 SX12XX 軟件包初始化函數如下所示：

1intsx12xx_init（void）；

該函數不支持組件初始化，函數主要完成功能有，

設置 LoRa 調制模式 ；

設備配置和引腳初始化（配置 SPI 設備，配置復位和中斷引腳）；

LoRa 參數配置和初始化（RFFrequency , Power, SignalBw, SpreadingFactor,ErrorCoding 等）；

3.2 MSH 測試命令

如果開啟 sx12xx 軟件包示例程序，就會導出 sx12xx_test 命令到控制臺。設備上電初始化完成，在控制臺調用測試命令，將會打印如下所示：

1msh/>sx12xx_test2sx12xxinitsucceed##獲取設備句柄，初始化Lora成功3versioncodeofthechipis12##chipcode信息4SX1278Loraparametersare:##如下為主要Lora設置參數信息5RFFrequencyis870000000##頻率6RFPoweris14##發射功率7SignalBwis9##信號帶寬8SpreadingFactoris7##擴頻因子9sx12xxspicheckok!##SPI測試完成

4、常見問題

SPI 設備初始化時找不到設備問題

1spisamplerunfailed!cant'tfindspi12device!

出現上述問題，可能原因是 ENV 中配置 SX12XX 使用的 SPI 設備類型不正確，可以在添加 SX12XX 軟件包之前在 FinSH 中使用list_device查看當前可用 SPI 設備名稱，如果 BSP 工程中沒有 SPI 設備或者只有 SPI 總線設備，需要手動在驅動中添加 SPI 設備，并正確配置 SX12XX 軟件包中使用的 SPI 設備名稱。

5、注意事項

獲取軟件包時，需要注意正確配置使用的 SPI 設備名稱、復位引腳號和中斷引腳號；

軟件包目前處于beta測試階段, 推薦在 menuconfig 選項中選擇latest版本