bit BANG GAMING Magicians SOCD Guide
Magicians SOCD Cleaner V2 Table of Contents
Table of Contents
Section 1: A Note from Bit Bang Gaming ............................1
Section 2: Safety & Modding Disclaimer .............................2
Section 3: Icons Used in this Manual ..................................3
Section 4: Production Description.......................................4
Overview............................................................................................................................................. 4
Connectivity....................................................................................................................................... 4
Firmware Updates............................................................................................................................ 5
Section 5: Mechanical ...........................................................6
Mounting the Board......................................................................................................................... 6
Snap-In Adhesive PCB Feet......................................................................................................... 6
Screw-In PCB Feet ........................................................................................................................ 6
Section 6: Electrical ..............................................................7
Example Wiring Diagram................................................................................................................ 7
Specifications.................................................................................................................................... 7
Sending Power to the Board ......................................................................................................... 8
Connector Map.................................................................................................................................. 8
Pinouts & Descriptions................................................................................................................... 9
Power Input Screw Terminal Block.............................................................................................. 9
Pass-thru Harness Port ................................................................................................................. 9
Button Input Screw Terminal Block............................................................................................ 10
Cleaned Output Port .................................................................................................................... 10
Micro USB Port ..............................................................................................................................11
OMNI Port & LED Port..................................................................................................................11
Section 7: Configuration.....................................................12
Setup the Magicians SOCD Cleaner V2 ................................................................................... 12
Initiating a BLE Connection ........................................................................................................ 12
Main Menu..................................................................................................................................... 13
Cleaning Modes & Testing .......................................................................................................... 13
Mapping & Logic........................................................................................................................... 13
BLE Mode...................................................................................................................................... 13
Magicians SOCD Cleaner V2 Table of Contents
Device Info..................................................................................................................................... 14
Disconnect From Bluetooth ........................................................................................................ 14
Share On Twitter........................................................................................................................... 14
Section 9: Troubleshooting ................................................15
No Power .......................................................................................................................................... 15
No Button Signal ............................................................................................................................ 15
Latency.............................................................................................................................................. 15
Section 10: Firmware ..........................................................16
Bugs................................................................................................................................................... 16
Update Procedure .......................................................................................................................... 16
Section 11: More Information .............................................21
Where to Get Additional Support............................................................................................... 21
Document Revision Notes ........................................................................................................... 21
Magicians SOCD Cleaner V2 Section 1: A Note from Bit Bang Gaming
INSTALLATION MANUAL & USER GUIDE
REV B
PAGE 1
Section 1: 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
Magicians SOCD Cleaner V2 Section 2: Safety & Modding Disclaimer
INSTALLATION MANUAL & USER GUIDE
REV B
PAGE 2
Section 2: 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.
1. Always wear safety glasses to prevent debris from flying into your eyes when
altering material by drilling, cutting, grinding, etc.
2. 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.
3. 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.
4. Always treat electricity with respect. Just because it is low voltage does not mean
damage to you or to the equipment is not possible.
5. 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.
6. 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.
7. Always double check polarity with reliable documentation or a multimeter wherever
necessary.
8. 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.
Magicians SOCD Cleaner V2 Section 3: Icons Used in This Manual
INSTALLATION MANUAL & USER GUIDE
REV B
PAGE 3
Section 3: 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 beused 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.
Magicians SOCD Cleaner V2 Section 4: Product Description
INSTALLATION MANUAL & USER GUIDE
REV B
PAGE 4
Section 4: 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.
Magicians SOCD Cleaner V2 Section 4: Product Description
INSTALLATION MANUAL & USER GUIDE
REV B
PAGE 5
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.
You can find the latest firmware on the Magicians SOCD
Cleaner V2 product page or on our resources page:
https://bitbanggaming.com/pages/resources
Magicians SOCD Cleaner V2 Section 5: Mechanical
INSTALLATION MANUAL & USER GUIDE
REV B
PAGE 6
Section 5: 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.
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.
Magicians SOCD Cleaner V2 Section 6: Electrical
INSTALLATION MANUAL & USER GUIDE
REV B
PAGE 7
Section 6: 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
Spec.
Value
Note
Operating Voltage
4V – 6V
Must be powered to work
properly. Not guaranteed to
work if outside this range
Max Current Draw
~120mA
When BLE is enabled.
~55mA
When BLE is disabled.
Signal Inputs
Common ground
Common voltage or rail will
not work.
Signal Outputs
Push-Pull
This means the signal
swings from 0V to ~3.3V.
Gauge Accepted on Screw
Terminal Block
18 – 30 AWG
Phillips or flat head
screwdriver depending on
terminal block availability.
For additional specifications, please contact us and we can update the table in this manual to
include your request.
Magicians SOCD Cleaner V2 Section 6: Electrical
INSTALLATION MANUAL & USER GUIDE
REV B
PAGE 8
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
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!
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
1
Power Input Screw Terminal Block
5
Micro USB Port
2
Pass-thru Harness Port
6
OMNI Port
3
Button Input Screw Terminal Block
7
LED Port
4
Cleaned Output Port
1
5
2
3
4
6
7
Magicians SOCD Cleaner V2 Section 6: Electrical
INSTALLATION MANUAL & USER GUIDE
REV B
PAGE 9
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
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.
Pin 1
Pin 2
Magicians SOCD Cleaner V2 Section 6: Electrical
INSTALLATION MANUAL & USER GUIDE
REV B
PAGE 10
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
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!
Pin 1
Pin 1
Magicians SOCD Cleaner V2 Section 6: Electrical
INSTALLATION MANUAL & USER GUIDE
REV B
PAGE 11
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
Magicians SOCD Cleaner V2 Section 7: Configuration
INSTALLATION MANUAL & USER GUIDE
REV B
PAGE 12
Section 7: Configuration
Setup the 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.
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!
Magicians SOCD Cleaner V2 Section 7: Configuration
INSTALLATION MANUAL & USER GUIDE
REV B
PAGE 13
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.
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
Magicians SOCD Cleaner V2 Section 7: Configuration
INSTALLATION MANUAL & USER GUIDE
REV B
PAGE 14
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.
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!
Magicians SOCD Cleaner V2 Section 9: Troubleshooting
INSTALLATION MANUAL & USER GUIDE
REV B
PAGE 15
Section 9: 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.
Magicians SOCD Cleaner V2 Section 10: Firmware
INSTALLATION MANUAL & USER GUIDE
REV B
PAGE 16
Section 10: 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.
1. 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.
2. Next visit https://www.espressif.com/en/support/download/other-
tools?keys=&field_type_tid%5B%5D=842
3. Download the software called Flash Download Tools.
4. Once it’s download, unzip the contents.
Magicians SOCD Cleaner V2 Section 10: Firmware
INSTALLATION MANUAL & USER GUIDE
REV B
PAGE 17
5. Open up the unzipped folder and run flash_download_tool_3.9.2.exe.
6. 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.
Table of contents
