Skip to content

Latest commit

 

History

History
50 lines (38 loc) · 2.46 KB

README.md

File metadata and controls

50 lines (38 loc) · 2.46 KB

iidx-controller

Software that enables you to create your own Arduino based beatmania IIDX controller.

Features

  • HID lighting support (that works with btools and ttools).
  • GUI configuration tool.
  • Multiple input methods (joystick, keyboard, mouse).

Requirements

  • An Arduino Leonardo (technically compatible with any ATmega32U4 based board, but only tested with a Leonardo).
  • The Bounce2 library.

Uploading the code

Because this code uses LUFA, the process of uploading is a bit more different.

  1. Add https://github.com/CrazyRedMachine/Arduino-Lufa/raw/master/package_arduino-lufa_index.json as an Additional Board Manager URL (in File -> Preferences menu)
  2. Install LUFA AVR Boards from the Board Manager
  3. Select Arduino Leonardo (LUFA) as your board type
  4. Hit Upload

NOTE: To upload new code, you need to press reset in the GUI or on your board when the IDE shows PORTS {COM1, COM6, } / {COM1, COM6, } => {} or something similar in the log. (to enable showing this, check File -> Preferences -> Show verbose output during: -> Upload)

Setup

Buttons:

  • One terminal to GND and the other terminal to the corresponding pin.

LEDs:

  • Positive terminal to corresponding pin.
  • Negative terminal to GND.

Encoder:

  • Connect the encoder's wires to the corresponding pins.
  • Set ENCODER_PPR in iidx-controller/config.h to the PPR of your encoder.

Manufacturer name:

  • By setting MF_NAME in iidx-controller/config.h, you can change the manufacturer name of your controller.
  • You can change this to whatever you'd like, such as your name.

Info:

  • Pinouts are available in iidx-controller/config.h, you can edit them there if necessary.
  • Leonardo pinout (what the numbers in the codes pinout arrays mean) at the bottom of this page.
  • Additional settings can be configured via the GUI, more info here

Thanks

Leonardo pinout

Leo pinout