Adafruit LED Backpacks

https://learn.adafruit.com/adafruit-led-backpack
Admin
Adafruit LED Backpacks are I2C-based driver breakout boards and modules used to control LED...
Tokens:84,514
Snippets:730
Trust Score:10
Update:1 month ago
Show doc for...
Tokens:
Raw
### Install pip3

Source: https://learn.adafruit.com/adafruit-led-backpack?view=all

Command to install pip3 if it is missing on your system.

```bash
sudo apt-get install python3-pip
```

--------------------------------

### Install PIL via apt-get

Source: https://learn.adafruit.com/adafruit-led-backpack?view=all

Install the Python Imaging Library (PIL) using the system package manager to support custom fonts.

```bash
sudo apt-get install python3-pil
```

--------------------------------

### Initialize I2C and Seg7x4 display

Source: https://learn.adafruit.com/adafruit-led-backpack/0-dot-56-seven-segment-backpack-circuitpython-and-python-usage

Imports the necessary modules and creates an I2C instance using board.I2C(), then initializes a Seg7x4 display. Use this as the starting point for controlling the LED backpack from the REPL.

```python
import board
from adafruit_ht16k33.segments import Seg7x4

i2c = board.I2C()
display = Seg7x4(i2c)
```

--------------------------------

### Adafruit_7segment matrix begin(0x70) - single

Source: https://learn.adafruit.com/adafruit-led-backpack/changing-i2c-address

Original example for setting a single seven-segment matrix to address 0x70. Replace this with two object instantiations when using multiple backpacks.

```C++
Adafruit_7segment matrix = Adafruit_7segment();

void setup() {
  Serial.begin(9600);
  Serial.println("7 Segment Backpack Test");

  matrix.begin(0x70);
}
```

--------------------------------

### Initialize I2C and MatrixBackpack16x8

Source: https://learn.adafruit.com/adafruit-led-backpack/1-2-16x8-matrix-circuitpython-and-python-usage

Import the necessary modules and initialize the I2C bus and matrix display. Note that some boards may require board.STEMMA_I2C() instead of board.I2C().

```python
import board
from adafruit_ht16k33.matrix import MatrixBackpack16x8

i2c = board.I2C()
matrix = MatrixBackpack16x8(i2c)
```

--------------------------------

### Install HT16K33 Library

Source: https://learn.adafruit.com/adafruit-led-backpack?view=all

Command to install the CircuitPython HT16K33 library via pip.

```bash
pip3 install adafruit-circuitpython-ht16k33
```

--------------------------------

### Initialize display with I2C address

Source: https://learn.adafruit.com/adafruit-led-backpack/0-54-alphanumeric-9b21a470-83ad-459c-af02-209d8d82c462

Initialize the display using the begin method. The default address is 0x70, but a custom address can be provided.

```auto
alpha4.begin(0x70);  // pass in the address
```

--------------------------------

### Line Number Reference

Source: https://learn.adafruit.com/adafruit-led-backpack?view=all

A simple list of line numbers corresponding to the code example.

```text
1
2
3
4
5
6
7
8
```

--------------------------------

### CircuitPython AlphaNumeric Display Example

Source: https://learn.adafruit.com/adafruit-led-backpack?view=all

This script demonstrates how to initialize the display, use set_digit_raw with various data formats, and scroll text using the marquee function.

```python
# SPDX-FileCopyrightText: 2022 Kattni Rembor for Adafruit Industries
# SPDX-License-Identifier: MIT

import time

import board

from adafruit_ht16k33 import segments

# Create the display object.
# Display connected to STEMMA QT connector.
display = segments.Seg14x4(board.STEMMA_I2C())
# Display connected to I2C pins.
# display = segments.Seg14x4(board.I2C())  # uses board.SCL and board.SDA

# This section displays four 0's across the display. The code shows four
# different ways to use the set_digit_raw function. Each is labeled below.
# 16-bit Hexadecimal number
display.set_digit_raw(0, 0x2D3F)
time.sleep(0.2)
# 16-bit Binary number
display.set_digit_raw(1, 0b0010110100111111)
time.sleep(0.2)
# 8-bit Binary Tuple
display.set_digit_raw(2, (0b00101101, 0b00111111))
time.sleep(0.2)
# 8-bit Hexadecimal List
display.set_digit_raw(3, [0x2D, 0x3F])
time.sleep(0.2)

# Delay between.
time.sleep(2)

# Scroll "Hello, world!" across the display. Setting the loop parameter to false allows you to
# tell the marquee function to run only once. By default, marquee loops indefinitely.
display.marquee("Hello, world!", loop=False)

# Delay between.
time.sleep(2)

# Scroll special characters, uppercase and lowercase letters, and numbers across
# the display in a loop. This section will continue to run indefinitely.
display.marquee("".join(chr(character) for character in range(ord("!"), ord("z") + 1)))
```

--------------------------------

### Initialize BigSeg7x4 Display with I2C

Source: https://learn.adafruit.com/adafruit-led-backpack/circuitpython-and-python-usage-197dcbfa-4ccf-4b98-a152-3982411df681

Imports the necessary modules and initializes the I2C bus using board.I2C(), then creates a BigSeg7x4 display object. Note that some boards may require board.STEMMA_I2C() instead of board.I2C() when using the STEMMA QT port.

```python
import board
from adafruit_ht16k33.segments import BigSeg7x4

i2c = board.I2C()
display = BigSeg7x4(i2c)
```

--------------------------------

### Initialize BiColor24 Bargraph with I2C

Source: https://learn.adafruit.com/adafruit-led-backpack/bi-color-24-bargraph-circuitpython-usage

Imports the necessary modules and initializes the I2C bus using board.I2C(), then creates a Bicolor24 instance. Note: Some boards may require board.STEMMA_I2C() when using the STEMMA QT port.

```python
import board
from adafruit_ht16k33.bargraph import Bicolor24

i2c = board.I2C()
bc24 = Bicolor24(i2c)
```

--------------------------------

### Set individual segments using set_digit_raw

Source: https://learn.adafruit.com/adafruit-led-backpack/0-dot-56-seven-segment-backpack-circuitpython-and-python-usage

Use set_digit_raw with an 8-bit bitmask (Hex, Decimal, or binary) to control specific segments of a digit. This example displays '8.8.EE' by passing different bitmask formats.

```python
display.set_digit_raw(0, 0xFF)
display.set_digit_raw(1, 0b11111111)
display.set_digit_raw(2, 0x79)
display.set_digit_raw(3, 0b01111001)
```
Tokens:
Raw