k Easy-link 編程指南
項目名稱 ：2 SX1212 M 433M 標準模塊
項目型號 ： LSD4RF-2H310N10
文 件 修 改 記 錄 臺 帳
項目名稱 Easy-link 編程指南 項目型號 LSD4RF-2H310N10
編制人 蔣俊杰 編制日期 2015-08
審核人 孫香濤、于海波 審核日期 2015-08
版本號 修改日志 修改人 審核人
修改日期
（XXXX-XX-XX）
V1.0 新建 蔣俊杰 于海波 2015-08-21
目 目 錄
第一章 簡介..............................................................................................................................................................1
第二章 快速建立通信測試試驗.............................................................................................................................. 2
第三章 例程流程圖.................................................................................................................................................. 4
第四章 移植..............................................................................................................................................................5
1、修改宏定義.................................................................................................................................................. 5
2、SPI 初始化................................................................................................................................................... 6
3、MCU 硬件功能的移植................................................................................................................................... 6
4、建立測試工程.............................................................................................................................................. 8
第五章 更改無線模塊的通信參數........................................................................................................................ 10
1、設置載波頻率............................................................................................................................................ 10
2、設置波特率................................................................................................................................................ 11
3、設置同步字................................................................................................................................................ 12
4、定義是否打開 CRC..................................................................................................................................... 13
5、數據包長度定義........................................................................................................................................ 13
6、數據包數據定義........................................................................................................................................ 14
7、調制方式 FSK 與 OOK 的切換.................................................................................................................... 14
第六章 LSD4RF-2H310N10 例程部分代碼介紹......................................................................................................15
1、SX1212_RF.h.............................................................................................................................................. 15
2、SX1212_RF.c.............................................................................................................................................. 15
3、SX1212_RF.c.............................................................................................................................................. 15
4、讀寫 LSD4RF-2H310N10 寄存器的值........................................................................................................ 15
5、清除 LSD4RF-2H310N10 的 FIFO............................................................................................................... 15
6、設置 LSD4RF-2H310N10 的工作模式........................................................................................................ 16
7、復位 LSD4RF-2H310N10 模塊.................................................................................................................... 16
8、初始化 LSD4RF-2H310N10 模塊................................................................................................................ 16
9、發送數據包................................................................................................................................................ 17
10、接收數據包.............................................................................................................................................. 17
敬告用戶:................................................................................................................................................................17
1
章 第一章 簡介
本編程指南主要講解了 LSD4RF-2H310N10 easy-link（簡單通信）庫函數調
用的應用。方便用戶快速建立測試工程，進行簡單的通信。
Easy-link 為用戶提供了一個數據包長度可變的通信測試代碼。代碼中有關
無線模塊的文件主要包括了 SX1212_RF.h、SX1212_RF.c 文件。主函數 SX1212_tx
（SX1212_rx）調用了對應文件里的函數，為用戶調用函數和測試提供了參考。
Easy-link 代碼完全用的標準 C 語言寫的，用戶只需更改一些宏定義和
SX1212_RF 配置參數就可以方便地應用于其他 MCU 平臺。
提示：本程序只是為用戶提供一個簡單易用的通信測試代碼，當用戶測試
通信成功后，可以適當地根據自己的需求更改一些參數。
經測試，本代碼在 MSP430F4152 平臺上正常運行。
實物連接圖，按照藍色連接線直接插入。
Msp430 底板
無線模塊
2
章 第二章 快速建立通信測試試驗
為了使客戶更快更方便的使用我們的產品，我們將程序做了統一的整合規
范，讓客戶更容易操作起來，提高開發進度。客戶只需要三步即可完成 easy-link
（簡單通信）數據收發。（適用于 MSP430F4152）
步驟一：
首先根據自己使用的（MCU）單片機，修改對應 msp430_sys.h 中的
LSD_SPI_SIMO 、 LSD_SPI_SCK 、 LSD_SPI_SOMI 、 LSD_SPI_NSS_CONFIG 、
LSD_SPI_NSS_DATA、LSD_RF_IRQ0、LSD_RF_IRQ1 的宏定義，例如如下。
3
根據不同平臺，根據自己實際用的射頻IO 口，修改相應的 IO 口定義 。
本測試代碼基于 MSP430F4152 平臺。
步驟二 ：
1、建立發送測試 SX1212_tx.c 工程，在 workspace 處選擇 SX1212_tx，
并且選中 SX1212_tx.c 為當前文件編譯。下載到一個控制底板（MSP430）
2、建立接收測試 SX1212_rx.c 工程，在 workspace 處選擇 SX1212_rx，
并且選中 SX1212_rx.c 為當前文件編譯。下載到另一個控制底板（MSP430）
步驟三 ：
完成后，上電模塊可自動進行數據收發。可在該中斷函數中增加 LED 亮滅
的功能來觀察通信效果。如下，
4
章 第三章 例程流程圖
初始化后進入空閑狀態，如想進入接收狀態，可以調用 LSD_RF_RXmode();進入
接收狀態，如想進入發送發送數據，可以調用 SendRfFrame((unsigned char
*)(&RF_Pkt), sizeof(RF_Pkt))函數，接收和發送可以直接切換，也可以進入
空閑后，再切換。
注意：每次完成發送或接收會自動進入低功耗狀態。
上電
初始化
空閑
發送
接收
InitSX1212();
LSD_RF_RXmode();
SendRfFrame((unsigned char *)(&RF_Pkt),
LSD_RF_RXmode();
SendRfFrame((unsigned char *)(&RF_Pkt),
5
章 第四章 移植
1 1 、 修改宏定義
因為無線模塊是通過 SPI 總線控制的，所以首先得移植模擬的 SPI。找到頭
文件 msp430_sys.h,根據自己的需求修改宏定義 SIMO、SCK、SOMI、NSS_CONFIG、
NSS_DATA 對應的 IO 口。此舉決定了 SPI 通信成功與否。
根據需要，在 msp430_sys.h 中更改 IRQ0 的宏定義對應的 IO 口，這決定了
無線模塊能否正常發送接收。IRQ0 連接到 MCU 具有外部中斷的 IO 口上。IO 口
中斷開，選擇上升沿觸發中斷。
這六處宏定義是與 MCU 相連的最基本的五個接口，請務必調試成功。如果
換到其他平臺請仔細區別各個平臺的 IO。例如普通 51 單片機的 P0,P1,P2 端口
6
沒有方向寄存器和功能選擇寄存器等。
2 2 、I SPI 初始化
在 SX1212_RF.c 文件中，定義了 SPI 的初始化，
設置了 SPI 的 IO 口的方向，輸入輸出初始電平。如果用的其他平臺的 MCU，保
證自己用的 IO 口功能就行。（初始化 SIMO、SCK、SOMI、NSS_CONFIG、NSS_DATA）
3 3 、U MCU 硬件功能的移植
本示例程序用到了 MSP430F4152 的定時器 TIMERA 中斷功能，和端口 PORT1
的外部中斷功能。在非 MSP430 平臺上的時候注意這個功能的移植，因為無線模
塊的發送和接收都是在中斷函數里進行的。在SX1212_tx.c 文件里，
（1 1 ） 定時發送一包數據
7
（2 2 ） 中斷接收一包數據
8
4 4 、 建立測試工程
（1 1 ） 建立發送測試 c SX1212_tx.c 工程 ，在 workspace 處選擇 SX1212_tx，
并且選中 SX1212_tx.c 為當前文件。
首先初始化 MCU。
然后初始化無線模塊 SX1212，如果初始化失敗，MCU 會重新啟動。（提示：
失敗一般是 SPI 通信不正常，請確保 SPI 能正確通信。其次，再檢查硬件連接
正確與否。最后再看模塊有無損壞）
測試通過后，建立數據包。
MCU 進入低功耗。
編譯通過后，下載到一個控制底板，作為發送方。
（2） 、 建立接收測試 c SX1212_rx.c 工程 ，在 workspace 處選擇 SX1212_rx，
并且選中 SX1212_rx.c 為當前文件。
首先初始化 MCU。
然后初始化無線模塊 SX1212，如果初始化失敗，MCU 會重新啟動。（提示：
9
失敗一般是 SPI 通信不正常，請確保 SPI 能正確通信。其次，再檢查硬件連接
正確與否。最后再看模塊有無損壞）
測試通過后，模塊進入接收模式。
MCU 進入低功耗。
編譯通過后，下載到另一個控制底板，作為接收方。
完成后，進行通信測試，如果不成功，請排查之前的步驟有沒有做好。直到
通信成功。
通信成功的現象：
A 模塊發送一包數據包紅燈閃爍，B 模塊接收到數據包黃燈閃爍，B 模塊并將
數據回傳給 A 模塊，A 模塊接收到回傳數據后黃燈閃爍。
A 模塊
B 模塊
A 發送數據包
B 發送回傳數據包
10
章 第五章 更改無線模塊的通信參數
在通信成功的前提下，可以到這章，了解怎么更改無線模塊的通信參數。
首先，到 SEMTECH 官網下載軟件 SX1212 Start Kit，方便寄存器的配置。
該軟件打開后，整個界面是灰色的，不能操控。同時按下 Ctrl+Alt+N,可以解除
灰色限制，整個界面都可以操作。
1 1 、 設置載波頻率
點擊在如上圖所示的紅色圓圈內的 McParam，同時在下面的紅色橢圓內輸入
頻率值，例如，434 000 000，然后按下 Enter 鍵，你會看到如圖所示變為紅色
的數值，該數值表示當前載波頻率對應的數值。
載波頻率由四個寄存器控制，分別是 REG_MCPARAM1 地址 0x00、REG_R1 地
址 0x06、REG_P1 地址 0x07、REG_S1 地址 0x08。其地址右邊的數值即當前寄存
11
器配置的數值。載波頻率設置好后，在 SX1212_RF.c 文件里找到對應的寄存器，
修改 REG_MCPARAM1、REG_R1、REG_P1、REG_S1 右邊的數值，下載程序，模塊就
會以 434MHZ 的載波頻率工作了。如圖，
2 2 、 設置波特率
回到軟件 SX1212 Start Kit，在如下紅色圓圈內輸入波特率，以及頻偏 Fdev。
更改參數 Fdev 時，對應的 RxBW 也應做相應的修改，建議用戶參考 SX1212 的
DATASHEET，因為這兩個參數會影響模塊的通信效果。
修改成 25000 的波特率后，其寄存器對應的數值會變為紅色
12
同理，到 SX1212_RF.c 文件里去更改波特率，如圖，
如果想更改其他參數，請結合數據手冊和SX1212 Start Kit 上位機軟件，
將改好的數值更新到 SX1212_RF.c 頭文件中，這些參數會在無線模塊的初始化
中完成。
3 3 、 設置同步字
對照數據手冊，設置 REG_SYNCCONFIG，
本歷程中同步字默認設置為如下圖所示，
如果需要更改，請結合上位機軟件，在 packet→sync 對應的處輸入你想設
置的數值，查看 REG 表中對應的數值，將數值更新到 SX1212_RF.c 文件中。
13
4 4 、 定義是否打開 CRC
由數據手冊可以看到
5 、 數據包長度定義
因為之前數據設的可變模式，所以它的值盡量設為較大值，這里設置為 64
14
個字節
由數據手冊可以看到，
6 6 、 數據包數據定義
這里隨意定義了一個 64 個字節的發送數據包，用戶可根據自己的需求做改動。
7 7 、 調制方式 K FSK 與 與 K OOK 的切換
本例程默認為 FSK 調制方式。
在文件 SX1212_RF.c 中，已設置了初始值，如下，
對照數據手冊，該值的含義是：數據包模式、FSK。
調制方式的切換，同理我們可以利用上位機來設置調制方式。
注意：保證收發雙方的這些寄存器設置必須一致。沒有提及的參數，在通
信沒有成功之前，不建議修改。
15
章 第六章 LSD4RF-2H310N10 例程部分代碼介紹
1 1 、 SX1212_RF.h
全是芯片 SX1208 內部寄存器的宏定義，方便用戶的理解和使用。禁止修改。
2 2 、 SX1212_RF.c
首先定義了一個 SX1212 的結構體。該結構體包含了 SX1212 的寄存器地址
和寄存器值。方便用戶配置寄存器，一個地址對應一個寄存器數值。
3 3 、 SX1212_RF.c
改文件里包含了 SX1212 的驅動程序。比如，模擬 SPI，發送數據包，切換
模式等函數。
4 4 、 讀寫 0 LSD4RF-2H310N10 寄存器的值
5 5 、 清除 0 LSD4RF-2H310N10 的 的 FIFO
16
6 6 、 設置 0 LSD4RF-2H310N10 的工作模式
7 7 、 復位 0 LSD4RF-2H310N10 模塊
8 8 、 初始化 0 LSD4RF-2H310N10 模塊
17
9 9 、 發送數據包
10 、 接收數據包
|
QQ好友和群
QQ空間
騰訊微博
騰訊朋友
收藏
淘帖
頂
踩
