1 Star 0 Fork 1

上海域格信息技术有限公司/yopen

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
贡献代码
同步代码
Loading...
README
MIT

项目介绍

该开源项目用于YM310_X09系列模块二次开发,针对AT软件无法满足要求,或者想省去MCU单片机的客户而设计的。

如何开发

环境准备

  • windows环境(建议win10或以上)版本
  • 安装python3
  • arm-gcc交叉编译器
  • YM310_X09系列模组以及USB线等硬件环境

开发工具

安装交叉编译器

  • 下载交叉编译器gcc-arm-none-eabi-10-2020-q4-major,ARM官方下载链接
  • 编译器解压到C盘,修改gcc-arm-none-eabi-10-2020-q4-major文件名为gcc,确保CMake可以通过c:\gcc\bin\arm-none-eabi-gcc访问到编译,目录结构如下:
 C:\gcc\bin 的目录

2024/07/31  12:15           780,288 arm-none-eabi-addr2line.exe
2024/07/31  12:15           802,304 arm-none-eabi-ar.exe
2024/07/31  12:15         1,377,792 arm-none-eabi-as.exe
2024/07/31  12:15         2,112,512 arm-none-eabi-c++.exe
2024/07/31  12:15           777,728 arm-none-eabi-c++filt.exe
2024/07/31  12:15         2,110,464 arm-none-eabi-cpp.exe
2024/07/31  12:15            34,304 arm-none-eabi-elfedit.exe
...

编译

打开cmd命令行,运行build.bat脚本,编译成功会显示如下字段

    #######################################################################
    ##                 ########     ###     ######   ######              
    ##                 ##     ##   ## ##   ##    ## ##    ##             
    ##                 ##     ##  ##   ##  ##       ##                   
    ##                 ########  ##     ##  ######   ######              
    ##                 ##        #########       ##       ##             
    ##                 ##        ##     ## ##    ## ##    ##             
    ##                 ##        ##     ##  ######   ######              
    #######################################################################
build successfully
[100%] Built target YOpenApp

选择工程编译

build.bat脚本支持通过添加参数,编译不同bsp_moduleproject项目,参数格式如下:

## 编译参数:
build.bat [bsp_module] [project]
## 举例:
    build YM310_X09C.S60 demo
    build YM310_X09S.U62 demo
  • 可选bsp_module
bsp_module 对应脚本(bsp/EC7XX目录) 功能描述 适用模组型号
YM310_X09C.S60 YM310_X09C.S60.cmake 基础数传 YM310_X09ACNCX / YM310_X09ACNCL
YM310_X09C.S61 YM310_X09C.S61.cmake YM310_X09C.S60基础上,增加了USB口基础AT指令支持 YM310_X09ACNCX / YM310_X09ACNCL
YM310_X09S.U62 YM310_X09S.U62.cmake YM310_X09C.S61基础上, USB网卡,WIFI SCAN, SMS等功能,FLASH空间更大 YM310_X09ACNSX / YM310_X09ACNSL
  • 可选project
project 对应脚本(project目录) 功能描述
demo demo.cmake yopen提供的api接口的使用示例
mbedtls mbedtls.cmake mbedtls功能组件
mqtt mqtt.cmake mqtt功能组件

下载固件

通过FlashTools工具下载out\YOpenApp.binpkg文件,相关下载操作步骤参考FlashTools工具说明

查看运行效果

通过EPAT日志工具,抓取demo_hello工程运行日志,可以看到运行结果如下:一秒打印一次hello _demo_thread cnt-x image

工程介绍

工程代码用cmake进行构建,make进行编译,工程相关配置可以参考project\demo_hello.cmake工程文件。

代码目录介绍

目录 介绍
api 功能api接口
bsp 底层代码,适配不同硬件(一般不需要了解)
components 功能组件,例如http,mqtt,json等
demo 样例代码,api或者功能组件的代码样例
doc 帮助文档,api文档或者工具使用说明等
project 工程构建文件,每个文件表示一个代码工程
out 中间文件,编译自动产生
tools 工程构建过程中使用的工具或脚本集合

入口函数

应用代码入口函数app_main位于bsp\EC7XX\app_main.c文件中。

API接口

接口声明在api目录头文件中,详细说明在Open_API文档中

可用空间

bsp_module project RAM* ROM* FS FOTA
YM310_X09C.S60 demo 334KB 330KB 48KB 192KB
YM310_X09C.S61 demo 331KB 154KB 48KB 192KB
YM310_X09S.U62 demo 328KB 813KB 976KB 464KB

注意:

  • RAM空间为实际malloc可用空间。所以不能全部用完,否则会导致malloc失败,出现系统异常
  • ROM空间为实际代码剩余空间
  • ROM和RAM大小统计,均基于project/demo项目,不同project会有差异。

如何添加自己的代码工程

添加之前需要简单了解CMake的基本语法,相关添加步骤可以参考doc目录下的增加mqtt工程.md文件。

开发指南

详细开发指南参考:doc/YOPEN 开发指南

MIT License Copyright (c) [year] [fullname] Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

简介

该开源项目用于YM310_X09系列模块二次开发,针对AT软件无法满足要求,或者想省去MCU单片机的客户而设计的 展开 收起
MIT
取消

发行版 (1)

全部
14天前

贡献者 (4)

全部

近期动态

5天前创建了任务 #IBY8TW _gettimeofday函数死机问题
14天前推送了新的 R3.1.0 标签
14天前删除了 beta 分支
14天前推送了新的提交到 main 分支,8ebca75...4c72d1c
20天前推送了新的 beta 分支
加载更多
不能加载更多了
马建仓 AI 助手
尝试更多
代码解读
代码找茬
代码优化
1
https://gitee.com/yuge-info/yopen.git
git@gitee.com:yuge-info/yopen.git
yuge-info
yopen
yopen
main

搜索帮助