1
0
mirror of https://github.com/cc65/cc65.git synced 2025-01-10 19:29:45 +00:00

Updating doc

This commit is contained in:
jede 2017-02-02 22:44:06 +01:00
parent 5abb40b229
commit ad6e54c2d8

View File

@ -9,7 +9,7 @@
<date>2017-01-22 <date>2017-01-22
<abstract> <abstract>
An overview over the Telestrat (telemon 3.0 : http://orix.oric.org) runtime system as it is implemented for the cc65 C An overview over the Telestrat (Telemon 3.0 : http://orix.oric.org) runtime system as it is implemented for the cc65 C
compiler.) compiler.)
</abstract> </abstract>
@ -37,7 +37,7 @@ is a machine language program with a 20 bytes header described here : http://ori
This header is used for Telemon 3.0. This header is used for Telemon 3.0.
Anyway, for Telemon 2.4, there is no file management, there is no TAPE routine in telemon, there is no way to load a binary easiy. Anyway, for Telemon 2.4, there is no file management, there is no TAPE routine in Telemon, there is no way to load a binary easily.
Stratsed (the Telestrat operating system) handles files management. Stratsed is loaded to memory from floppy disk. Stratsed (the Telestrat operating system) handles files management. Stratsed is loaded to memory from floppy disk.
@ -47,10 +47,12 @@ The only way to load a binary (for Telemon 2.4) is to :
<itemize> <itemize>
<item>remove the 20 bytes header <item>remove the 20 bytes header
<item>download osdk : http://osdk.defence-force.org/index?page=download <item>download osdk : http://osdk.defence-force.org/index?page=download
<item>use Floppybuilder in OSDK to insert the binary with the tool (please read FloppyBuilder manual to insert your binary, and to start microdisc boot sector when telestrat starts) <item>use Floppybuilder in OSDK to insert the binary with the tool (please read FloppyBuilder manual to insert your binary, and to start microdisc boot sector when Telestrat starts)
</itemize> </itemize>
Please note also, that the binary converted into TAP file, will not produce a right stratsed file when tap2dsk and old2mfm are used. You will be in the case that Telestrat/Stratsed crashed when you do "DIR" command.
If you know the Stratsed disk format, please contact the author of this doc.
<sect>Memory layout<p> <sect>Memory layout<p>
@ -60,7 +62,6 @@ In the standard setup, cc65-generated programs use the memory from
available. ROM calls are possible without further precautions. available. ROM calls are possible without further precautions.
Special locations: Special locations:
<descrip> <descrip>
@ -110,7 +111,6 @@ structures; accessing the struct fields will access the chip registers.
</descrip><p> </descrip><p>
<sect>Loadable drivers<p> <sect>Loadable drivers<p>
<sect1>Extended memory drivers<p> <sect1>Extended memory drivers<p>
@ -124,27 +124,31 @@ No extended memory drivers are currently available for the Telestrat.
telemon 2.4 & 3.0 manages joysticks but it had been handled yet. telemon 2.4 & 3.0 manages joysticks but it had been handled yet.
</descrip><p> </descrip>
<sect1>Mouse drivers<p> <sect1>Mouse drivers<p>
<descrip>
Telestrat manages also mouse, but it had been no handled yet in this version. Telestrat manages also mouse, but it had been no handled yet in this version.
</descrip>
<sect1>RS232 device drivers<p> <sect1>RS232 device drivers<p>
<descrip> <descrip>
not done Telestrat has a RS232 port, but it's not used
</descrip><p> </descrip><
<sect>Limitations<label id="limitations"><p> <sect>Limitations<label id="limitations"><p>
<sect1>Disk I/O<p> <sect1>Disk I/O<p>
This version handles fopen, fread, fclose primitives. Because Telemon 3.0 handles these three primitives. By the way, Telemon 3.0 handles fopen, fread, fclose primitives. It means that this function will crash the Telestrat because Telemon 2.4 did not have not these primitives.
it uses an extension "ch376 card" which handles sdcard and FAT 32 usb key. In the next version of Telemon, FT DOS, Sedoric, Stratsed will be handled in these 3 primitives. By the way, Telemon 3.0 uses an extension "ch376 card" which handles sdcard and FAT 32 usb key. In the next version of Telemon, FT DOS, Sedoric, Stratsed will be handled in these 3 primitives (fopen, fread, fclose).
<itemize> <itemize>
<item>fclose <item>fclose