Files
microbadge/README.md
Myrddin Dundragon 46a23631e4 The build files and project documents.
This sets up the basic build for the microbit project. The documentation
needed to code against it has been assembled in the documents directory.
2025-07-18 10:37:31 -04:00

3.5 KiB

MicroBadge

License-Shield LinkedIn-Shield

MicroBadge is a software application suite for the BBC micro:bit v2, designed as a digital conference badge.


Table of Contents
  1. About The Project
  2. Project Structure
  3. Getting Started
  4. Copyright & License

About The Project

This project provides a modular and extensible application framework for the BBC micro:bit. It supports multiple interactive applications with a shared UI and rendering infrastructure. It uses message-passing channels and safe numeric arithmetic via bounded, clamped, and wrapped integer types.

Features

  • Modular application management with a switcher component.
  • Menu, Snake, Badge, and future NFC applications included.
  • Real-time rendering to the micro:bit LED matrix.
  • Button input driven by asynchronous event channels.
  • Renderer abstraction for pixel-level control.
  • Channel-based messaging for input and output decoupling.
  • Safe integer handling using bounded, clamped, and wrapped types.

Built With

Project Structure

src/
├── main.rs                 Entry point of the application.

Getting Started

Prerequisites

The Rust discovery book has a great section on how to setup a build environment.

Make sure you have the correct bulid target installed.

rustup target add thumbv7em-none-eabihf

Build and Flash

To build and flash the program to your Microbit just run:

cargo embed

Copyright 2025 CyberMages LLC

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this library except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS