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

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

Topic revision: r3 - 18 Nov 2026, AdminUser