Macro microcontroller-2

Macro Microcontroller 2

An RP2040 microcontroller development board with an integrated macropad that lets you control GPIOs with keyboard keys on a single PCB, plus a custom BASIC interpreter and disk operating system.

Documentation page: https://nicholaslim.me/macro-microcontroller-2

Hack Club Stardance Challenge project: https://stardance.hackclub.com/projects/21502

View hardware demonstration at https://nicholaslim.me/macro-microcontroller-2/assets/hardware-demo.mp4!

What's New?

1. Microcontroller unit directly soldered on board!
2. More output devices with speed and volume adjustments (Buzzer and motor).
3. More ways to power the board (Barrel jack, USB, GPIO pins).
4. Custom BASIC interpreter and a disk operating system.

What Does it Do?

Macro Microcontroller 2 allows you to control GPIO pins using macropad-like keys and from the serial terminal using the built-in Macro Microcontroller BASIC Interpreter or a disk operating system for simple uses. It offers more ways to control GPIOs by having builtin keys that can be programmed to your own needs.

Enclosure

Datasheet

For more details on the hardware, please read the datasheet!

Firmware

Macro Microcontroller BIOS

A basic BIOS-like firmware, which performs basic POST routines and reports information on the device. Source code.

 _  _
| \/ | Macro Microcontroller BIOS Version 0.0.2.
|_\/_| Copyright (C) 2025-2026 Nicholas Lim.

Device: Macro Microcontroller 2 (RP2040 @ 125MHz)
Serial Number: ****************
RAM Free: 254K OK
Serial Status: Connected

Press SW1 to enter Macro Microcontroller BASIC.
Press SW2 to enter BOOTSEL mode.

Booting system...

Macro Microcontroller DOS

A simple DOS-like environment that boots from the BIOS. Source code.

Available commands (* denotes optional parameters):

1. HELP: Launches the help guide.
2. CALCULATE: Performs basic operations on 2 numbers. Usage: CALCULATE [Number] [+ - * / ^ root] [Number]
3. ECHO: Echoes text.
4. PROGLIST: Show program listing.
5. SYSTEM: Starts another Macro Microcontroller DOS console.
6. EXIT: Stops all processes for power off.
7. OUT: Turns on a specified GPIO for 1 second. Usage: OUT [LED# IO# BELL MOTOR]
8. VERSION: Shows the release version.
9. BOOT: Reboots the system. Usage: BOOT -m [BASIC BOOTSEL]*
10. DEVINFO: Displays device and memory information.
11. UPTIME: Shows device uptime.

Macro Microcontroller BASIC Interpreter

A BASIC interpreter written in C for Macro Microcontroller, providing a simple coding environment via a serial terminal. You may view a demo at Assets/firmware-demo.mp4.

Currently available statements:

1. PRINT: Outputs text to the serial terminal.
2. LET: Assigns a value (integer, float or string) to a variable (Only one variable is allowed for now).
3. INPUT: Assigns a value (integer, float or string) to a variable via user input.
4. GPIO: Turns on a specified GPIO pin for 1 second.
5. LSVAR: Outputs variable name and their value to the serial terminal.
6. END: Clears variable and reset line numbers.
7. EXIT: Puts the device into sleep/power off mode.
8. KEY: Pass GPIO controls to the macropad.
9. REM: Add comments to your program.

For example programs, see Firmware Files/example.bas. Try out the web editor at https://editor.nicholaslim.me/macro-microcontroller!

Schematics

View PCB file at https://kicanvas.org/?repo=https%3A%2F%2Fgithub.com%2FNicholas1023%2Fmacro-microcontroller-2%2Fblob%2Fmain%2FPCB%20Files%2Fmacro-microcontroller-2.kicad_pcb!

Repository Structure

main
 ├── /docs ← Documentation website and datasheet files are here
 ├── /Assets ← Images and videos are here
 │     └── /Journal ← Images for JOURNAL.md
 ├── /PCB Files ← .kicad_ files are here
 ├── /Production Files ← Gerber and BOM files are here
 ├── /Printing Files ← STLs are here
 ├── /Firmware Files ← Firmware files are here
 ├── JOURNAL.md ← Devlogs
 ├── README.md ← This file
 ├── LICENSE.txt ← License
 └── schematics.pdf ← Schematics

Bill of Materials (Excluding DNP)

Legal

Hardware files ("PCB Files", "Printing Files", "Production Files", "schematics.pdf") are licensed under the terms of the CERN-OHL-W-2.0 License from 9 September 2026 onwards. Versions prior to this date remain available under the terms of the CERN-OHL-P-2.0 License. See LICENSE.txt.

Documentation files ("docs", "Assets", "JOURNAL.md") are licensed under the terms of the MIT License. See docs/LICENSE.txt.

macro-microcontroller-basic.c, macro-microcontroller-bios.c, macro-microcontroller-bios+dos.c are licensed under the terms of the MIT License. firmware-template.c is licensed under the terms of the MIT-0 License. example.bas is marked CC0 1.0.

Macro Microcontroller BIOS, Macro Microcontroller DOS and Macro Microcontroller BASIC compile source code from the following third-party software:

• Pico SDK: See Firmware Files/pico_sdk_import.cmake for the Pico SDK license and copyright notice.