]> git.sur5r.net Git - cc65/blobdiff - doc/gamate.sgml
SetNewMode() documentation = issue #814
[cc65] / doc / gamate.sgml
index 227672b1b816c4253a9e449b7fe7b9114f36c32b..e5e3acbdd796f1e4dea3bcc31969ceae8b0062d8 100644 (file)
@@ -1,11 +1,9 @@
 <!doctype linuxdoc system>
 
 <article>
-
 <title>Gamate System specific information for cc65
 <author>
 <url url="mailto:groepaz@gmx.net" name="Groepaz/Hitmen">
-<date>2015-11-14
 
 <abstract>
 An overview over the Gamate runtime system as it is implemented for the
@@ -36,19 +34,19 @@ The standard binary output format generated by the linker for the Gamate target
 is a cartridge image with header. It is of course possible to change this
 behaviour by using a modified startup file and linker config.
 
+Note: the first two bytes of the header contain a checksum that must be inserted
+by an external program. Such an utility is provided in util/gamate/gamate-fixcart.c
+
 <sect>Platform specific header files<p>
 
 Programs containing Gamate specific code may use the <tt/gamate.h/ header file.
 
 
-<sect1>Hardware access<p>
-
-The following pseudo variables declared in the <tt/gamate.inc/ include file do
-allow access to hardware located in the address space.
+<sect1>Gamate specific functions<p>
 
-<descrip>
-
-</descrip><p>
+<itemize>
+<item>waitvsync</item>
+</itemize>
 
 
 
@@ -92,7 +90,8 @@ No serial drivers are currently available for the Gamate.
 <sect>Limitations<p>
 
 <itemize>
-<item>interruptor support in crt0 (and cfg) is missing
+<item>When using the C-compiler, keep in mind that only 0x200 bytes RAM in total
+can be used for variables and the runtime stack.
 </itemize>
 
 <sect1>Disk I/O<p>
@@ -118,7 +117,8 @@ following functions (and a few others):
 <sect>Other hints<p>
 
 <itemize>
-<item>a good emulator to use for Gamate is "MESS/MAME" (<url url="http://www.mess.org/">)
+<item>The Gamate is emulated by MESS (<url url="http://www.mess.org/">),
+run like this: <tt>mess gamate -debug -window -skip_gameinfo -cart test.bin</tt>
 </itemize>
 
 some resources on the Gamate:
@@ -149,6 +149,3 @@ freely, subject to the following restrictions:
 </enum>
 
 </article>
-
-
-