pimoroni-pico/micropython/examples/badger2040/README.md

Badger 2040 Examples

• Function Examples
  • Battery
  • Button Test
  • LED
  • Pin interrupt
• Application Examples
  • Badge
  • Checklist
  • Clock
  • E-Book
  • Fonts
  • Image
  • QR gen
  • Launcher
  • Conway

Function Examples

Battery

battery.py

An example of how to read the battery voltage and display a battery level indicator.

Button Test

button_test.py

An example of how to read Badger2040's buttons and display a unique message for each.

LED

led.py

Blinks Badger's LED on and off.

Pin interrupt

pin_interrupt.py

An example of drawing text and graphics and using the buttons.

Application Examples

Badge

badge.py

Create your own name badge! This application looks for two files on your MicroPython drive:

• badge.txt - A text file containing 6 lines, corresponding to the 6 different pieces of text on the badge
• badge-image.bin - A 108x128px 1-bit colour depth image to display alongside the text. You can use examples/badger2040/image_converter/convert.py to convert them:

python3 convert.py --binary --resize image_file_1.png image_file_2.png image_file_3.png

Checklist

list.py

A checklist application, letting you navigate through items and tick each of them off.

• checklist.txt - A text file containing the titles of items for the list.

Clock

clock.py

A simple clock showing the time and date, that uses the E Ink's fast speed to update every second.

E-Book

ebook.py

A mini text file e-reader. Comes pre-loaded with an excerpt of The Wind In the Willows.

Fonts

fonts.py

A demonstration of the various fonts that can be used in your programs.

Image

image.py

An image gallery. Displays and lets you cycle through any images stored within the MicroPython device's /images directory. Images must be 296x128 pixels with 1-bit colour depth. You can use examples/badger2040/image_converter/convert.py to convert them:

python3 convert.py --binary --resize image_file_1.png image_file_2.png image_file_3.png

QR gen

qrgen.py

Displays and lets you cycle through multiple QR codes, with configuration stored in text files within the MicroPython device's /qrcodes directory.

• /qrcodes/qrcode.txt - A text file containing 9 lines. The first line should be a URL which will be converted into and displayed as a QR code. Up to 8 more lines of information can be added, which will be shown as plain text to the right of the QR code.
• /qrcodes/*.txt - additional text files can be created using the same format. All text files can be cycled through.

Launcher

launcher.py

A launcher-style application, providing a menu of other applications that can be loaded, as well as information such as battery level.

Conway

conway.py

Conway's classic Game of Life, implemented on the Badger. Note: this application is not linked from the Launcher by default - it can be run directly using Thonny or your MicroPython editor of choice, or you can modify the Launcher to add it (you'll want to update launchericons.png as well)