bslathi19/cc65
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity

Add CARTSIZE to cfg file for configuring the a78 header. Add descriptions of usage.

Browse Source
This commit is contained in:
Karri Kaksonen
2022-03-07 08:48:59 +02:00
committed by mrdudz
parent db48605434
commit f7c59ee1ec
3 changed files with 33 additions and 12 deletions
Download Patch File Download Diff File Expand all files Collapse all files

30
doc/atari7800.sgml
View File

@@ -24,7 +24,29 @@ comes with the cc65 C compiler. It describes the memory layout, Atari
<sect>Binary format<p>
The default binary output format generated by the linker for the Atari
7800 target is a 32K cartridge image.
7800 target is a 48K cartridge image.
<sect>A78 header<p>
There is lots of different cart hardware available for the atari7800.
Some carts have ROM, RAM, sound hardware, non-volatile high score chips.
In order to know what kind of hardware the cart build requires there is
a header file of 128 bytes in front of the binary.
The default build creates a cart file for a 48K rom cart without any
extra features like the pokey audio chip or extra RAM.
In order to make cc65 more user friendly the build will add the a78
header automatically. This allows you to run the binary on emulators
and flash carts on the real console.
<sect>Encryption<p>
In order to boot the game in a mode that supports atari7800 functions
the cart must be encrypted after the linking phase.
There is a program called sign7800 that can be used to sign the cart.
The encryption is not required for running the cart on emulators.
You can also run atari2600 games without encryption.
<sect>Memory layout<p>
@@ -104,12 +126,6 @@ There are no drivers for the Atari 7800.
TBD
<sect>Encryption<p>
In order to boot the game in a mode that supports atari7800 functions
the cart must be encrypted after the linking phase.
There is a program called sign7800 that can be used to sign the cart.
<sect>Other hints<p>
One may write a custom linker configuration file to tune the memory