Cartconv

Dieser Artikel ist sehr kurz und nicht besonders ausführlich. Hilf bitte mit, ihn zu verbessern.

Cartconv
Entwickler	VICE-Team
Release	2008
Lizenz	GPL
Plattform(en)	Linux, PC (Windows)
Genre	Entwicklungssystem
Steuerung
Medien	keine
Sprache(n)
Information	Bestandteil von VICE

Cartconv ist ein kommandozeilenbasiertes Programm für den PC unter Windows oder Linux zur Umwandlung von CRT-Dateien (Steckmodul-Datei für den Emulator VICE) und ist im Downloadpaket des Emulators VICE enthalten.

Zu beachten ist, dass BIN- und PRG-Dateien ein reines Abbild der im ROM des jeweiligen Steckmoduls enthaltenen Daten darstellen, während CRT-Dateien die Daten und zusätzlich Informationen zum Typ der genutzten Steckmodul-Hardware enthalten. BIN-Dateien lassen sich nur sinnvoll in CRT-Dateien umwandeln, wenn man den vom jeweiligen ROM vorausgesetzten Steckmodul-Hardware-Typ kennt und cartconv beim Konvertieren angibt.

PRG-Dateien werden ähnlich zu BIN-Dateien behandelt. Insbesondere handelt es sich bei Cartconv nicht um einen "Steckmodul-Generator" und kann nicht aus beliebigen PRGs startende Steckmodule erstellen.

Parameter

-i "input name"	erforderlich	Hier wird der Dateiname der zu konvertierenden .BIN oder .CRT-Datei angegeben.
-o "output name"	erforderlich	Hier wird der Dateiname angegeben, unter der die Konvertierung abgespeichert wird.
-t carttype	optional	Wird nur benötigt zum Konvertieren von .CRT-Dateien für die unterstützten Steckmodul-Type (siehe unten).
-s revision	optional	Wird nur benötigt zum Konvertieren von .CRT-Dateien für den unterstützten Subtype bzw. Revision (siehe unten).
-n "cart name"	optional	Steckmodul-Dateiname; wird nur benötigt zum Erstellen einer .CRT-Datei.
-l loadaddress	optional	Speicheradresse zum Laden eines Programms; wird benötigt bei Konvertierung einer .CRT-Datei zu einer .PRG-Datei oder bei der Erstellung einer .CRT-Datei.
-f "input name"	optional	Gibt Informationen über die .CRT-Datei bzw. dem Steckmodul an. Dieser Parameter kann nicht mit den anderen Parametern genutzt werden!
-r	optional	Aktiviert den Repariermodus (akzeptiert defekte Programme).
-p	optional	Programme werden unabhängig der Speichergröße des Steckmoduls in die .CRT-Datei geschrieben (hilfreich bei der Entwicklung).
-b	optional	Leere Speicherbänke werden frei gelassen und mit den Wert $ff aufgefüllt.
-q	optional	Deaktiviert alle unwichtigen Textinformationsausgaben.
--types	optional	Zeigt alle unterstützten Steckmodul-Dateien bzw. Typen an (siehe unten).
--version		Zeigt die aktuelle CARTCONV-Version an.

Beispiele

cartconv -i pacman.crt -o pacman.bin

Extrahiert aus der .CRT-Datei namens pacman.crt den reinen ROM-Inhalt und schreibt ihn in eine .BIN-Datei namens pacman.bin. Die beiden Parameter -i und -o müssen immer angegeben werden, außer bei der Nutzung des Parameters -f.

cartconv -i fc3.bin -t fc3 -o fc3.crt

Interpretiert den Inhalt der .BIN-Datei namens fc3.bin als ROM-Inhalt eines Final Cartridge 3-Moduls und konvertiert es in eine .CRT-Datei namens fc3.crt.

cartconv -i asm_8000_8k.prg -t normal -o normal_8k.crt

Erzeugt aus dem Inhalt der Datei asm_8000_8k.prg die Datei normal_8k.crt. Der Steckmodul-Typ "normal" und die Dateigröße 8k zeigt ein Standard-Steckmodul an, das aus nur einem EPROM besteht, das die EXROM-Leitung der PLA auf Low zieht und das EPROM dementsprechend bei $8000 einblendet (mögliche Hardware-Umsetzungen sind Versa64Card oder Simple64Cart). Das PRG muss dabei die CBM80-Kennung enthalten, sofern das Modul beim Start des Rechners Code ausführen und nicht nur in den Speicher eingeblendet werden soll.

Typen

bin      Binary .bin file (Default crt->bin)
prg      Binary C64 .prg file with load-address

C64 cartridge types:

normal   Generic 8KiB/12KiB/16KiB .crt file (Default bin->crt)
ulti     Ultimax mode 4KiB/8KiB/16KiB .crt file

ap        9 Atomic Power .crt file
ar2      50 Action Replay MK2 .crt file
ar3      35 Action Replay MK3 .crt file
ar4      30 Action Replay MK4 .crt file
ar5       1 Action Replay V5 .crt file
bb3      65 Blackbox V3 .crt file
bb4      66 Blackbox V4 .crt file
bb8      64 Blackbox V8 .crt file
bb9      71 Blackbox V9 .crt file
bis      68 BIS-Plus .crt file
cap      34 Capture .crt file
comal    21 Comal 80 .crt file
dep256   26 Dela EP256 .crt file, extra files can be inserted
dep64    24 Dela EP64 .crt file, extra files can be inserted
dep7x8   25 Dela EP7x8 .crt file, extra files can be inserted
din      17 Dinamic .crt file
drean    74 Drean .crt file
dsm      52 Diashow-Maker .crt file
easy     32 EasyFlash .crt file
ecr      59 Easy Calc Result .crt file
epyx     10 Epyx FastLoad .crt file
exos     44 EXOS .crt file
expert    6 Expert Cartridge .crt file
f64      56 Formel 64 .crt file
fc1      13 The Final Cartridge .crt file
fc3       3 The Final Cartridge III .crt file
fcp      29 Final Cartridge Plus .crt file
ff       45 Freeze Frame .crt file
ff2      77 Freeze Frame MK2 .crt file
fm       46 Freeze Machine .crt file
fp        7 Fun Play .crt file
gk       42 Game Killer .crt file
gmod2    60 GMod2 .crt file
gmod3    62 GMod3 .crt file
gs       15 C64 Games System .crt file
ide64    39 IDE64 .crt file
ieee     41 IEEE-488 Interface .crt file
ieeeflash64 75 IEEE Flash! 64 .crt file
kcs       2 KCS Power Cartridge .crt file
ks       54 Kingsoft .crt file
ltk      72 Lt. Kernal Host Adaptor .crt file
mach5    51 MACH 5 .crt file
max      61 MAX Basic .crt file
md       19 Magic Desk .crt file
mf       14 Magic Formel .crt file
mikro    28 Mikro Assembler .crt file
mm       70 MultiMAX .crt file
mmc64    37 MMC64 .crt file
mmcr     38 MMC Replay .crt file
mv       49 Magic Voice .crt file
ocean     5 Ocean .crt file
p64      43 Prophet64 .crt file
pf       53 Pagefox .crt file
rep256   27 REX 256K EPROM Cart .crt file, extra files can be inserted
rgcd     57 RGCD .crt file
rl       73 RAMLink .crt file
ross     23 ROSS .crt file
rr       36 Retro Replay .crt file
rrf      67 REX RAM-Floppy .crt file
rrnet    58 RR-Net MK3 .crt file
ru       12 REX Utility .crt file
s64      47 Snapshot 64 .crt file
sb       22 Structured BASIC .crt file
sdbox    69 SD-BOX .crt file
se5      48 Super Explode V5.0 .crt file
sg        8 Super Games .crt file
silver   55 Silverrock 128KiB Cartridge .crt file
simon     4 Simons' BASIC .crt file
ss4      40 Super Snapshot V4 .crt file
ss5      20 Super Snapshot V5 .crt file
star     31 Stardos .crt file
turtle   76 HES Turtle Graphics II .crt file
wl       11 Westermann Learning .crt file
ws       16 Warp Speed .crt file
zaxxon   18 Zaxxon .crt file
zipp     63 ZIPP-CODE 48 .crt file

C128 cartridge types:

c128     Generic 8KiB/16KiB .crt file
ap        9 Atomic Power .crt file
ar2      50 Action Replay MK2 .crt file
ar3      35 Action Replay MK3 .crt file
ar4      30 Action Replay MK4 .crt file
ar5       1 Action Replay V5 .crt file
bb3      65 Blackbox V3 .crt file
bb4      66 Blackbox V4 .crt file
bb8      64 Blackbox V8 .crt file
bb9      71 Blackbox V9 .crt file
bis      68 BIS-Plus .crt file
cap      34 Capture .crt file
comal    21 Comal 80 .crt file
dep256   26 Dela EP256 .crt file
dep64    24 Dela EP64 .crt file
dep7x8   25 Dela EP7x8 .crt file
din      17 Dinamic .crt file
drean    74 Drean .crt file
dsm      52 Diashow-Maker .crt file
easy     32 EasyFlash .crt file
ecr      59 Easy Calc Result .crt file
epyx     10 Epyx FastLoad .crt file
exos     44 EXOS .crt file
expert    6 Expert Cartridge .crt file
f64      56 Formel 64 .crt file
fc1      13 The Final Cartridge .crt file
fc3       3 The Final Cartridge III .crt file
fcp      29 Final Cartridge Plus .crt file
ff       45 Freeze Frame .crt file
ff2      77 Freeze Frame MK2 .crt file
fm       46 Freeze Machine .crt file
fp        7 Fun Play .crt file
gk       42 Game Killer .crt file
gmod2    60 GMod2 .crt file
gmod3    62 GMod3 .crt file
gs       15 C64 Games System .crt file
ide64    39 IDE64 .crt file
ieee     41 IEEE-488 Interface .crt file
ieeeflash64 75 IEEE Flash! 64 .crt file
kcs       2 KCS Power Cartridge .crt file
ks       54 Kingsoft .crt file
ltk      72 Lt. Kernal Host Adaptor .crt file
mach5    51 MACH 5 .crt file
max      61 MAX Basic .crt file
md       19 Magic Desk .crt file
mf       14 Magic Formel .crt file
mikro    28 Mikro Assembler .crt file
mm       70 MultiMAX .crt file
mmc64    37 MMC64 .crt file
mmcr     38 MMC Replay .crt file
mv       49 Magic Voice .crt file
ocean     5 Ocean .crt file
p64      43 Prophet64 .crt file
pf       53 Pagefox .crt file
rep256   27 REX 256K EPROM Cart .crt file
rgcd     57 RGCD .crt file
rl       73 RAMLink .crt file
ross     23 ROSS .crt file
rr       36 Retro Replay .crt file
rrf      67 REX RAM-Floppy .crt file
rrnet    58 RR-Net MK3 .crt file
ru       12 REX Utility .crt file
s64      47 Snapshot 64 .crt file
sb       22 Structured BASIC .crt file
sdbox    69 SD-BOX .crt file
se5      48 Super Explode V5.0 .crt file
sg        8 Super Games .crt file
silver   55 Silverrock 128KiB Cartridge .crt file
simon     4 Simons' BASIC .crt file
ss4      40 Super Snapshot V4 .crt file
ss5      20 Super Snapshot V5 .crt file
star     31 Stardos .crt file
turtle   76 HES Turtle Graphics II .crt file
wl       11 Westermann Learning .crt file
ws       16 Warp Speed .crt file
zaxxon   18 Zaxxon .crt file
zipp     63 ZIPP-CODE 48 .crt file

VIC20 cartridge types:

vic20    Generic 8KiB/12KiB/16KiB .crt file
bb        2 Behr Bonz .crt file
fe3       5 Final Expansion .crt file
mega      1 Mega-Cart .crt file
um        4 UltiMem .crt file
vicfp     3 Vic Flash Plugin .crt file

Plus4 cartridge types:

plus4    Generic 4KiB/8KiB/16KiB/32KiB .crt file
c1lo     Generic 4KiB/8KiB/16KiB C1LO .crt file
c1hi     Generic 4KiB/8KiB/16KiB C1HI .crt file
c2lo     Generic 4KiB/8KiB/16KiB C2LO .crt file
c2hi     Generic 4KiB/8KiB/16KiB C2HI .crt file
jacint    3 1MB Cartridge .crt file
magic     1 c264 magic cart .crt file
multi     2 Plus4 multi cart .crt file

Weblinks

• Infos zu Cartconv bei vice-emu.sourceforge.io
• github.com