nanoFramework.Iot.Device.Mbi5027 1.2.696

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.696                
NuGet\Install-Package nanoFramework.Iot.Device.Mbi5027 -Version 1.2.696                
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.696" />                
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.696                
#r "nuget: nanoFramework.Iot.Device.Mbi5027, 1.2.696"                
#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.696

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

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.704 79 12/18/2024
1.2.696 78 12/16/2024
1.2.673 101 10/23/2024
1.2.635 107 8/30/2024
1.2.631 99 8/28/2024
1.2.590 106 7/17/2024
1.2.570 113 6/14/2024
1.2.560 105 5/29/2024
1.2.548 95 5/15/2024
1.2.436 253 11/10/2023
1.2.416 131 11/8/2023
1.2.329 167 5/26/2023
1.2.313 151 5/12/2023
1.2.302 155 5/10/2023
1.2.297 176 5/3/2023
1.2.273 243 3/17/2023
1.2.203 293 12/28/2022
1.2.159 378 11/14/2022
1.2.153 387 11/5/2022
1.2.141 408 10/25/2022
1.2.122 455 10/12/2022
1.2.114 391 10/8/2022
1.2.104 430 9/24/2022
1.2.95 451 9/22/2022
1.2.87 494 9/15/2022
1.2.73 426 9/8/2022
1.2.5 476 7/13/2022
1.1.141.41205 448 7/6/2022
1.1.116.8772 430 6/24/2022
1.1.113.2032 452 6/23/2022
1.1.58.10097 460 5/23/2022
1.1.27 471 4/26/2022
1.1.20 437 4/21/2022
1.1.3 459 4/15/2022
1.1.1 439 4/14/2022
1.0.300 457 3/31/2022
1.0.277-preview.128 123 3/26/2022
1.0.277-preview.126 125 3/25/2022
1.0.277-preview.125 116 3/25/2022
1.0.277-preview.113 121 3/20/2022
1.0.277-preview.112 116 3/19/2022
1.0.277-preview.110 117 3/18/2022
1.0.277-preview.105 121 3/15/2022
1.0.277-preview.103 124 3/14/2022
1.0.277-preview.102 114 3/11/2022
1.0.277-preview.99 130 3/10/2022
1.0.277-preview.98 126 3/8/2022
1.0.277-preview.85 126 2/25/2022
1.0.277-preview.77 118 2/18/2022
1.0.277-preview.60 137 2/4/2022
1.0.277-preview.41 135 1/28/2022
1.0.277-preview.32 137 1/27/2022
1.0.277-preview.17 140 1/24/2022
1.0.277-preview.13 131 1/21/2022
1.0.277-preview.1 131 1/11/2022
1.0.259 365 12/9/2021
1.0.221 166 10/19/2021
1.0.219 171 10/19/2021
1.0.218 196 10/18/2021
1.0.156 174 9/1/2021
1.0.155 166 8/31/2021
1.0.150 188 7/23/2021
1.0.148 173 7/22/2021
1.0.125 202 7/5/2021
1.0.119 238 6/28/2021
1.0.112 210 6/16/2021
1.0.79 184 5/26/2021