nanoFramework.Iot.Device.Mbi5027 1.2.141

Prefix Reserved
There is a newer version of this package available.
See the version list below for details.
dotnet add package nanoFramework.Iot.Device.Mbi5027 --version 1.2.141                
NuGet\Install-Package nanoFramework.Iot.Device.Mbi5027 -Version 1.2.141                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="nanoFramework.Iot.Device.Mbi5027" Version="1.2.141" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add nanoFramework.Iot.Device.Mbi5027 --version 1.2.141                
#r "nuget: nanoFramework.Iot.Device.Mbi5027, 1.2.141"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install nanoFramework.Iot.Device.Mbi5027 as a Cake Addin
#addin nuget:?package=nanoFramework.Iot.Device.Mbi5027&version=1.2.141

// Install nanoFramework.Iot.Device.Mbi5027 as a Cake Tool
#tool nuget:?package=nanoFramework.Iot.Device.Mbi5027&version=1.2.141                

MBI5027 -- 16-bit shift register with error detection

MBI5027 is a 16-bit shift register. Per the datasheet, the MBI5027 is a "16-bit Constant Current LED Sink Driver with Open/Short Circuit Detection". The Mbi5027 binding is based on and is compatible with the more general ShiftRegister binding. The Mbi5027 binding adds error detection functionality. Either binding can be used to control the MBI5027.

MBI5027

The MBI5027 is similar to the commonly used SN74HC595 shift register, with some key differences.

  • The MBI5027 has 16 inputs (and can control 16 LEDs) while the SN74HC595 has 8 outputs.
  • The MBI5027 is a current sink, which means you connect the cathode (ground), not anode (power) legs, to its pins. The current comes towards the sink, not away from it. The SN74HC595 is a current source and requires the opposite wiring due to the opposite direction of current.
  • The MBI5027 provides a configurable constant current, which means that resistors are not needed per input. A single resistor is used, connected to R-EXT, to configure the current.
  • The MBI5027 provides the ability to detect errors, per input.
  • The SN74HC595 provides a storage register clear capability, which the MBI5027 lacks.
  • The MBI5027 and SN74HC595 can be controlled by the same API for their basic operations; they are protocol compatible.

Note: The MBI5168 is an 8-bit constant current sink without error detection, making it a more direct comparison to the SN74HC595.

The MBI5027 sample demonstrates how to use the shift register. The generic shift register sample is more extensive and is compatible with the MBI5027.

Documentation

  • You can find the datasheet here
  • Purchase: Not widely available. aliexpress.com/ was used to purchase the unit used to write this binding.

Usage

The following example code demonstrates how to use the MBI5027 with its most basic functions.

Mbi5027 sr = new(Mbi5027PinMapping.Minimal);

// Light up three of first four LEDs
sr.ShiftBit(1);
sr.ShiftBit(1);
sr.ShiftBit(0);
sr.ShiftBit(1);
sr.Latch();

// Display for 1s
Thread.Sleep(1000);

// Clear register
sr.ShiftClear();

// Write to all 16 registers with two byte values
// The `false` parameter avoids latching the storage register after the first call to `ShiftByte`
sr.ShiftByte(0b_1101_1010, false);
sr.ShiftByte(0b_1010_1101);

If you want to use SPI, see the ShiftRegister binding, which includes more information on SPI.

The following image demonstrate a binary clock counting example.

binary clock counting example

Example circuit

The following breadboard circuit demonstrates the correct wiring pattern, including error detection.

MBI5027_BB_topview

It is easy to mis-wire the MBI5027. The following image captures the most basic aspects for correct configuration.

MBI5027 basic wiring

The following are key aspects to ensure are correct:

  • Pin 24 (VDD) must be wired to 5v for error correction to work correctly.
  • Pin 23 (R-EXT) must be connected to ground with a resistor, which configures the constant current.
  • Loads must connect to the MBI5027 with their cathode legs. In this example, the LED is connected to the ground rail via its anode leg and to a MBI5027 input pin via its cathode leg.

Error detection

The MBI5027 provides the ability to detect errors, per output. This is very useful for remote deployments, to determine if repairs are required (for a traffic sign, for example). The MBI5027 requires transitioning to an error detection mode to detect errors and then back to normal mode for normal operation.

The following example code demonstrates how to detect output errors with the MBI5027.

var sr = new Mbi5027(Mbi5027PinMapping.Complete);

// switch to error detection mode
sr.EnableDetectionMode();

// read error states, per output
var index = sr.BitLength - 1;
foreach (var value in sr.ReadOutputErrorStatus())
{
    Debug.WriteLine($"Bit {index--}: {value}");
}

// switch back to normal mode
sr.EnableNormalMode();

Per the datasheet, data can be shifted into the storage register while reading the output error status and before re-entering normal mode.

When all 16 outputs are in use, and no errors are detected, you will see the following output given this code. A Low state would be shown if the output is unused, is misconfigured or other error condition. You can create this situation by disconnecting one of the input connections on the MBI5027.

Bit 15: High
Bit 14: High
Bit 13: High
Bit 12: High
Bit 11: High
Bit 10: High
Bit 9: High
Bit 8: High
Bit 7: High
Bit 6: High
Bit 5: High
Bit 4: High
Bit 3: High
Bit 2: High
Bit 1: High
Bit 0: High

Note: Error detection was found to work only with 5v power. When 3.3v power was used, error detection did not work correctly.

Product Compatible and additional computed target framework versions.
.NET Framework net is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.2.673 86 10/23/2024
1.2.635 100 8/30/2024
1.2.631 90 8/28/2024
1.2.590 98 7/17/2024
1.2.570 104 6/14/2024
1.2.560 98 5/29/2024
1.2.548 88 5/15/2024
1.2.436 248 11/10/2023
1.2.416 124 11/8/2023
1.2.329 162 5/26/2023
1.2.313 146 5/12/2023
1.2.302 149 5/10/2023
1.2.297 171 5/3/2023
1.2.273 238 3/17/2023
1.2.203 288 12/28/2022
1.2.159 373 11/14/2022
1.2.153 382 11/5/2022
1.2.141 403 10/25/2022
1.2.122 450 10/12/2022
1.2.114 386 10/8/2022
1.2.104 425 9/24/2022
1.2.95 446 9/22/2022
1.2.87 489 9/15/2022
1.2.73 421 9/8/2022
1.2.5 471 7/13/2022
1.1.141.41205 443 7/6/2022
1.1.116.8772 425 6/24/2022
1.1.113.2032 446 6/23/2022
1.1.58.10097 455 5/23/2022
1.1.27 466 4/26/2022
1.1.20 432 4/21/2022
1.1.3 454 4/15/2022
1.1.1 434 4/14/2022
1.0.300 452 3/31/2022
1.0.277-preview.128 120 3/26/2022
1.0.277-preview.126 122 3/25/2022
1.0.277-preview.125 113 3/25/2022
1.0.277-preview.113 118 3/20/2022
1.0.277-preview.112 113 3/19/2022
1.0.277-preview.110 114 3/18/2022
1.0.277-preview.105 118 3/15/2022
1.0.277-preview.103 121 3/14/2022
1.0.277-preview.102 111 3/11/2022
1.0.277-preview.99 127 3/10/2022
1.0.277-preview.98 121 3/8/2022
1.0.277-preview.85 123 2/25/2022
1.0.277-preview.77 113 2/18/2022
1.0.277-preview.60 134 2/4/2022
1.0.277-preview.41 132 1/28/2022
1.0.277-preview.32 134 1/27/2022
1.0.277-preview.17 137 1/24/2022
1.0.277-preview.13 128 1/21/2022
1.0.277-preview.1 128 1/11/2022
1.0.259 358 12/9/2021
1.0.221 159 10/19/2021
1.0.219 164 10/19/2021
1.0.218 189 10/18/2021
1.0.156 167 9/1/2021
1.0.155 159 8/31/2021
1.0.150 181 7/23/2021
1.0.148 166 7/22/2021
1.0.125 195 7/5/2021
1.0.119 231 6/28/2021
1.0.112 203 6/16/2021
1.0.79 177 5/26/2021