嵌入式 环境配置 - macOS

适用系统： macOS（Intel 或 Apple Silicon）

所需组件概览

跟随本教程，你将会安装以下组件：

• Homebrew
• Git
• GNU Make
• CMake
• Ninja
• GCC
• Arm GNU Toolchain
• Visual Studio Code（最新版）
• STM32CubeMX（最新版，不是 STM32CubeMX2）
• SEGGER J-Link Software and Documentation Pack（V7.92c）
• SEGGER Ozone（V3.30b）
• SEGGER SystemView

1. 下载所需安装包

请严格按照下方标注选择对应软件版本。对于指定了固定版本的软件，不要直接下载最新版。

Intel 芯片请选择 x86_64 版本；Apple Silicon 芯片请选择 ARM64 版本。

1.1 Visual Studio Code

从 Visual Studio Code 官方网站 下载适用于 macOS 和当前芯片架构的最新安装包。

1.2 STM32CubeMX

打开 STM32CubeMX 官方下载页面，登录或注册 ST 账号，然后下载适用于 macOS 和当前芯片架构的最新版本。

请下载 STM32CubeMX，不要下载 STM32CubeMX 2。

1.3 SEGGER J-Link

从 J-Link 官方下载页面 下载适用于 macOS 和当前芯片架构的 V7.92c 版本。

1.4 SEGGER Ozone

从 Ozone 官方下载页面 下载适用于 macOS 和当前芯片架构的 V3.30b 版本。

1.5 SEGGER SystemView

从 SystemView 官方下载页面 下载适用于 macOS 和当前芯片架构的 V3.60 版本。

1.6 Serial Port 串口调试助手

从 App Store 中搜索serial port并下载安装

2. 安装 Visual Studio Code

解压第 1 节下载的安装包并安装 Visual Studio Code。

3. 安装 Homebrew

3.1 打开终端

1. 按 Command + Space 打开 Spotlight。
2. 输入 terminal，然后打开“终端”。

3.2 执行安装命令

在终端中执行：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"

如果终端要求输入密码，请输入当前用户的登录密码。输入密码时终端不会显示任何字符，这是正常现象。

出现确认提示时按 Enter。之后如果安装程序再次等待输入，继续按 Enter，直到安装完成。

安装完成后，关闭当前终端窗口，并重新打开终端，执行以下命令验证：

brew --version

确认能够显示 Homebrew 版本信息后，再继续后续安装。

4. 配置 Git 与 GitHub

4.1 安装 Git

在终端中执行：

brew install git

Git 安装完成后，终端输出应与下图类似：

4.2 使用 SSH 连接 GitHub

如果还没有 GitHub 账号，请先前往 GitHub Sign Up 注册并登录。

打开 GitHub SSH keys 设置，点击 New SSH key。

在终端中执行以下命令，将 [email protected] 替换为 GitHub 账号使用的邮箱：

ssh-keygen -t ed25519 -C [email protected]

出现输入提示时按 Enter 接受默认设置，直到生成完成。终端显示的内容不必与下图完全相同，但整体格式应相似。

在输出中找到 Your public key has been saved in 后面的公钥文件路径。该路径通常以 .pub 结尾，将其复制下来。

在终端中输入 cat、一个空格，再粘贴刚才复制的路径，然后按 Enter。例如：

cat /Users/yourname/.ssh/id_ed25519.pub

终端将显示一行以 ssh-ed25519 开头的内容。复制整行公钥。

回到 GitHub 的 Add new SSH Key 页面：

1. 在 Title 中输入任意便于识别的名称。
2. 将刚才复制的公钥粘贴到 Key 中。
3. 点击 Add SSH key。

添加成功后，SSH key 将出现在账号设置页面中：

在终端中测试连接：

ssh -T [email protected]

第一次连接时，终端可能要求确认主机身份。输入 yes 并按 Enter。

如果看到以下信息，说明 SSH 连接配置成功：

Hi xxxxx! You've successfully authenticated, but GitHub does not provide shell access.

4.3 设置 Git 用户信息

在终端中分别执行以下命令，将姓名和邮箱替换为自己的信息：

git config --global user.name "Your Name"
git config --global user.email [email protected]

Git 用户信息说明

• user.name 不必与 GitHub 用户名相同，它只是提交记录中显示的作者名称。
• Git 对提交邮箱没有格式要求。若希望提交记录关联到 GitHub 账号并计入贡献统计，请使用已关联到该账号的邮箱。
• 提交邮箱会写入 Git 历史并可能公开。如不想公开真实邮箱，可使用 GitHub 提供的 noreply 邮箱。

详情请参阅 GitHub 贡献归属说明 和 设置提交邮箱。

执行以下命令确认配置：

git config --global --get user.name
git config --global --get user.email

5. 安装编译工具链

在终端中依次执行以下命令：

brew install make
brew install cmake
brew install ninja
brew install gcc
brew install --cask gcc-arm-embedded

安装完成后，执行以下命令验证编译工具链：

make --version
cmake --version
ninja --version
arm-none-eabi-gcc --version
arm-none-eabi-g++ --version

如果终端能够显示版本信息，说明工具链已经安装成功。

6. 安装嵌入式开发软件

6.1 STM32CubeMX

• 解压并打开第 1 节下载的 STM32CubeMX 安装程序，按照提示完成安装。

6.2 SEGGER J-Link

• 打开第 1 节下载的 J-Link V7.92c 安装包，按照提示完成安装。

6.3 SEGGER Ozone

• 打开第 1 节下载的 Ozone V3.30b 安装包，按照提示完成安装。

6.4 SEGGER SystemView

• 打开第 1 节下载的 SystemView 安装包，按照提示完成安装。

7. 使用提示

7.1 从文件夹打开 Visual Studio Code

首次使用 code 命令前，需要先将它添加到 PATH：

1. 打开 Visual Studio Code，按 Command + Shift + P 打开命令面板。
2. 输入 shell command，然后选择 Shell Command: Install 'code' command in PATH。

安装完成后，关闭并重新打开终端，然后按照以下步骤从工程目录启动 Visual Studio Code：

1. 打开访达（Finder），在屏幕顶部的菜单栏中选择 显示，然后点击 显示路径栏。

   

2. 在访达中找到工程文件夹。窗口底部的路径栏会显示当前文件夹的完整路径。

   

3. 在路径栏中右键点击要打开的工程文件夹，选择 在终端中打开，然后在打开的终端中执行：

   code .
   

   

7.2 打开 STM32CubeMX 工程

在 macOS 上，双击 .ioc 文件可能无法正确加载工程。建议打开 STM32CubeMX，然后使用 Load Project 功能选择并打开 .ioc 工程文件。

如果 STM32CubeMX 无法找到 .ioc 工程文件，请按照以下步骤为 STM32CubeMX 开启“完全磁盘访问权限”：

1. 打开 系统设置，选择 隐私与安全性，然后点击 完全磁盘访问权限。

   

2. 在应用列表中找到 STM32CubeMX，并打开右侧的开关。如果列表中没有 STM32CubeMX，请点击左下角的 + 将其添加。

   

7.3 开启 Visual Studio Code 自动保存

建议开启自动保存，避免修改代码后忘记保存，导致编译时仍使用旧代码。

在 Visual Studio Code 顶部菜单栏中选择 文件 → 自动保存。菜单项前出现勾选标记即表示已开启，如下图所示。

8. 下一步

环境配置完成。接下来请继续进行 环境验证。