在Zephyr RTOS开发环境中构建并将“Hello World”项目flash到功能强大的ESP32-S3开发板上

在第一篇文章中，我们从头开始构建了一个干净的、完全可控的Zephyr RTOS开发环境。现在是时候用更先进的微控制器来测试它的功率了。

在本指南中，我们将使用我们的新环境来构建并将“Hello World”项目flash到功能强大的ESP32-S3 (N16R8)开发板上。这是一个庞然大物，具有双核处理器，Wi-Fi，蓝牙5 (LE)， 16MB的大闪存和8MB的PSRAM。

为了做到这一点，我们将使用一个最小的、生产就绪的模板，该模板预先配置为Visual Studio Code中的无缝体验。

1. 你需要什么

在我们开始之前，请确保一切都准备好了。硬件很简单，如果您按照我们的第一个指南进行操作，软件应该已经配置好了。

硬件:

•ESP32-S3开发板(本指南使用的是带有N16R8芯片的通用板)。

•一根USB Type-C线(确保它是数据线，而不仅仅是充电线!)

软件:

•一个完整配置的Zephyr RTOS环境(Python, Git, West， SDK等)。

•Visual Studio Code与推荐的扩展(包括C/ c++， CMake工具，和任务管理器)。

刚开始?如果你还没有准备好你的开发环境，请先按照我的详细指南：Manual Zephyr RTOS Installation on Windows。此项目模板假定您的环境已经准备就绪。

2. 快速入门：从零到“Hello World”

重要：确保您的Zephyr环境已激活!zephyr-env运行。CMD -你的终端应该在提示符下显示(.venv)。

2.1. 获取项目模板

将存储库克隆到本地机器并在Visual Studio Code中打开它：

2.2. 连接硬件

连接ESP32-S3非常简单。将USB-C电缆插入主板的USB-to-UART端口(通常标有“UART”或“COM”)，并将另一端连接到您的计算机。

2.3. 构建项目

我们将使用VS Code任务来简化工作流。你有两个选择：

选项A：命令面板

•按Ctrl+Shift+B或进入“Terminal→Run Task…”

•从下拉菜单中选择Build

选项B：任务浏览器(推荐)

•打开任务资源管理器面板(侧栏)

•单击Build任务旁边的播放按钮

等待构建完成。您应该在终端中看到构建成功。

2.4. 闪光板

使用相同的方法(Command Palette或task Explorer)运行Flash任务。单板应自动检测并闪现。

2.5. 监控输出

现在，运行Monitor任务。一个串行监视器将在VS Code终端中打开。

2.6. 庆祝!

您应该看到消息Hello World!每一秒都在打印。您刚刚在ESP32-S3上运行了第一个Zephyr应用程序!

3. 引擎盖下：是什么让这个模板聪明

这个模板不仅仅是打印文本;正确配置ESP32-S3的复杂硬件，实现高性能。

3.1. 硬件配置(' esp32s3_devkit .overlay ')

覆盖文件是硬件设置的核心，它告诉Zephyr如何处理这块板上巨大的16MB闪存和8MB PSRAM。

主要特点:

•PSRAM Enabled：显式将PSRAM大小设置为8MB。

•Flash Size Defined：配置Flash的最大容量为16MB。

•分区表：包括一个标准的16MB分区布局，这对于ESP-IDF引导加载程序和固件存储是必不可少的。

比命令行代码段更聪明的方法

ESP32板的世界是多样化的，有几十种Flash和PSRAM尺寸的组合。为了管理这种复杂性，Zephyr提供了一个名为Snippets的强大功能。

代码片段是模块化的配置文件，您可以在构建时使用-S标志应用它。例如，标准的Zephyr配置电路板的方法是运行这样的命令：

虽然这个系统非常灵活，但它要求您将这些标志添加到每个构建命令中。此模板通过将我们的16MB闪存和8MB PSRAM板的配置直接嵌入到。覆盖文件。这使得构建过程更加清晰，并且VS Code构建任务可以完美地开箱即用。

为您的板调整模板

如果你的主板有不同的Flash/PSRAM配置(例如，8MB Flash和2MB PSRAM)，你可以很容易地切换到使用片段。方法如下:

1.清除覆盖文件：打开esp32s3_devkitc. exe文件。覆盖文件并删除其所有内容。

2. 在VS Code中激活代码片段：打开.vscode/tasks。json文件。在Build任务中，你会发现这些被注释掉的行：

3. 取消注释和配置：取消注释这些行并更改值以匹配您的硬件(例如，“flash-8M”，“psram-2M”)。

3.2. 项目配置(Project .conf)

该文件对内核和驱动程序进行微调，以获得最佳性能。

CONFIG_SPIRAM_MODE_OCT=y：开启PSRAM的八进制SPI模式。它使用8条数据线来快速访问外部存储器。

•CONFIG_ESPTOOLPY_FLASHMODE_QIO=y：启用主flash的Quad I/O模式。它使用4条数据线来加速代码执行。

•80MHz可选模式：默认为40MHz。为了获得最佳性能，您可以取消注释最后两行，以80MHz的速度运行PSRAM和Flash。

3.3. 应用程式码(src/main.c)

代码本身是为Zephyr量身定制的经典“Hello World”。

它没有切换引脚，而是使用printk()将格式化的字符串发送到串行控制台，这是调试的基本工具。

3.4. VS Code工作流

任务。json：定义Build、Flash、Monitor和Clean脚本。构建任务是精心制作的，明确指向正确的板目标(esp32s3_devkitc/esp32s3/procpu)和我们的自定义覆盖文件，确保每次都有完美的构建。

c_cpp_properties。json：该文件配置智能感知。重要：必须至少运行一次Build任务才能使代码完成工作完美，因为它依赖于compile_commands。在构建期间生成的Json文件。

4. 常见问题处理

“west: command not found”

•原因：Zephyr环境没有被激活。

•解决方案：运行zephyr-env。cmd脚本(Windows)或源环境文件。您的提示符应该显示(.venv)。

“闪烁失败，出现‘串行异常’或‘连接失败’”

•原因：单板未进入引导加载模式或USB线缆故障。

•解决方案:

1. 确保您使用的是具有数据功能的USB电缆。

2. 手动进入引导模式：长按BOOT，按下RESET，然后释放BOOT。重新运行Flash任务。

“串行监视器中出现乱码或无输出”

•原因：波特率不匹配或连接不良。

•解决方法：VS Code Monitor任务自动处理波特率(115200)。按下单板上的RESET按钮。如果失败，请重新检查USB电缆和连接。

5. 结论

恭喜你!您已经在功能强大的ESP32-S3上成功构建、刷新和监视了第一个Zephyr项目。

这个模板提供了一个坚如磐石的基础，处理棘手的内存配置，这样您就可以专注于编写应用程序代码。集成的VS Code工作流使整个开发过程快速、高效和愉快。

本文编译自hackster.io