Atarimax ColecoVision 128-in-1 Flash MultiCart
ColecoVision/ADAM Compatible Flash Multi-Cart with USB Interface
©2010 Steven J Tucker
Chapter 3: Using the Multi-Cart Studio Software
The Multi-Cart Studio software is based around the concept of creating 'Workbooks' that represent the final configuration you would like programmed into your multi-cart.
Workbooks are like any other file, such as a Microsoft Word document, they contain your data and are not directly linked to any physical cartridge.
You can create, edit and save your workbook designs without ever needing to connect your cartridge.
Once you have used the Multi-Cart Studio to create the layout you desire for your multi-cart, then and only then do you need to connect your cartridge for programming.
Changes made to workbooks are incremental, so if your new workbook only differs from your current cartridge configuration by a small amount, for example you may have changed only one or two rom images, only those changes will be saved to your cartridge, saving time during synchronization.
Tour of the Multi-Cart Studio Software
The Multi-Cart Editing Control
This control is the main active interface to adding, removing and manipulating rom images to your workbook.
The numbers on the left are 'slot numbers' for the rom images in your workbook.
These numbers represent the position those games will have on your final cartridge.
This control is disabled when no Workbook is open.
Live Menu Preview
This control displays a view of what your on-screen Multi-Cart menu will look like when used on a real ColecoVision. This display is updated in response to your workbook changes and will scroll along with the Multi-Cart editing window.
This control is not visible unless a workbook is open.
Style Editing Controls
The style editing controls allow you to change the text and appearance of the Multi-Cart Workbook on-screen menu.
These controls are disabled when no Workbook is open.
This scrolling text window displays the current state of the software including cartridge connection and programming functions.
This control is always enabled.
This area at the bottom of the window displays the current cartridge connection state, as well as the state of any current cartridge programming operation.
These indicators are always enabled.
These controls start and stop programming of your cartridge based on the current Workbook contents.
These controls are only enabled when a Flash Multi-Cart is connected to the system.
The Status Monitor and Event Log
The Status Monitor
The Status Monitor bar at the bottom of the screen is where the state of the USB interface to your cartridge is shown.
If your cartridge is connected and visible to the Multi-Cart Studio software, the message 'CARTRIDGE CONNECTED' will be displayed in this bar, otherwise 'CARTRIDGE DISCONNECTED' will be seen.
The other indicators on this bar show the current state of hardware operations like synchronizing your cartridge. Should you need to make a bug report, please include the state of these indicators in your report.
The Event Log
The event log is a verbose display of status and error messages that occur while using the Multi-Cart Studio Software.
For example when adding a ROM Image to your workbook, if it is recogized by the internal MD5 database, its name and signature will be displayed in this area.
While Synchronizing your cartridge the current progress will be displayed in this window.
Should you need to make a bug report, please include any error messages displayed in this window.
When you plug in your cartridge the unique Serial Number of your device will be displayed in this window.
Creating a New Workbook
By creating a new workbook, you are essentially creating a new blank Multi-Cart document.
To this document you will add rom images and other customizations before synchronizing your cartridge to it.
Having this information stored in a normal document means you never have to 'hot edit' your cartridge and your Workbook can be backed up to CD-ROM, e-mailed to friends, etc.
To create a new workbook, select 'File' from the drop down menu, and then 'New'.
Your new blank workbook is now loaded and you can begin editing your multi-cart document.
To save your workbook to disk, select 'File' and then 'Save As' and give your workbook a name such as 'My Workbook.mcw'.
Note: '.MCW' is the file extension for Multi-Cart Workbooks.
Adding ROM Images to your Workbook
Adding ROM Images to your workbook is required if you want to have any games on your cartridge.
Note: All 32k and smaller rom images are supported, which accounts for all ColecoVision game releases.
ROM Images must be in raw binary format to be recognized. These may be listed as .BIN, .COL, .ROM or other extensions.
To add a ROM Image to your workbook, right click on the Multi-Cart Editing Window on the slot number you want to assign.
This will bring up the ROM Image Context Menu.
Select the 'Load ROM from File(s)' menu option to bring up the file select dialog, then select your rom image.
Another convenient way to add one or more ROM Images to your workbook is to simply drag those ROM Image from the Windows Explorer and drop them on the slot you want to fill in the Multi-Cart Editing Window.
If you drag and drop more than one ROM Image they will be added starting at the selected slot number, replacing any existing ROM Images without prompting.
The Multi-Cart studio software contains a MD5 database of around 175 known ROM Images and variations.
If your ROM Image is recognized by the current database, it will be automatically assigned a menu friendly name and rom image type.
If your ROM Image is not in the current MD5 database, its filename will be used as the description, which you can change by double clicking on the name shown in the ROM list.
Please note that slot number 128 is not user assignable. This slot contains the on-screen menu software and self-test programs.
Removing ROM Images from your Workbook
To remove a ROM Image currently in your Workbook and make that slot blank, right click on the desired slot and select the 'Clear Slot' menu option.
Alternately, you can press the DELETE key while a rom image is highlighted.
Both the ROM Image and its description will be removed from your workbook.
Changing the menu name of a ROM Image
To change the name of the ROM Image that will be displayed on the Multi-Cart menu, right click on the name and select the 'Edit Menu Title' menu option.
Note: The display on the ColecoVision screen is limited to 34 characters per line, minus a few characters used for the slot ID number, so you will be limited to around 30 characters for your menu description.
You can view exactly how your menu entry will look by viewing the 'Live Menu Preview' on the right hand side of the Multi-Cart Studio Workshop window.
Moving ROM Images around in your Workbook
To swap two slots in your workbook, just grab the slot ID number shown in the left column, for example 001, and while holding down the left mouse button, drop it on the slot ID number you wish to exchange it with.
While dragging a small arrow will appear to assist you in selecting the correct place to drop the ROM Image.
Customizing the look of your Multi-Cart menu
The look of your Multi-Cart menu can be extensively customized.
The ColecoVision VDP displays text on the screen using a soft font called a 'Character Set'.
The Multi-Cart Studio software includes a selection of these character sets and will let you preview them live before having to make any changes to your real multi-cart.
By default in a new workbook, these character sets are assigned the same font used by Atari 8-bit Computers, which is very readable on even small televisions.
Lets start by changing the font for the body of your menu entries.
Click on the 'Listing Font' button on the main Multi-Cart Studio interface.
This will bring up the Character Set Preview and Selection window shown here.
This is a interactive window that will display the complete character set and allow you get a magnified look at any of the characters by just hovering your mouse pointer over it.
To select a new character set, just use the drop-down menu at the bottom of the dialog to select any of the pre-installed character sets.
As you select a new set, the character set preview will automatically update to show you the full contents of this character set.
If you like your selection, press 'Save' to add it to your workbook, or 'Cancel' to do nothing.
Once you have added the character set to your workbook, the Live Menu Preview on the right side will update and display your menu in the new character set, exactly how it will appear on the real ColecoVision!
The Multi-Cart Studio comes with a number of character sets, but if you would like to add your own Character Sets, just deposit those files into the 'Character Sets' directory in the Multi-Cart Studio installation folder.
The header (top) and footer (bottom) lines of your multi-cart on screen menu will by default display a title and instructions on how to use the menu.
You can change the text of these lines to anything you desire by pressing the 'Header Text' or 'Footer Text' buttons no the main Multi-Cart Studio interface.
These changes will be reflected immediately in the Live Menu Preview.
Remember to Save Changes to your Workbook
After making any changes to your workbook it is very important that you save your workbook to your hard disk.
Synchronizing will save the contents of your workbook to cartridge, but unless you save your workbook to disk, you will lose your ability to make incremental changes to the current cartridge configuration and will have to build your workbook over again the next time you start the Multi-Cart Studio software.