]> git.sur5r.net Git - cc65/commitdiff
Creativision documentation enhancements. 524/head
authorChristian Groessler <chris@groessler.org>
Tue, 14 Nov 2017 23:13:06 +0000 (00:13 +0100)
committerChristian Groessler <chris@groessler.org>
Tue, 14 Nov 2017 23:13:06 +0000 (00:13 +0100)
doc/creativision.sgml

index 64623b3b27cf19a1bc8ba1ef2d339ae64b3a5141..29653ce0fb8397197334d6c859028dc5b53ecb96 100644 (file)
@@ -4,7 +4,7 @@
 
 <title>VTech Creativision (aka Funvision) specific information for cc65
 <author><url url="mailto:polluks+cc65@sdf.lonestar.org" name="Stefan A. Haubenthal">
-<date>2016-04-14
+<date>2017-11-15
 
 <abstract>
 An overview over the Creativision runtime system as it is implemented for the
@@ -31,14 +31,16 @@ more than one platform. Please see the function reference for more information.
 <sect>Binary format<p>
 
 The standard binary output format generated by the linker for the Creativision target
-is a 4 kbyte machine language program. It is of course possible to change
-this behaviour by using one of the different linker configs.
+is a 4 KB ROM image. To create an 8 KB ROM a custom linker script has
+to be used.
 
 <sect>Memory layout<p>
 
-cc65 generated programs with the default setup run with the I/O area enabled,
-which gives a usable memory range of &dollar;B000 - &dollar;BEFF.
-More ROM may need additional bankswitching code.
+cc65 generated programs with the default setup are 4 KB in size,
+occupying &dollar;B000 - &dollar;BFFF. Usable memory space for the
+user program is &dollar;B000 - &dollar;BEFF. &dollar;BF00 -
+&dollar;BFFF is reserved for the runtime and cartridge configuration
+area.
 
 Special locations:
 
@@ -47,11 +49,15 @@ Special locations:
   The text screen is located at VRAM &dollar;1000.
 
   <tag/Stack/
-  The C runtime stack is located at &dollar;3FF and growing downwards.
+  The C runtime stack is located at &dollar;03FF and growing downwards.
+
+  <tag/RAM/
+  The available RAM for cc65 programs of an unexpanded Creativision
+  starts at &dollar;01FA and ends at &dollar;03FF.
 
   <tag/Heap/
-  The C heap is located at the end of the program and grows towards the C
-  runtime stack.
+  The C heap is located at the end of the program's data area and
+  grows towards the C runtime stack.
 
 </descrip><p>