【进阶开发】如何编译MaixPy工程
开源 MaixPy 项目开发指南
本文是为了帮助一些想要成为开发者的用户而写的开源项目の开发文档。
1. 获取 maixpy 开源项目
没有代理的同学可以用 github 镜像站列表(
https://github.com/rc1844/fastgithub
)加速拉取 maixpy 仓库,请不要用 gitee 拉取 maixpy 仓库,会掉子模块仓库的。
juwan@juwan-N85-N870HL:~$ git clone https://gitclone.com/github.com/sipeed/MaixPy
正克隆到 'MaixPy'...
remote: 对象计数中: 77517, 完成.
remote: 压缩对象中: 100% (20929/20929), 完成.
remote: Total 77517 (delta 56791), reused 76050 (delta 55761)
接收对象中: 100% (77517/77517), 53.62 MiB | 972.00 KiB/s, 完成.
处理 delta 中: 100% (56791/56791), 完成.
juwan@juwan-N85-N870HL:~$ cd MaixPy/
juwan@juwan-N85-N870HL:~/MaixPy$ git submodule update --recursive --init
子模组 'components/kendryte_sdk/kendryte-standalone-sdk'(https://github.com/sipeed/kendryte-standalone-sdk)已对路径 'components/kendryte_sdk/kendryte-standalone-sdk' 注册
子模组 'components/micropython/core'(https://github.com/micropython/micropython.git)已对路径 'components/micropython/core' 注册
子模组 'components/micropython/port/src/lvgl/lv_bindings'(https://github.com/littlevgl/lv_binding_micropython.git)已对路径 'components/micropython/port/src/lvgl/lv_bindings' 注册
子模组 'components/micropython/port/src/ulab/micropython-ulab'(https://github.com/Neutree/micropython-ulab.git)已对路径 'components/micropython/port/src/ulab/micropython-ulab' 注册
子模组 'components/spiffs/core'(https://github.com/pellepl/spiffs.git)已对路径 'components/spiffs/core' 注册
子模组 'tools/flash/kflash_py'(https://github.com/sipeed/kflash.py.git)已对路径 'tools/flash/kflash_py' 注册
子模组 'tools/kconfig/Kconfiglib'(https://github.com/ulfalizer/Kconfiglib.git)已对路径 'tools/kconfig/Kconfiglib' 注册
子模组 'tools/spiffs/mkspiffs'(https://github.com/igrr/mkspiffs.git)已对路径 'tools/spiffs/mkspiffs' 注册
正克隆到 '/home/juwan/MaixPy/components/kendryte_sdk/kendryte-standalone-sdk'...
正克隆到 '/home/juwan/MaixPy/components/micropython/core'...
注意,这之后拉取子仓库是没有加速的,会从 github 试图拉取,你也可以用同样的方法单独拉取子模块位置(在 .gitmodules
中定义),本篇文档是无法帮你解决网络问题的。
如果 https://gitclone.com 挂了,就自己想办法找其他线路吧。
如何确认最终子模块是否拉取完整,可以输入 git submodule status
,不完整请不要进行编译,必出错误。
juwan@juwan-N85-N870HL:~/Desktop/maixpy$ git submodule status 7fdb511fe61026eec5874885de5981c4f60f664d components/kendryte_sdk/kendryte-standalone-sdk (v0.5.2-181-g7fdb511)ced340d739e84737dd5c8e6b4ab9af2ea44e29e7 components/micropython/core (v1.11-64-gced340d73)ddf09164ee1711a61169030a7ee8bf370ee5743f components/micropython/port/src/lvgl/lv_bindings (remotes/origin/dev-6.0-32-gddf0916)c315a571df49a19b843f7dffc300c21ccb7d4edd components/micropython/port/src/ulab/micropython-ulab (0.24-27-gc315a57)ec68ba8208d7550860e4e78299d58a529b88bf85 components/spiffs/core (0.2-234-gec68ba8)1ef6f4c0b2cb8b1872b6ffe9337f4e02d5487fa6 tools/flash/kflash_py (v1.0-79-g1ef6f4c)53c72959ac4d71f99913e4b0eea99261a6585430 tools/kconfig/Kconfiglib (v12.12.1-14-g53c7295)983970e40ff381d95d68a9bddff70c4d9921021b tools/spiffs/mkspiffs (0.2.3-6-g983970e)
1.1. 编译 maixpy 开源项目
这节内容假设你没有任何搭建交叉编译链的经验。
首先按 build.md 顺序执行各种操作即可,如果你不会英文你可以开翻译机。
步骤说明如下:
- 给 linux 环境安装必须的编译工具和 Python 模块,确保 cmake / make / python3 可用。
- 设置 toolchain 工具链到系统
/opt/kendryte-toolchain/
目录下,方便 SDK 寻找编译工具,确保存在 /opt/kendryte-toolchain/bin/riscv64-unknown-elf-gcc 编译工具。 - 进入到 MaixPy 的具体硬件项目下
cd projects/maixpy_k210
然后输入python3 project.py build
开始编译。
整个编译步骤就这样结束了, 编译成功后你就会在 projects/maixpy_k210
目录下得到一个 build 文件夹,里面有如下文件:
- maixpy.bin 将要被烧录到 0x000000 地址的 K210 固件。
- maixpy.txt 当前固件对应的反编译代码内容,辅助你排查 core dump 的指针地址的信息。
其他文件是编译过程中产生的 .a 和 .o 中间编译文件,可忽略。
1.2. 烧录 maixpy 固件到你的硬件
juwan@juwan-N85-N870HL:~/Desktop/maixpy/projects/maixpy_k210$ python3 project.py -h
-- SDK_PATH:/home/juwan/Desktop/maixpy
maixpy
usage: project.py [-h] [-p PORT] [-b BAUDRATE] [-t] [-n] [-s] [-B {dan,bit,bit_mic,goE,goD,maixduino,kd233,auto}] [-S] [--toolchain PATH] [--toolchain-prefix PREFIX][--config_file PATH] [--verbose]{config,build,rebuild,menuconfig,clean,distclean,clean_conf,flash}build tool, e.g. `python project.py build`
其中 -B goE
是选择版型,可选的项有 dan,bit,bit_mic,goE,goD,maixduino,kd233,auto
表示烧录方式,这个和具体硬件有很大关系。
bit 通常对应使用 CH340 的芯片。
maixduino 通常对应使用 CH552 的芯片。
具体你可以多种试试,还可以选择烧录频率 115200 、1500000 的 BAUDRATE 选择,当然,无论是哪种配置,只要能烧录进去就行,更多的使用方法你需要查看 -h 的帮助说明。
常见的烧录过程如下:
➜ maixpy_k210_minimum git:(master) ✗ sudo kflash -b 1500000 -p /dev/ttyUSB0 build/maixpy.bin
[sudo] fqr 的密码:
[INFO] COM Port Selected Manually: /dev/ttyUSB0
[INFO] Default baudrate is 115200 , later it may be changed to the value you set.
[INFO] Trying to Enter the ISP Mode...
._
[INFO] Automatically detected goE/kd233 [INFO] Greeting Message Detected, Start Downloading ISP
Downloading ISP: |============================================================================================================| 100.0% 10kiB/s
[INFO] Booting From 0x80000000
[INFO] Wait For 0.1 second for ISP to Boot
[INFO] Boot to Flashmode Successfully
[INFO] Selected Baudrate: 1500000
[INFO] Baudrate changed, greeting with ISP again ...
[INFO] Boot to Flashmode Successfully
[INFO] Selected Flash: On-Board
[INFO] Initialization flash Successfully
Programming BIN: |============================================================================================================| 100.0% 47kiB/s
[INFO] Rebooting...
1.3. 命令行连接硬件 & 运行代码
>>>
paste mode; Ctrl-C to cancel, Ctrl-D to finish
===
=== print('hello world!')
===
hello world!
>>>
这样你就完成了快速的验证和开发,但如果你是要调试某一段功能代码,你可以通过 mpfshell-lite 直接命令行上传代码,复位就运行,然后报错和调试。
底层开发动态语言经常这样操作,所以要感谢所有做解释器接口的开发者做了大量的接口验证。
2. MaixPy 项目应用说明
假设已经知道如何使用 MaixPy 工程进行开发、编译、烧录,接下来将深入介绍一些工具的用法,这里面只交待一些常见用法,并不会展开细节说明。
2.1. 介绍 cmake 的工程编译方法
但 MaixPy 只把 micropython 当做一个依赖库包加入到自己的环境当中,所以实际上 MaixPy 的软件架构设计是围绕着 K210 软件组件的形式进行构建的。
因此可以来到 maixpy 文件夹里存在一个 hello_world 的工程,让看看它是怎么构成的。
- hello_world
- build
- compile
- main
- CMakeLists.txt
- config_defaults.mk
- project.py
MaixPy 项目已经准备了一个模板提供给你进行 K210 的项目构建,这里忽略项目构建的过程,重点关注需要可以编译链接的工程配置部分,也就是 main 下的 CMakeLists.txt ,它的内容如下。
############### Add include ###################
# list(APPEND ADD_INCLUDE "include"
# )
# list(APPEND ADD_PRIVATE_INCLUDE "")
########################################################### Add source files #################
list(APPEND ADD_SRCS "src/main.cpp")
# aux_source_directory(src ADD_SRCS)
# list(REMOVE_ITEM COMPONENT_SRCS "src/test2.c")
##################################################### Add required/dependent components ######
list(APPEND ADD_REQUIREMENTS kendryte_sdk)
########################################################### Add static libs ##################
# list(APPEND ADD_STATIC_LIB "lib/libtest.a")
###############################################register_component()
可以看到 ADD_SRCS
链接了一个 src/main.cpp
代码文件作为程序入口。
通过 ADD_REQUIREMENTS
就可以加载其他地方的模块进来,例如 list(APPEND ADD_REQUIREMENTS kendryte_sdk)
则请求了 kendryte_sdk
这个 SDK 包。
如果想要链接自己的 nncase 库呢?其他库代码呢?
可以直接则改为绝对路径下的 LINK_DIRECTORIES(/home/juwan/maixpy/projects/maixpy_old/main/src/nncase)
的代码就可以了,这样做的前提是这个库是由 cmake 工程的方式提供的。
这里示范了如何在编译调用自己的 nncase 库,结合这些关键讯息再去阅读工程,应该就可以较为轻松的用起来了吧。
2.2. 如何打包 micropython spiffs 文件系统分享出来
如果你深入使用了 MaixPy 进行开发,你会发现 MaixUI 提供了一种文件系统文件(img),当你刷入这个 UI 系统一样的 img ,你就会在烧录后直接进入 UI 界面。
CONFIG_SPIFFS_SIZE=0x300000
CONFIG_SPIFFS_START_ADDR=0xD00000
这里只讨论工具的使用,而不对其实现做详解。
而 spiffs 是不支持目录结构的,那么我们会发现 ui 的 img 在 flash 里的文件名称会存在 lib/core.py
这样的名称,而正常情况下我们是不可能将这个文件创建起来的,所以要通过工具将其打包。
在 tools/spiffs/mkspiffs 目录下有 gen_spiffs_image.py 脚本完成这个打包镜像的功能,用法请看 tools/spiffs/README.md 说明。
- 在 spiffs 目录下准备一个 fs 文件夹,包含你要打包的代码或资源文件内容。
- 执行
python gen_spiffs_image.py ../../projects/maixpy_k210/config_defaults.mk
即可得到 maixpy_spiffs.img 二进制文件。 - 将上述得到的 img 烧入到 0xD00000 就恢复 micropython 的文件系统里的内容。
如果你做了一些小系统,用这样的方式发布,用户拿到你提供的 img 文件,烧入就可以立刻得到和你一样的环境啦,这其实和基于 Linux 系统发布某系统镜像的结构是一样的。
现在,你学会了吗?
2.3. MaixPy 的持续集成服务(Travis CI)
持续集成服务 Travis CI 教程
2.4. 如何更好的阅读开源项目源代码
3. 最后的参考资料
文章来源于猪百岁儿,原文链接:https://bbs.sipeed.com/thread/488
【进阶开发】如何编译MaixPy工程相关推荐
- 积木Sketch插件进阶开发指南
前段时间,美团外卖技术团队积木Sketch插件"意外走红".为了帮助更多的设计师小哥哥.小姐姐落地设计规范,提升产研效率,积木Sketch团队开始着手打造一个平台化的产品.本文介绍 ...
- 【Android FFMPEG 开发】Android Studio 工程配置 FFMPEG ( 动态库打包 | 头文件与函数库拷贝 | CMake 脚本配置 )
文章目录 I . FFMPEG 交叉编译后的函数库及头文件 II . FFMPEG 静态库打包动态库 ( 仅做参考 ) III . 创建 Android Studio 工程 IV . FFMPEG 头 ...
- QtCreator集成开发环境编译调试VLC
QtCreator集成开发环境编译调试VLC 作者:lovey599 本文讨论如何用QtCreator编译并调试VLC源代码.你可以点击此处下载vlc-1.1.12.tar.gz源代码,也可以自行去官 ...
- 不混淆so文件_NDK开发_编译的cpp引用到 其它so, Android.mk 的写法
如果我们编译的so文件需要引用到其它的so文件,那我们来看下这时候的Android.mk 文件如何写. 一.不需要ndk编译 .cpp,直接是 so文件 切到 Project 视图,在java同级目录 ...
- 命令行开发、编译、打包Android应用程序
Android SDK提供了一系列命令行工具,用来进行Android应用的开发.调试.打包等工作!Eclipse能够进行Android应用开发的相关工作,也是调用了这些工具而已. 只有掌握了命令下的工 ...
- Android 使用Ant编译Android 工程
如何编译Android 工程? 关于如何编译Android 工程在这篇官方文档这里中解释的比较清楚, 太多的详细的解释我就不说了,RTFM. 我需要说的是我们既可以让IDE替你完成编译的编译工作,也可 ...
- 设置DirectShow开发的编译环境
这个章节的内容主要是编写 DirectShow应用所需的一些基本概念,可以把它当作一个高级介绍,理解这些内容只需具备一般的编程和有关多媒体的知识. 2.1. 设置DirectShow开发的编译环境 ...
- windows下编译php扩展,windows下开发并编译PHP扩展的方法_php
现在就简单说一在WINDOWS下开发php扩展的步骤: 首先需要准备的软件有: cygwin 安装路径e:/app/cygwin visual studio C++ 6.0, 修改环境变量,把已经安装 ...
- Qt开发,编译报错:Cannot find file: xxx.pro.
一.问题描述 Qt开发,编译报错:Cannot find file: xxx.pro. 二.问题分析 工程目录包含中文目录 三.解决方案 将工程放于不含中文目录的文件夹下
最新文章
- EditText禁止输入回车
- 大道至简第一章观后感(伪代码)
- 参加第十六届智能车竞赛同学提问与回答-6-30
- [Javascipt] Immediately-Invoker 2
- sql server 2008学习12 事务和锁
- 数组中的第k个最大元素—leetcode215
- BUPT 2012复试机考 4T
- php 调用memcache,Windows下的Memcache安装(php调用)
- Attachments to close incidents
- 【SQL】实验五 数据库的完整性
- java 典型程序,13道Java典型的Java小程序
- RayData学习总结
- 数据库和数据库实例的概念
- Selenium Firefox Webdriver 无图模式
- [STL]priority_queue多种方式自定义排序
- Android页面跳转(Intent)
- 23种设计模式-个人笔记(三)
- Android修改分区格式为F2FS
- 磨金石教育分享||想转行学习插画,应该怎么做,需要什么基础?
- php 银行支付通道_接口--php对接农行网上支付平台-b2b
热门文章
- 武汉市科技小巨人企业申报条件材料,附2022年经开、洪山、东湖高新、江夏、江岸五区奖励
- python代码库能干什么_一行Python代码能做什么?
- 使用html2canvas完成页面截屏并保存为图片
- APP上架到各大应用商店
- my.cnf 配置文件参数解释
- ERROR 1415 (0A000): Not allowed to return a result set from a trigger
- windows7计算机配置要求,Windows7最低配置要求是什么 windows7的版本介绍
- (17)方阵的特征值与特征向量
- php 数组中重复值,php找出数组中的重复值
- 周志华点评机器学习会议