Shift Registers - Tutorial 1, Absolute Addressing

1//
2//   Tutorial 1 - use of ez_SPI8 library
3//   Setup and absolute  addressing.
4//
5//   Ron D Bentley, Stafford, UK
6//   April 2021
7//
8//   This example and code is in the public domain and
9//   may be used without  restriction and without warranty.
10//
11
12#include <ez_SIPO8_lib.h>
13
14#define  max_SIPOs  1  // one 1 SIPO for this tutorial
15#define max_timers 0  // no timers  required
16
17// initiate the class for max SIPOs/timers required
18SIPO8 my_SIPOs(max_SIPOs,  max_timers);
19
20int my_LEDs;  // used to keep the SIPO bank id
21
22void setup()  {
23  Serial.begin(9600);
24  // create a bank of 1 SIPO using create_bank function:
25  // data pin, clock pin, latch pin, number of SIPO this bank
26  my_LEDs = my_SIPOs.create_bank(8,  10, 9, 1); // data pin, clock pin, latch pin, number of SIPO this bank
27  if (my_LEDs  == create_bank_failure) {
28    Serial.println(F("\
29failed to create bank"));
30    Serial.flush();
31    exit(0);
32  }
33  // print the bank data for confirmation/inspection
34  my_SIPOs.print_SIPO_data();
35}
36
37void loop() {
38  // start by setting  all SIPO outputs to low (off)
39  my_SIPOs.set_all_array_pins(LOW);
40  my_SIPOs.xfer_array(LSBFIRST);
41  do {
42    //
43    // assemble pattern 0b01010101 into the array
44    my_SIPOs.set_array_pin(0,  HIGH);
45    my_SIPOs.set_array_pin(1, LOW);
46    my_SIPOs.set_array_pin(2, HIGH);
47    my_SIPOs.set_array_pin(3, LOW);
48    my_SIPOs.set_array_pin(4, HIGH);
49    my_SIPOs.set_array_pin(5, LOW);
50    my_SIPOs.set_array_pin(6, HIGH);
51    my_SIPOs.set_array_pin(7, LOW);
52    my_SIPOs.xfer_array(MSBFIRST);  // now  move array to physical SIPO and light up the LEDs
53    delay(500);
54    // assemble  inverted pattern 0b10101010 into the array
55    my_SIPOs.set_array_pin(0, LOW);
56    my_SIPOs.set_array_pin(1, HIGH);
57    my_SIPOs.set_array_pin(2, LOW);
58    my_SIPOs.set_array_pin(3, HIGH);
59    my_SIPOs.set_array_pin(4, LOW);
60    my_SIPOs.set_array_pin(5, HIGH);
61    my_SIPOs.set_array_pin(6, LOW);
62    my_SIPOs.set_array_pin(7, HIGH);
63    my_SIPOs.xfer_array(MSBFIRST);  // now  move array to physical SIPO and light up the LEDs
64    delay(500);
65  } while  (true);
66}
67