mcauser/awesome-micropython

A curated list of awesome MicroPython libraries, frameworks, software and resources.

awesome-micropython's Issues

Add social sharing / OpenGraph tags

Enhancement: could add og: and twitter:card meta tags to make Awesome MicroPython more awesome when the link is shared online.

(mostly logging this as a todo for myself to contribute / @mcauser consider me assigned!)

Add MAX30102 driver

This is a driver for the MAX30102. https://github.com/QuirkyCort/IoTy/blob/main/public/extensions/max30102.py

Compared to the current driver listed on awesome-micropython, this one adds a built in heartbeat detection and bpm measurement.

This driver was written for the IoTy project (...a web-based blocks to Python system, similar to BIPES), so it doesn't have it's own repository.

mpsync - A tool that detects changes in files and synchronizes them to a micropython board

Hi,

I'm new to micropython and for my workflow I created a tool that detects changes to files in a specified folder and synchronizes them to a micropython board. That way, whenever you save your project, your board directly executes what you've just written.

The project is called mpsync, is licensed under the MIT license and can be downloaded via pip (pip install mpsync). It is in very early development and has definitely some missing features.

Maybe this tool is also helpful for other developers, so it would be great if it can be added to this list. I'm not sure under wich topic it would fit. It runs on the host, but is not really a shell.

Best,
Uhlo

Machine Vision

A simple machine vision library that provides blob and circle detection. https://github.com/QuirkyCort/IoTy/blob/main/public/extensions/mv.py

It can be used with raw GRAYSCALE or YUV422 data, and has been tested with the camera driver by @lemariva (https://github.com/lemariva/micropython-camera-driver).

This driver was written for the IoTy project (...a web-based blocks to Python system, similar to BIPES), so it doesn't have it's own repository.

[MicroPython-NeuralNetwork] - (https://gitlab.com/olivierlenoir/MicroPython-NeuralNetwork) - Neural Network for MicroPython

In category AI.

[MicroPython-NeuralNetwork] - (https://gitlab.com/olivierlenoir/MicroPython-NeuralNetwork) - Neural Network for MicroPython

README
Neural Network using an ESP32 with MicroPython

This repository require using Matrix:
https://gitlab.com/olivierlenoir/MicroPython-Matrix

PROCESS
1 - Train neural network with python
cd micropython
python3 test_neuralnetwork

2 - Use neuralnetwork with micropython
import utest_neuralnetwork

DOCUMENTATION
https://olivierlenoir.gitlab.io/MicroPython-NeuralNetwork/MicroPythonNeuralNetwork.pdf

Discord link in the community section has expired.

Discord link in the community section has expired.
https://discord.gg/5GjKNE

Add APDS9960 driver

This is a driver for the APDS9960. https://github.com/QuirkyCort/IoTy/blob/main/public/extensions/apds9960.py

Compared to the current driver listed on awesome-micropython, this one adds simple gesture detection (up, down, left, and right).

This driver was written for the IoTy project (...a web-based blocks to Python system, similar to BIPES), so it doesn't have it's own repository.

dead links in the micropyton display driver list

Hey, i am setting up a reference chart for micropython display drivers and unfortunately i came across some dead links on your website/github. Do you happen to have new sources for the drivers?

Controller	Type	Typical display	conn.	Typ.res.	Driver Library	Remark
Dead link	SSD1606	E-Paper	active matrix epaper		128x180	micropython-ili9341
Dead link	ILI9341	LCD TFT	Medium lcd rgb 2.7”-3.2”			micropython-ili9341
Dead link	SH1106	LCD TFT				micropython-ili9341
Dead link	SSD1606	LCD TFT				micropython-ili9341
Dead link	ST7735	LCD TFT				micropython-ili9341
Dead link	PCD8544	OLED				micropython-oled
Dead link	SH1106	OLED				micropython-oled
Dead link	SSD1306	OLED				micropython-oled
Dead link	UC1701X	OLED				micropython-oled

sht11 module for micropython

I propose module to read sht11 sensor for esp32 (maybe esp8266 too)
modified from https://github.com/ayoy/upython-aq-monitor which only pyboard supported

link of sht11 module: https://github.com/2black0/micropython-sht11

it will be great if listed :)
thanks

Add amazon.com to BOT_ALLOW_LIST for awesome_bot workflow

Per this run, it looks like amazon.com is potentially (?) sending HTTP 403 for valid links, from runs of the workflow that checks links. May be worth adding to the environment variable for the workflow to skip.

there is no micro:bit section

the microbit rus so slowly that one wire protocol solution have to be written in arm thumb assembly language and won't easily port to other micropython boards even if there were the need for an assembly solution to getting a sensor to work.
With version 1 microbits there were issues with the size of program source, this is still the case with version 2, less than 20kb so the microbit version of a sensor is often rendered unreadable by minifying all function and variable names.

do you want to start a microbit section on your awesome list, this is a list i host?
https://github.com/rhubarbdog/microbit-component

A MicroPython module for asyncio button.

Hi @mcauser ,
Here's a MicroPython module for asyncio button written by me.
I think it could be useful for projects using asyncio.
https://github.com/jacklinquan/micropython-aiobutton

Suggestion: Add umidiparser - a parser for MIDI files

umidiparser a complete parser for MIDI files

Section: Audio

Add Husky Lens drivers

This is a driver for the DFRobot Husky Lens. https://github.com/QuirkyCort/IoTy/blob/main/public/extensions/huskylib.py

The Husky Lens (https://www.dfrobot.com/product-1922.html) is a camera module that can do some onboard machine vision tasks and returns the results in either UART or I2C mode.

The driver is based on the official Python API (https://github.com/HuskyLens/HUSKYLENSPython), but heavily modified to work with micropython and fix a few bugs.

This driver was written for the IoTy project (...a web-based blocks to Python system, similar to BIPES), so it doesn't have it's own repository.

Add additional i2c LCD driver

Mentioned as great in the recent MicroPython meetup.
https://github.com/Thomascountz/micropython_i2c_lcd

IO-Expander menu has ADC/DAC URL

On the IO-Expander menu has the:

micropython-pcf8591 - MicroPython driver for PCF8591 8-Bit I2C I/O Expander.

But the that url is about ADC/DAC, not about IO Expander.

Add VL53L1X driver

This is a driver for the VL53L1X. https://github.com/QuirkyCort/IoTy/blob/main/public/extensions/vl53l1x.py

Compared to the current driver listed on awesome-micropython, this one provides the ability to set distance mode and timing budget. This should allow better results in some cases, but I haven't played around with it enough to see a difference.

This driver was written for the IoTy project (...a web-based blocks to Python system, similar to BIPES), so it doesn't have it's own repository.

Add LD2410 Human Presence Sensor

This is a driver for the LD2410. https://github.com/QuirkyCort/IoTy/blob/main/public/extensions/ld2410.py

This is a 24GHz human presence sensing module, capable of detecting moving and stationary targets, and provide an approximate range.

This driver was written for the IoTy project (...a web-based blocks to Python system, similar to BIPES), so it doesn't have it's own repository.

Add micropython-gy33 driver

This is a pair of UART and I2C driver for the GY-33 color sensor.

https://github.com/QuirkyCort/micropython-gy33

The GY-33 uses a TCS3472, but does not expose it by default. Instead, it has an onboard micro-controller (STM32F030F4) that handles reading of the sensor and provides a UART and I2C interface. The I2C interface is not compatible with drivers written for the TCS3472, so a separate driver is required.

I couldn't find any detailed English documentation for the GY33, so I've also provided documentation for it in the repository based on the Chinese docs and my own tests.

ESP32 Micropython version

HI,
Very good web site for micropython examples but could you tell me what micropython firmware for ESP32 are you using ?

Sincerely
Eric

First item in **IO-Expander** section is not micropython, but C.

Hi, I noticed the following item is not a micropython driver:

MCP23017-ESP8266-Miniature-Driver - Driver for MCP23017 16-bit I/O Expander.

In my opinion it should be dropped from the list.
Hope it helps.

Proposing a new section "Frameworks"

Dear Mike,

thanks for your awesome collection of MicroPython resources - and also thanks to all of the contributors.

We would like to add the Terkin Datalogger to the collection. However, it is not quite a library but would probably qualify as a "full program".

While thinking about that, the naming would be a bit awkward, so we came up with "Frameworks" which we believe would fit better. We have a strong background using the Pyramid web framework which could be seen as a role model for Terkin somehow - naturally on a much smaller scale ;].

Thanks already for looking into this. We wanted to humbly ask about your opinion on that before actually starting a pull request.

With kind regards,
Andreas.

Add Max31865 RTD Temperature IC driver

This is a driver for the MAX31865 resistance-to-digital converter IC ported from Adafruit's CircuitPython implementation to micropython.

https://github.com/sufyanaslam198/max31865.git

L3GD20H + LSM303DLHC based IMU driver include in Zumu Robot driver set

Haven't tested it yet myself, but this is the only uPy driver I-ve been able to find that covers the L3GD20H + LSM303DLHC based IMU's such as Adafruit's DOF 10 (just add a BMP085/180 driver) or Pololu MinIMU-9 v2.

add greyscale epaper display driver

Covered in the news this week https://github.com/antirez/uc8151_micropython

LVGL?

Do you think LVGL Micropython binding could fit in your list?

https://docs.lvgl.io/latest/en/html/get-started/micropython.html

https://hackaday.com/2019/02/28/littlevgl-brings-gui-tools-to-micropython/

https://hackaday.com/2019/08/31/micropython-and-c-play-together-better/

Add YX5300 Serial MP3 Player

This is a driver for the YX5300. https://github.com/QuirkyCort/IoTy/blob/main/public/extensions/yx5300.py

This is an MP3 player that can be controlled via a serial interface.

This driver was written for the IoTy project (...a web-based blocks to Python system, similar to BIPES), so it doesn't have it's own repository.

Micropython

Add micropython-generic-thermistor

Would you be willing to add my library to the ADC temperature sensor section?
Thanks!

micropython-generic-thermistor - Micropython Generic Thermistor Library is a basic software module designed to simplify temperature sensing using NTC thermistors within MicroPython-based projects. The library assumes a generic NTC thermistor on the ground side of a voltage divider.

Suggestion: Set up a cron CI workflow to check links

Just a suggestion in case you are interested, on my Awesome list I run a workflow like this to check for dead links every morning:
https://github.com/carlosperate/awesome-microbit/blob/master/.github/workflows/check-links.yml

It uses a ruby-base awesome list tool instea of the more common awesome-lint, as I find some of the awesome-link rules a bit too strick and awesome_bot works well for my purposes.

The workflow file would likely Just Work™️ if it's copy/pasted, happy to submit a PR if it's something you'd like to integrate here as well.

Suggestion: SH1107 display driver with support for 128 x 128 pixel OLEDs

Besides support for 128 x 64 displays provided by the SH1107 driver already listed, this one also supports 128 x 128 displays. It works with I2C and SPI and provides for initialisation in different rotations, some optimisations for partial screen updates, and support for hardware features such as flipping the display upside down.

SH1107 - Micropython driver for SH1107-based OLED displays, both 128 x 128 and 128 x 64 pixels

Add TCA9548A drivers

This is a driver for the TCA9548A (I2C multiplexer). https://github.com/QuirkyCort/IoTy/blob/main/public/extensions/tca9548a.py

This is a really trivial driver, but I suppose it may be useful to some.

This driver was written for the IoTy project (...a web-based blocks to Python system, similar to BIPES), so it doesn't have it's own repository.

Add HX710 driver

This is a driver for the HX710. https://github.com/QuirkyCort/IoTy/blob/main/public/extensions/hx710.py

It is very similar to the current drivers for HX711 (...and is readable using the HX711 drivers), but the HX710 has different settings and either a built-in temperature sensor (HX710A) or a Analog/Digital Voltage difference detector (HX710B).

This driver was written for the IoTy project (...a web-based blocks to Python system, similar to BIPES), so it doesn't have it's own repository.

Micropython video+written tutorials

Two great sources of tutorials for Micropython:

1. Miguel Grinberg's 6-part Micropython course. He also created the awesome Microdot library, which allows you to use a Flask-like expressive web framework in Micropython.
   https://blog.miguelgrinberg.com/post/micropython-and-the-internet-of-things-part-i-welcome
   https://github.com/miguelgrinberg/microdot

2. Bi-weekly Micropython video+written tutorials (full disclosure: this is me...but the tutorials are free, so it's win-win :)
   https://bhave.sh

Modbus slave: TCP and RTU

Hi!

Thanks for the great page.

I'm researching so much on the internet, including forum, and so on to find a Modbus TCP Server (slave) and Modbus RTU slave. But I will be happy if just one that slave (TCP or RTU) can be found :)

Do you know some project with that?

I found only this: https://github.com/sfera-labs/exo-sense-py-modbus Unfortunately that was wrote for the PyCom modules where their MicroPython is a bit different than official MicroPython, and that last commit has 2 years.
If will be not possible to find a project, do you know (more or less) if is easy to port that to Official MicroPython?
Ps: actually I'm using uasyncio on applications. So I would like to use the ModBus integrated with uasyncio as well.

Thank you so much.

Add P10 32*16 LED panel display driver

I propose adding my project, LED Panel MicroPython Driver Module, to the Awesome MicroPython list.

This driver is designed for P10 32x16 single-color LED panel displays. I couldn't find an existing MicroPython driver for this module during my research, so I hope adding it to the Awesome MicroPython list would make it more accessible to others.

I2S Audio Driver

You may consider adding https://github.com/rdagger/micropython-sgtl5000

Add mpbridge CLI tool

I'm maintainer of mpbridge CLI tool which helps MicroPython developers to develop and debug faster and easier. This tool can be integrated into any IDE and help you sync / run / debug project faster. It depends on mpremote which is officially maintained by MicroPython organization.

404: SHT10_uPython

SHT10_uPython - Driver for SHT10 temperature and humidity sensor.
https://github.com/Omgitskillah/SHT10_uPython
No longer exists.

Suggestion: Add utility to freeze file system and allow to mount it

https://github.com/bixb922/freezeFS

freezeFS

freezes file structures on the PC with text and binary files into Python source for freezing as bytecode in flash. It allows to mount the frozen data as a read-only Virtual File System, or to extract the files to the flash file system.

Category : Flash

Broken link

Hi, I found a broken link:

• https://github.com/thebaron88/micropython_quickled (file: README.md, status code: 404)

MicroWebSrv2 library

Hello,
About your awesome MicroPython list, I see mainly drivers for sensors but I read "libraries, frameworks, software and resources" :)
I can purpose the new version of a micro HTTP Web Server with modules : MicroWebSrv2

GitHub repository at https://github.com/jczic/MicroWebSrv2 (see features)
Page at https://MicroWebSrv2.hc2.fr

Do you think this library would be worth adding?
Thank you. 👍

Using Awesome Micropython with Raspberry Pi Pico

Hello,

How can I install and use the libraries with the Pico board?

MicroPython-multiaxis, new path

Hello, I've changed my username on GitLab to comply with SSL requirements.
Project 'olivier.len02/micropython-multiaxis' was moved to 'olivierlenoir/micropython-multiaxis'. Please update any links and bookmarks that may still have the old path.
So correct link is now 'https://gitlab.com/olivierlenoir/micropython-multiaxis'.

Add Belay (Package Manager & computer-device communications)

I'd like to propose adding my project, Belay, to your list! I can open a PR, but I was unsure of what section to put it under. Belay is primarily 2 things:

Allows Easy Computer-Device Communications.

The following code, running on a computer (e.g. with CPython), will toggle an LED on a microcontroller board running micropython. Besides micropython, no prior pre-configuration is required.

import belay

device = belay.Device("/dev/ttyUSB0")


@device.task
def set_led(state):
    print(f"Printing from device; turning LED to {state}.")
    Pin(25, Pin.OUT).value(state)


set_led(True)

Package Manager

It's been a challenge to get repeatable deployments, and reliable dependency updates. I added a cli tool belay that is heavily inspired by Poetry.

Basically, micropython dependency URLs can be specified in pyproject.toml. Running belay update will fetch and cache those files into the .belay/ folder of your project (this should be committed to git and can be thought of like a lock file). The dependencies and project can then be installed to device via belay install [PORT]. Hashes of files are compared, so syncs are efficient when only a few changes are made. The CLI has a lot of other actions to aid in development and debugging, but this is the basic use-case.

Here's a very basic project that uses Belay for handling dependencies. Note that in this project, no explicit belay install needs to be performed since it's automatically handled within main.py. This also allows for pip-installable libraries/cli to bundle micropython code that can be automatically deployed to micropython microcontrollers.

Add mprsa

mprsa - A MicroPython module for creating, importing, and exporting RSA keys in DER and PEM formats with PKCS#1, PKCS#8, and X.509/SPKI structures, and signing/verifying and encryption/decryption using blinding and SHA-1 and SHA-256 hashing algorithms.

Add Garmin Lidar LIte v3hp library

I recently wrote a library for the Garmin Lidar Lite v3hp lidar sensor. If you think it's worth adding https://github.com/Dnapert/LidarLight_v3HP_micropython

Remove ad9850_signalgen

Per this run, it looks like this is now a 404 link.

[MicroPython-MiFlora](https://github.com/matthias-bs/MicroPython-MiFlora) - MicroPython library for Xiaomi Mi Flora (aka. flower care) BLE plant sensors.

This might be a useful addition to the "Sensors" section.

Add a driver for the CS1237 24 bit ADC and for the HX710 24 bit ADC.

Hi Mike.
The CS1237 plays in the field of the HX711, but is told to be less noisy. My test did not show a huge difference, but that may be a problem of the test set-up. It's more flexible than the HX711, with gains of 1,2,64 and 128, and sampling rates of 10, 40, 640 and 1280.

https://github.com/robert-hh/CS1237

I made a variant of my HX711 driver for the HX710: https://github.com/robert-hh/hx710
My HX711 driver is at: https://github.com/robert-hh/hx711

The difference to the HX711 driver you listed already is the synchronization of the data reading with the data ready pulse on the data line, which will be created even if the data reading is in progress. If you do not synchronize the reading with that pulse, it may cause severely wrong values being retrieved.

Best Regards, Robert