`adafruit_is31fl3731`¶

CircuitPython driver for the IS31FL3731 charlieplex IC.

Base library.

Author(s): Tony DiCola, Melissa LeBlanc-Williams, David Glaude

Implementation Notes¶

Hardware:

Software and Dependencies:

Adafruit CircuitPython firmware for the supported boards: https://github.com/adafruit/circuitpython/releases

class adafruit_is31fl3731.IS31FL3731(i2c, address=116)[source]¶

The IS31FL3731 is an abstract class contain the main function related to this chip. Each board needs to define width, height and pixel_addr.

Parameters:	i2c_device (i2c_device) – the connected i2c bus i2c_device address – the device address; defaults to 0x74

audio_play(sample_rate, audio_gain=0, agc_enable=False, agc_fast=False)[source]¶: Controls the audio play feature

audio_sync(value=None)[source]¶: Set the audio sync feature register

autoplay(delay=0, loops=0, frames=0)[source]¶

Start autoplay

Parameters:	delay – in ms loops – number of loops - 0->7 frames – number of frames: 0->7

blink(rate=None)[source]¶: Updates the blink register

fade(fade_in=None, fade_out=None, pause=0)[source]¶

Start and stop the fade feature. If both fade_in and fade_out are None (the default), the breath feature is used for fading. if fade_in is None, then fade_in = fade_out. If fade_out is None, then fade_out = fade_in

Parameters:	fade_in – positive number; 0->100 fade-out – positive number; 0->100 pause – breath register 2 pause value

fill(color=None, blink=None, frame=None)[source]¶

Fill the display with a brightness level

Parameters:	color – brightness 0->255 blink – True if blinking is required frame – which frame to fill 0->7

frame(frame=None, show=True)[source]¶

Set the current frame

Parameters:	frame – frame number; 0-7 or None. If None function returns current frame show – True to show the frame; False to not show.

image(img, blink=None, frame=None)[source]¶

Set buffer to value of Python Imaging Library image. The image should be in 8-bit mode (L) and a size equal to the display size.

Parameters:	img – Python Imaging Library image blink – True to blink frame – the frame to set the image

pixel(x, y, color=None, blink=None, frame=None)[source]¶

Blink or brightness for x-, y-pixel

Parameters:	x – horizontal pixel position y – vertical pixel position color – brightness value 0->255 blink – True to blink frame – the frame to set the pixel

static pixel_addr(x, y)[source]¶: Calulate the offset into the device array for x,y pixel

reset()[source]¶: Kill the display for 10MS

sleep(value)[source]¶

Set the Software Shutdown Register bit

Parameters:	value – True to set software shutdown bit; False unset

`adafruit_is31fl3731.charlie_bonnet`¶

CircuitPython driver for the IS31FL3731 charlieplex IC.

Author(s): Tony DiCola, Melissa LeBlanc-Williams

Implementation Notes¶

Hardware:

Adafruit 16x8 CharliePlex LED Matrix Bonnets

Software and Dependencies:

Adafruit CircuitPython firmware for the supported boards: https://github.com/adafruit/circuitpython/releases

class adafruit_is31fl3731.charlie_bonnet.CharlieBonnet(i2c, address=116)[source]¶

Supports the Charlieplexed bonnet

static pixel_addr(x, y)[source]¶: Calulate the offset into the device array for x,y pixel

`adafruit_is31fl3731.charlie_wing`¶

CircuitPython driver for the IS31FL3731 charlieplex IC.

Author(s): Tony DiCola, Melissa LeBlanc-Williams

Implementation Notes¶

Hardware:

Adafruit 15x7 CharliePlex LED Matrix Display FeatherWings

Software and Dependencies:

Adafruit CircuitPython firmware for the supported boards: https://github.com/adafruit/circuitpython/releases

class adafruit_is31fl3731.charlie_wing.CharlieWing(i2c, address=116)[source]¶

Supports the Charlieplexed feather wing

static pixel_addr(x, y)[source]¶: Calulate the offset into the device array for x,y pixel

`adafruit_is31fl3731.keybow2040`¶

CircuitPython driver for the IS31FL3731 charlieplex IC.

Author(s): Tony DiCola, Melissa LeBlanc-Williams

Implementation Notes¶

Hardware:

Pimoroni Keybow 2040

Software and Dependencies:

Adafruit CircuitPython firmware for the supported boards: https://github.com/adafruit/circuitpython/releases

class adafruit_is31fl3731.keybow2040.Keybow2040(i2c, address=116)[source]¶

Supports the Pimoroni Keybow 2040 with 4x4 matrix of RGB LEDs

static pixel_addr(x, y)[source]¶: Calulate the offset into the device array for x,y pixel

pixelrgb(x, y, r, g, b, blink=None, frame=None)[source]¶

Blink or brightness for x, y-pixel

Parameters:	x – horizontal pixel position y – vertical pixel position r – red brightness value 0->255 g – green brightness value 0->255 b – blue brightness value 0->255 blink – True to blink frame – the frame to set the pixel

`adafruit_is31fl3731.led_shim`¶

CircuitPython driver for the IS31FL3731 charlieplex IC.

Author: David Glaude

Implementation Notes¶

Hardware:

Pimoroni 28 RGB Led Shim

Software and Dependencies:

Adafruit CircuitPython firmware for the supported boards: https://github.com/adafruit/circuitpython/releases

class adafruit_is31fl3731.led_shim.LedShim(i2c, address=117)[source]¶

Supports the LED SHIM by Pimoroni

static pixel_addr(x, y)[source]¶: Translate an x,y coordinate to a pixel index.

pixelrgb(x, r, g, b, blink=None, frame=None)[source]¶

Blink or brightness for x-pixel

Parameters:	x – horizontal pixel position r – red brightness value 0->255 g – green brightness value 0->255 b – blue brightness value 0->255 blink – True to blink frame – the frame to set the pixel

`adafruit_is31fl3731.matrix`¶

CircuitPython driver for the IS31FL3731 charlieplex IC.

Author(s): Tony DiCola, Melissa LeBlanc-Williams

Implementation Notes¶

Hardware:

Adafruit 16x9 Charlieplexed PWM LED Matrix Driver - IS31FL3731

Software and Dependencies:

Adafruit CircuitPython firmware for the supported boards: https://github.com/adafruit/circuitpython/releases

class adafruit_is31fl3731.matrix.Matrix(i2c, address=116)[source]¶

Supports the Charlieplexed feather wing

static pixel_addr(x, y)[source]¶: Calulate the offset into the device array for x,y pixel

`adafruit_is31fl3731.charlie_bonnet`¶

CircuitPython driver for the IS31FL3731 charlieplex IC.

Author(s): Tony DiCola, Melissa LeBlanc-Williams

Implementation Notes¶

Hardware:

Pimoroni 11x7 LED Matrix Breakout

Software and Dependencies:

Adafruit CircuitPython firmware for the supported boards: https://github.com/adafruit/circuitpython/releases

class adafruit_is31fl3731.matrix_11x7.Matrix11x7(i2c, address=117)[source]¶

Supports the 11x7 LED Matrix Breakout by Pimoroni

static pixel_addr(x, y)[source]¶: Translate an x,y coordinate to a pixel index.

`adafruit_is31fl3731.rgbmatrix5x5`¶

CircuitPython driver for the IS31FL3731 charlieplex IC.

Author(s): Tony DiCola, Melissa LeBlanc-Williams, David Glaude, James Carr

Implementation Notes¶

Hardware:

5x5 RGB Matrix Breakout

Software and Dependencies:

Adafruit CircuitPython firmware for the supported boards: https://github.com/adafruit/circuitpython/releases

class adafruit_is31fl3731.rgbmatrix5x5.RGBmatrix5x5(i2c, address=116)[source]¶

Supports the Pimoroni RGBmatrix5x5 with 5x5 matrix of RGB LEDs

static pixel_addr(x, y)[source]¶: Calulate the offset into the device array for x,y pixel

pixelrgb(x, y, r, g, b, blink=None, frame=None)[source]¶

Blink or brightness for x, y-pixel

Parameters:	x – horizontal pixel position y – vertical pixel position r – red brightness value 0->255 g – green brightness value 0->255 b – blue brightness value 0->255 blink – True to blink frame – the frame to set the pixel

`adafruit_is31fl3731.scroll_phat_hd`¶

CircuitPython driver for the Pimoroni 17x7 Scroll pHAT HD.

Author: David Glaude

Implementation Notes¶

Hardware:

Pimoroni 17x7 Scroll pHAT HD

Software and Dependencies:

Adafruit CircuitPython firmware for the supported boards: https://github.com/adafruit/circuitpython/releases

class adafruit_is31fl3731.scroll_phat_hd.ScrollPhatHD(i2c, address=116)[source]¶

Supports the Scroll pHAT HD by Pimoroni

static pixel_addr(x, y)[source]¶: Translate an x,y coordinate to a pixel index.