一、模块来源

采购链接：

安信可NB-IoT+GPS北斗双模定位模块EC-01G开发板/多频段全网通

资料下载：

https://docs.ai-thinker.com/nb-iot

二、规格参数

工作电压：3.0V-3.6V

工作电流：IMAX = 170mA

模块尺寸：14.4 x 24.7 MM

控制方式：串口

1. 移植过程

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

2. 查看资料

NBIOT模块使用网络是通过物联网卡提供流量，物联网卡请自行到淘宝购买。

说明

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

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

3. 引脚选择

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

4. 移植至工程

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

移植步骤中的导入.c和.h文件与第二章的第1小节【DHT11温湿度传感器】相同，只是将.c和.h文件更改为bsp_ec01g.c与bsp_ec01g.h。这里不再过多讲述，移植完成后面修改相关代码。

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

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

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

unsigned char EC01G_RX_BUFF[EC01G_RX_LEN_MAX];
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)
{
        GPIO_InitTypeDef GPIO_InitStructure;

        RCC_APB2PeriphClockCmd(RCC_APB2Periph_AFIO|RCC_EC01G_TX|RCC_EC01G_RX,ENABLE);

        GPIO_StructInit(&GPIO_InitStructure);
        GPIO_InitStructure.GPIO_Pin           = GPIO_EC01G_TX;//TX引脚
        GPIO_InitStructure.GPIO_Mode          = GPIO_Mode_AF_PP;
        GPIO_InitStructure.GPIO_Speed         = GPIO_Speed_50MHz;
        GPIO_Init(PORT_EC01G_TX, &GPIO_InitStructure);

        GPIO_StructInit(&GPIO_InitStructure);
        GPIO_InitStructure.GPIO_Pin           = GPIO_EC01G_RX;//RX引脚
        GPIO_InitStructure.GPIO_Mode          = GPIO_Mode_IN_FLOATING;
        GPIO_Init(PORT_EC01G_RX, &GPIO_InitStructure);

        USART_InitTypeDef USART_InitStructure;//定义配置串口的结构体变量

        RCC_APB1PeriphClockCmd(RCC_EC01G_USART, ENABLE);//开启串口2的时钟

        USART_DeInit(EC01G_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(EC01G_USART,&USART_InitStructure);//将相关参数初始化给串口2

        USART_ITConfig(EC01G_USART, USART_IT_RXNE, ENABLE);//初始配置接受中断
        USART_ITConfig(EC01G_USART, USART_IT_IDLE, ENABLE);//初始配置接受中断

        USART_ClearFlag(EC01G_USART,USART_FLAG_RXNE);//初始配置时清除接受置位
        USART_ClearFlag(EC01G_USART,USART_IT_IDLE);//初始配置时清除接受置位

        USART_Cmd(EC01G_USART, ENABLE);//开启串口2

        NVIC_InitTypeDef NVIC_InitStructure;//中断控制结构体变量定义

        NVIC_InitStructure.NVIC_IRQChannel                    = EC01G_USART_IRQ;//中断通道指定为USART2
        NVIC_InitStructure.NVIC_IRQChannelPreemptionPriority  = 1;//主优先级为0
        NVIC_InitStructure.NVIC_IRQChannelSubPriority         = 1;//次优先级为1
        NVIC_InitStructure.NVIC_IRQChannelCmd                 = ENABLE;//确定使能
        NVIC_Init(&NVIC_InitStructure);//初始化配置此中断通道
}

/******************************************************************
 * 函 数 名 称：EC01G_USART_Send_Bit
 * 函 数 说 明：向EC01G模块发送单个字符
 * 函 数 形 参：ch=字符
 * 函 数 返 回：无
 * 作       者：LC
 * 备       注：无
******************************************************************/
void EC01G_USART_Send_Bit(unsigned char ch)
{
    USART_SendData(EC01G_USART, (uint8_t)ch);

    while( RESET == USART_GetFlagStatus(EC01G_USART, USART_FLAG_TXE) ){} // 等待发送数据缓冲区标志置位

}

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

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

        int string_length = strlen((char*)hex) / 2;
        int i = 0;

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

        {
            i++;
        }
        //从buff里复制长度为i的字符串到weather_data
        strncpy(weather_data, buff, i);
        //strncpy函数不会补零，需手动补上
        weather_data[i+1] = '\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[250]={0};
    char parse_buff[1024]={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_GetITStatus(EC01G_USART,USART_IT_RXNE) != RESET) // 接收缓冲区不为空
        {
                                //接收数据
                EC01G_RX_BUFF[ EC01G_RX_LEN ] = USART_ReceiveData(EC01G_USART);

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

                //接收长度限制
        EC01G_RX_LEN = ( EC01G_RX_LEN + 1 ) % EC01G_RX_LEN_MAX;

                USART_ClearFlag(EC01G_USART, USART_IT_RXNE);

        }
        if(USART_GetITStatus(EC01G_USART,USART_IT_IDLE) == SET) // 检测到空闲中断
        {
                volatile uint32_t temp;
                temp = EC01G_USART->SR; // 读取状态寄存器以清除IDLE标志
                temp = EC01G_USART->DR; // 读取数据寄存器以清除IDLE标志

                EC01G_RX_BUFF[EC01G_RX_LEN] = '\0'; //字符串结尾补 '\0'
                EC01G_RX_FLAG = SET;                // 接收完成

                                //usart_interrupt_flag_clear(EC01G_USART, USART_INT_FLAG_IDLE);
        }
}

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

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

#ifndef _BSP_EC01G_H_
#define _BSP_EC01G_H_

#include "stm32f10x.h"
#include "string.h"
#include "board.h"

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

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

//要查询的城市 （输入城市拼音，免费版只支持部分城市）
#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[20];         //查询的城市
    char country[20];       //查询的国家
    char path[50];          //具体地址（市市省国，例：Shenzhen,Shenzhen,Guangdong,China）
    char weather[10];       //天气状态
    char weather_code[5];   //天气代码
    char temperature[5];    //温度
    char last_update[50];   //天气数据更新时间
}WEATHER_DATA;

/****************************   串口配置    ****************************/
#define RCC_EC01G_TX              RCC_APB2Periph_GPIOA   // 串口TX的端口时钟
#define RCC_EC01G_RX              RCC_APB2Periph_GPIOA   // 串口RX的端口时钟
#define RCC_EC01G_USART           RCC_APB1Periph_USART2  // 串口2的时钟

#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 EC01G_USART               USART2                 // 串口2
#define EC01G_USART_IRQ           USART2_IRQn            // 串口2中断
#define EC01G_USART_IRQHandler    USART2_IRQHandler      // 串口2中断服务函数

#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. 根据安信可科技提供的资料，完成心知天气平台的接入。

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 替换成为你的私钥。

4. 代码移植

实现该步骤请确保完成了移植至工程目录。

在 bsp_ec01g.h 中，将私钥宏定义 API_KEY 修改为你自己的私钥。并输入要查询的城市。

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

/*
 * 立创开发板软硬件资料与相关扩展板软硬件资料官网全部开源
 * 开发板官网：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_ec01g.h"

int main(void)
{

      WEATHER_DATA weather_data={0};

      board_init();

      uart1_init(115200);

      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)
      {

      }

}

上电现象：

模块移植成功案例代码【百度网盘】

链接：https://pan.baidu.com/s/1YXzBXfzvUR0dWLF9v0eMjA?pwd=an6k

提取码：an6k