Taiko-Input/USB-MCU/README_EN.md
AnalogDragon f619c0a386 update md
2023-07-23 04:17:27 +08:00

3.9 KiB

USB-MCU Project

中文版

Homepage

MCU: CH552, IDE: KEIL 4
Microcontroller's official website: WCH CH552

Software Flow

The software runs according to the following flow:

Input -> Output Frequency Limitation -> Output Assignment -> Key Mapping -> USB

Output Frequency Limitation

The output frequency limitation is mainly due to the hardware or program that receives the data. When it receives data that exceeds its processing capability, packet loss may occur.
After multiple tests, the software input limitation for ニジイロ is a maximum input frequency of 60Hz for all channels and 30Hz for signals of the one channel.
The n******o switch limits the input signal filter to 20ms (both press and release are around 20ms; values smaller than this may result in sticky inputs).
Other game software running on different computers usually doesn't have this convenient limitation, but there is usually a filtering of around 10ms on the selection page.

Output Assignment

Due to different device capabilities or software running methods, different software support different maximum input frequencies. The purpose of allocating the output channels is to achieve the input frequency limit of the particular device.
The behavior observed is that when the triggering frequency is high, inputs from the same channel will be allocated to another channel. Different devices adopt different approaches:

  • ns: Aggressive debouncing is performed, and when there are high-frequency inputs, they are allocated primarily to the two adjacent keys on the same side.
  • ニジイロ: The game software limits the maximum global input frequency and the maximum input frequency for a single channel. This may be for the convenience of calculating images. Here, the input frequency for a single channel is limited, and inputs of the same type (e.g., same "dong") are allocated to idle channels.
  • Other applications on PC (such as Open Taiko): These software programs do not have input frequency limitations, so no allocation is needed.

Cross Assignment
Cross assignment diagram for compatibility with ニジイロ

Key Mapping

  • For dual-taiko hardware, taiko inputs are mapped to keyboard inputs DFJK ZXCV, and service key inputs are mapped to keyboard inputs 12345678.
  • For single-taiko hardware, there are two modes: NS mode and keyboard mode. For NS mode, the input keys are shown in the image below. For keyboard mode, you can set the inputs as DFJK or ZXCV through the buttons, with DFJK being the default.

Tags
Tags for single-taiko hardware

Modifying the Program

Dual-taiko Software

  • To disable the output assignment feature, modify the WITHOUT_OUTPUT_ASSIGN macro inside CompatibilityHID.C by uncommenting it.
  • To modify the parameters related to output frequency limitation, modify the EXCHANGE_DATA macro inside CompatibilityHID.C.
  • To change the key values, modify the array inside the Enp2BlukIn function in CompatibilityHID.C.

Single-taiko Software

The single-taiko software integrates three modes: NS mode (using HORI's PID/VID, where NS only verifies the PID/VID without any further encryption); keyboard mode compatible with ニジイロ (60Hz input lock); and keyboard mode compatible with other taiko taiko software (unlock the limitations and disable the output assignment).

  • To change the default startup mode, modify the MODE_STARTUP macro inside CompatibilityHID.C.
  • To switch modes during startup within 1 second, use the following button combinations:
...
if(!KEY1)start_up_mode = MODE_NS_GP;
if(!KEY2)start_up_mode = MODE_KEYBOARD;
if(!KEY3)start_up_mode = MODE_KB_LMT;
if(!KEY4)start_up_mode = MODE_STARTUP;
...
  • During runtime, holding down buttons 1 to 4 will trigger a reset, allowing you to switch modes again.