1. 安装 VSCode

   • 访问 VSCode 官网 下载 .deb 包
   • 使用以下命令安装：

     sudo dpkg -i <下载的文件名>.deb
     sudo apt-get install -f
     

2. 安装 PlatformIO 扩展

   • 在 VSCode 中，转到扩展市场（Ctrl+Shift+X）
   • 搜索 “PlatformIO IDE”
   • 点击 “安装”

3. 创建 PlatformIO 项目

   • 在 VSCode 中，点击 PlatformIO 图标（通常在左侧栏）
   • 选择 “New Project”
   • 选择 Board: “Arduino Uno”
   • 选择 Framework: “Arduino”
   • 选择项目位置并命名
     

4. 编写代码

   • 在 src/main.cpp 中编写或粘贴您的 Arduino 代码

     #include <Arduino.h>void printMenu() {Serial.println("\n--- Arduino Menu ---");Serial.println("1. Say Hello");Serial.println("2. Get Arduino Uptime");Serial.println("3. Blink LED");Serial.println("Enter your choice:");
     }void setup() {Serial.begin(9600);while (!Serial) {; // Wait for serial port to connect (needed for native USB port only)}Serial.println("Arduino ready for communication!");pinMode(LED_BUILTIN, OUTPUT);printMenu();
     }void loop() {if (Serial.available() > 0) {char choice = Serial.read();// Clear the serial bufferwhile (Serial.available() > 0) {Serial.read();}switch (choice) {case '1':Serial.println("Hello from Arduino!");break;case '2':Serial.print("Arduino uptime: ");Serial.print(millis() / 1000);Serial.println(" seconds");break;case '3':Serial.println("Blinking LED 3 times...");for (int i = 0; i < 3; i++) {digitalWrite(LED_BUILTIN, HIGH);delay(500);digitalWrite(LED_BUILTIN, LOW);delay(500);}Serial.println("Blinking complete!");break;default:Serial.println("Invalid choice. Please try again.");}printMenu();}
     }
     

5. 连接 Arduino Uno

   • 使用 USB 线将 Arduino Uno 连接到电脑

6. 编译和上传

   • 点击 VSCode 底部状态栏的 “PlatformIO: Build” 图标编译代码
   • 点击 “PlatformIO: Upload” 图标将程序上传到 Arduino Uno
   • 点击vscode下方的Auto

7. 监视串口输出

   • 点击 “PlatformIO: Serial Monitor” 图标打开串口监视器
   • 这时在串口监视器中输入数字，就可以选择相应的功能。

   注：如果遇到权限问题，可能需要将用户添加到 dialout 组：

   sudo usermod -a -G dialout $USER
   

   添加后需要注销并重新登录才能生效。

故障排除

串口监视器错误

如果在点击 “PlatformIO: Serial Monitor” 时出现类似以下的错误：
这是因为 PlatformIO 在尝试运行测试，但是找不到测试文件。解决方法如下：

1. 确保您不是在运行测试命令。串口监视器应该使用 “Monitor” 命令，而不是 “Test” 命令。

2. 如果问题仍然存在，尝试以下步骤：

   • 在项目根目录创建一个 test 文件夹（如果不存在）
   • 在 test 文件夹中创建一个空的测试文件，例如 test_main.cpp
   • 在 test_main.cpp 中添加以下内容：

     #include <unity.h>void setUp(void) {// set stuff up here
     }void tearDown(void) {// clean stuff up here
     }void test_function_calculator_addition(void) {TEST_ASSERT_EQUAL(32, 25 + 7);
     }int main(int argc, char **argv) {UNITY_BEGIN();RUN_TEST(test_function_calculator_addition);UNITY_END();return 0;
     }
     

3. 尝试使用命令行运行串口监视器：

   • 打开终端
   • 导航到项目目录
   • 运行命令：pio device monitor

4. 检查 platformio.ini 文件，确保正确配置了串口监视器：

   [env:uno]
   platform = atmelavr
   board = uno
   framework = arduino
   monitor_speed = 9600
   

如果问题仍然存在，可以尝试重新安装 PlatformIO 或查看 PlatformIO 的官方文档以获取更多帮助。