mirror of
https://github.com/cc65/cc65.git
synced 2024-09-27 04:54:54 +00:00
Change XEX configuration file names to better reflect original names.
Also, updates documentation with the new files.
This commit is contained in:
parent
0e33a653d7
commit
824e30934e
24
cfg/atari-asm-xex.cfg
Normal file
24
cfg/atari-asm-xex.cfg
Normal file
@ -0,0 +1,24 @@
|
|||||||
|
FEATURES {
|
||||||
|
STARTADDRESS: default = $2E00;
|
||||||
|
}
|
||||||
|
SYMBOLS {
|
||||||
|
__STARTADDRESS__: type = export, value = %S;
|
||||||
|
}
|
||||||
|
MEMORY {
|
||||||
|
ZP: file = "", define = yes, start = $0082, size = $007E;
|
||||||
|
MAIN: file = %O, define = yes, start = %S, size = $BC20 - %S;
|
||||||
|
}
|
||||||
|
FILES {
|
||||||
|
%O: format = atari;
|
||||||
|
}
|
||||||
|
FORMATS {
|
||||||
|
atari: runad = start;
|
||||||
|
}
|
||||||
|
SEGMENTS {
|
||||||
|
ZEROPAGE: load = ZP, type = zp, optional = yes;
|
||||||
|
EXTZP: load = ZP, type = zp, optional = yes; # to enable modules to be able to link to C and assembler programs
|
||||||
|
CODE: load = MAIN, type = rw, define = yes;
|
||||||
|
RODATA: load = MAIN, type = ro optional = yes;
|
||||||
|
DATA: load = MAIN, type = rw optional = yes;
|
||||||
|
BSS: load = MAIN, type = bss, optional = yes, define = yes;
|
||||||
|
}
|
@ -1,56 +0,0 @@
|
|||||||
# Sample linker configuration for C programs using the Atari binary file support.
|
|
||||||
# Use with: cl65 -tatari -Catari-c-xex.cfg prog.c -o prog.xex
|
|
||||||
FEATURES {
|
|
||||||
STARTADDRESS: default = $2000;
|
|
||||||
}
|
|
||||||
SYMBOLS {
|
|
||||||
__SYSTEM_CHECK__: type = import; # force inclusion of "system check" load chunk
|
|
||||||
__STACKSIZE__: type = weak, value = $0800; # 2k stack
|
|
||||||
__STARTADDRESS__: type = export, value = %S;
|
|
||||||
__RESERVED_MEMORY__: type = weak, value = $0000;
|
|
||||||
__SYSCHKHDR__: type = export, value = 0; # Disable system check header
|
|
||||||
__SYSCHKTRL__: type = export, value = 0; # Disable system check trailer
|
|
||||||
}
|
|
||||||
MEMORY {
|
|
||||||
ZP: file = "", define = yes, start = $0082, size = $007E;
|
|
||||||
# "system check" load chunk
|
|
||||||
SYSCHKCHNK: file = %O, start = $2E00, size = $0300;
|
|
||||||
# "main program" load chunk
|
|
||||||
MAIN: file = %O, define = yes, start = %S, size = $BC20 - __STACKSIZE__ - __RESERVED_MEMORY__ - %S;
|
|
||||||
}
|
|
||||||
FILES {
|
|
||||||
%O: format = atari;
|
|
||||||
}
|
|
||||||
FORMATS {
|
|
||||||
atari: runad = start,
|
|
||||||
initad = SYSCHKCHNK: __SYSTEM_CHECK__;
|
|
||||||
}
|
|
||||||
SEGMENTS {
|
|
||||||
ZEROPAGE: load = ZP, type = zp;
|
|
||||||
EXTZP: load = ZP, type = zp, optional = yes;
|
|
||||||
SYSCHK: load = SYSCHKCHNK, type = rw, define = yes, optional = yes;
|
|
||||||
STARTUP: load = MAIN, type = ro, define = yes;
|
|
||||||
LOWBSS: load = MAIN, type = rw, optional = yes; # not zero initialized
|
|
||||||
LOWCODE: load = MAIN, type = ro, define = yes, optional = yes;
|
|
||||||
ONCE: load = MAIN, type = ro, optional = yes;
|
|
||||||
CODE: load = MAIN, type = ro, define = yes;
|
|
||||||
RODATA: load = MAIN, type = ro;
|
|
||||||
DATA: load = MAIN, type = rw;
|
|
||||||
INIT: load = MAIN, type = rw, optional = yes;
|
|
||||||
BSS: load = MAIN, type = bss, define = yes;
|
|
||||||
}
|
|
||||||
FEATURES {
|
|
||||||
CONDES: type = constructor,
|
|
||||||
label = __CONSTRUCTOR_TABLE__,
|
|
||||||
count = __CONSTRUCTOR_COUNT__,
|
|
||||||
segment = ONCE;
|
|
||||||
CONDES: type = destructor,
|
|
||||||
label = __DESTRUCTOR_TABLE__,
|
|
||||||
count = __DESTRUCTOR_COUNT__,
|
|
||||||
segment = RODATA;
|
|
||||||
CONDES: type = interruptor,
|
|
||||||
label = __INTERRUPTOR_TABLE__,
|
|
||||||
count = __INTERRUPTOR_COUNT__,
|
|
||||||
segment = RODATA,
|
|
||||||
import = __CALLIRQ__;
|
|
||||||
}
|
|
@ -1,24 +1,56 @@
|
|||||||
|
# Sample linker configuration for C programs using the Atari binary file support.
|
||||||
|
# Use with: cl65 -tatari -Catari-c-xex.cfg prog.c -o prog.xex
|
||||||
FEATURES {
|
FEATURES {
|
||||||
STARTADDRESS: default = $2E00;
|
STARTADDRESS: default = $2000;
|
||||||
}
|
}
|
||||||
SYMBOLS {
|
SYMBOLS {
|
||||||
__STARTADDRESS__: type = export, value = %S;
|
__SYSTEM_CHECK__: type = import; # force inclusion of "system check" load chunk
|
||||||
|
__STACKSIZE__: type = weak, value = $0800; # 2k stack
|
||||||
|
__STARTADDRESS__: type = export, value = %S;
|
||||||
|
__RESERVED_MEMORY__: type = weak, value = $0000;
|
||||||
|
__SYSCHKHDR__: type = export, value = 0; # Disable system check header
|
||||||
|
__SYSCHKTRL__: type = export, value = 0; # Disable system check trailer
|
||||||
}
|
}
|
||||||
MEMORY {
|
MEMORY {
|
||||||
ZP: file = "", define = yes, start = $0082, size = $007E;
|
ZP: file = "", define = yes, start = $0082, size = $007E;
|
||||||
MAIN: file = %O, define = yes, start = %S, size = $BC20 - %S;
|
# "system check" load chunk
|
||||||
|
SYSCHKCHNK: file = %O, start = $2E00, size = $0300;
|
||||||
|
# "main program" load chunk
|
||||||
|
MAIN: file = %O, define = yes, start = %S, size = $BC20 - __STACKSIZE__ - __RESERVED_MEMORY__ - %S;
|
||||||
}
|
}
|
||||||
FILES {
|
FILES {
|
||||||
%O: format = atari;
|
%O: format = atari;
|
||||||
}
|
}
|
||||||
FORMATS {
|
FORMATS {
|
||||||
atari: runad = start;
|
atari: runad = start,
|
||||||
|
initad = SYSCHKCHNK: __SYSTEM_CHECK__;
|
||||||
}
|
}
|
||||||
SEGMENTS {
|
SEGMENTS {
|
||||||
ZEROPAGE: load = ZP, type = zp, optional = yes;
|
ZEROPAGE: load = ZP, type = zp;
|
||||||
EXTZP: load = ZP, type = zp, optional = yes; # to enable modules to be able to link to C and assembler programs
|
EXTZP: load = ZP, type = zp, optional = yes;
|
||||||
CODE: load = MAIN, type = rw, define = yes;
|
SYSCHK: load = SYSCHKCHNK, type = rw, define = yes, optional = yes;
|
||||||
RODATA: load = MAIN, type = ro optional = yes;
|
STARTUP: load = MAIN, type = ro, define = yes;
|
||||||
DATA: load = MAIN, type = rw optional = yes;
|
LOWBSS: load = MAIN, type = rw, optional = yes; # not zero initialized
|
||||||
BSS: load = MAIN, type = bss, optional = yes, define = yes;
|
LOWCODE: load = MAIN, type = ro, define = yes, optional = yes;
|
||||||
|
ONCE: load = MAIN, type = ro, optional = yes;
|
||||||
|
CODE: load = MAIN, type = ro, define = yes;
|
||||||
|
RODATA: load = MAIN, type = ro;
|
||||||
|
DATA: load = MAIN, type = rw;
|
||||||
|
INIT: load = MAIN, type = rw, optional = yes;
|
||||||
|
BSS: load = MAIN, type = bss, define = yes;
|
||||||
|
}
|
||||||
|
FEATURES {
|
||||||
|
CONDES: type = constructor,
|
||||||
|
label = __CONSTRUCTOR_TABLE__,
|
||||||
|
count = __CONSTRUCTOR_COUNT__,
|
||||||
|
segment = ONCE;
|
||||||
|
CONDES: type = destructor,
|
||||||
|
label = __DESTRUCTOR_TABLE__,
|
||||||
|
count = __DESTRUCTOR_COUNT__,
|
||||||
|
segment = RODATA;
|
||||||
|
CONDES: type = interruptor,
|
||||||
|
label = __INTERRUPTOR_TABLE__,
|
||||||
|
count = __INTERRUPTOR_COUNT__,
|
||||||
|
segment = RODATA,
|
||||||
|
import = __CALLIRQ__;
|
||||||
}
|
}
|
||||||
|
@ -203,7 +203,7 @@ is <it/left out/, keep this in mind.
|
|||||||
The values you assign to the two symbols <tt/__AUTOSTART__/ and <tt/__EXEHDR__/
|
The values you assign to the two symbols <tt/__AUTOSTART__/ and <tt/__EXEHDR__/
|
||||||
don't matter.
|
don't matter.
|
||||||
|
|
||||||
<sect2><tt/atari-xex.cfg/<p>
|
<sect2><tt/atari-asm-xex.cfg/<p>
|
||||||
|
|
||||||
This config file allows writing multi segment binaries easily, without having to
|
This config file allows writing multi segment binaries easily, without having to
|
||||||
write the header explicitly on each segment.
|
write the header explicitly on each segment.
|
||||||
@ -213,7 +213,8 @@ format support on LD65 instead of the standard binary output, so it does not
|
|||||||
have the <tt/__AUTOSTART/ nor the <tt/__EXEHDR__/ symbols.
|
have the <tt/__AUTOSTART/ nor the <tt/__EXEHDR__/ symbols.
|
||||||
|
|
||||||
Note that each <tt/MEMORY/ area in the configuration file will have it's own
|
Note that each <tt/MEMORY/ area in the configuration file will have it's own
|
||||||
segment in the output file with the correct headers.
|
segment in the output file with the correct headers, and you can specify and
|
||||||
|
init address INITAD) for each memory area.
|
||||||
|
|
||||||
<sect2><tt/atari-cart.cfg/<p>
|
<sect2><tt/atari-cart.cfg/<p>
|
||||||
|
|
||||||
@ -242,6 +243,18 @@ would need to be split in more parts and the parts to be loaded manually.
|
|||||||
To write the generated file to a cassette, a utility (<tt/w2cas.com/) to run
|
To write the generated file to a cassette, a utility (<tt/w2cas.com/) to run
|
||||||
on an Atari is provided in the <tt/util/ directory of <tt/atari/ target dir.
|
on an Atari is provided in the <tt/util/ directory of <tt/atari/ target dir.
|
||||||
|
|
||||||
|
<sect2><tt/atari-xex.cfg/<p>
|
||||||
|
|
||||||
|
This config file shows how to write a binary using the ATARI (xex) file format
|
||||||
|
support on LD65, this simplifies the memory areas and allows to add new memory
|
||||||
|
areas easily without writing new headers and trailers.
|
||||||
|
|
||||||
|
Note that the default C library includes the system-check chunk, so in this
|
||||||
|
linker configuration we suppress the importing of the header and trailer for
|
||||||
|
this chunk by defining the standard import symbols to a 0 value. For the
|
||||||
|
initialization address of the system-check chunk, the INITAD is set directly in
|
||||||
|
the configuration.
|
||||||
|
|
||||||
<sect1><tt/atarixl/ config files<p>
|
<sect1><tt/atarixl/ config files<p>
|
||||||
|
|
||||||
<sect2>default config file (<tt/atarixl.cfg/)<p>
|
<sect2>default config file (<tt/atarixl.cfg/)<p>
|
||||||
@ -265,6 +278,15 @@ The files generated by this config file include the
|
|||||||
<ref name="&dquot;system check&dquot;" id="syschkxl"> load chunk. It can
|
<ref name="&dquot;system check&dquot;" id="syschkxl"> load chunk. It can
|
||||||
optionally be left out, see <ref name="Getting rid of the &dquot;system check&dquot; load chunk" id="nosyschk">.
|
optionally be left out, see <ref name="Getting rid of the &dquot;system check&dquot; load chunk" id="nosyschk">.
|
||||||
|
|
||||||
|
<sect2><tt/atarixl-xex.cfg/<p>
|
||||||
|
|
||||||
|
Similar to the <tt/atari-xex.cfg/ above, this config file shows how to write a
|
||||||
|
binary using the ATARI (xex) file format support on LD65.
|
||||||
|
|
||||||
|
In addition to the suppressing of the system-check headers and trailers, this
|
||||||
|
also suppresses the shadow-ram-preparation headers and trailers, but does this
|
||||||
|
by defining an "UNUSED" memory area that is not written to the output file.
|
||||||
|
|
||||||
|
|
||||||
<sect>Platform specific header files<p>
|
<sect>Platform specific header files<p>
|
||||||
|
|
||||||
|
Loading…
Reference in New Issue
Block a user