由于项目需求,产品需要入库电信平台,我们项目只需完成自注册即可,其实都差不多,具体协议需要看电信白皮书。
自注册要求
格式:
1.消息类型:HTTP POST
2.内容类型:Content-Type=application/encrypted-json
3.报文信息格式:JSON
触发自注册条件:
1.更换SIM卡 (每次换卡需要重新上传自注册信息)
2.时间超过30天(距离上一次注册的时间大于等于30天)
3.OTA版本升级(不一定必须有OTA功能,更新程序也可以归为OTA,例如烧写器,远程升级等)
产品要求
下面是对产品的要求,非产品自注册,是自注册另外对产品的要求。
如果用的是4G模块的产品,没有屏幕就需要把"型号",“软硬件版本”,"操作系统"通过串口助手打印出来,其他要求要通过AT指令或者屏幕实现
AT指令
下面AT指令是产品进行自注册的流程(EC800,其他模块需要看它具体的AT指令手册)
开机自动打印信息
MODEL: xxxx
SWVER: V1.0
HWVER: V1.0
OSVER: RTOS1.0
MODEL: xxxx 此产品型号必须和提交的资料产品型号保持一致
1.AT
2.ATE0
3.AT+CPIN?
4.AT+CGREG?
5.AT+QIDEACT=1
6.AT+CSQ
7.AT+QCCID
SIM卡的ICCID需要上传的平台,并且当SIM卡更换时,需要重新注册,所以ICCID需要保存到产品内。
8.AT+CREG?
SIM卡 SIM1CELLID需要上传
9.AT+CIMI?
查询IMSI
10.AT+GSN=1
查询IMEI
拼接字符串
上面所有需要的SIM卡信息获取完后,就需要拼接字符串了,格式为JSON
具体上传哪一部分协议,和字符串的具体内容,需要看做的是什么产品和白皮书。
{“REGVER”: “12.0”,“MEID”: “”,“MODEL”: “xxxx”,“SWVER”: “V1.0”,“SIM1CDMAIMSI”: “”,“UETYPE”: “6”,“SIM1ICCID”: “8986112323xxx9900xxx”,“SIM1LTEIMSI”: “46011xxx7540xxx”,“SIM2CDMAIMSI”: “”,“SIM2ICCID”: “”,“SIM2LTEIMSI”: “”,“MACID”: “”,“OSVER”: “RTOS1.0”,“IMEI1”: “XXX690070160XXX”,“IMEI2”: “”,“SIM1CELLID”: “XXX650C”,“SIM2CELLID”: “”,“5GSW1”: “2”,“5GSW2”: “”,“NWTYPE1”: “4”,“NWTYPE2”: “”,“DATASIM”: “1”,“ROM”: “256G”,“RAM”: “32G”,“ACCESSTYPE”: “1”}
Base64加密
字符串拼接完成后,需要Bas把内容Base64加密。
//C文件
#include "base64.h"
#include <stdint.h>
#include <stdio.h>
#define BASE64_SIZE_T_MAX ( (size_t) -1 )
static const unsigned char base64_enc_map[64] =
{
'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J',
'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S', 'T',
'U', 'V', 'W', 'X', 'Y', 'Z', 'a', 'b', 'c', 'd',
'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n',
'o', 'p', 'q', 'r', 's', 't', 'u', 'v', 'w', 'x',
'y', 'z', '0', '1', '2', '3', '4', '5', '6', '7',
'8', '9', '+', '/'
};
static const unsigned char base64_dec_map[128] =
{
127, 127, 127, 127, 127, 127, 127, 127, 127, 127,
127, 127, 127, 127, 127, 127, 127, 127, 127, 127,
127, 127, 127, 127, 127, 127, 127, 127, 127, 127,
127, 127, 127, 127, 127, 127, 127, 127, 127, 127,
127, 127, 127, 62, 127, 127, 127, 63, 52, 53,
54, 55, 56, 57, 58, 59, 60, 61, 127, 127,
127, 64, 127, 127, 127, 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, 127, 127, 127, 127, 127, 127, 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, 127, 127, 127, 127, 127
};
int BASE64_Encode(unsigned char *dst, size_t dlen, size_t *olen,
const unsigned char *src, size_t slen)
{
size_t i = 0, n = 0;
int C1 = 0, C2 = 0, C3 = 0;
unsigned char *p = (void *)0;
if(slen == 0)
{
*olen = 0;
return 0;
}
n = slen / 3 + (slen % 3 != 0);
if(n > (BASE64_SIZE_T_MAX - 1) / 4)
{
*olen = BASE64_SIZE_T_MAX;
return MBEDTLS_ERR_BASE64_BUFFER_TOO_SMALL;
}
n *= 4;
if((dlen < n + 1) || (NULL == dst))
{
*olen = n + 1;
return MBEDTLS_ERR_BASE64_BUFFER_TOO_SMALL;
}
n = (slen / 3) * 3;
for(i = 0, p = dst; i < n; i += 3)
{
C1 = *src++;
C2 = *src++;
C3 = *src++;
*p++ = base64_enc_map[(C1 >> 2) & 0x3F];
*p++ = base64_enc_map[(((C1 & 3) << 4) + (C2 >> 4)) & 0x3F];
*p++ = base64_enc_map[(((C2 & 15) << 2) + (C3 >> 6)) & 0x3F];
*p++ = base64_enc_map[C3 & 0x3F];
}
if(i < slen)
{
C1 = *src++;
C2 = ((i + 1) < slen) ? *src++ : 0;
*p++ = base64_enc_map[(C1 >> 2) & 0x3F];
*p++ = base64_enc_map[(((C1 & 3) << 4) + (C2 >> 4)) & 0x3F];
if((i + 1) < slen)
*p++ = base64_enc_map[((C2 & 15) << 2) & 0x3F];
else *p++ = '=';
*p++ = '=';
}
*olen = p - dst;
*p = 0;
return 0;
}
int BASE64_Decode(unsigned char *dst, size_t dlen, size_t *olen,
const unsigned char *src, size_t slen)
{
size_t i = 0, n = 0;
uint32_t j = 0, x = 0;
unsigned char *p = (void *)0;
for(i = n = j = 0; i < slen; i++)
{
x = 0;
while(i < slen && src[i] == ' ')
{
++i;
++x;
}
if(i == slen)
break;
if((slen - i) >= 2 &&
src[i] == '\r' && src[i + 1] == '\n')
continue;
if(src[i] == '\n')
continue;
if(x != 0)
return MBEDTLS_ERR_BASE64_INVALID_CHARACTER;
if(src[i] == '=' && ++j > 2)
return MBEDTLS_ERR_BASE64_INVALID_CHARACTER;
if(src[i] > 127 || base64_dec_map[src[i]] == 127)
return MBEDTLS_ERR_BASE64_INVALID_CHARACTER;
if(base64_dec_map[src[i]] < 64 && j != 0)
return MBEDTLS_ERR_BASE64_INVALID_CHARACTER;
n++;
}
if(n == 0)
{
*olen = 0;
return 0;
}
n = (6 * (n >> 3)) + ((6 * (n & 0x7) + 7) >> 3);
n -= j;
if(dst == NULL || dlen < n)
{
*olen = n;
return MBEDTLS_ERR_BASE64_BUFFER_TOO_SMALL;
}
for(j = 3, n = x = 0, p = dst; i > 0; i--, src++)
{
if(*src == '\r' || *src == '\n' || *src == ' ')
continue;
j -= (base64_dec_map[*src] == 64);
x = (x << 6) | (base64_dec_map[*src] & 0x3F);
if(++n == 4)
{
n = 0;
if(j > 0)
*p++ = (unsigned char)(x >> 16);
if(j > 1)
*p++ = (unsigned char)(x >> 8);
if(j > 2)
*p++ = (unsigned char)(x);
}
}
*olen = p - dst;
return 0;
}
//H文件
#ifndef _BASE64_H
#define _BASE64_H
#include <stddef.h>
#define MBEDTLS_ERR_BASE64_BUFFER_TOO_SMALL -0x002A /**< Output buffer too small. */
#define MBEDTLS_ERR_BASE64_INVALID_CHARACTER -0x002C /**< Invalid character in input. */
#ifdef __cplusplus
extern "C" {
#endif
int BASE64_Encode(unsigned char *dst, size_t dlen, size_t *olen,
const unsigned char *src, size_t slen);
int BASE64_Decode(unsigned char *dst, size_t dlen, size_t *olen,
const unsigned char *src, size_t slen);
#ifdef __cplusplus
}
#endif
#endif
11.AT+QIOPEN=1,0,“TCP”,“XXXX.XX.cn”,9998,0,1
TCP连接XXX服务器
服务器连接成功后,由于模块没有HTTP功能,需要用TCP模拟HTTP去进行连接(模块带有HTTP功能可忽略此步骤)
拼接HTTP协议
POST / HTTP/1.1
Content-Type: application/encrypted-json
Host: XXXX.XX.cn:9998 //服务器和上面的服务器地址一样的
Content-Length: 604
12.AT+QISEND=0,711
TCP发送到服务器,上面拼接的HTTP和加密的内容
接收:
+QIURC: “recv”,0,204
HTTP/1.1
[13:52:20.268]收←◆ 200 OK
Server: unknown/2.4.5
Date: Fri, 06 Sep 2024 05:52:20 GMT
Content-Type: text/html;charset=UTF-8
Content-Length: 42
Connection: keep-alive
{“resultDesc”:“Success”,“resultCode”:“0”}
返回发送成功,数据上传完毕。