pinball_soup

The below steps will get a) arduino IDE, b) raspi set up with lisy, c) sd cards for APC to run Time Warped

• Arduino Pinball Controller Docs: https://github.com/AmokSolderer/APC
• Arduino IDE: https://docs.arduino.cc/software/ide-v2/tutorials/getting-started-ide-v2/
• lisy: https://lisy.dev/software.html

APC: PCB ordering

• TBD
• PCB maker did not have all parts available/in stock. Order list details for parts to solder for board completion:
  • https://docs.google.com/spreadsheets/d/1Lxnt1CGEWpybvpkPa3vRJebU48Qeu8h9te3dvZjng0g/edit?gid=0#gid=0

APC: Arduino Due & onboard SD card

• install arduino IDE (IDE 2) appimage from arduino site
• make downloaded file executable & open
• install Arduino IDE SPI (if needed) and sdfat libraries as detailed on APC github
• clone/download V1.02 version of APC repo
• upload APC.ino sketch in Arduino IDE (the other .ino files from repo should open as separate register cards)
• connect Due to comp via "programming port" (closest to DC power)
• in IDE, select Tools > Board > Boards Manager, then search for Due and download sam boards core.
• in IDE, select Tools > Board > Arduino SAM boards > Arduino Due (programming port)
• in IDE, select Tools > Serial Port > select arduino IDE serial port
• upload APC.ino sketch to Due via "Upload" button.
• if permission error, likely need to add user to group that controls port access. check which group owns ports (how TBD), if "dialout" group exists, it is likely this one
• $ less /etc/group (this lists all groups)
• add user to appropriate group & reboot afterwards: $ sudo usermod -a -G dialout $USER. retry upload after reboot & it should work.
• format an SD card using formatter from SDcard assoc (in windows machine only) for use on APC board. There will be a second SD card for use with raspi outlined in later steps.
  • wyze 32gb card: card with RED sharpie has Time Warp settings (APC & usb) & sounds from amoksolderer (via dropbox) pre-loaded
  • wyze 32gb card: card with BLACK X/LINES sharpie has no pre-loaded settings (will need to configure APC correctly upon first use, which will save settings to card)
• Install Due on APC, put sd card into APC's onboard slot
• Install APC in pinball machine (no raspi yet):
  • take one cord from old board, clearly label it based on name printed on old board (e.g. 2J4 on connector housing)
  • take that same cord and plug into corresponging port on APC using this diagram: https://github.com/AmokSolderer/APC/blob/master/DOC/InitialTests.md
  • run each test in order as described in APC initial test docs (linked in line above)

Lisy: Lisy image & raspberry pi

• download latest lisy embedded image via https://lisy.dev/swrep/LISY_Image/embedded/latest/
  • align image type with raspi type: ensure pi0w image since that's the raspi we're using here
• optional: download latest full image via https://lisy.dev/swrep/LISY_Image/stable/
• upload image to sdcard using a good image writer tool (can be linux or windows ex: raspi imager, dd)
• Put sdcard into raspi (pi0w v 1.1) slot, install raspi (pi0w) on APC

Pinball Machine: lisy config & running original rom

Easy method

• APC creator sent Time Warp sound files, APC config, and usb/lisy/raspi config pre-set to pull up Time Warp.
• unzip if needed from download, and upload files to (correctly formatted) sdcard as indicated in previous steps. Install card on APC board
• Turn machine on. It should come up as original Time Warp
  • the "first" time this is done (or sdcard wiped/reuploaded), machine will enter Williams settings vs gameplay. Flip coin door dipswitch to "Down", short press "Advance" to navigate back to final "exit" setting, then press start button. Settings will save to sdcard and game should start as normal going forward.
  • rom is coin-based. will need to add credits to machine to start game.

Hard(er) method

The below linux-based steps will get a) a python virtualenv to work in, b) the godot engine needed by mpf, c) mpf and d) the gmc addons mpf needs into a given machine folder

MissionPinball Docs: https://missionpinball.org/latest/start/quickstart/

MPF: godot engine/IDE, local development env, table project setup

• install godot: https://godotengine.org/download/linux/

• $ mv ~/Downloads/Godot_v4.3-stable_linux.x86_64 godot

• $ sudo mv godot /usr/local/bin

• install pyenv & activate virtualenv plugin

• install python versions

• $ env PYTHON_CONFIGURE_OPTS='--enable-optimizations --with-lto' PYTHON_CFLAGS='-march=native -mtune=native' pyenv install --verbose 3.11.8

• $ env PYTHON_CONFIGURE_OPTS='--enable-optimizations --with-lto' PYTHON_CFLAGS='-march=native -mtune=native' pyenv install --verbose 3.9.12

• $ pyenv virtualenv 3.9.12 mpf3912

• $ pyenv virtualenv 3.11.8 mpfgmc3118_timewarp

• $ pyenv activate mpfgmc3118_timewarp

• Download latest mpf-gmc from https://github.com/missionpinball/mpf-gmc

• $ cp -rv ~/repos/mpf-gmc/addons ~/repos/pinball_soup/time_warped/

• follow MPF instructions/docs on godot editor for setting main scene, window size, audio buses, attract mode slide