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
控制方式：串口

移植过程

我们的目标是在天空星GD32F407上能够完成无线传输的功能。首先要获取资料，查看数据手册应如何实现，再移植至我们的工程。

查看资料

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

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

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

引脚选择

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

移植至工程

移植步骤中的导入.c和.h文件与【2.1 DHT11温湿度传感器】相同，只是将.c和.h文件更改为bsp_ec01g.c与bsp_ec01g.h。见2.1.3.3 移植至工程。这里不再过多讲述。移植完成后面修改相关代码。 将bsp_uart.h文件，替换成下方的代码：

/*
* 天空星软硬件资料与相关扩展板软硬件资料官网全部开源
* 开发板官网：www.lckfb.com
* 技术支持常驻论坛，任何技术问题欢迎随时交流学习
* 立创论坛：club.szlcsc.com
* 关注bilibili账号：【立创开发板】，掌握我们的最新动态！
* 不靠卖板赚钱，以培养中国工程师为己任
* Change Logs:
* Date           Author       Notes
* 2023-11-02     LCKFB-yzh    first version
*/

#ifndef __BSP_UART_H__
#define __BSP_UART_H__

#include "board.h"

#define BSP_USART_TX_RCU  RCU_GPIOA   // 串口TX的端口时钟
#define BSP_USART_RX_RCU  RCU_GPIOA   // 串口RX的端口时钟
#define BSP_USART_RCU     RCU_USART0  // 串口0的时钟

#define BSP_USART_TX_PORT GPIOA                                // 串口TX的端口
#define BSP_USART_RX_PORT GPIOA                                // 串口RX的端口
#define BSP_USART_AF                         GPIO_AF_7   // 串口0的复用功能
#define BSP_USART_TX_PIN  GPIO_PIN_9  // 串口TX的引脚
#define BSP_USART_RX_PIN  GPIO_PIN_10 // 串口RX的引脚

#define BSP_USART                                                 USART0                                                                      // 串口0
#define BSP_USART_IRQ                     USART0_IRQn                                                                 // 串口0中断
#define BSP_USART_IRQHandler  USART0_IRQHandler                                                // 串口0中断服务函数

/* 串口缓冲区的数据长度 */
#define USART_RECEIVE_LENGTH  1024

extern uint8_t  g_recv_buff[]; // 接收缓冲区
extern uint16_t g_recv_length;                                                                                 // 接收数据长度
extern uint8_t  g_recv_complete_flag;                                                  // 接收完成标志位

void usart_gpio_config(uint32_t band_rate);                           // 配置串口
void usart_send_data(uint8_t ucch);                                   // 发送一个字符
void usart_send_string(uint8_t *ucstr);                               // 发送一个字符串
void  usart_receive_clear(void);

#endif /* __BSP_UART_H__ */

将bsp_uart.c文件，替换成下方的代码：

/*
* 天空星软硬件资料与相关扩展板软硬件资料官网全部开源
* 开发板官网：www.lckfb.com
* 技术支持常驻论坛，任何技术问题欢迎随时交流学习
* 立创论坛：club.szlcsc.com
* 关注bilibili账号：【立创开发板】，掌握我们的最新动态！
* 不靠卖板赚钱，以培养中国工程师为己任
* Change Logs:
* Date           Author       Notes
* 2023-11-02     LCKFB-yzh    first version
*/

#include "bsp_uart.h"
#include <stdio.h>

uint8_t         g_recv_buff[];   // 接收缓冲区
uint16_t         g_recv_length = 0;                                                                         // 接收数据长度
uint8_t                g_recv_complete_flag = 0;                                          // 接收数据完成标志位

/************************************************
函数名称 ： usart_gpio_config
功    能 ： 串口配置GPIO
参    数 ： band_rate:波特率
返 回 值 ： 无
作    者 ： LC
*************************************************/
void usart_gpio_config(uint32_t band_rate)
{
        /* 开启时钟 */
        rcu_periph_clock_enable(BSP_USART_TX_RCU);   // 开启串口时钟
        rcu_periph_clock_enable(BSP_USART_RX_RCU);   // 开启端口时钟
        rcu_periph_clock_enable(BSP_USART_RCU);      // 开启端口时钟

        /* 配置GPIO复用功能 */
  gpio_af_set(BSP_USART_TX_PORT,BSP_USART_AF,BSP_USART_TX_PIN);
        gpio_af_set(BSP_USART_RX_PORT,BSP_USART_AF,BSP_USART_RX_PIN);

        /* 配置GPIO的模式 */
        /* 配置TX为复用模式 上拉模式 */
        gpio_mode_set(BSP_USART_TX_PORT,GPIO_MODE_AF,GPIO_PUPD_PULLUP,BSP_USART_TX_PIN);
        /* 配置RX为复用模式 上拉模式 */
        gpio_mode_set(BSP_USART_RX_PORT, GPIO_MODE_AF,GPIO_PUPD_PULLUP,BSP_USART_RX_PIN);

        /* 配置TX为推挽输出 50MHZ */
        gpio_output_options_set(BSP_USART_TX_PORT,GPIO_OTYPE_PP,GPIO_OSPEED_50MHZ,BSP_USART_TX_PIN);
        /* 配置RX为推挽输出 50MHZ */
        gpio_output_options_set(BSP_USART_RX_PORT,GPIO_OTYPE_PP, GPIO_OSPEED_50MHZ, BSP_USART_RX_PIN);

        /* 配置串口的参数 */
        usart_deinit(BSP_USART);                                 // 复位串口
        usart_baudrate_set(BSP_USART,band_rate);                 // 设置波特率
        usart_parity_config(BSP_USART,USART_PM_NONE);            // 没有校验位
        usart_word_length_set(BSP_USART,USART_WL_8BIT);          // 8位数据位
        usart_stop_bit_set(BSP_USART,USART_STB_1BIT);                              // 1位停止位

  /* 使能串口 */
        usart_enable(BSP_USART);                                 // 使能串口
        usart_transmit_config(BSP_USART,USART_TRANSMIT_ENABLE);  // 使能串口发送
        usart_receive_config(BSP_USART,USART_RECEIVE_ENABLE);    // 使能串口接收

        /* 中断配置 */
        nvic_irq_enable(BSP_USART_IRQ, 2, 2);                                                                          // 配置中断优先级
        usart_interrupt_enable(BSP_USART,USART_INT_RBNE);                                 // 读数据缓冲区非空中断和溢出错误中断
        usart_interrupt_enable(BSP_USART,USART_INT_IDLE);                                 // 空闲检测中断
}

/************************************************
函数名称 ： usart_send_data
功    能 ： 串口重发送一个字节
参    数 ： ucch：要发送的字节
返 回 值 ：
作    者 ： LC
*************************************************/
void usart_send_data(uint8_t ucch)
{
        usart_data_transmit(BSP_USART,(uint8_t)ucch);                                                         // 发送数据
        while(RESET == usart_flag_get(BSP_USART,USART_FLAG_TBE));  // 等待发送数据缓冲区标志置位
}


/************************************************
函数名称 ： usart_send_String
功    能 ： 串口发送字符串
参    数 ： ucstr:要发送的字符串
返 回 值 ：
作    者 ： LC
*************************************************/
void usart_send_string(uint8_t *ucstr)
{
        while(ucstr && *ucstr)        // 地址为空或者值为空跳出
        {
          usart_send_data(*ucstr++);  // 发送单个字符
        }
}
void  usart_receive_clear(void)
{
    unsigned int i = 0;
    for( i = 0; i < USART_RECEIVE_LENGTH; i++ )
    {
        g_recv_buff[] = 0;
    }
    g_recv_length = 0;
}

#if !defined(__MICROLIB)
//不使用微库的话就需要添加下面的函数
#if (__ARMCLIB_VERSION <= 6000000)
//如果编译器是AC5  就定义下面这个结构体
struct __FILE
{
        int handle;
};
#endif

FILE __stdout;

//定义_sys_exit()以避免使用半主机模式
void _sys_exit(int x)
{
        x = x;
}
#endif

/* retarget the C library printf function to the USART */
int fputc(int ch, FILE *f)
{
    usart_data_transmit(BSP_USART, (uint8_t)ch);
    while(RESET == usart_flag_get(BSP_USART, USART_FLAG_TBE));
    return ch;
}

/************************************************
函数名称 ： BSP_USART_IRQHandler
功    能 ： 串口接收中断服务函数
参    数 ： 无
返 回 值 ： 无
作    者 ： LC
*************************************************/
void BSP_USART_IRQHandler(void)
{
        if(usart_interrupt_flag_get(BSP_USART,USART_INT_FLAG_RBNE) == SET)   // 接收缓冲区不为空
        {
                g_recv_buff[] = usart_data_receive(BSP_USART);      // 把接收到的数据放到缓冲区中
        }

        if(usart_interrupt_flag_get(BSP_USART,USART_INT_FLAG_IDLE) == SET)   // 检测到帧中断
        {
                usart_data_receive(BSP_USART);                                     // 必须要读，读出来的值不能要
                g_recv_buff[] = '\0';                                                                                                                                 // 数据接收完毕，数组结束标志
                g_recv_complete_flag = 1;                                          // 接收完成
                usart_interrupt_flag_clear(BSP_USART, USART_INT_FLAG_IDLE);
        }

}

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

/*
 * 立创开发板软硬件资料与相关扩展板软硬件资料官网全部开源
 * 开发板官网：www.lckfb.com
 * 技术支持常驻论坛，任何技术问题欢迎随时交流学习
 * 立创论坛：club.szlcsc.com
 * 关注bilibili账号：【立创开发板】，掌握我们的最新动态！
 * 不靠卖板赚钱，以培养中国工程师为己任
 * Change Logs:
 * Date           Author       Notes
 * 2023-11-02     LCKFB-yzh    first version
 */

#include "bsp_ec01g.h"
#include "stdio.h"
#include "string.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, 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_ms(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_ms(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;
        }
}


/******************************************************************
 * 函 数 名 称：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_ms(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(EC01G_USART, USART_INT_FLAG_IDLE);
        }
}

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

/*
 * 立创开发板软硬件资料与相关扩展板软硬件资料官网全部开源
 * 开发板官网：www.lckfb.com
 * 技术支持常驻论坛，任何技术问题欢迎随时交流学习
 * 立创论坛：club.szlcsc.com
 * 关注bilibili账号：【立创开发板】，掌握我们的最新动态！
 * 不靠卖板赚钱，以培养中国工程师为己任
 * Change Logs:
 * Date           Author       Notes
 * 2023-11-02     LCKFB-yzh    first version
 */


#ifndef _BSP_EC01G_H_
#define _BSP_EC01G_H_

#include "gd32f4xx.h"
#include "string.h"
#include "board.h"

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



/****************************   心知天气     ****************************/
//秘钥(需要修改为你的密钥！)
#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_7   // 串口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

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

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

2. 登陆控制台获取私钥(这里我注册了3个 密钥，随便选择了一个)

3. 根据安信可科技提供的资料，完成心知天气平台的接入。 AT指令发送步骤：
   指令相关含义见资料【nb-iot系列模组AT指令集v1.0.pdf】

API指令可上心知天气官网查询，这个贴两个API指令。（可点击超链接文字，跳转到相关网页）

API指令中，请将 your_api_key 替换成为你的私钥。

4. 代码移植

   实现该步骤请确保完成了3.7.3.3移植至工程目录。
   在 bsp_ec01g.h 中，将私钥宏定义 API_KEY 修改为你自己的私钥。并输入要查询的城市。

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

/*
 * 立创开发板软硬件资料与相关扩展板软硬件资料官网全部开源
 * 开发板官网：www.lckfb.com
 * 技术支持常驻论坛，任何技术问题欢迎随时交流学习
 * 立创论坛：club.szlcsc.com
 * 关注bilibili账号：【立创开发板】，掌握我们的最新动态！
 * 不靠卖板赚钱，以培养中国工程师为己任
 * Change Logs:
 * Date           Author       Notes
 * 2023-11-02     LCKFB-yzh    first version
 */
#include "board.h"
#include "bsp_ec01g.h"

int main(void)
{
        WEATHER_DATA weather_data={0};


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

    EC01G_Init();
    EC01G_Seniverse_Init();

    //等待之前的串口数据接收完毕
    delay_ms(1000);delay_ms(1000);delay_ms(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)
    {

    }
}


l

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

代码下载

链接在资料下载章节的模块移植手册资料那里！！