# Adafruit IS31FL3741
## Overview
Add a splash of RGB LEDs to a project you're working on, with this adorable 13x9 RGB LED matrix breakout. It features -- no surprise -- 117 RGB LEDs, each one 2x2mm in size, in a 13x9 grid with 3mm pitch spacing.
[Unlike our 8x8 DotStar grid here](https://www.adafruit.com/product/3444), these are not NeoPixel or DotStar or other 'smart' RGB LEDs. Instead of having a li'l chip in each LED, there's one large controller chip that handles all the PWM for you. The ISSI IS32FL3741 communicates over I2C and can set each LED element with 8 bit PWM for 24-bit color across the RGB elements, for beautiful color! There's an adjustable current driver, so you can brighten or dim the whole display without losing color resolution.
Each assembled board comes with the grid, four mounting holes, and the IS31FL3741 chip with all supporting circuitry. The board can run from 3.3 to 5V DC power and logic - powering from 5V is recommended since the green and blue LEDs look better with the extra headroom. We designed the PCB so you can tile the boards side-to-side if you desire, you'll just have to cut/solder the jumpers on the bottom to change the I2C address: Up to 4 boards can share one I2C bus.
[Use Arduino](https://github.com/adafruit/Adafruit_IS31FL3741) or [CircuitPython/Python to quickly set pixels](https://github.com/adafruit/Adafruit_CircuitPython_IS31FL3741) to any color you desire. Note that I2C makes this board very easy to wire up [compared to our "HUB75"-style RGB LED Matrices](https://www.adafruit.com/category/327) _but_ that also makes the display slower because each pixel must be written over I2C. For a small display with simple animations, it's fine - but if you want to do video or larger graphics, we recommend upgrading to the HUB75 style.
We made it easy for you to get some color right into your next project. The LED matrix and circuitry is soldered onto a custom-made PCB with two [STEMMA QT connectors](https://learn.adafruit.com/introducing-adafruit-stemma-qt/what-is-stemma-qt) on the top, and are compatible with [SparkFun Qwiic](https://www.sparkfun.com/qwiic) I2C connectors. This allows you to make solderless connections between your development board and the IS31FL3741 or to chain it with a wide range of other sensors and accessories using a [**compatible cable**](https://www.adafruit.com/?q=stemma%20qt%20cable).
# Adafruit IS31FL3741
## Pinouts
## Power Pins
The chip on the breakout requires between a 2.7V and 5.5V, and can be easily used with most microcontrollers, such as an Arduino or a Feather.
- **VIN** - This is the power pin. To power the board, give it the same power as the logic level of your microcontroller - e.g. for a 5V micro like Arduino, use 5V, or for a Feather use 3.3V.
- **GND** - This is common ground for power and logic.
## I2C Pins
Default address is **0x30**.
- **SCL** - This is the I2C **clock pin** , connect to your microcontroller's I2C clock line. There's a **10K pullup** on this pin.
- **SDA** - This is the I2C **data pin** , connect to your microcontroller's I2C data line. There's a **10K pullup** on this pin.
- [**STEMMA QT**](https://learn.adafruit.com/introducing-adafruit-stemma-qt) **-** These connectors allow you to connect to development boards with **STEMMA QT** connectors, or to other things, with [various associated accessories](https://www.adafruit.com/?q=JST%20SH%204).
## Other Pins
- **EN** - This is the shutdown pin.
- **ADDR** - This is the address pin. It is connected to GND by default. Connect this pin to one of three other pins (VCC, SCL, SDA) to change the I2C address. See below for more details.
- **INT** - This is the interrupt pin. This pin is active low when the interrupt event happens.
## Address Pin and Jumpers
The default I2C address is 0x30. The address pin is connected to ground by default. You can connect the address pin to one of three other pins to change the address, allowing for up to four boards to be connected on the same I2C bus.
**To change the I2C address, you must follow the steps below.**
**First, cut the bottom jumper on the back of the board** (indicated by the arrow in the image). Use a hobby knife to cut the connection between the two pads.
**Solder ONE of the other three sets of jumper pads (highlighted in the image) to change the address.** Solder only one at a time. The addresses are listed on the back of the board next to each jumper. Here are the details:
- The **top jumper** changes the address to **0x31**. It connects the ADDR pin to SCL.
- The **second jumper** changes the address to **0x32**. It connects the ADDR pin to SDA.
- The **third jumper** changes the address to **0x33**. It connects the ADDR pin to VCC.
# Adafruit IS31FL3741
## Python & CircuitPython
It's easy to use the IS31FL3741 matrix with Python and CircuitPython, and the [Adafruit CircuitPython IS31FL3741](https://github.com/adafruit/Adafruit_CircuitPython_IS31FL3741) module. This module allows you to easily write Python code that controls the LEDs.
You can use this LED controller with any CircuitPython microcontroller board or with a computer that has GPIO and Python [thanks to Adafruit\_Blinka, our CircuitPython-for-Python compatibility library](https://learn.adafruit.com/circuitpython-on-raspberrypi-linux).
## CircuitPython Microcontroller Wiring
First wire up a IS31FL3741 matrix to your board exactly as shown below. Here's an example of wiring a Feather M4 to the matrix driver breakout with I2C using one of the handy [**STEMMA QT**](https://learn.adafruit.com/introducing-adafruit-stemma-qt) connectors:
- **Board 3V** to **matrix VCC (red wire)**
- **Board GND** to **matrix GND (black wire)**
- **Board SCL** to **matrix SCL (yellow wire)**
- **Board SDA** to **matrix SDA (blue wire)**
You can also use the standard **0.100" pitch** headers to wire it up on a breadboard:
- **Board 3V** to **matrix VCC (red wire)**
- **Board GND** to **matrix GND (black wire)**
- **Board SCL** to **matrix SCL (yellow wire)**
- **Board SDA** to **matrix SDA (blue wire)**
## Python Computer Wiring
Since there's _dozens_ of Linux computers/boards you can use, we will show wiring for Raspberry Pi. For other platforms, [please visit the guide for CircuitPython on Linux to see whether your platform is supported](https://learn.adafruit.com/circuitpython-on-raspberrypi-linux).
Here's the Raspberry Pi wired to the matrix driver breakout using I2C and a [**STEMMA QT**](https://learn.adafruit.com/introducing-adafruit-stemma-qt) connector:
- **Pi 3V3** to **matrix VCC (red wire)**
- **Pi GND** to **matrix GND (black wire)**
- **Pi SCL** to **matrix SCL (yellow wire)**
- **Pi SDA** to **matrix SDA (blue wire)**
Finally here is an example of how to wire up a Raspberry Pi to the sensor using a solderless breadboard:
- **Pi 3V3** to **matrix VCC (red wire)**
- **Pi GND** to **matrix GND (black wire)**
- **Pi SCL** to **matrix SCL (yellow wire)**
- **Pi SDA** to **matrix SDA (blue wire)**
## Python Installation of IS31FL3741 Library
You'll need to install the **Adafruit\_Blinka** library that provides the CircuitPython support in Python. This may also require enabling I2C on your platform and verifying you are running Python 3. [Since each platform is a little different, and Linux changes often, please visit the CircuitPython on Linux guide to get your computer ready](https://learn.adafruit.com/circuitpython-on-raspberrypi-linux)!
Once that's done, from your command line run the following command:
- `pip3 install adafruit-circuitpython-is31fl3741`
If your default Python is version 3, you may need to run `pip` instead. Make sure you aren't trying to use CircuitPython on Python 2.x, it isn't supported!
## CircuitPython Usage
To use with CircuitPython, you need to first install the IS31FL3741 library, and its dependencies, into the **lib** folder on your **CIRCUITPY** drive. Then you need to update **code.py** with the example script.
Thankfully, we can do this in one go. In the example below, click the **Download Project Bundle** button below to download the necessary libraries and the **code.py** file in a zip file. Extract the contents of the zip file, and copy the **entire** **lib** **folder** and the **code.py** file to your **CIRCUITPY** drive.
Your **CIRCUITPY/lib** folder should contain the following folders and file:
- **adafruit\_bus\_device/**
- **adafruit\_is31fl3741/**
- **adafruit\_register/**
- **adafruit\_framebuf.mpy**
## Python Usage
Once you have the library `pip3` installed on your computer, copy or download the following example to your computer, and run the following, replacing **code.py** with whatever you named the file: `python3 code.py`
## Basic Example Code:
https://github.com/adafruit/Adafruit_CircuitPython_IS31FL3741/blob/main/examples/is31fl3741_simpletest.py
The LEDs light up one at a time, various colors, and in an arbitrary order!
First you import the necessary modules and library. Then you create the `IS31FL3741` object, provide it the `board.I2C()` object, and save it to `is31`.
Next, you do the basic setup needed to control the LEDs. You set all the LEDs to maximum brightness with `set_led_scaling()`, set the current to max with `global_current`, and enable them by setting `enable` to `True`.
Then, inside your loop, you have a `for` loop iterating over the entire set of pixels (351 total!), and turning on each one individually for 0.01 seconds before turning it off and moving on to the next one.
## Rainbow Example Code:
To run this example, you need to update your **code.py** file.
Click the **Download Project Bundle** button below to download the **code.py** file (and the libraries, though you don't need to update them again) in a zip file. Extract the contents of the zip file, and copy the **code.py** file to your **CIRCUITPY** drive.
Your **CIRCUITPY** drive should resemble the image below.
https://github.com/adafruit/Adafruit_CircuitPython_IS31FL3741/blob/main/examples/is31fl3741_rgbswirl.py
The matrix lights up in a slow-moving rainbow pattern!
That's all there is to using the IS31FL3741 LED matrix driver with CircuitPython!
# Adafruit IS31FL3741
## Python Docs
# Adafruit IS31FL3741
## Arduino
Using the IS31FL3741 with Arduino involves wiring up the matrix to your Arduino-compatible microcontroller, installing the [Adafruit IS31FL3741](https://github.com/adafruit/Adafruit_IS31FL3741) library, and running the provided example code.
## I2C Wiring
Here is how to wire up the matrix using one of the [**STEMMA QT**](https://learn.adafruit.com/introducing-adafruit-stemma-qt) connectors. The examples show a Metro but wiring will work the same for an Arduino or other compatible board.
- Connect **matrix VCC (red wire)** to **Arduino 5V** if you are running a **5V** board Arduino (Uno, etc.). If your board is **3V,** connect to that instead.
- Connect** matrix GND (black wire)** to **Arduino** **GND**
- Connect **matrix SCL (yellow wire)** to **Arduino** **SCL**
- Connect **matrix SDA (blue wire)** to **Arduino** **SDA**
Here is how to wire the matrix to a board using a solderless breadboard:
- Connect **matrix VCC (red wire)** to **Arduino 5V** if you are running a **5V** board Arduino (Uno, etc.). If your board is **3V,** connect to that instead.
- Connect** matrix GND (black wire)** to **Arduino** **GND**
- Connect **matrix SCL (yellow wire)** to **Arduino** **SCL**
- Connect **matrix SDA (blue wire)** to **Arduino** **SDA**
## **Library Installation**
You can install the **Adafruit IS31FL3741** library for Arduino using the Library Manager in the Arduino IDE.
Click the **Manage Libraries ...** menu item, search for **IS31FL3741** , and select the **Adafruit IS31FL3741** library, and install the latest version:
If asked about dependencies, click "Install all".
## **Load Rainbow Example**
Open up **File -\> Examples -\> Adafruit IS31FL3741 Library -\> qtmatrix-rgbswirl**
https://github.com/adafruit/Adafruit_IS31FL3741/blob/main/examples/qtmatrix-rgbswirl/qtmatrix-rgbswirl.ino
After opening the demo file, upload to your Arduino wired up to the matrix. Once you upload the code, you'll see the matrix light up in a rainbow pattern!
This demo does a simple example showing how to set the color of each pixel using `ledmatrix.drawPixel(x, y, color565)` - where `x` and `y` are the 0-12 and 0-8 indexed location indicator, and `color565` is the 16-bit packed color. We use `ledmatrix.``ColorHSV` to get a rainbow color across the spectrum.
## Load GFX Example
Open up **File -\> Examples -\> Adafruit IS31FL3741 Library -\> qtmatrix-text**
https://github.com/adafruit/Adafruit_IS31FL3741/blob/main/examples/qtmatrix-text/qtmatrix-text.ino
After opening the demo file, upload to your Arduino wired up to the matrix. Once you upload the code, a scrolling rainbow ADAFRUIT! will show up on your matrix!
This demo uses more of the Adafruit\_GFX library to draw text, [check out the guide for Adafruit GFX to learn how to draw circles, lines, triangles, etc!](https://learn.adafruit.com/adafruit-gfx-graphics-library)
# Adafruit IS31FL3741
## Adafruit GFX Library
# Adafruit IS31FL3741
## Arduino Docs
# Adafruit IS31FL3741
## Downloads
## Files
- [IS31FL3741 Datasheet](https://cdn-learn.adafruit.com/assets/assets/000/104/653/original/IS31FL3741.pdf?1631722883)
- [EagleCAD PCB files on GitHub](https://github.com/adafruit/Adafruit-IS31FL3741-PCB)
- [Matrix Fritzing object in the Adafruit Fritzing Library](https://github.com/adafruit/Fritzing-Library/blob/master/parts/Adafruit%20IS31FL3741.fzpz)
- [3D Models on GitHub](https://github.com/adafruit/Adafruit_CAD_Parts/tree/main/5201%20IS31FL3741%20STEMMA)
# Schematic and Fab Print for LED Matrix
## Primary Products
### Adafruit IS31FL3741 13x9 PWM RGB LED Matrix Driver
[Adafruit IS31FL3741 13x9 PWM RGB LED Matrix Driver](https://www.adafruit.com/product/5201)
Add a splash of RGB LEDs to a project you're working on, with this adorable 13x9 RGB LED matrix breakout. It features -- no surprise -- 117 RGB LEDs, each one 2x2mm in size, in a 13x9 grid with 3mm pitch spacing.
[Unlike our 8x8 dotstar...](https://www.adafruit.com/product/3444)
In Stock
[Buy Now](https://www.adafruit.com/product/5201)
[Related Guides to the Product](https://learn.adafruit.com/products/5201/guides)
## Featured Products
### STEMMA QT / Qwiic JST SH 4-Pin Cable - 50mm Long
[STEMMA QT / Qwiic JST SH 4-Pin Cable - 50mm Long](https://www.adafruit.com/product/4399)
This 4-wire cable is 50mm / 1.9" long and fitted with JST SH female 4-pin connectors on both ends. Compared with the chunkier JST PH these are 1mm pitch instead of 2mm, but still have a nice latching feel, while being easy to insert and remove.
In Stock
[Buy Now](https://www.adafruit.com/product/4399)
[Related Guides to the Product](https://learn.adafruit.com/products/4399/guides)
### STEMMA QT / Qwiic JST SH 4-pin Cable - 100mm Long
[STEMMA QT / Qwiic JST SH 4-pin Cable - 100mm Long](https://www.adafruit.com/product/4210)
This 4-wire cable is a little over 100mm / 4" long and fitted with JST-SH female 4-pin connectors on both ends. Compared with the chunkier JST-PH these are 1mm pitch instead of 2mm, but still have a nice latching feel, while being easy to insert and remove.
Out of Stock
[Buy Now](https://www.adafruit.com/product/4210)
[Related Guides to the Product](https://learn.adafruit.com/products/4210/guides)
### STEMMA QT / Qwiic JST SH 4-pin to Premium Male Headers Cable
[STEMMA QT / Qwiic JST SH 4-pin to Premium Male Headers Cable](https://www.adafruit.com/product/4209)
This 4-wire cable is a little over 150mm / 6" long and fitted with JST-SH female 4-pin connectors on one end and premium Dupont male headers on the other. Compared with the chunkier JST-PH these are 1mm pitch instead of 2mm, but still have a nice latching feel, while being easy to insert...
In Stock
[Buy Now](https://www.adafruit.com/product/4209)
[Related Guides to the Product](https://learn.adafruit.com/products/4209/guides)
## Related Guides
- [LED Matrix Alarm Clock](https://learn.adafruit.com/led-matrix-alarm-clock.md)
- [Mini LED Matrix Audio Visualizer](https://learn.adafruit.com/mini-led-matrix-audio-visualizer.md)
- [Ocean Epoxy Resin Lightbox with RGB LED Matrix Image Scroller](https://learn.adafruit.com/ocean-epoxy-resin-lightbox-with-rgb-led-matrix-image-scroller.md)
- [PyPortal Quarantine Clock](https://learn.adafruit.com/pyportal-quarantine-clock.md)
- [Adafruit AD5693R 16-Bit DAC Breakout Board](https://learn.adafruit.com/adafruit-ad5693r-16-bit-dac-breakout-board.md)
- [Adafruit LIS2MDL Triple Axis Magnetometer](https://learn.adafruit.com/adafruit-lis2mdl-triple-axis-magnetometer.md)
- [Adafruit PCM5122 I2S DAC](https://learn.adafruit.com/adafruit-pcm5122-i2s-dac.md)
- [Adafruit ESP32-S3 TFT Feather](https://learn.adafruit.com/adafruit-esp32-s3-tft-feather.md)
- [Adafruit CharliePlex LED Matrix Bonnet](https://learn.adafruit.com/adafruit-charlieplex-bonnet.md)
- [Star Trek LCARS Display](https://learn.adafruit.com/star-trek-lcars-display.md)
- [CircuitPython Libraries on Linux and ODROID C2](https://learn.adafruit.com/circuitpython-libaries-linux-odroid-c2.md)
- [Make It Log](https://learn.adafruit.com/make-it-data-log-spreadsheet-circuit-playground.md)
- [Adafruit PCA9546 4-Channel STEMMA QT Multiplexer](https://learn.adafruit.com/adafruit-pca9546-4-channel-stemma-qt-multiplexer.md)
- [Adafruit AirLift - ESP32 WiFi Co-Processor Breakout](https://learn.adafruit.com/adafruit-airlift-breakout.md)
- [CircuitPython Libraries on Linux and the NVIDIA Jetson Nano](https://learn.adafruit.com/circuitpython-libraries-on-linux-and-the-nvidia-jetson-nano.md)