CBM FileBrowser

(C) 2010 by NBLA000

member of the Denial Group

Overview:

This program works as a program launcher for Commodore machines. Even if it was originally intended for a device with sd2iec firmware, it works also with any CBM drive (without sd2iec functions of course).

It is a multi-system version derived from the discontinued sd2brwse v.0.6 by Hannu Nuotio (fork() of sdbrowse v.0.7)

The Vic-20 Mega-Cart Installer is based on sys.asm sources of mega-tools by Daniel Kahlin

Current supported machines:

• C64

• C64DTV

• Vic-20 unexpanded

• Vic-20 +3K RAM

• Vic-20 +8K RAM or plus (for FE3 use this version)

• Vic-20 with Mega-Cart

Tested drives:

• MMC2IEC

• SD2IEC

• uIEC

• C64-SD

• 1541

• 1541-II

• 1571
  

• 1581

How it works:

Load it and type RUN to start.

Use the joy or cursor keys to browse the directory, fire/return to load the selected program.

See the key assigments section for other keys specification.

For user with different CBM systems, there is a small basic program that autodetects the machine and then loads the proper system program, just put it as first file of your SD-Card/disk and type LOAD”*”,8 - Note that system programs (without the .prg suffix) must be in the same folder of the basic program.

Note for Vic-20 versions:

Load the proper version according with the used memory expansion:

Unexpanded, +3K RAM, +8K RAM or plus, for FE3 use the +8K version.

Note for the Vic-20's Mega-Cart version:

Load it by using any memory configuration from both normal or soft reset menus.

After launching a program, It may auto-restart (without re-load) even if you switch off your Vic-20, just hold CBM key on boot/reset (or select VIC +3K) and type SYS1150.

Please note that if you launch a 3K program, you must reload the file-Browser.

To speedup loading for sd2iec based drives, SD2IEC/uIEC/MMC2IEC/C64SD/etc, or any other drives with JiffyDOS rom, please install latest SJLOAD patch for Mega-Cart (www.mega-cart.com)

Key assigments:

Each system use a specific key assigments but some keys are common for all system.

Common keys for all system:

Keys for C64:

Keys for C64DTV:

Common Keys for All Vic-20 versions:

Additional Keys for Vic-20 with Mega-Cart:

Screenshots:

Custom versions:

The program can be customizable with some options, just edit the proper .def file and compile, each system use a relative .def file, the file is commented with options explanation.

For example, the .def file for the Vic-20 unexpanded is vic20-unexp.def.

Compile the program:

Use ACME 0.91

# acme --cpu 6502 -f cbm -o program_name.prg system_file.asm

example for the Vic-20 +8K RAM or plus:

# acme --cpu 6502 -f cbm -o fb20-8k.prg vic20-8k.asm

For DOS/Windows, you may easily compile it by using the batch file "CBM-FileBrowser.bat"

Just execute it and select the system.

For Unix/Linux, you may compile it by using the included Makefile

Known bugs/issues:

MMC2IEC with 0.6.7 and maybe previous firmware versions too:

If browsing in some directory (but not on a .d64 image) and quitting, the following RUN starts the program on the root directory

TODO:

• Bottom bar for the C64/C64DTV

• DASM porting of sources

• C16/Plus4 support

• C128 support

Versions:

v.0.1 - 01-Sep-2009 (Start of project, C64/C64DTV only)

v.0.2 - 21-Oct-2009 (First working version for Vic-20 +8K RAM)

v.0.3 - 06-Jan-2010 (Added memory config auto-detection for Vic-20 selected program)

v.0.4 - 19-Jan-2010 (Added support for Vic-20 with Mega-Cart and manual start mode)

v.0.5 - 10-Feb-2010 (Added support for Vic-20 unexpanded and Vic-20 +3K RAM)

v.1.0 - 05-Mar-2010 (First public version, minor issues fixed, C64 and Vic-20 supported)

v.1.1 - 22-Jun-2010 (Added support for D41 and DNP file images, sd2iec firmware v.0.9.0 or higher required)

v.1.2 - 09-Oct-2010 (Added SJLOAD speed-up option to the manual mode of the Mega-cart version)

Download:

CBM-FileBrowser_v1.2.zip