Cons-n-Stuff/iidx_pico
1
0
Fork 0
mirror of https://github.com/whowechina/iidx_pico.git synced 2024-11-12 01:10:50 +01:00
Code Releases Activity
Pico beatmania IIDX controller
97 Commits 1 Branch 0 Tags 43 MiB
C 68.5%
OpenSCAD 26.8%
CMake 4.7%
d5a391c1d0
Go to file
whowechina d5a391c1d0 Simple fix for earlier PCB versions.
2024-09-09 22:34:34 +08:00
.vscode Turntable hotswap 2023-04-05 11:49:50 +08:00
cad Big update (analog and effect mode removed) 2023-12-10 18:36:21 +08:00
doc Simple fix for earlier PCB versions. 2024-09-09 22:34:34 +08:00
firmware Refactoring "HID lights for turntable" 2024-06-10 15:58:28 +08:00
PCB/Keyboard PCB v1.3 fixes key "sticky-feel" problem 2024-09-09 22:15:14 +08:00
Production PCB v1.3 fixes key "sticky-feel" problem 2024-09-09 22:15:14 +08:00
.gitignore Turntable noise filtering and debouncing 2024-06-08 10:46:03 +08:00
LICENSE.txt Put license file 2023-05-21 19:34:41 +08:00
README.md Simple fix for earlier PCB versions. 2024-09-09 22:34:34 +08:00

README.md

IIDX Pico - Beatmania IIDX controller

Features:

  • It's thin, really thin.
  • Detachable turntable using magnetic connector (soft hinge is another option).
  • HID lights, of course!
  • Key color theme and customization.
  • Multiple turntable effects.
  • Many live settings.
  • Konami device mode for IIDX Ultimate Mobile.
  • All source files open.

Thanks to many respectful guys/companies who made their tools or materials free or open source (KiCad, OpenSCAD, InkScape, Raspberry things). And also:

Notes

This is a difficult build, it heavily depends on 3D printing, both FDM and SLA (resin). It also requires skills to solder tiny components and thin cables., much more difficult than my other projects such as Pico Popn.

Move forward only if you're REALLY interested.

Also, you can check out my other cool projects.

Disclaimer

I made this project in my personal time with no financial benefit or sponsorship. I will continue to improve the project. I have done my best to ensure that everything is accurate and functional, there's always a chance that mistakes may occur. I cannot be held responsible for any loss of your time or money that may result from using this open source project. Thank you for your understanding.

HOW TO BUILD

Turntable Materials

  • 1x AS5600 hall angular sensor board set (23mm*23mm)
  • 1x 6mm*2mm magnet (must be radially magnetized), normally comes with the AS5600 board set.
  • 1x 61804-2RS deep groove ball bearing (20x32x7mm), normally < 5US$;
  • 1x WS2812B LED ring board, or RGB LED strip (recommended). Choose ones with dense LED arrangement (>=32 LEDs per board, or >90 LEDS per meter);
  • 3x M4*10mm screws (large flat head is better) and hex nuts, for bearing. For hinge version, use M3 screws.
  • 4x M3*12mm screws, for spinning disc.
  • 1x REF3030 (3.0V Voltage Reference, SOT-23-3).
  • 1x Custom cut black acrylic disc, 4mm thickness.
  • 11x 12mm non slip self-adhesive silicon pads (also for Keyboard).
    https://www.amazon.com/Cabinet-Dampening-Adhesive-Circular-Stoppers/dp/B07XXWG818

Keyboard Materials

Detachable Cable

  • 1x HDMI cable (ultra slim, diameter < 4mm), at least 50cm in length, we'll cut the HDMI connectors off, so pick a cheap one.
  • 2X Magnetic pogopin connector sets, male and female. PCB side should use ones with 90-degree pins, cable side use ones with straight pins.

Step 1 - Buy

  • Keyboard PCB
    Just go JLC and make the order. Make sure the board thickness is 1.2mm, it's very important!
  • Turntable PCB
    It's an optional one. It makes the wiring and soldering inside the turntable a litter easier.
  • Acrylic disc
    Choose the dxf file according to your disc size and find a vendor to cut the 4mm black acrylic.

Step 2 - 3D Print

Keyboard

  • PCB bottom (pcb_bottom_*.stl, choose one according to your connector or hinge choice)
    FDM, PLA/PETG transparent, 0.2mm layer, 4 walls.
  • PCB top (pcb_top.stl)
    FDM, PLA transparent, 0.2mm layer, 4 walls.
    If you have Bambu Lab's AMS system, use PLA black/gray for 3.0mm+ layers.

Turntable

For following prints, FDM, PLA, 0.4 nozzle, 0.16-0.2mm layer, 4 walls. And very important: "Seam Position" should be set to "Random" in your slicer, not only it looks better, it makes the bearing-flange coupling smoother and tension distributed more evenly.
These are all printed with

  • Base (TT_base_xxx.stl), choose one of the 150, 170 or 180, based on your choice of disc size, 20-60% fill.
  • Bearing seat (bearing_seat_6804.stl), 20-60% fill.
  • Flange for disc (TTshaft_6804.stl), 60% fill.
  • If you opt for the hinge option, go with the files with "hinge" in the filename.

Pogopin Connector

It's very small and requires higher accuracy.

  • Housing for pogopin connector (pogo_bottom.stl, pogo_top.stl).
    FDM, PLA, 0.2 nozzle is recommended, 0.1mm layer, 4 walls, 60% fill.

Button keycaps

  • Option 1 (Choc V1 or V2): SLA (resin), regular white, 0.05mm layer, check out my orientation:
  • Option 2 (Choc V2 only): FDM, PLA white, 0.2mm nozzle recommended but 0.4mm nozzle works too, 0.10~0.16mm layer, use easy-to-remove material for support, like "Bambu Support W" or just PETG.

Step 3 - Solder

  • Keyboard

    • WS2812 choices for main 7 main keys, for each key: solder 1x WS2812B-3528 under the key switch, or 4x WS2812-1516 around the key switch.

    • IMPORTANT: be careful about the orientation of LEDs, they're different at different rows or columns.

    • Connector choices: solder 2x pogopin connectors, or solder 1x 3.5mm headphone input jack.

    • It's very easy to miss the USB pins of the Raspberry Pico Pi, it's at the other side. And it's difficult to solder as you may leave an airbubble in the soldering hole. My trick is to use sharpest iron tip, super-slowly apply solder wire only at one side. This is my result:

    • You can use level shifter (SN74LV1T34DBVR, U2/U3), or you can just bypass it by soldering a nearby resistor (10 ohm, R1/R2).

    • Optional: TVS1 and TVS2 are rated 3.3V, protecting GPIOs. TVS3 should be rated 5V when using level shifter, and 3.3V when not using level shifter.

  • Turntable

    • General
      Typical AS5600 development board comes with 3.3V configuration, we can't feed 5V to it directly, it would burn the AS5600 or the main Pi Pico. The GPIO we use to communicate with AS5600 can never go beyond 3.6V. So we need a lower voltage, I chose REF3030, a precise 3.0V voltage reference.
      You need to scrape off some solder mask to expose the ground copper (don't scrape the solder mask under 5V pin). I found a good place to mount the REF3030, this is how I handled it:

    • Very Important
      Before proceeding further, it's important to know that the silicone hinge option used in my IIDX Teeny has proven to be the most effective and stable. Therefore, it's highly recommended to opt for the hinge option, rather than the subsequent digital (pogopin). I've also removed the analog (3.5mm headphone jack) option simply because it's not good. If you use Teeny's silicone hinge option, use the added J3/J4 3.3v soldering pads to power the AS5600.

    • If you go with digital (magnetic pogo pin connector)
      There're a set of I2C and a WS2812B signal line together in the cable that connects turntable and the keyboard. Unfortunately, these signals crosstalk. So, we have to use shield cables for them. Two I2C lines should have a shield cable, and the WS2812B signal should have another shield cable. Good thing is, an HDMI cable has 4 shield cables and bunch of other small cables. We can make use of it.

  • Turntable LED Ring
    I recommend to use LED strip over LED board, becuase the LED board's light is facing up, but using strip, the light can spread out pefectly.
    Use transparent double-sided tape to stick the LED around the turntable inner wall.

Step 4 - Assemble

  • Assemble the turntable
    I don't know how to draw an explosion diagram, this is done by coding in OpenSCAD:

    These shows how a bearing is installed.

  • Install the low-profile stabilizers.
    https://docs.keeb.io/choc-stabs
    A little trick here. As the PCB footprint is made to support both choc v1 and v2, that leaves some wobble space for choc v1 and makes it difficult to align. So leave the key switch unsoldered, when the stabilizer, the key switch and the keycap are all in place, push the keycap down and then solder the key switch. This way the key switch will be aligned to the stabilizers better.

    VERY IMPORTANT

    I made a terrible mistake in early PCBs which causes main buttons sticky (not physically responsive as expected). If you're using PCB v1.3 or later version, you're fine. If you're using PCB v1.2 or earlier version, there's a simple fix. Just manually cut some bevelling on the PCB, so stabilizer's shaft can move freely. You need to do all the buttons. Please don't cut through the PCB, just cut the edge a little at the bottom.

  • Assemble the keyboard
    It's very easy.

Step 4 - Firmware

  • For the new build, hold the BOOTSEL button while connect the USB to a PC, there will be a disk named "RPI-RP2" showed up. Drag the uf2 firmware binary file into it. That's it. There's a small hole at the back side of the keyboard, it is facing right to the BOOTSEL button.
  • If it is already running my IIDX firmware, hold two small AUX buttons together will do the same as the BOOTSEL button.
  • You need to setup your configuration such as AS5600 connection mode and LED ring.
  • Also you can setup the key color theme and turntable effects at runtime. I think I made the configuration too showey and complicated. Check out the manual.
    Nice Looking Manual Here

What If?

  • I can't find pogopin connector.
    Solution: I figured out some another choices, one is using a 3.5mm 4P headphone jack. It uses analog to communicate turntable movements, but I'm still testing it, so stay tuned. I will update this document. The other is to use fixed connection (left or right hinge).
  • I don't have Bambu Lab's machine, or I don't have an AMS system.
    Solution: There're many online vendors and people providing paid Bambu printing service. Or you can just use other 3D printers. It's just the numbers in the OpenSCAD source file or STL files are finetuned on my Bambu Lab X1. You may need to adjust a little on your 3D printer system to get perfect result. And regarding the multi-color thing, maybe you can just paint the top layer by hand. I know people do miniature painting, I think it would be similar.
  • STL files are not accurate, difficult to assemble.
    Solution: 3D printer systems are different one from another, it results in small differences even with same model file and some configuration. If the printed parts are not happy with each other, you can fiddle with the OpenSCAD source file and the numbers in it for your case.
  • I don't have resin printer.
  • I can't find Kailh low-profile stabilizer.
  • I don't have electronic DIY gears.
    Solution: OK, this is an electronic hobby project, maybe it's not for you if you don't plan to do electronic DIYs. There're many good IIDX controllers you can purchase somewhere online.
  • I want Bluetooth support.
    Not A Solution: I once wanted to implement the Bluetooth support. But after I tried bluetooth joystick, I gave up. You really don't want to play rhythm game with a Bluetooth connection!