host-aprom/README.md

77 lines
2.6 KiB
Markdown
Raw Permalink Normal View History

2024-06-29 20:17:34 +00:00
# TASOLLER Custom Firmware (Host MCU - Application ROM)
See [Development](./Development.md) for development information.
2024-08-15 13:54:01 +00:00
Like what you see? [Buy me a coffee](https://ko-fi.com/bottersnike)
## Features
- Superior slider processing; no more dropped holds or missed notes!
- Native arcade IO support
- Air sensor anti-jitter (fixes dodgy sensors)
- Intuitive menus
- Arcade-accurate colours
And of course, it's all open source :).
2024-06-29 20:17:34 +00:00
2024-07-12 16:18:18 +00:00
## Setup
### Installing Firmware
2024-08-15 13:54:01 +00:00
- Download both `host_aprom.bin` and `led_aprom.bin`
- Run `TASOLLER-FirmwareUpdater.exe`
- Follow the instructions
2024-07-12 16:18:18 +00:00
### Configuring segatools
This firmware emulates arcade IO. As such, segatools' emulation should be disabled, by adding the following lines:
```ini
[slider]
enable=0
[io4]
enable=0
```
Ensure no other `[slider]` section exists in the file (or if it does, set `enable=0` there instead).
The slider **MUST** be assigned to port `COM1`. To do this:
- Go to `Devices and Printers` in control panel
- Double click `TASOLLER`
- In the `Hardware` tab, double click `USB Serial Device`
- If this already reads `USB Serial Device (COM1)` nothing needs done
- Click `Change settings`
- Go to `Port Settings` -> `Advanced...`
- Under the dropdown for `COM Port Number:` select `COM1`
If `COM1` is already in use, check what device it is assigned to in Device Manager under `Ports (COM & LPT)`. You may need to enable `View` -> `Show hidden devices`.
Pre-chusan Chunithm uses IO3. This firmware does not (and unfortunately cannot) support IO3. It is recommended to enable the HID keyboard mode, and continue to use keyboard input for IRs.
2024-08-04 21:27:46 +00:00
## Controls
### General
Tap FN1 to insert a coin. FN2 is currently unbound.
2024-06-29 20:17:34 +00:00
2024-08-04 21:27:46 +00:00
### Configuration
2024-08-13 02:21:30 +00:00
While holding FN1, the following configuration options are available:
2024-08-15 18:43:38 +00:00
![](./docs/img/Graphic_Slider_Settings.png)
2024-08-13 02:21:30 +00:00
※ "Insert card" will hold the Enter key for 5 seconds
2024-08-04 21:27:46 +00:00
### Test menu
2024-08-13 02:21:30 +00:00
2024-08-04 21:27:46 +00:00
To enter the system test menu, double-tap FN2. This will mirror the on-screen controls, and additionally adds controls for the TEST and SERVICE buttons on a real cabinet. Double-tap FN2 again to leave this mode on the controller (note that this is not synced with the game exiting the menu!).
2024-08-15 18:43:38 +00:00
![](./docs/img/Graphic_Slider_Test.png)
2024-06-29 20:17:34 +00:00
2024-08-04 21:27:46 +00:00
To access the TEST and SERVICE buttons without entering the test menu, hold FN2 instead.
2024-06-29 20:17:34 +00:00
2024-08-15 18:43:38 +00:00
![](./docs/img/Graphic_Slider_TestReduced.png)
2024-08-13 02:21:30 +00:00
2024-08-04 21:27:46 +00:00
## Keyboard Mapping
When the HID keyboard is enabled, the following mapping (UMIGURI defaults) is used:
2024-08-15 18:43:38 +00:00
![](./docs/img/Graphic_Slider_Binds.png)
2024-06-29 20:17:34 +00:00
2024-08-04 21:27:46 +00:00
with the airs mapped as `0OLP,.`.
2024-06-29 20:17:34 +00:00
2024-08-04 21:27:46 +00:00
Please note that this is slightly different to stock firmware!