adafruit_ht16k33.ht16k33

• Authors: Radomir Dopieralski & Tony DiCola for Adafruit Industries

class adafruit_ht16k33.ht16k33.HT16K33(i2c: busio.I2C, address: int = 112, auto_write: bool = True, brightness: float = 1.0)

The base class for all displays. Contains common methods.

Parameters

• address (int) – The I2C addess of the HT16K33.

• auto_write (bool) – True if the display should immediately change when set. If False, show must be called explicitly.

• brightness (float) – 0.0 - 1.0 default brightness level.

property auto_write

Auto write updates to the display.

property blink_rate

The blink rate. Range 0-3.

property brightness

The brightness. Range 0.0-1.0

fill(color: bool)

Fill the whole display with the given color.

show()

Refresh the display and show the changes.

Matrix Displays

class adafruit_ht16k33.matrix.Matrix16x8(i2c: busio.I2C, address: int = 112, auto_write: bool = True, brightness: float = 1.0)

The matrix wing.

pixel(x, y, color=None)

Get or set the color of a given pixel.

class adafruit_ht16k33.matrix.Matrix8x8(i2c: busio.I2C, address: int = 112, auto_write: bool = True, brightness: float = 1.0)

A single matrix.

property columns

Read-only property for number of columns

image(img)

Set buffer to value of Python Imaging Library image. The image should be in 1 bit mode and a size equal to the display size.

pixel(x: int, y: int, color: Optional[bool] = None) → Optional[bool]

Get or set the color of a given pixel.

property rows

Read-only property for number of rows

shift(x: int, y: int, rotate: bool = False)

Shift pixels by x and y

Parameters

rotate – (Optional) Rotate the shifted pixels to the left side (default=False)

shift_down(rotate: bool = False)

Shift all pixels down

Parameters

rotate – (Optional) Rotate the shifted pixels to top (default=False)

shift_left(rotate: bool = False)

Shift all pixels left

Parameters

rotate – (Optional) Rotate the shifted pixels to the right side (default=False)

shift_right(rotate: bool = False)

Shift all pixels right

Parameters

rotate – (Optional) Rotate the shifted pixels to the left side (default=False)

shift_up(rotate: bool = False)

Shift all pixels up

Parameters

rotate – (Optional) Rotate the shifted pixels to bottom (default=False)

class adafruit_ht16k33.matrix.Matrix8x8x2(i2c: busio.I2C, address: int = 112, auto_write: bool = True, brightness: float = 1.0)

A bi-color matrix.

fill(color)

Fill the whole display with the given color.

image(img: <module 'PIL.Image' from '/home/docs/checkouts/readthedocs.org/user_builds/adafruit-circuitpython-ht16k33/envs/4.1.7/lib/python3.6/site-packages/PIL/Image.py'>)

Set buffer to value of Python Imaging Library image. The image should be a size equal to the display size.

pixel(x, y, color=None)

Get or set the color of a given pixel.

class adafruit_ht16k33.matrix.MatrixBackpack16x8(i2c: busio.I2C, address: int = 112, auto_write: bool = True, brightness: float = 1.0)

A double matrix backpack.

pixel(x, y, color=None)

Get or set the color of a given pixel.

Segment Displays

class adafruit_ht16k33.segments.BigSeg7x4(i2c: busio.I2C, address: int = 112, auto_write: bool = True)

Numeric 7-segment display. It has the same methods as the alphanumeric display, but only supports displaying a limited set of characters.

property ampm

The AM/PM indicator.

property bottom_left_dot

The bottom-left dot indicator.

property top_left_dot

The top-left dot indicator.

class adafruit_ht16k33.segments.Colon(disp: adafruit_ht16k33.segments.Seg7x4, num_of_colons: int = 1)

Helper class for controlling the colons. Not intended for direct use.

class adafruit_ht16k33.segments.Seg14x4(i2c: busio.I2C, address: int = 112, auto_write: bool = True, brightness: float = 1.0)

Alpha-numeric, 14-segment display.

marquee(text: str, delay: float = 0.25, loop: bool = True)

Automatically scroll the text at the specified delay between characters

Parameters

• text (str) – The text to display

• delay (float) – (optional) The delay in seconds to pause before scrolling to the next character (default=0.25)

• loop (bool) – (optional) Whether to endlessly loop the text (default=True)

print(value: Union[str, int, float], decimal: int = 0)

Print the value to the display.

print_hex(value: int)

Print the value as a hexidecimal string to the display.

scroll(count: int = 1)

Scroll the display by specified number of places.

set_digit_raw(index: int, bitmask: Union[int, List, Tuple])

Set digit at position to raw bitmask value. Position should be a value of 0 to 3 with 0 being the left most character on the display.

bitmask should be 2 bytes such as: 0xFFFF It can be passed as an integer, list, or tuple

class adafruit_ht16k33.segments.Seg7x4(i2c: busio.I2C, address: int = 112, auto_write: bool = True)

Numeric 7-segment display. It has the same methods as the alphanumeric display, but only supports displaying a limited set of characters.

property colon

Simplified colon accessor

scroll(count: int = 1)

Scroll the display by specified number of places.

set_digit_raw(index: int, bitmask: int)

Set digit at position to raw bitmask value. Position should be a value of 0 to 3 with 0 being the left most digit on the display.