Custom Pinball Index - User contributions [en]

Initializing the Library

2023-07-01T17:23:08Z

DickHamill:

In the .ino file, the setup() function will initialize the RPU library and prepare the MPU for booting.

There are several options for the RPU_InitializeMPU function that allow the developer to choose how the machine will boot. <blockquote>unsigned long RPU_InitializeMPU(unsigned long initOptions=RPU_CMD_PERFORM_MPU_TEST, byte creditResetSwitch=0xFF); </blockquote>By default, the RPU_InitializeMPU function will assume that it should boot to the new code running on the Arduino. The parameters will describe the situations when the developer wants the board to boot to the original (M6800) code. <blockquote>
RPU_CMD_BOOT_ORIGINAL - This will boot to original unconditionally (disables new code completely for this install)

RPU_CMD_BOOT_ORIGINAL_IF_CREDIT_RESET - Only supported on Rev 4 or greater, boots original if the C/R button is held at power on

RPU_CMD_BOOT_ORIGINAL_IF_NOT_CREDIT_RESET - Only supported on Rev 4 or greater, boots original if the C/R button is NOT held at power on

RPU_CMD_BOOT_ORIGINAL_IF_SWITCH_CLOSED - boots to original if the switch is closed at power on

RPU_CMD_BOOT_ORIGINAL_IF_NOT_SWITCH_CLOSED - boots to original if the switch is NOT closed at power on
</blockquote>There are also parameters to control other boot behavior: <blockquote>RPU_CMD_AUTODETECT_ARCHITECTURE - For Rev 101 and greater--the code detects architecture of board (mainly for diagnostics applications)

RPU_CMD_PERFORM_MPU_TEST - perform basic tests on PIAs and return result codes </blockquote>

These defines are used as Bit flags in the first parameter of the function.

To tell the board to boot to original code if the jumper switch is not set, or the credit/reset button is held at power on, these parameters can be used:<blockquote>
RPU_InitializeMPU(RPU_CMD_BOOT_ORIGINAL_IF_CREDIT_RESET | RPU_CMD_BOOT_ORIGINAL_IF_NOT_SWITCH_CLOSED, SW_CREDIT_RESET);</blockquote>
Note: the second parameter must tell the library the ID of the Credit/Reset switch if that's being used for a boot condition.

Initializing the Library

2023-07-01T17:18:53Z

DickHamill: Created page with "In the .ino file, the setup() function will initialize the RPU library and prepare the MPU for booting. There are several options for the RPU_InitializeMPU function that allow the developer to choose how the machine will boot. ''' unsigned long RPU_InitializeMPU(unsigned long initOptions=RPU_CMD_PERFORM_MPU_TEST, byte creditResetSwitch=0xFF); ''' By default, the RPU_InitializeMPU function will assume that it should boot to the new code running on the Ardu..."

In the .ino file, the setup() function will initialize the RPU library and prepare the MPU for booting.
There are several options for the RPU_InitializeMPU function that allow the developer to choose how the machine will boot.

'''
unsigned long RPU_InitializeMPU(unsigned long initOptions=RPU_CMD_PERFORM_MPU_TEST, byte creditResetSwitch=0xFF);
'''

By default, the RPU_InitializeMPU function will assume that it should boot to the new code running on the Arduino. The parameters will describe the situations when the developer wants the board to boot to the original (M6800) code.
RPU_CMD_BOOT_ORIGINAL - This will boot to original unconditionally (disables new code completely for this install)
RPU_CMD_BOOT_ORIGINAL_IF_CREDIT_RESET - Only supported on Rev 4 or greater, boots original if the C/R button is held at power on
RPU_CMD_BOOT_ORIGINAL_IF_NOT_CREDIT_RESET - Only supported on Rev 4 or greater, boots original if the C/R button is NOT held at power on
RPU_CMD_BOOT_ORIGINAL_IF_SWITCH_CLOSED - boots to original if the switch is closed at power on
RPU_CMD_BOOT_ORIGINAL_IF_NOT_SWITCH_CLOSED - boots to original if the switch is NOT closed at power on

There are also parameters to control other boot behavior:
RPU_CMD_AUTODETECT_ARCHITECTURE - For Rev 101 and greater--the code detects architecture of board (mainly for diagnostics applications)
RPU_CMD_PERFORM_MPU_TEST - perform basic tests on PIAs and return result codes

These defines are used as Bit flags in the first parameter of the function.
To tell the board to boot to original code if the jumper switch is not set, or the credit/reset button is held at power on, these parameters can be used:
'''
RPU_InitializeMPU(RPU_CMD_BOOT_ORIGINAL_IF_CREDIT_RESET | RPU_CMD_BOOT_ORIGINAL_IF_NOT_SWITCH_CLOSED, SW_CREDIT_RESET);
'''
Note: the second parameter must tell the library the ID of the Credit/Reset switch if that's being used for a boot condition.

Software Resources

2023-07-01T17:07:42Z

DickHamill:

To facilitate the creation of games, there are a number of templates, utilities, and helper libraries available on the BSOS GitHub site.

[[Base Library Functions]]

[[Initializing the Library]]

[[Audio Functions Library]]

[[Drop Target Handler Library]]

[[Lamp Animation Helper Executable]]

[[Machine Diagnostics]]

[[Pinball Machine Base]]

Software Resources

2023-07-01T17:07:15Z

DickHamill:

To facilitate the creation of games, there are a number of templates, utilities, and helper libraries available on the BSOS GitHub site.

[[Base Library Functions]]

[Initializing the Library]

[[Audio Functions Library]]

[[Drop Target Handler Library]]

[[Lamp Animation Helper Executable]]

[[Machine Diagnostics]]

[[Pinball Machine Base]]

Part Sources

2023-06-25T14:29:13Z

DickHamill: Added parts for Rev 100+ boards

== Arduinos ==

* Arduino Nano (for [[BSOS Hardware Revisions|Rev 1]] or [[BSOS Hardware Revisions|Rev 2]])
** [https://www.amazon.com/HiLetgo-ATmega328P-Controller-Development-Unsoldered/dp/B01DLIJQA2/ On Amazon] - currently $17.49 for 3 (search for "Arduino Nano ATmega328P CH340G")
* Mega 2560 Pro (for [[BSOS Hardware Revisions|Rev 3]] or greater, or [[BSOS Hardware Revisions|RPG]] board)
** [[https://www.aliexpress.us/item/3256804647334883.html via Ali Express]] - currently $9.55 each (Still being tested by Mike)
** [https://www.amazon.com/SongHe-ATMEGA2560-16AU-Pinheaders-Compatible-Mega2560/dp/B07TGF9VMQ/ On Amazon] - currently $17.99 each (search for "Arduino MEGA 2560 Pro")

== Female Connectors for Arduino MEGA 2560 Pro ==

* Configuration 1
** Qty 1 - 2x5 pin connector (to add to a 2x16 for the 2x21 connector)
*** [https://www.mouser.com/ProductDetail/3M-Electronic-Solutions-Division/929852-01-05-RA?qs=neFkstNq%252B6Ex1fEfkze0Fg%3D%3D&countryCode=US&currencyCode=USD Mouser] - currently $2.42 each
*** [https://www.digikey.com/en/products/detail/3m/929852-01-05-10/682218 Digikey] - currently $1.27 each
** Qty 2 - 2x16 pin connectors
*** [https://www.mouser.com/ProductDetail/3M-Electronic-Solutions-Division/929852-01-16-RA?qs=neFkstNq%252B6FJU7HdNnS4aQ%3D%3D&countryCode=US&currencyCode=USD Mouser] - currently $4.34 each
*** [https://www.digikey.com/en/products/detail/3m/929852-01-16-10/682229 Digikey] - currently $3.51 each
** Qty 2 - 2x3 pin connector
*** [https://www.mouser.com/ProductDetail/3M-Electronic-Solutions-Division/929852-01-03-RA?qs=neFkstNq%252B6F%252BzjJp1uEEhA%3D%3D&countryCode=US&currencyCode=USD Mouser] - currently $2.10 each
*** [https://www.digikey.com/en/products/detail/3m/929852-01-03-10/682216 Digikey] - currently $0.76 each
* Configuration 2
** Qty 1 - 2x21 pin connector
*** [https://www.digikey.com/en/products/detail/3m/929852-01-21-10/682234 Digikey] - currently $4.60 each
** Qty 1 - 2x16 pin connectors
*** [https://www.mouser.com/ProductDetail/3M-Electronic-Solutions-Division/929852-01-16-RA?qs=neFkstNq%252B6FJU7HdNnS4aQ%3D%3D&countryCode=US&currencyCode=USD Mouser] - currently $4.34 each
*** [https://www.digikey.com/en/products/detail/3m/929852-01-16-10/682229 Digikey] - currently $3.51 each
** Qty 2 - 2x3 pin connector
*** [https://www.mouser.com/ProductDetail/3M-Electronic-Solutions-Division/929852-01-03-RA?qs=neFkstNq%252B6F%252BzjJp1uEEhA%3D%3D&countryCode=US&currencyCode=USD Mouser] - currently $2.10 each
*** [https://www.digikey.com/en/products/detail/3m/929852-01-03-10/682216 Digikey] - currently $0.76 each

== Parts for Rev 100+ boards ==

* Male socket pins (2.54mm Male 40 Pin Single Row Straight Round Pin Header Strip 1*40P):
** https://www.aliexpress.us/item/2251832506677289.html?gatewayAdapt=glo2usa4itemAdapt
* 40-pin CPU sockets
** (wiper) https://www.digikey.com/en/products/detail/cnc-tech/245-40-1-06/3441588
** (round - machine pin) https://www.digikey.com/en/products/detail/adam-tech/ICM-640-1-GT-HT/9832971
** (round - machine pin) https://www.mouser.com/ProductDetail/Mill-Max/110-99-640-41-001000?qs=WZeyYeqMOWfGzlTYkXtFyQ%3D%3D

== WAV Trigger Holder ==
If you have access to a 3D printer, [https://pinballrefresh.com/s/WAV_Trigger_Mount.stl WAV Trigger Mount] is a printable bracket to mount the WAV Trigger with adhesive or cable ties (created by @turren).

== WiFi Module (Rev 4 and above) ==
Wifi Module for connecting to a scoring server: https://www.amazon.com/gp/product/B07BK435ZW/

== OLED Display (Rev 4 and above) ==
Display for diagnostics: https://www.amazon.com/gp/product/B08J1D212N/

BSOS Hardware Revisions

2023-06-24T16:23:42Z

DickHamill: DickHamill moved page BSOS Hardware Revisions to RPU Hardware Revisions: rebranding of BSOS to MPU

#REDIRECT [[RPU Hardware Revisions]]

RPU Hardware Revisions

2023-06-24T16:23:42Z

DickHamill: DickHamill moved page BSOS Hardware Revisions to RPU Hardware Revisions: rebranding of BSOS to MPU

= RPU Hardware Revisions =
Interfacing the Arduino to the MPU is done using the J5 connector on the board. The J5 connector is at the top of the board and it was originally meant as a diagnostic port. It contains access to all the lines needed except for the IRQ line on the original MPU's.

The hardware interface board has gone through several revisions. The original version interfaced with an Arduino Nano, though due to program space limitations and the need for additional pins current versions use the Arduino Mega 2560 Pro.
{| class="wikitable"
|+
!Board Version
!Arduino Required
!Compatible
Bally MPUs
!Compatible
Stern MPUs
!Compatible
Williams MPUs
!Bally Sound Cards
!Stern Sound Cards
!Willams Sound Cards
!Boots
Original
Code
|-
|Revision 1
|[[NANO ATMega328P]]
|AS-2518-17
AS-2518-35
|MPU-100
MPU-200
|
| -21, -50, -51
|
|
|Hardware switch
|-
|Revision 2
|[[NANO ATMega328P]]
|AS-2518-17
AS-2518-35
|MPU-100
MPU-200
|
| -21, -50, -51
|SB-100
|
|Hardware switch
|-
|Revision 3
|[[MEGA 2560 PRO]]
|AS-2518-17
AS-2518-35
|MPU-100
MPU-200
|
| -21, -50, -51
|SB-100, SB-300
|
|Hardware switch
|-
|Revision 4
|[[MEGA 2560 PRO]]
|AS-2518-17
AS-2518-35
|MPU-100
MPU-200
|
| -21, -50, -51
|SB-100, SB-300
|
|Hardware switch
or hold Credit/Reset
button on boot
|-
|Revision 101
|[[MEGA 2560 PRO]]
|AS-2518-17
AS-2518-35
|MPU-100
MPU-200
|System 4
System 6

System 6a

System 7

System 11
| -21, -50, -51
|SB-100, SB-300
|Type 1
Type 2
System 11 Sound
System 11 Music
|Hardware switch
or hold Credit/Reset
button on boot
|-
|Revision 102
(auto detects CPU)
|[https://pinballindex.com/index.php/MEGA_2560_PRO MEGA 2560 PRO]
|AS-2518-17
AS-2518-35
|MPU-100
MPU-200
|System 4
System 6

System 6a

System 7

System 11
| -21, -50, -51
|SB-100, SB-300
|Type 1
Type 2
System 11 Sound
System 11 Music
|Hardware switch
or hold Credit/Reset
button on boot
|}
[[File:Ardino-board01.jpg|thumb|Early BSOS Prototype]]
== Early Prototypes ==
The earliest versions of the BSOS system were based on breadboards - manual versions of what would eventually become Version 1.

[[File:Mega2560 Pro.jpg|thumb|Arduino Mega 2560 Pro]]
[[File:Mega-2560-Pro-Pinout.jpg|thumb|Arduino Mega 2560 Pro Pinout]]

== Version 1 ==
Revision 1 uses a 74125 buffer chip to interface an Arduino NANO to the MPU. This board works for most Bally -17, -35, and Stern -100, and -200 games, but won't allow the NANO to control the SB300 (like in Meteor and Galaxy).

== Version 2 ==
Revision 2 uses two ICs (74155 & 74240) to interface more thoroughly. It can talk to the SB300.

== Version 3 ==
Revision 3 upgrades the Arduino to a MEGA 2560 PRO and works with all Bally/Stern early SS games (NOTE: the MEGA 2560 PRO has a different layout than a typical MEGA 2560. You need a MEGA 2560 PRO with D0-D31 on the same header)

== Version 4 - in-progress ==

== IRQ Line ==
On the original MPU boards (Altek replacement boards have the IRQ line on J5) a jumper from top lead of R134 on the MPU board needs to be connected to the IRQ pin on the interface board so the Arduino can sense the interrupt line.

== WAVTrigger board ==
WAVTrigger is a separate add-on board that receives signals via a serial port and can play sounds from an SD card.

== Installing the card onto the J5 connector ==
Your MPU should be working before you attempt this step. There are some situations where you can use this daughter card without parts of your MPU functioning. For example, the new code will not require the PROMs, RAM, CRAM, or reset section of the board to be operable. However, until you know your MPU is in working order, I advise you to start there.

With the machine off, plug in your new card into J5, ensuring that the rightmost pin (pin 1) of the daughter card is connected to the rightmost pin (pin 1) of J5. The J5 connector is keyed on pin 29, for reference.

On a Bally AS-2518-17, -35, or Stern MPU-100 board, the J5 connector doesn’t contain the IRQ line. For those boards, you’ll need to run a jumper between the Arduino’s pin D2 and the top leg of R134
[[File:Interrupt Jumper.jpg|center|thumb]]

On a Stern MPU-200 or an Alltek MPU Replacement (Bally/Stern), the J5 connector is 34 pins and it contains an IRQ line on pin 34. For these boards, the daughter card can pick up the IRQ directly from the board

RPU Hardware Revisions

2023-06-24T16:22:53Z

DickHamill: /* BSOS Hardware Revisions */

Main Page

2023-06-24T16:22:07Z

DickHamill:

Note that the BSOS project has been renamed to "Retro Pin Upgrade" - This was done to avoid any intellectual property confusion/issues. Until other areas have been updated, assume any reference to BSOS is the same as RetroPin Upgrade.[[File:Bsos square.jpg|thumb]]

<strong>This is the site for RPU reference material and related things....

[[File:Ardino-board01.jpg|thumb]]

[[Introduction - What is BSOS?|Introduction - What is RPU?]]

[[BSOS System Requirements|RPU System Requirements]]

[[BSOS Hardware Revisions|RPU Hardware Revisions]]

[[BSOS Machines|List of Known RPU machines]]

[[List of known BSOS installations|List of known RPU installations]]

[[Software Resources]]

[[Part Sources]]

[[How to Build and Install on Your Machine]]

Part Sources

2023-05-15T22:25:29Z

DickHamill: Added more hardware links

== Arduinos ==

* Arduino Nano (for [[BSOS Hardware Revisions|Rev 1]] or [[BSOS Hardware Revisions|Rev 2]])
** [https://www.amazon.com/HiLetgo-ATmega328P-Controller-Development-Unsoldered/dp/B01DLIJQA2/ On Amazon] - currently $17.49 for 3 (search for "Arduino Nano ATmega328P CH340G")
* Mega 2560 Pro (for [[BSOS Hardware Revisions|Rev 3]] or greater, or [[BSOS Hardware Revisions|RPG]] board)
** [[https://www.aliexpress.us/item/3256804647334883.html via Ali Express]] - currently $9.55 each (Still being tested by Mike)
** [https://www.amazon.com/SongHe-ATMEGA2560-16AU-Pinheaders-Compatible-Mega2560/dp/B07TGF9VMQ/ On Amazon] - currently $17.99 each (search for "Arduino MEGA 2560 Pro")

== Female Connectors for Arduino MEGA 2560 Pro ==

* Configuration 1
** Qty 1 - 2x5 pin connector (to add to a 2x16 for the 2x21 connector)
*** [https://www.mouser.com/ProductDetail/3M-Electronic-Solutions-Division/929852-01-05-RA?qs=neFkstNq%252B6Ex1fEfkze0Fg%3D%3D&countryCode=US&currencyCode=USD Mouser] - currently $2.42 each
*** [https://www.digikey.com/en/products/detail/3m/929852-01-05-10/682218 Digikey] - currently $1.27 each
** Qty 2 - 2x16 pin connectors
*** [https://www.mouser.com/ProductDetail/3M-Electronic-Solutions-Division/929852-01-16-RA?qs=neFkstNq%252B6FJU7HdNnS4aQ%3D%3D&countryCode=US&currencyCode=USD Mouser] - currently $4.34 each
*** [https://www.digikey.com/en/products/detail/3m/929852-01-16-10/682229 Digikey] - currently $3.51 each
** Qty 2 - 2x3 pin connector
*** [https://www.mouser.com/ProductDetail/3M-Electronic-Solutions-Division/929852-01-03-RA?qs=neFkstNq%252B6F%252BzjJp1uEEhA%3D%3D&countryCode=US&currencyCode=USD Mouser] - currently $2.10 each
*** [https://www.digikey.com/en/products/detail/3m/929852-01-03-10/682216 Digikey] - currently $0.76 each
* Configuration 2
** Qty 1 - 2x21 pin connector
*** [https://www.digikey.com/en/products/detail/3m/929852-01-21-10/682234 Digikey] - currently $4.60 each
** Qty 1 - 2x16 pin connectors
*** [https://www.mouser.com/ProductDetail/3M-Electronic-Solutions-Division/929852-01-16-RA?qs=neFkstNq%252B6FJU7HdNnS4aQ%3D%3D&countryCode=US&currencyCode=USD Mouser] - currently $4.34 each
*** [https://www.digikey.com/en/products/detail/3m/929852-01-16-10/682229 Digikey] - currently $3.51 each
** Qty 2 - 2x3 pin connector
*** [https://www.mouser.com/ProductDetail/3M-Electronic-Solutions-Division/929852-01-03-RA?qs=neFkstNq%252B6F%252BzjJp1uEEhA%3D%3D&countryCode=US&currencyCode=USD Mouser] - currently $2.10 each
*** [https://www.digikey.com/en/products/detail/3m/929852-01-03-10/682216 Digikey] - currently $0.76 each

== WAV Trigger Holder ==
If you have access to a 3D printer, [https://pinballrefresh.com/s/WAV_Trigger_Mount.stl WAV Trigger Mount] is a printable bracket to mount the WAV Trigger with adhesive or cable ties (created by @turren).

== WiFi Module (Rev 4 and above) ==
Wifi Module for connecting to a scoring server: https://www.amazon.com/gp/product/B07BK435ZW/

== OLED Display (Rev 4 and above) ==
Display for diagnostics: https://www.amazon.com/gp/product/B08J1D212N/

RPU Hardware Revisions

2023-04-19T16:00:17Z

DickHamill: Updated revision table to conform to new naming

= BSOS Hardware Revisions =
Interfacing the Arduino to the MPU is done using the J5 connector on the board. The J5 connector is at the top of the board and it was originally meant as a diagnostic port. It contains access to all the lines needed except for the IRQ line on the original MPU's.

The hardware interface board has gone through several revisions. The original version interfaced with an Arduino Nano, though due to program space limitations and the need for additional pins current versions use the Arduino Mega 2560 Pro.
{| class="wikitable"
|+
!Board Version
!Arduino Required
!Compatible
Bally MPUs
!Compatible
Stern MPUs
!Compatible
Williams MPUs
!Bally Sound Cards
!Stern Sound Cards
!Willams Sound Cards
!Boots
Original
Code
|-
|Revision 1
|[[NANO ATMega328P]]
|AS-2518-17
AS-2518-35
|MPU-100
MPU-200
|
| -21, -50, -51
|
|
|Hardware switch
|-
|Revision 2
|[[NANO ATMega328P]]
|AS-2518-17
AS-2518-35
|MPU-100
MPU-200
|
| -21, -50, -51
|SB-100
|
|Hardware switch
|-
|Revision 3
|[[MEGA 2560 PRO]]
|AS-2518-17
AS-2518-35
|MPU-100
MPU-200
|
| -21, -50, -51
|SB-100, SB-300
|
|Hardware switch
|-
|Revision 4
|[[MEGA 2560 PRO]]
|AS-2518-17
AS-2518-35
|MPU-100
MPU-200
|
| -21, -50, -51
|SB-100, SB-300
|
|Hardware switch
or hold Credit/Reset
button on boot
|-
|Revision 101
|[[MEGA 2560 PRO]]
|AS-2518-17
AS-2518-35
|MPU-100
MPU-200
|System 4
System 6

System 6a

System 7

System 11
| -21, -50, -51
|SB-100, SB-300
|Type 1
Type 2
System 11 Sound
System 11 Music
|Hardware switch
or hold Credit/Reset
button on boot
|-
|Revision 102
(auto detects CPU)
|[https://pinballindex.com/index.php/MEGA_2560_PRO MEGA 2560 PRO]
|AS-2518-17
AS-2518-35
|MPU-100
MPU-200
|System 4
System 6

System 6a

System 7

System 11
| -21, -50, -51
|SB-100, SB-300
|Type 1
Type 2
System 11 Sound
System 11 Music
|Hardware switch
or hold Credit/Reset
button on boot
|}
[[File:Ardino-board01.jpg|thumb|Early BSOS Prototype]]
== Early Prototypes ==
The earliest versions of the BSOS system were based on breadboards - manual versions of what would eventually become Version 1.

[[File:Mega2560 Pro.jpg|thumb|Arduino Mega 2560 Pro]]
[[File:Mega-2560-Pro-Pinout.jpg|thumb|Arduino Mega 2560 Pro Pinout]]

== Version 1 ==
Revision 1 uses a 74125 buffer chip to interface an Arduino NANO to the MPU. This board works for most Bally -17, -35, and Stern -100, and -200 games, but won't allow the NANO to control the SB300 (like in Meteor and Galaxy).

== Version 2 ==
Revision 2 uses two ICs (74155 & 74240) to interface more thoroughly. It can talk to the SB300.

== Version 3 ==
Revision 3 upgrades the Arduino to a MEGA 2560 PRO and works with all Bally/Stern early SS games (NOTE: the MEGA 2560 PRO has a different layout than a typical MEGA 2560. You need a MEGA 2560 PRO with D0-D31 on the same header)

== Version 4 - in-progress ==

== IRQ Line ==
On the original MPU boards (Altek replacement boards have the IRQ line on J5) a jumper from top lead of R134 on the MPU board needs to be connected to the IRQ pin on the interface board so the Arduino can sense the interrupt line.

== WAVTrigger board ==
WAVTrigger is a separate add-on board that receives signals via a serial port and can play sounds from an SD card.

== Installing the card onto the J5 connector ==
Your MPU should be working before you attempt this step. There are some situations where you can use this daughter card without parts of your MPU functioning. For example, the new code will not require the PROMs, RAM, CRAM, or reset section of the board to be operable. However, until you know your MPU is in working order, I advise you to start there.

With the machine off, plug in your new card into J5, ensuring that the rightmost pin (pin 1) of the daughter card is connected to the rightmost pin (pin 1) of J5. The J5 connector is keyed on pin 29, for reference.

On a Bally AS-2518-17, -35, or Stern MPU-100 board, the J5 connector doesn’t contain the IRQ line. For those boards, you’ll need to run a jumper between the Arduino’s pin D2 and the top leg of R134
[[File:Interrupt Jumper.jpg|center|thumb]]

On a Stern MPU-200 or an Alltek MPU Replacement (Bally/Stern), the J5 connector is 34 pins and it contains an IRQ line on pin 34. For these boards, the daughter card can pick up the IRQ directly from the board

BSOS Machines

2023-04-19T15:53:23Z

DickHamill: Updated board version number to match new scheme

== Known BSOS Machines ==
{| class="wikitable"
|Title
|Status
|Originating Author
|Github/Other Links
|Version
|[[BSOS Hardware Revisions|Board Req'd]]
|-
|Black Jack 2020
|Released
|Dick Hamill
|https://github.com/BallySternOS/BlackJack2020
|1
|All
|-
|Black Knight 2023
|In Progress
|Dick Hamill
|
|
|101
|-
|Centaur-2022
|Released
|Ryan O'Donnell
|https://github.com/ryanjpodonnell/centaur-2022
|
|3
|-
|Eight Ball Plus
|Released
|Brian MacKay
|https://github.com/BallySternOS/Eight-Ball-Plus
|80
|3
|-
|Fireball Classic
|In Progress
|Valor Pinball
|
|
|
|-
|Flash 2023
|In Progress
|Dick Hamill
|
|
|101
|-
|Flash Gordon 2021
|Released
|Tim Murren
|https://github.com/BallySternOS/FlashGordon2021
|
|
|-
|(Beyond) Future Spa
|In Progress
|Brian MacKay
|
|
|3
|-
|Galaxy 2021
|Released
|Dick Hamill
|https://github.com/BallySternOS/Galaxy2021
|13
|3
|-
|Jungle Lord 2023
|In Progress
|Dick Hamill
|
|
|101
|-
|Lightning 2023
|In Progress
|Dick Hamill
|
|
|3
|-
|Meteor 2021
|Released
|Dick Hamill
|https://github.com/BallySternOS/Meteor2021
|8
|2
|-
|Scorpion 2022
|In Progress
|Dick Hamill
|
|
|101
|-
|[[Silverball Mania 2021]]
|Released
|Dick Hamill
|https://github.com/BallySternOS/SilverballMania2021MEGA
|2
|3
|-
|Stars 2020
|Released
|Dick Hamill
|https://github.com/BallySternOS/Stars2020-21
|6
|1
|-
|Stars 2021
|Released
|Dick Hamill
|https://github.com/BallySternOS/Stars2020-21
|2
|3
|-
|[[StarTrek 2022|Star Trek 2022]]
|In Progress
|John Turner
|
|
|
|-
|Stellar Wars 2022
|Released
|Dick Hamill
|https://github.com/BallySternOS/StellarWars2022
|1
|101
|-
|Supersonic 2022
|Released
|Dick Hamill
|https://github.com/BallySternOS/Supersonic2022
|1
|3
|-
|Trident 2020
|Released
|Dick Hamill
|https://github.com/BallySternOS/Trident2020
|2
|1
|-
|Trident 2022
|Released
|Dick Hamill
|https://github.com/BallySternOS/Trident2022
|1
|3
|-
|[[Paragon]]
|In Progress
|Mike from PinballHelp.com
|https://www.youtube.com/watch?v=4fBk7Wx4ABU&t=335s
|1
|1
|}

List of known BSOS installations

2023-01-09T00:56:31Z

DickHamill:

== Known BSOS Installations (existing games modified with BSOS) ==

Following is a list of known BSOS games and their (general) location. Many of these may be in private locations, but if there's a way to contact the owners, it may be possible to visit/demo the games.

Since this Wiki is the official BSOS Wiki, we're going to sequentially number each known instance of the game as has been submitted to us.

{| class="wikitable"
|'''Title'''
|'''Game #'''
|'''Status'''
|'''Owner'''
|'''Location'''
|'''Notes'''
|'''Link/Reference'''
|-
|[[Trident]] 2020
|
|private
|[[Mike/PinballHelp.com]]
|New Orleans, LA
|additional mods
|https://pinchurch.com
|-
|[[Trident]] 2020
|
|'''public'''
|
|Tres Bon BBQ (Harahan, LA)
|
|https://tresbonmeats.com/
|-
|[[Paragon]] 2023
|
|private
|[[Mike/PinballHelp.com]]
|New Orleans, LA
|Demo: https://www.youtube.com/watch?v=4fBk7Wx4ABU
|https://pinchurch.com
|-
|[[Silverball Mania]]
|
|private
|[[Mike/PinballHelp.com]]
|Central Arkansas
|
|https://pinchurch.com
|-
|[[Mata Hari]]
|
|private
|[[Mike/PinballHelp.com]]
|Central Arkansas
|work in progress
|https://pinchurch.com
|-
|[[Meteor]]
|
|private
|[[Mike/PinballHelp.com]]
|Central Arkansas
|work in progress
|https://pinchurch.com
|-
|[[Supersonic]]
|
|private
|[[Mike/PinballHelp.com]]
|New Orleans, LA
|work in progress
|https://pinchurch.com
|-
|Black Jack 2020
|
|'''public'''
|
|Wessie's Den
|212 Brown St Westbrook Maine
|
|-
|
|}

List of known BSOS installations

2023-01-09T00:55:24Z

DickHamill: /* Known BSOS Installations (existing games modified with BSOS) */

== Known BSOS Installations (existing games modified with BSOS) ==

Following is a list of known BSOS games and their (general) location. Many of these may be in private locations, but if there's a way to contact the owners, it may be possible to visit/demo the games.

Since this Wiki is the official BSOS Wiki, we're going to sequentially number each known instance of the game as has been submitted to us.

{| class="wikitable"
|'''Title'''
|'''Game #'''
|'''Status'''
|'''Owner'''
|'''Location'''
|'''Notes'''
|'''Link/Reference'''
|-
|Black Jack 2020
|
|'''public'''
|
|Wessie's Den
|212 Brown St Westbrook Maine
|
|-
|[[Trident]] 2020
|
|private
|[[Mike/PinballHelp.com]]
|New Orleans, LA
|additional mods
|https://pinchurch.com
|-
|[[Trident]] 2020
|
|'''public'''
|
|Tres Bon BBQ (Harahan, LA)
|
|https://tresbonmeats.com/
|-
|[[Paragon]] 2023
|
|private
|[[Mike/PinballHelp.com]]
|New Orleans, LA
|Demo: https://www.youtube.com/watch?v=4fBk7Wx4ABU
|https://pinchurch.com
|-
|[[Silverball Mania]]
|
|private
|[[Mike/PinballHelp.com]]
|Central Arkansas
|
|https://pinchurch.com
|-
|[[Mata Hari]]
|
|private
|[[Mike/PinballHelp.com]]
|Central Arkansas
|work in progress
|https://pinchurch.com
|-
|[[Meteor]]
|
|private
|[[Mike/PinballHelp.com]]
|Central Arkansas
|work in progress
|https://pinchurch.com
|-
|[[Supersonic]]
|
|private
|[[Mike/PinballHelp.com]]
|New Orleans, LA
|work in progress
|https://pinchurch.com
|-
|}

Part Sources

2023-01-06T21:44:15Z

DickHamill: Added WAV Trigger holder

== Arduinos ==

* Arduino Nano (for [[BSOS Hardware Revisions|Rev 1]] or [[BSOS Hardware Revisions|Rev 2]])
** [https://www.amazon.com/HiLetgo-ATmega328P-Controller-Development-Unsoldered/dp/B01DLIJQA2/ On Amazon] - currently $17.49 for 3 (search for "Arduino Nano ATmega328P CH340G")
* Mega 2560 Pro (for [[BSOS Hardware Revisions|Rev 3]] or greater, or [[BSOS Hardware Revisions|RPG]] board)
** [[https://www.aliexpress.us/item/3256804647334883.html via Ali Express]] - currently $9.55 each (Still being tested by Mike)
** [https://www.amazon.com/SongHe-ATMEGA2560-16AU-Pinheaders-Compatible-Mega2560/dp/B07TGF9VMQ/ On Amazon] - currently $17.99 each (search for "Arduino MEGA 2560 Pro")

== Female Connectors for Arduino MEGA 2560 Pro ==

* Configuration 1
** Qty 1 - 2x5 pin connector (to add to a 2x16 for the 2x21 connector)
*** [https://www.mouser.com/ProductDetail/3M-Electronic-Solutions-Division/929852-01-05-RA?qs=neFkstNq%252B6Ex1fEfkze0Fg%3D%3D&countryCode=US&currencyCode=USD Mouser] - currently $2.42 each
*** [https://www.digikey.com/en/products/detail/3m/929852-01-05-10/682218 Digikey] - currently $1.27 each
** Qty 2 - 2x16 pin connectors
*** [https://www.mouser.com/ProductDetail/3M-Electronic-Solutions-Division/929852-01-16-RA?qs=neFkstNq%252B6FJU7HdNnS4aQ%3D%3D&countryCode=US&currencyCode=USD Mouser] - currently $4.34 each
*** [https://www.digikey.com/en/products/detail/3m/929852-01-16-10/682229 Digikey] - currently $3.51 each
** Qty 2 - 2x3 pin connector
*** [https://www.mouser.com/ProductDetail/3M-Electronic-Solutions-Division/929852-01-03-RA?qs=neFkstNq%252B6F%252BzjJp1uEEhA%3D%3D&countryCode=US&currencyCode=USD Mouser] - currently $2.10 each
*** [https://www.digikey.com/en/products/detail/3m/929852-01-03-10/682216 Digikey] - currently $0.76 each
* Configuration 2
** Qty 1 - 2x21 pin connector
*** [https://www.digikey.com/en/products/detail/3m/929852-01-21-10/682234 Digikey] - currently $4.60 each
** Qty 1 - 2x16 pin connectors
*** [https://www.mouser.com/ProductDetail/3M-Electronic-Solutions-Division/929852-01-16-RA?qs=neFkstNq%252B6FJU7HdNnS4aQ%3D%3D&countryCode=US&currencyCode=USD Mouser] - currently $4.34 each
*** [https://www.digikey.com/en/products/detail/3m/929852-01-16-10/682229 Digikey] - currently $3.51 each
** Qty 2 - 2x3 pin connector
*** [https://www.mouser.com/ProductDetail/3M-Electronic-Solutions-Division/929852-01-03-RA?qs=neFkstNq%252B6F%252BzjJp1uEEhA%3D%3D&countryCode=US&currencyCode=USD Mouser] - currently $2.10 each
*** [https://www.digikey.com/en/products/detail/3m/929852-01-03-10/682216 Digikey] - currently $0.76 each

== WAV Trigger Holder ==
If you have access to a 3D printer, [https://pinballrefresh.com/s/WAV_Trigger_Mount.stl WAV Trigger Mount] is a printable bracket to mount the WAV Trigger with adhesive or cable ties (created by @turren).

Main Page

2023-01-06T21:31:27Z

DickHamill:

[[File:Bsos square.jpg|thumb]]

<strong>This is the site for BSOS reference material and related things....

[[File:Ardino-board01.jpg|thumb]]

[[Introduction - What is BSOS?]]

[[BSOS System Requirements]]

[[BSOS Hardware Revisions|BSOS Hardware Revisions]]

[[BSOS Machines|List of Known BSOS machines]]

[[Software Resources]]

[[Part Sources]]

[[How to Build and Install on Your Machine]]

How to Build and Install on Your Machine

2023-01-06T21:30:03Z

DickHamill: /* How to Build,Get, & Install on Your Machine */

= How to Build and Install on Your Machine =

# Purchase an Arduino Mega 2560 pro like this [https://www.amazon.com/Gowoops-ATMEGA2560-16AU-headers-Compatible-Mega2560/ one]
# Get an interface board (RoyGBev sells them on [https://pinside.com/pinball/market/shops/1304-roygbev-pinball Pinside]) If the board is pre-flashed skip the downloading and compiling sections
# Download the [[BSOS Machines|code for your game]], compile, and install it on your Ardiuno
# Install it onto your MPU board via the J5 connector
# Install a remote switch or jumper to enable/disable the original code on your machine
# [[Preparing your WAV trigger|Set up your WAV trigger to play the new sound effects]]
# Turn on the machine and play!

==Downloading and compiling the code ==
The code for the machines is written in Arduino (Based on C++)

# To download the pinball machine BSOS code, go to the GitHub repository page for the machine you are installing ([[BSOS Machines|See the list of machines and the git libraries).]] On the right side of the page, you should see a green button that says "Code". Click this button and then select "Download ZIP" from the dropdown menu. This will download a zip file containing the code and all of its associated files to your computer.
#Once the download is complete, unzip the file to a location on your computer where you want to store the code.
#Next, open the Arduino IDE. From the File menu, select "Open" and navigate to the folder where you unzipped the pinball machine BSOS code. Open the file with the ".ino" extension. This will load the code into the IDE.
#Before you can upload the code to the Arduino Mega 2560, you will need to set the correct board and serial port in the IDE. To do this, go to the Tools menu and select the "Board" and "Port" options. Choose "Arduino/Genuino Mega or Mega 2560" as the board and the serial port that your Arduino is connected to as the port.
# Finally, to upload the code to the Arduino, click the "Upload" button in the IDE (it looks like an arrow pointing to the right). This will compile the code and send it to the Arduino, where it will be run. If the upload is successful, you should see a message in the IDE indicating that it was completed.

== Installing the card onto the J5 connector==
Your MPU should be working before you attempt this step. There are some situations where you can use this daughter card without parts of your MPU functioning. For example, the new code will not require the PROMs, RAM, CRAM, or reset section of the board to be operable. However, until you know your MPU is in working order, I advise you to start there.

With the machine off, plug in your new card into J5, ensuring that the rightmost pin (pin 1) of the daughter card is connected to the rightmost pin (pin 1) of J5. The J5 connector is keyed on pin 29, for reference.

On a Bally AS-2518-17, -35, or Stern MPU-100 board, the J5 connector doesn’t contain the IRQ line. For those boards, you’ll need to run a jumper between the Arduino’s pin D2 and the top leg of R134
[[File:Instal on J5.jpg|center|thumb|J5 Install]]
[[File:Interrupt Jumper.jpg|center|thumb|Jumper to the interrupt line]]
On a Stern MPU-200 or an Alltek MPU Replacement (Bally/Stern), the J5 connector is 34 pins and it contains an IRQ line on pin 34. For these boards, the daughter card can pick up the IRQ directly from the board.

How to Build,Get, & Install on Your Machine

2023-01-06T21:29:11Z

DickHamill: DickHamill moved page How to Build,Get, & Install on Your Machine to How to Build and Install on Your Machine: simplification

#REDIRECT [[How to Build and Install on Your Machine]]

How to Build and Install on Your Machine

2023-01-06T21:29:10Z

DickHamill: DickHamill moved page How to Build,Get, & Install on Your Machine to How to Build and Install on Your Machine: simplification

= How to Build,Get, & Install on Your Machine =

# Purchase an Arduino Mega 2560 pro like this [https://www.amazon.com/Gowoops-ATMEGA2560-16AU-headers-Compatible-Mega2560/ one]
# Get an interface board (RoyGBev sells them on [https://pinside.com/pinball/market/shops/1304-roygbev-pinball Pinside]) If the board is pre-flashed skip the downloading and compiling sections
# Download the [[BSOS Machines|code for your game]], compile, and install it on your ardiuno
# Install it onto your MPU board via the J5 connector
# Install a remote switch or jumper to enable/disable the original code on your machine
# [[Preparing your WAV trigger|Set up your WAV trigger to play the new sound effects]]
# Turn on the machine and play!

==Downloading and compiling the code ==
The code for the machines is written in Arduino (Based on C++)

# To download the pinball machine BSOS code, go to the GitHub repository page for the machine you are installing ([[BSOS Machines|See the list of machines and the git libraries).]] On the right side of the page, you should see a green button that says "Code". Click this button and then select "Download ZIP" from the dropdown menu. This will download a zip file containing the code and all of its associated files to your computer.
#Once the download is complete, unzip the file to a location on your computer where you want to store the code.
#Next, open the Arduino IDE. From the File menu, select "Open" and navigate to the folder where you unzipped the pinball machine BSOS code. Open the file with the ".ino" extension. This will load the code into the IDE.
#Before you can upload the code to the Arduino Mega 2560, you will need to set the correct board and serial port in the IDE. To do this, go to the Tools menu and select the "Board" and "Port" options. Choose "Arduino/Genuino Mega or Mega 2560" as the board and the serial port that your Arduino is connected to as the port.
# Finally, to upload the code to the Arduino, click the "Upload" button in the IDE (it looks like an arrow pointing to the right). This will compile the code and send it to the Arduino, where it will be run. If the upload is successful, you should see a message in the IDE indicating that it was completed.

== Installing the card onto the J5 connector==
Your MPU should be working before you attempt this step. There are some situations where you can use this daughter card without parts of your MPU functioning. For example, the new code will not require the PROMs, RAM, CRAM, or reset section of the board to be operable. However, until you know your MPU is in working order, I advise you to start there.

With the machine off, plug in your new card into J5, ensuring that the rightmost pin (pin 1) of the daughter card is connected to the rightmost pin (pin 1) of J5. The J5 connector is keyed on pin 29, for reference.

On a Bally AS-2518-17, -35, or Stern MPU-100 board, the J5 connector doesn’t contain the IRQ line. For those boards, you’ll need to run a jumper between the Arduino’s pin D2 and the top leg of R134
[[File:Instal on J5.jpg|center|thumb|J5 Install]]
[[File:Interrupt Jumper.jpg|center|thumb|Jumper to the interrupt line]]
On a Stern MPU-200 or an Alltek MPU Replacement (Bally/Stern), the J5 connector is 34 pins and it contains an IRQ line on pin 34. For these boards, the daughter card can pick up the IRQ directly from the board.

Main Page

2023-01-06T21:28:16Z

DickHamill: Undo revision 85 by DickHamill (talk)

Main Page

2023-01-06T21:26:44Z

DickHamill:

Part Sources

2023-01-06T18:54:08Z

DickHamill: Added parts links

How to Build/Get/Install on Your Machine

2023-01-05T00:56:43Z

DickHamill: Created page with "Build a daughter card Get other components (Arduino, sound card, etc.) Load game code onto Arduino Install in your game"

Build a daughter card
Get other components (Arduino, sound card, etc.)
Load game code onto Arduino
Install in your game

Main Page

2023-01-05T00:49:58Z

DickHamill:

BSOS Machines

2023-01-05T00:32:27Z

DickHamill: /* Known BSOS Machines */ Added column for minimum required board

== Known BSOS Machines ==
{| class="wikitable"
|Title
|Status
|Originating Author
|Github/Other Links
|Version
|[[BSOS Hardware Revisions|Board Req'd]]
|-
|Black Jack 2020
|Released
|Dick Hamill
|https://github.com/BallySternOS/BlackJack2020
|1
|All
|-
|Black Knight 2023
|In Progress
|Dick Hamill
|
|
|RPG
|-
|Centaur-2022
|Released
|Ryan O'Donnell
|https://github.com/ryanjpodonnell/centaur-2022
|
|3
|-
|Eight Ball Plus
|Released
|Brian MacKay
|https://github.com/BallySternOS/Eight-Ball-Plus
|80
|3
|-
|Fireball Classic
|In Progress
|Valor Pinball
|
|
|
|-
|Flash 2023
|In Progress
|Dick Hamill
|
|
|RPG
|-
|Flash Gordon 2021
|Released
|Tim Murren
|https://github.com/BallySternOS/FlashGordon2021
|
|
|-
|(Beyond) Future Spa
|In Progress
|Brian MacKay
|
|
|3
|-
|Galaxy 2021
|Released
|Dick Hamill
|https://github.com/BallySternOS/Galaxy2021
|13
|3
|-
|Jungle Lord 2023
|In Progress
|Dick Hamill
|
|
|RPG
|-
|Lightning 2023
|In Progress
|Dick Hamill
|
|
|3
|-
|Meteor 2021
|Released
|Dick Hamill
|https://github.com/BallySternOS/Meteor2021
|8
|2
|-
|Scorpion 2022
|In Progress
|Dick Hamill
|
|
|RPG
|-
|[[Silverball Mania 2021]]
|Released
|Dick Hamill
|https://github.com/BallySternOS/SilverballMania2021MEGA
|2
|3
|-
|Stars 2020
|Released
|Dick Hamill
|https://github.com/BallySternOS/Stars2020-21
|6
|1
|-
|Stars 2021
|Released
|Dick Hamill
|https://github.com/BallySternOS/Stars2020-21
|2
|3
|-
|[[StarTrek 2022|Star Trek 2022]]
|In Progress
|John Turner
|
|
|
|-
|Stellar Wars 2022
|Released
|Dick Hamill
|https://github.com/BallySternOS/StellarWars2022
|1
|RPG
|-
|Supersonic 2022
|Released
|Dick Hamill
|https://github.com/BallySternOS/Supersonic2022
|1
|3
|-
|Trident 2020
|Released
|Dick Hamill
|https://github.com/BallySternOS/Trident2020
|2
|1
|-
|Trident 2022
|Released
|Dick Hamill
|https://github.com/BallySternOS/Trident2022
|1
|3
|-
|[[Paragon]]
|In Progress
|Mike from PinballHelp.com
|https://www.youtube.com/watch?v=4fBk7Wx4ABU&t=335s
|1
|1
|}

BSOS Machines

2023-01-03T14:41:28Z

DickHamill: Added Centaur-2022

== Known BSOS Machines ==
{| class="wikitable"
|Title
|Status
|Originating Author
|Github/Other Links
|Version
|-
|Black Jack 2020
|Released
|Dick Hamill
|https://github.com/BallySternOS/BlackJack2020
|1
|-
|Black Knight 2023
|In Progress
|Dick Hamill
|
|
|-
|Centaur-2022
|Released
|Ryan O'Donnell
|https://github.com/ryanjpodonnell/centaur-2022
|
|-
|Eight Ball Plus
|Released
|Brian MacKay
|https://github.com/BallySternOS/Eight-Ball-Plus
|80
|-
|Fireball Classic
|In Progress
|Valor Pinball
|
|
|-
|Flash 2023
|In Progress
|Dick Hamill
|
|
|-
|Flash Gordon 2021
|Released
|Tim Murren
|https://github.com/BallySternOS/FlashGordon2021
|
|-
|(Beyond) Future Spa
|In Progress
|Brian MacKay
|
|
|-
|Galaxy 2021
|Released
|Dick Hamill
|https://github.com/BallySternOS/Galaxy2021
|13
|-
|Jungle Lord 2023
|In Progress
|Dick Hamill
|
|
|-
|Lightning 2023
|In Progress
|Dick Hamill
|
|
|-
|Meteor 2021
|Released
|Dick Hamill
|https://github.com/BallySternOS/Meteor2021
|8
|-
|Scorpion 2022
|In Progress
|Dick Hamill
|
|
|-
|[[Silverball Mania 2021]]
|Released
|Dick Hamill
|https://github.com/BallySternOS/SilverballMania2021MEGA
|2
|-
|Stars 2020
|Released
|Dick Hamill
|https://github.com/BallySternOS/Stars2020-21
|6
|-
|Stars 2021
|Released
|Dick Hamill
|https://github.com/BallySternOS/Stars2020-21
|2
|-
|[[StarTrek 2022|Star Trek 2022]]
|In Progress
|John Turner
|
|
|-
|Stellar Wars 2022
|Released
|Dick Hamill
|https://github.com/BallySternOS/StellarWars2022
|1
|-
|Supersonic 2022
|Released
|Dick Hamill
|https://github.com/BallySternOS/Supersonic2022
|1
|-
|Trident 2020
|Released
|Dick Hamill
|https://github.com/BallySternOS/Trident2020
|2
|-
|Trident 2022
|Released
|Dick Hamill
|https://github.com/BallySternOS/Trident2022
|1
|-
|[[Paragon]]
|In Progress
|Mike from PinballHelp.com
|https://www.youtube.com/watch?v=4fBk7Wx4ABU&t=335s
|1

|}

BSOS Machines

2022-12-20T04:41:22Z

DickHamill:

== Known BSOS Machines ==
{| class="wikitable"
|Title
|Status
|Originating Author
|Github/Other Links
|Version
|-
|Black Jack 2020
|Released
|Dick Hamill
|https://github.com/BallySternOS/BlackJack2020
|1
|-
|Black Knight 2023
|In Progress
|Dick Hamill
|
|
|-
|Eight Ball Plus
|Released
|Brian MacKay
|https://github.com/BallySternOS/Eight-Ball-Plus
|80
|-
|Fireball Classic
|In Progress
|Valor Pinball
|
|
|-
|Flash 2023
|In Progress
|Dick Hamill
|
|
|-
|Flash Gordon 2021
|Released
|Tim Murren
|https://github.com/BallySternOS/FlashGordon2021
|
|-
|(Beyond) Future Spa
|In Progress
|Brian MacKay
|
|
|-
|Galaxy 2021
|Released
|Dick Hamill
|https://github.com/BallySternOS/Galaxy2021
|13
|-
|Jungle Lord 2023
|In Progress
|Dick Hamill
|
|
|-
|Lightning 2023
|In Progress
|Dick Hamill
|
|
|-
|Meteor 2021
|Released
|Dick Hamill
|https://github.com/BallySternOS/Meteor2021
|8
|-
|Scorpion 2022
|In Progress
|Dick Hamill
|
|
|-
|[[Silverball Mania 2021]]
|Released
|Dick Hamill
|https://github.com/BallySternOS/SilverballMania2021MEGA
|2
|-
|Stars 2020
|Released
|Dick Hamill
|https://github.com/BallySternOS/Stars2020-21
|6
|-
|Stars 2021
|Released
|Dick Hamill
|https://github.com/BallySternOS/Stars2020-21
|2
|-
|[[StarTrek 2022|Star Trek 2022]]
|In Progress
|John Turner
|
|
|-
|Stellar Wars 2022
|Released
|Dick Hamill
|https://github.com/BallySternOS/StellarWars2022
|1
|-
|Supersonic 2022
|Released
|Dick Hamill
|https://github.com/BallySternOS/Supersonic2022
|1
|-
|Trident 2020
|Released
|Dick Hamill
|https://github.com/BallySternOS/Trident2020
|2
|-
|Trident 2022
|Released
|Dick Hamill
|https://github.com/BallySternOS/Trident2022
|1
|-
|[[Paragon]]
|In Progress
|Mike from PinballHelp.com
|https://www.youtube.com/watch?v=4fBk7Wx4ABU&t=335s
|1

|}

RPU Hardware Revisions

2022-12-07T18:50:49Z

DickHamill: Hardware revisions table added

Drop Target Handler Library

2022-12-05T02:04:52Z

DickHamill: Wrote page

Drop targets on pinball machines can be as simple as a switch for each target and a solenoid to reset those targets. Why would you need a library to handle those? In some machines (early Williams solid state machines), there is a switch that momentarily makes contact as each switch falls, and then another daisy-chained switch to indicate that all the targets are down. In early Bally machines, the switch is triggered when the target is all the way down and a poorly-gapped switch can give multiple readings when vibrations move through the playfield. This library handles those cases and only returns valid closures (one per target per reset). It also keeps track if the targets were dropped in order, and it knows to ignore closures that happen during the reset.

=== Constructor ===
DropTargetBank(byte s_numSwitches, byte s_numSolenoids, byte s_bankType, byte s_solenoidOnTime);<blockquote>s_numSwitches - total number of drop targets in this bank

s_numSolenoids - total number of solenoids required to reset this bank

s_bankType

* DROP_TARGET_TYPE_BALLY_1 - normal Bally
* DROP_TARGET_TYPE_STERN_1 - normal Stern
* DROP_TARGET_TYPE_STERN_2 - Stern "memory" drops (each target can be retracted with it's own solenoid)
* DROP_TARGET_TYPE_WILLIAMS_1 - extra switch for all targets down

s_solenoidOnTime - number of cycles for solenoid reset (12 is common for Bally/Stern)</blockquote>

=== Functions ===
void DefineSwitch(byte switchOrder, byte switchNum); // this function is called for each target's switch<blockquote>switchOrder - zero index (used for knowing if targets were dropped in order)

switchNum - machine's switch matrix index</blockquote>void DefineResetSolenoid(byte solIndex, byte solChannelNumber); // this function is called for each reset solenoid for this bank<blockquote>solIndex - zero index solenoid number

solChannelNumber - machine's solenoid index</blockquote>void AddAllTargetsSwitch(byte s_allTargetsSwitch); // this function is only called if the bank has an "all down" switch (i.e. early Williams)<blockquote>s_allTargetsSwitch - machine's switch matrix index</blockquote>byte HandleDropTargetHit(byte switchNum); // this function is called whenever the game loop sees a drop target switch on the stack<blockquote>switchNum - machine's switch matrix index

Return value - returns a bit mask of all targets down since last hit

* b0 - drop target index 0 is newly down (true/false)
* b1 - drop target index 1 is newly down (true/false)
* etc.
</blockquote>byte CheckIfBankCleared(); // this function is called after a target switch is seen to determine if bank has been cleared<blockquote>Return values:

* 0 - bank not clear
* 1 - DROP_TARGET_BANK_CLEARED
* 2 - DROP_TARGET_BANK_CLEARED_IN_ORDER
</blockquote>void Update(unsigned long currentTime); // this function should be called in the program's main loop<blockquote>currentTime - the current time in milliseconds</blockquote>void ResetDropTargets(unsigned long timeToReset, boolean ignoreQuickDrops=false); // call this function to reset the bank<blockquote>timeToReset - machine time in milliseconds to reset; typically CurrentTime + (any delay in ms)

ignoreQuickDrops - set this parameter to ignore drops that come immediately after reset, in case of mechanical failure or Williams</blockquote>byte GetStatus(); // call to get a bit mask of the current drops down<blockquote>Return value:

* b0 - drop target index 0 is down (true/false)
* b1 - drop target index 1 is down (true/false)
* etc.
</blockquote>

=== Common Usage ===
Global variable for each bank:<blockquote>DropTargetBank DropTargets6(6, 2, DROP_TARGET_TYPE_WILLIAMS_1, 50);</blockquote>Targets are configured in setup() function:<blockquote> DropTargets6.DefineSwitch(0, SW_LEFT_3_DROP_1);

DropTargets6.DefineSwitch(1, SW_LEFT_3_DROP_2);

DropTargets6.DefineSwitch(2, SW_LEFT_3_DROP_3);

DropTargets6.DefineSwitch(3, SW_RIGHT_3_DROP_1);

DropTargets6.DefineSwitch(4, SW_RIGHT_3_DROP_2);

DropTargets6.DefineSwitch(5, SW_RIGHT_3_DROP_3);

DropTargets6.AddAllTargetsSwitch(SW_3_DROPS_COMPLETE);

DropTargets6.DefineResetSolenoid(0, SOL_3_DROP_LEFT_RESET);

DropTargets6.DefineResetSolenoid(1, SOL_3_DROP_RIGHT_RESET);</blockquote>Targets are reset in InitNewBall<blockquote> DropTargets6.ResetDropTargets(CurrentTime + 200, true);</blockquote>Switch hits are sent to a handler function<blockquote> case SW_LEFT_3_DROP_1:

case SW_LEFT_3_DROP_2:

case SW_LEFT_3_DROP_3:

case SW_RIGHT_3_DROP_1:

case SW_RIGHT_3_DROP_2:

case SW_RIGHT_3_DROP_3:

case SW_3_DROPS_COMPLETE:

if (Handle6Drops(switchHit)) {

LastSwitchHitTime = CurrentTime;

if (BallFirstSwitchHitTime == 0) BallFirstSwitchHitTime = CurrentTime;

}

break;</blockquote>Score is added in switch handler, and targets are checked to see if they have been cleared<blockquote>void Handle6Drops(byte switchHit) {

byte result = DropTargets6.HandleDropTargetHit(switchHit);

unsigned long numTargetsDown = (unsigned long)CountBits(result);

if (numTargetsDown) CurrentScores[CurrentPlayer] += PlayfieldMultiplier * numTargetsDown * 100;

byte cleared = DropTargets6.CheckIfBankCleared();

if (cleared) {

// currently no award for clearing in order

DropTargets6.ResetDropTargets(CurrentTime + 500, true);

if (Drop6Clears[CurrentPlayer]<4) {

CurrentScores[CurrentPlayer] += Drop6ClearRewards[Drop6Clears[CurrentPlayer]] * PlayfieldMultiplier;

Drop6Clears[CurrentPlayer] += 1;

} else {

AwardSpecial();

Drop6Clears[CurrentPlayer] = 0;

}

IncreasePlayfieldMultiplier(30000);

PlaySoundEffect(SOUND_EFFECT_DROP_TARGET_RESET);

} else if (numTargetsDown) {

PlaySoundEffect(SOUND_EFFECT_DROP_TARGET_HIT);

}

...</blockquote>Targets are updated in loop() or ManageGameMode()<blockquote> DropTargets6.Update(CurrentTime);</blockquote>

=== Where to find it ===
[https://github.com/BallySternOS/BallySternOS/tree/master/HelperClasses Latest code on GitHub - DropTargets.h]

Software Resources

2022-12-05T01:34:30Z

DickHamill: Added links

To facilitate the creation of games, there are a number of templates, utilities, and helper libraries available on the BSOS GitHub site.

[[Audio Functions Library]]

[[Drop Target Handler Library]]

[[Lamp Animation Helper Executable]]

[[Machine Diagnostics]]

[[Pinball Machine Base]]

Main Page

2022-12-05T01:30:50Z

DickHamill: Added a link/page for software

BSOS Machines

2022-11-30T16:42:07Z

DickHamill: /* Known BSOS Machines */

== Known BSOS Machines ==
{| class="wikitable"
|Title
|Status
|Originating Author
|Github/Other Links
|Version
|-
|Black Jack 2020
|Released
|Dick Hamill
|https://github.com/BallySternOS/BlackJack2020
|1
|-
|Black Knight 2023
|In Progress
|Dick Hamill
|
|
|-
|Flash 2023
|In Progress
|Dick Hamill
|
|
|-
|Flash Gordon 2021
|Released
|Tim Murren
|https://github.com/BallySternOS/FlashGordon2021
|
|-
|Galaxy 2021
|Released
|Dick Hamill
|https://github.com/BallySternOS/Galaxy2021
|13
|-
|Jungle Lord 2023
|In Progress
|Dick Hamill
|
|
|-
|Lightning 2023
|In Progress
|Dick Hamill
|
|
|-
|Meteor 2021
|Released
|Dick Hamill
|https://github.com/BallySternOS/Meteor2021
|8
|-
|Scorpion 2022
|In Progress
|Dick Hamill
|
|
|-
|[[Silverball Mania 2021]]
|Released
|Dick Hamill
|https://github.com/BallySternOS/SilverballMania2021MEGA
|2
|-
|Stars 2020
|Released
|Dick Hamill
|https://github.com/BallySternOS/Stars2020-21
|6
|-
|Stars 2021
|Released
|Dick Hamill
|https://github.com/BallySternOS/Stars2020-21
|2
|-
|[[StarTrek|Star Trek]]
|In Progress
|John Turner
|
|
|-
|Stellar Wars 2022
|Released
|Dick Hamill
|https://github.com/BallySternOS/StellarWars2022
|1
|-
|Supersonic 2022
|In Progress
|Dick Hamill
|
|
|-
|Trident 2020
|Released
|Dick Hamill
|https://github.com/BallySternOS/Trident2020
|2
|-
|Trident 2022
|Released
|Dick Hamill
|https://github.com/BallySternOS/Trident2022
|1
|-
|[[Paragon]]
|In Progress
|Mike from PinballHelp.com
|https://www.youtube.com/watch?v=4fBk7Wx4ABU&t=335s
|1

|}

Introduction - What is BSOS?

2022-11-30T14:44:50Z

DickHamill: Added more information about the name

BSOS (Bally/Stern Operating System) is a library of functions enabling an [https://www.arduino.cc/ Arduino] or other microcontroller to control a pinball machine. An adapter board interfaces the Arduino to the pinball machine's MPU (Main Processor Unit) either through a diagnostic port or the CPU socket. Then, the Arduino is able to control the machine's lamps, sounds, switches, and solenoids.

With BSOS, people have created new rules for many early solid state [[BSOS Machines|pinball machines]].

The name BSOS originated because the library was written to work with the Bally AS-2518-17 and Stern MPU-100 [https://pinwiki.com/wiki/index.php/Bally/Stern architectures]. Since that inception, the libraries have been expanded to accommodate other architectures, such as Bally's AS-2518-35, Stern's MPU-200, and Williams System 4-7 MPUs. Work is underway to support Atari, Game Plan, and Williams System 11 MPUs as well.

Introduction - What is BSOS?

2022-11-30T14:17:00Z

DickHamill: Created page with "BSOS (Bally/Stern Operating System) is a library of functions enabling an [https://www.arduino.cc/ Arduino] or other microcontroller to control a pinball machine. An adapter board interfaces the Arduino to the pinball machine's MPU (Main Processor Unit) either through a diagnostic port or the CPU socket. Then, the Arduino is able to control the machine's lamps, sounds, switches, and solenoids. With BSOS, people have created new rules for many early solid state BSOS Ma..."