the10thwiz/cc65
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Correcting some code from github comments

Browse Source
This commit is contained in:
jede
2017-02-01 23:58:33 +01:00
parent d9778994fa
commit 0e649f24ea
13 changed files with 51 additions and 1200 deletions
Download Patch File Download Diff File Expand all files Collapse all files

57
doc/telestrat.sgml
View File

@@ -10,7 +10,7 @@
<abstract>
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>
<!-- Table of contents -->
@@ -21,21 +21,35 @@ compiler.
<sect>Overview<p>
This file contains an overview of the Telestrat runtime system as it comes with the
cc65 C compiler. It describes the memory layout, Telemon3.0-specific header files,
cc65 C compiler. It describes the memory layout, Telestrat-specific header files,
available drivers, and any pitfalls specific to that platform.
Please note that Telemon3.0-specific functions are just mentioned here, they are
Please note that Telestrat-specific functions are just mentioned here, they are
described in detail in the separate <url url="funcref.html" name="function
reference">. Even functions marked as "platform dependent" may be available on
more than one platform. Please see the function reference for more
information.
<sect>Binary format<p>
The standard binary output format generated by the linker for the Telemon 3.0 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 here : http://orix.oric.org/doku.php?id=orix:header
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.
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.
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)
</itemize>
@@ -64,12 +78,12 @@ Special locations:
<sect>Platform-specific header files<p>
Programs containing Telemon 3.0 -specific code may use the <tt/telemon.h/ header file.
Programs containing Telestrat -specific code may use the <tt/telestrat.h/ header file.
<sect1>Telemon 3.0-specific functions<p>
<sect1>Telestrat-specific functions<p>
The functions listed below are special for the Telemon 3.0. See the <url
The functions listed below are special for the Telestrat. See the <url
url="funcref.html" name="function reference"> for declaration and usage.
<itemize>
@@ -77,13 +91,13 @@ url="funcref.html" name="function reference"> for declaration and usage.
<item>ping
<item>shoot
<item>zap
<item>oupsx
<item>oups
</itemize>
<sect1>Hardware access<p>
The following pseudo variables declared in the <tt/atmos.h/ header file do allow
The following pseudo variables declared in the <tt/telestrat.h/ header file do allow
access to hardware located in the address space. Some variables are
structures; accessing the struct fields will access the chip registers.
@@ -99,30 +113,23 @@ structures; accessing the struct fields will access the chip registers.
<sect>Loadable drivers<p>
<em>Note:</em> Since the Atmos doesn't have working disk I/O
(see <ref id="limitations" name="section &quot;Limitations&quot;">), the
available drivers cannot be loaded at runtime (so the term "loadable drivers"
is somewhat misleading). Instead, the drivers have to be statically linked. While
this may seem overhead, it has two advantages:
<sect1>Extended memory drivers<p>
No extended memory drivers are currently available for the Atmos.
No extended memory drivers are currently available for the Telestrat.
<sect1>Joystick drivers<p>
<descrip>
telemon 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>
<sect1>Mouse drivers<p>
Telemon 3.0 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.
<sect1>RS232 device drivers<p>
@@ -132,14 +139,12 @@ not done
</descrip><p>
<sect>Limitations<label id="limitations"><p>
<sect1>Disk I/O<p>
This version handles fopen, fread, fclose primitives. Because Telemon 3.0 handles these two primitives. By the way,
it uses an extension "ch376 card" which handles sdcard and FAT 32 usb key.
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.
<itemize>
<item>fclose