在Espressif-IDE中使用Wokwi仿真ESP32

陈拓 2023/10/17-2023/10/19

1. 概述

在Espressif-IDE v2.9.0版本之后可直接在IDE中使用Wokwi模拟器。 

1.1 什么是 Wokwi 模拟器？

Wokwi 是一款在线电子模拟器，支持模拟各种开发板、元器件和传感器，例如乐鑫产品 ESP32。 Wokwi 提供基于浏览器的界面，您可以通过这种简单直观的方式，即可快速编写一个 IoT 项目。 

网址https://wokwi.com/

1.2 Wokwi和Espressif-IDE是如何集成并工作的？

如果选择使用乐鑫开发板基于ESP-IDF构建IoT应用，Espressif-IDE可以为您提供开发环境。您可以在IDE中构建、烧录、监控或调试IoT应用；但若想查看串口输出还需要通过ESP32开发板，此时使用Wokwi模拟器更加快速便捷，可免去使用开发板。

Espressif-IDE提供Wokwi集成插件，允许IDE通过websocket与Wokwi服务器进行通信，以此来实现烧录IDE中构建的.bin 文件。根据IDE提供的目标芯片和项目ID，Wokwi服务器在系统浏览器中为指定目标启动模拟器。因此在与模拟器通信的同时，您也可在IDE控制台查看串口监视器输出。

2. 在Espressif-IDE中使用Wokwi模拟器

2.1 安装Espressif-IDE

见《ESP32集成开发环境Espressif-IDE安装 – Windows》

https://blog.youkuaiyun.com/chentuo2000/article/details/133931499?spm=1001.2014.3001.5501

2.2 安装 Wokwi 服务器

https://github.com/MabezDev/wokwi-server/

• 下载wokwi-server

从发布页面下载为您的平台预先构建的可执行文件。

https://github.com/MabezDev/wokwi-server/releases

提示：

如果访问github超时或者下载速度慢，可以试试用Watt Toolkit加速，网址：

https://steampp.net/

Watt Tookit可以从Microsoft Store直接安装：

• 解压wokwi-server

这就算安装好了。

2.3 设置环境变量

在Eclipse CDT中构建环境变量。

• Peferences > C/C++ > Build > Environment

• Add…

添加WOKWI_SERVER_PATH为Wokwi服务器wokwi-server.exe的可执行路径

F:\esp\wokwi-server.exe

OK

Apply

Apply and Close

2.4 使用Wokwi模拟器配置一个新的运行启动配置(Launch Configuration)。

• New Launch Configguration…

• Next

• 选择项目

• OK

• 在https://wokwi.com/esp32中选择一个Wokwi项目并添加项目的项目ID

Wokwi项目的ID可以在URL中找到。

在https://wokwi.com/esp32中找一个可用的项目，对于我们这个例子任何一个项目都可以，因为我们不用任何外部元件，我们就用下面这个没有外都元件的项目：

点开该项目：

从URL中我们可以知道，项目的ID为305569599398609473

• 最终如下创建Launch Configuration

点击Apply，再点击Finish

2.5 启动Wokwi模拟器

• 从IDE工具栏中，单击“启动”按钮以启动Wokwi模拟器

• 点击Proceed

在默认浏览器中（我的默认浏览器是Microsoft Edge）将会看到运行中的Wokwi模拟器：

有关Wokwi模拟器的中文说明见：

https://docs.wokwi.com/zh-CN/

参考文档

1. 如何在Espressif-IDE中使用Wokwi模拟器
   https://blog.youkuaiyun.com/espressif/article/details/130563663?spm=1002101.3001.6650.4