Adafruit HT16K33 LED Matrix Shield

Overview

The Adafruit Small 1.2 inch 8x8 LED Matrix with I2C Backpack features a Holtek HT16K33 LED Controller Driver, an 8x8 LED matrix and two STEMMA QT connectors.

This shield definition can also be used with other shields having a HT16K33 LED controller. The controller exposes up to 128 LEDs, and the mapping between a LED number and a physical LED might differ on different shields. See Discussion on other LED backpacks.

Adafruit 8x8 LED Matrix Shield (Credit: Adafruit)

Requirements

This shield can be used with boards which provide an I2C connector, for example STEMMA QT or Qwiic connectors. The target board must define a zephyr_i2c node label. See Shields for more details.

Pin Assignments

Shield Pin	Function
SDA	HT16K33 I2C SDA
SCL	HT16K33 I2C SCL

See holtek,ht16k33 for documentation on devicetree settings.

Programming

Set --shield adafruit_ht16k33 when you invoke west build. For example when running the HT16K33 LED driver with keyscan sample:

# From the root of the zephyr repository
west build -b adafruit_qt_py_rp2040 --shield adafruit_ht16k33 samples/drivers/ht16k33