Add binding for IS31FL3730 LED driver

src/devices/Display/Display.csproj

@@ -15,6 +15,7 @@
     <Compile Include="Large4Digit7SegmentDisplay.cs" />
     <Compile Include="BiColorBarGraph.cs" />
     <Compile Include="BarColor.cs" />
+    <Compile Include="IMatrix.cs" />
   </ItemGroup>
   <ItemGroup>
     <None Include="README.md" />

src/devices/Display/IMatrix.cs

@@ -0,0 +1,33 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+using System;
+
+namespace Iot.Device.Display
+{
+    /// <summary>
+    /// Interface for basic LED matrix functionality.
+    /// </summary>
+    public interface IMatrix
+    {
+        /// <summary>
+        /// Width (x-axis) of LED matrix.
+        /// </summary>
+        int Width { get; }
+
+        /// <summary>
+        /// Height (y-axis) of LED matrix.
+        /// </summary>
+        int Height { get; }
+
+        /// <summary>
+        /// Indexer for matrix.
+        /// </summary>
+        int this[int x, int y] { get; set; }
+
+        /// <summary>
+        /// Fill LEDs (0 is dark; 255 is all lit).
+        /// </summary>
+        public void Fill(int value);
+    }
+}

src/devices/Is31fl3730/Current.cs

@@ -0,0 +1,48 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+using System;
+using System.Device.Gpio;
+using System.Device.Spi;
+using System.Threading;
+using System.Threading.Tasks;
+using Iot.Device.Multiplexing.Utility;
+
+namespace Iot.Device.Display
+{
+    /// <summary>
+    /// Represents an IS31FL3731 LED Matrix driver
+    /// </summary>
+    public enum Current
+    {
+        /// <summary>
+        /// 5 mA
+        /// </summary>
+        CmA5 = 0b1000,
+
+        /// <summary>
+        /// 10 mA
+        /// </summary>
+        CmA10 = 0b1001,
+
+        /// <summary>
+        /// 35 mA
+        /// </summary>
+        CmA35 = 0b1110,
+
+        /// <summary>
+        /// 40 mA
+        /// </summary>
+        CmA40 = 0b0,
+
+        /// <summary>
+        /// 45 mA
+        /// </summary>
+        CMA45 = 0b0001,
+
+        /// <summary>
+        /// 75 mA
+        /// </summary>
+        CmA75 = 0b0111,
+    }
+}

src/devices/Is31fl3730/DisplayMode.cs

@@ -0,0 +1,33 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+using System;
+using System.Device.Gpio;
+using System.Device.Spi;
+using System.Threading;
+using System.Threading.Tasks;
+using Iot.Device.Multiplexing.Utility;
+
+namespace Iot.Device.Display
+{
+    /// <summary>
+    /// Represents an IS31FL3731 LED Matrix driver
+    /// </summary>
+    public enum DisplayMode
+    {
+        /// <summary>
+        /// Enable matrix one only.
+        /// </summary>
+        MatrixOneOnly = 0x0,
+
+        /// <summary>
+        /// Enable matrix two only.
+        /// </summary>
+        MatrixTwoOnly = 0x8,
+
+        /// <summary>
+        /// Enable matrix one and two.
+        /// </summary>
+        MatrixOneAndTwo = 0x18,
+    }
+}

src/devices/Is31fl3730/DotMatrix.cs

@@ -0,0 +1,98 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+using System;
+using System.Device.I2c;
+
+namespace Iot.Device.Display
+{
+    /// <summary>
+    /// Represents a virtual LED Matrix.
+    /// </summary>
+    // Datasheet: https://cdn-shop.adafruit.com/product-files/3017/31FL3730.pdf
+    // Product: https://shop.pimoroni.com/products/led-dot-matrix-breakout
+    // Related repo: https://github.com/pimoroni/microdot-phat
+    public class DotMatrix : IMatrix
+    {
+        private readonly DotMatrix5x7[] _matrices;
+
+        /// <summary>
+        /// Initialize virtual Dot Matrix.
+        /// </summary>
+        /// <param name="matrices">The  to create with.</param>
+        public DotMatrix(DotMatrix5x7[] matrices)
+        {
+            _matrices = matrices;
+            Width = DotMatrix5x7.BaseWidth * matrices.Length;
+        }
+
+        /// <inheritdoc/>
+        public int Width { get; }
+
+        /// <inheritdoc/>
+        public int Height { get; } = DotMatrix5x7.BaseHeight;
+
+        /// <summary>
+        /// Indexer for matrices.
+        /// </summary>
+        public DotMatrix5x7 this[int matrix] => _matrices[matrix];
+
+        /// <summary>
+        /// Length (or count) of matrices.
+        /// </summary>
+        public int Length => _matrices.Length;
+
+        /// <inheritdoc/>
+        public int this[int x, int y]
+        {
+            get
+            {
+                var (matrixIndex, index) = GetMatrixIndex(x, y);
+                return _matrices[matrixIndex][index, y];
+            }
+            set
+            {
+                var (matrixIndex, index) = GetMatrixIndex(x, y);
+                _matrices[matrixIndex][index, y] = value;
+            }
+        }
+
+        /// <inheritdoc/>
+        public void Fill(int value)
+        {
+            foreach (DotMatrix5x7 matrix in _matrices)
+            {
+                matrix.Fill(value);
+            }
+        }
+
+        private (int MatrixIndex, int Index) GetMatrixIndex(int x, int y)
+        {
+            if (x < 0 || x >= Width)
+            {
+                throw new ArgumentException($"{nameof(x)} value ({x}) out of range.");
+            }
+
+            if (y < 0 || y >= Height)
+            {
+                throw new ArgumentException($"{nameof(y)} value ({y}) out of range.");
+            }
+
+            int matrixIndex = x / DotMatrix5x7.BaseWidth;
+            int index = x % DotMatrix5x7.BaseWidth;
+            return (matrixIndex, index);
+        }
+
+        /// <summary>
+        /// Default Is31fl3730 initialization
+        /// </summary>
+        public static Is31fl3730 InitializeI2c(I2cDevice i2cDevice)
+        {
+            i2cDevice = i2cDevice ?? throw new ArgumentException($"{nameof(i2cDevice)} is null.");
+            Is31fl3730 is31fl3730 = new(i2cDevice);
+            is31fl3730.DisplayMode = DisplayMode.MatrixOneAndTwo;
+            is31fl3730.Initialize();
+            return is31fl3730;
+        }
+    }
+}

src/devices/Is31fl3730/DotMatrix10x7.cs

@@ -0,0 +1,53 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+using System;
+using System.Collections;
+using System.Collections.Generic;
+using System.Device.I2c;
+using System.Threading;
+
+namespace Iot.Device.Display
+{
+    /// <summary>
+    /// Represents an IS31FL3731 LED Matrix driver
+    /// </summary>
+    // Datasheet: https://cdn-shop.adafruit.com/product-files/3017/31FL3730.pdf
+    // Product: https://shop.pimoroni.com/products/led-dot-matrix-breakout
+    // Related repo: https://github.com/pimoroni/microdot-phat
+    public class DotMatrix10x7 : DotMatrix
+    {
+        /// <summary>
+        /// Initialize Dot Matrix Breakout IS31FL3730 device.
+        /// </summary>
+        /// <param name="i2cDevice">The <see cref="System.Device.I2c.I2cDevice"/> to create with.</param>
+        public DotMatrix10x7(I2cDevice i2cDevice)
+        : this(DotMatrix.InitializeI2c(i2cDevice))
+        {
+        }
+
+        /// <summary>
+        /// Initialize Dot Matrix Breakout IS31FL3730 device.
+        /// </summary>
+        /// <param name="is31fl3730">The <see cref="Iot.Device.Display.Is31fl3730"/> to create with.</param>
+        public DotMatrix10x7(Is31fl3730 is31fl3730)
+        : base(Initialize(is31fl3730))
+        {
+        }
+
+        /// <summary>
+        /// Default I2C address for device.
+        /// </summary>
+        public const int DefaultI2cAddress = 0x61;
+
+        private static DotMatrix5x7[] Initialize(Is31fl3730 is31fl3730)
+        {
+            is31fl3730 = is31fl3730 ?? throw new ArgumentException($"{nameof(is31fl3730)} is null");
+            return new DotMatrix5x7[]
+            {
+                is31fl3730[1],
+                is31fl3730[0]
+            };
+        }
+    }
+}

src/devices/Is31fl3730/DotMatrix5x7.cs

@@ -0,0 +1,61 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+using System;
+using System.Collections.Generic;
+using System.Device.I2c;
+using System.Threading;
+
+namespace Iot.Device.Display
+{
+    /// <summary>
+    /// Represents LED Dot Matrix driven by IS31FL3730.
+    /// </summary>
+    public class DotMatrix5x7 : IMatrix
+    {
+        private readonly Is31fl3730 _is31fl3730;
+        private readonly int _matrix;
+
+        /// <summary>
+        /// Initialize Dot Matrix IS31FL3730 device.
+        /// </summary>
+        /// <param name="is31fl3730">The <see cref="Iot.Device.Display.Is31fl3730"/> to create with.</param>
+        /// <param name="matrix">The index of the matrix (of a pair).</param>
+        public DotMatrix5x7(Is31fl3730 is31fl3730, int matrix)
+        {
+            _is31fl3730 = is31fl3730;
+            _matrix = matrix;
+        }
+
+        /// <inheritdoc/>
+        public int Width { get; } = BaseWidth;
+
+        /// <inheritdoc/>
+        public int Height { get; } = BaseHeight;
+
+        /// <inheritdoc/>
+        public int this[int x, int y]
+        {
+            get => _is31fl3730.Read(_matrix, x, y);
+            set => _is31fl3730.Write(_matrix, x, y, value);
+        }
+
+        /// <inheritdoc/>
+        public void Fill(int value) => _is31fl3730.Fill(_matrix, value);
+
+        /// <summary>
+        /// Fill matrix (0 is dark; 1 is lit).
+        /// </summary>
+        public void WriteDecimalPoint(int value) => _is31fl3730.WriteDecimalPoint(_matrix, value);
+
+        /// <summary>
+        /// Width of LED matrix (x axis).
+        /// </summary>
+        public static readonly int BaseWidth = 5;
+
+        /// <summary>
+        /// Height of LED matrix (y axis).
+        /// </summary>
+        public static readonly int BaseHeight = 7;
+    }
+}