一、模块来源
二、规格参数
工作电压:2.0V-5.5V
工作电流:52mA~104mA
默认频率:433Mhz
发射功率:20dBm
参考通信距离:3km
控制方式:串口
以上信息见厂家资料文件
三、移植过程
我们的目标是将例程移植至开发板上【完成无线传输的功能】。首先要获取资料,查看数据手册应如何实现读取数据,再移植至我们的工程。
1、查看资料
通过MD0与MD1设置工作模式。
需要多个模块互传数据,则模块间的配置参数必须要一致。参数包括:空中速度、模块地址、通信信道。
参数的修改是通过上位机进行设置。具体步骤请参考快速操作指南。配置完成之后,只需要将模式设置为一般工作模式,即可进行透传。
2、引脚选择
使用串口2(串口2-TX=PA2,串口2-RX=PA3)
AUX引脚 用于无线收发缓冲指示和自检指示。它指示模块是否有数据尚未通过无线发出去,或已收到的数据是否 已通过串口全部发出,或模块正在初始化自检过程中。
工作状态切换时 AUX 时序变换:工作状态切换前应当检测 AUX 引脚状态,当 AUX 为低电平时,表示模块繁忙;当 AUX 输出高电平约 2ms 后,表示此时模块处于空闲状态,模块可以开始工作状态切换,低延时工作状态引脚 MD0、MD1 电平开始跳变,AUX 继续输出高电平约 3ms 后,模块进行状态切换,当 AUX 输出低电平,表示正在切换状态,AUX 输出高电平,并保持约 2ms 表示状态切换完成。
本案例是不需要进行工作模式切换,而是固定使用一般工作模式(MD0=0,MD1=0)故AUX悬空即可。
3、移植至工程
移植步骤中的导入.c和.h文件与传感器章节的【DHT11温湿度传感器】相同,只是将.c和.h文件更改为bsp_lora.c与bsp_lora.h。这里不再过多讲述,移植完成后面修改相关代码。
在文件bsp_lora.c中,编写如下代码。
/*
* 立创开发板软硬件资料与相关扩展板软硬件资料官网全部开源
* 开发板官网:www.lckfb.com
* 技术支持常驻论坛,任何技术问题欢迎随时交流学习
* 立创论坛:https://oshwhub.com/forum
* 关注bilibili账号:【立创开发板】,掌握我们的最新动态!
* 不靠卖板赚钱,以培养中国工程师为己任
* Change Logs:
* Date Author Notes
* 2024-04-02 LCKFB-LP first version
*/
#include "bsp_lora.h"
#include "stdio.h"
#include "string.h"
unsigned char LOAR_RX_BUFF[LOAR_RX_LEN_MAX];
unsigned char LOAR_RX_FLAG = 0;
unsigned char LOAR_RX_LEN = 0;
/************************************************************
* 函数名称:LOAR_USART_Init
* 函数说明:连接LOAR的初始化
* 型 参:bund=串口波特率
* 返 回 值:无
* 备 注:波特率根据你设置的内容来决定(默认波特率9600)
*************************************************************/
void LOAR_USART_Init(unsigned int bund)
{
GPIO_InitTypeDef GPIO_InitStructure;
RCC_APB2PeriphClockCmd(RCC_APB2Periph_AFIO|RCC_LORA_TX|RCC_LORA_RX,ENABLE);
GPIO_StructInit(&GPIO_InitStructure);
GPIO_InitStructure.GPIO_Pin = GPIO_LORA_TX;//TX引脚
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF_PP;
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
GPIO_Init(PORT_LORA_TX, &GPIO_InitStructure);
GPIO_StructInit(&GPIO_InitStructure);
GPIO_InitStructure.GPIO_Pin = GPIO_LORA_RX;//RX引脚
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IN_FLOATING;
GPIO_Init(PORT_LORA_RX, &GPIO_InitStructure);
USART_InitTypeDef USART_InitStructure;//定义配置串口的结构体变量
RCC_APB1PeriphClockCmd(RCC_LORA_USART, ENABLE);//开启串口2的时钟
USART_DeInit(LORA_USART);//大概意思是解除此串口的其他配置
USART_StructInit(&USART_InitStructure);
USART_InitStructure.USART_BaudRate = bund;//设置波特率
USART_InitStructure.USART_WordLength = USART_WordLength_8b;//字节长度为8bit
USART_InitStructure.USART_StopBits = USART_StopBits_1;//1个停止位
USART_InitStructure.USART_Parity = USART_Parity_No ;//没有校验位
USART_InitStructure.USART_Mode = USART_Mode_Rx | USART_Mode_Tx;//将串口配置为收发模式
USART_InitStructure.USART_HardwareFlowControl = USART_HardwareFlowControl_None; //不提供流控
USART_Init(LORA_USART,&USART_InitStructure);//将相关参数初始化给串口2
USART_ITConfig(LORA_USART, USART_IT_RXNE, ENABLE);//初始配置接受中断
USART_ITConfig(LORA_USART, USART_IT_IDLE, ENABLE);//初始配置接受中断
USART_ClearFlag(LORA_USART,USART_FLAG_RXNE);//初始配置时清除接受置位
USART_ClearFlag(LORA_USART,USART_IT_IDLE);//初始配置时清除接受置位
USART_Cmd(LORA_USART, ENABLE);//开启串口2
NVIC_InitTypeDef NVIC_InitStructure;//中断控制结构体变量定义
NVIC_InitStructure.NVIC_IRQChannel = LORA_USART_IRQ;//中断通道指定为USART2
NVIC_InitStructure.NVIC_IRQChannelPreemptionPriority = 1;//主优先级为0
NVIC_InitStructure.NVIC_IRQChannelSubPriority = 1;//次优先级为1
NVIC_InitStructure.NVIC_IRQChannelCmd = ENABLE;//确定使能
NVIC_Init(&NVIC_InitStructure);//初始化配置此中断通道
}
/******************************************************************
* 函 数 名 称:LOAR_USART_Send_Bit
* 函 数 说 明:向LOAR模块发送单个字符
* 函 数 形 参:ch=字符
* 函 数 返 回:无
* 作 者:LC
* 备 注:无
******************************************************************/
void LOAR_USART_Send_Bit(unsigned char ch)
{
USART_SendData(LORA_USART, (uint8_t)ch);
while( RESET == USART_GetFlagStatus(LORA_USART, USART_FLAG_TXE) ){} // 等待发送数据缓冲区标志置位
}
/******************************************************************
* 函 数 名 称:LOAR_USART_send_String
* 函 数 说 明:向LOAR模块发送字符串
* 函 数 形 参:str=发送的字符串
* 函 数 返 回:无
* 作 者:LC
* 备 注:无
******************************************************************/
void LOAR_USART_send_String(unsigned char *str)
{
while( str && *str ) // 地址为空或者值为空跳出
{
LOAR_USART_Send_Bit(*str++);
}
}
/******************************************************************
* 函 数 名 称:LOAR_USART_send_String
* 函 数 说 明:向LOAR模块发送字符串
* 函 数 形 参:str=发送的16进制数据 len=发送的数据长度
* 函 数 返 回:无
* 作 者:LC
* 备 注:无
******************************************************************/
void LOAR_USART_send_HEX(unsigned char *str, unsigned int len)
{
while( len-- ) // 地址为空或者值为空跳出
{
LOAR_USART_Send_Bit(*str++);
}
}
/******************************************************************
* 函 数 名 称:Clear_LOAR_RX_BUFF
* 函 数 说 明:清除LOAR发过来的数据
* 函 数 形 参:无
* 函 数 返 回:无
* 作 者:LC
* 备 注:无
******************************************************************/
void Clear_LOAR_RX_BUFF(void)
{
unsigned char i = LOAR_RX_LEN_MAX - 1;
while(i)
{
LOAR_RX_BUFF[i--] = 0;
}
LOAR_RX_LEN = 0;
LOAR_RX_FLAG = 0;
}
/**********************************************************
* 函 数 名 称:Anakysis_Data
* 函 数 功 能:接收LoRa发送过来的数据
* 传 入 参 数:无
* 函 数 返 回:1=接收到一次数据 0=当前没有接收到数据
* 作 者:LC
* 备 注:
**********************************************************/
unsigned char Anakysis_Data(void)
{
if( LOAR_RX_FLAG == 1 )//如果接收到串口的数据
{
LOAR_RX_FLAG = 0;//将标志位清除
printf("data = %s\r\n",LOAR_RX_BUFF);
Clear_LOAR_RX_BUFF();
return 1;
}
else
{
printf("NO Data!\r\n");
}
return 0;
}
/******************************************************************
* 函 数 名 称:LOAR_USART_IRQHandler
* 函 数 说 明:连接LOAR的串口中断服务函数
* 函 数 形 参:无
* 函 数 返 回:无
* 作 者:LC
* 备 注:无
******************************************************************/
void LORA_USART_IRQHandler(void)
{
if(USART_GetITStatus(LORA_USART,USART_IT_RXNE) != RESET) // 接收缓冲区不为空
{
//接收数据
LOAR_RX_BUFF[ LOAR_RX_LEN ] = USART_ReceiveData(LORA_USART);
#if DEBUG
//测试,查看接收到了什么数据
printf("%c", LOAR_RX_BUFF[ LOAR_RX_LEN ]);
#endif
//接收长度限制
LOAR_RX_LEN = ( LOAR_RX_LEN + 1 ) % LOAR_RX_LEN_MAX;
USART_ClearFlag(LORA_USART,USART_FLAG_RXNE);//初始配置时清除接受置位
}
if(USART_GetITStatus(LORA_USART,USART_IT_IDLE) == SET) // 检测到空闲中断
{
volatile uint32_t temp;
temp = LORA_USART->SR; // 读取状态寄存器以清除IDLE标志
temp = LORA_USART->DR; // 读取数据寄存器以清除IDLE标志
LOAR_RX_BUFF[LOAR_RX_LEN] = '\0'; //字符串结尾补 '\0'
LOAR_RX_FLAG = SET; // 接收完成
//usart_interrupt_flag_clear(LOAR_USART, USART_INT_FLAG_IDLE);
}
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
在文件bsp_lora.h中,编写如下代码。
/*
* 立创开发板软硬件资料与相关扩展板软硬件资料官网全部开源
* 开发板官网:www.lckfb.com
* 技术支持常驻论坛,任何技术问题欢迎随时交流学习
* 立创论坛:https://oshwhub.com/forum
* 关注bilibili账号:【立创开发板】,掌握我们的最新动态!
* 不靠卖板赚钱,以培养中国工程师为己任
* Change Logs:
* Date Author Notes
* 2024-04-02 LCKFB-LP first version
*/
#ifndef _BSP_LORA_H_
#define _BSP_LORA_H_
#include "stm32f10x.h"
#include "string.h"
#include "board.h"
/**************************** 串口配置 ****************************/
#define RCC_LORA_TX RCC_APB2Periph_GPIOA // 串口TX的端口时钟
#define RCC_LORA_RX RCC_APB2Periph_GPIOA // 串口RX的端口时钟
#define RCC_LORA_USART RCC_APB1Periph_USART2 // 串口2的时钟
#define PORT_LORA_TX GPIOA // 串口TX的端口
#define PORT_LORA_RX GPIOA // 串口RX的端口
#define GPIO_LORA_TX GPIO_Pin_2 // 串口TX的引脚
#define GPIO_LORA_RX GPIO_Pin_3 // 串口RX的引脚
#define LORA_USART USART2 // 串口2
#define LORA_USART_IRQ USART2_IRQn // 串口2中断
#define LORA_USART_IRQHandler USART2_IRQHandler // 串口2中断服务函数
#define LOAR_RX_LEN_MAX 300 //串口接收最大长度
void LOAR_USART_Init(unsigned int bund);
void LOAR_USART_send_String(unsigned char *str);
void LOAR_USART_send_HEX(unsigned char *str, unsigned int len);
unsigned char Anakysis_Data(void);
#endif
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
四、移植验证
在main.c中,编写以下代码。(确保bsp_lora.c 与 bsp_lora.h 已经按照以上进行编写)
修改【R_T】切换 开发板1 和 开发板2 的消息发送。
/*
* 立创开发板软硬件资料与相关扩展板软硬件资料官网全部开源
* 开发板官网:www.lckfb.com
* 技术支持常驻论坛,任何技术问题欢迎随时交流学习
* 立创论坛:https://oshwhub.com/forum
* 关注bilibili账号:【立创开发板】,掌握我们的最新动态!
* 不靠卖板赚钱,以培养中国工程师为己任
* Change Logs:
* Date Author Notes
* 2024-04-02 LCKFB-LP first version
*/
#include "stm32f10x.h"
#include "board.h"
#include "bsp_uart.h"
#include "stdio.h"
#include "bsp_lora.h"
#define R_T 1 //【1】开发板1 【0】开发板2
int main(void)
{
board_init();
uart1_init(9600);
printf("Start\r\n");
//LoRa模块初始化
LOAR_USART_Init(9600);
while(1)
{
//接收的数据
Anakysis_Data();
//发送数据
#if R_T
LOAR_USART_send_String((uint8_t *)"LSpi-1\r\n");
#else
LOAR_USART_send_String((uint8_t *)"LSpi-2\r\n");
#endif
delay_ms(500);
}
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
上电效果:两个开发板间的数据互传
注意
修改【R_T】切换开发板1和开发板2的消息发送。
模块代码下载链接: