如何使用Mac终端给树莓派pico构建C/C++程序进行开发,以及遇到各种问题该怎么处理,不使用任何IDE或编辑器(例如VS Code)

写本文的原因是官方的教程已经过时了,如果你现在按照官方教程来在 Mac 上进行配置,那么会遇到一堆问题,比如我几乎把能踩的“雷”都踩了。所以这里记录了完整过程,以及各种错误的原因和处理方法,不然以后换 Mac 了或者在其他平台遇到同样的问题,忘记怎么处理的就头大了。

接下来先记录一下整体的安装流程,会介绍一些背景知识,对于一些会错误的地方会进行说明和解释。虽然文中对一些可能出现的错误进行了介绍,但是还是单独写了一篇博客进行整理,方便以后查阅:《为树莓派Pico配置交叉编译环境和工具链arm-none-eabi-gcc时可能会遇到的错误以及解决方案》

安装流程

下载 Raspberry Pi Pico SDK

Raspberry Pi Pico SDK 提供为基于 RP2040 的设备(如 Raspberry Pi Pico)编写 C/C++ 或汇编语言程序需要使用的使用的头文件、库和构建系统,这大大提升了开发效率。

这部分的方法可以和官方介绍的方法一样,但是如果你使用 HTTPS 克隆失败了很多次,那么建议使用 SSH 或者更新 Git 试试看,GitHub 在 HTTPS cloning errors 对这个问题有简单的介绍。所以这里两种地址都列出来:

# 使用https
git clone https://github.com/raspberrypi/pico-sdk.git --branch master
# 使用 SSH
git clone git@github.com:raspberrypi/pico-sdk.git --branch master

然后进入pico-sdk目录,初始化引用的子模块:

$ cd pico-sdk
$ git submodule update --init

这里可能需要等待很长时间,而且经常会出现错误,比如加载失败、连接超时等,需要多试试看,因为都是 HTTPS 下载的,建议根据上文连接中的介绍进行诊断。这部分真的需要耐心!

配置 Raspberry Pi Pico SDK

接下来需要在环境变量PICO_SDK_PATH中记录pico-sdk的根地址,这样后面 CMake 就可以找到需要的一些库、头文件等一些工具。这需要在你的 Shell 配置文件里加上这么一句:

export PICO_SDK_PATH=~/Desktop/pico/pico-sdk

接下来你可以关闭终端再次打开,或者使用source来激活这个更改,比如:

$ source .bash_profile

后面配置其他工具时也需要类似的操作,如果你想进一步了解这步的知识,可以看我的另一篇博客:《macOS在终端上如何直接使用脚本或者下载的程序》。

此外,虽然这里还没提及 CMake,但是还有另一种方法,你还可以在CMakeLists.txt中的project(...)部分之前加上这句话也可以设置环境变量PICO_SDK_PATH

set(PICO_SDK_PATH ~/Desktop/pico/pico-sdk)

后面的路径用不用双引号包裹都行,一般不会出现解析错误,保险起见可以加。

这种方法的好处在于对不同项目可以设置不同的环境变量,你可以根据自己的需求进行选择。

安装 CMake

CMake 是一个构建、测试、打包的工具,可以生成make可以构建的makefile文件。这是因为make在所有类 Unix 都是自带的,但是makefile文件编写不是很容易。

这里我们直接使用brew进行安装即可:

brew install cmake

使用下面的命令查看版本来确认已经安装:

$ cmake --version
cmake version 3.27.1CMake suite maintained and supported by Kitware (kitware.com/cmake).

(介绍CMake的博客还没写完,写完会贴个链接在这)

工具链

为什么需要工具链

在 Mac 上给树莓派 Pico 进行开发是需要交叉编译的。交叉编译就是在系统上编译另一种系统甚至另一个平台的程序,比如我是在 X86 架构的 macOS 上编译 Arm 架构 Linux 的可执行程序。为了实现这个目的需要一套工具来编译,比如目标系统、目标平台的编译器、库,这套工具就是常说的工具链(Toolchain)。因为本机上的编译器clang和库是给 macOS 编译程序的,编译出来的可执行程序是Mach-O executable格式,而不是 Linux 需要的格式。顺道一提,这里树莓派 Pico 需要导入的可执行程序格式为UF2 firmware image, family Raspberry Pi RP2040

下载工具链

给树莓派 Pico 进行交叉编译的工具链名为:arm-none-eabi-gcc,使用方法和gcc一样,但是一般很少直接使用 arm-none-eabi-gcc 进行编译,都是使用 CMake 进行安装。

需要注意的是,下载工具链不要直接使用brew下载。因为brew安装的版本可能是不是树莓派 Pico 对应的版本或者配置错误,这样会导致一些错误。比如当前brew下载的版本只有 200MB,而官网的版本有 845MB,如果使用brew下载的版本,那么虽然也是 12.3 版本,cmake构建也没有问题,但是到make这步的时候就会显示以下错误:

-- Build files have been written to: /shared/pico-setup/pico/pico-examples/build/elf2uf2
[  0%] Performing build step for 'ELF2UF2Build'
Scanning dependencies of target elf2uf2
[ 50%] Building CXX object CMakeFiles/elf2uf2.dir/main.cpp.o
[100%] Linking CXX executable elf2uf2
[100%] Built target elf2uf2
[  0%] No install step for 'ELF2UF2Build'
[  0%] Completed 'ELF2UF2Build'
[  0%] Built target ELF2UF2Build

这时候用下面的命令卸载、清理掉brew安装的内容:

# 卸载arm-none-eabi-gcc
$ brew uninstall arm-none-eabi-gcc
# 清理掉一些下载文件
$ brew cleanup arm-none-eabi-gcc
# brew默认将二进制文件安装到/usr/local/bin/目录下,虽然前面卸载了,但是可能会有一些残留,手动删一下
$ sudo rm /usr/local/bin/arm-none-eabi-*

这时候再从官网下载即可。

进入 Arm GNU Toolchain Downloads,用页面搜索功能搜一下“macOS”,因为链接太多了。你会看到光是在 macOS 下面就有这么多链接:

请添加图片描述

选择你对应平台(就是处理器架构)的AArch32 bare-metal target (arm-none-eabi)中的链接点击下载。选择AArch32因为树莓派 Pico 的微控制器 RP2040 包含的 Arm Cortex M0 是 32 位的,也就是AArch32,如果你下成AArch64 bare-metal target (aarch64-none-elf)是没法编译的。

安装工具链

如果你下载的是 tar.xz 格式的,那么使用下面的指令将其解压:

$ tar xvf arm-gnu-toolchain-版本号-darwin-arm64-arm-none-eabi.tar.xz

然后将其放在一个你喜欢但是不经常动的位置。

如果你下载的是 PKG 格式的,那么安装之后会放在“应用程序”目录/Applications/下,如下:

请添加图片描述

这时候这个目录的绝对地址就是/Applications/ArmGNUToolchain/

配置工具链

接下来要像之前一样配置一下工具链,好让cmake构建的时候找到需要的编译器、汇编器等工具以及库。

配置方法是在环境变量PATH中添加上arm-none-eabi的二进制目录,这样就可以使用里面的工具了。

如果是使用 PKG 安装的,那么在 Shell 配置文件中添加如下语句(版本不同可以略有变化):

export PATH="$PATH:/Applications/ArmGNUToolchain/版本号/arm-none-eabi/bin"

如果你是下载的 tar.xz,那么在 Shell 配置文件中添加如下语句(版本不同可以略有变化):

export PATH="$PATH:~/arm-gnu-toolchain-12.3.rel1-darwin-arm64-arm-none-eabi/bin"

~/arm-gnu-toolchain-12.3.rel1-darwin-arm64-arm-none-eabi是你之前下载解压好之后放的位置,选择里面第一层的bin目录,该目录应该包含 C/C++ 的编译器arm-none-eabi-gccarm-none-eabi-g++,内容大致如下:

请添加图片描述

不要选择arm-none-eabi里的bin

如果你完成了以上步骤,那么就可以为树莓派 Pico 进行交叉编译了。

构建项目

这里我们使用一个自制的例子和官方例子 pico-examples 来介绍一下构建项目中的一些命令。

首先新建一个pico目录来存放这些例子,并且进入该命令:

$ mkdir pico
$ cd pico

简单的例子

接下来介绍简单的自制例子。按照以下命令新建一个目录blink,然后在里面新建一些文件和目录:

# 新建一个`blink`目录并进入
$ mkdir blink
$ cd blink
# 创建两个空白文件 blink.c 和 CMakeLists.txt
$ touch blink.c CMakeLists.txt
# 将 pico-sdk 项目中的 pico_sdk_import.cmake 文件复制到当前目录下
# 如果你之前没有设置PICO_SDK_PATH,那么就使用你的pico-sdk路径
$ cp $PICO_SDK_PATH/external/pico_sdk_import.cmake .

然后在blink.c文件中输入以下内容,这些编译后会让树莓派 Pico 上的 LED 灯开始闪烁:

#include "pico/stdlib.h"const uint LED_PIN = 25;int main() {gpio_init(LED_PIN);gpio_set_dir(LED_PIN, GPIO_OUT);gpio_put(LED_PIN, 0);while (true) {gpio_put(LED_PIN, 1);sleep_ms(250);gpio_put(LED_PIN, 0);sleep_ms(250);}
}

CMakeLists.txt文件中输入以下内容:

cmake_minimum_required(VERSION 3.17)include(pico_sdk_import.cmake)# 这两个是设置目标系统和目标平台的,如果不加这两句也行,但是第一次运行 cmake 构建时会需要较长时间寻找合适的编译器,后面再构建就没区别了
set(CMAKE_SYSTEM_NAME Linux)
set(CMAKE_SYSTEM_PROCESSOR arm)project(blink)pico_sdk_init()add_executable(blink 
blink.c
)target_link_libraries(blink pico_stdlib)pico_add_extra_outputs(blink)

这时候新建一个名为build的目录来存放构建后的内容,然后进入。

$ mkdir build
$ cd build

这是一个良好的构建项目的习惯,因为会很方便清理一些构建后的文件,也是cmake的惯例。

然后使用以下命令进行构建:

$ cmake ..
$ make -j4

如果在构建过程中出现任何错误,都建议完全清空build目录,再进行下次构建!

这里你可能会好奇为什么使用make -j4这个命令,而不是直接使用make。其实两个都可以,但是推荐使用选项-j4,原因在“pico-examples”部分会有说明。

构建成功会显示以下内容:

请添加图片描述

而此时的build目录下内容如下:

请添加图片描述

这时候先继续讲如何构建 pico-examples,如果你想马上知道如何导入可以跳到后面。

pico-examples

回到pico目录下:

$ cd ../..

首先下载 pico-examples:

# 用 https
$ git clone https://github.com/raspberrypi/pico-examples.git
# 用 SSH
$ git clone git@github.com:raspberrypi/pico-examples.git

同样进入pico-examples目录,然后新建build目录,在进入其中:

$ cd pico-examples
$ mkdir build
$ cd build

然后就像简单的例子一样使用下面的命令来构建所有的项目:

$ cmake ..
$ make -j4

为什么make要使用选项-j

这里解释一下为什么使用make -j4而不是make

  • 选项-j4意思是“同时运行 4 个任务或者命令”,如果直接使用make可能会出现fatal error: cannot read spec file ‘nosys.specs’: No such file or directory的错误,也就是一个好了得等另外一个。
  • 不过使用-j4的主要目的是为了加快构建速度。

二者的速度差距有多少呢?我进行了测试,可以看到实际花费的时间(real)减少到三分之一左右,你可以自己尝试看看。
请添加图片描述

这是因为-j4利用了更多的进程,而更多的进程意味着更多的线程。这样可以提升 CPU 的利用率和降低程序运行时间,所以你可以看到使用使用-j4的用户使用 CPU 时间(user)和系统使用 CPU 时间(sys)都要高于不使用-j4的情况。

这里的4可以根据你的处理器线程数进行调整,由于这个任务的 CPU 利用率很高,阻塞、睡眠的情况少,所以上限大概就是你的线程数,更高的值带来的提升比较少。但是4的个很不错的选择,因为:

  1. 如果尝试过多线程编程就知道,4线程是一个拐点,很多任务超过4之后线程数带来的性能提升曲线会放缓,之前增加一个线程带来的提升可能需要增加两到三个线程才能达到。
  2. 很多处理器可以同时运行的线程数还是不太够,而4是很多机器能接受的。

如果你拥有一个核心很多的处理器,可以试试看设置为最高的速度,用time make -jxx测试一下时间,如果可以的话评论留言让我记录一下哦。

导入编译好后的二进制文件

导入的方法很简单,首先拔下来你的树莓派 Pico,然后按住树莓派上的白色按钮“BOOTSEl”,如下:

请添加图片描述

然后插上线连接到 Mac 上。这样树莓派 Pico 会进入 USB 大容量存储模式。

这时就会发现出现了这样的一个 USB 存储装置:

请添加图片描述

然后将我们之前构建好的项目中的.uf2文件拖入这里即可。拖入后会显示“磁盘没有正常推出”,对此不要紧张,是正常的。

如果将一开始blink项目中的blink.uf2拖入,那么就可以看到树莓派 Pico 上的 LED 开始闪烁了。

断开再次插上也会继续闪烁,如果你想重置树莓派 Pico 来让他別闪了,那么再次断开按住按钮进入 USB 存储模式就会重置清空之前的二进制文件。

最后,关于构建中还可能会出现一些问题,这些问题我会单独开一篇来进行整理(已将链接贴到开头了)。

希望能帮到有需要的人~

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.rhkb.cn/news/88838.html

如若内容造成侵权/违法违规/事实不符,请联系长河编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

2023上半年京东奶粉行业品牌销售排行榜(京东数据分析平台)

近年来,受新生儿人口数量下降的影响,婴幼儿奶粉市场的需求量萎缩,市场由增量竞争转为存量竞争。根据鲸参谋电商数据分析平台的数据显示,今年上半年,京东婴幼儿奶粉市场的销量将近4400万,环比下降约19%&…

电气测试相关

项目: 长期过电压 瞬态过电压 瞬态欠压 跳跃启动 卸载 纹波电压 电源电压缓慢下降和上升 电源电压缓慢下降、快速上升 复位行为 短暂中断 启动脉冲 带电气系统控制的电压曲线 引脚中断 连接器中断 反极性 信号线和负载电路短路 启动行为 对分流不…

form中表单切换,导致 relus 中的事件无法触发,原因:页面切换不要一直切换DOM,会导致问题,需要都显示出来

修改前&#xff0c;因为重复渲染DOM导致绑定rules失效 修改前代码使用 computed 计算出渲染的DOM&#xff0c;影响rules事件<el-formref"form"inline:model"billDetailCopy":rules"rules"size"small"label-position"right&quo…

YOLOv5可视化界面

Pyside6可视化界面 安装Pyside6 激活之前的虚拟环境yolov5 在该环境的终端输入以下命令 pip install -i https://pypi.tuna.tsinghua.edu.cn/simple pyside6输入where python找到当前使用的Python的路径 找到该路径下的designer.exe文件&#xff08;/Lib/site-packages/PySi…

Java IO流——【从零构建信息管理系统】

Java I/O流——【从零构建信息管理系统】 文章目录 什么是Java I/O流介绍理解字节流和字符流的区别 Java I/O流的作用Java I/O流方法InputStream方法Reader方法OutputStream方法Writer方法Java I/O体系的全体类 使用示例Java I/O流在实际应用中使用效果 什么是Java I/O流 介绍…

idea集成chatGPT,免费使用的bito神器

什么是Bito&#xff1f; Bito是一款在IntelliJ IDEA编辑器中的插件&#xff0c;Bito插件是由ChatGPT团队开发的&#xff0c;它是ChatGPT团队为了提高开发效率而开发的一款工具。ChatGPT团队是一支专注于自然语言处理技术的团队&#xff0c;他们开发了一款基于GPT的自然语言处理…

Azure创建第一个虚拟机

首先&#xff0c;登录到 Azure 门户 (https://portal.azure.com/)。在 Azure 门户右上角&#xff0c;点击“虚拟机”按钮&#xff0c;并点击创建&#xff0c;创建Azure虚拟机。 在虚拟机创建页面中&#xff0c;选择所需的基本配置&#xff0c;包括虚拟机名称、操作系统类型和版…

Pytorch个人学习记录总结 10

目录 优化器 优化器 官方文档地址&#xff1a;torch.optimhttps://pytorch.org/docs/stable/optim.html Debug过程中查看的grad所在的位置&#xff1a; model --> Protected Atributes --> _modules --> ‘model’ --> Protected Atributes --> _modules -…

期刊和会议缩写查询网站

1.https://pubmed.ncbi.nlm.nih.gov/?termMedicalImageComputingandComputer-AssistedIntervention 2. http://www.letpub.com.cn/index.php?pagejournalapp&viewsearch 3. https://blog.csdn.net/weixin_44557349/article/details/120825927 https://blog.csdn.net/ret…

Vue中如何更好地封装组件?

子组件接受父组件传递的事件 1.子组件使用事件名"$emit(父组件中传递的事件名,想给父组件传递的参数(可选))" click"$emit(click)" 2.子组件使用 v-on"$listeners" 父组件&#xff1a; <template><div id"app"><myCo…

第 358 场LeetCode周赛题解

A 数组中的最大数对和 数据范围小&#xff0c;直接暴力枚举数对 class Solution { public:int mx(int x) {//返回10进制表示的数的最大数字int res 0;for (; x; x / 10)res max(res, x % 10);return res;}int maxSum(vector<int> &nums) {int n nums.size();int r…

3.2 Tomcat基础

1. Tomcat概述 Tomcat 服务器是一个免费的开放源代码的Web 应用服务器&#xff0c;属于轻量级应用服务器。 Tomcat版本&#xff1a;apache-tomcat-8.5.76。 2.IDEA集成Tomcat 第一步 第二步 第三步 ​ 编辑切换为居中 添加图片注释&#xff0c;不超过 140 字&#xff0…

PyQt5组件之QLabel显示图像和视频

目录 一、显示图像和视频 1、显示图像 2、显示视频 二、QtDesigner 窗口简单介绍 三、相关函数 1、打开本地图片 2、保存图片到本地 3、打开文件夹 4、打开本地文本文件并显示 5、保存文本到本地 6、关联函数 7、图片 “.png” | “.jpn” Label 自适应显示 一、显…

ModaHub魔搭社区:从OpenAI实践看分工必要性,核心关注工作流相关的基础软件工具栈

从OpenAI实践看分工必要性,核心关注工作流相关的基础软件工具栈 参考海外OpenAI的率先尝试,工作流分工、点工具加持助力成功。一方面,OpenAI在《GPT-4 Technical Report》论文中[1]中披露了参与GPT 4开发的人员分工,共249人,角色分工明确,预训练、强化学习和对齐、部署等…

ORCA优化器浅析——CXform base class for all transformations

CXform CXforml类作为所有transformation的基础类&#xff0c;其包含了pattern成员m_pexpr。主要是在exploration和implementation expression流程中使用&#xff0c;主要调用Transform函数。其还包含返回相关xforms的集合函数&#xff0c;比如PbsIndexJoinXforms等。 class …

运算器组成实验

1.实验目的及要求 实验目的 1、熟悉双端口通用寄存器组的读写操作。 2、熟悉运算器的数据传送通路。 3、验证运算器74LS181的算术逻辑功能。 4、按给定数据&#xff0c;完成指定的算术、逻辑运算。 实验要求 1、做好实验预习。掌握运算器的数据传送通路和ALU的功能特性&…

微服务实战项目-学成在线-项目优化(redis缓存优化)

微服务实战项目-学成在线-项目优化(redis缓存优化) 1 优化需求 视频播放页面用户未登录也可以访问&#xff0c;当用户观看试学课程时需要请求服务端查询数据&#xff0c;接口如下&#xff1a; 1、根据课程id查询课程信息。 2、根据文件id查询视频信息。 这些接口在用户未认…

verilog学习笔记5——进制和码制、原码/反码/补码

文章目录 前言一、进制转换1、十进制转二进制2、二进制转十进制3、二进制乘除法 二、原码、反码、补码1、由补码计算十进制数2、计算某个负数的补码 前言 2023.8.13 天气晴 一、进制转换 1、十进制转二进制 整数&#xff1a;除以2&#xff0c;余数倒着写 小数&#xff1a;乘…

QT之时钟

QT之时钟 会用到一个时间类:qtime 定时类:qtimer #------------------------------------------------- # # Project created by QtCreator 2023-08-13T10:49:31 # #-------------------------------------------------QT += core guigreaterThan(QT_MAJOR_VERSION,…

css3新增选择器总结

目录 一、属性选择器 二、结构伪类选择器 三、伪元素选择器 四、UI状态伪类选择器 五、反选伪类选择器 六、target选择器 七、父亲选择器、后代选择器 八、相邻兄弟选择器、兄弟们选择器 一、属性选择器 &#xff08;除IE6外的大部分浏览器支持&#xff09; E&#…