Libraries

Once your Feather is set up with CircuitPython 5.3.0 or greater, you'll also need to add some libraries. Follow this page for information on how to download and add libraries to your Feather.

From the library bundle you downloaded in that guide page, transfer the following libraries onto the Feather's /lib directory:

  • adafruit_bus_device
  • adafruit_slideshow.mpy

Text Editor

Adafruit recommends using the Mu editor for using your CircuitPython code with the Feather boards. You can get more info in this guide.

Alternatively, you can use any text editor that saves files.

Code.py

Copy the code below and paste it into Mu. Then, save it to your Feather as code.py.

import board
import displayio
import framebufferio
import rgbmatrix
from adafruit_slideshow import SlideShow

displayio.release_displays()
matrix = rgbmatrix.RGBMatrix(
    width=64,
    height=32,
    bit_depth=5,
    rgb_pins=[board.D6, board.D5, board.D9, board.D11, board.D10, board.D12],
    addr_pins=[board.A5, board.A4, board.A3, board.A2],
    clock_pin=board.D13,
    latch_pin=board.D0,
    output_enable_pin=board.D1,
)

display = framebufferio.FramebufferDisplay(matrix, auto_refresh=True)

slideshow = SlideShow(
    display,
    backlight_pwm=None,
    folder="/images",
    loop=True,
    order=0,
    fade_effect=False,
    dwell=8,
    auto_advance=True,
)


while slideshow.update():
    pass

The code is quite short! We are using the displayio library along with framebufferio and rgbmatrix to do the heavy lifting.

The adafruit_slideshow library makes it simple to auto-play any images in the specified folder. Here's more detail on how to use SlideShow.

Image Files

You can get started using the included image files, or make your own.

From the project .zip, drag the images folder onto the Feather's CIRCUITPY drive.

The program will automatically use any .bmp files in the /images directory. Make sure they have legal names (no spaces or weird characters!) and are 64x32 pixel .bmp files. 16-bit or 24-bit both work fine.

This guide was first published on Jun 23, 2020. It was last updated on Jun 23, 2020.

This page (Code the Protest Sign) was last updated on Nov 06, 2020.