OneMO模组说｜技术学堂-ML307A开发指南（一） OpenCPU模式网络初始化流程介绍

已于 2023-06-13 19:06:11 修改
阅读量5.6k 收藏 13
点赞数
分类专栏： OneMO模组说 文章标签： 物联网 信息与通信 嵌入式硬件
于 2023-06-13 19:03:41 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/GY6866/article/details/131193699
版权

OpenCPU网络初始化流程至关重要，是模组正常连接服务器应用的前提。流程包含读取模组IMEI/SN、读取SIM卡IMSI/ICCID和模组PDP激活状态三个环节。本文介绍了ML307A模组OpenCPU模式网络初始化的相关接口、demo代码解析、demo运行示例以及常见问题。

图1 网络初始化流程

一、相关接口

模组的IMEI/SN获取接口可在include\cmiot\cm_sys.h中查看，SIM卡IMSI/ICCID获取接口可以在include\cmiot\cm_sim.h中查看，PDP激活状态查询可以在include\cmiot\cm_modem.h中查看。

1.1 获取模组IMEI

/**

 * @brief 获取模组IMEI

 *

 * @param [out] imei IMEI，长度16字节

 *

 * @return 

 *   = 0  - 成功 \n

 *   < 0  - 失败, 返回值为错误码

 *  

 * @details More details

 */

int32_t cm_sys_get_imei(char *imei);

模组正常开机成功之后即可调用该接口获取模组IMEI，返回0表示获取成功，小于0表示获取失败；

1.2 获取模组SN

/**

 * @brief 获取模组SN

 *

 * @param [out] sn SN，长度32字节

 *

 * @return 

 *   = 0  - 成功 \n

 *   < 0  - 失败, 返回值为错误码

 *  

 * @details More details

 */

int32_t cm_sys_get_sn(char *sn);

模组正常开机成功之后即可调用该接口获取模组SN，返回0表示获取成功，小于0表示获取失败；

1.3 获取SIM卡IMSI

/**

 * @brief 获取设备IMSI

 *

 * @param [out] imsi 存储IMSI，长度16字节，申请内存后传入

 * @return  

 *   = 0  - 成功 \n

 *   < 0  - 失败, 返回值为错误码.

 *  

 * @details More details

 *

 */

int32_t cm_sim_get_imsi(char* imsi);

模组正常开机且正常识别到SIM卡之后即可调用该接口获取SIM卡的IMSI，返回0表示获取成功，小于0表示获取失败；

1.4 获取SIM卡ICCID

/* 获取ICCID示例，注意虚拟AT通道传入的指令为"AT*ICCID?\r\n" */

void cm_demo_iccid(void)

模组正常开机且正常识别到SIM卡之后即可调用该接口获取SIM卡ICCID，获取ICCID采用虚拟AT指令的方式进行获取，需要注意使用虚拟AT通道之前需要先进行虚拟通道初始化；

1.5 PDP状态查询

int32_t cm_modem_get_pdp_state(uint16_t cid)

模组开机后默认会自动进行第一路PDP激活，该接口调用虚拟AT指令进行激活查询，CID为PDP上下文编号，返回值为虚拟AT指令查询到的PDP状态，返回1表示激活成功，返回0表示激活失败。

二、demo代码解析

在SDK提供的demo中，已经实现模组IMEI/SN和SIM卡的IMSI/ICCID的获取，以及PDP激活状态查询，下面我们详细看一下cm_demo_main.c文件中相关部分的代码。

2.1 获取模组IMEI

#define CM_VER_LEN       65 /*< 存储长度> */

char buf[CM_VER_LEN] = {0};/*定义字符串buf并初始化为零 */

 int ret;

memset(buf, 0, CM_VER_LEN); /*存储的buf清零 */

    ret = cm_sys_get_imei(buf); /*调用函数获取IMEI 并存到buf*/

    if (ret == 0)

    {

        cm_demo_printf("IMEI:%s\n", buf);/*接口函数返回值等于0则获取正常，进行串口打印输出IMEI */

    }

    else

    {

        cm_demo_printf("IMEI ERROR\n");/*接口函数返回值不等于0则打印报错 */

    }

这里建立一个buf数组，用于存储IMEI字符串，先进行buf清空，然后获取IMEI，最后使用串口打印函数输出；

2.2 获取模组SN

  memset(buf, 0, CM_VER_LEN);/*存储的buf清零 */

    ret = cm_sys_get_sn(buf); /*调用函数获取模组SN并存到buf*/

    if (ret == 0)

    {

        cm_demo_printf("SN:%s\n", buf);/*接口函数返回值等于0则获取正常，进行串口打印输出SN */

    }

    else

    {

        cm_demo_printf("SN ERROR\n");/*接口函数返回值不等于0则打印报错 */

    }

首先进行buf清空，然后获取模组SN，最后使用串口打印函数输出；

2.3 获取SIM卡IMSI

    memset(buf, 0, CM_VER_LEN);/*存储的buf清零 */

    ret = cm_sim_get_imsi(buf);/*调用函数获取SIM卡IMSI并存到buf*/

    if (ret == 0)

    {

        cm_demo_printf("IMSI:%s\n", buf);/*接口函数返回值等于0则获取正常，进行串口打印输出IMSI */

    }

    else

    {

        cm_demo_printf("IMSI ERROR\n");/*接口函数返回值不等于0则打印报错 */

    }

首先进行buf清空，然后获取SIM卡IMSI，最后使用串口打印函数输出；

2.4 获取SIM卡ICCID

​

    /* 获取ICCID示例，注意虚拟AT通道传入的指令为"AT*ICCID?\r\n" */

cm_demo_iccid();

/* 获取ICCID示例，注意虚拟AT通道传入的指令为"AT*ICCID?\r\n" */

void cm_demo_iccid(void)

{  

/* 初始化AT虚拟通道，注册AT虚拟通道消息回调函数*/

    if(cm_virt_at_init(iccid_resp_cb)!=0)

{

/* 初始化AT虚拟通道接口返回值不等于0，则串口打印始化AT虚拟通道错误*/

       cm_demo_printf("cm_virt_at_init  err");  

        return;

}

/* 初始化AT虚拟通道接口返回值等于0则发送虚拟AT指令"AT*ICCID?\r\n"*/

    if(cm_virt_at_send((uint8_t *)"AT*ICCID?\r\n",strlen("AT*ICCID?\r\n")) < 0)

{

* AT虚拟通道发送数据接口返回值小于0则打印AT虚拟通道发送数据错误*/

        cm_demo_printf("cm_virt_at_send err");  

        return;

    }

osDelay(500);

/* AT指令发送完成后进行AT虚拟通道去初始化*/

    cm_virt_at_deinit();    

}

/* AT虚拟通道消息回调函数用于接收AT指令的返回值*/

void iccid_resp_cb(void * param)

{

/* 定义at_data字符串用于存储AT指令的返回值*/

unsigned char at_data[256]={0};

/* 将AT虚拟通道回调函数返回的字符串转换成整型数，不能转换则打印原始数据*/

    if(atoi(param) ==  0)

{    

/* 通过AT虚拟通道接收数据并存入at_data字符串*/   

        cm_virt_at_get(at_data,sizeof(at_data));

/* 打印AT指令返回值*/ 

        cm_demo_printf("%s\n", at_data);        

    }

    /* 将AT虚拟通道回调函数返回的字符串转换成整型数*,转换成功则打印ICCID*/

else if(atoi(param) == 1)

{

/* 通过AT虚拟通道接收数据并存入at_data字符串*/ 

        cm_virt_at_get(at_data,sizeof(at_data));

/* 打印AT指令返回值*/ 

        cm_demo_printf("*ICCID:%s\n", at_data);  

    }

}
​

首先调用函数cm_virt_at_init进行虚拟AT通道初始化，然后发送虚拟AT指令“AT+ICCID?”获取ICCID，通过虚拟AT通道的回调函数iccid_resp_cb打印获取到的ICCID；

2.5查询pdp激活状态

  /*  定义PDP查询次数整型变量并初始化为0*/ 

int pdp_time_out=0;

 while(1)

{ 

/* PDP查询次数大于10次则打印网络超时*/ 

        if(pdp_time_out>10) 

        {

            cm_demo_printf("network timeout\n");

            break;

        }

/* PDP状态查询为1则打印network ready并跳出循环*/ 

        if(cm_modem_get_pdp_state(1) == 1)

        {

            cm_demo_printf("network ready\n");        

            break;

        }

/* 延时1秒PDP查询次数加一*/ 

        osDelay(200);  

        pdp_time_out++;

    }

以1秒的间隔循环查询PDP激活状态10次，如果次数超过则打印网络超时，如果PDP状态激活成功则打印网络准备好。

三、demo运行示例

上面提到在cm_demo_main.c中，已经实现读取模组IMEI/SN，SIM卡的IMSI/ICCID，以及PDP激活状态查询，下面是cm_demo_main.c运行示例。

[05-04 17:49:19:868]CM OpenCPU Starts  //开机成功，opencpu程序开始运行，通过UART0，9600波特率进行打印

[05-04 17:49:19:883]SDK VERSION:ML307A_OpenCPU_Standard_1.3.1.2304071557_release  //SDK版本号获取

[05-04 17:49:19:964]fs total:262144,remain:184320  //文件系统信息获取

[05-04 17:49:19:995]heap total:1310716,remain:664352 //系统heap状态获取

[05-04 17:49:20:027]waiting for network...  //等待网络激活，超时时间设置为10秒

[05-04 17:49:25:240]network ready    //网络初始化成功打印

[05-04 17:49:26:279]Now:2023-5-4:17:49:27,Thursday  //获取当前时间

[05-04 17:49:26:311]SN:20209P1001531A000014 //SN号获取

[05-04 17:49:26:343]IMEI:864606060109344 //IMEI获取

[05-04 17:49:26:359]IMSI:460042726515520 //IMSI获取

[05-04 17:49:26:424]*ICCID: "89860407112270005520" //ICCID获取

[05-04 17:49:28:953]

[05-04 17:49:28:953]please input cmds:   

四、常见问题

  1. 为什么获取不到SIM卡IMSI和ICCID?

获取SIM卡IMSI和ICCID需要保证SIM卡电路设计正常，插拔卡方向正确，SIM卡硬件正常才能获取到IMSI和ICCID。

  1. 网络超时等待时间是否可以自行配置？

可以的，网络超时的时间间隔在不同的网络环境可能存在差异，可自行配置来保证有足够的时间来完成网络激活。

  1. 是否所有的AT指令都可以采用虚拟AT指令？

   虚拟AT不完全支持OneMO AT手册中的指令，仅支持3GPP的AT指令。

  1. 激活PDP失败的原因？

   PDP是在开机读卡之后自动激活的，激活失败需要排查SIM卡是否存在欠费、机卡绑定、未激活问题。

GY6866
关注
  • 0
    点赞
  • 踩
  • 13
    收藏
    觉得还不错? 一键收藏
  • 2
    评论
专栏目录
ML307A模组使用MQTT协议连接ONENET平台
s19933183110的博客
08-21 2698
在我测试过程中，使用AT+MQTTCONN命令连接ONENET平台，返回+MQTTURC: “conn”,0,1。按照参考文档试了一天多都没成功，后面我用MQTT.fx工具测试这几个参数，完全是没问题的。ONENET平台接入文档，链接：https://open.iot.10086.cn/doc/v5/fuse/detail/919。模组的资料去ONEMO网站下载，链接：http://onemo10086.com/#/product/detail/82。设备使用mqtt连接时，需要用到三个参数，分别为。
ML302-ML305-ML306-OpenCPU-编程设计指导手册-V1.1.0
12-30
中国移动ML302的模组的二次开发的OpenCPU_编程设计指导手册_V1.1.0
OneMO模组说｜技术学堂-ML307A开发指南（三） OpenCPU UDP及TCP使用介绍
GY6866的博客
06-13 2703
UDP/TCP是物联网通信中常用的一种基础通信协议，是TCP/IP协议的核心。其中TCP是面向连接、可实现端到端可靠数据包发送；UDP是无连接的，无超时重发机制，数据流传输不完全可靠，但传输速度比TCP更快。本文从使用流程、SDK demo测试、TCP测试示例和常见问题四个方面介绍了如何快速实现ML307A模组的UDP/TCP双向通信功能。
ml307A模块连接阿里云（详细版）
最新发布
weixin_58125062的博客
06-16 540
ml307A模块连接阿里云（详细版）
中移物联OneMO Cat.1模组推动联网POS规模应用
GY6866的博客
05-24 445
在第三方支付蓬勃发展和消费模式不断革新的时代背景下，新型联网POS终端以其智能化、便捷化的特点丰富人们生活便利度。在这一变革浪潮中，中移物联OneMO Cat.1模组ML307R凭借其卓越的性能和成本效益，成为推动联网POS规模应用的重要力量。
ML307A模组连接Onenet平台流程及注意事项
guijianwuming的专栏
09-14 3078
ML307A是一款LTE Cat.1无线上网模组，可以广泛应用于各种消费级、工业级产品上。在使用低功耗产品上会去连接到Onenet平台上，则要采用LwM2M协议连接Onenet平台。
OPENCPU学习---开发环境搭建
笑看人生
01-05 2260
OPENCPU学习---开发环境搭建
OneMO模组说｜技术学堂-ML307A开发指南（二） OpenCPU HTTP及HTTPS使用介绍
GY6866的博客
06-13 4177
HTTP是一个简单的请求-响应协议，在物联网设备中使用非常广泛，可向HTTP服务器获取数据、推送数据、下载服务器上的文件、OTA远程升级等。ML307A OpenCPU SDK提供的HTTP API接口最大支持创建4路HTTP实例，且支持GET、POST和PUT等常用请求方法。 本文从使用流程、demo代码、OneNET平台对接示例及常见问题四个方面对ML307A模组OpenCPU的HTTP及HTTPS功能进行了介绍。
【Python】基于ML307A的位置读取系统（通过UART串口实现AT指令和flask来实现自动化读取并推流）
网易独家音乐人Mike Zhou的博客
04-12 1956
【Python】基于ML307A的位置读取系统（通过UART串口实现AT指令和flask来实现自动化读取并推流）
OneMO模组说｜技术学堂-硬件篇（三）模组电源原理图设计指南
GY6866的博客
05-10 1352
在模组的外围电路设计中，合理的供电设计是保障模组正常运行的前提。本文将从电源电路设计、电容设计以及供电控制电路设计等方面阐述模组外围电路设计的注意事项。
OpenCPU入门基础
m0_37777700的博客
12-17 2684
1、打开工程软件：sublime_text.exe G:\ProjectFile\BC26 全网通 NBIOT openCPU开发板V3.0\5.程序代码\BC26模块openCPU代码\sublimetext3\Sublime Text Build 3176 x64 2、打开编程软件 3、选择工程示例 4、打开工程，查看宏定义 5、打开GPIO程序 6、修改工程文件 7、！！！修改完成后，选择保存，不然编译的文件为未保存前的文...
移远BC26模组 OPENCPU开发 SDK开发包
03-08
移远BC26模组 OPENCPU开发 SDK开发包，OPENCPU开发，NB模块
opencpu:用于嵌入式科学计算和可重复研究的OpenCPU系统
05-09
Opencpu的 产生和复制结果 一个用于使用R进行嵌入式科学计算和可重复研究的系统。OpenCPU服务器公开了一个简单但功能强大的HTTP api，用于RPC和与R进行数据交换。这为统计服务或构建R Web应用程序提供了可靠且可扩展的基础。 OpenCPU服务器既可以作为交互式R会话中的单用户开发服务器运行，也可以基于Apache2的多用户Linux堆栈运行。 整个系统是完全开源的，并已获得许可。 OpenCPU网站上有​​详细的文档和示例应用程序。 文献资料 官方 论文： 示例 JavaScript客户端： 服务器手册： 云服务器 要在Ubuntu Server上安装云服务器： # requires Ubuntu 20.04 (Focal) sudo add-apt-repository -y ppa:opencpu/opencpu-2.2 sudo apt-get upda
ML307R OpenCPU MQTT使用
06-01
**ML307R OpenCPU MQTT使用指南** 在物联网（IoT）领域，MQTT（Message Queuing Telemetry Transport）是一种轻量级的发布/订阅式消息协议，广泛应用于资源有限的设备通信。ML307R是一款适用于物联网应用的微控制器...
ML307R OpenCPU GPIO使用
05-26
**ML307R OpenCPU GPIO使用详解** ML307R是一款基于嵌入式处理器的OpenCPU（开放式中央处理器）平台，它提供了丰富的GPIO（通用输入/输出）接口，适用于各种控制和交互应用。GPIO是微控制器或SoC（系统级芯片）中的...
ML307R OpenCPU TCP使用
05-28
1. **初始化网络接口**：配置ML307R的网络接口，包括设置IP地址、子网掩码、网关等网络参数，以及启动TCP/IP协议栈。 2. **创建TCP套接字**：使用特定的API函数创建一个TCP套接字，指定其为服务器端或客户端模式。 ...
ML307R OpenCPU UDP使用
05-28
ML307R OpenCPU UDP使用
中移模组ml307a开发
12-21
中移物联网的ML307A开发板是一款支持4G Cat.1网络的开发板。它提供了丰富的功能和接口，适用于物联网应用的开发和测试。以下是使用ML307A开发板的一些基本步骤： 1. 准备工作： - 确保你已经获得了ML307A开发板，并且具备相应的开发环境。 - 参考官方文档，了解ML307A开发板的硬件规格和接口定义。 2. 连接硬件： - 将ML307A开发板与电脑通过USB线连接。 - 确保开发板上的电源和信号灯正常工作。 3. 配置开发环境： - 安装并配置ML307A开发板所需的开发工具和驱动程序。 - 确保你已经正确设置了串口通信参数。 4. 编写代码： - 使用你熟悉的编程语言（如C、C++、Python等）编写应用程序。 - 根据ML307A开发板的文档，使用相应的API和库函数进行开发。 5. 编译和烧录： - 使用开发工具将你的代码编译成可执行文件。 - 将编译后的文件通过串口或其他方式烧录到ML307A开发板中。 6. 测试和调试： - 运行你的应用程序，测试ML307A开发板的功能和性能。 - 根据需要，使用调试工具进行调试和性能优化。 请注意，以上步骤仅为一般性指导，具体的操作步骤可能会因开发环境和需求而有所不同。建议你参考ML307A开发板的官方文档和示例代码，以获取更详细的信息和指导。
评论 2
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值