Bit Bang Gaming V2 Magicians SOCD Cleaner Instruction Manual

: June 10, 2024
: bit BANG GAMING

Table of Contents

A Note from Bit Bang Gaming
Safety & Modding Disclaimer
Icons Used in this Manual
Production Description
Mechanical
Electrical
Configuration
Troubleshooting
Firmware
More Information
References
Read User Manual Online (PDF format)
Download This Manual (PDF format)

Bit Bang Gaming V2 Magicians SOCD Cleaner Instruction Manual

A Note from Bit Bang Gaming

Hello! Thank you for purchasing the Magicians SOCD Cleaner V2!

The chip shortage robbed us of the Magicians SOCD Cleaner V1 which is the main reason why we were not able to build and carry it. But ever since we have identified a replacement chip, the Magicians SOCD Cleaner is back better than ever with the new V2.

Even though we had a good baseline for creating the newest version, there has been a lot of effort and challenges to incorporate new features. We made the FGC’s best SOCD cleaner even better with app integration, profiles to save and choose from in real time, a power input port to use bypass harness more easily, and even a custom SOCD rule maker.

Enjoy it!

Sincerely,
Joe
Bit Bang Gaming LLC

Safety & Modding Disclaimer

This product is to be used in a bigger electrical installation. It requires some basic knowledge of mechanical and electrical systems from you, the modder. While the necessary skills are not difficult to learn, it is still required for a successful installation. Some precautions to be mindful of are listed below. It is by no means an exhaustive list but is a step in the right direction.

Always wear safety glasses to prevent debris from flying into your eyes when altering material by drilling, cutting, grinding, etc.
Always use the right tool for the right job. For example, using a lighter instead of a heat gun to heat shrink a solder connection may work but it is not the suggested practice as there is a risk of fire and the release of noxious fumes.
Always work in a well-ventilated area when the modding activity might release airborne debris or fumes. A mask or fume extractor may be required if modding in a small space or if there is an excess of debris or fumes.
Always treat electricity with respect. Just because it is low voltage does not mean damage to you or to the equipment is not possible.
Always disconnect power while modding. If you need make measurements or observe a behavior, make sure that wiring and equipment are secured enough to not cause them to move in an unfavorable manner where damage may result, and then connect power.
Always use a fuse with battery mods. If the battery is rechargeable, always make sure that the charging and protection circuits are in place before using.
Always double check polarity with reliable documentation or a multimeter wherever necessary.
Never start modding something when you’re not confident you understand the process. Ask for help instead from the modding community or contact us.

When properly installed, this product will not cause damage to your existing equipment or system. We are not responsible or liable for damage of any kind from improper installation practices. By continuing with this installation manual, you accept the risks and agree that you are proficient in making a successful installation.

You also agree to have fun! Modding is a fun hobby to learn new things and building something cool, and to be proud of. Don’t let this page scare you! We are here to help every step of the way, and the community is extremely friendly so don’t be afraid to ask any questions you may have.

Icons Used in this Manual

Throughout this manual, a few icons will be used to highlight certain aspects of a topic.

The Note icon will be used for something you should remember about a particular topic.

The Tip icon will be used for something that you should consider doing or a shortcut that you can benefit from.

The Warning icon will be used when you should be extremely careful and aware of something.

Production Description

Overview
The Magicians SOCD Cleaner V2 gives you the ability to add SOCD cleaning to nearly
any OEM controller and control board. With 25 different SOCD combinations and a custom SOCD rule creator, this is the gold standard. It you are looking for the best SOCD cleaner out there, you have found it!

Connectivity
The Magicians SOCD Cleaner V2 makes it simple to wire the following features:

Power input via a two-pin screw terminal block and Pass-thru Harness port. These ports are protected from accidental reverse voltage conditions. The Pass-thru Harness port makes it easier to use aftermarket pass thru cables so that there is no reason to ever tap into the sticks power lines.
Direction inputs via a five-pin screw terminal block. Having it as a screw terminal makes it easy to accommodate the wiring scheme of your setup.
Cleaned outputs via a five pin JST NH connector, commonly used for arcade joysticks and to make integration easier with your controller’s built-in cable or to easily use with an after-market harness.
Micro USB port to offer a quick power test and for updating the firmware via a PC.
Comes with a configuration smart phone app that connects via Bluetooth Low Energy (BLE) to quickly configure and test the Magicians SOCD Cleaner during installation. Can also be used to quickly change modes between matches.
OMNI port for both direction inputs and LED output making integration with accessories such as the ODIN and LOKI a snap.

Configuration
All configuration is performed via a phone app. This makes it easy to read and configure features such as:

Changing SOCD cleaning modes, with 25 to choose from.
Creating your own SOCD rules when you need extra control.
Saving between four different profiles to switch in between matches and games.
Changing the cleaned output connector mapping for any control board pinout.
Changing the cleaned output connector logic convention for compatibility with most control board.
Real time testing of cleaned outputs to ensure the cleaning profile is configured exactly how you intended it to be.
Changing the type of BLE advertising to save on battery power or to prevent other players from messing with your settings.
Reading PCB and app information to stay informed on your setup’s version.

Firmware Updates
We will provide future firmware support.

Firmware is updateable over Micro USB port.
Flashing can be performed on Windows using microcontroller’s native program applications

Tip icon You can find the latest firmware on the Magicians SOCD Cleaner V2 product page or on our resources page: https://bitbanggaming.com/pages/resources

Mechanical

Mounting the Board
The dimensions of the Magicians SOCD Cleaner V2 is based off our previous SOCD cleaner designs. This form factor offers simple and compact footprint for mounting within a controller case. It features four mounting holes that are 0.122in (3.10mm) in diameter.
Diminsion

Warning Icon Always elevate the board a few cm away from the mounting surface. Never directly mount board surface to a metal surface (risk of shorting) or to a plastic surface (risk of ESD). It is always best to use the mounting holes to prevent any damage.

Snap-In Adhesive PCB Feet
This mounting method uses four little feet that snap through the board’s mounting holes.
These feet then mount with double sided tape to a location in a controller. It is a common and easy way to mount electronics inside of an arcade controller. We offer these for sale on our website. Other reputable arcade parts retailers also offer them for sale.

Screw-In PCB Feet
This mounting method uses four little feet that screw through the board’s mounting holes.
These feet then mount with screws to a location in a controller. Screw mounting is common on controllers where drilling is easy and practical, such as one made from wood. We offer these for sale on our website. Other reputable arcade parts retailers also offer them for sale.

Electrical

Example Wiring Diagram
The below wiring diagram example shows the complete hookup using buttons. If using an ODIN or LOKI, the OMNI and LED ports will be used. If using a pass-thru harness, it is not necessary to connect the two-pin screw terminal.
Specifications
The table below shows an overview of the electrical system and its general specifications.
These will be explained later in more detail, but this is a good resource if you are already familiar with the electrical system and just need some quick info.

Magicians SOCD Cleaner V2 – Electrical Specifications

For additional specifications, please contact us and we can update the table in this manual to include your request.

Sending Power to the Board
The Magicians SOCD Cleaner V2 has a few different ways it can be powered up. It can be powered by the:

Power input screw terminal block
Pass-thru Harness Port
Micro USB port

Warning Icon Never try to power the board with higher voltage supplies that are above 6VDC! For example, 12VDC, 48VDC, 120VAC, etc. Over-voltage will damage the board!

Note Icon The power input screw terminal block can theoretically handle up to 15VDC but the internal regulator might overheat and temporarily shut down to protect itself. It will also draw more current if doing an advanced install, please take note of this.

When planning a scheme for input power, it is suggested to never apply voltage to more than one port at a time. However, no harm will result if for example the USB port and the power input screw terminal both have voltage applied to them. Internally, they are diode “OR’d” which means that current will be drawn by whichever power source has the higher voltage.

Connector Map

Connector Map

Power Input Screw Terminal Block
Pass-thru Harness Port
Button Input Screw Terminal Block
Cleaned Output Port
Micro USB Port
OMNI Port
LED Port

Pinouts & Descriptions
The Magicians SOCD Cleaner V2 is simple to put together if you have done a similar type of mod. If this is your first time putting something like this together, we highly suggest reading this entire section to get acquainted with all the connections.

Power Input Screw Terminal Block
The main way to connect power. Wire up +5V and ground and you are all set. On after-market controller boards such as a Brook board, you can tap power off its screw terminal block. If it is an OEM control board, you will need to tap into the USB power lines. The power input here is protected from reverse polarity

Pin #	Name	Typical Color
1	V+	RED
2	GROUND	BLACK

Connection Type: Screw Terminal, 18-30AWG wire
Connector Map Number: 1

Pass-thru Harness Port
Where to connect a pass-thru harness so that it is not necessary to modify your controller’s power wiring. Vendors such as Focus Attack carry this

Connection Type: JST ZH
Connector Map Number: 2

Note Icon If your control board does not offer an easy way to tap power or you are not able to get a pass-thru harness, you will need to either t-tap (these are included along with some wiring with sample demo here) or manually tap (requires wire strippers or knife, and a steady hand with some electrical tape). This may be difficult for you to do if you are not comfortable with electrical wiring mods.

Button Input Screw Terminal Block
Wire your buttons to this terminal block. Note that there is no standard color code. The harness for your buttons is usually colorful but the color code highly depends on the button harnesses you have. For easier wiring, it is advisable to purchase an All-Button Harness.

Pin #	Name	Typical Color
1	GND	BLACK
2	RIGHT	BLACK
3	LEFT	BLACK
4	UP	BLACK
5	DOWN	BLACK

Connection Type: Screw Terminal, 18-30AWG wire
Connector Map Number: 3

Cleaned Output Port
This is where the output comes from. The inputs from the direction buttons are used to create a cleaned (or rather a magical!) output.

Pin #	Name	Typical Color
1	GND	BLACK
2	MAPPABLE	GREEN
3	MAPPABLE	YELLOW
4	MAPPABLE	ORANGE
5	MAPPABLE	RED

Connection Type: JST NH, male header
Connector Map Number: 4

Warning Icon If using a board with positive logic (like a zero delay board), it will likely have pin 1 as 5V so do not connect it to the Cleaned Output Port! If you do, you run the risk of damaging your setup or anything it is connected to. Be extremely careful!

Micro USB Port
Where to connect a USB cable when performing a firmware update. Alternatively, you can use this to power up the board. But in most installations, it will be left unplugged.

Connection Type: Micro USB
Connector Map Number: 5

OMNI Port & LED Port
This is where devices like the ODIN or LOKI are plugged into. Be sure to use the black stem board included with their kit. The LED port is an output that will power the LEDs on the ODIN or LOKI. There is no series resistor for the LED port.

Connection Types: JST XH, male headers
Connector Map Numbers: 6 & 7

Configuration

Setup the Magicians SOCD Cleaner V2

Magicians SOCD Cleaner V2

Once the electrical installation is complete, the only thing required for setting up to configure is to power the controller and to have a smart phone with the Magicians SOCD Cleaner V2 app installed. The app is available on both the Google Play Store and Apple App Store and is the only way to configure the Magicians SOCD Cleaner V2. Communication to the board is over BLE. Search “Magicians SOCD Cleaner V2” to find the app.

Initiating a BLE Connection
Open the app and you will be greeted with a screen to scan for nearby Magicians SOCD V2 devices. When you press Scan, it will take a few moments for this to take place. If more than a minute passes by with nothing happening, ensure that the Magicians SOCD Cleaner V2 is powered on. If it is, restart the app and try again. After scanning, a drop menu will show up saying to Choose Your Device. Pressing this will show all Magicians SOCD Cleaner V2 devices detected nearby, simply scroll down the menu until you find yours. Chances are only one will show up. Once it is chosen, you will be able to connect to the board. The board will indicate it is connected to BLE by turning the status RGB LED from white to blue.

Note Icon Each Magicians SOCD Cleaner V2 has a unique BLE ID it advertises. It will always begin with “MAGICV2:”, followed by a unique sequence of characters and/or numbers. Be sure to remember yours so you don’t accidently connect to someone else’s board!

Main Menu
The main menu shows all the latest features. Upon initial release, the following features be available:

Change SOCD cleaning modes, with 25 to choose from.
Create your own SOCD rules.
Save between four different profiles.
Change the cleaned output connector mapping.
Change the cleaned output connector logic convention.
Real time testing of cleaned outputs.
Change the type of BLE advertising.
Read PCB and app information.

Updates occur on occasion so be sure to check back on our website or discord to see if there any to apply.

Note Icon The on-board status RGB LED will turn green whenever a direction button is pushed. When not connected to BLE, neutral is indicated as white, but when connected to BLE it is indicated as blue.

Cleaning Modes & Testing
Cleaning modes are chosen per axis until using the SOCD rule maker. Simply press the mode you want, and it will be instantly configured on the profile you have selected. Press the Test button to bring you to the Test Mode for live, detailed testing. Upon initial release, the following modes will be available:

Clean to neutral
Clean to min cardinal (left or down)
Clean to max cardinal (right or up)
Clean to last input priority
Bypass cleaning
Custom SOCD rule

Mapping & Logic
It is possible to map the cleaned output connector direction outputs making it possible to interface with any combination the control board requires. Logic will invert the signals; negative logic is the most common. If using a zero delay board, be sure to switch this over to positive logic.

BLE Mode
By default, the Magicians SOCD Cleaner V2 will automatically advertise itself to be connected to by anyone that has the app downloaded. It is possible to not advertise at all. Simply hold the left and right buttons while powering up the controller. This makes it easy to stop others from messing with your settings or to save power if your controller runs on batteries. This behavior is defined as Automatic in the BLE Mode screen.

It is possible to invert this behavior by setting the BLE Mode to Manual. This means that by default, the board will never advertise. To make it advertise, hold down the left and right buttons while powering up the controller.

Tip icon If playing in a tournament, it might be easier to have your phone connected to the board at all times to block anyone else from using it while also making it easier to switch modes between matches. It is a matter of preference.

Device Info
Gives some basic info about the PCB and app.

Disconnect From Bluetooth
Press this button to leave the connection from the board. The status RGB LED will turn back to white. If the board is powered off during a connection, the app will crash. Simply restart it to get it working again after powering up the board.

Share On Twitter
This button makes it easy to share about everyone involved in making the Magicians SOCD Cleaner V2 possible. There is a predefined message loaded once you choose Twitter. You can change the message if you’d like but be sure to @ us so we know how you are liking everything!

Troubleshooting

This section is most useful by using a multi-meter. If you are unsure where to get one or use one, here is a great YouTube video to get you started: https://www.youtube.com/watch?v=bF3OyQ3HwfU

No Power
Sometimes there might be an instance where power is being applied, but it will not turn on or intermittently turns on. Try the following to see if this resolves your issue:

Ensure that the cable you made or purchased measures to have voltage where the board will be receiving it or check that the cable does not have a break in it by measuring the continuity.
Ensure that the cable you made or purchased has been plugged into the correct port.
Ensure that the cable you made or purchased has the correct pinout. This can be performed by using a muti-meter and measuring the continuity for correctly wired pins.

No Button Signal
Sometimes there might be an instance where a button is being pushed but it will not turn on or intermittently turns on. Try the following to see if this resolves your issue:

Ensure that the cable you made or purchased does not have a break in it by measuring the continuity.
Ensure that the cable you made or purchased has been plugged into the correct port or is wired to the correct terminal.
Ensure that the cable you made or purchased has the correct pinout. This can be performed by using a muti-meter and measuring the continuity for correctly wired pins.

Latency
Latency should be extremely low. We do not have any measured results yet because this value might change as the firmware matures but last measurement was around 0.1ms. It might be faster with an optimization we make in the future. Latency of any kind should not be so slow that you can easily see the difference. As the firmware matures, and required updates start to slow down, formal measurements may be provided.

Firmware

Bugs
When this product was being developed, lots of bugs have been squashed but there could still be some hiding underneath a bit of code somewhere. If you find one, please let us know and we will work on a firmware fix to release.

Update Procedure
New firmware can be flashed through the micro USB port on the board. The board uses a modern 32-bit microcontroller from Espressif. This company has a software called Flash Download Tools, that enables the ability to flash the chip. At this time of this writing, they only offer this software for Windows. The process shows examples with the Antagonist V2 but the process is identical.

Download the latest firmware files from the product page. It will be a zipped file. Unzip it and note its location as it will be used in a future step.
Next visit https://www.espressif.com/en/support/download/othertoolskeys=&field_type_tid%5B%5D=842
Download the software called Flash Download Tools.
Once it’s download, unzip the contents.
Open up the unzipped folder and run flash_download_tool_3.9.2.exe.
When it runs, two windows will pop up. One is a command-like screen that will output status messages, and another asking to configure some setting. Configure as shown below and then click OK.”
The settings window will be replaced with different window. We will now be using the firmware files downloaded from Step 1. Take a look at the window below.

Once complete, the configuration should look like the window above. Please keep following on to do this.
Notice the first four rows that are checked and highlighted in green. This is where you input the files you downloaded from the product page. To choose a BIN file to input, click the three dots icon to the right. It will open File Explorer so that you can navigate to where those files are. If you did not move its location, it will likely still be in your downloads folder.
The files should be chosen in the following order to make it easier to follow along:
bootloader.bin
partition-table.bin
ota_data_initial.bin
f_antagonist-v2.bin
Once you have chosen all of the BIN files, you now need to type in the address to write the BIN files to. Below shows the same order as before but with the addresses:
0x0
0x8000
0xd000
0x10000
Be sure that each row has the box checked next to it.
It is extremely important to have the addresses correct. Please triple check to make sure it matches exactly as shown and not out of order.
8. Under the menu called SpiFlashConfig, make sure the settings are set exactly how the example configuration was shown earlier. That means:
- SPI SPEED = 80MHz
- SPI MODE = DIO
- DoNotChgBin = CHECKED
Next plug in the Magicians SOCD Cleaner V2 to the PC via a USB cable. Once plugged in, Windows should be detecting and installing drivers for it. Once complete, navigate to your Device Manager to see which COM port was created. Below, it is shown as COM11.
On the bottom right of the flash tool, choose the COM to be the COM port that was recently detected by Windows, in our example, this is COM11. Choose BAUD to be 115200.
Please check over all of the settings and file locations again. Once you are certain all looks to be just like the beginning of this section, press the START button. Once pressed, you will see the below occurring:
Once complete, Download Panel 1 will say FINISH. To finish the flashing, press the STOP button. If this is not pressed, the flash process will not be completely correct and you will need to restart the flash process.
The flashing process is now complete! Unplug the Magicians SOCD Cleaner V2 from the USB cable and repower it in your controller set up. You can confirm the firmware has changed either by noticing a change in a feature you were after or by connecting to the app and going into the System Info menu to see the firmware version the Magicians SOCD Cleaner V2 is running.