欢迎来到 ESP32C3TFT 开发板图片上传与固件管理指南！本指南将引导您完成安装图片与解决常见问题的全部流程。

1. 安装 Thonny IDE

Thonny 是一个简单易用的 Python 集成开发环境（IDE），它提供了良好的 MicroPython 支持。在本教程中，我们将使用 Thonny 来连接和管理 ESP32C3TFT 开发板。

1. 请访问 Thonny 官方网站：thonny.org 镜像地址
2. 下载适合您操作系统的版本（Windows、macOS 或 Linux）。
3. 按照提示安装 Thonny（通常只需点击“下一步”即可完成安装）。

2. 转换图片为 240x240 格式

由于本设备的显示屏分辨率为 240x240，为了确保较好的显示效果并节省存储空间，我们需要将图片转换为 240x240 的格式。

1. 准备您想要显示的图片。
2. 使用图像编辑软件（例如 Windows 系统自带的“照片”应用）打开该图片。
3. 将图片的大小调整为 240x240 像素。
4. 将调整好的图片保存为 PNG 格式。
5. 将图片文件重命名为您喜欢的名称。

3. 复制图片到开发板

1. 在 Thonny 中点击工具栏的“视图”选项，打开“文件”和“终端”面板。
2. 确保您的开发板已经连接至电脑。此时，在文件视图中您应该能够同时看到电脑和设备上的文件；在终端中也没有出现错误信息。
3. 在终端中键入 Control + C，直到显示以下内容： python MicroPython (固件版本) on (固件编译日期); ESP32C3 module with ESP32C3 Type "help()" for more information. >>> 如果连接出现异常，请点击页面上方的“Stop/Restart”按钮，然后重新连接设备。
4. 在电脑的文件系统中，导航至您转换好的图片所在的文件夹。
5. 在设备文件系统中，双击打开 imgs 文件夹。
6. 在电脑文件系统中，选中转换好的图片，右键点击并选择“上传到 imgs”。

常见问题

无法连接开发板

如果您将 ESP32C3TFT 开发板连接到电脑后，Thonny 无法检测到设备，请按照以下步骤检查连接是否正常：

1. 打开设备管理器（Windows）、系统报告（macOS）或使用 lsusb 命令（Linux）。
2. 查看是否有新的串口设备出现。如果没有，请尝试更换 USB 端口或 USB 线缆（确保您的 USB 线缆至少是 USB 2.0 的数据线）。
3. 如果有串口设备出现，但 Thonny 仍然无法连接，请尝试重新烧写固件。

如何烧写固件

这一步通常在设备出厂前已经完成。如果您的设备无法正常连接或需要更新固件，请按照以下步骤操作：

1. 确保开发板已经正确连接，并尝试在按下 BOOT 按钮的同时为设备上电。
2. 打开 Thonny IDE。
3. 在“解释器”选项卡中，点击“配置解释器”。
4. 点击“安装或更新 MicroPython（esptool）”。
5. 点击界面右下角的按钮 ☰。
6. 选择相应的串口设备作为目标设备。
7. 点击“选择本地 Micropython 镜像”（Select local Micropython image...）。
8. 选择包含 ST7789 驱动的适合的 MicroPython 固件文件（可以从这个仓库下载最新版或使用镜像地址，密码为 ESP32C3TFT）。

如何更新程序

如果您需要更新设备上的程序，请按照以下步骤操作：

1. 在这里下载所需的 dist.zip 文件。
2. 解压 dist.zip 文件。
3. 在 Thonny 中点击工具栏的“视图”选项，打开“文件”和“终端”面板。
4. 确保您的开发板已经连接至电脑。此时，在文件视图中您应该能够同时看到电脑和设备上的文件；在终端中也没有出现错误信息。
5. 在终端中键入 Control + C，直到显示以下内容： python MicroPython (固件版本) on (固件编译日期); ESP32C3 module with ESP32C3 Type "help()" for more information. >>> 如果连接出现异常，请点击页面上方的“Stop/Restart”按钮，然后重新连接设备。
6. 在电脑文件中，导航到解压后的 dist.zip 文件夹
7. 在设备文件中，右键删除所有文件（imgs中的文件可保留）
8. 在电脑文件中，选中 dist.zip 文件夹中的所有文件，右键点击并选择 “上传到 /”

希望本指南对您有所帮助！祝您开发愉快！