From 8e06d6d4f7d72584c3fee54038f362db37e94617 Mon Sep 17 00:00:00 2001 From: "ol.sc" Date: Thu, 8 Nov 2012 23:08:00 +0000 Subject: [PATCH] Added documentation of static drivers. git-svn-id: svn://svn.cc65.org/cc65/trunk@5927 b7a2c559-68d2-44c3-8de9-860c34a00d81 --- doc/apple2enh.sgml | 14 +++++++------ doc/atari.sgml | 52 ++++++++++++++++++++++++++++++++++++---------- doc/atmos.sgml | 7 ++++--- doc/c128.sgml | 31 ++++++++++++++------------- doc/c16.sgml | 7 +++++-- doc/c64.sgml | 39 ++++++++++++++++++---------------- doc/cbm510.sgml | 8 ++++--- doc/cbm610.sgml | 6 ++++-- doc/plus4.sgml | 9 ++++---- doc/vic20.sgml | 8 ++++--- 10 files changed, 115 insertions(+), 66 deletions(-) diff --git a/doc/apple2enh.sgml b/doc/apple2enh.sgml index f3ae6e4e1..667ae9ec7 100644 --- a/doc/apple2enh.sgml +++ b/doc/apple2enh.sgml @@ -313,18 +313,20 @@ you cannot do it, it just means that there's no help. Loadable drivers

+The names in the parentheses denote the symbols to be used for static linking of the drivers. + Graphics drivers

- + This driver features a resolution of 40×48 with 16 colors. The function + This driver features a resolution of 280×192 with 8 colors and two hires pages. Note that programs using this driver will have to be linked with - + Gives access to 47.5 KB RAM (190 pages of 256 bytes each) on an Extended 80-Column Text Card. @@ -364,7 +366,7 @@ you cannot do it, it just means that there's no help. - + Supports up to two standard analog joysticks connected to the game port of the enhanced Apple //e. @@ -375,7 +377,7 @@ you cannot do it, it just means that there's no help. - + Driver for the AppleMouse II Card. Searches all Apple II slots for an AppleMouse II Card compatible firmware. The default bounding box is [0..279,0..191]. @@ -390,7 +392,7 @@ you cannot do it, it just means that there's no help. - + Driver for the Apple II Super Serial Card. Supports up to 19200 baud, hardware flow control (RTS/CTS) and interrupt driven receives. Note that because of the peculiarities of the 6551 chip transmits are not diff --git a/doc/atari.sgml b/doc/atari.sgml index 44bf65671..5450b2990 100644 --- a/doc/atari.sgml +++ b/doc/atari.sgml @@ -154,12 +154,39 @@ chip registers. Graphics drivers

-Currently there are no graphics drivers available for the Atari platform. -However, the runtime library provides a function named _graphics, with -a mode parameter just like the BASIC GRAPHICS command. This function will -switch to the requested graphics mode. -There are currently no functions available to access the graphics -memory. The access must be implemented manually. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Many graphics modes require more memory than the text screen which is in effect when the program starts up. Therefore the programmer has to @@ -221,24 +248,27 @@ the Atari ROM code. Extended memory drivers

-Currently there are no extended memory drivers available for the Atari -platform. + + + + +

+ Joystick drivers

- + Supports up to four standard joysticks connected to the joystick ports of the Atari. - + Supports up to eight standard joysticks connected to a MultiJoy adapter.

- Mouse drivers

Currently no drivers available (in fact, the API for loadable mouse drivers diff --git a/doc/atmos.sgml b/doc/atmos.sgml index 107b8b849..2954b6d95 100644 --- a/doc/atmos.sgml +++ b/doc/atmos.sgml @@ -104,13 +104,14 @@ this may seem overhead, it has two advantages: at runtime with almost no effort. +The names in the parentheses denote the symbols to be used for static linking of the drivers. Graphics drivers

- + This driver was written by Stefan Haubenthal. It features a resolution of 240×200 with 2 colors. @@ -126,7 +127,7 @@ No extended memory drivers are currently available for the Atmos. - + Supports two standard joysticks connected to the P.A.S.E. interface of the Atmos.

@@ -142,7 +143,7 @@ No mouse drivers are currently available for the Atmos. - + Driver for the Telestrat integrated serial controller and the Atmos with a serial add-on. Note that because of the peculiarities of the 6551 chip together with the diff --git a/doc/c128.sgml b/doc/c128.sgml index d691e3cd7..37cdd25f8 100644 --- a/doc/c128.sgml +++ b/doc/c128.sgml @@ -159,19 +159,22 @@ structures, accessing the struct fields will access the chip registers. Loadable drivers

+The names in the parentheses denote the symbols to be used for static linking of the drivers. + + Graphics drivers

Note: The graphics drivers for the VDC are incompatible with the extended memory drivers using the VDC memory! - + This driver was written by Maciej Witkowiak. It uses the 80 column display and features a resolution of 640*200 with two colors and an adjustable palette (that means that the two colors can be chosen out of the 16 VDC colors). - + This driver was written by Maciej Witkowiak. This driver uses the 80 column display and features a resolution of 640*480 with two colors and an adjustable palette (that means that the two colors can be chosen out of the @@ -186,16 +189,16 @@ missing on VDC and are translated to the two colors missing from VIC palette. - + A driver for the GeoRam cartridge. The driver will always assume 2048 pages of 256 bytes each. There are no checks, so if your program knows better, just go ahead. - + An extended memory driver for the RAM in page 1. The common memory area is excluded, so this driver supports 251 pages of 256 bytes each. - + An extended memory driver for the RAM in pages 1-3. The common memory area is excluded, so this driver supports up to 731 pages of 256 bytes each. The @@ -204,17 +207,17 @@ missing on VDC and are translated to the two colors missing from VIC palette. machines with RAM in banks 2+3, so it has been made a separate driver. The additional code was contributed by Marco van den Heuvel. - + A driver for the RamCart 64/128 written and contributed by Maciej Witkowiak. Will test the hardware for the available RAM. - + A driver for the CBM REUs. The driver will determine from the connected REU if it supports 128KB of RAM or more. In the latter case, 256KB are assumed, but since there are no range checks, the application can use more memory if it has better knowledge about the hardware than the driver. - + A driver for the VDC memory of the C128 written and contributed by Maciej Witkowiak. Autodetects the amount of memory available (16 or 64K) and offers 64 or 256 pages of 256 bytes each. Note: This driver is incompatible with @@ -227,14 +230,14 @@ missing on VDC and are translated to the two colors missing from VIC palette. - + Driver for the Protovision 4-player adapter originally written by Groepaz for the C64 and converted for the C128 by me. See for prices and building instructions. Up to four joysticks are supported. - + Supports up to two joysticks connected to the standard joysticks port of the C128. @@ -246,14 +249,14 @@ missing on VDC and are translated to the two colors missing from VIC palette. - + Supports a standard mouse connected to port #0 of the C128. - + Supports a mouse emulated by a standard joystick e.g. 1350 mouse in port #1 of the C128. - + Supports a potentiometer device e.g. Koala Pad connected to port #1 of the C128. @@ -264,7 +267,7 @@ missing on VDC and are translated to the two colors missing from VIC palette. - + Driver for the SwiftLink cartridge. Supports up to 38400 baud, hardware flow control (RTS/CTS) and interrupt driven receives. Note that because of the peculiarities of the 6551 chip together with the use of the NMI, transmits diff --git a/doc/c16.sgml b/doc/c16.sgml index a63bf59b1..110082a19 100644 --- a/doc/c16.sgml +++ b/doc/c16.sgml @@ -148,6 +148,9 @@ structures, accessing the struct fields will access the chip registers. Loadable drivers

+The names in the parentheses denote the symbols to be used for static linking of the drivers. + + Graphics drivers

No graphics drivers are currently available for the C16/C116. @@ -157,7 +160,7 @@ No graphics drivers are currently available for the C16/C116. - + A driver for the hidden RAM below the BASIC and KERNAL ROMs. Supports 125 pages with 256 bytes each if the machine is equipped with 64K of memory (a Plus/4 or a memory extended C16/116). @@ -170,7 +173,7 @@ No graphics drivers are currently available for the C16/C116. - + Supports up to two joysticks connected to the standard joysticks port of the Commodore 16/116. diff --git a/doc/c64.sgml b/doc/c64.sgml index 873a1707b..2e6a37e77 100644 --- a/doc/c64.sgml +++ b/doc/c64.sgml @@ -199,6 +199,9 @@ structures, accessing the struct fields will access the chip registers. Loadable drivers

+The names in the parentheses denote the symbols to be used for static linking of the drivers. + + Graphics drivers

Note: All available graphics drivers for the TGI interface will use @@ -207,7 +210,7 @@ the standard setup without any memory loss or need for a changed configuration. - + This driver features a resolution of 320*200 with two colors and an adjustable palette (that means that the two colors can be chosen out of a palette of the 16 C64 colors). @@ -218,45 +221,45 @@ configuration. - + A driver for the C64 256K memory expansion. This driver offers 768 pages of 256 bytes each. Written and contributed by Marco van den Heuvel. - + A driver for the Double Quick Brown Box cartridge. This driver offers 64 pages of 256 bytes each. Written and contributed by Marco van den Heuvel. - + A driver for the Berkeley Softworks GeoRam cartridge. The driver will determine the available RAM from the connected cartridge. It supports 64KB up to 2048KB of RAM. - + A driver for the ISEPIC cartridge. This driver offers just 8 pages of 256 bytes each. Written and contributed by Marco van den Heuvel. - + A driver for the hidden RAM below the I/O area and kernal ROM. Supports 48 256 byte pages. Please note that this driver is incompatible with any of the graphics drivers! - + A driver for the RamCart 64/128 written and contributed by Maciej Witkowiak. Will test the hardware for the available RAM. - + A driver for the CBM REUs. The driver will determine from the connected REU if it supports 128KB of RAM or more. In the latter case, 256KB are assumed, but since there are no range checks, the application can use more memory if it has better knowledge about the hardware than the driver. - + A driver for the VDC memory of the C128. Written and contributed by Maciej Witkowiak. Can be used if the program is running in C64 mode of the C128. Autodetects the amount of memory available (16 or 64K) and offers 64 or 256 pages of 256 bytes each. - + A driver for the C64 D2TV (the second or PAL version). This driver offers indeed 7680 pages of 256 bytes each. @@ -267,23 +270,23 @@ configuration. - + Driver for the Digital Excess & Hitmen adapter contributed by Groepaz. See on instructions how to build one. Up to four joysticks are supported. - + Driver for the Protovision 4-player adapter contributed by Groepaz. See for prices and building instructions. Up to four joysticks are supported. - + Supports up to two standard joysticks connected to the joysticks port of the C64. - + Supports one joystick emulated by the numberpad of the C128 in C64 mode, the firebutton is labeled &dquot;5&dquot; and ENTER. @@ -294,14 +297,14 @@ configuration. - + Supports a standard mouse connected to port #0 of the C64. - + Supports a mouse emulated by a standard joystick e.g. 1350 mouse in port #1 of the C64. - + Supports a potentiometer device e.g. Koala Pad connected to port #1 of the C64. @@ -312,7 +315,7 @@ configuration. - + Driver for the SwiftLink cartridge. Supports up to 38400 baud, hardware flow control (RTS/CTS) and interrupt driven receives. Note that because of the peculiarities of the 6551 chip together with the use of the NMI, transmits diff --git a/doc/cbm510.sgml b/doc/cbm510.sgml index dcfe06bd2..0dc842bc1 100644 --- a/doc/cbm510.sgml +++ b/doc/cbm510.sgml @@ -173,6 +173,8 @@ will not work! Loadable drivers

+The names in the parentheses denote the symbols to be used for static linking of the drivers. + Graphics drivers

@@ -182,7 +184,7 @@ No graphics drivers are currently available for the Commodore 510. Extended memory drivers

- + A driver for the RAM in bank 1. Supports up to 255 pages with 256 bytes each.

@@ -192,7 +194,7 @@ No graphics drivers are currently available for the Commodore 510. - + Supports up to two standard joysticks connected to the joysticks port of the Commodore 510. @@ -208,7 +210,7 @@ No mouse drivers are currently available for the Commodore 510. - + Driver for the 6551 ACIA chip built into the Commodore 510. Supports up to 19200 baud, hardware flow control (RTS/CTS) and interrupt driven receives. Note that because of the peculiarities of the 6551 chip transmits are not diff --git a/doc/cbm610.sgml b/doc/cbm610.sgml index 9c6ac090f..5acb38a1a 100644 --- a/doc/cbm610.sgml +++ b/doc/cbm610.sgml @@ -173,6 +173,8 @@ will not work! Loadable drivers

+The names in the parentheses denote the symbols to be used for static linking of the drivers. + Graphics drivers

@@ -184,7 +186,7 @@ really good:-). Extended memory drivers

- + A driver for the RAM in bank 2. Supports up to 255 pages with 256 bytes each.

@@ -207,7 +209,7 @@ does not exist). - + Driver for the 6551 ACIA chip built into the Commodore 610. Supports up to 19200 baud, hardware flow control (RTS/CTS) and interrupt driven receives. Note that because of the peculiarities of the 6551 chip transmits are not diff --git a/doc/plus4.sgml b/doc/plus4.sgml index c247cd78c..eefb85e21 100644 --- a/doc/plus4.sgml +++ b/doc/plus4.sgml @@ -146,6 +146,9 @@ structures, accessing the struct fields will access the chip registers. Loadable drivers

+The names in the parentheses denote the symbols to be used for static linking of the drivers. + + Graphics drivers

No graphics drivers are currently available for the Plus/4. @@ -156,19 +159,17 @@ No graphics drivers are currently available for the Plus/4. No extended memory drivers are currently available for the Plus/4. - Joystick drivers

- + Supports up to two joysticks connected to the standard joysticks port of the Plus/4.

- Mouse drivers

Currently no drivers available (in fact, the API for loadable mouse drivers @@ -179,7 +180,7 @@ does not exist). - + Driver for the 6551 ACIA chip built into the Plus/4. Supports up to 19200 baud, hardware flow control (RTS/CTS) and interrupt driven receives. Note that because of the peculiarities of the 6551 chip transmits are not diff --git a/doc/vic20.sgml b/doc/vic20.sgml index 6d6b18321..1227ee667 100644 --- a/doc/vic20.sgml +++ b/doc/vic20.sgml @@ -136,6 +136,9 @@ structures, accessing the struct fields will access the chip registers. Loadable drivers

+The names in the parentheses denote the symbols to be used for static linking of the drivers. + + Graphics drivers

No graphics drivers are currently available for the VIC20. @@ -150,10 +153,10 @@ No extended memory drivers are currently available for the VIC20. - + Supports one standard joystick connected to the joysticks port of the VIC20. - + Driver for the Protovision 4-player adapter contributed by Groepaz. See for prices and @@ -162,7 +165,6 @@ No extended memory drivers are currently available for the VIC20.

- Mouse drivers

No mouse drivers are currently available for the VIC20. -- 2.39.5