Merge pull request #130 from pimoroni/driver/is31fl3731

is31fl3731 driver, RGBMatrix5x5 and Matrix11x7 breakouts

drivers/CMakeLists.txt

@@ -3,3 +3,4 @@ add_subdirectory(st7789)
 add_subdirectory(msa301)
 add_subdirectory(rv3028)
 add_subdirectory(vl53l1x)
+add_subdirectory(is31fl3731)

drivers/is31fl3731/CMakeLists.txt

@@ -0,0 +1 @@
+include(is31fl3731.cmake)

drivers/is31fl3731/is31fl3731.cmake

@@ -0,0 +1,10 @@
+set(DRIVER_NAME is31fl3731)
+add_library(${DRIVER_NAME} INTERFACE)
+
+target_sources(${DRIVER_NAME} INTERFACE
+  ${CMAKE_CURRENT_LIST_DIR}/${DRIVER_NAME}.cpp)
+
+target_include_directories(${DRIVER_NAME} INTERFACE ${CMAKE_CURRENT_LIST_DIR})
+
+# Pull in pico libraries that we need
+target_link_libraries(${DRIVER_NAME} INTERFACE pico_stdlib hardware_i2c)

drivers/is31fl3731/is31fl3731.cpp

@@ -0,0 +1,128 @@
+#include <cstdlib>
+#include <math.h>
+#include <map>
+#include <vector>
+
+#include "is31fl3731.hpp"
+
+namespace pimoroni {
+
+  constexpr uint8_t CONFIG_BANK = 0x0b;
+  constexpr uint8_t NUM_PIXELS = 144;
+  constexpr uint8_t NUM_FRAMES = 8;
+
+  constexpr uint8_t ENABLE_OFFSET = 0x00;
+  constexpr uint8_t COLOR_OFFSET = 0x24;
+
+  constexpr uint8_t GAMMA[256] = {
+    0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
+    0, 0, 0, 0, 0, 0, 1, 1, 1, 1, 1, 1, 1, 2, 2, 2,
+    2, 2, 2, 3, 3, 3, 3, 3, 4, 4, 4, 4, 5, 5, 5, 5,
+    6, 6, 6, 7, 7, 7, 8, 8, 8, 9, 9, 9, 10, 10, 11, 11,
+    11, 12, 12, 13, 13, 13, 14, 14, 15, 15, 16, 16, 17, 17, 18, 18,
+    19, 19, 20, 21, 21, 22, 22, 23, 23, 24, 25, 25, 26, 27, 27, 28,
+    29, 29, 30, 31, 31, 32, 33, 34, 34, 35, 36, 37, 37, 38, 39, 40,
+    40, 41, 42, 43, 44, 45, 46, 46, 47, 48, 49, 50, 51, 52, 53, 54,
+    55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70,
+    71, 72, 73, 74, 76, 77, 78, 79, 80, 81, 83, 84, 85, 86, 88, 89,
+    90, 91, 93, 94, 95, 96, 98, 99, 100, 102, 103, 104, 106, 107, 109, 110,
+    111, 113, 114, 116, 117, 119, 120, 121, 123, 124, 126, 128, 129, 131, 132, 134,
+    135, 137, 138, 140, 142, 143, 145, 146, 148, 150, 151, 153, 155, 157, 158, 160,
+    162, 163, 165, 167, 169, 170, 172, 174, 176, 178, 179, 181, 183, 185, 187, 189,
+    191, 193, 194, 196, 198, 200, 202, 204, 206, 208, 210, 212, 214, 216, 218, 220,
+    222, 224, 227, 229, 231, 233, 235, 237, 239, 241, 244, 246, 248, 250, 252, 255};
+  
+  enum mode {
+    PICTURE   = 0x00,
+    AUTOPLAY  = 0x08,
+    AUDIOPLAY = 0x18
+  };
+
+  enum reg : uint8_t {
+    MODE      = 0x00,
+    FRAME     = 0x01,
+    AUTPLAY1  = 0x02,
+    AUTOPLAY2 = 0x03,
+    BLINK     = 0x05,
+    AUDIOSYNC = 0x06,
+    BREATH1   = 0x07,
+    BREATH2   = 0x08,
+    SHUTDOWN  = 0x0a,
+    GAIN      = 0x0b,
+    ADC       = 0x0c,
+    BANK      = 0xfd
+  };
+
+  bool IS31FL3731::init() {
+    i2c_init(i2c, 100000);
+
+    gpio_set_function(sda, GPIO_FUNC_I2C); gpio_pull_up(sda);
+    gpio_set_function(scl, GPIO_FUNC_I2C); gpio_pull_up(scl);
+
+    i2c_reg_write_uint8(reg::SHUTDOWN, 0b00000001);
+
+    i2c_reg_write_uint8(reg::BANK, CONFIG_BANK);
+
+    i2c_reg_write_uint8(reg::MODE, mode::PICTURE);
+
+    i2c_reg_write_uint8(reg::AUDIOSYNC, 0);
+
+    clear();
+
+    return true;
+  }
+
+  i2c_inst_t* IS31FL3731::get_i2c() const {
+    return i2c;
+  }
+
+  int IS31FL3731::get_sda() const {
+    return sda;
+  }
+
+  int IS31FL3731::get_scl() const {
+    return scl;
+  }
+
+  void IS31FL3731::clear() {
+    for(auto i = 0u; i < sizeof(buf); i++) {
+      buf[i] = 0;
+    }
+  }
+
+  void IS31FL3731::i2c_reg_write_uint8(uint8_t reg, uint8_t value) {
+    uint8_t buffer[2] = {reg, value};
+    i2c_write_blocking(i2c, address, buffer, 2, false);
+  }
+
+  int16_t IS31FL3731::i2c_reg_read_int16(uint8_t reg) {
+    int16_t value;
+    i2c_write_blocking(i2c, address, &reg, 1, true);
+    i2c_read_blocking(i2c, address, (uint8_t *)&value, 2, false);
+    return value;
+  }
+
+  void IS31FL3731::enable(std::initializer_list<uint8_t> pattern, uint8_t frame) {
+    i2c_reg_write_uint8(reg::BANK, frame);
+    uint8_t enable_buf[19];
+    enable_buf[0] = ENABLE_OFFSET;
+    uint8_t offset = 1;
+    for(auto byte : pattern) {
+      enable_buf[offset] = byte;
+      offset++;
+    }
+    i2c_write_blocking(i2c, address, enable_buf, sizeof(enable_buf), false);
+  }
+
+  void IS31FL3731::set(uint8_t index, uint8_t brightness) {
+    buf[index + 1] = GAMMA[brightness];
+  }
+
+  void IS31FL3731::update(uint8_t frame) {
+    i2c_reg_write_uint8(reg::BANK, frame);
+    buf[0] = COLOR_OFFSET;
+    i2c_write_blocking(i2c, address, buf, sizeof(buf), false);
+    i2c_reg_write_uint8(reg::BANK, CONFIG_BANK); // Switch back to config bank
+    i2c_reg_write_uint8(reg::FRAME, frame); // Set the desired frame as active
+  }
+}

drivers/is31fl3731/is31fl3731.hpp

@@ -0,0 +1,69 @@
+#pragma once
+
+#include "hardware/i2c.h"
+#include "hardware/gpio.h"
+#include <initializer_list>
+
+namespace pimoroni {
+
+  class IS31FL3731 {
+    //--------------------------------------------------
+    // Constants
+    //--------------------------------------------------
+  public:
+    static const uint8_t DEFAULT_I2C_ADDRESS      = 0x74;
+    static const uint8_t I2C_ADDRESS_ALTERNATE1   = 0x75;
+    static const uint8_t I2C_ADDRESS_ALTERNATE2   = 0x76;
+    static const uint8_t I2C_ADDRESS_ALTERNATE3   = 0x77;
+    static const uint8_t DEFAULT_SDA_PIN          = 20;
+    static const uint8_t DEFAULT_SCL_PIN          = 21;
+
+
+    //--------------------------------------------------
+    // Variables
+    //--------------------------------------------------
+  private:
+    i2c_inst_t *i2c   = i2c0;
+
+    // interface pins with our standard defaults where appropriate
+    int8_t address    = DEFAULT_I2C_ADDRESS;
+    int8_t sda        = DEFAULT_SDA_PIN;
+    int8_t scl        = DEFAULT_SCL_PIN;
+
+    uint8_t buf[145];
+
+
+    //--------------------------------------------------
+    // Constructors/Destructor
+    //--------------------------------------------------
+  public:
+    IS31FL3731() {}
+
+    IS31FL3731(uint8_t address) :
+      address(address) {}
+
+    IS31FL3731(i2c_inst_t *i2c, uint8_t address, uint8_t sda, uint8_t scl) :
+      i2c(i2c), address(address), sda(sda), scl(scl) {}
+
+
+    //--------------------------------------------------
+    // Methods
+    //--------------------------------------------------
+  public:
+    bool init();
+
+    i2c_inst_t* get_i2c() const;
+    int get_sda() const;
+    int get_scl() const;
+
+    void enable(std::initializer_list<uint8_t> pattern, uint8_t frame = 0);
+    void set(uint8_t index, uint8_t brightness);
+    void update(uint8_t frame = 0);
+    void clear();
+
+  private:
+    void i2c_reg_write_uint8(uint8_t reg, uint8_t value);
+    int16_t i2c_reg_read_int16(uint8_t reg);
+  };
+
+}

examples/CMakeLists.txt

@@ -1,4 +1,6 @@
 add_subdirectory(breakout_roundlcd)
+add_subdirectory(breakout_rgbmatrix5x5)
+add_subdirectory(breakout_matrix11x7)
 add_subdirectory(pico_display)
 add_subdirectory(pico_unicorn)
 add_subdirectory(pico_unicorn_plasma)

examples/breakout_matrix11x7/CMakeLists.txt

@@ -0,0 +1,12 @@
+set(OUTPUT_NAME matrix11x7_demo)
+
+add_executable(
+  ${OUTPUT_NAME}
+  demo.cpp
+)
+
+# Pull in pico libraries that we need
+target_link_libraries(${OUTPUT_NAME} pico_stdlib hardware_i2c breakout_matrix11x7)
+
+# create map/bin/hex file etc.
+pico_add_extra_outputs(${OUTPUT_NAME})

examples/breakout_matrix11x7/demo.cpp

@@ -0,0 +1,35 @@
+#include "pico/stdlib.h"
+
+#include "breakout_matrix11x7.hpp"
+
+using namespace pimoroni;
+
+BreakoutMatrix11x7 matrix11x7(0x75);
+
+int main() {
+  gpio_init(PICO_DEFAULT_LED_PIN);
+  gpio_set_dir(PICO_DEFAULT_LED_PIN, GPIO_OUT);
+
+  matrix11x7.init();
+
+  while(true) {
+    for(auto x = 0; x < matrix11x7.WIDTH; x++) {
+      for(auto y = 0; y < matrix11x7.HEIGHT; y++) {
+        matrix11x7.set_pixel(x, y, ((x + y) & 0b1) * 128);
+      }
+    }
+    matrix11x7.update(0);
+    gpio_put(PICO_DEFAULT_LED_PIN, true);
+    sleep_ms(1000);
+    for(auto x = 0; x < matrix11x7.WIDTH; x++) {
+      for(auto y = 0; y < matrix11x7.HEIGHT; y++) {
+        matrix11x7.set_pixel(x, y, ((x + y + 1) & 0b1) * 128);
+      }
+    }
+    matrix11x7.update(0);
+    gpio_put(PICO_DEFAULT_LED_PIN, false);
+    sleep_ms(1000);
+  }
+
+  return 0;
+}

examples/breakout_rgbmatrix5x5/CMakeLists.txt

@@ -0,0 +1,12 @@
+set(OUTPUT_NAME rgbmatrix5x5_demo)
+
+add_executable(
+  ${OUTPUT_NAME}
+  demo.cpp
+)
+
+# Pull in pico libraries that we need
+target_link_libraries(${OUTPUT_NAME} pico_stdlib hardware_i2c breakout_rgbmatrix5x5)
+
+# create map/bin/hex file etc.
+pico_add_extra_outputs(${OUTPUT_NAME})

examples/breakout_rgbmatrix5x5/demo.cpp

@@ -0,0 +1,36 @@
+#include <string.h>
+#include <math.h>
+#include <vector>
+#include <cstdlib>
+
+#include "breakout_rgbmatrix5x5.hpp"
+
+using namespace pimoroni;
+
+BreakoutRGBMatrix5x5 rgbmatrix5x5;
+
+int main() {
+  rgbmatrix5x5.init();
+
+  const pimoroni::RGBLookup colors[4] = {
+    {255, 0, 0},
+    {0, 255, 0},
+    {0, 0, 255},
+    {128, 128, 128}
+  };
+
+  uint8_t col = 0;
+  while(1) {
+    pimoroni::RGBLookup color = colors[col];
+    for(auto x = 0u; x < 5; x++) {
+      for(auto y = 0u; y < 5; y++) {
+        rgbmatrix5x5.set_pixel(x, y, color.r, color.g, color.b);
+      }
+    }
+    rgbmatrix5x5.update(0);
+    sleep_ms(1000);
+    col++;
+    col %= 4;
+  }
+  return 0;
+}

libraries/CMakeLists.txt

@@ -1,8 +1,10 @@
 add_subdirectory(breakout_roundlcd)
+add_subdirectory(breakout_rgbmatrix5x5)
+add_subdirectory(breakout_matrix11x7)
 add_subdirectory(pico_graphics)
 add_subdirectory(pico_display)
 add_subdirectory(pico_unicorn)
 add_subdirectory(pico_scroll)
 add_subdirectory(pico_explorer)
 add_subdirectory(pico_rgb_keypad)
-add_subdirectory(pico_wireless)
+add_subdirectory(pico_wireless)

libraries/breakout_matrix11x7/CMakeLists.txt

@@ -0,0 +1 @@
+include(breakout_matrix11x7.cmake)

libraries/breakout_matrix11x7/breakout_matrix11x7.cmake

@@ -0,0 +1,11 @@
+set(LIB_NAME breakout_matrix11x7)
+add_library(${LIB_NAME} INTERFACE)
+
+target_sources(${LIB_NAME} INTERFACE
+  ${CMAKE_CURRENT_LIST_DIR}/${LIB_NAME}.cpp
+)
+
+target_include_directories(${LIB_NAME} INTERFACE ${CMAKE_CURRENT_LIST_DIR})
+
+# Pull in pico libraries that we need
+target_link_libraries(${LIB_NAME} INTERFACE pico_stdlib hardware_i2c is31fl3731)

libraries/breakout_matrix11x7/breakout_matrix11x7.cpp

@@ -0,0 +1,28 @@
+#include "breakout_matrix11x7.hpp"
+
+namespace pimoroni {
+    void BreakoutMatrix11x7::init() {
+        IS31FL3731::init();
+        enable({
+            0b01111111, 0b01111111,
+            0b01111111, 0b01111111,
+            0b01111111, 0b01111111,
+            0b01111111, 0b01111111,
+            0b01111111, 0b01111111,
+            0b01111111, 0b00000000,
+            0b00000000, 0b00000000,
+            0b00000000, 0b00000000,
+            0b00000000, 0b00000000,
+        }, 0);
+    }
+
+    uint8_t BreakoutMatrix11x7::lookup_pixel(uint8_t index) {
+        return lookup_table[index];
+    }
+
+    void BreakoutMatrix11x7::set_pixel(uint8_t x, uint8_t y, uint8_t c) {
+        uint8_t i = lookup_pixel(y * WIDTH + x);
+        set(i, c);
+    }
+
+}

libraries/breakout_matrix11x7/breakout_matrix11x7.hpp

@@ -0,0 +1,35 @@
+#pragma once
+
+#include "../../drivers/is31fl3731/is31fl3731.hpp"
+
+namespace pimoroni {
+    class BreakoutMatrix11x7 : public IS31FL3731 {
+      public:
+        static constexpr uint8_t WIDTH = 11;
+        static constexpr uint8_t HEIGHT = 7;
+        static constexpr int8_t DEFAULT_I2C_ADDRESS    = 0x75;
+        static constexpr int8_t ALTERNATE_I2C_ADDRESS  = 0x77;
+
+        void init();
+
+        BreakoutMatrix11x7() : IS31FL3731(DEFAULT_I2C_ADDRESS)  {};
+        BreakoutMatrix11x7(uint8_t address) : IS31FL3731(address) {};
+        BreakoutMatrix11x7(i2c_inst_t *i2c, uint8_t address, uint8_t sda, uint8_t scl) : IS31FL3731(i2c, address, sda, scl) {};
+
+        void set_pixel(uint8_t x, uint8_t y, uint8_t c);
+
+      private:
+        uint8_t lookup_pixel(uint8_t index);
+
+        // This wonderful lookup table maps the LEDs on Matrix 11x7
+        const int8_t lookup_table[WIDTH * HEIGHT] = {
+            6, 22, 38, 54, 70, 86, 14, 30, 46, 62, 78,
+            5, 21, 37, 53, 69, 85, 13, 29, 45, 61, 77,
+            4, 20, 36, 52, 68, 84, 12, 28, 44, 60, 76,
+            3, 19, 35, 51, 67, 83, 11, 27, 43, 59, 75,
+            2, 18, 34, 50, 66, 82, 10, 26, 42, 58, 74,
+            1, 17, 33, 49, 65, 81, 9, 25, 41, 57, 73,
+            0, 16, 32, 48, 64, 80, 8, 24, 40, 56, 72
+        };
+    };
+}

libraries/breakout_rgbmatrix5x5/CMakeLists.txt

@@ -0,0 +1 @@
+include(breakout_rgbmatrix5x5.cmake)

libraries/breakout_rgbmatrix5x5/breakout_rgbmatrix5x5.cmake

@@ -0,0 +1,11 @@
+set(LIB_NAME breakout_rgbmatrix5x5)
+add_library(${LIB_NAME} INTERFACE)
+
+target_sources(${LIB_NAME} INTERFACE
+  ${CMAKE_CURRENT_LIST_DIR}/${LIB_NAME}.cpp
+)
+
+target_include_directories(${LIB_NAME} INTERFACE ${CMAKE_CURRENT_LIST_DIR})
+
+# Pull in pico libraries that we need
+target_link_libraries(${LIB_NAME} INTERFACE pico_stdlib hardware_i2c is31fl3731)

libraries/breakout_rgbmatrix5x5/breakout_rgbmatrix5x5.cpp

@@ -0,0 +1,35 @@
+#include "breakout_rgbmatrix5x5.hpp"
+
+namespace pimoroni {
+
+    void BreakoutRGBMatrix5x5::init() {
+        IS31FL3731::init();
+        enable({
+            0b00000000, 0b10111111,
+            0b00111110, 0b00111110,
+            0b00111111, 0b10111110,
+            0b00000111, 0b10000110,
+            0b00110000, 0b00110000,
+            0b00111111, 0b10111110,
+            0b00111111, 0b10111110,
+            0b01111111, 0b11111110,
+            0b01111111, 0b00000000
+        }, 0);
+    }
+
+    RGBLookup BreakoutRGBMatrix5x5::lookup_pixel(uint8_t index) {
+        return lookup_table[index];
+    }
+
+    void BreakoutRGBMatrix5x5::set_pixel(uint8_t x, uint8_t y, uint8_t r, uint8_t g, uint8_t b) {
+        if (x == 1 || x == 3) {
+            y = 4 - y;
+        }
+        uint8_t index = y + (x * 5);
+        RGBLookup rgb = lookup_pixel(index);
+        set(rgb.r, r);
+        set(rgb.g, g);
+        set(rgb.b, b);
+    }
+
+}

libraries/breakout_rgbmatrix5x5/breakout_rgbmatrix5x5.hpp

@@ -0,0 +1,62 @@
+#pragma once
+
+#include "../../drivers/is31fl3731/is31fl3731.hpp"
+
+namespace pimoroni {
+    struct RGBLookup {
+        uint8_t r;
+        uint8_t g;
+        uint8_t b;
+    };
+
+    class BreakoutRGBMatrix5x5 : public IS31FL3731 {
+      public:
+        static constexpr uint8_t WIDTH = 5;
+        static constexpr uint8_t HEIGHT = 5;
+        static constexpr int8_t DEFAULT_I2C_ADDRESS    = 0x74;
+        static constexpr int8_t ALTERNATE_I2C_ADDRESS  = 0x77;
+
+        void init();
+        void set_pixel(uint8_t x, uint8_t y, uint8_t r, uint8_t g, uint8_t b);
+  
+        BreakoutRGBMatrix5x5() : IS31FL3731(DEFAULT_I2C_ADDRESS)  {};
+        BreakoutRGBMatrix5x5(uint8_t address) : IS31FL3731(address) {};
+        BreakoutRGBMatrix5x5(i2c_inst_t *i2c, uint8_t address, uint8_t sda, uint8_t scl) : IS31FL3731(i2c, address, sda, scl) {};
+      private:
+        RGBLookup lookup_pixel(uint8_t index);
+
+        // This wonderful lookup table maps the LEDs on RGB Matrix 5x5
+        // from their 3x5x5 (remember, they're RGB) configuration to
+        // their specific location in the 144 pixel buffer.
+        const RGBLookup lookup_table[28] = {
+            {118, 69, 85},
+            {117, 68, 101},
+            {116, 84, 100},
+            {115, 83, 99},
+            {114, 82, 98},
+            {113, 81, 97},
+            {112, 80, 96},
+            {134, 21, 37},
+            {133, 20, 36},
+            {132, 19, 35},
+            {131, 18, 34},
+            {130, 17, 50},
+            {129, 33, 49},
+            {128, 32, 48},
+            {127, 47, 63},
+            {121, 41, 57},
+            {122, 25, 58},
+            {123, 26, 42},
+            {124, 27, 43},
+            {125, 28, 44},
+            {126, 29, 45},
+            {15, 95, 111},
+            {8, 89, 105},
+            {9, 90, 106},
+            {10, 91, 107},
+            {11, 92, 108},
+            {12, 76, 109},
+            {13, 77, 93},
+        };
+    };
+}

micropython/examples/breakout_matrix11x7/demo.py

@@ -0,0 +1,28 @@
+import time
+from breakout_matrix11x7 import BreakoutMatrix11x7
+
+on_brightness = 64
+
+matrix = BreakoutMatrix11x7()
+
+x = 0
+y = 0
+light = True
+
+while True:
+    if light:
+        matrix.set_pixel(x, y, on_brightness)
+    else:
+        matrix.set_pixel(x, y, 0)
+    matrix.update()
+
+    x += 1
+    if x >= matrix.WIDTH:
+        x = 0
+        y += 1
+        if y >= matrix.HEIGHT:
+            y = 0
+            light = not light
+            time.sleep(0.5)
+
+    time.sleep(0.01)

micropython/examples/breakout_rgbmatrix5x5/demo.py

@@ -0,0 +1,31 @@
+import time
+from breakout_rgbmatrix5x5 import BreakoutRGBMatrix5x5
+
+colors = []
+colors.append((255, 0, 0))
+colors.append((0, 255, 0))
+colors.append((0, 0, 255))
+colors.append((128, 128, 128))
+
+matrix = BreakoutRGBMatrix5x5()
+
+x = 0
+y = 0
+col = 0
+
+while True:
+    matrix.set_pixel(x, y, colors[col][0], colors[col][1], colors[col][2])
+    matrix.update()
+
+    x += 1
+    if x >= matrix.WIDTH:
+        x = 0
+        y += 1
+        if y >= matrix.HEIGHT:
+            y = 0
+            col += 1
+            if col >= len(colors):
+                col = 0
+            time.sleep(0.5)
+
+    time.sleep(0.01)

micropython/modules/breakout_matrix11x7/breakout_matrix11x7.c

@@ -0,0 +1,52 @@
+#include "breakout_matrix11x7.h"
+
+////////////////////////////////////////////////////////////////////////////////////////////////////
+// BreakoutMatrix11x7 Class
+////////////////////////////////////////////////////////////////////////////////////////////////////
+
+/***** Methods *****/
+MP_DEFINE_CONST_FUN_OBJ_KW(BreakoutMatrix11x7_set_pixel_obj, 1, BreakoutMatrix11x7_set_pixel);
+MP_DEFINE_CONST_FUN_OBJ_1(BreakoutMatrix11x7_update_obj, BreakoutMatrix11x7_update);
+MP_DEFINE_CONST_FUN_OBJ_1(BreakoutMatrix11x7_clear_obj, BreakoutMatrix11x7_clear);
+
+/***** Binding of Methods *****/
+STATIC const mp_rom_map_elem_t BreakoutMatrix11x7_locals_dict_table[] = {
+    { MP_ROM_QSTR(MP_QSTR_set_pixel), MP_ROM_PTR(&BreakoutMatrix11x7_set_pixel_obj) },
+    { MP_ROM_QSTR(MP_QSTR_update), MP_ROM_PTR(&BreakoutMatrix11x7_update_obj) },
+    { MP_ROM_QSTR(MP_QSTR_clear), MP_ROM_PTR(&BreakoutMatrix11x7_clear_obj) },
+    { MP_ROM_QSTR(MP_QSTR_WIDTH), MP_ROM_INT(WIDTH) },
+    { MP_ROM_QSTR(MP_QSTR_HEIGHT), MP_ROM_INT(HEIGHT) },
+};
+STATIC MP_DEFINE_CONST_DICT(BreakoutMatrix11x7_locals_dict, BreakoutMatrix11x7_locals_dict_table);
+
+/***** Class Definition *****/
+const mp_obj_type_t breakout_matrix11x7_BreakoutMatrix11x7_type = {
+    { &mp_type_type },
+    .name = MP_QSTR_breakout_matrix11x7,
+    .print = BreakoutMatrix11x7_print,
+    .make_new = BreakoutMatrix11x7_make_new,
+    .locals_dict = (mp_obj_dict_t*)&BreakoutMatrix11x7_locals_dict,
+};
+
+
+////////////////////////////////////////////////////////////////////////////////////////////////////
+// breakout_matrix11x7 Module
+////////////////////////////////////////////////////////////////////////////////////////////////////
+
+/***** Globals Table *****/
+STATIC const mp_map_elem_t breakout_matrix11x7_globals_table[] = {
+    { MP_OBJ_NEW_QSTR(MP_QSTR___name__), MP_OBJ_NEW_QSTR(MP_QSTR_breakout_matrix11x7) },
+    { MP_OBJ_NEW_QSTR(MP_QSTR_BreakoutMatrix11x7), (mp_obj_t)&breakout_matrix11x7_BreakoutMatrix11x7_type },
+};
+STATIC MP_DEFINE_CONST_DICT(mp_module_breakout_matrix11x7_globals, breakout_matrix11x7_globals_table);
+
+/***** Module Definition *****/
+const mp_obj_module_t breakout_matrix11x7_user_cmodule = {
+    .base = { &mp_type_module },
+    .globals = (mp_obj_dict_t*)&mp_module_breakout_matrix11x7_globals,
+};
+
+////////////////////////////////////////////////////////////////////////////////////////////////////
+MP_REGISTER_MODULE(MP_QSTR_breakout_matrix11x7, breakout_matrix11x7_user_cmodule, MODULE_BREAKOUT_MATRIX11X7_ENABLED);
+////////////////////////////////////////////////////////////////////////////////////////////////////
+////////////////////////////////////////////////////////////////////////////////////////////////////

micropython/modules/breakout_matrix11x7/breakout_matrix11x7.cpp

@@ -0,0 +1,150 @@
+#include "../../../libraries/breakout_matrix11x7/breakout_matrix11x7.hpp"
+
+#define MP_OBJ_TO_PTR2(o, t) ((t *)(uintptr_t)(o))
+
+// SDA/SCL on even/odd pins, I2C0/I2C1 on even/odd pairs of pins.
+#define IS_VALID_SCL(i2c, pin) (((pin) & 1) == 1 && (((pin) & 2) >> 1) == (i2c))
+#define IS_VALID_SDA(i2c, pin) (((pin) & 1) == 0 && (((pin) & 2) >> 1) == (i2c))
+
+
+using namespace pimoroni;
+
+extern "C" {
+#include "breakout_matrix11x7.h"
+
+/***** Variables Struct *****/
+typedef struct _breakout_matrix11x7_BreakoutMatrix11x7_obj_t {
+    mp_obj_base_t base;
+    BreakoutMatrix11x7 *breakout;
+} breakout_matrix11x7_BreakoutMatrix11x7_obj_t;
+
+/***** Print *****/
+void BreakoutMatrix11x7_print(const mp_print_t *print, mp_obj_t self_in, mp_print_kind_t kind) {
+    (void)kind; //Unused input parameter    
+    breakout_matrix11x7_BreakoutMatrix11x7_obj_t *self = MP_OBJ_TO_PTR2(self_in, breakout_matrix11x7_BreakoutMatrix11x7_obj_t);
+    BreakoutMatrix11x7* breakout = self->breakout;
+    mp_print_str(print, "BreakoutMatrix11x7(");
+
+    mp_print_str(print, "i2c = ");
+    mp_obj_print_helper(print, mp_obj_new_int((breakout->get_i2c() == i2c0) ? 0 : 1), PRINT_REPR);
+
+    mp_print_str(print, ", sda = ");
+    mp_obj_print_helper(print, mp_obj_new_int(breakout->get_sda()), PRINT_REPR);
+
+    mp_print_str(print, ", scl = ");
+    mp_obj_print_helper(print, mp_obj_new_int(breakout->get_scl()), PRINT_REPR);
+
+    mp_print_str(print, ")");
+}
+
+/***** Constructor *****/
+mp_obj_t BreakoutMatrix11x7_make_new(const mp_obj_type_t *type, size_t n_args, size_t n_kw, const mp_obj_t *all_args) {
+    breakout_matrix11x7_BreakoutMatrix11x7_obj_t *self = nullptr;
+
+    if(n_args == 0) {
+        mp_arg_check_num(n_args, n_kw, 0, 0, true);
+        self = m_new_obj(breakout_matrix11x7_BreakoutMatrix11x7_obj_t);
+        self->base.type = &breakout_matrix11x7_BreakoutMatrix11x7_type;
+        self->breakout = new BreakoutMatrix11x7();        
+    }
+    else if(n_args == 1) {
+        enum { ARG_address };
+        static const mp_arg_t allowed_args[] = {
+            { MP_QSTR_address, MP_ARG_REQUIRED | MP_ARG_INT },
+        };
+
+        // Parse args.
+        mp_arg_val_t args[MP_ARRAY_SIZE(allowed_args)];
+        mp_arg_parse_all_kw_array(n_args, n_kw, all_args, MP_ARRAY_SIZE(allowed_args), allowed_args, args);
+
+        self = m_new_obj(breakout_matrix11x7_BreakoutMatrix11x7_obj_t);
+        self->base.type = &breakout_matrix11x7_BreakoutMatrix11x7_type;
+        
+        self->breakout = new BreakoutMatrix11x7(args[ARG_address].u_int);     
+    }
+    else {
+        enum { ARG_i2c, ARG_address, ARG_sda, ARG_scl };
+        static const mp_arg_t allowed_args[] = {
+            { MP_QSTR_i2c, MP_ARG_REQUIRED | MP_ARG_INT },
+            { MP_QSTR_address, MP_ARG_REQUIRED | MP_ARG_INT },
+            { MP_QSTR_sda, MP_ARG_REQUIRED | MP_ARG_INT },
+            { MP_QSTR_scl, MP_ARG_REQUIRED | MP_ARG_INT },
+        };
+
+        // Parse args.
+        mp_arg_val_t args[MP_ARRAY_SIZE(allowed_args)];
+        mp_arg_parse_all_kw_array(n_args, n_kw, all_args, MP_ARRAY_SIZE(allowed_args), allowed_args, args);
+
+        // Get I2C bus.
+        int i2c_id = args[ARG_i2c].u_int;
+        if(i2c_id < 0 || i2c_id > 1) {
+            mp_raise_msg_varg(&mp_type_ValueError, MP_ERROR_TEXT("I2C(%d) doesn't exist"), i2c_id);
+        }
+
+        int sda = args[ARG_sda].u_int;
+        if (!IS_VALID_SDA(i2c_id, sda)) {
+            mp_raise_ValueError(MP_ERROR_TEXT("bad SDA pin"));
+        }
+
+        int scl = args[ARG_scl].u_int;
+        if (!IS_VALID_SCL(i2c_id, scl)) {
+            mp_raise_ValueError(MP_ERROR_TEXT("bad SCL pin"));
+        }        
+
+        self = m_new_obj(breakout_matrix11x7_BreakoutMatrix11x7_obj_t);
+        self->base.type = &breakout_matrix11x7_BreakoutMatrix11x7_type;
+        
+        i2c_inst_t *i2c = (i2c_id == 0) ? i2c0 : i2c1;
+        self->breakout = new BreakoutMatrix11x7(i2c, args[ARG_address].u_int, sda, scl);
+    }
+
+    self->breakout->init();
+
+    return MP_OBJ_FROM_PTR(self);
+}
+
+/***** Methods *****/
+mp_obj_t BreakoutMatrix11x7_set_pixel(size_t n_args, const mp_obj_t *pos_args, mp_map_t *kw_args) {
+    enum { ARG_self, ARG_x, ARG_y, ARG_val };
+    static const mp_arg_t allowed_args[] = {
+        { MP_QSTR_, MP_ARG_REQUIRED | MP_ARG_OBJ },
+        { MP_QSTR_col, MP_ARG_REQUIRED | MP_ARG_INT },
+        { MP_QSTR_row, MP_ARG_REQUIRED | MP_ARG_INT },
+        { MP_QSTR_val, MP_ARG_REQUIRED | MP_ARG_INT },
+    };
+
+    mp_arg_val_t args[MP_ARRAY_SIZE(allowed_args)];
+    mp_arg_parse_all(n_args, pos_args, kw_args, MP_ARRAY_SIZE(allowed_args), allowed_args, args);
+    
+    breakout_matrix11x7_BreakoutMatrix11x7_obj_t *self = MP_OBJ_TO_PTR2(args[ARG_self].u_obj, breakout_matrix11x7_BreakoutMatrix11x7_obj_t);
+
+    int x = args[ARG_x].u_int;
+    int y = args[ARG_y].u_int;
+    int val = args[ARG_val].u_int;
+
+    if(x < 0 || x >= BreakoutMatrix11x7::WIDTH || y < 0 || y >= BreakoutMatrix11x7::HEIGHT)
+        mp_raise_ValueError("x or y out of range.");
+    else {
+        if(val < 0 || val > 255)
+            mp_raise_ValueError("val out of range. Expected 0 to 255");
+        else
+            self->breakout->set_pixel(x, y, val);
+    }
+
+    return mp_const_none;
+}
+
+mp_obj_t BreakoutMatrix11x7_update(mp_obj_t self_in) {
+    breakout_matrix11x7_BreakoutMatrix11x7_obj_t *self = MP_OBJ_TO_PTR2(self_in, breakout_matrix11x7_BreakoutMatrix11x7_obj_t);
+    self->breakout->update();
+
+    return mp_const_none;
+}
+
+mp_obj_t BreakoutMatrix11x7_clear(mp_obj_t self_in) {
+    breakout_matrix11x7_BreakoutMatrix11x7_obj_t *self = MP_OBJ_TO_PTR2(self_in, breakout_matrix11x7_BreakoutMatrix11x7_obj_t);
+    self->breakout->clear();
+
+    return mp_const_none;
+}
+}

micropython/modules/breakout_matrix11x7/breakout_matrix11x7.h

@@ -0,0 +1,16 @@
+// Include MicroPython API.
+#include "py/runtime.h"
+
+/***** Constants *****/
+static const int WIDTH      = 11;
+static const int HEIGHT     = 7;
+
+/***** Extern of Class Definition *****/
+extern const mp_obj_type_t breakout_matrix11x7_BreakoutMatrix11x7_type;
+
+/***** Extern of Class Methods *****/
+extern void BreakoutMatrix11x7_print(const mp_print_t *print, mp_obj_t self_in, mp_print_kind_t kind);
+extern mp_obj_t BreakoutMatrix11x7_make_new(const mp_obj_type_t *type, size_t n_args, size_t n_kw, const mp_obj_t *all_args);
+extern mp_obj_t BreakoutMatrix11x7_set_pixel(size_t n_args, const mp_obj_t *pos_args, mp_map_t *kw_args);
+extern mp_obj_t BreakoutMatrix11x7_update(mp_obj_t self_in);
+extern mp_obj_t BreakoutMatrix11x7_clear(mp_obj_t self_in);

micropython/modules/breakout_matrix11x7/micropython.cmake

@@ -0,0 +1,20 @@
+set(MOD_NAME breakout_matrix11x7)
+string(TOUPPER ${MOD_NAME} MOD_NAME_UPPER)
+add_library(usermod_${MOD_NAME} INTERFACE)
+
+target_sources(usermod_${MOD_NAME} INTERFACE
+    ${CMAKE_CURRENT_LIST_DIR}/${MOD_NAME}.c
+    ${CMAKE_CURRENT_LIST_DIR}/${MOD_NAME}.cpp
+    ${CMAKE_CURRENT_LIST_DIR}/../../../libraries/${MOD_NAME}/${MOD_NAME}.cpp
+    ${CMAKE_CURRENT_LIST_DIR}/../../../drivers/is31fl3731/is31fl3731.cpp
+)
+
+target_include_directories(usermod_${MOD_NAME} INTERFACE
+    ${CMAKE_CURRENT_LIST_DIR}
+)
+
+target_compile_definitions(usermod_${MOD_NAME} INTERFACE
+    MODULE_${MOD_NAME_UPPER}_ENABLED=1
+)
+
+target_link_libraries(usermod INTERFACE usermod_${MOD_NAME})

micropython/modules/breakout_matrix11x7/micropython.mk

@@ -0,0 +1,13 @@
+set(MOD_NAME breakout_matrix11x7)
+PICOSCROLL_MOD_DIR := $(USERMOD_DIR)
+
+# Add our source files to the respective variables.
+SRC_USERMOD += $(PICOSCROLL_MOD_DIR)/${MOD_NAME}.c
+SRC_USERMOD_CXX += $(PICOSCROLL_MOD_DIR)/${MOD_NAME}.cpp
+
+# Add our module directory to the include path.
+CFLAGS_USERMOD += -I$(PICOSCROLL_MOD_DIR)
+CXXFLAGS_USERMOD += -I$(PICOSCROLL_MOD_DIR)
+
+# We use C++ features so have to link against the standard library.
+LDFLAGS_USERMOD += -lstdc++

micropython/modules/breakout_rgbmatrix5x5/breakout_rgbmatrix5x5.c

@@ -0,0 +1,52 @@
+#include "breakout_rgbmatrix5x5.h"
+
+////////////////////////////////////////////////////////////////////////////////////////////////////
+// BreakoutRGBMatrix5x5 Class
+////////////////////////////////////////////////////////////////////////////////////////////////////
+
+/***** Methods *****/
+MP_DEFINE_CONST_FUN_OBJ_KW(BreakoutRGBMatrix5x5_set_pixel_obj, 1, BreakoutRGBMatrix5x5_set_pixel);
+MP_DEFINE_CONST_FUN_OBJ_1(BreakoutRGBMatrix5x5_update_obj, BreakoutRGBMatrix5x5_update);
+MP_DEFINE_CONST_FUN_OBJ_1(BreakoutRGBMatrix5x5_clear_obj, BreakoutRGBMatrix5x5_clear);
+
+/***** Binding of Methods *****/
+STATIC const mp_rom_map_elem_t BreakoutRGBMatrix5x5_locals_dict_table[] = {
+    { MP_ROM_QSTR(MP_QSTR_set_pixel), MP_ROM_PTR(&BreakoutRGBMatrix5x5_set_pixel_obj) },
+    { MP_ROM_QSTR(MP_QSTR_update), MP_ROM_PTR(&BreakoutRGBMatrix5x5_update_obj) },
+    { MP_ROM_QSTR(MP_QSTR_clear), MP_ROM_PTR(&BreakoutRGBMatrix5x5_clear_obj) },
+    { MP_ROM_QSTR(MP_QSTR_WIDTH), MP_ROM_INT(WIDTH) },
+    { MP_ROM_QSTR(MP_QSTR_HEIGHT), MP_ROM_INT(HEIGHT) },
+};
+STATIC MP_DEFINE_CONST_DICT(BreakoutRGBMatrix5x5_locals_dict, BreakoutRGBMatrix5x5_locals_dict_table);
+
+/***** Class Definition *****/
+const mp_obj_type_t breakout_rgbmatrix5x5_BreakoutRGBMatrix5x5_type = {
+    { &mp_type_type },
+    .name = MP_QSTR_breakout_rgbmatrix5x5,
+    .print = BreakoutRGBMatrix5x5_print,
+    .make_new = BreakoutRGBMatrix5x5_make_new,
+    .locals_dict = (mp_obj_dict_t*)&BreakoutRGBMatrix5x5_locals_dict,
+};
+
+
+////////////////////////////////////////////////////////////////////////////////////////////////////
+// breakout_rgbmatrix5x5 Module
+////////////////////////////////////////////////////////////////////////////////////////////////////
+
+/***** Globals Table *****/
+STATIC const mp_map_elem_t breakout_rgbmatrix5x5_globals_table[] = {
+    { MP_OBJ_NEW_QSTR(MP_QSTR___name__), MP_OBJ_NEW_QSTR(MP_QSTR_breakout_rgbmatrix5x5) },
+    { MP_OBJ_NEW_QSTR(MP_QSTR_BreakoutRGBMatrix5x5), (mp_obj_t)&breakout_rgbmatrix5x5_BreakoutRGBMatrix5x5_type },
+};
+STATIC MP_DEFINE_CONST_DICT(mp_module_breakout_rgbmatrix5x5_globals, breakout_rgbmatrix5x5_globals_table);
+
+/***** Module Definition *****/
+const mp_obj_module_t breakout_rgbmatrix5x5_user_cmodule = {
+    .base = { &mp_type_module },
+    .globals = (mp_obj_dict_t*)&mp_module_breakout_rgbmatrix5x5_globals,
+};
+
+////////////////////////////////////////////////////////////////////////////////////////////////////
+MP_REGISTER_MODULE(MP_QSTR_breakout_rgbmatrix5x5, breakout_rgbmatrix5x5_user_cmodule, MODULE_BREAKOUT_RGBMATRIX5X5_ENABLED);
+////////////////////////////////////////////////////////////////////////////////////////////////////
+////////////////////////////////////////////////////////////////////////////////////////////////////

micropython/modules/breakout_rgbmatrix5x5/breakout_rgbmatrix5x5.cpp

@@ -0,0 +1,158 @@
+#include "../../../libraries/breakout_rgbmatrix5x5/breakout_rgbmatrix5x5.hpp"
+
+#define MP_OBJ_TO_PTR2(o, t) ((t *)(uintptr_t)(o))
+
+// SDA/SCL on even/odd pins, I2C0/I2C1 on even/odd pairs of pins.
+#define IS_VALID_SCL(i2c, pin) (((pin) & 1) == 1 && (((pin) & 2) >> 1) == (i2c))
+#define IS_VALID_SDA(i2c, pin) (((pin) & 1) == 0 && (((pin) & 2) >> 1) == (i2c))
+
+
+using namespace pimoroni;
+
+extern "C" {
+#include "breakout_rgbmatrix5x5.h"
+
+/***** Variables Struct *****/
+typedef struct _breakout_rgbmatrix5x5_BreakoutRGBMatrix5x5_obj_t {
+    mp_obj_base_t base;
+    BreakoutRGBMatrix5x5 *breakout;
+} breakout_rgbmatrix5x5_BreakoutRGBMatrix5x5_obj_t;
+
+/***** Print *****/
+void BreakoutRGBMatrix5x5_print(const mp_print_t *print, mp_obj_t self_in, mp_print_kind_t kind) {
+    (void)kind; //Unused input parameter    
+    breakout_rgbmatrix5x5_BreakoutRGBMatrix5x5_obj_t *self = MP_OBJ_TO_PTR2(self_in, breakout_rgbmatrix5x5_BreakoutRGBMatrix5x5_obj_t);
+    BreakoutRGBMatrix5x5* breakout = self->breakout;
+    mp_print_str(print, "BreakoutRGBMatrix5x5(");
+
+    mp_print_str(print, "i2c = ");
+    mp_obj_print_helper(print, mp_obj_new_int((breakout->get_i2c() == i2c0) ? 0 : 1), PRINT_REPR);
+
+    mp_print_str(print, ", sda = ");
+    mp_obj_print_helper(print, mp_obj_new_int(breakout->get_sda()), PRINT_REPR);
+
+    mp_print_str(print, ", scl = ");
+    mp_obj_print_helper(print, mp_obj_new_int(breakout->get_scl()), PRINT_REPR);
+
+    mp_print_str(print, ")");
+}
+
+/***** Constructor *****/
+mp_obj_t BreakoutRGBMatrix5x5_make_new(const mp_obj_type_t *type, size_t n_args, size_t n_kw, const mp_obj_t *all_args) {
+    breakout_rgbmatrix5x5_BreakoutRGBMatrix5x5_obj_t *self = nullptr;
+
+    if(n_args == 0) {
+        mp_arg_check_num(n_args, n_kw, 0, 0, true);
+        self = m_new_obj(breakout_rgbmatrix5x5_BreakoutRGBMatrix5x5_obj_t);
+        self->base.type = &breakout_rgbmatrix5x5_BreakoutRGBMatrix5x5_type;
+        self->breakout = new BreakoutRGBMatrix5x5();        
+    }
+    else if(n_args == 1) {
+        enum { ARG_address };
+        static const mp_arg_t allowed_args[] = {
+            { MP_QSTR_address, MP_ARG_REQUIRED | MP_ARG_INT },
+        };
+
+        // Parse args.
+        mp_arg_val_t args[MP_ARRAY_SIZE(allowed_args)];
+        mp_arg_parse_all_kw_array(n_args, n_kw, all_args, MP_ARRAY_SIZE(allowed_args), allowed_args, args);
+
+        self = m_new_obj(breakout_rgbmatrix5x5_BreakoutRGBMatrix5x5_obj_t);
+        self->base.type = &breakout_rgbmatrix5x5_BreakoutRGBMatrix5x5_type;
+        
+        self->breakout = new BreakoutRGBMatrix5x5(args[ARG_address].u_int);     
+    }
+    else {
+        enum { ARG_i2c, ARG_address, ARG_sda, ARG_scl };
+        static const mp_arg_t allowed_args[] = {
+            { MP_QSTR_i2c, MP_ARG_REQUIRED | MP_ARG_INT },
+            { MP_QSTR_address, MP_ARG_REQUIRED | MP_ARG_INT },
+            { MP_QSTR_sda, MP_ARG_REQUIRED | MP_ARG_INT },
+            { MP_QSTR_scl, MP_ARG_REQUIRED | MP_ARG_INT },
+        };
+
+        // Parse args.
+        mp_arg_val_t args[MP_ARRAY_SIZE(allowed_args)];
+        mp_arg_parse_all_kw_array(n_args, n_kw, all_args, MP_ARRAY_SIZE(allowed_args), allowed_args, args);
+
+        // Get I2C bus.
+        int i2c_id = args[ARG_i2c].u_int;
+        if(i2c_id < 0 || i2c_id > 1) {
+            mp_raise_msg_varg(&mp_type_ValueError, MP_ERROR_TEXT("I2C(%d) doesn't exist"), i2c_id);
+        }
+
+        int sda = args[ARG_sda].u_int;
+        if (!IS_VALID_SDA(i2c_id, sda)) {
+            mp_raise_ValueError(MP_ERROR_TEXT("bad SDA pin"));
+        }
+
+        int scl = args[ARG_scl].u_int;
+        if (!IS_VALID_SCL(i2c_id, scl)) {
+            mp_raise_ValueError(MP_ERROR_TEXT("bad SCL pin"));
+        }        
+
+        self = m_new_obj(breakout_rgbmatrix5x5_BreakoutRGBMatrix5x5_obj_t);
+        self->base.type = &breakout_rgbmatrix5x5_BreakoutRGBMatrix5x5_type;
+        
+        i2c_inst_t *i2c = (i2c_id == 0) ? i2c0 : i2c1;
+        self->breakout = new BreakoutRGBMatrix5x5(i2c, args[ARG_address].u_int, sda, scl);
+    }
+
+    self->breakout->init();
+
+    return MP_OBJ_FROM_PTR(self);
+}
+
+/***** Methods *****/
+mp_obj_t BreakoutRGBMatrix5x5_set_pixel(size_t n_args, const mp_obj_t *pos_args, mp_map_t *kw_args) {
+    enum { ARG_self, ARG_x, ARG_y, ARG_r, ARG_g, ARG_b };
+    static const mp_arg_t allowed_args[] = {
+        { MP_QSTR_, MP_ARG_REQUIRED | MP_ARG_OBJ },
+        { MP_QSTR_col, MP_ARG_REQUIRED | MP_ARG_INT },
+        { MP_QSTR_row, MP_ARG_REQUIRED | MP_ARG_INT },
+        { MP_QSTR_r, MP_ARG_REQUIRED | MP_ARG_INT },
+        { MP_QSTR_g, MP_ARG_REQUIRED | MP_ARG_INT },
+        { MP_QSTR_b, MP_ARG_REQUIRED | MP_ARG_INT },
+    };
+
+    mp_arg_val_t args[MP_ARRAY_SIZE(allowed_args)];
+    mp_arg_parse_all(n_args, pos_args, kw_args, MP_ARRAY_SIZE(allowed_args), allowed_args, args);
+    
+    breakout_rgbmatrix5x5_BreakoutRGBMatrix5x5_obj_t *self = MP_OBJ_TO_PTR2(args[ARG_self].u_obj, breakout_rgbmatrix5x5_BreakoutRGBMatrix5x5_obj_t);
+
+    int x = args[ARG_x].u_int;
+    int y = args[ARG_y].u_int;
+    int r = args[ARG_r].u_int;
+    int g = args[ARG_g].u_int;
+    int b = args[ARG_b].u_int;
+
+    if(x < 0 || x >= BreakoutRGBMatrix5x5::WIDTH || y < 0 || y >= BreakoutRGBMatrix5x5::HEIGHT)
+        mp_raise_ValueError("x or y out of range.");
+    else {
+        if(r < 0 || r > 255)
+            mp_raise_ValueError("r out of range. Expected 0 to 255");
+        else if(g < 0 || g > 255)
+            mp_raise_ValueError("g out of range. Expected 0 to 255");
+        else if(b < 0 || b > 255)
+            mp_raise_ValueError("b out of range. Expected 0 to 255");
+        else
+            self->breakout->set_pixel(x, y, r, g, b);
+    }
+
+    return mp_const_none;
+}
+
+mp_obj_t BreakoutRGBMatrix5x5_update(mp_obj_t self_in) {
+    breakout_rgbmatrix5x5_BreakoutRGBMatrix5x5_obj_t *self = MP_OBJ_TO_PTR2(self_in, breakout_rgbmatrix5x5_BreakoutRGBMatrix5x5_obj_t);
+    self->breakout->update();
+
+    return mp_const_none;
+}
+
+mp_obj_t BreakoutRGBMatrix5x5_clear(mp_obj_t self_in) {
+    breakout_rgbmatrix5x5_BreakoutRGBMatrix5x5_obj_t *self = MP_OBJ_TO_PTR2(self_in, breakout_rgbmatrix5x5_BreakoutRGBMatrix5x5_obj_t);
+    self->breakout->clear();
+
+    return mp_const_none;
+}
+}

micropython/modules/breakout_rgbmatrix5x5/breakout_rgbmatrix5x5.h

@@ -0,0 +1,16 @@
+// Include MicroPython API.
+#include "py/runtime.h"
+
+/***** Constants *****/
+static const int WIDTH      = 5;
+static const int HEIGHT     = 5;
+
+/***** Extern of Class Definition *****/
+extern const mp_obj_type_t breakout_rgbmatrix5x5_BreakoutRGBMatrix5x5_type;
+
+/***** Extern of Class Methods *****/
+extern void BreakoutRGBMatrix5x5_print(const mp_print_t *print, mp_obj_t self_in, mp_print_kind_t kind);
+extern mp_obj_t BreakoutRGBMatrix5x5_make_new(const mp_obj_type_t *type, size_t n_args, size_t n_kw, const mp_obj_t *all_args);
+extern mp_obj_t BreakoutRGBMatrix5x5_set_pixel(size_t n_args, const mp_obj_t *pos_args, mp_map_t *kw_args);
+extern mp_obj_t BreakoutRGBMatrix5x5_update(mp_obj_t self_in);
+extern mp_obj_t BreakoutRGBMatrix5x5_clear(mp_obj_t self_in);

micropython/modules/breakout_rgbmatrix5x5/micropython.cmake

@@ -0,0 +1,20 @@
+set(MOD_NAME breakout_rgbmatrix5x5)
+string(TOUPPER ${MOD_NAME} MOD_NAME_UPPER)
+add_library(usermod_${MOD_NAME} INTERFACE)
+
+target_sources(usermod_${MOD_NAME} INTERFACE
+    ${CMAKE_CURRENT_LIST_DIR}/${MOD_NAME}.c
+    ${CMAKE_CURRENT_LIST_DIR}/${MOD_NAME}.cpp
+    ${CMAKE_CURRENT_LIST_DIR}/../../../libraries/${MOD_NAME}/${MOD_NAME}.cpp
+    ${CMAKE_CURRENT_LIST_DIR}/../../../drivers/is31fl3731/is31fl3731.cpp
+)
+
+target_include_directories(usermod_${MOD_NAME} INTERFACE
+    ${CMAKE_CURRENT_LIST_DIR}
+)
+
+target_compile_definitions(usermod_${MOD_NAME} INTERFACE
+    MODULE_${MOD_NAME_UPPER}_ENABLED=1
+)
+
+target_link_libraries(usermod INTERFACE usermod_${MOD_NAME})

micropython/modules/breakout_rgbmatrix5x5/micropython.mk

@@ -0,0 +1,13 @@
+set(MOD_NAME breakout_rgbmatrix5x5)
+PICOSCROLL_MOD_DIR := $(USERMOD_DIR)
+
+# Add our source files to the respective variables.
+SRC_USERMOD += $(PICOSCROLL_MOD_DIR)/${MOD_NAME}.c
+SRC_USERMOD_CXX += $(PICOSCROLL_MOD_DIR)/${MOD_NAME}.cpp
+
+# Add our module directory to the include path.
+CFLAGS_USERMOD += -I$(PICOSCROLL_MOD_DIR)
+CXXFLAGS_USERMOD += -I$(PICOSCROLL_MOD_DIR)
+
+# We use C++ features so have to link against the standard library.
+LDFLAGS_USERMOD += -lstdc++

micropython/modules/micropython.cmake

@@ -1,4 +1,6 @@
 include(${CMAKE_CURRENT_LIST_DIR}/breakout_roundlcd/micropython.cmake)
+include(${CMAKE_CURRENT_LIST_DIR}/breakout_rgbmatrix5x5/micropython.cmake)
+include(${CMAKE_CURRENT_LIST_DIR}/breakout_matrix11x7/micropython.cmake)
 include(${CMAKE_CURRENT_LIST_DIR}/pico_scroll/micropython.cmake)
 include(${CMAKE_CURRENT_LIST_DIR}/pico_rgb_keypad/micropython.cmake)
 include(${CMAKE_CURRENT_LIST_DIR}/pico_unicorn/micropython.cmake)