X-Git-Url: https://git.sur5r.net/?a=blobdiff_plain;f=doc%2Fgamate.sgml;h=8e18ab76dc08c2d99f12c9c95d2e7055a639d816;hb=df80d071e8eeb799bd1d8ec55acd1ee92714c752;hp=227672b1b816c4253a9e449b7fe7b9114f36c32b;hpb=60285097e3b5bddc8c5ef67bd101039eae547763;p=cc65 diff --git a/doc/gamate.sgml b/doc/gamate.sgml index 227672b1b..8e18ab76d 100644 --- a/doc/gamate.sgml +++ b/doc/gamate.sgml @@ -1,11 +1,9 @@
- 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: @@ -138,17 +138,14 @@ including commercial applications, and to alter it and redistribute it freely, subject to the following restrictions: <enum> -<item> The origin of this software must not be misrepresented; you must not - claim that you wrote the original software. If you use this software - in a product, an acknowledgment in the product documentation would be - appreciated but is not required. -<item> Altered source versions must be plainly marked as such, and must not - be misrepresented as being the original software. -<item> This notice may not be removed or altered from any source - distribution. +<item> The origin of this software must not be misrepresented; you must not + claim that you wrote the original software. If you use this software + in a product, an acknowledgment in the product documentation would be + appreciated but is not required. +<item> Altered source versions must be plainly marked as such, and must not + be misrepresented as being the original software. +<item> This notice may not be removed or altered from any source + distribution. </enum> </article> - - -