From 0d6ba0e7c3dac6d87e09dd19389785654612f480 Mon Sep 17 00:00:00 2001 From: liuyihui Date: Wed, 3 Apr 2024 20:23:03 +0800 Subject: [PATCH] feat: linux installation and uspipd-win --- doc/chap0.md | 20 ++++++++++++++++---- 1 file changed, 16 insertions(+), 4 deletions(-) diff --git a/doc/chap0.md b/doc/chap0.md index 87a22aa..ddf6ed2 100644 --- a/doc/chap0.md +++ b/doc/chap0.md @@ -12,10 +12,21 @@ Blazar 开源硬件系统以类游戏机的功能布局，搭载了 I/O 按键 Blazar 项目团队 2017 年在清华大学制作完成了 MOOC 在线开放课程 [ARM微控制器与嵌入式系统](https://www.xuetangx.com/course/THU08091000246/14768615?channel=i.area.manual_search)。2018 年，此 MOOC 课程被评为国家精品在线开放课程，累计已有数万人次在线选课学习。 -## 工具配置 +## Linux 环境准备 +本指南的开发将会在 Linux 环境下进行，因此需要准备好 Linux 开发环境。如果您还没有 Linux 开发环境，有三种主要方式可以选择： +1. 在本地安装 Linux：有一台运行 Linux 的计算机，可以直接安装开发环境。 +2. 在虚拟机中安装 Linux：在 VMware、VirtualBox 或其他虚拟机软件中安装 Linux 系统。 +3. 在 Windows 系统上安装 Linux 子系统（Windows Subsystem for Linux，WSL）：Windows 10 版本 1903 及以上版本支持安装 WSL2 系统。 -为继续进行，需要以下工具： +### 本地安装 Linux（待补充） + +### 虚拟机安装 Linux（待补充） +### WSL 安装 Linux（待补充） +安装结束后，由于调试过程中需要用到 USB 接口进行通信，我们需要将 USB 接口从 Windows 系统中转接到 WSL 中，使用的工具为 [usbipd-win](https://github.com/dorssel/usbipd-win)，具体可参考 [连接 USB 设备](https://learn.microsoft.com/zh-cn/windows/wsl/connect-usb)。 + +## 工具配置 +为继续进行，需要以下工具： - [ARM GCC](https://developer.arm.com/downloads/-/gnu-rm) - 编译和链接 - [GNU make](http://www.gnu.org/software/make/) - 构建自动化 - [SEGGER J-Link](https://www.segger.com/downloads/jlink/) - 烧写固件与调试 @@ -50,7 +61,7 @@ $ brew install make ### 烧录与调试工具 J-Link 前往 [SEGGER J-Link](https://www.segger.com/downloads/jlink/) 下载对应安装包安装好 J-Link，安装完成之后将安装位置加入到环境变量`PATH`中。 -### VSCode +### 代码编辑与调试平台 VSCode 安装好 VSCode 本体之后，我们需要安装若干插件完善开发的体验： * [C/C++](https://marketplace.visualstudio.com/items?itemName=ms-vscode.cpptools): C/C++ IntelliSense, debugging, and code browsing. * [Cortex-Debug](https://marketplace.visualstudio.com/items?itemName=marus25.cortex-debug): ARM Cortex-M GDB Debugger support for VSCode @@ -63,4 +74,5 @@ $ brew install make - [Cortex-M0+ Devices Generic User Guide](https://developer.arm.com/documentation/dui0662/b/) ## 参考资料 -1. [Visual Studio Code for C/C++ with ARM Cortex-M: Part 1 – Installation](https://mcuoneclipse.com/2021/05/01/visual-studio-code-for-c-c-with-arm-cortex-m-part-1/) \ No newline at end of file +1. [Visual Studio Code for C/C++ with ARM Cortex-M: Part 1 – Installation](https://mcuoneclipse.com/2021/05/01/visual-studio-code-for-c-c-with-arm-cortex-m-part-1/) +2. [连接 USB 设备](https://learn.microsoft.com/zh-cn/windows/wsl/connect-usb) \ No newline at end of file