Repository files navigation

This is an operating system for microcontrollers like the ESP32.

It's written entirely in MicroPython, including device drivers, interrupt handlers, boot code, multitasking, display handling.

The architecure is inspired by the Android operating system for smartphones:

• 'thin' operating system with facilities for apps
• 'everything is an app' idea
• making it as simple as possible for developers to build new apps

Seehttps://install.MicroPythonOS.com

The operating system comes with a few apps built-in that are necessary to bootstrap:

• launcher: to be able to start apps
• wificonf: to be able to connect to the wifi
• appstore: to be able to download and install new apps
• osupdate: to download and install operating system updates

Other apps are available in the AppStore.

Seehttps://apps.MicroPythonOS.com/

• https://www.waveshare.com/wiki/ESP32-S3-Touch-LCD-2

• Linux desktop (uses SDL)
• MacOS should work. Untested.

• Should work, especially if it's running a Linux desktop like Raspbian. Untested.

• boot.py: initializes the hardware on ESP32 / boot_unix.py: initializes the hardware on linux desktop
• main.py: initializes the User Interface, contains helper functions for apps, and starts the launcher app

• /apps: new apps are downloaded and installed here
• /apps/com.example.app1: example app1 installation directory
• /apps/com.example.app1/MANIFEST.MF: info about app1 such as Name, Start-Script
• /apps/com.example.app1/mipmap-mdpi: medium dpi images for app1
• /apps/com.example.app1/mipmap-mdpi/icon_64x64.bin: icon for app1 (64x64 pixels)
• /builtin/: read-only filesystem that's compiled in and mounted at boot by main.py
• /builtin/apps: apps that are builtin and necessary for minimal facilities (launcher, wificonf, appstore etc)
• /builtin/res/mipmap-mdpi/default_icon_64x64.bin: default icon for apps that don't have one
• /data/: place where apps store their data
• /data/images/: place where apps (like the camera) store their images
• /data/com.example.app1/: storage (usually config.json) specific to com.example.app1

Prepare all the sources:

mkdir ~/MicroPythonOScd ~/MicroPythonOSgit clone https://github.com/MicroPythonOS/MicroPythonOS.gitgit clone https://github.com/MicroPythonOS/freezeFSgit clone https://github.com/cnadler86/micropython-camera-APIecho 'include("~/MicroPythonOS/lvgl_micropython/build/manifest.py")' >> micropython-camera-API/src/manifest.pygit clone https://github.com/MicroPythonOS/lvgl_micropythongit clone https://github.com/MicroPythonOS/secp256k1-embedded-ecdh

Start the build for ESP32:

cd ~/projects/MicroPythonOS/MicroPythonOS

./scripts/build_lvgl_micropython.sh esp32 prod

Or if you want to build for development, so without any preinstalled files, do:

./scripts/build_lvgl_micropython.sh esp32 dev

Now make sure your ESP32 is in bootloader mode (long-press the BOOT button if you're already running MicroPythonOS) and install it with:

./scripts/flash_over_usb.sh

If you made a 'devbuild', then you probably want to install all files and apps manually:

./scripts/install.sh

• Make sure CURRENT_OS_VERSION in main.py is incremented
• Make sure version numbers of apps that have been changed are incremented:

git diff --stat 0.0.4 # see everything that changed since tag 0.0.4git diff 0.0.4 -- internal_filesystem/apps/*/META-INF/* # list manifests that might have already had their version number incrementedgit diff 0.0.4 -- internal_filesystem/builtin/apps/*/META-INF/* # list manifests that might have already had their version number incremented

• Update CHANGELOG
• commit all code
• tag -a the main repo and external repo's like LightningPiggy
• git push --tags
• ./scripts/bundle_apps.sh
• ./scripts/build_lvgl_micropython.sh esp32 prod
• ./scripts/release_to_updates.sh
• ./scripts/release_to_install.sh

Building to run as an app on the Linux desktop or MacOS (untested) is supported.

To do so, make sure you have the necessary dependencies:

• seehttps://github.com/MicroPythonOS/lvgl-micropython/
• sudo apt install libv4l-dev # for webcam.c

cd ~/projects/MicroPythonOS/MicroPythonOS/

./scripts/build_lvgl_micropython.sh unix dev

or

./scripts/build_lvgl_micropython.sh macOS dev

Then to run it, do:

./scripts/run_desktop.sh