Next: , Previous:   [Contents][Index]


15 cartconv

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.

15.1 cartconv command line options

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.

-s revision

This parameter is optional. It is only needed when converting to a .crt file. See the detailed description of the .crt format for which types support subtypes/revisions.

-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.

-r

This parameter is optional, it enables repair mode (accept broken input files)

-p

This parameter is optional, when it is given cartconv will accept input files that do not match the cartridge sizes (useful for development).

-b

This parameter is optional, when it is given cartconv will not omit banks that are empty (filled with $ff).

-q

This parameter is optional, it disables all non-error messages

--types

This parameter is optional. It shows all supported cartridge types (see below).

--version

Show cartconv version string and exit

The following cartridge types are supported:

bin

Binary .bin file (Default crt->bin)

normal

Generic 8KiB/12KiB/16KiB .crt file (Default bin->crt)

prg

Binary C64 .prg file with load-address

ulti

Ultimax mode 4KiB/8KiB/16KiB .crt file

ap

Atomic Power .crt file

ar2

Action Replay MK2 .crt file

ar3

Action Replay MK3 .crt file

ar4

Action Replay MK4 .crt file

ar5

Action Replay V5 .crt file

bis

BIS-Plus .crt file

bb3

Blackbox V3 .crt file

bb4

Blackbox V4 .crt file

bb8

Blackbox V8 .crt file

bb9

Blackbox V9 .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

dsm

Diashow-Maker .crt file

easy

EasyFlash .crt file

ecr

Easy Calc Result .crt file

epyx

Epyx FastLoad .crt file

exos

EXOS .crt file

expert

Expert Cartridge .crt file

f64

Formel 64 .crt file

fc1

The Final Cartridge .crt file

fc3

The Final Cartridge III .crt file

fcp

Final Cartridge Plus .crt file

ff

Freeze Frame .crt file

fm

Freeze Machine .crt file

fp

Fun Play .crt file

gk

Game Killer .crt file

gmod2

GMod2 .crt file

gmod3

GMod3 .crt file

gs

C64 Games System .crt file

ide64

IDE64 .crt file

ieee

IEEE-488 Interface .crt file

kcs

KCS Power Cartridge .crt file

ks

Kingsoft .crt file

ltk

Lt. Kernal Host Adaptor .crt file

mach5

MACH 5 .crt file

md

Magic Desk .crt file

mf

Magic Formel .crt file

max

MAX Basic .crt file

mikro

Mikro Assembler .crt file

mmc64

MMC64 .crt file

mmcr

MMC Replay .crt file

mv

Magic Voice .crt file

mm

MultiMAX .crt file

ocean

Ocean .crt file

p64

Prophet64 .crt file

pf

Pagefox .crt file

rep256

REX 256KiB EPROM Cart .crt file, extra files can be inserted (1)(2)(3)

rgcd

RGCD .crt file

ross

ROSS .crt file

rr

Retro Replay .crt file

rrnet

RR-Net MK3 .crt file

rrf

REX RAM-Floppy .crt file

ru

REX Utility .crt file

sdbox

SD-BOX .crt file

s64

Snapshot 64 .crt file

sb

Structured BASIC .crt file

se5

Super Explode V5.0 .crt file

sg

Super Games .crt file

silver

Silverrock 128KiB Cartridge .crt file

simon

Simons’ BASIC .crt file

ss4

Super Snapshot V4 .crt file

ss5

Super Snapshot V5 .crt file

star

Stardos .crt file

wl

Westermann Learning .crt file

ws

Warp Speed .crt file

zaxxon

Zaxxon .crt file

zipp

ZIPP-CODE 48 .crt file

15.2 cartconv examples

cartconv -i foo.crt -o foo.bin

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

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

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

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

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

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

Convert a binary file to an ocean type cartridge.

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

Inserting a 32KiB EPROM file into an dep64 type cartridge.

  • step 1 : use the dep64 binary file in VICE as a generic 8KiB 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 dep256 -i dep256.bin -i somegame.crt -o foo.crt

Insert an 8KiB .crt file into a dep256 type cartridge.

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

Insert multiple 8KiB .crt files into a rep256 type cartridge.

cartconv -f foo.crt

Get information about a .crt file.


Next: petcat, Previous: c1541   [Contents][Index]