X-Git-Url: https://git.sur5r.net/?a=blobdiff_plain;f=doc%2Fc128.sgml;h=1d8734fdfc319888b5a4b603487242d6bc8e8cff;hb=8590de5cf3515d7df156a5d470ad06bd68f97555;hp=2bfb37a3db38dbcb7ff6b72cacf596e8a1fe4c5c;hpb=8886e6f100de035aa6738356c06d05eb1c668a8f;p=cc65 diff --git a/doc/c128.sgml b/doc/c128.sgml index 2bfb37a3d..1d8734fdf 100644 --- a/doc/c128.sgml +++ b/doc/c128.sgml @@ -1,10 +1,9 @@
- Commodore 128-specific information for cc65 -<author><url url="mailto:uz@cc65.org" name="Ullrich von Bassewitz"> -<date>2014-04-12 +<author><url url="mailto:uz@cc65.org" name="Ullrich von Bassewitz">,<newline> +<url url="mailto:polluks@sdf.lonestar.org" name="Stefan A. Haubenthal"> <abstract> An overview over the C128 runtime system as it is implemented for the cc65 C @@ -88,6 +87,21 @@ url="funcref.html" name="function reference"> for declaration and usage. </itemize> +<sect1>C128-specific accelerator functions<p> + +The functions listed below are accelerator functions for the C128. See the <url +url="funcref.html" name="function reference"> for declaration and usage. + +<itemize> +<item>detect_c128 +<item>detect_scpu +<item>get_c128_speed +<item>get_scpu_speed +<item>set_c128_speed +<item>set_scpu_speed +</itemize> + + <sect1>CBM-specific functions<p> Some functions are available for all (or at least most) of the Commodore @@ -109,6 +123,8 @@ declaration and usage. <item>cbm_k_basin <item>cbm_k_bsout <item>cbm_k_clrch +<item>cbm_k_tksa +<item>cbm_k_second <item>cbm_load <item>cbm_open <item>cbm_opendir @@ -181,22 +197,32 @@ Note: The graphics drivers for the VDC are incompatible with the extended memory drivers using the VDC memory! <descrip> + + <tag><tt/c128-hi.tgi (c128_hi_tgi)/</tag> + 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 VIC colors). Unlike BASIC 7.0, this driver puts its + graphics data into the RAM behind the ROMs. + <tag><tt/c128-vdc.tgi (c128_vdc_tgi)/</tag> 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 + 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). <tag><tt/c128-vdc2.tgi (c128_vdc2_tgi)/</tag> 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 + 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 16 VDC colors). The driver requires 64KB VDC RAM. + </descrip><p> -Note: The colors are translated from definitions in headers to correct VDC values; -so, please use definitions or VIC color numbers only. Colors <tt/GRAY3/ and <tt/BROWN/ are -missing on VDC, and are translated to the two colors missing from the VIC palette. +Note: The colors are translated from the definitions in the headers to correct +VDC values; so, please use definitions or VIC color numbers only. Colors +<tt/GRAY3/ and <tt/BROWN/ are missing on the VDC; and, are translated to the +two colors missing from the VIC palette. + <sect1>Extended memory drivers<p> @@ -313,6 +339,13 @@ The default drivers, <tt/mouse_stddrv (mouse_static_stddrv)/, point to <tt/c128- <sect>Limitations<p> +<sect1>Realtime clock<p> + +The realtime clock functions use the CIA1 TOD clock. As that clock only stores +the time but not the date, the date set by <tt/clock_settime()/ is simply stored +inside the C library for retrieval in the same program via <tt/clock_gettime()/. + + <sect>Other hints<p> @@ -364,14 +397,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>