M5Stick-Launcher 安装与配置指南

M5Stick-Launcher 安装与配置指南

M5Stick-Launcher App launcher for M5StickC, M5StickC Plus, M5StickC Plus 2 and M5Cardputer 项目地址: https://gitcode.com/gh_mirrors/m5/M5Stick-Launcher

一、项目基础介绍

M5Stick-Launcher 是一个为 M5Stack、Lilygo、CYDs、Marauder 和 ESP32 设备设计的应用启动器。它允许用户通过 OTA（Over-The-Air）更新、SD 卡、WebUI 等方式安装和运行二进制文件。项目主要使用 C 和 C++ 编程语言，结合 Python 脚本进行编译和部署。

二、项目使用的关键技术和框架

• MicroPython：一种实现 Python 3 的精简版，适用于微控制器。
• ESP-IDF：Espressif IoT Development Framework，用于开发 ESP32 系列设备的官方开发框架。
• Arduino：用于 ESP32 开发的集成开发环境（IDE）。
• PlatformIO：一个跨平台、多框架的代码构建和上传工具。
• TFT_eSPI：用于驱动 TFT LCD 屏幕的 Arduino 库。
• LovyanGFX：一个用于嵌入式设备的图形库。

三、项目安装和配置准备工作

在开始安装之前，请确保您已经完成了以下准备工作：

1. 安装 Arduino IDE：确保安装了最新版本的 Arduino IDE，并添加了 ESP32 开发板支持。
2. 安装 PlatformIO：在 Arduino IDE 中安装 PlatformIO 插件。
3. 下载项目代码：使用 Git 克隆项目到本地计算机。

   git clone https://github.com/bmorcelli/M5Stick-Launcher.git
   

4. 准备 SD 卡：确保您有一个格式化为 FAT32 的 SD 卡，并备份其内容。

四、详细安装步骤

步骤 1：配置 Arduino IDE

1. 打开 Arduino IDE。
2. 转到“文件”>“首选项”（Windows）或“Arduino”>“首选项”（Mac）。
3. 在“附加开发板管理器网址”中添加 ESP32 的 URL：

   https://dl.espressif.com/dl/package_esp32com_index.json
   

4. 打开“工具”>“开发板”>“开发板管理器”。
5. 搜索并安装“ESP32”开发板。

步骤 2：编译项目

1. 在 Arduino IDE 中，打开项目文件夹中的 M5Stick-Launcher.ino 文件。
2. 选择正确的开发板（例如，ESP32 Dev Module）和端口。
3. 点击“验证”按钮编译代码。

步骤 3：上传固件到设备

1. 将 M5Stick 设备通过 USB 连接到计算机。
2. 确保设备处于引导模式（通常需要按住 Boot 按钮的同时重置设备）。
3. 在 Arduino IDE 中点击“上传”按钮将固件上传到设备。

步骤 4：配置 WebUI

1. 在项目目录中找到 webUi 文件夹。
2. 使用文本编辑器打开 config.json 文件。
3. 根根据需要修改配置，如网络设置、OTA 更新设置等。
4. 保存并关闭文件。

步骤 5：使用 SD 卡更新

1. 将编译好的固件文件（通常为 .bin 文件）复制到 SD 卡的根目录。
2. 将 SD 卡插入 M5Stick 设备。
3. 重启设备，固件将自动更新。

完成以上步骤后，您的 M5Stick-Launcher 应该已经成功安装并可以使用了。您可以开始通过 WebUI 或 SD 卡安装和管理各种应用。

M5Stick-Launcher App launcher for M5StickC, M5StickC Plus, M5StickC Plus 2 and M5Cardputer 项目地址: https://gitcode.com/gh_mirrors/m5/M5Stick-Launcher