Ubuntu 22.04 + VSCode搭建SAM3开发环境

安装完成后，你会看到底部状态栏出现一个“蚂蚁”图标，说明PlatformIO已经激活。重启VSCode让插件完全生效。

4. 创建第一个PlatformIO项目（选择SAM3开发板）

点击左侧的PlatformIO图标（小蚂蚁），选择“Open” → “New Project”。在弹出的窗口中：

• Name：输入项目名称，例如“SAM3_Blink”。
• Board：在搜索框输入“Due”或“SAM3X”，选择“Arduino Due (Native USB Port)”（这是最常见的SAM3开发板，基于SAM3X8E单片机）。
• Framework：选择“Arduino”框架（对新手最友好）。
• Location：使用默认位置即可。

点击“Finish”，PlatformIO会自动下载需要的工具链和框架，等待几分钟。完成后，你会看到项目结构：包含src文件夹（存放源码）、platformio.ini（配置文件）等。

5. 编写测试代码（经典的LED闪烁）

在src文件夹下找到main.cpp（如果没有，就新建一个），双击打开，输入以下代码：

    #include void setup() {  pinMode(13, OUTPUT);  // 板载LED通常连接在数字13号引脚}void loop() {  digitalWrite(13, HIGH);  delay(1000);  digitalWrite(13, LOW);  delay(1000);}  

这是最简单的测试程序，让开发板上的LED每秒亮灭一次。如果你使用的是Arduino Due，板载LED通常连接在13号引脚。

6. 连接硬件并设置权限

用USB线将SAM3开发板（如Arduino Due）连接到电脑的USB口。在Ubuntu 22.04中，可能需要给串口设备添加读写权限，否则无法上传程序。执行以下命令将你的用户添加到dialout组：

    sudo usermod -a -G dialout $USER  

重要：执行后需要注销并重新登录，或者重启电脑，权限更改才会生效。

7. 编译并上传测试代码

回到VSCode，在底部PlatformIO工具栏找到“→”（上传）按钮，点击它。PlatformIO会自动编译代码并尝试上传到开发板。如果一切顺利，你会看到终端输出“SUCCESS”信息，并且开发板上的LED开始闪烁。

如果上传失败，检查开发板是否被识别：可以运行ls /dev/tty*查看是否有类似ttyACM0的设备。另外确保在platformio.ini中指定了正确的上传端口（通常PlatformIO会自动检测）。

8. 验证运行结果

观察开发板上的LED：如果它按一秒间隔闪烁，恭喜你，你的Ubuntu 22.04 + VSCode + SAM3开发环境已经完全搭建成功，并且成功运行了测试代码！

你可以修改delay的数值，重新上传，观察LED闪烁频率的变化，进一步理解代码逻辑。

常见问题与解决

• 编译错误：通常是因为框架没有下载完整，可以尝试删除项目，重新创建，让PlatformIO重新下载依赖。
• 上传失败：检查USB连接，确保开发板处于可上传状态（Arduino Due可能需要按一下板上的擦除按钮再上传）。另外检查dialout权限。
• 找不到开发板：在platformio.ini中手动指定board = due，并添加upload_port = /dev/ttyACM0（根据实际设备名）。

教程结束，希望你在Ubuntu 22.04下使用VSCode开发SAM3单片机的旅程顺利！