基于vscode在WSL中配置PlatformIO开发环境

一、虚拟机中新建目录

mkdir platformIO
cd platformIO/

二、安装必要的系统包

首先打开WSL终端，执行以下命令安装基础编译环境和Python虚拟环境支持：

sudo apt update
sudo apt install -y python3-pip python3-venv

三、安装PlatformIO Core

直接使用pip安装PlatformIO核心工具。为了提升下载速度，可以使用国内镜像源-7：

pip3 install -U platformio -i https://pypi.tuna.tsinghua.edu.cn/simple

安装成功后，尝试在终端输入 pio --version，如果能正常显示版本号，说明安装成功。

pio --version

四、将项目文件复制到 WSL

# 假设你的项目在 Windows 的 E:\PlatformIO_Projects\my_project
# 在 WSL 中复制项目文件（从 Windows 分区复制到 WSL 家目录）
cp -r /mnt/d/Download/firmware-master2 ~/platformIO/

# 进入项目目录
cd ~/platformIO/firmware-master2/

# 查看项目文件
ls -la

# 应该看到类似结构：
# platformio.ini
# src/
# include/
# lib/

五、 编译和测试

# 在项目目录中执行编译，使用并行编译加快速度
pio run -j 4

【加速方案：国内镜像源】

#立即加速的解决方案：使用国内镜像源（推荐）

# 创建 PlatformIO 配置文件
mkdir -p ~/.platformio

# 配置国内镜像源
cat > ~/.platformio/platformio.ini << 'EOF'
[platformio]
default_envs = powerbank-s3-epaper
packages_dir = ~/.platformio/packages
platforms_dir = ~/.platformio/platforms
framework_dir = ~/.platformio/frameworks

# 使用国内镜像
pypi_url = https://pypi.tuna.tsinghua.edu.cn/simple
package_blob_url = https://dl.registry.platformio.org/packages

[env:powerbank-s3-epaper]
platform = espressif32
board = t-deck
framework = arduino
EOF

pio run -j 4

六、编译和烧录

# 编译并上传到设备
pio run -t upload     #只上传

# 串口监听
pio run -t monitor    #只监听

七、测试完整流程

# 1. 进入项目目录
cd ~/platformIO/your_project_name

# 2. 清理之前的编译（可选）
pio run -t clean

# 3. 编译项目
pio run

# 4. 上传到设备
pio run -t upload

# 5. 监视串口输出（如果需要）
pio device monitor

八、解决可能的依赖问题

# 安装常用的编译工具
sudo modprobe usbserial
sudo modprobe cp210x
sudo modprobe ch341
sudo service udev restart