EC20/EC25 4G模块AT指令开发总结_ec25和ec20区别

一.EC25/20 4G模块简介

  EC25 是一系列带分集接收功能的 LTE-FDD/LTE-TDD/WCDMA/GSM 无线通信模块。
1.供电 ：
VBAT 供电电压范围：3.3V~4.3V
典型供电电压：3.8V
2.网络协议特性：
支持TCP/UDP/PPP/FTP/FTPS/HTTP/HTTPS/NTP/PING/
QMI/NITZ/SMTP/SSL/MQTT/CMUX/SMTPS/MMS*/FILE*协议
支持 PAP (Password Authentication Protocol) 和 CHAP (Challenge Handshake Authentication Protocol)协议。
3.主串口：
 用于 AT 命令传送和数据传输。
 波特率最大为 921600bps，默认为 115200bps（可通过AT指令配置修改波特率）。
 支持 RTS 和 CTS 硬件流控。
4.开关机与复位：
开机：可以通过拉低 PWRKEY 至少 500ms 使模块开机。
关机： 通过 PWRKEY 引脚控制模块关机。
    发送 AT+QPOWD 命令关机。
复位：RESET_N 引脚可用于模块复位。拉低 RESET_N 引脚 150ms~460ms 后可使模块复位。

二.AT指令总结

1.通用AT指令

 AT：测试指令，返回OK。
 ATE0：关闭回显，返回OK。
 AT+CCLK?：获取网络时间，返回格式详见参考手册。（注意此处返回的时间是基站本地时间，可能需要自己转换成北京时间）
 AT+QCCID：获取SIM卡号。返回格式详见参考手册。
 AT+CSQ：获取信号强度，返回0-31，返回99为无信号。
 AT+QPOWD：模块关机。

2.建立TCP/UDP连接相关AT指令

 AT+CPIN?：判断SIM状态是否正常，正常返回READY。
 AT+CREG?：查询网络是否注册成功，成功返回OK。
 AT+QICSGP=1,1,“MOBILE”,"","",1：配置TCP/IP环境，成功返回OK。
 AT+QIACT=1：激活TCP/IP环境，成功返回OK。
 AT+QIOPEN=1,0,“TCP”,“ip”,port,0,2：建立TCP连接（透传模式），其中ip和port要替换成实际要连接的网络值。连接成功返回CONNECT。（至此已将建立了TCP连接，可以直接透传发数据了）
 AT+QIOPEN=1,2,“UDP SERVICE”,“127.0.0.1”,0,3030,1：创建UDP服务器。成功返回OK。（至此还未建立UDP连接，不可以发数据）
 AT+QISEND=2,len,“ip”,port ：UDP准备发送数据指令，此处发送数据长度len，目的ip地址和端口号port要根据实际给定，收到">"后将数据发送出去，发送成功收到SEND OK。
 +++ ：退出TCP透传模式（发送数据完成要退出透传）。
 AT+QICLOSE=0/2 ：关闭连接（此处的0/2是连接号，由之前的AT+QIOPEN指令开启）。

三.TCP传输数据流程

1.POWERKEY开机----->2.模块联网----->3.建立TCP连接----->4.TCP发送数据----->5.等待返回数据并处理----->6.模块关机（POWERKEY或AT指令）。
详细程序：

相关支持函数：
//串口1,printf 函数
//确保一次发送数据不超过USART1_MAX_SEND_LEN字节
void fg_printf(char* fmt,...)  
{  
	u16 i=0;
	va_list ap;
	va_start(ap,fmt);
	vsprintf((char*)USART1_TX_BUF,fmt,ap);
	va_end(ap);
	i=strlen((const char*)USART1_TX_BUF);//此次发送数据的长度

     /*采用串口寄存器操作发送数据*/
//	for(j=0;j<i;j++)//循环发送数据
//	{
//		while((USART1->ISR&0X40)==0);    //循环发送,直到发送完毕   
//		USART1->TDR=USART1_TX_BUF[j];  
//	}
    
    /*采用串口HAL库函数发送数据*/
//    HAL_UART_Transmit(&huart1, (uint8_t*)USART1_TX_BUF,i, 1000);	//发送接收到的数据
//    while(__HAL_UART_GET_FLAG(&huart1, UART_FLAG_TC) != SET);		//等待发送结束
    
    /*采用DMA方式发送数据*/
    HAL_USART1_DMA_TX(&USART1TxDMA_Handler,DMA_FLAG_TC2,&huart1,USART1_TX_BUF,i);//使用DMA发送数据
    memset(USART1_TX_BUF,0,sizeof(USART1_TX_BUF));//清空缓存
}

//4G_MODULE发送命令后,检测接收到的应答
//str:期待的应答结果
//返回值:0,没有得到期待的应答结果
//    其他,期待应答结果的位置(str的位置)
u8* fg_send_check_cmd(u8 *str)
{
	char *strx=0;
    USART1_RX_BUF[USART1_RX_COUNT]=0;//添加结束符
    strx=strstr((const char*)USART1_RX_BUF,(const char*)str);
	return (u8*)strx;
}
//向4G_MODULE发送指定数据
//data:发送的数据(不需要添加回车了)
//ack:期待的应答结果,如果为空,则表示不需要等待应答
//waittime:等待时间(单位:100ms)
//返回值:0,发送成功(得到了期待的应答结果)
//       1,发送失败
u8 fg_send_cmd(u8 *data,u8 *ack,u16 waittime)
{
    waittime=waittime*100;
    fg_printf("%s\r\n",data);                //需要发送的是命令
	if(ack&&waittime)		                 //需要等待应答
	{
        while(--waittime)	                 //等待倒计时
        {
            delay_ms(1);
            if(USART1_IDLE_FLAG)             //接收到期待的应答结果
            {
                if(fg_send_check_cmd(ack))
                {
                   printf("%s ack:  %s\r\n",data,(u8*)ack);
				   memset(USART1_RX_BUF,0,sizeof(USART1_RX_BUF));//清空USART1缓存
                   USART1_IDLE_FLAG=0;
                   USART1_RX_COUNT=0;        //串口1接受数据清零
                   return 0;                 //ack正确，返回1
                }
                memset(USART1_RX_BUF,0,sizeof(USART1_RX_BUF));//清空USART1缓存
                USART1_IDLE_FLAG=0;
                USART1_RX_COUNT=0;//串口1接受数据清零
            } 
        }
	}
	return 1;                     //ack错误，返回0
}

//1.4G开机
void FourG_Power_On(void)
{
    POWERKEY(1);
    delay_ms(600);
    POWERKEY(0);
}
//2.模块联网
/**
 * @brief	4G模块联网
 *
 * @param   void
 *
 * @return  0:连接成功
 *          1:连接失败        
 */
u8 FourG_Connect_To_Internet(void)
{
    u8 i=0;
    for(i=0;i<3;i++)
    if(fg_send_cmd((u8 *)"AT",(u8 *)"OK",100)==0)break;
    if(i==3)
    {
        printf("模块状态不正常...\r\n\r\n");
        return 1;    //失败，返回1
    }
    else printf("模块状态正常...\r\n\r\n");
    
    for(i=0;i<3;i++)
    if(fg_send_cmd((u8 *)"ATE0",(u8 *)"OK",100)==0)break;
    if(i==3)
    {
        printf("关闭回显失败...\r\n\r\n");
        return 1;    //失败，返回1
    }
    else printf("关闭回显成功...\r\n\r\n");
    
    for(i=0;i<3;i++)
    if(fg_send_cmd((u8 *)"AT+CPIN?",(u8 *)"READY",10)==0)break;
    if(i==3)
    {
        printf("SIM卡状态不正常...\r\n\r\n");
        return 1;    //失败，返回1
    }
    else printf("SIM卡状态正常...\r\n\r\n");

    for(i=0;i<3;i++)
    if(fg_send_cmd((u8 *)"AT+CREG?",(u8 *)"OK",10)==0)break;
    if(i==3)
    {
        printf("CS网络注册失败...\r\n\r\n");
        return 1;    //失败，返回1
    }
    else printf("CS网络注册成功...\r\n\r\n");
    return 0;
}
//3.建立TCP连接
/**
 * @brief	4G模块建立TCP连接
 *
 * @param   ip：需要连接的ip地址
 *          port：需要连接的端口
 *
 * @return  0:建立TCP连接成功
 *          1:建立TCP连接失败        
 */
u8 FG_TCP_Connect(const u8* ip,const u8* port)
{
    u8 i=0;
    char p[50]={0};
    for(i=0;i<3;i++)
    if(fg_send_cmd((u8 *)"AT+QICSGP=1,1,\"MOBILE\",\"\",\"\",1",(u8 *)"OK",10)==0)break;
    if(i==3)
    {
        printf("配置TCP/IP环境失败...\r\n\r\n");
        return 1;    //失败，返回1
    }
    else printf("配置TCP/IP环境成功...\r\n\r\n");
    
    for(i=0;i<3;i++)
    if(fg_send_cmd((u8 *)"AT+QIACT=1",(u8 *)"OK",10)==0)break;
    if(i==3)
    {
        printf("激活TCP/IP环境失败...\r\n\r\n");
        return 1;    //失败，返回1
    }
    else printf("激活TCP/IP环境成功...\r\n\r\n");
    
    sprintf((char*)p,"AT+QIOPEN=1,0,\"TCP\",\"%s\",%s,0,2",ip,port);
    for(i=0;i<3;i++)
    if(fg_send_cmd((u8 *)p,(u8 *)"CONNECT",10)==0)break;
    if(i==3)
    {
        printf("设置TCP透传模式失败...\r\n\r\n");
        return 1;    //失败，返回1
    }
    else printf("设置TCP透传模式成功...\r\n\r\n");
    return 0;    //成功，返回0
}
//4.TCP发送数据
/**
 * @brief	TCP发送数据
 *
 * @param   data：发送的数据
 *          len：发送的数据长度
 *
 * @return  void      
 */
void FG_TCP_Send_Data(u8* data,u16 len)
{
    /*采用DMA方式发送数据*/
    HexArrayToString(data,(char*)USART1_TX_BUF,len);          //先将原始数据转成字符串
    HAL_USART1_DMA_TX(&USART1TxDMA_Handler,DMA_FLAG_TC2,&huart1,USART1_TX_BUF,2*len);//使用DMA发送数据
    memset(USART1_TX_BUF,0,sizeof(USART1_TX_BUF));            //清空缓存
}
//5.等待返回数据并处理(部分代码)
if(USART1_IDLE_FLAG)                     //串口1接收数据完毕,与NB模块通信
{
       for(i=0;i<USART1_RX_COUNT;i++)   //打印出接收到的数据
       printf("%x ",USART1_RX_BUF[i]);     
       printf("\r\n");
       memset(USART1_RX_BUF,0,sizeof(USART1_RX_BUF));       //清空缓存，以备下一次使用
       USART1_RX_COUNT=0;                                   //将接受字节数清零
       USART1_IDLE_FLAG=0;                                  //空闲中断标志复位
}
//6.模块关机
//4G关机
void FourG_Power_Off(void)
{
    POWERKEY(1);
    delay_ms(600);
    POWERKEY(0);
//    fg_printf("AT+QPOWD\r\n");           //发送关机指令
}
EC20/25 4G模块的默认串口波特率是115200，有时需要修改波特率，函数如下:
/**
 * @brief	FG模块设置波特率
 *
 * @param   void
 *
 * @return  0:设置成功
 *          1:设置失败        
 */
u8 FourG_SET_Bund(void)
{
    u8 i=0;
    for(i=0;i<3;i++)
    if(fg_send_cmd((u8 *)"AT",(u8 *)"OK",100)==0)break;
    if(i==3)
    {
        printf("模块状态不正常...\r\n\r\n");
        return 1;    //失败，返回1
    }
    else printf("模块状态正常...\r\n\r\n");
 
    for(i=0;i<3;i++)
    if(fg_send_cmd((u8 *)"AT+IPR=9600;&W",(u8 *)"OK",50)==0)break;  //设置波特率为9600并永久保存在模块中，此处波特率可根据需要修改
    if(i==3)
    {
        printf("设置9600波特率失败...\r\n\r\n");
        return 1;    //失败，返回1
    }
    else printf("设置9600波特率成功...\r\n\r\n");
    
    return 0;
}
1
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
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239

四.UDP传输数据流程

1.POWERKEY开机----->2.模块联网----->3.建立UDP连接----->4.UDP发送数据----->5.等待返回数据并处理----->6.模块关机（POWERKEY或AT指令）。
详细程序：

//相关支持函数：同上TCP
//1.4G开机：同上TCP
//2.模块联网：同上TCP
//3.建立UDP连接
/**
 * @brief	4G建立UDP连接
 *
 * @param   ip：需要连接的ip地址
 *          port：需要连接的端口
 *          socket：连接成功后返回创建的socket值
 *
 * @return  0:UDP连接成功
 *          1:UDP连接失败        
 */
u8 FG_UDP_Connect(void)
{
    u8 i=0;
    for(i=0;i<3;i++)
    if(fg_send_cmd((u8 *)"AT+QICSGP=1,1,\"MOBILE\",\"\",\"\",1",(u8 *)"OK",10)==0)break;
    if(i==3)
    {
        printf("配置TCP/IP环境失败...\r\n\r\n");
        return 1;    //失败，返回1
    }
    else printf("配置TCP/IP环境成功...\r\n\r\n");
    
    for(i=0;i<3;i++)
    if(fg_send_cmd((u8 *)"AT+QIACT=1",(u8 *)"OK",10)==0)break;
    if(i==3)
    {
        printf("激活TCP/IP环境失败...\r\n\r\n");
        return 1;    //失败，返回1
    }
    else printf("激活TCP/IP环境成功...\r\n\r\n");

    for(i=0;i<3;i++)
    if(fg_send_cmd((u8 *)"AT+QIOPEN=1,2,\"UDP SERVICE\",\"127.0.0.1\",0,3030,1",(u8 *)"OK",10)==0)break;
    if(i==3)
    {
        printf("设置UDP透传模式失败...\r\n\r\n");
        return 1;    //失败，返回1
    }
    else printf("设置UDP透传模式成功...\r\n\r\n");
    return 0;    //成功，返回0
}
//4.UDP发送数据
/**
 * @brief	UDP发送数据
 *
 * @param   ip:ip地址
 *          port：端口号
 *          data：发送的数据
 *          len：发送的数据长度
 *
 * @return  0:UDP发送成功
 *          1:UDP发送失败        
 */               
u8 FG_UDP_Send_Data(const u8* ip,const u8* port,u8* data,u16 len)
{
    u8 i=0;
    u16 waittime=1000;
    char p[50]={0};
    sprintf((char*)p,"AT+QISEND=2,%d,\"%s\",%s",2*len,ip,port);
    for(i=0;i<3;i++)
    if(fg_send_cmd((u8 *)p,(u8 *)">",10)==0)break;
    if(i==3)
    {
        printf("没有收到>发送数据失败...\r\n\r\n");
        return 1;    //失败，返回1
    }
    else printf("确认收到>开始发送数据....\r\n\r\n");
    /*采用DMA方式发送数据*/
    HexArrayToString(data,(char*)USART1_TX_BUF,len);          //先将原始数据转成字符串
    HAL_USART1_DMA_TX(&USART1TxDMA_Handler,DMA_FLAG_TC2,&huart1,USART1_TX_BUF,2*len);//使用DMA发送数据
    memset(USART1_TX_BUF,0,sizeof(USART1_TX_BUF));            //清空缓存
    while(--waittime)	                 //等待倒计时
    {
        delay_ms(1);
        if(USART1_IDLE_FLAG)             //接收到期待的应答结果
        {
            if(fg_send_check_cmd((u8 *)"SEND OK"))
            {
               printf("ack:  %s\r\n",(u8*)"SEND OK");
               memset(USART1_RX_BUF,0,sizeof(USART1_RX_BUF));//清空USART1缓存
               USART1_IDLE_FLAG=0;
               USART1_RX_COUNT=0;        //串口1接受数据清零
               return 0;                 //ack正确，返回0
            }
            memset(USART1_RX_BUF,0,sizeof(USART1_RX_BUF));//清空USART1缓存
            USART1_IDLE_FLAG=0;
            USART1_RX_COUNT=0;          //串口1接受数据清零
        } 
    }
    return 1;                 //ack错误，返回1
}
//5.等待返回数据并处理,由于UDP不是透传模式，因此需要最接收到的数据进行处理，具体可自行处理
if(USART1_IDLE_FLAG)                     //串口1接收数据完毕,与NB模块通信
{
                   received_length=0;
                   printf("接收到的UDP数据是：%s\r\n",USART1_RX_BUF);
                   /*判断是否有来自服务器的数据*/
                   str1=fg_send_check_cmd(portnum);  //判断接受到的数据是否有+NSONMI:
                   str2=str1+portlen+2;              //获得数据区域的首地址
                   while(str2!=&USART1_RX_BUF[USART1_RX_COUNT-2])   //未到倒数第二位
                   {
                       str2++;                       //接收缓存区向下进一个位置
                       received_length++;            //接收字节数加一
                       if(received_length>180)break; //如果接收数据大于180，则判断接收错误，退出while()循环
                   }
                   printf("received_length=%d\r\n",received_length);
                   memmove(USART1_RX_BUF,str1+portlen+2,received_length);
                   USART1_RX_COUNT=received_length;
                   USART1_RX_BUF[USART1_RX_COUNT]=0;

               	   for(i=0;i<USART1_RX_COUNT;i++)
                   printf("%x ",USART1_RX_BUF[i]);     
                   printf("\r\n");
}
//6.模块关机：同上TCP
1
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

五.总结

4G通信作为如今的主流通信方式有着十分广泛的用途，移远公司的EC20/25作为主流的4G通信模块有很广泛的使用，另外此模块还具有其他很多强大的功能，如低功耗模式，GNSS定位功能，可自己开发。TCP/UDP作为主流的传输协议，本文提供了详细的开发流程，可作为参考。