Package: pizazz
PizazzA utility class to leverage 74HC595 shift register chips with a Raspberry Pi.The 74HC595 shift register is an incredibly useful chip. A single chip has 8 output pins which can be
controlled with only 3 input pins (excluding Vcc and Gnd of course).
That is great in itself however 595's can be daisy-chained together to give you multiples of 8 pin outputs yet still
always controlled by only 3 input pins! Wow!If you are not sure why this is useful then let me explain.I had a requirement to create a LED "Status Board" for a monitoring and automation application that I am also writing.
The status board would reflect the current operation status of things like Jenkins jobs, Github Actions, Linux services etc etc.
I needed a minimum of 16 LEDs. Now there already exists astatus boardHAT. However it only tracks 5 items (that is 10 LED's). However, each LED requires it's own GPIO and the HAT masks all other pins making them unavailable.Using the RaspberryRPi.GPIOlibrary it is possible to individually switch the 27 GPIO pins. However each LED would require
a wire from the GPIO pin. This is very physically unwieldy and clunky to control in Python.Enter the 74HC595...This class enables you to individually control any number of LEDS (or other output devices) with only 3 GPIO pins.Basic Wiring of the 74HC595 8-bit shift register to a Raspberry PiPinTagDescription1 - 7Q1 - Q7Parallel Data output pins 1-78GndGround9Q7->Serial data output pin10MRMaster Reset11SHClock pin12STLatch pin13OEOutput enable14DSSerial data input15Q0Parallel data output pin 016VccPositive voltage supplyChaining 2 or more shift registers togetherHow the register worksThe 595 has two registers (which can be thought of as “memory containers”), each with just 8 bits of data.The Shift RegisterThe Storage RegisterWhenever we apply a clock pulse to a 595, two things happen:The bits in the Shift Register move one step to the left. For example, Bit 7 accepts the value that was previously in bit 6, bit 6 gets the value of bit 5 etc.Bit 0 in the Shift Register accepts the current value on DATA pin. At the rising edge of the pulse, if the data pin is high, then a 1 gets pushed into the shift register. Otherwise, it is a 0.On enabling the Latch pin, the contents of Shift Register are copied into the Storage Register.
Each bit of the Storage Register is connected to one of the output pins Q0–Q7 of the IC, so in general, when the value in the Storage Register changes, so do the outputs.InstallationRaspberry Pi:pip3installpizazzConnecting the Raspberry PiThe 40 pins of the Raspberry Pi are GPIO, 5v, 3.3V and ground. Some of the GPIO pins can have special purposes.
However, all of them can be controlled by the RPi.GPIO Python Library.
The RPi.GPIO requires that you specify how you will identify the pins that you use. There are 2 ways:GPIO.BOARD:option specifies that you are referring to the pins by the number of the pin.BCM:option means that you are referring to the pins by the "Broadcom SOC channel" number, these are
the numbers after "GPIO"So referring to the diagram below: BCM mode GPIO2 is the same as BOARD mode pin 2Connect any GPIO's to the clock, latch and data pins of the register and connect the the 5v supply and earth
as indicated in the register diagram.
If you are connecting the outputs to LED's then you need to wire 330 ohm resistors serially to protect them in the usual way.Library Usage examplesFor more examples and usage, please refer to theWiki.https://user-images.githubusercontent.com/33905365/220999848-e6062e9d-af53-4c91-8db8-0f8b5fdf1ff3.mp4Import the libraryfrompizazz.pizazzimportHC595Instantiate the library passing the initialisation argumentsshifter=HC595(mode="BCM",data=17,clock=27,latch=18,ics=2)the 'ics' parameter defines the number of registers daisey-chained together.There are four public methods in the library:MethodDescriptionclear()sets shift and storage registers to zerotest()Cycles sequentially through all outputsset_output()explicitly sets specific pin outputsset_pattern()sets output using a bit pattern1. Using the set_output(output, mask) methodArgs:output(int) - decimal value of the binary bits you want to set to "on"mask(int) - decimal value of the binary bits to consider in this operation.Consider the following setup:Using a mask has 2 benefits:It enables the library to explicitly turn LEDS 'off'. e.g. sending an output value of 16 means turn pin 5 'on'. it has no concept of turning pin 6 'off'. Using a mask facilitates this.It isolates the pins to consider in the update. For a status board this is important. The inputs from the sensors can now be considered in isolation from the other sensors making asynchronous updates possible.Consider sensor 2:method valuesLED3LED4set_output(0, 12)OFFOFFset_output(4, 12)ONOFFset_output(8, 12)OFFONset_output(12, 12)ONONNOTE: All other LED outputs remain the same and are untouched by these operationsThis now makes programming the shift register a simple process. e.g. consider a Jenkins jobjenkins_mask=48jenkins_pass=16jenkins_fail=32# 'sensor' receives a failing indicationshifter.set_output(jenkins_fail,jenkins_mask)# 'sensor' receives a passing indicationshifter.set_output(jenkins_pass,jenkins_mask)The second value is the bit mask (similar to an IP bit mask) - Explained later2. Using the set_pattern(chip_pattern) methodArgs:chip_pattern(List or Nested List) - Bit pattern representing the pins to set 'on' or 'off'. If more than two registers are used then the pattern should be a nested list.Using the bit pattern (for a two chip configuration)shifter.set_pattern([[0,0,1,1,0,0,0,0],[0,0,0,0,0,0,0,0]])For a single chip a simple list should be used:shifter.set_pattern([0,0,1,1,0,0,0,0])DocumentationRead the DocsExample UsageCreditsChangelogAPI ReferenceWikiMetaStephen R A King :sking.github@gmail.comCreated with Cookiecutter template:version 1.2.2Digital object identifier: