EC-01G NBIOT+GPS模块

模块来源

采购链接：
https://item.taobao.com/item.htm?spm=a1z10.3-c-s.w4002-24271435830.11.47384853h0s6Zh&id=661208519683
资料下载：
https://docs.ai-thinker.com/nb-iot

规格参数

工作电压：3.0V-3.6V
工作电流：IMAX = 170mA
模块尺寸：14.4 x 24.7 MM
控制方式：串口

移植过程

我们的目标是在【立创开发板GD32E230C8T6】上能够完成无线传输的功能。首先要获取资料，查看数据手册应如何实现，再移植至我们的工程。

查看资料

NBIOT模块使用网络是通过物联网卡提供流量，物联网卡链接：点击跳转

使用GPS定位时，不可在室内，室内很难定位。需要到室外进行定位。

其余请参考官方资料：https://docs.ai-thinker.com/nb-iot

引脚选择

使用串口1（串口1-TX=PA2，串口1-RX=PA3）

移植至工程

移植步骤中的导入.c和.h文件与上一节相同，只是将.c和.h文件更改为bsp_ec01g.c与bsp_ec01g.h。移植完成后面修改相关代码。

详细可见【TTP224触摸传感器】中的移植至工程目录。这里不再过多讲述。移植完成后面修改相关代码。

工程参考入门手册工程模板

在文件bsp_ec01g.c中，编写如下代码。

 /******************************************************************************
   * 测试硬件：立创开发板·GD32E230C8T6    使用主频72Mhz    晶振8Mhz
   * 版 本 号: V1.0
   * 修改作者: www.lckfb.com
   * 修改日期: 2023年11月02日
   * 功能介绍:
   *****************************************************************************
   * 梁山派软硬件资料与相关扩展板软硬件资料官网全部开源
   * 开发板官网：www.lckfb.com
   * 技术支持常驻论坛，任何技术问题欢迎随时交流学习
   * 立创论坛：club.szlcsc.com
   * 其余模块移植手册：【立创·GD32E230C8T6开发板】模块移植手册
   * 关注bilibili账号：【立创开发板】，掌握我们的最新动态！
   * 不靠卖板赚钱，以培养中国工程师为己任
  ******************************************************************************/

#include "bsp_ec01g.h"
#include "stdio.h"
#include "string.h"
#include "stdlib.h"


unsigned char EC01G_RX_BUFF[];
unsigned char EC01G_RX_FLAG = 0;
unsigned int EC01G_RX_LEN = 0;



/*
        AT\r\n                //测试设备是否存在                        返回OK说明存在
        AT+CFUN=1        //关闭飞行模式                                返回OK 说明成功
        AT+CEREG?        //判断是否附着网络成功                返回+CEREG: 0,1 说明附着网络成功
        AT+HTTPCREATE=0,"http://116.62.81.138:80"        //设置命令创建一个 http 或 https 客户端实例                返回OK成功
        AT+HTTPCON=0                //连接0号实例服务器        返回OK成功
        AT+HTTPSEND=0,0,78,"/v3/weather/now.json?key=SIwiiHEWo6pPD42S5&location=beijing&language=en&unit=c"        //向0号实例发送GET命令，地址长度为78
        AT+HTTPDESTROY=0        //断开连接   当出现 +HTTPERR: 0,11 时，需要断开连接，再重新连接实例服务器



将API返回的数据，+HTTPRESPC: 后面的7B227。。。转为字符串形式

+HTTPRESPH: 0,200,396,Date: Fri, 02 Jun 2023 03:35:05 GMT
Content-Type: application/json; charset=utf-8
Content-Length: 260
Connection: keep-alive
access-control-allow-origin: *
etag: W/"104-BAVuIqnZSk8TcsNHuRGYESoLzao"
x-powered-by: Express
x-ratelimit-limit: 20;w=60
x-ratelimit-remaining: 19
x-ratelimit-reset: 60.000
x-request-id: F2S6NvFKYBEUQ0zTbqlB
x-tenant-id: dbef859d-3503-45ff-ba2f-3e5f0f4de75d

+HTTPRESPC: 0,0,260,520,7B22726573756C7473223A5B7B226C6F636174696F6E223A7B226964223A2257583446425858464B45344622
2C226E616D65223A224265696A696E67222C22636F756E747279223A22434E222C2270617468223A224265696A696E672C4265696A696E67
2C4368696E61222C2274696D657A6F6E65223A22417369612F5368616E67686169222C2274696D657A6F6E655F6F6666736574223A222B30
383A3030227D2C226E6F77223A7B2274657874223A2253756E6E79222C22636F6465223A2230222C2274656D7065726174757265223A2232
38227D2C226C6173745F757064617465223A22323032332D30362D30325431313A31343A33382B30383A3030227D5D7D
*/


/************************************************************
 * 函数名称：EC01G_USART_Init
 * 函数说明：连接EC01G的初始化
 * 型    参：bund=串口波特率
 * 返 回 值：无
 * 备    注：无
*************************************************************/
void EC01G_USART_Init(unsigned int bund)
{
        /* 使能 EC01G_USART 的时钟 */
        rcu_periph_clock_enable(RCU_EC01G_USART);
        /* 使能时钟 */
        rcu_periph_clock_enable(RCU_EC01G_TX);
        rcu_periph_clock_enable(RCU_EC01G_RX);
        /*        配置引脚为复用功能 */
        gpio_af_set(PORT_EC01G_TX, BSP_EC01G_AF, GPIO_EC01G_TX);

        /*        配置引脚为复用功能 */
        gpio_af_set(PORT_EC01G_RX, BSP_EC01G_AF, GPIO_EC01G_RX);

        /*        配置TX引脚为复用上拉模式 */
        gpio_mode_set(PORT_EC01G_TX, GPIO_MODE_AF, GPIO_PUPD_PULLUP, GPIO_EC01G_TX);

        /*        配置RX引脚为复用上拉模式 */
        gpio_mode_set(PORT_EC01G_RX, GPIO_MODE_AF, GPIO_PUPD_PULLUP, GPIO_EC01G_RX);

        /*        配置PA2引脚为为输出模式 */
        gpio_output_options_set(PORT_EC01G_TX, GPIO_OTYPE_PP, GPIO_OSPEED_50MHZ, GPIO_EC01G_TX);

        /*        配置PA3引脚为为输出模式 */
        gpio_output_options_set(PORT_EC01G_RX, GPIO_OTYPE_PP, GPIO_OSPEED_50MHZ, GPIO_EC01G_RX);

        /*        设置EC01G_USART的波特率为115200 */
        usart_baudrate_set(EC01G_USART, bund);

        /*        设置EC01G_USART的校验位为无 */
        usart_parity_config(EC01G_USART, USART_PM_NONE);

        /*        设置EC01G_USART的数据位为8位 */
        usart_word_length_set(EC01G_USART, USART_WL_8BIT);

        /*        设置EC01G_USART的停止位为1位 */
        usart_stop_bit_set(EC01G_USART, USART_STB_1BIT);

        /*        使能串口1 */
        usart_enable(EC01G_USART);

        /*        使能EC01G_USART传输 */
        usart_transmit_config(EC01G_USART, USART_TRANSMIT_ENABLE);

        /*        使能EC01G_USART接收 */
        usart_receive_config(EC01G_USART, USART_RECEIVE_ENABLE);

        /*        使能EC01G_USART接收中断标志位 */
        usart_interrupt_enable(EC01G_USART, USART_INT_RBNE);

                /*        使能EC01G_USART空闲中断标志位 */
        usart_interrupt_enable(EC01G_USART, USART_INT_IDLE); // DLE 线检测中断

        /* 配置中断优先级 */
        nvic_irq_enable(EC01G_USART_IRQ, 2); // 配置中断优先级
}

/******************************************************************
 * 函 数 名 称：EC01G_USART_Send_Bit
 * 函 数 说 明：向EC01G模块发送单个字符
 * 函 数 形 参：ch=字符
 * 函 数 返 回：无
 * 作       者：LC
 * 备       注：无
******************************************************************/
void EC01G_USART_Send_Bit(unsigned char ch)
{
        //发送字符
        usart_data_transmit(EC01G_USART, ch);
        // 等待发送数据缓冲区标志自动置位
        while(RESET == usart_flag_get(EC01G_USART, USART_FLAG_TBE) );
}


/******************************************************************
 * 函 数 名 称：EC01G_USART_send_String
 * 函 数 说 明：向EC01G模块发送字符串
 * 函 数 形 参：str=发送的字符串
 * 函 数 返 回：无
 * 作       者：LC
 * 备       注：无
******************************************************************/
void EC01G_USART_send_String(unsigned char *str)
{
        while( str && *str ) // 地址为空或者值为空跳出
        {
                EC01G_USART_Send_Bit(*str++);
        }
}
//清除串口接收的数据
/******************************************************************
 * 函 数 名 称：Clear_EC01G_RX_BUFF
 * 函 数 说 明：清除EC01G发过来的数据
 * 函 数 形 参：无
 * 函 数 返 回：无
 * 作       者：LC
 * 备       注：无
******************************************************************/
void Clear_EC01G_RX_BUFF(void)
{
        unsigned int i = EC01G_RX_LEN_MAX-1;
        while(i)
        {
                EC01G_RX_BUFF[] = 0;
        }
        EC01G_RX_LEN = 0;
        EC01G_RX_FLAG = 0;
}


/******************************************************************
 * 函 数 名 称：EC01G_Send_Cmd
 * 函 数 说 明：向EC01G模块发送指令，并查看EC01G模块是否返回想要的数据
 * 函 数 形 参：cmd=发送的AT指令        ack=想要的应答                waitms=等待应答的时间                cnt=等待应答多少次
 * 函 数 返 回：1=得到了想要的应答                0=没有得到想要的应答
 * 作       者：LC
 * 备       注：无
******************************************************************/
char EC01G_Send_Cmd(char *cmd,char *ack,unsigned int waitms,unsigned char cnt)
{
        EC01G_USART_send_String((unsigned char*)cmd);//发送AT指令
        while(cnt--)
        {
                  //串口中断接收EC01G应答
                if( EC01G_RX_FLAG == 1 )
                {
                        EC01G_RX_FLAG = 0;
                        EC01G_RX_LEN = 0;
            //查找是否有想要的数据
                        if( strstr((char*)EC01G_RX_BUFF, ack) != NULL )
                        {
                                return 1;
                        }
            //清除接收的数据
                        Clear_EC01G_RX_BUFF();
                }
        //时间间隔
        delay_1ms(waitms);
        }

        EC01G_RX_FLAG = 0;
        EC01G_RX_LEN = 0;
        return 0;
}

/******************************************************************
 * 函 数 名 称：EC01G_Init
 * 函 数 说 明：EC01G模块初始化
 * 函 数 形 参：无
 * 函 数 返 回：无
 * 作       者：LC
 * 备       注：ESP01S的默认波特率是9600
******************************************************************/
void EC01G_Init(void)
{
        EC01G_USART_Init(9600);//默认波特率为9600
}



/******************************************************************
 * 函 数 名 称：EC01G_Seniverse_Init
 * 函 数 说 明：配置EC01G模块连接心知天气平台
 * 函 数 形 参：无
 * 函 数 返 回：1=没有检测到设备
 * 作       者：LC
 * 备       注：
AT\r\n                            //测试设备是否存在                        返回OK说明存在
AT+CFUN=1                    //关闭飞行模式                                返回OK 说明成功
AT+CEREG?                    //判断是否附着网络成功                返回+CEREG: 0,1 说明附着网络成功
AT+HTTPCREATE=0,"http:  //116.62.81.138:80"        //设置命令创建一个 http 或 https 客户端实例                返回OK成功
AT+HTTPCON=0                    //连接0号实例服务器        返回OK成功
AT+HTTPSEND=0,0,78,"/v3/weather/now.json?key=SIwiiHEWo6pPD42S5&location=beijing&language=en&unit=c"        //向0号实例发送GET命令，地址长度为78
AT+HTTPDESTROY=0            //断开连接   当出现 +HTTPERR: 0,11 时，需要断开连接，再重新连接实例服务器
******************************************************************/
uint8_t EC01G_Seniverse_Init(void)
{
        uint8_t        ret = 0;
                uint8_t i = 0;
        uint8_t send_buff[]={0};

        //测试设备是否存在
        if( EC01G_Send_Cmd("AT\r\n", "OK", 1000,3) == 0 )
        {
                return 1;
        }

        //关闭飞行模式
        if( EC01G_Send_Cmd("AT+CFUN=1\r\n", "OK", 1000,3) == 0 )
        {
                return 2;
        }

        //判断是否附着网络成功
        if( EC01G_Send_Cmd("AT+CEREG?\r\n", "+CEREG: 0,1", 1000,3) == 0 )
        {
                delay_1ms(500);
                ret = EC01G_Send_Cmd("AT+CEREG?\r\n", "+CEREG: 0,1", 1000,3);
                if( ret == 0 )
                {
                        return 1;
                }
        }

    again:

         //如果之前有连接过，则断开连接
    EC01G_Send_Cmd("AT+HTTPDESTROY=0\r\n", "OK", 500,1);
        //清除接收的数据
        Clear_EC01G_RX_BUFF();


        //创建一个 http客户端实例
        while( EC01G_Send_Cmd("AT+HTTPCREATE=0,\"http://116.62.81.138:80\"\r\n", "OK", 1000,3) == 0 )
        {
                        #if        DEBUG
                                        printf("AT+HTTPCREATE FAIL\r\n");
                        #endif
                        i++;
                        if( i >= 3 ) return 2;
                        goto again;
        }
                i=0;
        //连接0号实例服务器 (默认0号服务器)
        while( EC01G_Send_Cmd("AT+HTTPCON=0\r\n", "OK", 1000,3) == 0 )
        {
                        #if        DEBUG
                                        printf("AT+HTTPCON FAIL\r\n");
                        #endif
                        i++;
                        if( i >= 3 ) return 3;
                        goto again;
        }

        //发送获取天气数据API
        sprintf((char*)send_buff, "AT+HTTPSEND=0,0,%d,%s\r\n", strlen(WEATHER_FACTS_API)-2, WEATHER_FACTS_API);
        if( EC01G_Send_Cmd((char*)send_buff, "OK", 1000,3) == 0 )
        {
                        #if        DEBUG
                                printf("AT+HTTPSEND FAIL\r\n");

                        #endif
                        return 4;
        }
                return 0;



}


/******************************************************************
 * 函 数 名 称：Hex_To_Text
 * 函 数 说 明：将16进制字符串转为字符型字符串
 * 函 数 形 参：hex=16进制字符串地址    hex_len=     text=要保存的地址
 * 函 数 返 回：无
 * 作       者：LC
 * 备       注：无
******************************************************************/
void Hex_To_Text(char *hex, char *text)
{
        char buff[]={0};
        int string_length = strlen((char*)hex) / 2;
        int i = 0;

        // 将每两个字符转换为一个字节，并拷贝到转换后的字符串中
    for (i = 0; i < string_length; i++) {
        char HEX[];
        memcpy(HEX, &hex[], 2);
        HEX[] = '\0';
        text[] = strtol(HEX, NULL, 16);
    }
    text[]='\0';
}


/******************************************************************
 * 函 数 名 称：Search_Data
 * 函 数 说 明：查找对应数据
 * 函 数 形 参：original_data=原始数据   weather_data=要保存的数据  find_what查找的数据头
 * 函 数 返 回：0=查找失败   1=查找成功
 * 作       者：LC
 * 备       注：无
******************************************************************/
uint8_t Search_Data(char *original_data, char * weather_data, char *find_what)
{
    char *buff;
    uint16_t i = 0;
    if( strstr(original_data, find_what) != NULL )
    {
        //找到内容开始的地址
        buff = strstr(original_data, find_what);
        //过滤find_what的内容
        buff += strlen(find_what);
        //找到'"'的下标
        while( buff[] != '"' )

        {
            i++;
        }
        //从buff里复制长度为i的字符串到weather_data
        strncpy(weather_data, buff, i);
        //strncpy函数不会补零，需手动补上
        weather_data[] = '\0';
        return 1;
    }
    return 0;
}

/******************************************************************
 * 函 数 名 称：Weather_Data_Analysis
 * 函 数 说 明：解析天气数据格式。
 * 函 数 形 参：original_data原始JSON格式数据  weather_data解析的数据保存地址
 * 函 数 返 回：无
 * 作       者：LC
 * 备       注：原始JSON格式数据见下方
{"results":[{"location":{"id":"WS10730EM8EV","name":"Shenzhen","country":"CN","path":
"Shenzhen,Shenzhen,Guangdong,China","timezone":"Asia/Shanghai","timezone_offset":
"+08:00"},"now":{"text":"Sunny","code":"0","temperature":"32"},"last_update":"2023-06-02T16:10:15+08:00"}]}
******************************************************************/
void Weather_Data_Analysis(char *original_data, WEATHER_DATA* weather_data)
{
    //查找城市
    Search_Data(original_data,weather_data->city,"name\":\"");
    //查找国家
    Search_Data(original_data,weather_data->country,"country\":\"");
    //查找具体地址
    Search_Data(original_data,weather_data->path,"path\":\"");
    //查找天气状态
    Search_Data(original_data,weather_data->weather,"text\":\"");
    //查找天气代码
    Search_Data(original_data,weather_data->weather_code,"code\":\"");
    //查找当前温度
    Search_Data(original_data,weather_data->temperature,"temperature\":\"");
    //查找更新时间
    Search_Data(original_data,weather_data->last_update,"last_update\":\"");
}


/******************************************************************
 * 函 数 名 称：Get_Weather_Data
 * 函 数 说 明：获取天气数据
 * 函 数 形 参：data=所以天气数据保存的结构体地址
 * 函 数 返 回：无
 * 作       者：LC
 * 备       注：无
******************************************************************/
void Get_Weather_Data(WEATHER_DATA* data)
{
    uint16_t outtime = 5000;//5秒的超时时间
    uint16_t i = 0;
    unsigned char send_buff[]={0};
    char parse_buff[]={0};
    char *rev_buff=0;

    //清除接收的数据
        Clear_EC01G_RX_BUFF();
    //整理天气数据API
    sprintf((char*)send_buff, "AT+HTTPSEND=0,0,%d,%s\r\n", strlen(WEATHER_FACTS_API)-2, WEATHER_FACTS_API);
    //发送指令
    EC01G_USART_send_String(send_buff);

    //接收数据
    while( outtime-- )
    {
        delay_1ms(1);
        if( EC01G_RX_FLAG == 1 )
        {
            EC01G_RX_FLAG = 0;
            //如果接收正确
            if( strstr((const char*)EC01G_RX_BUFF, "+HTTPRESPC:")  != NULL )
            {
                //保存数据地址
                rev_buff = strstr((const char*)EC01G_RX_BUFF, "+HTTPRESPC:");
                break;
            }
        }
    }

    //过滤不需要的数据
    rev_buff+=11;   //过滤+HTTPRESPC:
    while( i < 4 )//过滤4个逗号
    {
        if( *rev_buff == ',' )
        {
            i++;
        }
        rev_buff++;
    }

    //将16进制字符串转为字符型字符串
    Hex_To_Text(rev_buff, parse_buff);

    //解析数据保存到data里
    Weather_Data_Analysis(parse_buff, data);
}


/******************************************************************
 * 函 数 名 称：EC01G_USART_IRQHandler
 * 函 数 说 明：连接EC01G的串口中断服务函数
 * 函 数 形 参：无
 * 函 数 返 回：无
 * 作       者：LC
 * 备       注：无
******************************************************************/
void EC01G_USART_IRQHandler(void)
{
        if(usart_interrupt_flag_get(EC01G_USART,USART_INT_FLAG_RBNE) != RESET) // 接收缓冲区不为空
        {
        //接收数据
                EC01G_RX_BUFF[] = usart_data_receive(EC01G_USART);

#if DEBUG
        //测试，查看接收到了什么数据
        printf("%c", EC01G_RX_BUFF[]);
#endif

                //接收长度限制
        EC01G_RX_LEN = ( EC01G_RX_LEN + 1 ) % EC01G_RX_LEN_MAX;
        }
        if(usart_interrupt_flag_get(EC01G_USART,USART_INT_FLAG_IDLE) == SET) // 检测到空闲中断
        {
                usart_data_receive(EC01G_USART);    // 必须要读，读出来的值不能要
                EC01G_RX_BUFF[] = '\0'; //字符串结尾补 '\0'
                EC01G_RX_FLAG = SET;                // 接收完成
                usart_interrupt_flag_clear(USART1, USART_INT_FLAG_IDLE);
        }
}


在文件bsp_ec01g.h中，编写如下代码。
/********************************************************************************
  * 文 件 名: bsp_ec01g.h
  * 版 本 号: 初版
  * 修改作者: LC
  * 修改日期: 2022年06月05日
  * 功能介绍:
  ******************************************************************************
  * 开发板官网：www.lckfb.com
*********************************************************************************/


#ifndef _BSP_EC01G_H_
#define _BSP_EC01G_H_

#include "gd32e23x.h"
#include "string.h"
#include "systick.h"

//是否开启串口0调试，查看WIFI回显数据
#define     DEBUG   1



/****************************   心知天气     ****************************/
//秘钥(需要修改为你的密钥！)
#define API_KEY                "SpUFyXp2YvP12yxQR"

//要查询的城市 （输入城市拼音，免费版只支持部分城市）
#define QUERIED_CITY    "shenzhen"

//天气实况API                 "/v3/weather/now.json?key=your_api_key&location=beijing&language=zh-Hans&unit=c"
#define WEATHER_FACTS_FRONT             "\"/v3/weather/now.json?key="
#define WEATHER_FACTS_MIDDLE            "&location="
#define WEATHER_FACTS_BACK              "&language=en&unit=c\""
//查询天气实况API
#define WEATHER_FACTS_API ( WEATHER_FACTS_FRONT  API_KEY  WEATHER_FACTS_MIDDLE  QUERIED_CITY  WEATHER_FACTS_BACK)


//未来天气预报API   "/v3/weather/daily.json?key=your_api_key&location=beijing&language=zh-Hans&unit=c&start=0&days=5"
#define FUTURE_WEATHER_FRONT             "\"/v3/weather/daily.json?key="
#define FUTURE_WEATHER_MIDDLE            "&location="
#define FUTURE_WEATHER_BACK              "&language=en&unit=c&start=0&days=5\""
//未来天气预报API
#define FUTURE_WEATHER_API ( FUTURE_WEATHER_FRONT  API_KEY  FUTURE_WEATHER_MIDDLE  QUERIED_CITY  FUTURE_WEATHER_BACK)

//接收的数据保存地址
typedef struct{
    char  city[];         //查询的城市
    char country[];       //查询的国家
    char path[];          //具体地址（市市省国，例：Shenzhen,Shenzhen,Guangdong,China）
    char weather[];       //天气状态
    char weather_code[];   //天气代码
    char temperature[];    //温度
    char last_update[];   //天气数据更新时间
}WEATHER_DATA;


/****************************   串口配置    ****************************/
#define RCU_EC01G_TX         RCU_GPIOA   // 串口TX的端口时钟
#define RCU_EC01G_RX         RCU_GPIOA   // 串口RX的端口时钟
#define RCU_EC01G_USART      RCU_USART1  // 串口1的时钟

#define PORT_EC01G_TX        GPIOA                 // 串口TX的端口
#define PORT_EC01G_RX        GPIOA                 // 串口RX的端口
#define GPIO_EC01G_TX        GPIO_PIN_2  // 串口TX的引脚
#define GPIO_EC01G_RX        GPIO_PIN_3  // 串口RX的引脚
#define BSP_EC01G_AF         GPIO_AF_1   // 串口1的复用功能

#define EC01G_USART                 USART1                      // 串口1
#define EC01G_USART_IRQ             USART1_IRQn                 // 串口1中断
#define EC01G_USART_IRQHandler      USART1_IRQHandler        // 串口1中断服务函数

#define EC01G_RX_LEN_MAX        2096     //串口接收最大长度





void EC01G_Init(void);
uint8_t EC01G_Seniverse_Init(void);
void Get_Weather_Data(WEATHER_DATA* data);

#endif

3.8.4 案例一 接入心知天气平台获取天气数据

1. 心知天气获取 第一次使用需要先注册，进入官网：https://www.seniverse.com。

2. 我们添加产品

3. 然后我们刷新页面，重新点击进入管理，这里就有一个密钥了。

4. 根据安信可科技提供的资料，完成心知天气平台的接入。 AT指令发送步骤： 指令相关含义见资料【nb-iot系列模组AT指令集v1.0.pdf】 发送 成功则返回 说明 AT\r\n OK 测试设备是否存在 AT+CFUN=1\r\n OK 关闭飞行模式（如果返回ERROR:10 说明没有识别到物联网卡） AT+CEREG?\r\n +CEREG: 0,1 判断是否附着网络成功（不成功请注意NB天线是否接好） AT+HTTPCREATE=0,"http://116.62.81.138:80"\r\n OK 创建一个http客户端实例 AT+HTTPCON=0\r\n OK 连接该实例（连接心知天气平台） AT+HTTPSEND=0,0,LEN,API\r\n OK 向0号实例发送长度为LEN的API指令 API指令可上心知天气官网查询，这个贴两个API指令。（可点击超链接文字，跳转到相关网页） 获取天气实况 /v3/weather/now.json?key=your_api_key&location=beijing&language=zh-Hans&unit=c 获取未来5天天气情况 /v3/weather/daily.json?key=your_api_key&location=beijing&language=zh-Hans&unit=c&start=0&days=5 API指令中，请将 your_api_key 替换成为你的私钥。
5. 代码移植 实现该步骤请确保完成了3.7.3.3移植至工程目录。 在 bsp_ec01g.h 中，将私钥宏定义 API_KEY 修改为你自己的私钥。并输入要查询的城市。

6. 在main.c 中编辑以下代码。

 /******************************************************************************
   * 测试硬件：立创开发板·GD32E230C8T6    使用主频72Mhz    晶振8Mhz
   * 版 本 号: V1.0
   * 修改作者: www.lckfb.com
   * 修改日期: 2023年11月02日
   * 功能介绍:
   *****************************************************************************
   * 梁山派软硬件资料与相关扩展板软硬件资料官网全部开源
   * 开发板官网：www.lckfb.com
   * 技术支持常驻论坛，任何技术问题欢迎随时交流学习
   * 立创论坛：club.szlcsc.com
   * 其余模块移植手册：【立创·GD32E230C8T6开发板】模块移植手册
   * 关注bilibili账号：【立创开发板】，掌握我们的最新动态！
   * 不靠卖板赚钱，以培养中国工程师为己任
  ******************************************************************************/
#include "gd32e23x.h"
#include "systick.h"
#include "bsp_usart.h"
#include "stdio.h"
#include "BSP_ec01g.h"


int main(void)
{
    WEATHER_DATA weather_data={0};
    systick_config();                //滴答定时器初始化 1ms

    usart_gpio_config(115200U);
    printf("start\r\n");

    EC01G_Init();
    EC01G_Seniverse_Init();

    //等待之前的串口数据接收完毕
    delay_1ms(1000);delay_1ms(1000);delay_1ms(1000);

    printf("\r\n\r\nagain rev\r\n\r\n");
    //获取天气数据，并保存到weather_data结构体里
    Get_Weather_Data(&weather_data);

    printf("city = %s\r\n", weather_data.city );
    printf("country = %s\r\n", weather_data.country );
    printf("path = %s\r\n", weather_data.path );
    printf("weather = %s\r\n", weather_data.weather );
    printf("weather_code = %s\r\n", weather_data.weather_code );
    printf("temperature = %s\r\n", weather_data.temperature );
    printf("last_update = %s\r\n", weather_data.last_update );
        while(1)
        {

        }
}

7. 移植现象 等待NBIOT模块连接上心知天气平台获取到数据之后，将会把数据发送至串口。

移植成功示例，见文件3.8.4-1 。

文件下载

文件3.8.4-1 移植成功示例

3.9 AS32-100 LoRa无线通信模块 3.9.1 模块来源 采购链接： LORA模块433无线通信串口模块中继组网SX1278/76应用成熟杜绝死机 资料下载： AS32-TTL-100 433MHz LoRa扩频 无线收发模块 上位机下载地址： http://www.ashining.com.cn/relatedsoftware/soft_asds.zip

图3.9.1-1 产品实物展示 3.9.2 规格参数 工作电压：2.0V-5.5V 工作电流：52mA~104mA 默认频率：433Mhz 发射功率：20dBm 参考通信距离：3km 控制方式：串口

文件下载

文件下载

文件下载

文件3.9.2-1 相关手册

3.8.3 移植过程 我们的目标是在立创开发板GD32E230C8T6上能够完成无线传输的功能。首先要获取资料，查看数据手册应如何实现，再移植至我们的工程。 3.8.3.1 查看资料 通过MD0与MD1设置工作模式。 MD0 MD1 具体工作模式 0 0 一般工作模式 0 1 省电工作模式 1 0 唤醒工作模式 1 1 休眠工作模式 需要多个模块互传数据，则模块间的配置参数必须要一致。参数包括：空中速度、模块地址、通信信道。 参数的修改是通过上位机进行设置。具体步骤请参考快速操作指南。配置完成之后，只需要将模式设置为一般工作模式，即可进行透传。 3.8.3.2 引脚选择 使用串口1（串口1-TX=PA2，串口1-RX=PA3） AUX引脚 用于无线收发缓冲指示和自检指示。它指示模块是否有数据尚未通过无线发出去，或已收到的数据是否 已通过串口全部发出,或模块正在初始化自检过程中。 工作状态切换时 AUX 时序变换：工作状态切换前应当检测 AUX 引脚状态，当 AUX 为低电平时，表示模块繁 忙；当 AUX 输出高电平约 2ms 后，表示此时模块处于空闲状态，模块可以开始工作状态切换，低延时工作状态引 脚 MD0、MD1 电平开始跳变，AUX 继续输出高电平约 3ms 后，模块进行状态切换，当 AUX 输出低电平，表示正 在切换状态，AUX 输出高电平，并保持约 2ms 表示状态切换完成。 本案例是不需要进行工作模式切换，而是固定使用一般工作模式（MD0=0,MD1=0）故AUX悬空即可。 LoRa 立创开发板 接线图 MD0 GND

MD1 GND

RXD PA2

TXD PA3

AUX 不接

VCC 3V3

GND GND

表3.8.3.2 各引脚连接

3.8.3.3 移植至工程 移植步骤中的导入.c和.h文件与上一节相同，只是将.c和.h文件更改为bsp_lora.c与bsp_lora.h。见2.2.3.3 移植至工程。这里不再过多讲述。移植完成后面修改相关代码。 详细可见【TTP224触摸传感器】中的移植至工程目录（点我查看）。这里不再过多讲述。移植完成后面修改相关代码。

(新版本)空白工程文件（更新了usart串口的文件：以后就不用在usart文件中进行更改了）

文件下载

文件3.5.3.3-1 空白工程

在文件bsp_lora.c中，编写如下代码

 /******************************************************************************
   * 测试硬件：立创开发板·GD32E230C8T6    使用主频72Mhz    晶振8Mhz
   * 版 本 号: V1.0
   * 修改作者: www.lckfb.com
   * 修改日期: 2023年11月02日
   * 功能介绍:
   *****************************************************************************
   * 梁山派软硬件资料与相关扩展板软硬件资料官网全部开源
   * 开发板官网：www.lckfb.com
   * 技术支持常驻论坛，任何技术问题欢迎随时交流学习
   * 立创论坛：club.szlcsc.com
   * 其余模块移植手册：【立创·GD32E230C8T6开发板】模块移植手册
   * 关注bilibili账号：【立创开发板】，掌握我们的最新动态！
   * 不靠卖板赚钱，以培养中国工程师为己任
  ******************************************************************************/

#include "bsp_lora.h"
#include "stdio.h"
#include "string.h"


unsigned char LOAR_RX_BUFF[];
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)
{
        /* 使能 LOAR_USART 的时钟 */
        rcu_periph_clock_enable(RCU_LOAR_USART);
        /* 使能时钟 */
        rcu_periph_clock_enable(RCU_LOAR_TX);
        rcu_periph_clock_enable(RCU_LOAR_RX);
        /*        配置引脚为复用功能 */
        gpio_af_set(PORT_LOAR_TX, BSP_LOAR_AF, GPIO_LOAR_TX);

        /*        配置引脚为复用功能 */
        gpio_af_set(PORT_LOAR_RX, BSP_LOAR_AF, GPIO_LOAR_RX);

        /*        配置TX引脚为复用上拉模式 */
        gpio_mode_set(PORT_LOAR_TX, GPIO_MODE_AF, GPIO_PUPD_PULLUP, GPIO_LOAR_TX);

        /*        配置RX引脚为复用上拉模式 */
        gpio_mode_set(PORT_LOAR_RX, GPIO_MODE_AF, GPIO_PUPD_PULLUP, GPIO_LOAR_RX);

        /*        配置PA2引脚为为输出模式 */
        gpio_output_options_set(PORT_LOAR_TX, GPIO_OTYPE_PP, GPIO_OSPEED_50MHZ, GPIO_LOAR_TX);

        /*        配置PA3引脚为为输出模式 */
        gpio_output_options_set(PORT_LOAR_RX, GPIO_OTYPE_PP, GPIO_OSPEED_50MHZ, GPIO_LOAR_RX);

        /*        设置LOAR_USART的波特率为115200 */
        usart_baudrate_set(LOAR_USART, bund);

        /*        设置LOAR_USART的校验位为无 */
        usart_parity_config(LOAR_USART, USART_PM_NONE);

        /*        设置LOAR_USART的数据位为8位 */
        usart_word_length_set(LOAR_USART, USART_WL_8BIT);

        /*        设置LOAR_USART的停止位为1位 */
        usart_stop_bit_set(LOAR_USART, USART_STB_1BIT);

        /*        使能串口1 */
        usart_enable(LOAR_USART);

        /*        使能LOAR_USART传输 */
        usart_transmit_config(LOAR_USART, USART_TRANSMIT_ENABLE);

        /*        使能LOAR_USART接收 */
        usart_receive_config(LOAR_USART, USART_RECEIVE_ENABLE);

        /*        使能LOAR_USART接收中断标志位 */
        usart_interrupt_enable(LOAR_USART, USART_INT_RBNE);

                /*        使能LOAR_USART空闲中断标志位 */
        usart_interrupt_enable(LOAR_USART, USART_INT_IDLE); // DLE 线检测中断

        /* 配置中断优先级 */
        nvic_irq_enable(LOAR_USART_IRQ, 2); // 配置中断优先级
}

/******************************************************************
 * 函 数 名 称：LOAR_USART_Send_Bit
 * 函 数 说 明：向LOAR模块发送单个字符
 * 函 数 形 参：ch=字符
 * 函 数 返 回：无
 * 作       者：LC
 * 备       注：无
******************************************************************/
void LOAR_USART_Send_Bit(unsigned char ch)
{
        //发送字符
        usart_data_transmit(LOAR_USART, ch);
        // 等待发送数据缓冲区标志自动置位
        while(RESET == usart_flag_get(LOAR_USART, USART_FLAG_TBE) );
}


/******************************************************************
 * 函 数 名 称：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[] = 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;
        }
        return 0;
}


/******************************************************************
 * 函 数 名 称：LOAR_USART_IRQHandler
 * 函 数 说 明：连接LOAR的串口中断服务函数
 * 函 数 形 参：无
 * 函 数 返 回：无
 * 作       者：LC
 * 备       注：无
******************************************************************/
void LOAR_USART_IRQHandler(void)
{
        if(usart_interrupt_flag_get(LOAR_USART,USART_INT_FLAG_RBNE) != RESET) // 接收缓冲区不为空
        {
        //接收数据
                LOAR_RX_BUFF[] = usart_data_receive(LOAR_USART);

#if DEBUG
        //测试，查看接收到了什么数据
        printf("%c", LOAR_RX_BUFF[]);
#endif

                //接收长度限制
        LOAR_RX_LEN = ( LOAR_RX_LEN + 1 ) % LOAR_RX_LEN_MAX;
        }
        if(usart_interrupt_flag_get(LOAR_USART,USART_INT_FLAG_IDLE) == SET) // 检测到空闲中断
        {
                        usart_data_receive(LOAR_USART); // 必须要读，读出来的值不能要
                        LOAR_RX_BUFF[] = '\0'; //字符串结尾补 '\0'
                        LOAR_RX_FLAG = SET;            // 接收完成
                        usart_interrupt_flag_clear(USART1, USART_INT_FLAG_IDLE);
        }
}

在文件bsp_lora.h中，编写如下代码

 /******************************************************************************
   * 测试硬件：立创开发板·GD32E230C8T6    使用主频72Mhz    晶振8Mhz
   * 版 本 号: V1.0
   * 修改作者: www.lckfb.com
   * 修改日期: 2023年11月02日
   * 功能介绍:
   *****************************************************************************
   * 梁山派软硬件资料与相关扩展板软硬件资料官网全部开源
   * 开发板官网：www.lckfb.com
   * 技术支持常驻论坛，任何技术问题欢迎随时交流学习
   * 立创论坛：club.szlcsc.com
   * 其余模块移植手册：【立创·GD32E230C8T6开发板】模块移植手册
   * 关注bilibili账号：【立创开发板】，掌握我们的最新动态！
   * 不靠卖板赚钱，以培养中国工程师为己任
  ******************************************************************************/

#ifndef _BSP_LORA_H_
#define _BSP_LORA_H_

#include "gd32e23x.h"
#include "string.h"
#include "systick.h"


/****************************   串口配置    ****************************/
#define RCU_LOAR_TX          RCU_GPIOA   // 串口TX的端口时钟
#define RCU_LOAR_RX          RCU_GPIOA   // 串口RX的端口时钟
#define RCU_LOAR_USART       RCU_USART1  // 串口1的时钟

#define PORT_LOAR_TX         GPIOA                // 串口TX的端口
#define PORT_LOAR_RX         GPIOA                // 串口RX的端口
#define GPIO_LOAR_TX         GPIO_PIN_2  // 串口TX的引脚
#define GPIO_LOAR_RX         GPIO_PIN_3  // 串口RX的引脚
#define BSP_LOAR_AF          GPIO_AF_1   // 串口1的复用功能

#define LOAR_USART               USART1                      // 串口1
#define LOAR_USART_IRQ           USART1_IRQn                 // 串口1中断
#define LOAR_USART_IRQHandler    USART1_IRQHandler        // 串口1中断服务函数


#define     LOAR_RX_LEN_MAX     200       //串口接收最大长度

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

案例一 两个开发板间的数据互传

在【立创开发板GD32E230C8T6】1中的main.c中，编写以下代码。（确保bsp_lora.c 与 bsp_lora.h 已经按照以上进行编写）

 /******************************************************************************
   * 测试硬件：立创开发板·GD32E230C8T6    使用主频72Mhz    晶振8Mhz
   * 版 本 号: V1.0
   * 修改作者: www.lckfb.com
   * 修改日期: 2023年11月02日
   * 功能介绍:
   *****************************************************************************
   * 梁山派软硬件资料与相关扩展板软硬件资料官网全部开源
   * 开发板官网：www.lckfb.com
   * 技术支持常驻论坛，任何技术问题欢迎随时交流学习
   * 立创论坛：club.szlcsc.com
   * 其余模块移植手册：【立创·GD32E230C8T6开发板】模块移植手册
   * 关注bilibili账号：【立创开发板】，掌握我们的最新动态！
   * 不靠卖板赚钱，以培养中国工程师为己任
  ******************************************************************************/
#include "gd32e23x.h"
#include "systick.h"
#include "bsp_usart.h"
#include "stdio.h"
#include "bsp_lora.h"


// 如果BOARD是1，那么这个就是[] - 开发板1
// 如果BOARD是0，那么这个就是[] - 开发板2
#define BOARD   1


int main(void)
{
    systick_config();                //滴答定时器初始化 1ms

    usart_gpio_config(9600);
    printf("start\r\n");

        //LoRa模块初始化
        LOAR_USART_Init(9600);

#if BOARD

        while(1)
        {
                //接收的数据
                Anakysis_Data();

                //发送数据
                LOAR_USART_send_String("LSpi-1\r\n");
                //LOAR_USART_send_String("LSpi-2\r\n");
                delay_1ms(500);
        }

#else
        while(1)
        {
                //接收的数据
                Anakysis_Data();

                //发送数据
                //LOAR_USART_send_String("LSpi-1\r\n");
                LOAR_USART_send_String("LSpi-2\r\n");
                delay_1ms(500);
        }

#endif

}

在【立创开发板GD32E230C8T6】2中的main.c中，编写以下代码。（确保bsp_lora.c 与 bsp_lora.h 已经按照以上进行编写）

 /******************************************************************************
   * 测试硬件：立创开发板·GD32E230C8T6    使用主频72Mhz    晶振8Mhz
   * 版 本 号: V1.0
   * 修改作者: www.lckfb.com
   * 修改日期: 2023年11月02日
   * 功能介绍:
   *****************************************************************************
   * 梁山派软硬件资料与相关扩展板软硬件资料官网全部开源
   * 开发板官网：www.lckfb.com
   * 技术支持常驻论坛，任何技术问题欢迎随时交流学习
   * 立创论坛：club.szlcsc.com
   * 其余模块移植手册：【立创·GD32E230C8T6开发板】模块移植手册
   * 关注bilibili账号：【立创开发板】，掌握我们的最新动态！
   * 不靠卖板赚钱，以培养中国工程师为己任
  ******************************************************************************/
#include "gd32e23x.h"
#include "systick.h"
#include "bsp_usart.h"
#include "stdio.h"
#include "bsp_lora.h"


// 如果BOARD是1，那么这个就是[] - 开发板1
// 如果BOARD是0，那么这个就是[] - 开发板2
#define BOARD   0


int main(void)
{
    systick_config();                //滴答定时器初始化 1ms

    usart_gpio_config(9600);
    printf("start\r\n");

        //LoRa模块初始化
        LOAR_USART_Init(9600);

#if BOARD

        while(1)
        {
                //接收的数据
                Anakysis_Data();

                //发送数据
                LOAR_USART_send_String("LSpi-1\r\n");
                //LOAR_USART_send_String("LSpi-2\r\n");
                delay_1ms(500);
        }

#else
        while(1)
        {
                //接收的数据
                Anakysis_Data();

                //发送数据
                //LOAR_USART_send_String("LSpi-1\r\n");
                LOAR_USART_send_String("LSpi-2\r\n");
                delay_1ms(500);
        }

#endif

}

移植现象
两个梁山派分别接收到另一个梁山派的数据，并且通过串口0显示到电脑串口助手。

文件下载

📌 资料下载中心（点击跳转）

📌 在 资料下载中心->【模块移植手册资料下载】 里面的本章节压缩包中。