WAVEGO Pro-开发环境配置

来自Waveshare Wiki
跳转至： 导航、 搜索

开发环境搭建

简介

  • 本章主要介绍了WAVEGO Pro在VS Code上进行开发的开发环境配置，通过本章的学习，您可以开始WAVEGO Pro下位机ESP32的开发之路。

安装VS Code

  1. 首先到VS Code官网点击 ”other platforms“，根据操作系统选择对应版本下载：（我们这里以 Windows 系统的安装为例）下载 .exe 安装包。
    Image.png
  2. 运行安装程序，选择同意许可协议以及安装目标位置，“Additional Tasks” 勾选如下，勾选 ”Add to PATH（requires shell restart）“以便在命令行中使用 code 命令启动 VS Code。接下来按照提示完成安装。
    Image (1).png
    安装完成后启动 VS Code，安装完成界面如下：
    Vscodejietu.png

VS Code个性化设置

点击右下角的 ”Next“，可进入个性化设置流程。推荐设置如下：

  • 主题选择：根据喜好设置暗色/亮色主题
  • 扩展语言支持：如果你主要用于机器人下位机的开发，点击 “Browse Language Extensions”，窗口左边会弹出扩展插件的列表，建议安装：

C/C++ Extension Pack
HTML CSS Support
Vdcodegx.png
安装过程中如果弹出如下窗口，请选择 “Trust Publisher & Install” 以信任并安装插件。
Vscodegx2.png

安装 PlatformIO 插件

  1. 点击 VS Code 左侧的扩展（Extensions）图标打开插件选项列表，或使用快捷键 Ctrl+Shift+X 可直接打开插件选项列表。在搜索框中输入 "PlatformIO IDE"，点击安装 “PlatformIO IDE“。
    Vscodeplat.png
  2. 安装过程中如果弹出如下窗口，请选择 “Trust Publisher & Install” 以信任并安装插件。
    Platformio.png
  3. 等待安装完成后，VS Code 会自动打开 PlatformIO 的 Welcome 页面，此时右下角会显示 PlatformIO 的安装进度。整个安装过程可能需要较长的时间，且安装 PlatformIO Core 的耗时可能会更长一些，请耐心等待。
    Platformio2.png
  4. 首次安装 PlatformIO Core 时，**如果你没有重启 VS Code，可能会导致安装失败**。这是因为缺失安装脚本里面需要用到的一些新命令。需要进行如下操作：
    关闭并重新打开 VS Code，但不要关闭 PlatformIO 的 Welcome 页面（若关闭，可通过点击左侧的蚂蚁头 :anthead: 图标重新打开）
    重启后等待 PlatformIO Core 安装完成，右小角出现以下消息表示安装成功。
    Platformio3.png

创建 PlatformIO 项目

    ⚠️注意：在创建 PlatformIO 项目之前，请确保已完成前面所有插件的安装并已重启 VS Code，以确保前面安装的插件（尤其是 PlatformIO）配置生效，避免后续操作出错。
  1. 重启 VS Code 后你在 PlatformIO IDE 的 Welcome 页面可以依次阅读 PlatformIO 的相关特性。安装 PlatformIO IDE 时会自动安装 PlatformIO Core，所以 “Install PlatformIO Core” 按钮点击不会有响应。
    Vscodeplatformio1.png
  2. 点击 VS Code 左侧的蚂蚁头图标，打开 PlatformIO Project 项目列表。点击 “Create New Project” 开始创建项目。
    Vscodeplatformio2.png
  3. 点击 ”Create New Project“ 后，会进入 PIO Home 界面。点击 ”New Project“ 会弹出项目信息输入框。
    Vscodeplatformio3.png
  4. 在项目向导界面填写以下信息：
    • 项目名称
    • 选择开发板（根据机器人项目所使用的下位机驱动板类型来选择）：
    • 如果是 ESP32S3 的驱动板，可以选择 Espressif ESP32-S3-DevKitC-1-N8 (8 MB QD, No PSRAM)
    • 如果是 ESP32 的驱动板，可以选择 Espressif ESP32 Dev Module（WAVEGO Pro的开发板用的是该型号）
    • 选择开发框架：Arduino 框架（建议选择 Arduino 框架，因为我们提供的例程都是基于 Arduino 框架且需要大量的依赖库支持）
    Vscodeplatformio4.png
  5. 填写完成后，点击右下方的 ”Finish“。首次创建 ESP32-S3/ESP32 项目时，PlatformIO 会自动下载 Espressif32 平台、ESP32-S3/ESP32 对应所需的工具链以及编译器，有时会受网络速度影响（国内网络访问 PlatformIO 官方服务器时较慢），因此这个过程可能需要较长的时间。建议保持稳定的网络连接。这个过程中鼠标不要点击 VS Code 界面的其它地方。
    Vscodeplatformio5.png
  6. 当首次配置完成后，会提示你是否相信这个项目的作者，勾选 ”Trust the authors of all files in the parent folder ‘Github’“，并点击 Yes, I trust the authors。
    Vscodeplatformio6.png
  7. 至此，你已经创建了第一个 PlatformIO 项目，点击 VS Code 左上角的 EXPLORER，打开项目目录，可以看见刚刚创建的 PIO_TEST_01 项目和这个项目的文件结构。
    Vscodeplatformio7.png

编译 WAVEGO Pro源码

  1. 进入PlatformIO主页面点击Open Project。
    企业微信截图 17682868208962.png
  2. 选择到图中这个层级的目录点击Open "WAVEGO_Pro_PlatformIO"。
    企业微信截图 17682870657225.png
  3. 点击 VS Code 界面左下角底部状态栏的 “√” 图标（或者使用快捷键 Ctrl + Alt + B），进行编译项目（此操作不会上传程序到驱动板）。
    企业微信截图 17682875813534.png
  4. 编译后程序下方会自动打开一个面板，从这个面板可以看见 PROBLEMS、OUTPUT、DEBUG CONSOLE、TERMIANL、PORTS 等信息。当 TERMINAL 终端窗口显示 SUCCESS，表示项目编译成功，至此，已成功配置 PlatformIO 的开发环境。
    企业微信截图 17682877234213.png
取自“https://www.waveshare.net/w/index.php?title=WAVEGO_Pro-开发环境配置&oldid=140900”