<url url="mailto:uz@cc65.org" name="Ullrich von Bassewitz">,<newline>
<url url="mailto:polluks@sdf.lonestar.org" name="Stefan A. Haubenthal">,<newline>
<url url="mailto:greg.king5@verizon.net" name="Greg King">
-<date>2014-12-03
+<date>2015-01-09
<abstract>
An overview over the Atmos runtime system as it is implemented for the cc65 C
The standard binary output format generated by the linker for the Atmos target
is a machine language program with a one-line BASIC stub that jumps to the
-machine-language part through <tt/CALL/. It has a 24-byte tape header.
-It means that a file can be loaded as a BASIC program, and started with RUN.
-The standard load address is $501.
+machine-language part through <tt/CALL/. It has one sacrificial byte attached
+to the end (a bug in the Oric ROM means that BASIC can put a variable on top
+of the last byte that was loaded). It has a 24-byte tape header. A file can
+be CLOADed as a BASIC program, and started by typing <tt/RUN/. The standard
+load address is $501.
available. ROM calls are possible without further precautions.
If your program needs more memory, and it won't use TGI graphics, then you can
-use the ld65 command-line option, <tt/-D __RAMEND__=$B400/, when building the
-program, to "grab" the graphics screen RAM. Then, nearly 44K of memory is
-available.
+use the ld65 command-line option, <tt/-D __GRAB__=1/, when building the
+program, to include the graphics screen RAM. Then, nearly 44K of memory
+($0501 to $B400) is available.
Special locations:
<descrip>
<tag><tt/VIA/</tag>
- Access to the VIA (versatile interface adapter) chip is available via the
+ Access to the VIA (Versatile Interface Adapter) chip is available via the
<tt/VIA/ variable. The structure behind this variable is explained in <tt/_6522.h/.
</descrip><p>
<descrip>
<tag><tt/atmos-pase.joy (atmos_pase_joy)/</tag>
- Supports two standard joysticks connected to the P.A.S.E. interface of the Atmos.
+ Supports two standard joysticks connected to a P.A.S.E. / Altai interface of the Atmos.
+
+ <tag><tt/atmos-ijk.joy (atmos_ijk_joy)/</tag>
+ Supports two standard joysticks connected to an IJK interface of the Atmos.
</descrip><p>
They are defined to be FUNCT + a number key.
-<sect1>Capitals Lock<p>
+<sect1>Capitals lock<p>
The keyboard's "CAPS Lock" mode is turned off while the program is running.
The previous mode (usually, CAPS Lock turned on [because Oric BASIC keywords
</enum>
+<sect1>Automatic starting<p>
+
+Usually, a cc65-built program just will sit quietly in memory, after it is
+CLOADed. It waits for you to start it (by typing BASIC's <tt/RUN/ command).
+But, if you want to create a program that will start running immediately after
+it is loaded, then you can use the linker command-line option
+<tt/-D __AUTORUN__=$C7/.
+
+
<sect1>Interrupts<p>
The runtime for the Atmos uses routines marked as <tt/.INTERRUPTOR/ for