Framework LED Matrix

Overview

The Framework Laptop 16 compatible LED Matrix module is based on an RP2040 MCU and has an array of 9x36 white PWM LEDs controlled by a Lumissil IS31FL3741A.

Hardware

  • Dual core Arm Cortex-M0+ processor running up to 133MHz

  • 264KB on-chip SRAM

  • 1MB on-board QSPI flash with XIP capabilities

  • Built-in 9x36 white LED matrix

  • 2 way DIP Switch - one for user control, one to stay in bootloader

  • USB 1.1 controller (host/device)

  • 8 Programmable I/O (PIO) for custom peripherals

  • 1 Watchdog timer peripheral

Supported Features

The framework_ledmatrix board supports the hardware features listed below.

on-chip / on-board
Feature integrated in the SoC / present on the board.
2 / 2
Number of instances that are enabled / disabled.
Click on the label to see the first instance of this feature in the board/SoC DTS files.
vnd,foo
Compatible string for the Devicetree binding matching the feature.
Click on the link to view the binding documentation.

Programming and Debugging

The framework_ledmatrix board supports the runners and associated west commands listed below.

flash debug

Flashing

Using UF2

Here is an example of building the sample for enabling USB console.

west build -b framework_ledmatrix samples/subsys/usb/console

You must flash the LED Matrix with an UF2 file. One option is to use West (Zephyr’s meta-tool). To enter the UF2 flashing mode, remove the module flip the dip switch 2 and assemble it again. It will appear on the host as a mass storage device. At this point you can flash the image file by running:

west flash

After flashing, switch the DIP switch back again to run the firmware.

Alternatively, you can locate the generated build/zephyr/zephyr.uf2 file and simply drag-and-drop to the device after entering the UF2 flashing mode.

References