Custom Pinball Index - User contributions [en]

How to Build and Install on Your Machine

2023-01-05T04:49:36Z

JohnT:

= 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.

Preparing your WAV trigger

2023-01-05T04:46:41Z

JohnT: Created page with "=Preparing your WAV Trigger= BSOS uses a Robersonics WAV trigger to play sound effects. The WAV trigger needs to be upgraded and prepared to optimally work with BSOS. The general order is: #Make sure you have a nice table cloth on your table #Purchase a WAV trigger from [https://www.amazon.com/dp/B0108LU05A Amazon] or [https://www.sparkfun.com/products/13660 SparkFun] #Solder headers onto the 6 pin section of the WAV trigger to enable serial control #Bridge the 5V inpu..."

=Preparing your WAV Trigger=
BSOS uses a Robersonics WAV trigger to play sound effects. The WAV trigger needs to be upgraded and prepared to optimally work with BSOS.

The general order is:

#Make sure you have a nice table cloth on your table
#Purchase a WAV trigger from [https://www.amazon.com/dp/B0108LU05A Amazon] or [https://www.sparkfun.com/products/13660 SparkFun]
#Solder headers onto the 6 pin section of the WAV trigger to enable serial control
#Bridge the 5V input power pad on the WAV trigger
#Upgrade the WAV trigger to [https://robertsonics.com/wav-trigger-downloads/ version 1.3 or higher]
#Connect the WAV trigger to the interface board - making sure to pay attention to the pin order
#Download and load the sounds for your machine onto the micro SD Card and insert it into the WAV trigger
#Hook up a set of powered speakers to the WAV trigger

== Solder Headers onto the WAV trigger and bridge the 5V pad ==
The Arduino communicates with the WAV trigger via serial (UART) and powers the WAV trigger with 5V. You will need to solder 6 pins and bridge a solder pad on the WAV trigger.

The WAV Trigger sound card comes with an empty header (6-pin) on the bottom right of the board (yellow arrow). Solder male pins (0.1”) into this header. Pin 1 (GND) is at the top of the connector. To power the WAV Trigger through this header, you’ll need to put a solder bridge over the 5V pads (purple arrow pointing to SJ2). Otherwise, provide power through the barrel connector on the left side of the board.
[[File:WavTriggerHeader.jpg|border|center|1008x1008px|WAV Trigger with headers and power pad soldered]]

== Upgrading WAV trigger software ==
The WAV trigger ships with version 1.28. This version will work, but it may have issues when a lot of sound effects are played in a short period of time, specifically the background song may stop. To fix this the WAV trigger needs to be upgraded to a version > 1.30

* download v1.30 firmware and [https://robertsonics.com/wav-trigger-downloads/ update utility]
* set the slide switch on the wav trigger to the load position
* connect your desktop computer to the wav trigger using a usb to serial cable [https://www.adafruit.com/product/954 like this one] from Adafruit and the adapter to the 6-pin header you installed above
* connect an external power supply to the wav trigger
* run the wav trigger flash utility.

=== Using an Arduino as a USB to Serial bridge ===
In a pinch you can use an Arduino as a USB to UART bridge to flash the WAV trigger. To do this:

* Jumper the rst pin on the Arduino to the ground pin
* Connect the RX pin to the RX pin on the WAV trigger
* Connect the TX pin to the TX pin on the WAV trigger
* Connect the GND pin to the WAV trigger GND pin
* [[File:Arduino USB bridge.jpg|center|thumb|Arduino as USB to UART bridge]]

== Connect the WAV trigger to the interface board ==
If you’re using a BSOS PCB, the ground pin is the first pin on the left of either Serial 1 or Serial 2. The Gerber files for the PCB are in the main repository <nowiki>https://github.com/BallySternOS/BallySternOS</nowiki> , and there are kits available online. In this photo, the yellow arrow points to pin 1 (ground).
[[File:Rev2Serial.jpg|center|756x756px|Serial connection on the BSOS interface board]]
[[File:Rev2 to WAVTrigger.jpg|center|1008x1008px|WAV Trigger to REV 2 BSOS connection]]

== Load the sounds for your game onto a micro SD Card ==
Download the WAV files for the code you are using and load them onto the micro SD Card. The SD Card should be a class 4 or better card - see the [https://robertsonics.com/microsd-cards-for-audio/ documentation] on the supported cards

== Plug a powered speaker into the headphone jack ==
You will need to find a powered speaker to play the sounds from the WAV trigger. The speaker can be installed in the base of the machine or mounted up higher. You can plug the speakers into the 120V maintenance plug inside the base.

File:Arduino USB bridge.jpg

2023-01-05T04:37:02Z

JohnT:

using an Arduino as a USB bridge

File:Rev2 to WAVTrigger.jpg

2023-01-05T04:25:20Z

JohnT:

Connecting WAV trigger to a REV 2 board

File:Rev2Serial.jpg

2023-01-05T04:23:29Z

JohnT:

Serial connection on Rev2 of the interface board

File:WavTriggerHeader.jpg

2023-01-05T04:16:36Z

JohnT:

WAV trigger with header and 5V pad jumper

How to Build and Install on Your Machine

2023-01-05T03:59:59Z

JohnT:

= 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
# Purchase a WAV trigger from [https://www.amazon.com/dp/B0108LU05A Amazon] or [https://www.sparkfun.com/products/13660 SparkFun]
# Upgrade the WAV trigger to [https://robertsonics.com/wav-trigger-downloads/ version 1.3 or higher]
# Download and load the sounds for your machine onto the micro SD Card and insert it into the WAV trigger
# Bridge the 5V input power pad on the WAV trigger
# Connect the WAV trigger to the interface board - making sure to pay attention to the pin order
# Hook up a set of powered speakers to the WAV trigger
# 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 and Install on Your Machine

2023-01-05T03:31:21Z

JohnT:

==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 and Install on Your Machine

2023-01-05T03:30:03Z

JohnT:

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

== 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 and Install on Your Machine

2023-01-05T03:28:08Z

JohnT: Created page with "== 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 (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 contain..."

== 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-05T03:10:54Z

JohnT:

[[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]]

[[How to Build,Get, & Install on Your Machine]]

RPU Hardware Revisions

2023-01-05T00:58:51Z

JohnT: Added Install picture and text

= 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
!Boots
Original
Code
|-
|BSOS Version 1
|NANO ATMega328P
|AS-2518-17
AS-2518-35
|MPU-100
MPU-200
|
| -21, -50, -51
|
|Hardware switch
|-
|BSOS Version 2
|NANO ATMega328P
|AS-2518-17
AS-2518-35
|MPU-100
MPU-200
|
| -21, -50, -51
|SB-100
|Hardware switch
|-
|BSOS Version 3
|MEGA 2560 PRO
|AS-2518-17
AS-2518-35
|MPU-100
MPU-200
|
| -21, -50, -51
|SB-100, SB-300
|Hardware switch
|-
|BSOS Version 4 - J5
|MEGA 2560 PRO
|AS-2518-17
AS-2518-35
|MPU-100
MPU-200
|
| -21, -50, -51
|SB-100, SB-300
|Hardware switch
|-
|BSOS Version 4 - CPU
|MEGA 2560 PRO
|AS-2518-17
AS-2518-35
|MPU-100
MPU-200
|System 4
| -21, -50, -51
|SB-100, SB-300
|Hardware switch
or hold Credit/Reset
button on boot
|-
|RPG Version 1
|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
|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

File:Instal on J5.jpg

2023-01-05T00:56:45Z

JohnT:

Rev2 on J5

File:Interrupt Jumper.jpg

2023-01-05T00:43:28Z

JohnT:

Picture showing the interrupt jumper

Base Library Functions

2022-12-07T16:30:14Z

JohnT: Created page with "= Base Library Functions = These are the base library functions for the BSOS Library - you can find the original documentation on the git hub pages https://github.com/BallySternOS/ballysternos.github.io/blob/master/libraryfunctions.md = Library Functions = The BSOS library is divided into four sections: * Setup Functions * Lamp Functions * Switch Functions * Display Functions * Solenoid Functions * Sound Functions == Setup Functions == The minimum requirements to sta..."

= Base Library Functions =
These are the base library functions for the BSOS Library - you can find the original documentation on the git hub pages

https://github.com/BallySternOS/ballysternos.github.io/blob/master/libraryfunctions.md

= Library Functions =
The BSOS library is divided into four sections:

* Setup Functions
* Lamp Functions
* Switch Functions
* Display Functions
* Solenoid Functions
* Sound Functions

== Setup Functions ==
The minimum requirements to start the OS are the following setup functions:

'''''BSOS_SetupGameSwitches'''''

'''''BSOS_InitializeMPU'''''

'''''BSOS_SetupGameSwitches''''' just takes a pointer to the array of “'''''PlayfieldAndCabinetSwitch'''''” structures that the game layer defines. Each game can have pop bumpers and slingshots on different solenoids, and I wanted the OS to stay independent of machine-specific configurations. So the array passed in simply defines switches that should trigger immediate solenoid responses. This array needs to be sorted to put the highest-priority solenoids at the top. Some solenoids (pop bumpers & slingshots) will trigger immediately when they see a switch go from Open to Closed. Others, (like chimes) will only trigger when they see a debounced signal show Open, Closed, Closed. So, the parameters for this function are:

'''''s_numSwitches''''' – total switches that have solenoid responses s_numPrioritySwitches – switches at the top of the array that require immediate responses s_gameSwitchArray – pointer to the head of an array of PlayfieldAndCabinetSwitch structures with a size of '''''s_numSwitches'''''

'''''BSOS_InitializeMPU''''' sets up all the global variables, configures the ports on the Arduino, and it talks to the PIA chips to get them ready. It then hooks up the ISR to pin 2 to handle the interrupts generated by U10 and U11. Once this function is called, the machine is ready to go. At the moment, there’s no self-test as part of this function. In the future, the function should do the following tests:

Read & write to U10 to make sure it responds correctly Read & write to U11 Let the U10B:CB1 interrupt run for a second to make sure it’s coming in at approximately 120Hz Let the U11A:CA1 interrupt run for a second to make sure it’s running at approximately 320Hz Once those two functions are called, the game layer is free to use any of the functions for reading switches or outputting to solenoids, lamps, and displays.

== Lamp Functions ==
There is one main function to control the lamps and one to update the lamps in case they’re supposed to flash.

'''''BSOS_SetLampState''''' takes a lamp number and then turns it on or off based on s_lampState. These lamp numbers are inherent to the way the lamps are wired to the lamp driver board, so it’s up to the game layer to keep track of which lamp is which. For example, on Stars the first line of the first latch is hooked to the Special light near the purple star, so I have a definition of “SPECIAL_PURPLE_STAR” set to zero. The third parameter is whether the lamp is dim. A dim value of 0 makes the bulb fully on, 1 makes the bulb on 50% of the time at 60Hz, 2 makes it 50% at 30Hz, and 3 makes it 30Hz at a 25% duty cycle. The 30Hz values flicker a bit too much, but the 60Hz looks good. There’s also a parameter to make the bulb flash at the given period (in milliseconds). For the bulb to flash, you have to periodically call the next function.

'''''BSOS_ApplyFlashToLamps''''' called with the current time in milliseconds will flash the bulb at the set period. If the period of the lamp is 0, the bulb will not flash.

'''''BSOS_FlashAllLamps''''' is a self-test function to toggle all 60 circuits on the lamp board.

'''''BSOS_TurnOffAllLamps''''' is a helper function to blank all bulbs when changing machine states.

'''''BSOS_SetDimDivisor''''' allows the game to control the duty cycle of "dim" lamps. A value of "2" will give dim lamps a 50% duty cycle, and "3" will give them a 33% duty cycle.

== Switch Functions ==
'''''BSOS_GetDipSwitches''''' allows the game layer to read the DIP switch values from the board. The argument “index” selects which bank will be returned. Switch values are packed into the byte that is returned.

'''''BSOS_PullFirstFromSwitchStack''''' returns the next switch event from the stack. Every time a switch is hit, it’s pushed to the stack. This function pulls the first event from the stack. It returns SWITCH_STACK_EMPTY if there are no more events on the stack. This switch number is just an integer between 0 and 39 (inclusive). It’s up the game layer to know which switch is which. The machine’s manual will have a switch diagram and the values can be read from that.

'''''BSOS_ReadSingleSwitchState''''' allows the game level to check the state of a given switch at the moment. This is handy to know if the ball is currently in the outhole trough, or if drop targets are currently down. The only parameter is the switch number, and the return is true if the switch is closed.

== Display Functions ==
'''''BSOS_SetDisplay''''' – this is the main function to update a display. The first parameter (between 0-4, inclusive) chooses if we’re updating Player 1, Player 2, Player 3, Player 4, or Credits/Ball in Play. The second parameter will be broken up into digits by the OS.

'''''BSOS_SetDisplayBlank''''' allows the game layer to turn on or off individual digits of the displays. It’s a bitmask with 1 meaning show the digit and 0 meaning hide it. Because of confusing internal reasons, b0 is the left-most digit on a display and b5 is the right-most. So, to show 00 in a display, call this function with 0x30 after setting the display to zero.

'''''BSOS_SetDisplayBlankByMagnitude''''' will automatically clear leading zeros based on the magnitude of the number passed in.

'''''BSOS_SetDisplayBlankForCreditMatch''''' will turn off the first and third digits of a display. On some machines, the credit/ball-in-play display will be a single 6-digit display unit instead of two 2-digit ones. For that reason, credits and match should always be masked to 0x36.

'''''BSOS_SetDisplayCredits''''' and BSOS_SetDisplayMatch set only digits 2 and 3 to a 2-digit number.

'''''BSOS_SetDisplayBallInPlay''''' – sets digits 5 and 6 to a 2-digit number.

'''''BSOS_SetDisplayBIPBlank''''' blanks the ball-in-play display.

'''''BSOS_SetDisplayFlash''''' flashes the given display at the given period. This function must be called periodically in order to toggle the display on and off.

'''''BSOS_SetDisplayFlashCredits''''' flashes the credit display.

'''''BSOS_CycleAllDisplays''''' called periodically will cycle through all the digits for a self-test.

== Solenoid Functions ==
There are several functions related to the solenoids. Internally, the OS keeps two solenoid stacks. The first is a FIFO (first-in, first-out) stack used for immediate solenoid firing. The second allows the game level to queue solenoids for later (so it’s not really a stack, but a list of events and the times they should occur). The timed stack can be used for chimes or resetting banks of drop targets.

'''''BSOS_PushToSolenoidStack''''' – this function pushes the given solenoid number “numPushes” amount of times. “disableOverride” allows for stack pushes even if the solenoid stack has been disabled. Example: the solenoid stack might be disabled in Attract mode, but we still want to play a chime when the Start button is pressed.

'''''BSOS_SetCoinLockout''''' and '''''BSOS_SetDisableFlippers''''' are helper functions used to manage common continuous solenoids. They’re coded to use common bit assignments (flippers are often on bit 6, and coin lockout on b5), but that bit can be changed in the second parameter. BSOS_ReadContinuousSolenoids can be used to check on the current value. This is mostly used for debugging.

'''''BSOS_DisableSolenoidStack''''' is useful to disable pop bumpers and slingshots in a Tilt situation or during Attract mode. BSOS_EnableSolenoidStack turns it back on.

'''''BSOS_PushToTimedSolenoidStack''''' is like the other solenoid stack function, but it includes an unsigned long to tell it when to fire. The OS doesn’t concern itself with keeping a real-time clock, so the current clock value must be passed in by '''''BSOS_UpdateTimedSolenoidStack''''' in the program’s loop. When the curTime exceeds whenToFire, entries from the timed stack are moved to the regular solenoid stack.

== Sound Functions ==
There are a ton of different sound cards supported (-51, SB100, SB300, -17, Squawk and Talk), and they all have different functions to support them. Needs documentation.

Software Resources

2022-12-07T16:23:52Z

JohnT:

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]]

[[Audio Functions Library]]

[[Drop Target Handler Library]]

[[Lamp Animation Helper Executable]]

[[Machine Diagnostics]]

[[Pinball Machine Base]]

BSOS Machines

2022-12-05T03:09:50Z

JohnT:

== 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
|-
|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
|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

|}

StarTrek

2022-12-05T03:08:39Z

JohnT: JohnT moved page StarTrek to StarTrek 2022

#REDIRECT [[StarTrek 2022]]

StarTrek 2022

2022-12-05T03:08:39Z

JohnT: JohnT moved page StarTrek to StarTrek 2022

= Bally Star Trek (1979) =
[[File:Backglass.jpg|thumb|backglass]]
Star Trek is a pinball machine from April 1979, manufactured by Bally Manufacturing Co. A total of 16,842 units where built.
[[File:Playfield.jpg|thumb|Playfield]]
It was the first officially licensed Star Trek pinball game which extended into many other machines later on.

== Links ==
[https://www.ipdb.org/machine.cgi?id=2355 IPDB]

[https://pinside.com/pinball/machine/star-trek Pinsides]

[https://www.jeff-z.com/pinball/startrek/rules/rules.html Original rules (Jeff-Z)]

== BSOS ==
Project Status: In Progress

Last Update: 11/28/2022

Author: [[John Turner]]

GitHub Source:

== Rules ==

=== Drop Targets ===
knock down drop targets for a 10,25,50,special bonus and advance DT bonus

=== Spell Bally ===
Spell Bally for a 30K bonus and advances bonus multiplier

Saucer awards lit letter

dummy bumpers shift lit letters and advance saucer letter award

=== Hyper Space ===
Shooting hyper space lane advances warp speed bonus (preserved between balls)

=== Time Warp ===
Time warp collects current bonus x bonus multiplier

=== Bonus ===
Bonus points are awarded and displayed in the playfield.

Bonus multipliers are awarded and collected at the end of the ball or by shooting the time warp lane.

There is no max for bonus points

Bonus points and multipliers are not held over between balls

== Missions ==

=== Doomsday ===
Completing spelling B-A-L-L-Y in any ball and knocking all drop targets down in a single ball starts the doomsday mission (based on the doomsday machine episode)

Player then must complete B-A-L-L-Y to activate the countdown (drop targets will not register and reset until BALLY is spelled) all drop targets must be hit within 30 seconds to complete the mission. Players are awarded 60K points for completing the mission.

== Switches ==
{| class="wikitable"
|Switch
|Number
|-
|SW_DROP_1
|0
|-
|SW_DROP_2
|1
|-
|SW_DROP_3
|2
|-
|SW_DROP_4
|3
|-
|SW_BALL_RETURN
|4
|-
|SW_CREDIT_RESET
|5
|-
|SW_TILT
|6
|-
|SW_OUTHOLE
|7
|-
|SW_COIN_3
|8
|-
|SW_COIN_1
|9
|-
|SW_COIN_2
|10
|-
|SW_SLAM
|15
|-
|SW_LOWER_HS_ROLLOVER
|17
|-
|SW_RIGHT_INNNER_LANE
|18
|-
|SW_LEFT_INNNER_LANE
|19
|-
|SW_UPPER_500_TARGET
|20
|-
|SW_UPPER_HS_ROLLOVER
|21
|-
|SW_ADV_BONUS_BUMPERS
|22
|-
|SW_3K_TARGET
|23
|-
|SW_LEFT_MIDDLE_LANE
|24
|-
|SW_RIGHT_MIDDLE_LANE
|25
|-
|SW_Y_TARGET
|26
|-
|SW_2L_TARGET
|27
|-
|SW_L_TARGET
|28
|-
|SW_A_ROLLOVER
|29
|-
|SW_B_ROLLOVER
|30
|-
|SW_SAUCER
|31
|-
|SW_RIGHT_OUTLANE
|33
|-
|SW_LEFT_OUTLANE
|34
|-
|SW_RIGHT_SLINGSHOT
|35
|-
|SW_LEFT_SLINGSHOT
|36
|-
|SW_CENTER_BUMPER
|37
|-
|SW_RIGHT_BUMPER
|38
|-
|SW_LEFT_BUMPER
|39
|}

== Lamps ==
{| class="wikitable"
|Lamp
|Number
|Notes
|-
|LAMP_BONUS_1K
|0
|
|-
|LAMP_BONUS_2K
|1
|
|-
|LAMP_BONUS_3K
|2
|
|-
|LAMP_BONUS_4K
|3
|
|-
|LAMP_BONUS_5K
|4
|
|-
|LAMP_BONUS_6K
|5
|
|-
|LAMP_BONUS_7K
|6
|
|-
|LAMP_BONUS_8K
|7
|
|-
|LAMP_BONUS_9K
|8
|
|-
|LAMP_BONUS_10K
|9
|
|-
|LAMP_BONUS_20K
|10
|
|-
|LAMP_BONUS_3X
|13
|and planet special
|-
|LAMP_BONUS_2X
|14
|and planet 3x
|-
|LAMP_PLANET_2X
|15
|
|-
|LAMP_HS_2K
|16
|
|-
|LAMP_HS_4K
|17
|
|-
|LAMP_HS_6K
|18
|
|-
|LAMP_HS_8K
|19
|
|-
|LAMP_HS_10K
|20
|
|-
|LAMP_HS_EXTRA_BALL
|21
|
|-
|LAMP_R_UPPER_CHUTE_5K
|22
|
|-
|LAMP_L_UPPER_CHUTE_5K
|23
|
|-
|LAMP_SAUCER_B
|24
|
|-
|LAMP_SAUCER_A
|25
|
|-
|LAMP_SAUCER_L
|26
|
|-
|LAMP_SAUCER_2L
|27
|
|-
|LAMP_SAUCER_Y
|28
|
|-
|LAMP_3K_ADV_BONUS
|29
|
|-
|LAMP_R_INNER_LANE
|30
|
|-
|LAMP_L_INNER_LANE
|31
|
|-
|LAMP_ROLLOVER_B
|32
|
|-
|LAMP_ROLLOVER_A
|33
|
|-
|LAMP_TARGET_L
|34
|
|-
|LAMP_TARGET_2L
|35
|
|-
|LAMP_TARGET_Y
|36
|
|-
|LAMP_R_OUTER_LANE
|37
|
|-
|LAMP_L_OUTER_LANE
|38
|
|-
|LAMP_Y
|39
|
|-
|LAMP_HEAD_SHOOT_AGAIN
|40
|
|-
|LAMP_HEAD_MATCH
|41
|
|-
|LAMP_SHOOT_AGAIN
|42
|
|-
|LAMP_BALL_IN_PLAY
|43
|
|-
|LAMP_SPECIAL_10K
|44
|
|-
|LAMP_SPECIAL_25K
|45
|
|-
|LAMP_SPECIAL_50K
|46
|
|-
|LAMP_SPECIAL
|47
|
|-
|LAMP_HEAD_BALL_IN_PLAY
|48
|
|-
|LAMP_HEAD_HIGH_SCORE
|49
|
|-
|LAMP_HEAD_GAME_OVER
|50
|
|-
|LAMP_HEAD_TILT
|51
|
|-
|LAMP_B
|52
|
|-
|LAMP_A
|53
|
|-
|LAMP_L
|54
|
|-
|LAMP_2L
|55
|
|-
|LAMP_HEAD_1P
|56
|
|-
|LAMP_HEAD_2P
|57
|
|-
|LAMP_HEAD_3P
|58
|
|-
|LAMP_HEAD_4P
|59
|}

== Solonoids ==
{| class="wikitable"
|Solonoid
|Number
|-
|SOL_KNOCKER
|5
|-
|SOL_OUTHOLE
|6
|-
|SOL_SAUCER
|7
|-
|SOL_LEFT_BUMPER
|8
|-
|SOL_RIGHT_BUMPER
|9
|-
|SOL_CENTER_BUMPER
|10
|-
|SOL_LEFT_SLINGSHOT
|11
|-
|SOL_RIGHT_SLINGSHOT
|12
|-
|SOL_DROP_TARGET_RESET
|13
|}

StarTrek 2022

2022-12-05T03:08:04Z

JohnT:

BSOS Machines

2022-12-05T03:05:35Z

JohnT:

== 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
|-
|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|Star Trek]] 2022
|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

|}

Test3

2022-12-01T19:03:57Z

JohnT:

{{Infobox pinball machine
| name = Parmigiano Reggiano
| image = [[Image:Parmigiano reggiano piece.jpg|260px]]
| othernames =
| country = [[Italy]]
| region =
| town = [[Parma]], [[Reggio Emilia]], [[Modena]], [[Bologna]], [[Mantua]]
| source = Cows
| pasteurised = No
| texture = Hard
| fat =
| protein =
| dimensions =
| weight =
| aging = 24 months or more
| certification = [[Protected designation of origin|PDO]] 1992
}}

Test3

2022-12-01T19:01:43Z

JohnT: Created page with "{{Infobox cheese | name = Parmigiano Reggiano | image = 260px | othernames = | country = Italy | region = | town = Parma, Reggio Emilia, Modena, Bologna, Mantua | source = Cows | pasteurised = No | texture = Hard | fat = | protein = | dimensions = | weight = | aging = 24 months or more | certification = Protect..."

{{Infobox cheese
| name = Parmigiano Reggiano
| image = [[Image:Parmigiano reggiano piece.jpg|260px]]
| othernames =
| country = [[Italy]]
| region =
| town = [[Parma]], [[Reggio Emilia]], [[Modena]], [[Bologna]], [[Mantua]]
| source = Cows
| pasteurised = No
| texture = Hard
| fat =
| protein =
| dimensions =
| weight =
| aging = 24 months or more
| certification = [[Protected designation of origin|PDO]] 1992
}}

Template:Infobox pinball machine

2022-12-01T19:00:40Z

JohnT: Created page with "{{infobox | bodyclass = adr hrecipe | above = {{{name|<includeonly>{{PAGENAMEBASE}}</includeonly>}}} | aboveclass = fn ingredient | image = {{#invoke:InfoboxImage|InfoboxImage|image={{#invoke:Wikidata|getValue|P18|{{{image|FETCH_WIKIDATA}}} }}|size={{{image_size|}}}|sizedefault=frameless|alt={{{alt|}}}}} | caption = {{{caption|}}} | abovestyle = background-color: #f6e396 | label1 = Other names | data1 = {{{othernames|}}} | label2 = Country of o..."

{{infobox
| bodyclass = adr hrecipe
| above = {{{name|<includeonly>{{PAGENAMEBASE}}</includeonly>}}}
| aboveclass = fn ingredient
| image = {{#invoke:InfoboxImage|InfoboxImage|image={{#invoke:Wikidata|getValue|P18|{{{image|FETCH_WIKIDATA}}} }}|size={{{image_size|}}}|sizedefault=frameless|alt={{{alt|}}}}}
| caption = {{{caption|}}}
| abovestyle = background-color: #f6e396
| label1 = Other names
| data1 = {{{othernames|}}}
| label2 = Country of origin
| data2 = {{#invoke:Wikidata|getValue|P495|{{{country|FETCH_WIKIDATA}}}}}
| class2 = country-name
| label3 = Region, town
| data3 = {{{regiontown|}}}
| class3 = locality
| label4 = Region
| data4 = {{{region|}}}
| class4 = region
| label5 = Town
| data5 = {{{town|}}}
| class5 = locality
| label6 = Source of milk
| data6 = {{#invoke:Wikidata|getValue|P186|{{{source|FETCH_WIKIDATA}}}}}
| label7 = Pasteurised
| data7 = {{{pasteurised|}}}
| label8 = Pasteurized
| data8 = {{{pasteurized|}}}
| label9 = Texture
| data9 = {{{texture|}}}
| label10 = Fat content
| data10 = {{{fat|}}}
| label11 = Protein content
| data11 = {{{protein|}}}
| label12 = Dimensions
| data12 = {{{dimensions|}}}
| label13 = Weight
| data13 = {{{weight|}}}
| label14 = Aging time
| data14 = {{{aging|}}}
| label15 = Certification
| data15 = {{{certification|}}}
| label16 = Named after
| data16 = {{#invoke:Wikidata|getValue|P138|{{{namedafter|FETCH_WIKIDATA}}}}}
| below = {{#if:{{{commons|}}}{{#invoke:Commons link|hasGalleryOrCategory}}|{{Commons-inline|{{{commons|}}}|Related media on Commons|short=yes|notrack=1}}}}
}}{{Main other|[[Category:Articles with hRecipes]][[Category:Articles with Adr microformats]]}}{{#invoke:Check for unknown parameters|check|unknown={{main other|}}|preview= Page using [[Template:Infobox Cheese]] with unknown parameter "_VALUE_" |ignoreblank=y | name | image | alt | caption | othernames | country | region | town | source | pasteurised | pasteurized | texture | fat | protein | dimensions | weight | aging | certification | namedafter | Commons-inline | commons }}<noinclude>
{{documentation}}
</noinclude>

Main Page

2022-11-30T22:13:08Z

JohnT:

RPU Hardware Revisions

2022-11-30T22:10:40Z

JohnT: Created page with "= 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. Arduino Mega 2560 Pro Arduino Mega 2560 Pro Pinout The hardware interface board has gone through several revis..."

File:Mega-2560-Pro-Pinout.jpg

2022-11-30T21:59:01Z

JohnT:

Mega-2560-Pro-Pinout

File:Mega2560 Pro.jpg

2022-11-30T21:54:57Z

JohnT:

Arduino Mega 2560 Pro

StarTrek 2022

2022-11-30T13:05:31Z

JohnT:

= Bally Star Trek (1979) =
[[File:Backglass.jpg|thumb|backglass]]
Star Trek is a pinball machine from April 1979, manufactured by Bally Manufacturing Co. A total of 16,842 units where built.
[[File:Playfield.jpg|thumb|Playfield]]
It was the first officially licensed Star Trek pinball game which extended into many other machines later on.

== Links ==
[https://www.ipdb.org/machine.cgi?id=2355 IPDB]

[https://pinside.com/pinball/machine/star-trek Pinsides]

== BSOS ==
Project Status: In Progress

Last Update: 11/28/2022

Author: [[John Turner]]

GitHub Source:

== Rules ==

=== Drop Targets ===
knock down drop targets for a 10,25,50,special bonus and advance DT bonus

=== Spell Bally ===
Spell Bally for a 30K bonus and advances bonus multiplier

Saucer awards lit letter

dummy bumpers shift lit letters and advance saucer letter award

=== Hyper Space ===
Shooting hyper space lane advances warp speed bonus (preserved between balls)

=== Time Warp ===
Time warp collects current bonus x bonus multiplier

=== Bonus ===
Bonus points are awarded and displayed in the playfield.

Bonus multipliers are awarded and collected at the end of the ball or by shooting the time warp lane.

There is no max for bonus points

Bonus points and multipliers are not held over between balls

== Missions ==

=== Doomsday ===
Completing spelling B-A-L-L-Y in any ball and knocking all drop targets down in a single ball starts the doomsday mission (based on the doomsday machine episode)

Player then must complete B-A-L-L-Y to activate the countdown (drop targets will not register and reset until BALLY is spelled) all drop targets must be hit within 30 seconds to complete the mission. Players are awarded 60K points for completing the mission.

== Switches ==
{| class="wikitable"
|Switch
|Number
|-
|SW_DROP_1
|0
|-
|SW_DROP_2
|1
|-
|SW_DROP_3
|2
|-
|SW_DROP_4
|3
|-
|SW_BALL_RETURN
|4
|-
|SW_CREDIT_RESET
|5
|-
|SW_TILT
|6
|-
|SW_OUTHOLE
|7
|-
|SW_COIN_3
|8
|-
|SW_COIN_1
|9
|-
|SW_COIN_2
|10
|-
|SW_SLAM
|15
|-
|SW_LOWER_HS_ROLLOVER
|17
|-
|SW_RIGHT_INNNER_LANE
|18
|-
|SW_LEFT_INNNER_LANE
|19
|-
|SW_UPPER_500_TARGET
|20
|-
|SW_UPPER_HS_ROLLOVER
|21
|-
|SW_ADV_BONUS_BUMPERS
|22
|-
|SW_3K_TARGET
|23
|-
|SW_LEFT_MIDDLE_LANE
|24
|-
|SW_RIGHT_MIDDLE_LANE
|25
|-
|SW_Y_TARGET
|26
|-
|SW_2L_TARGET
|27
|-
|SW_L_TARGET
|28
|-
|SW_A_ROLLOVER
|29
|-
|SW_B_ROLLOVER
|30
|-
|SW_SAUCER
|31
|-
|SW_RIGHT_OUTLANE
|33
|-
|SW_LEFT_OUTLANE
|34
|-
|SW_RIGHT_SLINGSHOT
|35
|-
|SW_LEFT_SLINGSHOT
|36
|-
|SW_CENTER_BUMPER
|37
|-
|SW_RIGHT_BUMPER
|38
|-
|SW_LEFT_BUMPER
|39
|}

== Lamps ==
{| class="wikitable"
|Lamp
|Number
|Notes
|-
|LAMP_BONUS_1K
|0
|
|-
|LAMP_BONUS_2K
|1
|
|-
|LAMP_BONUS_3K
|2
|
|-
|LAMP_BONUS_4K
|3
|
|-
|LAMP_BONUS_5K
|4
|
|-
|LAMP_BONUS_6K
|5
|
|-
|LAMP_BONUS_7K
|6
|
|-
|LAMP_BONUS_8K
|7
|
|-
|LAMP_BONUS_9K
|8
|
|-
|LAMP_BONUS_10K
|9
|
|-
|LAMP_BONUS_20K
|10
|
|-
|LAMP_BONUS_3X
|13
|and planet special
|-
|LAMP_BONUS_2X
|14
|and planet 3x
|-
|LAMP_PLANET_2X
|15
|
|-
|LAMP_HS_2K
|16
|
|-
|LAMP_HS_4K
|17
|
|-
|LAMP_HS_6K
|18
|
|-
|LAMP_HS_8K
|19
|
|-
|LAMP_HS_10K
|20
|
|-
|LAMP_HS_EXTRA_BALL
|21
|
|-
|LAMP_R_UPPER_CHUTE_5K
|22
|
|-
|LAMP_L_UPPER_CHUTE_5K
|23
|
|-
|LAMP_SAUCER_B
|24
|
|-
|LAMP_SAUCER_A
|25
|
|-
|LAMP_SAUCER_L
|26
|
|-
|LAMP_SAUCER_2L
|27
|
|-
|LAMP_SAUCER_Y
|28
|
|-
|LAMP_3K_ADV_BONUS
|29
|
|-
|LAMP_R_INNER_LANE
|30
|
|-
|LAMP_L_INNER_LANE
|31
|
|-
|LAMP_ROLLOVER_B
|32
|
|-
|LAMP_ROLLOVER_A
|33
|
|-
|LAMP_TARGET_L
|34
|
|-
|LAMP_TARGET_2L
|35
|
|-
|LAMP_TARGET_Y
|36
|
|-
|LAMP_R_OUTER_LANE
|37
|
|-
|LAMP_L_OUTER_LANE
|38
|
|-
|LAMP_Y
|39
|
|-
|LAMP_HEAD_SHOOT_AGAIN
|40
|
|-
|LAMP_HEAD_MATCH
|41
|
|-
|LAMP_SHOOT_AGAIN
|42
|
|-
|LAMP_BALL_IN_PLAY
|43
|
|-
|LAMP_SPECIAL_10K
|44
|
|-
|LAMP_SPECIAL_25K
|45
|
|-
|LAMP_SPECIAL_50K
|46
|
|-
|LAMP_SPECIAL
|47
|
|-
|LAMP_HEAD_BALL_IN_PLAY
|48
|
|-
|LAMP_HEAD_HIGH_SCORE
|49
|
|-
|LAMP_HEAD_GAME_OVER
|50
|
|-
|LAMP_HEAD_TILT
|51
|
|-
|LAMP_B
|52
|
|-
|LAMP_A
|53
|
|-
|LAMP_L
|54
|
|-
|LAMP_2L
|55
|
|-
|LAMP_HEAD_1P
|56
|
|-
|LAMP_HEAD_2P
|57
|
|-
|LAMP_HEAD_3P
|58
|
|-
|LAMP_HEAD_4P
|59
|}

== Solonoids ==
{| class="wikitable"
|Solonoid
|Number
|-
|SOL_KNOCKER
|5
|-
|SOL_OUTHOLE
|6
|-
|SOL_SAUCER
|7
|-
|SOL_LEFT_BUMPER
|8
|-
|SOL_RIGHT_BUMPER
|9
|-
|SOL_CENTER_BUMPER
|10
|-
|SOL_LEFT_SLINGSHOT
|11
|-
|SOL_RIGHT_SLINGSHOT
|12
|-
|SOL_DROP_TARGET_RESET
|13
|}

Main Page

2022-11-29T03:34:17Z

JohnT:

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

<strong>This is the site for BSOS reference material and related things.... STAY TUNED for more!</strong>
[[File:Ardino-board01.jpg|thumb]]

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

BSOS Machines

2022-11-29T03:31:27Z

JohnT:

== Known BSOS Machines ==
{| class="wikitable"
|Title
|Status
|Author
|Github Link
|Version
|-
|[[StarTrek|Star Trek]]
|In Progress
|John Turner
|
|
|-
|SilverBallMania
|Released
|Dick Hamill
|https://github.com/BallySternOS/SilverballMania2021MEGA
|2
|}

BSOS Machines

2022-11-29T03:30:27Z

JohnT: creation

== Known BSOS Machines ==
{| class="wikitable"
|Title
|Status
|Author
|Github Link
|Version
|-
|[[Star Trek]]
|In Progress
|John Turner
|
|
|-
|SilverBallMania
|Released
|Dick Hamill
|https://github.com/BallySternOS/SilverballMania2021MEGA
|2
|}

StarTrek 2022

2022-11-29T03:18:01Z

JohnT: creation

= Bally Star Trek (1979) =
[[File:Backglass.jpg|thumb|backglass]]
Star Trek is a pinball machine from April 1979, manufactured by Bally Manufacturing Co. A total of 16,842 units where built.
[[File:Playfield.jpg|thumb|Playfield]]
It was the first officially licensed Star Trek pinball game which extended into many other machines later on.

== Links ==
[https://www.ipdb.org/machine.cgi?id=2355 IPDB]

[https://pinside.com/pinball/machine/star-trek Pinsides]

== BSOS ==
Project Status: In Progress

Last Update: 11/28/1972

Author: [[John Turner]]

GitHub Source:

== Rules ==

=== Drop Targets ===
knock down drop targets for a 10,25,50,special bonus and advance DT bonus

=== Spell Bally ===
Spell Bally for a 30K bonus and advances bonus multiplier

Saucer awards lit letter

dummy bumpers shift lit letters and advance saucer letter award

=== Hyper Space ===
Shooting hyper space lane advances warp speed bonus (preserved between balls)

=== Time Warp ===
Time warp collects current bonus x bonus multiplier

=== Bonus ===
Bonus points are awarded and displayed in the playfield.

Bonus multipliers are awarded and collected at the end of the ball or by shooting the time warp lane.

There is no max for bonus points

Bonus points and multipliers are not held over between balls

== Missions ==

=== Doomsday ===
Completing spelling B-A-L-L-Y in any ball and knocking all drop targets down in a single ball starts the doomsday mission (based on the doomsday machine episode)

Player then must complete B-A-L-L-Y to activate the countdown (drop targets will not register and reset until BALLY is spelled) all drop targets must be hit within 30 seconds to complete the mission. Players are awarded 60K points for completing the mission.

== Switches ==
{| class="wikitable"
|Switch
|Number
|-
|SW_DROP_1
|0
|-
|SW_DROP_2
|1
|-
|SW_DROP_3
|2
|-
|SW_DROP_4
|3
|-
|SW_BALL_RETURN
|4
|-
|SW_CREDIT_RESET
|5
|-
|SW_TILT
|6
|-
|SW_OUTHOLE
|7
|-
|SW_COIN_3
|8
|-
|SW_COIN_1
|9
|-
|SW_COIN_2
|10
|-
|SW_SLAM
|15
|-
|SW_LOWER_HS_ROLLOVER
|17
|-
|SW_RIGHT_INNNER_LANE
|18
|-
|SW_LEFT_INNNER_LANE
|19
|-
|SW_UPPER_500_TARGET
|20
|-
|SW_UPPER_HS_ROLLOVER
|21
|-
|SW_ADV_BONUS_BUMPERS
|22
|-
|SW_3K_TARGET
|23
|-
|SW_LEFT_MIDDLE_LANE
|24
|-
|SW_RIGHT_MIDDLE_LANE
|25
|-
|SW_Y_TARGET
|26
|-
|SW_2L_TARGET
|27
|-
|SW_L_TARGET
|28
|-
|SW_A_ROLLOVER
|29
|-
|SW_B_ROLLOVER
|30
|-
|SW_SAUCER
|31
|-
|SW_RIGHT_OUTLANE
|33
|-
|SW_LEFT_OUTLANE
|34
|-
|SW_RIGHT_SLINGSHOT
|35
|-
|SW_LEFT_SLINGSHOT
|36
|-
|SW_CENTER_BUMPER
|37
|-
|SW_RIGHT_BUMPER
|38
|-
|SW_LEFT_BUMPER
|39
|}

== Lamps ==
{| class="wikitable"
|Lamp
|Number
|Notes
|-
|LAMP_BONUS_1K
|0
|
|-
|LAMP_BONUS_2K
|1
|
|-
|LAMP_BONUS_3K
|2
|
|-
|LAMP_BONUS_4K
|3
|
|-
|LAMP_BONUS_5K
|4
|
|-
|LAMP_BONUS_6K
|5
|
|-
|LAMP_BONUS_7K
|6
|
|-
|LAMP_BONUS_8K
|7
|
|-
|LAMP_BONUS_9K
|8
|
|-
|LAMP_BONUS_10K
|9
|
|-
|LAMP_BONUS_20K
|10
|
|-
|LAMP_BONUS_3X
|13
|and planet special
|-
|LAMP_BONUS_2X
|14
|and planet 3x
|-
|LAMP_PLANET_2X
|15
|
|-
|LAMP_HS_2K
|16
|
|-
|LAMP_HS_4K
|17
|
|-
|LAMP_HS_6K
|18
|
|-
|LAMP_HS_8K
|19
|
|-
|LAMP_HS_10K
|20
|
|-
|LAMP_HS_EXTRA_BALL
|21
|
|-
|LAMP_R_UPPER_CHUTE_5K
|22
|
|-
|LAMP_L_UPPER_CHUTE_5K
|23
|
|-
|LAMP_SAUCER_B
|24
|
|-
|LAMP_SAUCER_A
|25
|
|-
|LAMP_SAUCER_L
|26
|
|-
|LAMP_SAUCER_2L
|27
|
|-
|LAMP_SAUCER_Y
|28
|
|-
|LAMP_3K_ADV_BONUS
|29
|
|-
|LAMP_R_INNER_LANE
|30
|
|-
|LAMP_L_INNER_LANE
|31
|
|-
|LAMP_ROLLOVER_B
|32
|
|-
|LAMP_ROLLOVER_A
|33
|
|-
|LAMP_TARGET_L
|34
|
|-
|LAMP_TARGET_2L
|35
|
|-
|LAMP_TARGET_Y
|36
|
|-
|LAMP_R_OUTER_LANE
|37
|
|-
|LAMP_L_OUTER_LANE
|38
|
|-
|LAMP_Y
|39
|
|-
|LAMP_HEAD_SHOOT_AGAIN
|40
|
|-
|LAMP_HEAD_MATCH
|41
|
|-
|LAMP_SHOOT_AGAIN
|42
|
|-
|LAMP_BALL_IN_PLAY
|43
|
|-
|LAMP_SPECIAL_10K
|44
|
|-
|LAMP_SPECIAL_25K
|45
|
|-
|LAMP_SPECIAL_50K
|46
|
|-
|LAMP_SPECIAL
|47
|
|-
|LAMP_HEAD_BALL_IN_PLAY
|48
|
|-
|LAMP_HEAD_HIGH_SCORE
|49
|
|-
|LAMP_HEAD_GAME_OVER
|50
|
|-
|LAMP_HEAD_TILT
|51
|
|-
|LAMP_B
|52
|
|-
|LAMP_A
|53
|
|-
|LAMP_L
|54
|
|-
|LAMP_2L
|55
|
|-
|LAMP_HEAD_1P
|56
|
|-
|LAMP_HEAD_2P
|57
|
|-
|LAMP_HEAD_3P
|58
|
|-
|LAMP_HEAD_4P
|59
|}

== Solonoids ==
{| class="wikitable"
|Solonoid
|Number
|-
|SOL_KNOCKER
|5
|-
|SOL_OUTHOLE
|6
|-
|SOL_SAUCER
|7
|-
|SOL_LEFT_BUMPER
|8
|-
|SOL_RIGHT_BUMPER
|9
|-
|SOL_CENTER_BUMPER
|10
|-
|SOL_LEFT_SLINGSHOT
|11
|-
|SOL_RIGHT_SLINGSHOT
|12
|-
|SOL_DROP_TARGET_RESET
|13
|}

File:Playfield.jpg

2022-11-29T02:39:11Z

JohnT:

Playfield

File:Backglass.jpg

2022-11-29T02:33:57Z

JohnT:

StarTrek backglass

File:Backglass.jpg

2022-11-29T02:33:25Z

JohnT:

StarTrek backless

User:JohnT

2022-11-28T20:32:12Z

JohnT: Created page with "John Turner"

John Turner