Skip to content

Latest commit

 

History

History
88 lines (70 loc) · 3.11 KB

README.md

File metadata and controls

88 lines (70 loc) · 3.11 KB
Raw

extralife-matrixportal-tracker

Tracking donations for ExtraLife on a 32x64 RGB Matrix via an Adafruit Matrix Portal.

Countdown in Action

Features

This tracker will display the number of hours, minutes, and seconds until your 24 hour game day event. Once it hits that time, it will begin to count up so you can track how long you've been gaming for.

Additionally, it will show the current donation total.

Hardware

To build this I got the following items:

Installation

  1. Follow this guide to install CircuitPython on the MatrixPortal.
  2. Add the following libraries:
  • adafruit_bitmap_font
  • adafruit_bus_device
  • adafruit_display_text
  • adafruit_esp32spi
  • adafruit_io
  • adafruit_matrixportal
  • adafruit_portalbase
  • adafruit_connection_manager.mpy
  • adafruit_datetime.mpy
  • adafruit_debouncer.mpy
  • adafruit_fakerequests.mpy
  • adafruit_lis3dh.mpy
  • adafruit_requests.mpy
  • neopixel.mpy
  1. Create your secrets.py file as listed below.
  2. Copy the code.py and Micro5-Regular-21.bdf files.
  3. Enjoy!

Configuration

Create a secrets.py file with the following contents:

secrets = {
    # WiFi Network Configuration
    'ssid': '_your_ssid_',
    'password': '_your_wifi_password_',

    # AIO API Config for local time
    'aio_username': '_your_aio_username_',
    'aio_key': '_your_aio_key_',
    
    # ExtraLife Participant ID from
    # https://www.extra-life.org/index.cfm?fuseaction=donordrive.participant&participantID=_your_id_
    'extralife_id': '_your_participant_id_',
    # ISO8601 formatted UTC time for your game day event
    'target_date': '2024-11-02T17:30:00',
}

Optional Settings

{
    # How many seconds between ExtraLife checks
    'refresh_frequency': 30,
    # What ExtraLife server to use
    'extralife_server': 'https://www.extra-life.org',
    # How many hours should it count up?
    'hide_after': 26,
    # How many hours should it count down?
    'hide_before': 999,
}

Inspiration

Based on the Metro_Matrix_Clock from John Park at Adafruit Industries (MIT License)

Font

I've bundled a slightly modified version of the Micro 5 font. I've specified a specific font size, added an extra pixel column to the 1 to ensure they are monospaced.