WSL2搭建基于Docker的ESP32开发环境

WSL2 安装

• 如何在 Windows 上安装 WSL2
  

1. sudo apt install esptool
2. sudo apt install linux-tools-generic hwdata
3. sudo update-alternatives --install /usr/local/bin/usbip usbip /usr/lib/linux-tools/*-generic/usbip 20

复制代码

Docker安装和配置

一键安装脚本

1. curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun

复制代码

配置

1. cat /etc/docker/daemon.json
2. {
3.   "registry-mirrors" : ["https://docker.registry.cyou",
4.         "https://docker-cf.registry.cyou",
5.         "https://dockercf.jsdelivr.fyi",
6.         "https://docker.jsdelivr.fyi",
7.         "https://dockertest.jsdelivr.fyi",
8.         "https://mirror.aliyuncs.com",
9.         "https://dockerproxy.com",
10.         "https://mirror.baidubce.com",
11.         "https://docker.m.daocloud.io",
12.         "https://docker.nju.edu.cn",
13.         "https://docker.mirrors.sjtug.sjtu.edu.cn",
14.         "https://docker.mirrors.ustc.edu.cn",
15.         "https://mirror.iscas.ac.cn",
16.         "https://docker.rainbond.cc",
17.         "https://do.nark.eu.org",
18.         "https://dc.j8.work",
19.         "https://dockerproxy.com",
20.         "https://gst6rzl9.mirror.aliyuncs.com",
21.         "https://registry.docker-cn.com",
22.         "http://hub-mirror.c.163.com",
23.         "http://mirrors.ustc.edu.cn/",
24.         "https://mirrors.tuna.tsinghua.edu.cn/",
25.         "http://mirrors.sohu.com/"
26.         ],
27.          "insecure-registries" : [
28.             "registry.docker-cn.com",
29.             "docker.mirrors.ustc.edu.cn"
30.             ],
31.         "debug": true,
32.         "experimental": false
33. }

复制代码

1. sudo systemctl daemon-reload
2. sudo systemctl restart docker

复制代码

测试Docker

1. sudo docker pull hello-world
2. Using default tag: latest
5. latest: Pulling from library/hello-world
6. Digest: sha256:ec153840d1e635ac434fab5e377081f17e0e15afab27beb3f726c3265039cfff
7. Status: Image is up to date for hello-world:latest
8. docker.io/library/hello-world:latest

复制代码

1. sudo docker run hello-world
2. [sudo] password for cmf:
4. Hello from Docker!
5. This message shows that your installation appears to be working correctly.
7. To generate this message, Docker took the following steps:
8. 1. The Docker client contacted the Docker daemon.
9. 2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
10.     (amd64)
11. 3. The Docker daemon created a new container from that image which runs the
12.     executable that produces the output you are currently reading.
13. 4. The Docker daemon streamed that output to the Docker client, which sent it
14.     to your terminal.
16. To try something more ambitious, you can run an Ubuntu container with:
17. $ docker run -it ubuntu bash
19. Share images, automate workflows, and more with a free Docker ID:
20. https://hub.docker.com/
22. For more examples and ideas, visit:
23. https://docs.docker.com/get-started/

复制代码

设置以非 root 用户身份管理 Docker

• Docker Engine 的 Linux 安装后步骤
  

创建docker组。

1. sudo groupadd docker

复制代码

将您的用户添加到docker组。

1. sudo usermod -aG docker $USER

复制代码

注销并重新登录WSL2，在Windows Cmd下执行。

1. wsl --shutdown

复制代码

还可以运行以下命令来激活对组的更改：

1. newgrp docker

复制代码

验证是否可以在没有sudo的情况下运行命令。

1. docker run hello-world
3. Hello from Docker!
4. This message shows that your installation appears to be working correctly.
6. To generate this message, Docker took the following steps:
7. 1. The Docker client contacted the Docker daemon.
8. 2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
9.     (amd64)
10. 3. The Docker daemon created a new container from that image which runs the
11.     executable that produces the output you are currently reading.
12. 4. The Docker daemon streamed that output to the Docker client, which sent it
13.     to your terminal.
15. To try something more ambitious, you can run an Ubuntu container with:
16. $ docker run -it ubuntu bash
18. Share images, automate workflows, and more with a free Docker ID:
19. https://hub.docker.com/
21. For more examples and ideas, visit:
22. https://docs.docker.com/get-started/

复制代码

拉取Docker镜像

1. cat docker-compose.yml
2. version: "3.8"
4. services:
5.   esp-idf:
6.     image: espressif/idf
7.     container_name: esp-idf-builder
8.     working_dir: /project
9.     volumes:
10.       - .:/project
11.     environment:
12.       - HOME=/tmp
13.       - IDF_GIT_SAFE_DIR=/project
14.     tty: true
15.     stdin_open: true

复制代码

1. docker compose up

复制代码

VsCode

• Visual Studio Code Download
  

需要安装的插件

• Dev Containers
  
• Remote Development
  
• ESP-IDF
  

Code

1. git clone https://github.com/espressif/esp-idf.git

复制代码

使用hello_world为示例工程

1. cp -rf esp-idf/examples/get-started/hello_world .

复制代码

使用vscode打开hello_world工程

1. cd hello_world
2. code .

复制代码

在VsCode的菜单栏选择 查看 > 命令面板，在弹出的对话框中输入ESP-IDF: Add docker container configuration。
然后当前项目的 .devcontainer 文件夹就会自动生成了。下一步在点击左下角的连接->在容器中重新打开。

在 Docker 容器中使用外部 USB 转串口设备

Windows中下载并安装usbipd-win工具

dmesg可以看到wsl2中已经识别到了一个ttyACM0，这时我们在回到VsCode。

在下面一行配置中，串口配置端口就选择ttyACM0，设备目标自行根据开发板选择，然后就可以点击Build Project，看我这里编译成功了！
接下载再试试烧录。

我选择的用UART烧录，看打印信息是烧录成功了，具体我们点击Monitor Devict试下。

优雅！
参考资料

• 使用Docker容器的ESP32开发环境搭建
  
• Docker官方文档
  
• 如何在 Windows 上安装 WSL2
  
• 如何将USB 设备连接到 WSL 2 上运行的 Linux 分发版
  

来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！