stansmicropy 0.1.0

Libraries and projects for MicroPython compatible boards

Baremetal MicroPython libraries with built-in cooperative multitasking for the Raspberry Pi Pico and Espressif boards.

---

Overview

The purpose of this project is to develop a set of libraries that allow easy programming and prototyping of essential sensor and robotics functions, similar to the form of the Arduino IDE. The implementations here are independent of any IDE or existing framework — written in 'baremetal' form using only the machine modules provided by MicroPython.

N.B: Initial development was for Raspberry Pi Pico boards, but the libraries in this repository work seamlessly with ESP32 boards. In projects or documentation where references are made to Pico boards rather than MCU, treat this as a legacy reference — the libraries work equivalently for both boards. If you wish to see such documentation updated, kindly open a pull request.

🔧 Supported Components

Component	Library	Key Features
LED	led.py	On/Off, non-blocking blink, PWM fade & brightness
Servo	servo.py	Angle positioning, sweep, oscillate, calibration
Ultrasonic	ultraSonic.py	HC-SR04 distance measurement
Button	button.py	Debounced input with short/long press
RGB LED	rgbLed.py	PWM/digital, named colours, hex, fades
LCD	liquidCrystal.py	I2C HD44780 via PCF8574 driver
OLED	oled.py	SSD1306 & SH1106 (I2C/SPI)
Wi-Fi	wifiManager.py	Station mode connect + TCP server
Scheduler	scheduler.py	Cooperative task scheduler with profiling

---

Multitasking Without an RTOS

In building this library, I had to tackle multitasking in a way that didn't require me to build a full RTOS. If this project has any use or advantage over similar libraries, then it's that.

The libraries for LEDs, servos, and the ultrasonic sensor are embedded with an update() function which performs cooperative scheduling while hiding the complexity. This allows a programmer to multitask multiple processes on a single core:

"""Simultaneously blink LEDs and oscillate a servo motor."""

from stansmicropy.led import LED
from stansmicropy.servo import Servo

blinkLed = LED(16)
pwmLed = LED(17)
servo = Servo(15)

servo.oscillate(min_angle=30, max_angle=150, step=3, delay=0.03)
blinkLed.blink(delay=0.3)
pwmLed.fade(minP=5, maxP=80, step=5, delay=0.05)

while True:
    servo.update()
    blinkLed.update()
    pwmLed.update()

For more complex scenarios, the Scheduler class manages multiple task modules with priority sorting, runtime add/remove, and optional profiling:

• schedulerDemo.py — Running multiple task files as simultaneous processes on the MCU
• buttonTogglePrograms.py — Using a physical button to switch between active programs at runtime, with OLED menu UI and mode persistence

For someone seeking to replicate modern PC OS capabilities on a cheap MCU, those demonstrations serve as a solid backbone.

---

Computer Vision

Architecture: Heavy processing (OpenCV, MediaPipe) runs on the PC → commands are sent to the MCU over Wi-Fi TCP.

The repository includes gesture control projects split into:

Side	Location	Role
Client (PC)	projects/Computer_Vision/client_side/	Webcam capture, hand tracking, sends commands
Server (MCU)	projects/Computer_Vision/server_side/	Receives commands, drives hardware

The desktop-side compVision.py library wraps MediaPipe's Hand Landmarker for simplified hand detection. When transferring stansmicropy to the MCU, copy it without the desktop module:

mpremote cp -r src/stansmicropy :

---

Getting Started

Prerequisites Flash the appropriate firmware from onto your Pico Install Python 3.12+ (ensure Add to PATH is checked) Install mpremote: pip install mpremote Install the MicroPico VSCode extension, but disable auto-connect — the serial port can only be accessed by one of mpremote or MicroPico at a time. The MicroPico extension helps resolve Pylance issues as micriopython only libraries like machine aren't available on desktop Python. Settings > MicroPico > Auto Connect → OFF

Quick Start Read the Coding Guide Browse the library docs for method references Start with the LED examples and progress from there For CV Projects pip install -r requirements.txt

---

Project Structure

StansMicroPy/
├── src/
│   ├── stansmicropy/             # ← Core MicroPython libraries
│   │   ├── led.py, servo.py, button.py, ultraSonic.py
│   │   ├── rgbLed.py, liquidCrystal.py, lcd.py, oled.py
│   │   ├── wifiManager.py, scheduler.py
│   │   └── __init__.py
│   └── desktop/                  # ← Desktop-side libraries (PC only)
│       └── compVision.py             # MediaPipe hand tracking wrapper
│
├── projects/                     # ← Example projects by component
│   ├── LED/, Servo/, Button/, LCD/, OLED/, RGBLED/, Ultrasonic/
│   ├── multi_component_projects/     # Sound sensor, multi-actuator demos
│   ├── Computer_Vision/
│   │   ├── client_side/              # PC scripts (sends commands)
│   │   └── server_side/              # MCU scripts (receives commands)
│   ├── wifi/                         # Wi-Fi connection examples
│   ├── task/                         # Task modules for the scheduler
│   ├── schedulerDemo.py
│   └── buttonTogglePrograms.py
│
├── Docs/                         # ← Guides & library documentation
│   ├── Coding_Guide.md
│   ├── LED.md, Servo.md, Button.md, Ultrasonic.md
│   ├── LCD.md, RGB.md
│   └── AI_Kit_recommendations.md
│
├── pyproject.toml
├── requirements.txt
└── LICENSE

---

Conventions

• Libraries and methods use camelCase naming
• Each library module has corresponding documentation in Docs/
• Project files include docstrings and inline comments where intuition might fail

---

Citations

This project is indebted to the open source community, particularly the contributions of:

whose code provided the foundations for the OLED library in this repository.

and

whose code is the backbone of the LCD Library

---

Somtochukwu Stanislus Emeka-Onwuneme · MIT License

Connect with me