The most important patcher command is the “patch” command, with this you overwrite (never insert) bytes<\/p>\n\n\n\n
patch <position> 0x<value><\/em><\/strong>\n\n# Patch position 12 (0x0C) with the four bytes 0x0025015E - changes the ROM version number to r37.350\nCapCLI> patch 0x0C 0x0025015E<\/code><\/pre>\n\n\n\nCreate\/set alias<\/h2>\n\n\n\n
Within Cap you can create variables (for some reason, I started using the word alias, now its stuck), but it’s just a variable, you can directly assign values to aliases, grab a chunk of the ROM and put it into an alias (to patch somewhere else or change), if the alias looks like it could be a number, you can add to or subtract from it, and you can treat it like a string and chop it up using the mid function.
I’ll probably add some extra functions here, like conversion between hex, int and strings, as it’s a little limited at the mo.<\/p>\n\n\n\n
alias <aliasname> <value><\/em><\/strong>\n\nCapCLI> alias FRED 0x01020304\nCapCLI> echo $FRED\n0x01020304\n\nalias <aliasname> romdata <start> <size><\/em><\/strong>\n\nCapCLI> loadrom \"ROMs\/TOSEC.Firmware\/Kickstart v2.05 r37.350 (1992-04)(Commodore)(A600HD)[!].rom\"\nCapCLI> alias FRED romdata 0x0C 0x04\nCapCLI> echo $FRED\n0x0025015E\n\nalias <aliasname> add <value><\/em><\/strong>\n\nCapCLI> echo $FRED\n0x0025015e\nCapCLI> alias FRED add 1\nCapCLI> echo $FRED\n0x0025015f\n\nNote, add and subtract only work properly on hex values, i.e. they must begin 0x (I might change this later)\n\nalias <aliasname> subtract <value><\/em><\/strong>\n\nCapCLI> echo $FRED\n0x0025015f\nCapCLI> alias FRED subtract 51\nCapCLI> echo $FRED\n0x0025012c\n\n\nalias <aliasname> mid <start> <size><\/em><\/strong>\n\nCapCLI> echo $FRED\n0x0025012c\nCapCLI> alias FRED mid 3 2\nCapCLI> echo $FRED\n02\n\nNote, the alias has 0x at the start of it, this is included <\/em>in the length, so position 0 is \"0\", position 1 is \"x\" etc.<\/code><\/pre>\n\n\n\nInbuilt aliases<\/h2>\n\n\n\n
For your delectation, I have created some inbuilt aliases that help you access\/modify ROM and library information, you (almost) only ever change data with the patch <\/strong>command.<\/p>\n\n\n\nROM things<\/strong>\n\nThe ROMBASE calculated from the ROM\n$ROMBASE<\/em><\/strong>\n\nCapCLI> echo $ROMBASE\n0x00f80000\n\nThe Commodore checksum (not CRC32)\n$CALCCHECKSUM<\/strong><\/em>\n\nCapCLI> echo $CALCCHECKSUM\n0xba5d5fa4\n\nThe location within the ROM of the kickstart version (usually 12, 0x0C)\n$(KICKSTARTVERSION)<\/strong><\/em>\n\nCapCLI> echo $(KICKSTARTVERSION)\n0x0000000c\n\nNote the use of brackets, to say \"location of\" rather than the actual kickstart version.\n\n# read the kickstart version into the KSV alias\nCapCLI> alias KSV romdata $(KICKSTARTVERSION) 4\nCapCLI> echo $KSV\n0x0025015E\n\nLocations of library things<\/strong>\n\nThese will give you the location of things that relate to specific libraries, so you can read or manipulate them - remember, the brackets mean \"give me the location\" not the value stored at that location\n\n$libraryname.(START)\n$libraryname.(END)\n$libraryname.(ROMTAG)\n$libraryname.(ROMTAG.MATCHTAG)\n$libraryname.(ROMTAG.ENDSKIP)\n$libraryname.(ROMTAG.FLAGS)\n$libraryname.(ROMTAG.VERSION)\n$libraryname.(ROMTAG.TYPE)\n$libraryname.(ROMTAG.PRI)\n$libraryname.(ROMTAG.NAME)\n$libraryname.(ROMTAG.IDSTRING)\n$libraryname.(ROMTAG.INIT)<\/strong><\/em>\n\nIf you want the start and end location of a library, then you can simply use the name;\n\n$libraryname<\/em><\/strong>\n\nCapCLI> echo $cia.resource\n274624 275640\n<\/code><\/pre>\n\n\n\nHash aliases<\/h2>\n\n\n\n
You can find and refer to files by their hash value, but only if you have previously done an “auditfiles” command, the auditfiles command hashes every file under the named directory and creates an alias for every file based upon it’s hash value – as you can guess, scanning an entire directory tree is very CPU and disk intensive, so don’t do this on gigs or data, it’s only really worthwhile on ROMs or Components.
This is used extensively in the “Recipes and Tests” to load a specific ROM or component (without having to know the exact name).<\/p>\n\n\n\n
Scan all files under a directory and evaluate the hash value<\/em><\/strong>\nauditfiles <dirname>\n<\/em><\/strong>\nCapCLI> auditfiles ROMs\nCapCLI> echo \"$0x43b0df7b\"\nROMs\/TOSEC.Firmware\/Kickstart v2.05 r37.350 (1992-04)(Commodore)(A600HD)[!].rom<\/code><\/pre>\n\n\n\nPatching the checksum<\/h2>\n\n\n\n
If you have altered the ROM, you will need to update the C= checksum, there’s a hard way and an easy way, but the hard way isn’t that hard.<\/p>\n\n\n\n
Using the location of the start of the checksum, patch it with a newly calculated value\npatch $Checksum.(START) $CALCCHECKSUM<\/em><\/strong>\n\nThe \"checksum\" command does this for you\nchecksum <\/em><\/strong><\/code><\/pre>\n\n\n\nFinding data<\/h2>\n\n\n\n
If you want to scan the ROM (or just a library) for the location of things, I have a command for that… the unusually named find command, if the find is successful then the alias $FIND is set to the position that it found it, if it’s not found then $FIND is not updated and you just get “Not found” (I might change this to reset $FIND).
You can search for binary text using hex representation (so searching for strings is a bit laborious) or you can search for 68000 opcodes<\/p>\n\n\n\n
find <from> <to> <what><\/em><\/strong>\n\nCapCLI> find 0 262143 0x6C696272617279\nCapCLI> echo $FIND\n0x00000038\n\nCapCLI> find 0 262143 0x112233445566778899aa\nNot found<\/strong>\nCapCLI> echo $FIND\n0x00000038\n\nfindopcode <from> <to> <what><\/em><\/strong>\n\nCapCLI> findopcode $0x75094a7b.scsidisk_40.12_(21.12.93) \"JSR FCD6(A6)\"\nCapCLI> echo $FIND\n0x00000090<\/code><\/pre>\n","protected":false},"excerpt":{"rendered":"Patch a position The most important patcher command is the “patch” command, with this you overwrite (never insert) bytes Create\/set alias Within Cap you can create variables (for some reason, I started using the word alias, now its stuck), but it’s just a variable, you can directly assign values to aliases, grab a chunk of …<\/p>\n