Skip to main content

如何使用PlatformIO IDE进行Arduino编程

正如您可能已经体验过的，当涉及到生产力时，Arduino IDE可能不是Arduino编程的最佳IDE，这里为您介绍一个更加开发友好的选择！在您喜爱的开发环境中使用Microsoft Visual Studio Code中的PlatformIO IDE来开发Wio Terminal和Seeeduino XIAO！

什么是PlatformIO​

PlatformIO是一个跨平台、跨架构、多框架的专业IDE工具，专为编写嵌入式应用程序的嵌入式系统和软件工程师设计。通过使用PlatformIO提供通用的IDE界面，您能够以更加开发友好的方式对您的硬件进行编程！

在本wiki中，您将能够配置PlatformIO以支持Wio Terminal和Seeeduino XIAO来开始您的编程！

更多信息，请访问PlatformIO

Platform IO IDE入门​

PlatformIO支持一些最流行的IDE和文本编辑器作为插件。在本wiki中，以VSCode的PlatformIO为例。

对于其他IDE，请查看以下参考：

VSCode的PlatfromIO​

  • 步骤1. 下载VSCode

下载并安装Microsoft Visual Studio Code

  • 步骤2. 为VSCode下载PlatformIO IDE插件

通过点击左侧面板上的Extensions或使用键盘快捷键在VS Code中打开Extensions Market：

note

键盘快捷键：Windows中为Shift+CTRL+X或macOS中为Shift+CMD+X。

在Extension Market中搜索**PlatfromIO并点击Install**：

  • 步骤3. 打开PlatformIO主页

点击底部PlatformIO工具栏上的"PlatformIO Home"按钮

现在，PlatformIO已安装到您的PC上！

Wio Terminal 和 Seeeduino XIAO 的配置​

Wio Terminal 和 Seeeduino XIAO 现已正式支持 PlatformIO：

  1. 导航到 PlatformIO 的根目录位置：

    • 对于 Unix：~/.platformio

    • 对于 Windows：C:\Users\{username}\.platformio，其中 {username} 是您的用户名。

  2. 导航到 platforms 文件夹。

  3. 下载配置好的 platform-atmelsam 到 platforms 文件夹。

支持的开发板​

配置好的 platform-atmelsam 支持以下开发板：

attention icon

提示

已经合并，很快就不再需要手动执行此操作。

快速开始​

本教程向您介绍 PlatformIO IDE 工作流程的基础知识，并在 Wio Terminal 上演示一个简单的"闪烁"示例。

  • 点击 PlatformIO Home 按钮。

  • 点击 New Project 并选择 Seeed Wio Terminal 作为开发板。

  • 打开 src 文件夹下的 main.cpp 并复制以下内容：
#include <Arduino.h>

void setup() {
  // initialize digital pin LED_BUILTIN as an output.
  Serial.begin(9600);
  pinMode(LED_BUILTIN, OUTPUT);
}

// the loop function runs over and over again forever
void loop() {
  digitalWrite(LED_BUILTIN, HIGH);   // turn the LED on (HIGH is the voltage level)
  delay(1000);                       // wait for a second
  digitalWrite(LED_BUILTIN, LOW);    // turn the LED off by making the voltage LOW
  delay(1000);                       // wait for a second
}
  • 打开 platformio.ini 配置文件并检查其是否正确：
[env:seeed_wio_terminal]
platform = atmelsam
board = seeed_wio_terminal
framework = arduino
  • 通过 PlatformIO 工具栏上的 Build 按钮或键盘快捷键构建项目。
note

构建项目：在 Windows 中使用 ctrl+alt+b 或在 macOS 中使用 cmd+shift+b。

  • 通过点击 PlatformIO 工具栏上的 Upload 按钮将项目上传到 Wio Terminal。
  • 现在您应该看到 Wio Terminal 的 LED 在闪烁！

有关更多 PlatformIO For VSCode 入门指南，请参考这里。

向 PlatformIO 添加库​

直接导入库​

要从 Github 直接导入库到 PlatformIO，您可以配置 platformio.ini 并添加带有依赖库 url 的 lib_deps，如下所示：

lib_deps = https://github.com/Seeed-Studio/Seeed_Arduino_LIS3DHTR

- 示例用法：

#include <Arduino.h>
#include<LIS3DHTR.h>

LIS3DHTR<TwoWire> lis;

void setup() {
  Serial.begin(115200);
  lis.begin(Wire1);

  if (!lis) {
    Serial.println("ERROR");
    while(1);
  }
  lis.setOutputDataRate(LIS3DHTR_DATARATE_25HZ); //数据输出速率
  lis.setFullScaleRange(LIS3DHTR_RANGE_2G); //量程范围设置为2g
}

void loop() {
  float x_values, y_values, z_values;
  x_values = lis.getAccelerationX();
  y_values = lis.getAccelerationY();
  z_values = lis.getAccelerationZ();

  Serial.print("X: "); Serial.print(x_values);
  Serial.print(" Y: "); Serial.print(y_values);
  Serial.print(" Z: "); Serial.print(z_values);
  Serial.println();
  delay(50);
}

从 Arduino 导入​

导入库的另一种方法是在 platformio.ini 配置文件中指向 Arduino 库路径，例如：

lib_extra_dirs = /Users/{username}/Documents/Arduino/libraries
caution

这不是指向包含源代码的库的直接路径。它应该是指向包含按文件夹分组的库的存储位置的路径。例如，D:\PlatformIO\extra\libraries 而不是 D:\PlatformIO\extra\libraries\FooLibrary。

有关更多库选项，请参阅 PlatformIO 库文档。

为 Seeed 使用最新的 ArduinoCore 库​

PlatformIO 中的 ArduinoCore 由 PlatformIO 自己维护，有时它没有与 Seeed 发布的最新版本保持同步。在这种情况下，您可以使用以下 platformio.ini，例如：

; PlatformIO 项目配置文件
;
;   构建选项：构建标志、源过滤器
;   上传选项：自定义上传端口、速度和额外标志
;   库选项：依赖项、额外库存储
;   高级选项：额外脚本
;
; 请访问文档了解其他选项和示例
; https://docs.platformio.org/page/projectconf.html

[env:seeed_wio_terminal]
platform = atmelsam
board = seeed_wio_terminal
framework = arduino
platform_packages = framework-arduino-samd-seeed@https://github.com/Seeed-Studio/ArduinoCore-samd.git

PlatformIO 的其他有用功能​

Loading Comments...