Using the cartconv utility that comes with VICE
===============================================

The cartconv program is a cartridge conversion utility, it can convert 
between binary and .crt images and it can 'insert' binary and/or 
.crt images into the eprom type of cartridges.


The cartconv program has the following parameters:

-i "input name"

This parameter is mandatory, it should contain the name of the binary/.crt 
file you want to convert. For the eprom type of cartridges this parameter 
can be used multiple times to insert images into the resulting file.


-o "output name"

This parameter is mandatory, it should contain the name of the binary/.crt 
file you want to convert the input file to.


-t carttype

This parameter is optional. It is only needed when converting to a .crt 
file. See below for the supported cartridge types.


-n "cart name"

This parameter is optional and is used as the cartridge name when creating 
a .crt file.


-l loadaddress

This parameter is optional and is used as the load-address when converting 
a .crt file to a .prg file, or when converting to a generic type .crt 
file.

-f "input name"

This parameter is optional, and is meant to output information about the
named file. It can't be used in conjuction with any of the other parameters.


The following cartridge types are supported:

-t argument   description
-----------   -----------
bin           Binary .bin file
prg           Binary C64 .prg file with load-address
normal        Generic 8kb/12kb/16kb .crt file
ulti          Ultimax mode 4kb/8kb/16kb .crt file
ap            Atomic Power .crt file
ar2           Action Replay 2 .crt file
ar3           Action Replay 3 .crt file
ar4           Action Replay 4 .crt file
ar5           Action Replay .crt file
cap           Capture .crt file
comal         Comal-80 .crt file
dep256        Dela EP256 .crt file, extra files can be inserted (1)(2)
dep64         Dela EP64 .crt file, extra files can be inserted (1)
dep7x8        Dela EP7x8 .crt file, extra files can be inserted (1)(2)(3)
din           Dinamic .crt file
easy          EasyFlash .crt file
epyx          Epyx Fastload .crt file
exos          Exos .crt file
expert        Expert Cartridge .crt file
fc1           Final Cartridge I .crt file
fc3           Final Cartridge III .crt file
fcp           Final Cartridge Plus .crt file
ff            Freeze Frame .crt file
fm            Freeze Machine .crt file
fp            Fun Play, Power Play .crt file
gk            Game Killer .crt file
gs            C64GS, System 3 .crt file
ide64         IDE64 .crt file
ieee          IEEE488 .crt file
kcs           KCS Power Cartridge .crt file
md            Magic Desk, Domark, Hes Australia .crt file
mf            Magic Formel .crt file
mikro         Mikro Assembler .crt file
mmc64         MMC64 .crt file
mmcr          MMC Replay .crt file
mv            Magic Voice .crt file
ocean         Ocean .crt file
p64           Prophet 64 .crt file
rep256        Rex EP256 .crt file, extra files can be inserted (1)(2)(3)
retro         Retro Replay .crt file
ross          Ross .crt file
ru            Rex Utility .crt file
s64           Snapshot 64 .crt file
sb            Structured Basic .crt file
se5           Super Explode 5 .crt file
sg            Super Games .crt file
simon         Simons Basic .crt file
ss4           Super Snapshot 4 .crt file
ss5           Super Snapshot 5 .crt file
star          StarDOS .crt file
wl            Westermann Learning .crt file
ws            WarpSpeed .crt file
zax           Zaxxon .crt file

(1) insertion of 32kb eprom files supported.
(2) insertion of 8kb .crt/binary files supported.
(3) insertion of 16kb .crt/binary files supported.


Examples:

- Converting a .crt file to a binary file with no load-address.

cartconv -i foo.crt -o foo.bin


- Converting a .crt file to a .prg file with default load-address.

cartconv -t prg -i foo.crt -o foo.prg


- Converting a .crt file to a .prg file with 49152 as the load-address.

cartconv -t prg -l 49152 -i foo.crt -o foo.prg


- Converting a binary file to an ocean type cartridge.

cartconv -t ocean -i foo.bin -o foo.crt


- Inserting a 32kb eprom file into an dep64 type cartridge.

  step 1 : use the dep64 binary file in VICE as a generic 8kb cartridge.
  step 2 : generate an eprom file.
  step 3 : get the eprom file to the host computer.
  step 4 : insert the eprom file into the final dep64 .crt file:

cartconv -t dep64 -i dep64.bin -i eprom.prg -o foo.crt


- Inserting an 8kb .crt file into a dep256 type cartridge.

cartconv -t dep256 -i dep256.bin -i somegame.crt -o foo.crt


- Inserting multiple 8kb .crt files into a rep256 type cartridge.

cartconv -t rep256 -i rep256.bin -i foo1.crt -i foo2.crt -i foo3.crt -o foo.crt

- Getting information about a .crt file.

cartconv -f foo.crt
