X-Git-Url: https://git.sur5r.net/?a=blobdiff_plain;f=doc%2Flynx.sgml;h=45c429b106e91db47d2931628d49c68def5e6409;hb=6ff1d8314d31096041213263887c9524cfb386f0;hp=a8c2525c2bf341da465a0f32f69e34efb8105802;hpb=f11067e2603d98b1475da308308e3a255dbe072f;p=cc65 diff --git a/doc/lynx.sgml b/doc/lynx.sgml index a8c2525c2..45c429b10 100644 --- a/doc/lynx.sgml +++ b/doc/lynx.sgml @@ -5,7 +5,7 @@
+
+Here is a small traditional Hello World program for the Atari Lynx.
+
+
The standard binary output format generated by the linker for the Lynx target
-is a cart image. It is of course possible to change this behaviour by using a
-modified startup file and linker config.
+is a cart image. By specifying the config file lynx-bll.cfg the linker will
+generate BLL download compatible binary files.
+
+It is of course possible to change this behaviour by using a modified startup
+file and linker config.
+
+The bootloader used in the cc65 lynx library uses a very minimal bootloader
+that does not check the cart or show a title screen.
-You can also produce real carts with directory structures and encrypted
-headers by modifying the startup and linker config files. There is a simple
-example archive called
-that shows how to create a complete bootable Lynx cart.
+The advantage of this bootloader is that it allows creation of cart images to
+many common formats.
+
+Cart sizes
+
cc65 generated programs with the default setup run with the I/O area and the
-kernal enabled, which gives a usable memory range of $400 - $C037.
+kernal enabled, which gives a usable memory range of $200 - $C037.
Special locations:
+
No extended memory drivers are currently available for the Lynx.
@@ -165,9 +263,6 @@ statically linked, because no file I/O is available. See the documentation for
the
No mouse drivers are currently available for the Lynx.
@@ -223,10 +318,7 @@ No mouse drivers are currently available for the Lynx.
We have no handshaking available. Even software handshake is impossible
as ComLynx has only one wire for the data.
- Both transmit and receive are interrupt driven. The driver reserves a fixed
- area $200-$2ff for the transmit ring buffer and $300-$3ff for the receive
- ring buffer. This area can not be used at startup for anything as the Lynx
- ROM needs this area for decryption purposes.
+ Both transmit and receive are interrupt driven.
@@ -235,7 +327,7 @@ No mouse drivers are currently available for the Lynx.
-
+
At this point in time there is no support for the cart filesystem yet. I have
a
-
-
-