Cons-n-Stuff/chu_pico
1
0
Fork 0
mirror of https://github.com/whowechina/chu_pico.git synced 2024-11-27 20:20:50 +01:00
Code Releases Activity
Pico controller for Chunithm-type rhythm game
135 Commits 1 Branch 0 Tags 39 MiB
C 95.6%
CMake 3.6%
OpenSCAD 0.8%
24f14fe8a5
Go to file
whowechina 24f14fe8a5 IR air tower support
2024-09-23 11:11:21 +08:00
.vscode Use aic_pico as a library via submodule 2024-03-16 17:02:52 +08:00
doc IR air tower support 2024-09-23 11:11:21 +08:00
firmware IR air tower support 2024-09-23 11:11:21 +08:00
PCB Update component models in air PCB 2024-09-20 16:48:39 +08:00
Production IR air tower support 2024-09-23 11:11:21 +08:00
tools Upload Redboard binaries 2023-11-15 21:16:48 +08:00
.gitignore Optimize AIME commands 2024-04-06 11:11:19 +08:00
.gitmodules Use aic_pico as a library via submodule 2024-03-16 17:02:52 +08:00
LICENSE.txt Ready to publish 2023-09-10 14:23:31 +08:00
README_CN.md IR air tower support 2024-09-23 11:11:21 +08:00
README.md IR air tower support 2024-09-23 11:11:21 +08:00

README.md

Chu Pico - Chunithm Style Mini Controller

点这里可以切换到中文版

Features:

  • It's small, made for 15-17 inch screen.
  • Air towers are replaced with built-in ToF sensors.
  • Traditional IR Air mechanism is also provided for DIYers.
  • HID lights, of course!
  • 32 keys (upper and lower rows).
  • Follows CrazyRedMachine's RedBoard I/O protocol.
  • Command line of rich features.
  • All source files open.

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

And thanks to community developers that inspired me and helped me: CrazyRedMachine (https://github.com/CrazyRedMachine), SpeedyPotato (https://github.com/speedypotato).

And also:

Notes

This one is relatively easy to build compared with my other projects like IIDX Pico or Teeny. You can check out my other cool projects.

This Chu Pico project:

  • Heavily depends on 3D printing, you need a Bambu 3D printer (X1 or P1).
  • Requires skills to solder tiny components.

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.

About the License

It's CC-NC. So DIY for yourself and for your friend, don't make money from it.

HOW TO BUILD

Frequently Made Mistakes

Many DIY enthusiasts commonly make certain mistakes during the building process. Please proceed with extra caution to avoid these.

  • MISTAKE: Soldering everything together without conducting intermediate testing.
    Remember, even professional engineers can make mistakes. It becomes significantly harder to identify the root cause of a problem when all components are already assembled or soldered. Therefore, it's advisable to solder and test in stages. The firmware is designed to function correctly even with some components missing, which is good for testing.
  • MISTAKE: Neglecting to cut the ADDR pin trace on the MPR121 module.
    The MPR121 module in the market has the ADDR pin pre-connected to ground. But the board expects a floating ADDR pin, otherwise the ADDR pin will short the circuit. Please verify your "CUT" using a multimeter.
  • MISTAKE: Rushing to replace components when something fails.
    Sometimes people prematurely assumes that the Raspberry Pi Pico or other modules are faulty. Be aware that desoldering and soldering large SMD components is a challenging task. It carries the risk of damaging the component or the PCB board. Patience and caution are crucial. Look at the schematics and PCB design files and ask help from community first. Questioning the integrity of these components should be your last resort.
  • MISTAKE: Failing to properly solder the 3 USB pins of the Raspberry Pi Pico.
    These pins are at the bottom side of the PCB. It's a common oversight to either forget to solder them or to leave air bubbles during the process. To avoid this, solder slowly from one side of the hole, using minimal solder wire and a generous amount of flux.

PCB

Light Guide Panel

  • Find a service to cut a light guide panel using DXF or DWG file Production\CAD\chu_pico_lgp.*, the size is 256mm*60mm, 1.8mm to 2.0mm thickness, thinner is better for sensitivity. 2.0mm is easy to find, 1.8mm is rare. I used 1.8mm for my build.
  • LGP material choices:
    • Real LGP (Light Guide Panel) material, it's the best choice.
    • Clear Acrylic with Light Guide Film, it's a good choice.
    • Clear Acrylic with single-side-frosted, it's a good choice.
    • Clear Acrylic with manual single-side-sanding, it can work too.

Panel Film

  • A self-adhesive textured/frosted film sheet, it is applied on top surface of the light guide panel. It improves touch feel. You can use window sticker film. It MUST be self-adhesive ones, NOT static cling ones. They're usually very cheap.
  • Cut the film to roughly match the shape of the light guide panel, and stick to the panel.
  • Gentlely rub the film to remove any air bubbles and make it stick tightly.

IR Cover

  • It's for good looking, as it hides 5 ToF sensors.
  • IR lights can go through.
  • Find a service to cut an IR cover using the DXF or DWG file Production\CAD\chu_pico_ir_cover.*, the size is 293.2mm*63.5mm, 1mm thickness. The material must be "Infrared Transmitting Acrylic Sheet" which can block visible lights (so it looks black) while letting IR lights go through.
  • If you can't find one, cut a regular smooth surface acrylic, but it can't hide the ToF sensors which are not good looking.
  • If you're using the VL53L0x ToF sensor, please add padding beneath the sensor. This brings it closer to the acrylic cover, which can prevent acrosstalk error.

3D Printing

  • You need a Bambu 3D printer for 2 reasons:

    • Parts are designed to perfectly fit in its 256mm*256mm print bed.
    • Its AMS system works great for easy-to-remove support material.

  • For all the following prints:

    • To fit object in the bed, Z rotate: 315 degree, X, Y move to: 134mm

    • PLA, PETG, ABS are all OK.

    • Layer height: 0.2mm

    • 4-6 walls, 50+% infill

    • Support: Yes. If you have Bambu AMS system, use their special support material at interface layers.

  • Base: Production\3D\chu_pico_base.stl, dark gray filament.

  • Cover: Production\3D\chu_pico_cover(_aime).stl, dark gray filament.

  • Cover Base: Production\3D\chu_pico_cover_base.stl, clear transparent (IMPORTANT) filament.

  • Light Guide Panel Fixer: Production\3D\chu_pico_lgp_fixer.stl, color doesn't matter.

Exploded View for Assembly

From top to bottom:

  • IR Cover
  • Cover
  • Cover Base
  • Panel Film
  • Light Guide Panel
  • PCB
  • Light Guide Panel Fixer
  • Base

You need 4x M3*12mm screws and 4x M3 hex nuts to fix all things.

7x silicone anti-slip pads can be applied to the bottom side of the base to provide stability when playing.

IR Air Tower

This is not necessary for Chu Pico. But some people may prefer the traditional IR air tower, especially when they're using Chu Pico design for a full-sized controller. So hereby I provide the IR air tower design, with a pair of air tower PCBs and the firmware support.

  1. First, you need to order the PCBs, the gerber file is Production\PCB\chu_air_v*.zip. It's for both sides of the air tower.
  2. Order the components, they're marked in the schematic. Then solder them to the PCB following the silkscreen.
  3. For left side tower, use J1 to connect to the Raspberry Pi Pico, and for the right side tower, use J2. GPIO 3 -> A, GPIO 4 -> B, GPIO 5 -> C, ADC 0 (GPIO 26) -> Right S, ADC 1 (GPIO 27) -> Left S.
  4. Steps for deployment. I. Enable IR air tower in the firmware (command ir enable), this will disable ToF. II. Enable diagnostics for IR (command ir diagnostic). III. Place the air towers and watch the output of the diagnostics, higher value means beam is received. IV. Set the baseline after the towers are properly placed (command ir baseline). V. Optionally, set the sensitivity, it's a percentage of expected change (command ir trigger <1..100>).

Firmware

  • UF2 file is in Production\Firmware folder.
  • 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 bottom side of the Chu Pico, it is facing right to the BOOTSEL button.
  • It works on CrazyRedMachine's RedBoard protocol. For more information, please check out CrazyRedMachine's project (Don't forget to give him a star and drop by his GitHub for other cool projects):
    https://github.com/CrazyRedMachine/RedBoard
  • It has a command line to do configuration. You can use this Web Serial Terminal to connect to the USB serial port of the Chu Pico. (Note: "?" is for help)
    https://googlechromelabs.github.io/serial-terminal/

CAD Source File

I'm using OnShape free subscription. It's powerful but it can't archive original designs to local, so I can only share the link here. STL/DXF/DWG files are exported from this online document.
https://cad.onshape.com/documents/8b9d0fe6ff1bfa4da17d33ee/w/5c7c980a282a19e7ba1db795/e/56ee65492584a3f709c23c49?renderMode=1&uiState=64fd606f17393c0e6f9b19a4