iidx-twinkIO

Arduino implementation of Twinkle IO interface.

What is this?

This project allows your arduino to control Sub-IO, or effector panel (16-segment displays) and top lights (spotlights, neons) on your Beatmania IIDX Deluxe cabinet, independently from an official IO, without rewiring anything.

Additionally, it also allows you to read slider values, and if your cab is from Twinkle era (grey door), front plate button inputs and turntable position as well (only if it doesn't have a bypass cable installed, which it probably does).

This project is helpful if:

• You are using a third-party or modified IO board that doesn't have the ability to control Sub-IO
• You have just the effector plate lying around and want to display something on the ticker

How do I use it?

Hardware

You will need:

• Arduino (or any compatible board, preferably with 5v logic level and 3.3v power out)
  • Some means to step down the VCC voltage to something lower if it doesn't have 3.3v out
• RJ-45 breakout board (or DIN8 if your cab uses that)
• Optionally, RS-422 module for receiving inputs

---

Wirings for the RJ-45 port is as follows:

RJ-45 Pin	Description	Direction
1	Data Input Z	RX
2	Data Input Y	RX
3	Enable Output B	TX
6	Enable Output A	TX
4	Data Output B	TX
5	Data Output A	TX
7	Clock Output B	TX
8	Clock Output A	TX

If you have a newer cab that uses DIN8 instead, you may try the conversion pinout written in arcade-docs and adapt it to match the pinout. I haven't tested it myself, but if anyone ends up getting this to work, please report back!

Data Input pins may be ignored if you don't need to receive inputs from the board. If you do, then you need to connect them to an RS-422 module, and wire the output to Data Input pin on Arduino.

You will connect all 3 B pins to 3.3v (or any voltage that is lower than what your Arduino HIGH voltage is, but higher than 0v).

Now, each A pins will be wired directly to corresponding pins on Arduino. Default pinouts are as follows:

Arduino Pin	Description
2	Data Input
3	Enable Output
4	Data Output
5	Clock Output

Your new IO board should be ready.

Software

Using Arduino IDE

Save main.cpp as .ino file, and upload it like usual. No external libraries are needed.

Using PlatformIO

The project is set to build for Arduino Pro Micro 5v, but it should work on other arduino-compatible board without any modification. Build and upload like you normally would (e.g. pio run -t upload).

I wanna use slider inputs / control lights in my program!

While the code doesn't really implement communication with PC to send/receive data, serial works just fine and it still periodically reads all outputs from Sub-IO. You can probably write some code that will send these data to PC via serial.

Resources

• 75ALS1178 datasheet

  • 75ALS1178 is the RS-422 chipset used in Sub-IO.

• M66009FP datasheet

  • I/O expander used in Sub-IO. This chip is responsible for actually exchanging data, and 4 I/O pins on arduino directly drive this chip.

• MAME implementation of TWINKLE PCB

  • Has Sub-IO addresses and bit layout for M66009FP. Thanks for the fantastic work!

• Arcade Docs GEC02 documentation

Thanks to

• @smf- for MAME Twinkle PCB implementation, this was the most crucial resource!
• @shizmob for maintaining an amazing community resource
• Zenith Arcade for the resource and access to the cab