Installation

Installation

First we need to install some programs with pip:

pip3 install esptool
pip3 install mpremote

Then download the microOS and firmware repository:

git clone https://github.com/asherevan/microOS.git
git clone https://github.com/russhughes/st7789_mpy

Now we need to flash the firmware to the device.
Plug in your esp32 with a usb cable, then issue these commands on your computer:

cd st7789_mpy/firmware/GENERIC_7789
esptool erase_flash
esptool write_flash 0x1000 firmware.bin

When all of that has finished, run:

cd ~/microOS
nano ./installer.py

Then, in the file, change YOUR NETWORK NAME and YOUR NETWORK PASSWORD to the name and password of your network respectively.

Save with ctrl-x, Y, then enter.

If you don't use nano, then you can change nano to the name of the editor you use.

Now run mpremote connect NAME_OF_COM_PORT run ./installer.py (replacing NAME_OF_COM_PORT with the port your device is connected to) and all of the necessary files and libraries will be downloaded and microOS is now installed!