Date: February 2024

Introduction

In his new two-part article (Part One, Part Two), Todd Andersen shows us how to build a microcontroller-based pinball ball detector to trigger add-ons such as toppers or enhanced lighting effects. His article focuses on building a system around an Arduino Uno microcontroller but, as he explains, other microcontrollers can be used instead.

In this addendum he examines several alternatives to the Arduino Uno, describing how they have their unique features and requirements, and provides the sketches to make them read the IR sensor input module and control the relay output module.


As only just a few pins are needed to make the Arduino-based pinball detector featured in Part One and Part Two, a few different microcontroller boards could be used instead.

In addition to the genuine Arduino Uno board, I have had success using various standalone microcontrollers, Digistump Digispark and clone boards, LilyTiny clone boards, ATtiny88 boards and clones, Arduino clone boards, and Raspberry Pi Pico.

Here are some suggestions listed from the smallest board to the largest:

  1. ATtiny85
    Click here for details of how to add this board to the Arduino IDE
    .
  2. Digistump Digispark USB-MICRO
    Follow these two Pinball News links for more detailed information: Link 1 and Link 2
    Click here and here for details of how to add this board to the Arduino IDE
    .
  3. Digistump Digispark USB-A
    Follow these two Pinball News links for more detailed information: Link 1 and Link 2
    Click here and here for details of how to add this board to the Arduino IDE
    .
  4. Digistump Digispark Pro
    Follow this link for more detailed information
    Click here and here for details of how to add this board to the Arduino IDE
    .
  5. Nano – MH-ET LIVE Attiny88
    See details below
    Click here and here for details of how to add this board to the Arduino IDE
    .
  6. Nano – Atmega328P
    Follow these Pinball News links for more detailed information: Link 1 and Link 2
    This board is supported in the standard Arduino IDE installation
    .
  7. Nano – LGT8F328P
    See details below
    Click here for details of how to add this board to the Arduino IDE
    .
  8. Raspberry Pi Pico
    See details below
    Click here for details of how to add this board to the Arduino IDE
    .
  9. Uno
    Follow these Pinball News links for more detailed information: Link 1 and Link 2
    This board is supported in the standard Arduino IDE installation

This list also, coincidentally, is listed from the hardest to the easiest to use.

Bonus board: The ‘VCC-GND Studio YD-RP2040’ is a RP2040-based Arduino Nano sized microcontroller board. And, it has an RGB LED output.

……10. Nano – YD-RP2040
………….See details below
………….Click here for details of how to add this board to the Arduino IDE

Because the YD-RP2040 is RP2040 microcontroller-based, it can be programmed much like the Raspberry Pi Pico.

This tenth bonus board is more expensive than the first eight (or nine, if you use an Uno clone board rather than a genuine Arduino Uno). It costs more than the fiver or tenner the other nine boards cost, but even with its own associated add-ons it’s still much more affordable than many commercially available pinball add-ons or toppers.

Let’s take a look at a selection of four of those alternative microcontrollers.

TINY 88 NANO

Introduction

This MH-ET LIVE Tiny88 is an ATtiny88-based microcontroller similar to the ATMega328p-based Nano microcontroller, but with fewer capabilities and at a lower price.

The MH-ET LIVE Tiny88 microcontroller
The MH-ET LIVE Tiny88 microcontroller

Boards

The ‘Tiny88’ is similar to the standard Arduino Nano (and clones) boards, but with a different pin arrangement.

Tiny88 Nano front and back
Tiny88 Nano front and back

Arduino IDE

Only a few years after its introduction, the Tiny88 microcontroller is almost fully supported in the Arduino IDE.

The microcontroller's selection in the Arduino IDE
The microcontroller’s selection in the Arduino IDE

Building

Rather than explaining further, we will get to putting together and showing the controller.

Sketch

The Tiny88 sketch below is laid out to include hardware connections. See lines #12 – #15 and #17 – #20.

The sketch for the Tiny88 microcontroller
The sketch for the Tiny88 microcontroller ball detector

Entire Sketch

You can view or copy the full sketch for the Tiny88 here.

//Tiny88PIrSens.INO


/*
Pinball News
https://www.pinballnews.com/
February, 2024
This example code is in the public domain.
*/


//Input Module pins
// irSensorPwr  =  5V 
// irSensorGnd  =  GND
int irSensorOut  =  3;

//Output Module pins
// relayPwr  =  5V
// relayPGnd  =  GND
int relayIn  =  0;

// Change as needed
int Dwell  =  777;  


// Setup
void setup ()                         
{                                     
  pinMode (irSensorOut, INPUT_PULLUP);    
    digitalWrite (irSensorOut, HIGH);
  pinMode (relayIn, OUTPUT);
    digitalWrite (relayIn, LOW); 
}                                     


// Loop
void loop ()                          
{                                     
  if (digitalRead (irSensorOut) == LOW)   
  {                                   
    digitalWrite (relayIn, HIGH);       
    digitalWrite (LED_BUILTIN, HIGH);
      delay (Dwell);                   
  }                                   
  else                                
  {                                   
    digitalWrite (relayIn, LOW);
    digitalWrite (LED_BUILTIN, LOW);        
  }                                      
}                

Finished Controller

With hardware and software together, we have a finished Tiny88 microcontroller-based prototype ball detector.

IR sensor module, relay module and Tiny88 board all powered - but not activated
IR sensor module, relay module and Tiny88 board all powered – but not activated
IR sensor module, relay module and Tiny88 board all powered and also triggered
IR sensor module, relay module and Tiny88 board all powered and also triggered

LGT8F328P NANO

Introduction

This LGT8F328P-based microcontroller is similar to ATMega328p-based microcontroller, but with additional capabilities and at a lower price.

LGT8F328P's features
LGT8F328P’s features

Boards

Some versions of this LGT8F328P module are pin-for-pin compatible with the standard Arduino Nano (and clones) board. This makes them convenient for using on some of the inexpensive Nano breakout boards available.

Tired old ATMega328p Nano board
Tired old ATMega328p Nano board
Shiny new LGT8F328P Nano board
Shiny new LGT8F328P Nano board

Breakout Boards

Several relatively-inexpensive breakout boards (a.k.a. ‘shileds’) are available to aid connections to the Nano board.

A remotely-powered Breakout board
A remotely-powered Breakout board
A simpler unpowered breakout board
A simpler unpowered breakout board

Arduino IDE

Only a few years after its introduction, the LGT8F328P microcontroller is almost fully supported in the Arduino IDE.

The microcontroller's selection in the Arduino IDE
The microcontroller’s selection in the Arduino IDE

Building

This article will be taking advantage of an already existing pinout arrangement to create our pinball controller – modified from previous articles. Rather than explaining any further, we will get to putting together and showing the controller.

Sketch

The LGT8F328P sketch below is laid out to include the hardware connections. See lines #10 – #13 and #15 – #18. For simplicity, all the connections are kept on one side of the board, with only one connection doubled-up.

The sketch for the LGT8F328 microcontroller ball detector
The sketch for the LGT8F328 microcontroller ball detector

Entire Sketch

//LGT8F328PIrSens.INO

/*
Pinball News
https://www.pinballnews.com/
February, 2024
This example code is in the public domain.
*/

//Input Module pins
// irSensorPwr  =  3.3 Volt  
// irSensorGnd  =  GND
int irSensorOut  =  A0;

//Output Module pins
// relayPwr  =  5.0 Volt
// relayPGnd  =  GND
int relayIn  =  A7;

// Change as needed
int Dwell  =  777;  

// Setup
void setup ()                         
{                                     
  pinMode (irSensorOut, INPUT_PULLUP);    
    digitalWrite (irSensorOut, HIGH);
  pinMode (relayIn, OUTPUT);
    digitalWrite (relayIn, LOW); 
}                                     

// Loop
void loop ()                          
{                                     
  if (digitalRead (irSensorOut) == LOW)   
  {                                   
    digitalWrite (relayIn, HIGH);       
    digitalWrite (LED_BUILTIN, HIGH);
      delay (Dwell);                   
  }                                   
  else                                
  {                                   
    digitalWrite (relayIn, LOW);
    digitalWrite (LED_BUILTIN, LOW);        
  }                                      
}                                     

Finished Controller

With hardware and software together, we have a finished LGT8F328P-based microcontroller prototype ball detector.

Sensor and relay modules and the LGT8F328P board all powered, but not activated
Sensor and relay modules and the LGT8F328P board all powered, but not activated
Sensor and relay modules and the LGT8F328P board all powered, and also triggered
Sensor and relay modules and the LGT8F328P board all powered, and also triggered

RASPBERRY PI PICO

Introduction

This RP2040 based microcontroller is similar to ATMega328p based microcontroller, but available at a lower price.

RP2040 features
RP2040 features

Boards

Some versions of this RP2040 microprocessor module can be used with inexpensive breakout boards.

Raspberry Pi Pico front and back
Raspberry Pi Pico front and back

Breakout Boards

Several relatively-inexpensive breakout boards are available.

A remotely-powered breakout board
A remotely-powered breakout board
An unpowered breakout board with LED indicators
An unpowered breakout board with LED indicators (shown lit for clarity)

Arduino IDE

Only a few years after its introduction, the RP2040 microcontroller is almost fully supported and compatible in the Arduino IDE software.

The Raspberry Pi Pico in the Arduino IDE
The Raspberry Pi Pico in the Arduino IDE

Building

Rather than explaining further, we will get to putting together and demonstrating the controller.

Sketch

The Raspberry Pi Pico sketch below is laid out to include hardware connections. See lines #12 – #15 and #17 – #20.

To make things simpler, connections are kept on just one side of the board, while no connections are doubled-up.

The sketch in the Arduino IDE
The sketch in the Arduino IDE

Entire Sketch

Here’s the full sketch you can copy and paste:

//RaspberryPiPicoIrSens.INO
/*
Pinball News
https://www.pinballnews.com/
February, 2024
This example code is in the public domain.
*/

//Input Module pins
// irSensorPwr  =  3v3OUT  
// irSensorGnd  =  GND
int irSensorOut  =  28;

//Output Module pins
// relayPwr  =  VBUS
// relayPGnd  =  GND
int relayIn  =  22;

// Change as needed
int Dwell  =  777;  

// Setup
void setup ()                         
{                                     
  pinMode (irSensorOut, INPUT_PULLUP);    
    digitalWrite (irSensorOut, HIGH);
  pinMode (relayIn, OUTPUT);
    digitalWrite (relayIn, LOW); 
}                                     

// Loop
void loop ()                          
{                                     
  if (digitalRead (irSensorOut) == LOW)   
  {                                   
    digitalWrite (relayIn, HIGH);
      delay (Dwell);                   
  }                                   
  else                                
  {                                   
    digitalWrite (relayIn, LOW);        
  }                                      
}                                     

Finished Controller

With hardware and software together, we have a finished RP2040-based prototype controller.

Sensor and relay modules and Pico all powered, but not activated
Sensor and relay modules and Pico all powered, but not activated
Sensor and relay modules and Pico all powered and also activated
Sensor and relay modules and Pico all powered and also activated

YD-RP2040 NANO

Introduction

The VCC-GND Studio YD-RP2040 is an RP2040-based microcontroller board similar to the ATMega328p-based Nano microcontroller board.

This board is the first used in this series of articles to include an on-board multi-colour light – its own RGB LED module.

With the use of this added LED module (called a ‘NeoPixel‘), we have switched from a behind-the-scenes controller to a module which may be playfield or backbox top mounted to add visual effect(s).

And, we don’t have to stop with the single LED NeoPixel of this module. NeoPixels come in a wide variety of forms, any of which could be added to give complex lighting effects to the playfield or backbox. The single NeoPixel is only used here as a very singular example to give you some idea of what NeoPixels can do.

The VCC-GND Studio YD-RP2040's features
The VCC-GND Studio YD-RP2040’s features

Boards

Some boards utilizing the RP2040 module, such as the ones below, include NeoPixel(s). The top board also includes a button (labelled ‘USR’) which we can use as a convenient manually-activated input device for easy prototype testing.

Boards with at least one NeoPixel
Boards with one or more NeoPixels
The features of the VCC-GND Studio YD-RP2040 board
The features of the VCC-GND Studio YD-RP2040 board

Breakout Boards

On a related note, NeoPixel breakout boards are also available for the Raspberry Pi Pico.

Raspberry Pi Pico wearing an LED matrix ‘hat’
Raspberry Pi Pico wearing an LED matrix ‘hat’

Arduino IDE

This RP2040-based microcontroller board is supported in the Arduino IDE, as a ‘Sparkfun ProMicro RP2040’ board.

The RP2040-based microcontroller board in the Arduino IDE
The RP2040-based microcontroller board in the Arduino IDE

Sketch

We will have to investigate the well-commented sketch further.

Let’s first give credit where due, to Adafruit Industries who provided their own example; the original ‘buttoncycler’ sketch.

The edited 'buttoncycler' sketch with the required library and definitions
The edited ‘buttoncycler’ sketch with the required library and definitions

This sketch requires a few things.

  • Line #34: Inclusion of the “Adafruit_NeoPixel.h” library.
    Note: If a NeoMatrix were used instead, the Adafruit_NeoMatrix.h library must be included instead.
  • Line #42: Defining of the “BUTTON_PIN”.
    Note: Do not hook a microcontroller directly to the switches on your pinball machine as damage to one or both may occur.
  • Line #44: Defining of the “PIXEL_PIN”.
    and
  • Line #46: Defining of the “PIXEL_COUNT”.

There is also a setup required for your selected NeoPixel brightness.

  • Line #66: Setting the brightness of the NeoPixel via “strip.setBrightness”.
    Note: This value is user-selectable from ‘0’ (off) to ‘255’ (maximum brightness).
The chosen brightness of 15 out of 255, for prototyping purposes
The chosen brightness of 15 out of 255, for prototyping purposes

Once defined, the brightness level is set for the entire sketch.

Shown below is the main loop where nine different lighting effects are configured in a wrap-around set. These cases can be changed and/or added to as you deem necessary.

The main loop with the different light shows
The main loop with the different light shows

The main disadvantage of this easy example is that, once started, each case must complete. That is, pushing the USR button (or triggering the input pin with a IR module) will not advance to the next light show while the previous one is still running.

Here’s the entire sketch:

// ArduinoNeoPixelButton.INO

/*
Lightly edited by Pinball News
February, 2024
*/

/*
Original example code from Adafruit Industries
Adafruit Industries
http://adafruit.com
Adafruit_NeoPixel/examples/buttoncycler
/buttoncycler.ino
*/

/*
Adafruit_NeoPixel.h
adafruit/Adafruit_NeoPixel 
https://github.com/adafruit/Adafruit_NeoPixel
*/

/*
The Magic of NeoPixels
https://learn.adafruit.com/adafruit-neopixel-uberguide/the-magic-of-neopixels
*/

// Simple demonstration on using an input device to trigger changes on your
// NeoPixels. Wire a momentary push button to connect from ground to a
// digital IO pin. When the button is pressed it will change to a new pixel
// animation. Initial state has all pixels off -- press the button once to
// start the first animation. As written, the button does not interrupt an
// animation in-progress, it works only when idle.

#include <Adafruit_NeoPixel.h>
#ifdef __AVR__
 #include <avr/power.h> // Required for 16 MHz Adafruit Trinket
#endif

// Digital IO pin connected to the button. This will be driven with a
// pull-up resistor so the switch pulls the pin to ground momentarily.
// On a high -> low transition the button press logic will execute.
#define BUTTON_PIN  24

#define PIXEL_PIN   23  // Digital IO pin connected to the NeoPixels.

#define PIXEL_COUNT 1   // Number of NeoPixels

// Declare our NeoPixel strip object:
Adafruit_NeoPixel strip(PIXEL_COUNT, PIXEL_PIN, NEO_GRB + NEO_KHZ800);
// Argument 1 = Number of pixels in NeoPixel strip
// Argument 2 = Arduino pin number (most are valid)
// Argument 3 = Pixel type flags, add together as needed:
//   NEO_KHZ800  800 KHz bitstream (most NeoPixel products w/WS2812 LEDs)
//   NEO_KHZ400  400 KHz (classic 'v1' (not v2) FLORA pixels, WS2811 drivers)
//   NEO_GRB     Pixels are wired for GRB bitstream (most NeoPixel products)
//   NEO_RGB     Pixels are wired for RGB bitstream (v1 FLORA pixels, not v2)
//   NEO_RGBW    Pixels are wired for RGBW bitstream (NeoPixel RGBW products)

boolean oldState = HIGH;
int     mode     = 0; // Currently-active animation mode, 0-9

void setup() {
  pinMode(BUTTON_PIN, INPUT_PULLUP);
  strip.begin(); // Initialize NeoPixel strip object (REQUIRED)
  strip.show(); // Initialize all pixels to 'off'
  strip.setBrightness(15); // Set BRIGHTNESS to 15 (max = 255)
}

void loop() {
  // Get current button state.
  boolean newState = digitalRead(BUTTON_PIN);

  // Check if state changed from high to low (button press).
  if((newState == LOW) && (oldState == HIGH)) {
    // Short delay to debounce button.
    delay(20);
    // Check if button is still low after debounce.
    newState = digitalRead(BUTTON_PIN);
    if(newState == LOW) {      // Yes, still low
      if(++mode > 8) mode = 0; // Advance to next mode, wrap around after #8
      switch(mode) {           // Start the new animation...
        case 0:
          colorWipe(strip.Color(  0,   0,   0), 50);    // Black/off
          break;
        case 1:
          colorWipe(strip.Color(255,   0,   0), 50);    // Red
          break;
        case 2:
          colorWipe(strip.Color(  0, 255,   0), 50);    // Green
          break;
        case 3:
          colorWipe(strip.Color(  0,   0, 255), 50);    // Blue
          break;
        case 4:
          theaterChase(strip.Color(127, 127, 127), 50); // White
          break;
        case 5:
          theaterChase(strip.Color(127,   0,   0), 50); // Red
          break;
        case 6:
          theaterChase(strip.Color(  0,   0, 127), 50); // Blue
          break;
        case 7:
          rainbow(10);
          break;
        case 8:
          theaterChaseRainbow(50);
          break;
      }
    }
  }

  // Set the last-read button state to the old state.
  oldState = newState;
}

// Fill strip pixels one after another with a color. Strip is NOT cleared
// first; anything there will be covered pixel by pixel. Pass in color
// (as a single 'packed' 32-bit value, which you can get by calling
// strip.Color(red, green, blue) as shown in the loop() function above),
// and a delay time (in milliseconds) between pixels.
void colorWipe(uint32_t color, int wait) {
  for(int i=0; i<strip.numPixels(); i++) { // For each pixel in strip...
    strip.setPixelColor(i, color);         //  Set pixel's color (in RAM)
    strip.show();                          //  Update strip to match
    delay(wait);                           //  Pause for a moment
  }
}

// Theater-marquee-style chasing lights. Pass in a color (32-bit value,
// a la strip.Color(r,g,b) as mentioned above), and a delay time (in ms)
// between frames.
void theaterChase(uint32_t color, int wait) {
  for(int a=0; a<10; a++) {  // Repeat 10 times...
    for(int b=0; b<3; b++) { //  'b' counts from 0 to 2...
      strip.clear();         //   Set all pixels in RAM to 0 (off)
      // 'c' counts up from 'b' to end of strip in steps of 3...
      for(int c=b; c<strip.numPixels(); c += 3) {
        strip.setPixelColor(c, color); // Set pixel 'c' to value 'color'
      }
      strip.show(); // Update strip with new contents
      delay(wait);  // Pause for a moment
    }
  }
}

// Rainbow cycle along whole strip. Pass delay time (in ms) between frames.
void rainbow(int wait) {
  // Hue of first pixel runs 3 complete loops through the color wheel.
  // Color wheel has a range of 65536 but it's OK if we roll over, so
  // just count from 0 to 3*65536. Adding 256 to firstPixelHue each time
  // means we'll make 3*65536/256 = 768 passes through this outer loop:
  for(long firstPixelHue = 0; firstPixelHue < 3*65536; firstPixelHue += 256) {
    for(int i=0; i<strip.numPixels(); i++) { // For each pixel in strip...
      // Offset pixel hue by an amount to make one full revolution of the
      // color wheel (range of 65536) along the length of the strip
      // (strip.numPixels() steps):
      int pixelHue = firstPixelHue + (i * 65536L / strip.numPixels());
      // strip.ColorHSV() can take 1 or 3 arguments: a hue (0 to 65535) or
      // optionally add saturation and value (brightness) (each 0 to 255).
      // Here we're using just the single-argument hue variant. The result
      // is passed through strip.gamma32() to provide 'truer' colors
      // before assigning to each pixel:
      strip.setPixelColor(i, strip.gamma32(strip.ColorHSV(pixelHue)));
    }
    strip.show(); // Update strip with new contents
    delay(wait);  // Pause for a moment
  }
}

// Rainbow-enhanced theater marquee. Pass delay time (in ms) between frames.
void theaterChaseRainbow(int wait) {
  int firstPixelHue = 0;     // First pixel starts at red (hue 0)
  for(int a=0; a<30; a++) {  // Repeat 30 times...
    for(int b=0; b<3; b++) { //  'b' counts from 0 to 2...
      strip.clear();         //   Set all pixels in RAM to 0 (off)
      // 'c' counts up from 'b' to end of strip in increments of 3...
      for(int c=b; c<strip.numPixels(); c += 3) {
        // hue of pixel 'c' is offset by an amount to make one full
        // revolution of the color wheel (range 65536) along the length
        // of the strip (strip.numPixels() steps):
        int      hue   = firstPixelHue + c * 65536L / strip.numPixels();
        uint32_t color = strip.gamma32(strip.ColorHSV(hue)); // hue -> RGB
        strip.setPixelColor(c, color); // Set pixel 'c' to value 'color'
      }
      strip.show();                // Update strip with new contents
      delay(wait);                 // Pause for a moment
      firstPixelHue += 65536 / 90; // One cycle of color wheel over 90 frames
    }
  }
}

Finished Controller

For the software portion, the “BUTTON_PIN”, “PIXEL_PIN”, “PIXEL_COUNT”, and “NeoPixel strip object” were all selected to match the hardware we are using – in this case, the VCC-GND Studio YD-RP2040.

If you wanted to use a different board or alternative NeoPixel type, you would have to select the pin values and NeoPixel object to match.

The VCC-GND Studio YD-RP2040 was chosen as an example board for its singular NeoPixel and pre-mounted user button. By referring to the previous Pinball Ball Detector set of articles in this series (Part One and Part Two) you can determine how to add the IR and relay modules to almost any controller module, and get those modules to work in conjunction with the detection of pinball(s) inside your pinball machine.

With hardware and software together, we have a finished RP2040-based prototype controller.

The YD-RP2040 board powered with NeoPixel at 'case 0' (OFF)
The YD-RP2040 board powered with NeoPixel at ‘case 0’ (OFF)

The YD-RP2040 board powered with NeoPixel at 'case 7' (Rainbow)
The YD-RP2040 board powered with NeoPixel at ‘case 7’ (Rainbow)
Load More Related Articles
  • Christian and Daniel from Pinball Brothers

    LIVE: ABBA PINBALL LAUNCH PARTY

    Welcome to this Pinball News report from the launch party for the new ABBA game from Pinba…
  • The new ABBA game from Pinball Brothers

    ABBA VOYAGE & ARRIVAL ANNOUNCED

    Pinball Brothers have released more details and pictures of their third title, based on th…
  • The Pinball News & Pinball Magazine PINcast

    MARCH 2024 PINCAST

    The start of another new month means it’s time to join Martin Ayub from Pinball News and J…
Load More By Pinball News
Load More In LEARN

Leave a Reply

Your email address will not be published. Required fields are marked *

Check Also

PINBALL BALL DETECTOR – PART ONE

Pinball add-ons, mods and toppers are increasingly popular ways to customise your machine,…