Creating the Course Directory and Downloading the Required Repositories
After installing the Linux prerequisites, the next step is to create the working directory for the course and download the repositories required for the S3 MINI PRO environment.
The main course directory is:
/opt/ucc/micros/esp32
1. Create the Course Directory
Run:
sudo mkdir -p /opt/ucc/micros/esp32
sudo chown -R $USER:$USER /opt/ucc/micros/esp32
cd /opt/ucc/micros/esp32
Check the current location:
pwd
Expected output:
/opt/ucc/micros/esp32
2. Required Repositories
WEMOS MicroPython
Repository:
https://github.com/wemos/micropython
Clone it using:
git clone https://github.com/wemos/micropython.git
WEMOS MicroPython-lib
Repository:
https://github.com/wemos/micropython-lib
Clone it using:
git clone https://github.com/wemos/micropython-lib.git
ESP-IDF v5.5.5
Repository:
https://github.com/espressif/esp-idf
Clone the exact version with its submodules:
git clone -b v5.5.5 --recursive https://github.com/espressif/esp-idf.git esp-idf-v5.5.5
ST7789 MicroPython Driver
Repository:
https://github.com/russhughes/st7789_mpy
Clone it using:
git clone https://github.com/russhughes/st7789_mpy.git
3. Create the ESP-IDF Link
Create a symbolic link called:
esp-idf
that points to:
esp-idf-v5.5.5
Run:
ln -s esp-idf-v5.5.5 esp-idf
The directory structure should then look like:
/opt/ucc/micros/esp32/
├── esp-idf -> esp-idf-v5.5.5
├── esp-idf-v5.5.5
├── micropython
├── micropython-lib
└── st7789_mpy
4. Verify the ESP-IDF Version
cd /opt/ucc/micros/esp32/esp-idf-v5.5.5
git describe --tags
The output should indicate version
v5.5.5 or a revision based on it.
5. Verify the Downloaded Repositories
cd /opt/ucc/micros/esp32
ls -l
You should see:
esp-idf
esp-idf-v5.5.5
micropython
micropython-lib
st7789_mpy
6. Optional: Using Another Windows Drive
If the main Windows drive does not have enough free space, the repositories can be stored on another Windows partition.
For example:
D:\UCC\micros\esp32
is accessible from WSL as:
/mnt/d/UCC/micros/esp32
A symbolic link can then be created:
sudo mkdir -p /opt/ucc/micros
sudo ln -s /mnt/d/UCC/micros/esp32 /opt/ucc/micros/esp32
7. Why These Repositories Are Needed
| Repository |
Purpose |
wemos/micropython |
MicroPython source and WEMOS board support |
wemos/micropython-lib |
Additional MicroPython libraries |
esp-idf-v5.5.5 |
ESP32 development framework used by MicroPython |
st7789_mpy |
Driver for the ST7789 display |