Skip to content

ML01 is a DIY LED board built around the Raspberry Pi Pico 2W, focused on learning, soldering, and scalable MicroPython firmware with integrated web control.

License

Notifications You must be signed in to change notification settings

RELEASE255/ML01_project

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

305 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

ML01 project by RELEASE255

DIY LED Board Powered by Raspberry Pico 2W

Hardware Firmware Docs&3d Costs PCB


ML01 Main image


πŸ’‘ Overview

ML01 is a fully DIY through-hole LED board driven by a Raspberry Pi Pico 2W and two TPIC6B595 shift registers. Built for makers, learners, and electronic enthusiasts, this product combining:

  • Electronics learning
  • Soldering practice
  • Microcontroller programming
  • Wireless control via Microdot
  • Possibility to customize the firmware and hardware
  • Open hardware philosophy with protected PCB design

πŸ“‹ Key Features

  • LED Circle | 16 yellow LEDs driven by 2Γ— TPIC power shift registers
  • Physical Controls | 2 buttons to switch operating modes
  • Wireless Web Interface | Autonomous Microdot server for full remote control
  • Mode 1 (FULL) | Turn all LEDs on
  • Mode 2 (CHASE) | Minute indicator synchronized via an NTP server
  • 100% DIY THT | Perfect for beginners and maker who wish to assemble or repair their product
  • Upgradable Firmware | New modes and features can be added anytime
  • Easy Powered | Works with the included 12.5 W PSU or via USB
  • Budget Friendly | Transparent and moderate costs coupled with low consumption (~1 Wh)

πŸ“¦ Contents of the Kit

Available on Tindie (coming soon):

  • 01x PCB

To be purchased separately:

  • 01x Raspberry Pi Pico 2W (THT version)
  • 01x Raspberry power supply 12.5 W (5.1 V / 2.5 A)
  • 02x TPIC6B595 (Power Shift Register)
  • 16x Yellow LED (2500 mcd 60 deg)
  • 16x Metal resistors 160Ξ©
  • 07x Ceramic capacitor (X7R 100 nF)
  • 01x Electro radial capacitor (100Β΅F)
  • 01x Resettable fuse
  • 02x Push buttons

To be printed according to the provided 3D model:

  • 01x PCB stand


Complete DIY kit packaging


πŸ“Έ Gallery


Bare PCB front view


DIY soldering THT components


Choice of orientation on the stand


PCB stand with cable holding


CHASE mode activated


FULL mode activated


Web interface for remote control


Web interface for log monitoring

ML01 CHASE mode animation
CHASE mode animated


πŸ“š Documentation

Specifications

See the document Specifications

Quick Start

  1. Solder all components following the guide (⏱️ ~ 5 hours)
  2. Finishing the PCB assembly with the cleaning
  3. Flash the firmware to your Pico 2W
  4. Configure the main.py file as you wish
  5. Transfer the 3 files (main.py, index.html, microdot.py) to your pico
  6. Plug the device to start the programm, it connects to your WiFi network
  7. Control via web interface or the buttons

Assembly

Follow the complet guide to Assembly

Configuration

Follow the complet guide to edit Settings

Control & consult logs

Using the 2 physical buttons or the web interface, see the document Usage


⚠️ Disclaimer

  • This is a DIY kit requiring soldering
  • Assembly mistakes may damage components
  • No warranty is provided
  • Use at your own risk
  • This device is intended for personal, non-commercial use only

It has not been tested or certified to meet:

  • CE electromagnetic compatibility standards
  • FCC Part 15 regulations
  • RoHS compliance (components should be RoHS-compliant when sourced)

🌐 Ecosystem


πŸ“œ License Overview

ML01 uses a multi-license & balanced open source model.
The main license is MIT but other parts of the project use Creative Commons licenses.
Below is the complete list of licenses used in the repository.
If you have any question about licensing or permitted uses, contact the project maintainer.

Category License File Types Commercial use Full text
Firmware MIT .py .html βœ… Allowed LICENSE
BOM CC BY-SA 4.0 .pdf βœ… Allowed LICENSE
Documentation CC BY-NC-SA 4.0 .pdf .md 🚫 Not allowed LICENSE
Technical plans CC BY-NC-SA 4.0 .pdf 🚫 Not allowed LICENSE
Schematics CC BY-NC-SA 4.0 .pdf 🚫 Not allowed LICENSE
3D Models CC BY-NC-SA 4.0 .stl .stp 🚫 Not allowed LICENSE
Images CC BY-NC-SA 4.0 .png .jpg 🚫 Not allowed LICENSE
PCB Sources Proprietary Kicad & Gerbers ❌ Not available N/A

πŸ”’ PCB sources remain proprietary

In order to preserve the value of the design, guarantee independence, sustainability and the protection of creators, the following elements are not available:

  • KiCad source files
  • PCB routing & layout
  • Gerber files
  • 3D model of the actual PCB

Third-Party Dependencies and Licenses

The ML01 firmware uses two essential external components:

MicroPython

ML01 runs on MicroPython, a Python interpreter optimized for microcontrollers.

  • License MIT
  • Author: Damien P. George and contributors
  • Official website: https://micropython.org
  • Full text license: here
    ℹ️ The firmware provided in this repository may not necessarily be the latest version.

Microdot

Microdot is an ultra-lightweight web micro-framework used for the ML01 kit's HTML interface.

  • License MIT
  • Author: Miguel Grinberg
  • Official Repository: https://github.com/miguelgrinberg/microdot
  • Full text license: here
    ℹ️ The microdot.py file provided in this repository may not necessarily be the latest version.

🀝 Contributions & Collaboration

Contributions to the firmware and documentation are welcome!

  • Open issues for bugs, ideas, or improvements
  • Submit pull requests for code or docs
  • Proprietary files cannot be modified

Interested in partnering?

I'm open to collaborations with:

  • Makers
  • Hardware designers
  • Open-source communities

Let's explore cross-promotion, joint tutorials, shared tools, or group orders.


πŸ—‚οΈ Repository Structure

ML01/
β”œβ”€β”€ 01_docs/
β”‚   β”œβ”€β”€ LICENSE-docs.md
β”‚   β”œβ”€β”€ ML01-assembly.md
β”‚   β”œβ”€β”€ ML01-costs.pdf
β”‚   β”œβ”€β”€ ML01-settings.md
β”‚   β”œβ”€β”€ ML01-specifications.md
β”‚   └── ML01-usage.md
β”‚
β”œβ”€β”€ 02_firmware/
β”‚   β”œβ”€β”€ LICENSE-firmware.md
β”‚   β”œβ”€β”€ LICENSE-microdot.md
β”‚   β”œβ”€β”€ LICENSE-micropython.md
β”‚   β”œβ”€β”€ RPI_PICO2_W-YYYYMMDD-vX.XX.X.uf2
β”‚   β”œβ”€β”€ index.html
β”‚   β”œβ”€β”€ main.py
β”‚   └── microdot.py
β”‚
β”œβ”€β”€ 03_hardware/
β”‚   β”œβ”€β”€ LICENSE-bom.md
β”‚   β”œβ”€β”€ LICENSE-hardware.md
β”‚   β”œβ”€β”€ ML01-bom.pdf
β”‚   β”œβ”€β”€ ML01-drawingA3.pdf
β”‚   └── ML01-kicad-schematic.pdf
β”‚
β”œβ”€β”€ 04_3dmodels/
β”‚   β”œβ”€β”€ LICENSE-3dmodels.md
β”‚   β”œβ”€β”€ ML01-pcbstand-v01.stl
β”‚   └── ML01-pcbstand-v01.stp
β”‚
β”œβ”€β”€ 05_images/
β”‚   β”œβ”€β”€ assembly/
β”‚   β”œβ”€β”€ product/
β”‚   β”œβ”€β”€ settings/
β”‚   β”œβ”€β”€ usage/
β”‚   └── LICENSE-images.md
β”‚
β”œβ”€β”€ CHANGELOG.md
β”œβ”€β”€ CONTRIBUTING.md
β”œβ”€β”€ LICENSE
└── README.md

Revision date: 2026.02.14
Β© RELEASE255 | All rights reserved