Cleanup and Table of contents

+ Normalized the writing style on almost all the document (still need to work on the "Other" category)
+ Fixed various mistakes (typo in drive commands, proposed replacement speaker not actually compatible with the cab)
+ Added a table of contents !

README.md

@@ -2,6 +2,43 @@
 
 Info dump related to the hardware/firmware/etc of ワッカ
 
+## Table of contents
+- [Wacca documentation](#wacca-documentation)
+  - [Table of contents](#table-of-contents)
+  - [Disclaimer](#disclaimer)
+  - [Service manual](#service-manual)
+- [Hardware](#hardware)
+  - [USB/Serial Connections Breakdown](#usbserial-connections-breakdown)
+  - [WACCA Serial Port Map](#wacca-serial-port-map)
+  - [Desktop specifications](#desktop-specifications)
+  - [Sound system](#sound-system)
+  - [Television](#television)
+  - [Power supplies](#power-supplies)
+- [PCB Details](#pcb-details)
+  - [Touch Unit Control Boards (PSS-7135-L02-01)](#touch-unit-control-boards-pss-7135-l02-01)
+  - [LED Data board (14-1497-R)](#led-data-board-14-1497-r)
+    - [Custom LED Driver](#custom-led-driver)
+  - [2.1 channel AMP (14-1466CR)](#21-channel-amp-14-1466cr)
+  - [Headphone AMP (00-1358AR)](#headphone-amp-00-1358ar)
+  - [I/O Control Board (837-15257-01)](#io-control-board-837-15257-01)
+  - [Card reader panel "ASSY CTRL PNL"](#card-reader-panel-assy-ctrl-pnl)
+  - [Touch Controller \& Sensor array](#touch-controller--sensor-array)
+- [Replacement LED PCBs](#replacement-led-pcbs)
+  - [Details on manufacturing your own LED PCBs](#details-on-manufacturing-your-own-led-pcbs)
+  - [BOM (for use with WS2813B-V5)](#bom-for-use-with-ws2813b-v5)
+  - [Soldering it all together](#soldering-it-all-together)
+  - [Replacing the board on the touch panel](#replacing-the-board-on-the-touch-panel)
+  - [Other hardware](#other-hardware)
+  - [Working inside the ALLS](#working-inside-the-alls)
+  - [Imaging your ALLS drive](#imaging-your-alls-drive)
+- [Other](#other)
+  - [Gooseneck Phone mount thing](#gooseneck-phone-mount-thing)
+  - [Gloves](#gloves)
+  - [Custom charts](#custom-charts)
+  - [Enabling front panel headphone jack on Fresh Windows Install](#enabling-front-panel-headphone-jack-on-fresh-windows-install)
+
+</details>
+
 ## Disclaimer
 
 Some information here is sourced from around the internet, of which I'm not sure if people wish to be credited for. You know who you are, let me know.
@@ -11,13 +48,20 @@ Many parts simply have not been extensively documented or are kept in private ci
 ## Service manual
 
 This PDF should be pretty easy to find online, there's also a shitty version that was fed through DEEPL to machine translate into english. This has a plethora of information that I won't directly post here since that's probably asking for a DMCA violation even for a dead game.
+
+---
+
 <br>
 
 # Hardware
 
+![Wacca I/O board](https://github.com/jbamuro/waccamole/raw/main/img/DSC00811.JPG)
+
 The anatomy of the cabinet an ALLS desktop connecting to a set of PCBs via two USB ports, three RS232 ports, two 3.5mm audio jacks, and digital video out to a 50 inch LCD (hdmi, displayport are supported WITH audio out).
 
-*TODO: Someone should double check this and update with more accurate info, I forgot where everything terminated when it was explained to me:*
+You can find a list of various informations related to the wacca hardware below.
+
+## USB/Serial Connections Breakdown
 
 ```text
 ALLS desktop RS232 1 --> Left Pentel PCB --> Left half of the touch controller
@@ -28,9 +72,7 @@ ALLS desktop USB 1 --> Sega IO
 ALLS desktop USB 2 --> LED Data board
 ```
 
----
+## WACCA Serial Port Map
-
-WACCA Serial Port Map :
 
 ```text
 COM1: Aime Reader
@@ -41,9 +83,7 @@ COM5: Keychip
 COM6: Console Lights
 ```
 
----
+## Desktop specifications
-
-Desktop specifications :
 
 ```text
 ALLS HX [849-0006]
@@ -59,9 +99,7 @@ https://seasonic.com/et SS-400ET
 RS232: 2 port + 1 port [Goes right to COM 1 COM 2 COM 3 on the motherboard]
 ```
 
----
+## Sound system
-
-Sound system :
 
 ```text
 Subwoofer: S02012D0 4OHM 40W ????
@@ -78,11 +116,7 @@ Dimensions(WxHxD)	120x90x97.5
 Total Mass	605g
 ```
 
-I believe [these](<https://www.crutchfield.com/S-nMsSvT4rfnE/p_108R6532EM/Infinity-Reference-REF-6532ex.html?omnews=17719017>) may work as a suitable replacement (at least they are for SDVX)
+## Television
-
----
-
-Television :
 
 ```text
 Advanced Display Lab Inc.
@@ -96,44 +130,45 @@ P/N: 1001500-102002-32
 InnoLux S500HJ1-LE8 Rev. C1
 09C1L1293620075
 https://www.panelook.com/S500HJ1-LE8_Innolux_50_LCM_overview_32625.html
-
 ```
 
-<br>
+## Power supplies
-
-# PCB Details
-
-![Wacca I/O board](https://github.com/jbamuro/waccamole/raw/main/img/DSC00811.JPG)
-
-**Power supplies:**
-
-![Power supplies](https://github.com/jbamuro/waccamole/raw/main/img/DSC00812.JPG)
 
 ```text
 LFA150F-12-J1 150W 12V 50-60Hz 12.5A IN AC100-240V
 LFA150F-5-J1Y 150W 5V 50-60Hz 30A IN AC100-240V
 ```
 
+![Power supplies](https://github.com/jbamuro/waccamole/raw/main/img/DSC00812.JPG)
+
 These two units supply all the power needed for the PCB components (sound system, LEDs, touch controller etc).
 My photos will look a little different at the bottom as we had to jerry rig an extension cable to feed power into the unit since I don't have the original cabling for it. Works fine on American power, there are also reports of it working fine in europe.
 
-R1 uses a 300VA [step down transformer](https://cdn.discordapp.com/attachments/267603668046446603/1045057845999173692/IMG_20221123_112537805_HDR.jpg) but that's probably overkill.
+R1 uses a 300VA but that's probably overkill.
 
-Hits about 200W during the attract. TODO: power info during songlist pull etc.
+![step down transformer](https://cdn.discordapp.com/attachments/267603668046446603/1045057845999173692/IMG_20221123_112537805_HDR.jpg)
+
+Hits about 200W during attract mode.
+TODO: power info during songlist pull etc.
 
 ---
 
-**Touch Unit Control Boards (PSS-7135-L02-01)**
+<br>
+
+# PCB Details
+
+## Touch Unit Control Boards (PSS-7135-L02-01)
+
 There are two of these and they each process 6 segments. Together they control the two halves of the touch controller assembly (for a total of 12 segments).
 
 ![Master Touch Unit Control Board](https://github.com/jbamuro/waccamole/raw/main/img/DSC00814.JPG "Master Touch Unit Control Board for the 6 segments on the right of the touch assembly (Can be determined thanks to it's ID, currently set to 8. The controller ID for the left segments is 7)")
 
 Each segment of the touch controller is connected to the others with the help of RS485 through a ribbon cable.
 The PCBs present on each segment are the exact same with the addition of a custom Pentel IC and some extra components needed to drive the tactile sensor array.
+
 ![Pentel IC](https://github.com/jbamuro/waccamole/raw/main/img/DSC00835.JPG "The custom Pentel IC handling tactile input")
 
 *Here's a detailed component list of those boards :*
-![Touch Unit Control Board](https://cdn.discordapp.com/attachments/568491469799817246/1143576271461302333/Top_View.jpg "Top view of the PCB")
 
 | Component | Reference         | Comment  |
 | --------- | ----------------- | -------- |
@@ -148,50 +183,85 @@ The PCBs present on each segment are the exact same with the addition of a custo
 | RG1       | XC6206 662K 3.3V 0.5A Voltage regulator | 3.3V 0.5A Voltage regulator |
 | RG2       | [178M05 91 03](https://datasheetspdf.com/pdf-file/614024/HitachiSemiconductor/178M05/1) | 5V 0.5A Fixed Voltage regulator |
 
+<details><summary>Click to show a Top View picture of the PCB</summary>
+
+![Touch Unit Control Board](https://cdn.discordapp.com/attachments/568491469799817246/1143576271461302333/Top_View.jpg "Top view of the PCB")
+
+</details>
+
 <br>
 
----
 
-**LED Data board (14-1497-R)**
+## LED Data board (14-1497-R)
+
+It sends the pretty colors to the touch controller.
+
 ![LED Data board](https://github.com/jbamuro/waccamole/raw/main/img/DSC00813.JPG "An LED Data board, connected to the ALLS using usb")
-This sends the pretty colors to the touch controller.
 
-Attempts to swap the board to an Adafruit FT232H breakout board to replace LED driver ongoing, Wacca LED tests pass fine, but no data seems to be sent out from pin 14.
+Here's a rundown of what this board is made out of :
 
-```
+| Component | Reference         | Comment  |
-IC1: FTDI FT232HL - Single Channel HiSpeed USB to Multipurpose UART/FIFO IC
+| --------- | ----------------- | -------- |
-Datasheet: https://ftdichip.com/wp-content/uploads/2020/07/DS_FT232H.pdf
+| IC1 | [FT232HL FTDI](https://ftdichip.com/wp-content/uploads/2020/07/DS_FT232H.pdf) | Single Channel HiSpeed USB to Multipurpose UART/FIFO IC |
+| IC2 | [93LC56B](https://www.microchip.com/en-us/product/93lc56b) | EEPROM for USB descriptor and VID/PID, 6 pin variant  |
+| IC3 | [SN74AHCT1G86](https://www.ti.com/lit/ds/symlink/sn74ahct1g86.pdf) | Single 2-Input XOR Gate |
 
-IC2: (93lc56b 6 pin?) eeprom for USB descriptor and VID/PID
+```text
-Datasheet: https://www.microchip.com/en-us/product/93lc56b
+ Additional info:
-
-IC3: B86J (sn74ahct1g86) Single 2-Input XOR Gate
-Datasheet: https://www.ti.com/lit/ds/symlink/sn74ahct1g86.pdf
-
-	Additional info:
 IC3 Pin# 1 - MOSI from FT232HL (Pin 14)
 IC3 Pin# 2 - trace runs to one pad of R10, through R11 (10k ohm resistor), to ground
 IC3 Pin# 3 - Ground
 IC3 Pin# 4 - LED data out into R12 (100 ohm resistor) to CN2 (LED Data/Ground out)
-IC3 Pin# 5 - (5v?) VCC in
+IC3 Pin# 5 - 5V, VCC in
-
 ```
 
----
+### Custom LED Driver
+
+If you want to make a custom LED Driver replacement, instructions, software and adapter link are below.
+
+![Wacca LEDs](https://cdn.discordapp.com/attachments/568491469799817246/1144020876740808824/PXL_20230822_121850510.jpg "Look at how pretty this is ! (don't mind the weird LED strip on the right)")
+
+The ftdi adapter we use is an [Adafruit FT232H](https://www.adafruit.com/product/2264)
+To flash it with the proper firmware you'll need the [FT_PROG EEPROM programmer](https://ftdichip.com/wp-content/uploads/2023/08/FT_Prog_v3.12.37.642-Installer.exe_.zip) software
+
+The flashing instructions are as follows :
+
+```text
+Ensure the FTDI d2xx drivers are installed and the FT232H board is the only FTDI device connected to your computer (verify this by opening Device Manager and inspecting each device under the COM & LPT ports drop down if you're unsure).
+
+Open FT_PROG and navigate to "DEVICES" > "Scan and Parse" you will see a new device populate in the device tree.
+
+Click on the device in the tree and verify "Chip Type:" is 'FT232H' as this will be the Adafruit board.
+
+Navigate to "USB String Descriptors" under the "FT EEPROM" section of the Device tree and change the "Product Description" field to "Single RS232-HS" and ensure the Serial Number field is blank, and the Serial Number Enabled box is unchecked.
+
+Navigate to the "Driver" tab in the device tree under "Hardware Specific" > "Port A" and ensure "Virtual COM Port" is the checked option and D2XX Direct is not selected.
+
+Right click the root Device in the device tree and click "Program Device"
+
+Once the programming has been completed disconnect the USB cable and reconnect it.
+
+Open your Windows Device Manager if it is not already and navigate to "USB Serial Converter" Under the "Universal Serial Bus Controllers" click Properties and navigate to the "Advanced" tab, ensure "Load VCP" is checked. Close the window and disconnect the USB cable and reconnect it.
+
+Within the Device manager navigate to "USB Serial Port (COM*)" under "Ports (COM & LPT)" right click, select "Properties" > "Port Settings" > "Advanced" > "COM Port Number" and select "COM6" disconnect the USB cable and reconnect it.
+
+Connect a wire to GND for LED Ground, and a wire to pin D1 for LED Data
+
+Load the game and you should have LED activity disaplaying if everything is configured correctly.
+```
+
+## 2.1 channel AMP (14-1466CR)
 
-**2.1 channel AMP (14-1466CR)**
 ![2.1 channel AMP](https://github.com/jbamuro/waccamole/raw/main/img/DSC00816.JPG "2.1 channel AMP (14-1466CR), Handles analog sound routing to subwoofer and tweeters")
 Handles analog sound routing to subwoofer and tweeters
 
----
+## Headphone AMP (00-1358AR)
 
-**Headphone AMP (00-1358AR)**
 ![Headphone Amplifier](https://github.com/jbamuro/waccamole/raw/main/img/DSC00815.JPG "Headphone Amplifier (00-1358AR), Handles audio output to the control panel")
 Handles audio output to the control panel
 
----
+## I/O Control Board (837-15257-01)
 
-**I/O Control Board (837-15257-01)**
 ![I/O Control Board](https://github.com/jbamuro/waccamole/raw/main/img/DSC00817.JPG)
  The existence of this board is a bit overkill for what it's used for, likely it *had* to be used due to Sega producing the cabinets for Marvelous. This is a newer version of the control board that has a USB port on it, almost all sega cabs use this now.
 
@@ -208,7 +278,7 @@ This giant metal LED lined panel has [4] plugs that connect to
 
 The coin entry stuff connected to the cash box is here too.
 
-## Touch Controller
+## Touch Controller & Sensor array
 
 The touch controller assembly is composed of 12 segments divided into two halves (6 per side, each having their own main controller board). They each have an individual channel ranging from 1 to 6.
 
@@ -216,7 +286,6 @@ The touch controller assembly is composed of 12 segments divided into two halves
 
 Each one of these weighs 1kg (2.2LBS) *(870g if the metal bracket is removed)* which totals to about 12kg (26LBS).
 
----
 
 Each unit has 5 LED strips (each strip has 8 LEDs making for a total of 40 LEDs per segment). In total, there are 480 LEDs in the touch controller assembly
 
@@ -227,13 +296,14 @@ Click [here](https://cdn.discordapp.com/attachments/297114097546297354/106844254
 Somehow I never really understood how MASSIVE these units are until I held an individual segment in my hand.
 ![This shit is massive](https://media.discordapp.net/attachments/568491469799817246/1143563743557591070/PXL_20230822_151247219.jpg "")
 
----
 
 Here are some scans of a segment that shows the curve profile.
 <br><img src="https://github.com/jbamuro/waccamole/raw/main/img/concurve1.png" data-canonical-src="https://github.com/jbamuro/waccamole/raw/main/img/concurve1.png" width="150" height="150"/>
 <img src="https://github.com/jbamuro/waccamole/raw/main/img/concurve2.png" data-canonical-src="https://github.com/jbamuro/waccamole/raw/main/img/concurve2.png" width="150" height="150"/>
 <img src="https://github.com/jbamuro/waccamole/raw/main/img/concurve3.png" data-canonical-src="https://github.com/jbamuro/waccamole/raw/main/img/concurve3.png" width="150" height="150"/>
 
+---
+
 <br>
 
 # Replacement LED PCBs
@@ -399,7 +469,7 @@ we want to access the wacca drive. replace `/dev/sd<wacca-drive>` with whatever
 
   Checks permission of the drive, should match the original
 
-  `fdisk -; wacca.img`
+  `fdisk -l wacca.img`
 
   To compare the sector count, should match the original
 
@@ -413,6 +483,8 @@ UNKNOWN: expand the existing partition possible? would be good for the future of
 
 <br>
 
+---
+
 # Other
 
 USB capture cards can be used to stream Wacca.