<title>Oric Telestrat-specific information for cc65
<author>
-<url url="mailto:jede@oric.org" name="Jede">,<newline>
+<url url="mailto:jede@oric.org" name="Jede">
<date>2017-01-22
<abstract>
-An overview over the Telestrat (telemon 3.0 : http://orix.oric.org) runtime system as it is implemented for the cc65 C
-compiler.)
+An overview over the Telestrat (Telemon 2.4 & Telemon 3.x : http://orix.oric.org) runtime system as it is implemented for the cc65 C compiler.
</abstract>
<!-- Table of contents -->
<sect>Binary format<p>
-The standard binary output format generated the linker for the Telestrat target
-is a machine language program with a 20 bytes header described here : http://orix.oric.org/doku.php?id=orix:header
+The standard binary output format generated the linker for the Telestrat
+target is a machine language program with a 20 bytes header described <url
+name="here" url="http://orix.oric.org/doku.php?id=orix:header">
-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.
-There is no tool to insert a binary in a Stratsed floppy disk.
+There is no tool to insert a binary in a Stratsed floppy disk.
-The only way to load a binary (for Telemon 2.4) is to :
+The only way to load a binary (for Telemon 2.4) is to:
<itemize>
<item>remove the 20 bytes header
-<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>download <url name="osdk" url="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)
</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>
available. ROM calls are possible without further precautions.
-
Special locations:
<descrip>
<sect>Platform-specific header files<p>
-Programs containing Telestrat -specific code may use the <tt/telestrat.h/ header file.
+Programs containing Telestrat-specific code may use the <tt/telestrat.h/ header file.
<sect1>Telestrat-specific functions<p>
</descrip><p>
-
<sect>Loadable drivers<p>
+<sect1>TGI<p>
+
+TGI drivers is available on Oric Telestrat with some functions :
+
+<itemize>
+<item>tgi_done
+<item>tgi_install
+<item>tgi_init
+<item>tgi_clear
+<item>tgi_line
+<item>tgi_setpixel
+</itemize>
+
+
<sect1>Extended memory drivers<p>
No extended memory drivers are currently available for the Telestrat.
telemon 2.4 & 3.0 manages joysticks but it had been handled yet.
-</descrip><p>
+</descrip>
<sect1>Mouse drivers<p>
+<descrip>
+
Telestrat manages also mouse, but it had been no handled yet in this version.
+</descrip>
+
<sect1>RS232 device drivers<p>
<descrip>
-not done
+Telestrat has a RS232 port, but it's not usable in cc65.
-</descrip><p>
+</descrip>
<sect>Limitations<label id="limitations"><p>
<sect1>Disk I/O<p>
-This version handles fopen, fread, fclose primitives. Because Telemon 3.0 handles these three primitives. By the way,
-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.
+Telemon 3.0 handles fopen, fread, fclose primitives. It means that this
+function will crash the Telestrat because Telemon 2.4 does not have these
+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>
<item>fclose
<item>fopen
<item>fread
-
</itemize>