# TASOLLER Custom Firmware (Host MCU - Application ROM)

See [Development](./Development.md) for development information.

Yes, the code is a mess. I just wanted to get something onto git y'know :).

## Setup
### Installing Firmware
- Disconnect the PC cable from the TASOLLER
- Hold down the FN2 button, while reconnecting the PC cable
- `HOSTMCU` should show as a device
- Use `Update V1.1.exe` from official firmware updates to load the firmware

Currently, Dao CFW is required on the LED board. This is controlled by `LED_FIRMWARE_CFW` in `src/led.h`.

### 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.

## Controls
### General
Tap FN1 to insert a coin. FN2 is currently unbound.

### Configuration
While holding FN1, the following configuration options are available:

![](./docs/Graphic_Slider_Settings.png)

※ "Insert card" will hold the Enter key for 5 seconds

### Test menu

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!).

![](./docs/Graphic_Slider_Test.png)

To access the TEST and SERVICE buttons without entering the test menu, hold FN2 instead.

![](./docs/Graphic_Slider_TestReduced.png)

## Keyboard Mapping
When the HID keyboard is enabled, the following mapping (UMIGURI defaults) is used:

![](./docs/Graphic_Slider_Binds.png)

with the airs mapped as `0OLP,.`.

Please note that this is slightly different to stock firmware!