Skip to content

File and Directory Browser

Jump to bottom
sy2002 edited this page Jul 4, 2022 · 3 revisions

Thanks to long filename support and alphabetically sorted file- and directory listings, mounting a disk image, loading a ROM or similar tasks are straightforward. Press MEGA65's Help key to open the on-screen-menu and choose the appropriate menu item using the cursor keys and Return.

Here is how the browser works:

  • Navigate up/down using the Cursor up and Cursor down keys
  • Page up and page down using the Cursor left and Cursor right keys
  • Return mounts a disk image/ROM/etc.
  • Run/Stop exits the file browser without mounting
  • Remembers the browsing history, i.e. even while you climb directory trees, when you mount the next image, the file selection cursor is positioned where you left off. This is very convenient for mounting multiple subsequent disks of a demo in a row.
  • Support for both SD card slots: The back slot has precedence over the bottom slot: As soon as you insert a card to the back slot, this card is being used. SD card changes are detected in real-time; also while the file browser is open.
  • Within the file browser you can use F1 to manually select the internal SD card (bottom tray) and F3 to select the external SD card (back slot).
  • An already mounted drive can be unmounted (i.e. "switch the drive off"), if you select it in the Help menu using the Space bar. If you select an already mounted drive with the Return key instead, then for the MiSTer core this is more like switching a diskette (or mounting a new hard drive) while leaving the drive on. Use the latter mechanism via Return when a game or a demo asks you to turn the disk or to insert another disk.
  • The file browser defaults to the folder DIR_START that you can specify in config.vhd in case this folder exists. Otherwise it starts at the root folder.
  • The file browser only shows files with a valid file extension. By default any file extension is valid but using custom code in m2m-rom.asm for example as shown in the "Hello World" Tutorial you are able to specify search patterns that are a fit for the core that you are porting.
Clone this wiki locally