一、环境介绍

MCU:STM32F103C8T6

GSM模块:移远MC20 (MT2503D)（GSM+GPS共存）功能很强大

开发软件:Keil5

MQTT协议采用OneNet的旧版协议，登录OneNet控制台创建应用时要选择旧版本。

如果想使用新版本的标准MQTT协议连接OnetNet请参考这里:/xiaolong1126626497/article/details/107385118

完整源代码下载:/download/xiaolong1126626497/18245206

二、MC20模块

MC20模块采用联发科技最新推出的多功能通信定位芯片研制而成。它是一款集成LCC封装、四频段GSM/GPRS和先进算法GNSS引擎于一体的全功能通信模块，具有超小体积、低功耗、双卡单待等优势。MC20不仅内嵌丰富的网络协议（如 TCP、UDP、PPP、FTP、HTTP以及SSL），还集成了多星座卫星系统（如北斗、GPS、QZSS），因此能提供无线移动通信以及精准的导航定位功能。

除具备GSM/GPRS无线通信功能外，MC20模块还支持先进的GNSS技术。它集成了EPOTM（用户无需自设服务器，直接从MTK服务器获取EPO数据）、秒定等技术，能够实现快速首次定位。由于支持北斗、GPS、QZSS等多星座卫星系统解调算法，其定位更加精准，抗多路径干扰能力更强，比传统GPS模块具有更多优势。另外，MC20模块中内置LNA和低功耗算法：前者使其接收灵敏度提升至-149dBm；后者使其在低功耗模式（GLP Mode）下的耗流仅为正常工作模式的40%。

MC20模块较传统GSM+GNSS方案体积减少40%，使其在各种应用中占具更大优势。其主要应用领域为：可穿戴设备（智能手表）、宠物追踪、财产追踪及行车记录仪等等。

主要优势

● 超小体积： 18.7mm × 16.0mm × 2.1mm

● 多卫星导航系统： GPS/BeiDou/QZSS

● GNSS 接收机通道： 99 路捕获通道/33 路跟踪通道

● 支持多种 AGPS 技术，如 EASYTM 、EPOTM 、秒定等

● 内置 LNA 大大提升 GNSS 接收机灵敏度（-167dBm@跟踪模式）：可使用无源 GNSS 天线而无需任何外部低噪声放大器

● 支持增强型 GNSS 功能，如 SDK 命令、LOCUSTM 、AIC 和 GLP

● 多功能四频段 GSM模块： 850/900/1800/1900MHz

● 内嵌丰富网络协议： TCP/UDP/PPP/HTTP/FTP/SSL

● 支持语音、短信、QuecFOTATM 、双卡单待以及 OpenCPU 功能

● 支持蓝牙 V3.0 以及 SPP & HFP-AG 配置文件

三、代码功能

使用STM32F103C8T6 通过串口+AT指令控制MC20模块+MQTT协议，登录OneNet服务器上传GPS数据，LED控制（网页按钮控制开发板上的LED灯）。

四、核心代码

4.1 main.c

#include "stm32f10x.h"#include "beep.h"#include "delay.h"#include "led.h"#include "sys.h"#include "usart.h"#include <string.h>#include <stdio.h>#include "timer.h"#include "mc20.h"//网络协议层#include "onenet.h"//协议封装文件#include "dStream.h"//产品IDchar PROID[]="231174";//鉴权信息char AUTH_INFO[]="1234567890";//设备IDchar DEVID[]="523369555";//API KEYchar API_KEY[]="k6vtrrEd1H7UMddiF3DzripS47w=";//缓冲区char onenet_http_cmd[1024];//服务器IP地址#define TCP_SERVER_IP_ADDR "183.230.40.39"//服务器端口号#define TCP_SERVER_PORT 6002//数据流结构DATA_STREAM data_stream[1]={{"gps","88.88",TYPE_JSON,1},};/*STM32开发板接线说明：STM32MC203.3V------>V_IOGND<----->GNDPA3<------GSM_TXPA2------>GSM_RX*/int main(){ u32 time_cnt=0;u32 cnt=0;double Longitude; //经度double latitude; //纬度LED_Init();BEEP_Init();USART_X_Init(USART1,72,115200);TIM2_Init(72,20000);//辅助串口2接收，超时时间为20msUSART_X_Init(USART2,36,9600); //连接着MC20(GPS+GPRS)printf("串口准备就绪.....\r\n");DelayMs(500);printf("程序修改时间: %s\r\n",__TIME__);while(1){u8 stat;/*初始化MC20,并连接到指定服务器*/MC20_InitConnect(TCP_SERVER_IP_ADDR,TCP_SERVER_PORT);/*登录OneNET服务器，上线设备*/stat=OneNet_DevLink();if(stat)printf("ERROR:%d,接入OneNET失败:%d\r\n",stat,cnt++);else break; //登录成功LED1=!LED1;delay_ms(200); break;//失败也退出继续运行下面代码}printf("6. OneNET服务器登录成功!\r\n");delay_ms(100);while(1){ /*6. 向OneNet服务器5秒发送一次数据*/time_cnt++;DelayMs(1);if(time_cnt>=5000){time_cnt=0;/*获取一次GPS输出的经纬度信息*/switch(MC20_GetGPS_Data(&Longitude,&latitude)){case 0: printf("经度:%f,纬度:%f\r\n",Longitude,latitude); break;case 1: printf("ERROR:GPS数据接收失败!\r\n"); break;case 2: printf("ERROR:GPS定位数据解码失败!<请将GPS拿到空旷位置定位>\r\n"); break;}//组装数据格式sprintf(onenet_http_cmd,"{\"lon\":%f,\"lat\":%f}",Longitude,latitude);data_stream[0].dataPoint=onenet_http_cmd; //赋值GPS数据//向云端发送数据流OneNet_SendData(FORMAT_TYPE1,DEVID,API_KEY,data_stream,1);}/*实时接收MC20收到的数据,进行解析*/if(USART2_RX_FLAG){USART2_RX_BUFF[USART2_RX_CNT]='\0';printf("USART2_RX_BUFF=%s\r\n",USART2_RX_BUFF); //向串口打印信息//解析平台返回的数据OneNet_RevPro(USART2_RX_BUFF);USART2_RX_CNT=0;USART2_RX_FLAG=0;memset(USART2_RX_BUFF,0,sizeof(USART2_RX_BUFF));}}}

4.2 mc20.c

#include "mc20.h"/*函数功能:向MC20模块发送指令函数参数:char *cmd 发送的命令char *check_data 检测返回的数据返回值: 0表示成功 1表示失败*/u8 MC20_SendCmd(char *cmd,char *check_data){u16 i,j;for(i=0;i<5;i++) //测试的总次数{USART2_RX_FLAG=0;USART2_RX_CNT=0;memset(USART2_RX_BUFF,0,sizeof(USART2_RX_BUFF));USART_X_SendString(USART2,cmd); //发送指令for(j=0;j<500;j++) //等待的时间(ms单位){if(USART2_RX_FLAG){USART2_RX_BUFF[USART2_RX_CNT]='\0';if(strstr((char*)USART2_RX_BUFF,check_data)){return 0;}else break;}delay_ms(10); //一次的时间}}return 1;}/*函数功能: MC20初始化检查*/u8 MC20_InitCheck(void){return MC20_SendCmd("AT\r\n","OK\r\n");}/*函数功能: 开启GPS功能返 回 值：0表示成功 1表示失败*/u8 MC20_StartGPS(void){//先判断GPS功能是否启动if(MC20_SendCmd("AT+QGNSSC?\r\n","+QGNSSC: 1")) {//没有启动就启动GPS功能if(MC20_SendCmd("AT+QGNSSC=1\r\n","OK\r\n")){return 1; //GPS功能启动失败}}return 0;}/*函数功能：从buf里面得到第cnt个逗号所在的位置返 回 值：0~254,代表逗号所在位置的偏移.255,代表不存在第cnt个逗号*/u8 GPS_GetCommaOffset(char *buf,u8 cnt){char *p=buf;while(cnt){if(*buf=='*'||*buf<' '||*buf>'z')return 255;//遇到'*'或者非法字符,则不存在第cx个逗号if(*buf==',')cnt--;buf++;}return buf-p; //计算偏移量}/*函数功能: 获取GPS经纬度数据值函数参数:double *Longitude :经度double *latitude :纬度返回值: 0表示定位成功,1表示定位失败说明: 解析$GNRMC命令，得到经纬度$GNRMC,023705.000,A,2842.4164,N,11549.5713,E,1.73,91.65,150319,,,A*41转换公式示例:经度： dddmm.mmmm 东经 11408.4790 114+(08.4790/60)=114.141317纬度： ddmm.mmmm 北纬 2236.9453 22+(36.9453/60)= 22.615755*/u8 GPS_GNRMC_Decoding(char *gps_buffer,double *Longitude,double *latitude){u8 Offset;u32 int_data;double s_Longitude,s_latitude;char *p;/*1. 确定下定位是否成功*/p=strstr(gps_buffer,"$GNRMC");if(!p)return 1;Offset=GPS_GetCommaOffset(p,2);if(Offset==255)return 2;if(*(p+Offset)!='A')return 3; //定位不准确/*2. 得到纬度*/Offset=GPS_GetCommaOffset(p,3);if(Offset==255)return 4;sscanf(p+Offset,"%lf",&s_latitude);s_latitude=s_latitude/100;int_data=s_latitude;//得到纬度整数部分s_latitude=s_latitude-int_data;//得到纬度小数部分s_latitude=(s_latitude)*100;*latitude=int_data+(s_latitude/60.0); //得到转换后的值/*3. 得到经度*/Offset=GPS_GetCommaOffset(p,5);if(Offset==255)return 5;sscanf(p+Offset,"%lf",&s_Longitude); s_Longitude=s_Longitude/100;int_data=s_Longitude;//得到经度整数部分s_Longitude=s_Longitude-int_data; //得到经度小数部分s_Longitude=s_Longitude*100;*Longitude=int_data+(s_Longitude/60.0); return 0;}/*函数功能: 获取一次GPS经纬度数据函数参数:double *Longitude :经度double *latitude :纬度返回值: 0表示定位成功,1表示数据接收失败,2表示定位失败*/u8 MC20_GetGPS_Data(double *Longitude,double *latitude){/*1. 发送获取GPS数据的指令*/if(MC20_SendCmd("AT+QGNSSRD=\"NMEA/RMC\"\r\n", "OK\r\n"))return 1;/*2. 对GPS数据进行解码*/if(GPS_GNRMC_Decoding((char *)USART2_RX_BUFF,Longitude,latitude))return 2;//解码成功return 0; }/*函数功能: 连接服务器函数参数:char *server_ip 服务器IP地址 u16 port 服务器端口号返回值: 0表示连接成功,1表示连接失败*/u8 MC20_Connect_TCP_Server(char *server_ip,u16 port){char send_buf[100]={0};sprintf(send_buf,"AT+QIOPEN=\"TCP\",\"%s\",\"%d\"\r\n",server_ip,port);//连接至服务器if(MC20_SendCmd(send_buf, "CONNECT")){return 1; //连接失败}return 0; //连接成功}/*函数功能: 向服务器发送数据函数参数: u8 *buffer 发送的数据u32 len 发送的长度返 回 值: 0表示发送成功,1表示准备发送失败，2表示数据发送失败*/u8 MC20_ClientSendData(u8 *buffer,u32 len){char send_buf[2];/*1. 准备发送数据*/if(MC20_SendCmd("AT+QISEND\r\n",">")){printf("AT+QISEND->ERROR Info:%s\r\n",USART2_RX_BUFF);return 1; }/*2. 开始发送数据*/USART_X_SendData(USART2,buffer,len);delay_ms(20);/*3. 发送结束符*/send_buf[0] = 0x1a;send_buf[1] = '\0';if(MC20_SendCmd(send_buf,"OK\r\n")){printf("发送结束符->ERROR Info:%s\r\n",USART2_RX_BUFF);return 2;}return 0;}/*函数功能: MC20初始化检查并连接至服务器 */#include "led.h"void MC20_InitConnect(char *server_ip,u16 port){/*1. MC20模块初始化检查*/while(MC20_InitCheck()){LED1=!LED1;printf("ERROR:MC20模块初始化检查失败!\r\n");delay_ms(100);}printf("1. MC20模块初始化成功!\r\n");delay_ms(100);/*2. 查询是否有PIN码锁定*/while(MC20_SendCmd("AT+CPIN?\r\n","READY")){LED1=!LED1;printf("ERROR:PIN码锁定检查失败!\r\n");delay_ms(100);}printf("2. PIN码锁定检查成功!\r\n");delay_ms(100);/*3. 查询SIM卡网络注册信息*/if(MC20_SendCmd("AT+CREG?\r\n",",1"))//本地SIM卡{if(MC20_SendCmd("AT+CREG?\r\n",",5"))//漫游SIM卡{printf("ERROR:查询SIM卡网络注册信息失败!\n");}elseprintf("3. 漫游SIM卡网络注册成功!\n");}elseprintf("3. 本地SIM卡网络注册成功!\n");delay_ms(100);/*4. 启动GPS功能*/if(MC20_StartGPS()){printf("ERROR:GPS功能启动失败!\n");}else printf("4. GPS功能启动成功!\n");delay_ms(100);/*5. 连接指定服务器*/while(MC20_Connect_TCP_Server(server_ip,port)){printf("ERROR: 连接TCP服务器失败!\r\n现在正在断开服务器,进行重连!\r\n需要保证服务器地址正确,并且SIM卡可以上网\r\n");/*先断开服务器连接 (如果之前没有连接过服务器，这里就会出现错误)*/MC20_SendCmd("AT+QICLOSE\r\n","OK\r\n");delay_ms(100);MC20_SendCmd("AT+QIDEACT\r\n","OK\r\n");delay_ms(100);}printf("5. 连接TCP服务器成功!\n");delay_ms(100);}

4.2 mc20.h

#ifndef _MC20_H#define _MC20_H#include "stm32f10x.h"#include "usart.h"#include "delay.h"#include <string.h>u8 MC20_SendCmd(char *cmd,char *check_data);u8 MC20_InitCheck(void);u8 MC20_StartGPS(void);u8 MC20_GetGPS_Data(double *Longitude,double *latitude);u8 MC20_Connect_TCP_Server(char *server_ip,u16 port);u8 MC20_ClientSendData(u8 *buffer,u32 len);void MC20_InitConnect(char *server_ip,u16 port);#endif

五、OneNet创建产品

链接地址:https://open./develop/global/product/#/console