Till Harbaum edited this page Sep 10, 2018 · 10 revisions

Using mist.ini

The MiST firmware has a few configuration options available, which can be set by adding a "mist.ini" file to the root of the SD card.

Overall the file should contain a "mist" tag at the top:

[mist]
keyrah_mode=0
scandoubler_disable=0
mouse_boot_mode=0
joystick_ignore_hat=0
joystick_ignore_osd=0
joystick_disable_shortcuts=0
joystick0_prefer_db9=0
key_menu_as_rgui=0
reset_combo=0
ypbpr=0
keep_video_mode=0
led_animation=0
key_remap=04,05
key_remap=05,04
hid_button_remap=
joystick_remap=
joy_key_map=

Comments can be added after each setting by using ; e.g.:

[mist]
scandoubler_disable=0 ; leave at 0 if not sure
...

Description

scandoubler_disable

If set to 1, some cores will disable their scandoubler to produce a 15khz video signal. This works better for upscalers and arcade displays. Also if you want to use a VGA-to-SCART cable with MiST, you need to set this option to 1.

Support is core specific; currently it is used by the ST, Amiga, Colecovision, Vic20 and Astrocade and several other cores. Cores not supporting this will ignore the setting.

For more details see Scart cable.

joystick0_prefer_db9

If set to 1, it disables joystick0 reordering. Default value is 0. Joystick reordering is used when one or more USB joystick devices are detected, and it moves any DB9 - connected devices to joystick numbers 3, 4, etc. When this setting is enabled, it allows use of a real Amiga DB9 mouse even if USB devices are present.

led_animation

If set to 1, the four LEDs on the bottom side of the MIST V1.3+ boards (some sold in clear cases) show some knight rider like animation.

ypbpr

If set to 1, some cores will enable component (YPbPr) video output. For more details see YPbPr/RGsB cable.

keep_video_mode

If set to 1, YPbPr and/or Scandoubler modes will be preserved between cores till reset button is pressed (either on MiST board, or hard reset key combination).

reset_combo

Choose key combination for reset:

0 - LCtrl-LAlt-RAlt
1 - LCtrl-LGui-RGui (Ctrl-LAmiga-RAmiga)
2 - LCtrl-LAlt-Delete

keyrah_mode

If set to 0 then keyrah v2 converter will have special tweaks for convenient usage in Minimig and other cores. Please note it requires ISO US/UK type of keyboard (with two blank keys). For ANSI and localized keyboards set this option to 1 to disable all keyrah tweaks.

mouse_boot_mode

Set to 1 to revert back to an old mouse handler which may solve compatibility issues with some mice (the default handler is much more compatible with keyboard/mouse wireless devices, though).

joystick_ignore_hat

If set to 1, the firmware will revert to old behavior of using analog axes instead of the digital direction pad, which is the default behaviour for newer firmwares (since firmware_150524).

key_remap

This allows you to remap USB HID keycodes reported to the cores. For example, if you want to exchange the keys 'a' and 'b' on your keyboard you'd want to have the USB HID keycodes 04 (the USB Usage ID of the key labeled 'a') and 05 to be exchanged the mist.ini would look like:

[mist]
key_remap=04,05
key_remap=05,04

This makes key 04 to be reported as key 05 and vice versa.

Per core settings override

Each core may need some different settings like key remap or scandoubler enable/disable. Any option from "mist" section can be overridden for specific core. Just add another section with core name and new value for desired setting. Hardcoded names for specific cores: MINIMIG, ST, PACE, ARCHIE. For 8bit cores use names you see on main page of OSD on the left vertical stripe.

example:

[minimig]
scandoubler_disable=1

"mist" section should be the first section in INI!

Clone this wiki locally
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.