Tab5 ESP-IDF 出厂固件编译

本教程将介绍如何编译 Tab5 的默认出厂固件程序，用户可基于该固件进行二次开发。

1.准备工作

1. 环境配置： 本教程基于Ubuntu操作系统搭建ESP-IDF开发环境，其他平台的编译环境搭建方式，具体请参考ESP-IDF - ESP32-P4上手教程。

2. 使用git版本管理工具拉取esp-idf项目，切换至指定分支并执行脚本安装相关工具链。

git clone --recursive https://github.com/espressif/esp-idf.git
cd esp-idf
git checkout v5.4.1 # recommend
./install.sh
. ./export.sh

3. 后续教程使用到的idf.py指令均依赖ESP-IDF, 运行指令前需要在项目工程路径下调用ESP-IDF中. ./export.sh用于激活相关的环境变量。详细说明请参考ESP-IDF - ESP32-P4上手教程。

2.User Demo

1. 拉取Tab5出厂固件项目源码，放置到与esp-idf项目同级目录下。

git clone https://github.com/m5stack/M5Tab5-UserDemo.git

2. 进入M5Tab5-UserDemo项目文件夹，并通过python脚本拉取依赖库组件。执行该命令前请确保PC端已安装python开发环境。

cd M5Tab5-UserDemo
python ./fetch_repos.py

3. 在项目路径M5Tab5-UserDemo->platforms->tab5中，调用esp-idf项目中export.sh用于激活相关的环境变量。以下指令适用于M5Tab5-UserDemo项目文件夹与esp-idf处于同级目录，其他路径则需根据实际情况修改指令。

cd platforms/tab5
. ../../../esp-idf/export.sh

3.程序编译与烧录

Tab5 通过数据线连接至电脑，长按复位按键直至绿色指示灯开始快速闪烁，松开按键后，设备即进入下载模式，等待固件烧录。此时执行以下指令进行程序编译与烧录。

idf.py flash

4.开始使用

完成烧录后，可点击屏幕各个区域，进行功能单元测试。