ML307R SDK开发--OpenCPU应用程序开发学习笔记(1)

ML307R OpenCPU丨APP_DEMO_SDK使用介绍 ML307R_APP_DEMO_SDK是在ML307R_OpenCPU_Standard_SDK标准代码基础上,新增了面向用户APP层的demo示例,区别于标准代码中的examples的示例代码,app_demo里已对用户常用参数进行提取,用户简单修改参数后即可实现联网自动化、数据透传、FOTA等功能,且各功能均可独立自动运行。 阅读详情
AI摘要

本文是OpenCPU相关学习笔记,介绍了OpenCPU可简化通信终端开发流程。详细阐述了OpenCPU SDK开发包内容,编译环境的要求、搭建与编译方法,还说明了SDK开发流程,包括用户入口函数、示例程序测试、添加源文件和库文件、制作库文件等,此外提及驱动安装和SDK API简介。

1:前言

        先了解一下什么是OpenCpu,OpenCPU是一种以模块作为主处理器的应用方式。这种方式可以简化用户对通信终端的开发流程,精简硬件结构设计,从而满足客户对成本、功耗、安全性等方面的需求。

        举个最简单的例子,在做mcu+4G模块相关开发的时候是mcu通过串口向4G模块发送AT指令然后4G模块返回响应。

        而有了OpenCpu的出现就不需要再有mcu这个东西了,直接在模组内进行开发

       这样就可以大大的优化了产品设计的大小和开发流程。

         此为博主个人学习笔记记录内容,相关资料信息内容均为公开资料,如有需要评论区见。

        本文在Windows7/Windows10 X64环境下,我在Windows11上试了一下也没出现报错。

        使用的模组系列型号:ML307R

        模组子型号:ML307R-DC

2:SDK开发包

        OpenCPU SDK开发包内含交叉编译器,必要的库文件和头文件以及示例程序等;解压后的文件内容图:     

SDK开发包文件说明:

custom存放用户空白工程,自己开发程序存放路径
doc存放参考文档
examples存放示例程序
include存放头文件
out存放编译生成的中间文件、版本文件、固件生成后存放的位置。
prebuild存放厂商提供的库文件、中间文件等
src存放cmiot库源码
tools存放交叉编译链、脚本工具、配置文件等

对于这个模组的硬件属性我在这就做简单的介绍:

模组主要应用接口包括:
▪ POWER接口
▪ UART接口
▪ USIM接口
▪ GPIO接口
▪ RF接口
▪ USB接口
▪ ANALOG接口
▪ SPI接口
▪ IIC接口
▪ AUDIO接口
▪ CONTROL接口
▪ LCD接口
▪ KEYPAD接口
▪ GND接口
▪ RESERVED接口

        引脚定义类型、状态以及参数

AI

模拟输入信号

信号类型

AO

模拟输出信号

AIO

模拟输入输出双向信号

DI

数字输入信号

DO

数字输出信号

DIO

数字输入输出双向信号

PI

电源输入信号

PO

电源输出信号

IO

输入输出双向信号

SI

施密特输入信号

OD

开漏输出信号

OC

开集输出信号

BOD

开漏输入输出双向信号

BOC

开集输入输出双向信号

RF

射频信号

OL

输出低电平

默认状态

OH

输出高电平

Z

高阻态

Float

浮空

PU

默认上拉

PD

默认下拉

VIH

高电平输入电压

参数

VIL

低电平输入电压

VOH

高电平输出电压

VOL

低电平输出电压

详细的硬件设计要求查看硬件手册,有需要评论区。

3:编译环境

3.1:编译环境要求

        OpenCPU SDK开发包,仅支持在Windows 7/Windows 10 X64环境下开发和编译,需预安装python3.7以上版本,安装完python后,打开命令行执行

pip install scons

安装scons工具。

        想要知道自己电脑安装的python版本是多少符不符合要求,在终端输入命令即可查看

python --version

安装scons工具直接输命令就行了

pip install scons

3.2 搭建编译环境

        OpenCPU SDK开发包自带交叉编译工具,使用前解压开发包至任意非中文路径下即可进行编译。请注意解压路径不能包含中文、空格及“&”符号。

        其实就是在解压后的SDK包里面不能有中文和其他符号就行了。

3.3 编译SDK

        SDK编译命令为scons
        执行以下步骤编译SDK:
                1. 确认模组硬件版本。
                2. 在SDK根目录下,打开命令行执行scons -c清除历史编译信息。
                3. 执行scons启动编译。
        如无编译错误,可在out/image/目录下获取编译生成的软件版本。

4:SDK开发流程

 4.1:用户入口函数

个人开发保存的位置在上面提到的custom文件夹中

用户入口函数cm_opencpu_entry()会在系统初始化过程中被调用;用户可在此函数中执行必要的初始化、用户线程创建等操作。就在custom\custom_main\src里面的custom_main.c里面。

4.2 示例程序说明

        OpenCPU程序示例覆盖大部分API,用户通过cm_demo_main.c中的命令数组可获取API示例程序的入口函数;通过串口发送命令即可测试示例代码。
        测试示例代码前需下载默认的demo版本固件至模组中。
        参照以下步骤完成示例代码测试:
1. 模组开机。
        开机后,串口会打印如下信息。不同型号模组及OpenCPU SDK版本打印信息存在差异,请以实际为准。


CM OpenCPU Starts
Compile Time:20211109172220
Boot Cause:6
SDK VERSION:ML302_OpenCPU_Standard_1.0.0.202111091716_release
BASELINE VERSION:8910_Module_V1_4_W21.31.2__20210810_1531
fs total:1441792,remain:339000
heap total:2864576,remain:1581472
sim ready
waiting for network...
[NET_REGISTER]:state:7
[NET_REGISTER]:PDP not ready
[NET_REGISTER]:state:2
[NET_REGISTER]:SIM ready
[NET_REGISTER]:state:3
[NET_REGISTER]:Attaching
[NET_REGISTER]:state:5
[NET_REGISTER]:Attach success
[NET_REGISTER]:state:8
[NET_REGISTER]:PDP ready
network ready
Now:2021-12-9:17:21:52,Tuesday
SN:92588066126970
IMEI:352273017386340
IMSI:460047933913534
ICCID:89860459112190003534
cm_test_asocket_init
please input cmds:


2. 按如下命令格式,通过串口输入命令,执行测试。
        CM:FUNC:PARAM1:PARAM2:PARAM3......
        ▪ FUNC代表命令名称,可在cm_demo_main.c的命令数组中查询;
        ▪ PARAM代表参数,参数间以冒号(:)分隔。

4.3 添加源文件

        添加源文件主要是在custom/路径下添加源文件和将custom路径加入头文件搜索路径为例说明操作步骤。
        添加流程:

        1. 打开custom/SConscript
        2. 在ram_source_fles列表中增加的源文件,其代码段运行于内存中;若模组支持XIP模式,则可在flash_source_fles列表中增加以XIP模式运行的源文件,代码段运行于Flash中。
        3. 在public_incs列表中增加公共头文件,private_incs列表中增加私有头文件。
        4. 可在cpp_defnes列表中添加模块私有的宏定义,仅对本模块生效

Sconscript内容:

4.4 添加库文件

        本节以在prebuild/libs路径下添加libxxx.a库文件为例说明操作步骤。
        参照以下步骤添加库文件:
                1. 打开tools/scons/EnvironConfig.py。
                2. 在BuildConfg->LIBS列表中添加xxx变量。
                3. 在BuildConfg->LIBPATH列表中添加libxxx.a的存放路径。

4.5 制作库文件

制作流程:

        1. 确定需要打包的目标文件,如out\obj\examples\adc\src\cm_demo_adc.o和out\obj\examples\mqtt\src\cm_demo_mqtt.o。
        2. 在命令行环境下,进入SDK根目录,选择SDK中的ar工具,执行打包命令。如"tools/toolchain/gcc-armnone-eabi/bin/arm-none-eabi-ar.exe" qc liboc_demo.a out/obj/examples/adc/src/cm_demo_adc.o out/obj/examples/mqtt/src/cm_demo_mqtt.o。
根目录下生成liboc_demo.a库文件,该文件可替代上述两个目标文件参与编译链接。

5:驱动安装

驱动在压缩包里面的ASR_Drivers文件夹里面

直接运行就可以了。

固件下载就不做具体介绍了,每一个的工具都有不同,有可用的就可以了。

6:SDK API简介

        SDK中API含操作系统接口、网络接口、模组基础功能接口和硬件外设接口等,详细信息请参见该型号对应
的API资料。
        下表为OpenCPU SDK支持的模块,不同SDK发布版本在API的支持范围上有细微差别,请以实际发布版本
为准。

接口模块

接口模块描述

参考文件

ADC

ADC功能

cm_adc.h

ALARM

闹钟功能

cm_alarm.h

ASOCKET

异步socket功能

cm_asocket.h

ASOCKET_DNS

异步DNS解析接口

cm_async_dns.h

AUDIO

音频功能

cm_audio_common.h/cm_audio_pl
ayer.h/cm_audio_recorder.h

BLE

BLE功能

cm_ble.h

CAMERA

CAMERA功能

cm_camera.h

DM

DM功能

cm_dm.h

ELOOP

Event Loop功能

cm_eloop.h

ETIMER

etimer功能

cm_etimer.h

FILE_SYSTEM

文件系统

cm_fs.h

FTP

FTP功能

cm_ftp.h

GNSS

GNSS功能

cm_gnss.h

GPIO

通用IO接口

cm_gpio.h

HTTP

HTTP功能

cm_http.h

I2C

I2C接口

cm_i2c.h

IOMUX

IOMUX功能

cm_iomux.h

KEYPAD

矩阵键盘接口

cm_keypad.h

LBS

LBS功能

cm_lbs.h

LCD

LCD功能

cm_lcd.h

MEM

内存管理功能

cm_mem.h

MQTT

MQTT功能

cm_mqtt.h

NTP

NTP功能

cm_ntp.h

OS

操作系统接口

cm_os.h

OTA

通用ota功能

cm_ota.h

PM

PM功能

cm_pm.h

PWM

PWM功能

cm_pwm.h

QR

QR功能

cm_qr.h

SD

SD功能

cm_sd.h

SIM

SIM功能

cm_sim.h

SPI

SPI接口

cm_spi.h

SSL

SSL功能

cm_ssl.h

SYS

模组基础功能

cm_sys.h

TTS

TTS功能

cm_tts.h

UART

串口接口

cm_uart_h

USB

USB虚拟串口通信功能

cm_usb.h

VIRT_AT

虚拟AT功能

cm_virt_at.h

WIFI_SCAN

Wi-Fi扫描功能

cm_wifi.h

OneMO模组说|技术学堂-ML307A开发指南(一) OpenCPU模式网络初始化流程介绍 OpenCPU网络初始化流程至关重要,是模组正常连接服务器应用的前提。流程包含读取模组IMEI/SN、读取SIM卡IMSI/ICCID和模组PDP激活状态三个环节。本文介绍了ML307A模组OpenCPU模式网络初始化的相关接口、demo代码解析、demo运行示例以及常见问题。 阅读详情

相关推荐

OPENCPU学习---开发环境搭建

OPENCPU学习---开发环境搭建

笑看人生 3677

OpenCPU

OpenCPU 是一种嵌入式开发解决方案。 属于模组所支持的功能,就是颠覆以前模组只能实现指定功能的局限,让模组可以当做主控来用。 这样方案不用再加MCU作为主控,节省成本,并且减少了方案的复杂度。 ...

xue_nuo的博客 1万+

OneMO模组说|技术学堂-ML307A开发指南(二) OpenCPU HTTP及HTTPS使用介绍

HTTP是一个简单的请求-响应协议,在物联网设备中使用非常广泛,可向HTTP服务器获取数据、推送数据、下载服务器上的文件、OTA远程升级等。ML307A OpenCPU SDK提供的HTTP API接口最大支持创建4路HTTP实例,且支持GET、POST和PUT等常用请求方法。 本文从使用流程、demo代码、OneNET平台对接示例及常见问题四个方面对ML307A模组OpenCPU的HTTP及HTTPS功能进行了介绍。

GY6866的博客 7418

OPENCPU学习---BC260Y-CN模组

基于BC260Y-CN模组的OPENCPU方案介绍

笑看人生 7236

ML307R-DC OpenCPU SDK开发中GPIO例子程序

ML307R-DC可以使用C语言开发。芯片自己带I2C。SPI和GPIO端口。开发利用自己的接口很方便。远传水表等非常方便。是MCU开发的利器。

caixf的博客 954

ML307R-DC OpenCPU SDK开发I2C

本文介绍了如何使用ML307R-DC芯片通过I2C接口控制GP8201芯片实现0-10V电压输出,从而调节灯光亮度。文中详细说明了开发环境配置、I2C程序编写方法(包括数据格式处理需左移4位)和主程序逻辑(亮度增减控制)。通过该方案,ML307R-DC可替代传统MCU实现简单设备控制,展示了其在物联网终端控制中的应用潜力。

caixf的博客 1010

大白BC26 opencpu开发视频详解

BC26 opencpu开发视频详解。对BC26 opencpu开发过程中遇到的问题进行详细说明:开发所需要的工具文件、操作流程、代码例程解释、下载编辑流程、程序开发调试等等。还有关于NBIOT行业的常见问题解释。

ML307R-DL OpenCPU开发实战:从零搭建物联网终端设备(附完整代码)

本文详细介绍了ML307R-DL OpenCPU开发实战,从零搭建物联网终端设备的完整流程,包括开发环境配置、代码架构设计、外设控制、网络通信与物联网协议实现等关键步骤。通过OpenCPU架构,开发者可直接在模组内部运行用户代码,降低BOM成本并提升系统可靠性。文章还提供了完整的代码示例和性能优化技巧,助力开发者快速掌握物联网设备开发。

g8f9d0s1a2的博客 785

ML307R 串口开发--OpenCPU应用程序开发学习笔记(2)

OpenCpu串口开发

jcf5832的博客 5654

ML307R-DL OpenCPU开发实战:从零搭建物联网终端设备(附完整代码示例)

本文详细介绍了中移物联ML307R-DL模组的OpenCPU二次开发实战,从零开始指导搭建物联网终端设备。内容涵盖开发环境配置、SDK结构解析、外设控制(GPIO/ADC)、网络通信(TCP/MQTT)实现,并提供了完整的代码示例和高级调试技巧,帮助开发者高效避坑,快速实现产品化。

grafana8visual的博客 785

ML307R OpenCPU DEMO_SDK环境搭建

这是ML307R_OpenCPU_Standard_SDK,里面提供example,custom里面是一个空项目,我们自己可以在这个项目添加自己的程序。| docs | 文档 || tools | 编译工具脚本 || out | 编译输出目录 || prebuild | 预编译文件 |

面朝大海春暖花开 3130

【嵌入式开发】OpenCPU

一种软件框架项目。

椎名的博客 933

ML307R OpenCPU GPIO使用

此函数第一个参数 cm_iomux_pin_e 是一个枚举,代表的是那个管脚,这个要和GPIO功能的管脚区分,比如我这里使用GPIO4 控制LED灯,可以查看 “第一个参数是cm_gpio_num_e 是指对应的GPIO,LED控制是使用了 GPIO4,既选择CM_GPIO_NUM_4。”手册 ,LED对应的引脚号是16,所以我们选择CM_IOMUX_PIN_16,而不是对应的GPIO4,这里需要注意。和cm_gpio_pull_e pull。第二个参数cm_gpio_level_e 对应的是设置的电平。

面朝大海春暖花开 3398

ML307A系列4G模块SDK开发(基于OpenCPU的固件开发)

#ML307A-DCLN开发 #ML307A-DSLN开发 #OpenCPU

weixin_63791423的博客 2216

ML307R OpenCPU UART使用

UART Demo示例可以在SDK:examples\uart\src\cm_demo_uart.c中查看。3.2 设置串口事件信息 事件里面添加了 接收到新的数据事件和 接收FIFO缓存溢出事件,这个在之后接收回调中处理。可以在UART Demo示例可以在SDK:examples\uart\src\cm_demo_uart.h中查看。从这里可以看到ML307R 是用户可用只有2个串口。3.4 注册串口事件 主要是串口接收。3.6 设置启用串口接收线程。以下是完整的串口代码。

面朝大海春暖花开 2396

ML307R OpenCPU开发实战:从环境搭建到MQTT上云

在物联网终端设计中,如何平衡成本、功耗与开发效率一直是嵌入式开发者的核心挑战。传统“MCU+通信模组”方案虽然成熟,但AT指令交互、串口调试与外设管理往往带来额外开销。OpenCPU架构应运而生,它允许应用代码直接运行在通信模组的应用处理器上,通过SDK调用网络协议栈与硬件接口,从而省去独立MCU,降低物料成本与布板面积,提升系统稳定性。这种模式尤其适合Cat.1、NB-IoT等中低速率的蜂窝网络设备,广泛应用在智能表计、共享设备、工业采集器等场景。以ML307R-OpenCpu-sdk包为例,围绕工程结构

weixin_29164091的博客 247

手把手教物联网开发(中移4G模组ML307C OpenCPU开发)

手把手教会4G模组ML307R OpenCPU开发

zsqlzjtu的专栏 6960

如何快速学习 PHP 编程:从入门到实战的高效路径

PHP高效学习路线摘要:4-8周掌握Web开发核心技能。阶段1(1周)搭建XAMPP/MAMP环境,掌握基础语法和变量处理;阶段2(2周)重点学习表单处理、会话管理和PDO数据库操作(防SQL注入);阶段3(2-3周)实战开发个人博客等小项目。关键原则:边学边练(每个知识点配3-5个案例)、优先掌握Web刚需技能(HTTP请求、数据库、动态页面)、善用官方手册。避坑点:密码必须加密、SQL使用预处理、统一UTF-8编码。建议每天2-3小时实操,通过项目驱动学习,快速形成开发能力。

2501_94233638的博客 1392

基于ML307R-DL的OpenCPU实战:Cat.1物联网温湿度采集终端开发详解

在物联网终端设计中,传统MCU加通信模组加AT指令的架构虽成熟,但存在成本高、调试复杂、功耗难优化等痛点。嵌入式开发者一直在寻求将业务逻辑与通信能力融合的方案。OpenCPU模式应运而生,它允许用户代码直接运行在Cat.1模组内置的ARM处理器上,利用模组自身的GPIO、I2C、ADC等外设接口完成数据采集与云端交互,从而省去外部MCU,精简硬件设计。这种方案在降低终端BOM成本、缩短开发链路、优化功耗方面具有明显价值,尤其适合环境监测、智能仓储、远程抄表等中低速物联网应用场景。本文基于ML307R-DL模

weixin_34288121的博客 774

Hand-Eye 标定误差分析:从理论到 C++ 实现

本文深入探讨了机器人手眼标定中的核心环节——误差分析。文章从AX=XB方程的理论残差出发,详细解析了旋转与平移误差的数学定义与物理意义,并提供了一个工业级的C++实现代码,用于计算重投影误差。通过误差分析,工程师可以量化标定精度,诊断问题根源,从而确保视觉引导机器人系统在实际应用中的可靠性与精确性。

c7d8e的博客 700

FlightStream实战:如何用面元法在笔记本电脑上完成无人机气动分析(附NASA案例)

本文详细介绍了如何利用FlightStream面元法在笔记本电脑上高效完成无人机气动分析,包括其核心技术优势、NASA D8案例实战解析及高效工作流建立。FlightStream作为快速CFD分析工具,显著提升了早期设计阶段的迭代速度,适用于概念设计验证和多气动构型比较。

weixin_28363123的博客 265
上一篇: 在rk3588上基于mosquitto库搭建MQTT客户端实现主题订阅和数据收发
下一篇: ML307R 串口开发--OpenCPU应用程序开发学习笔记(2)
悟凡爱学习
博客等级 码龄5年 3578粉丝 79原创
评论 9
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明:

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

余额充值
⌂ 换网址