diff --git a/doc/atari.sgml b/doc/atari.sgml index 1bdfd8ba2..64a28c7b5 100644 --- a/doc/atari.sgml +++ b/doc/atari.sgml @@ -63,7 +63,7 @@ detailed information about the load chunks see the chapter sufficient to know that the first load chunk(s) do preparation work and the main part of the program is in the last load chunk. -The values determining the size of the main part of the program (the only load +The values determining the size of the main part of the program (the second load chunk for With the default load address of $2400 this gives a usable memory range of -[$2400-$CFFF]. Note that the default load address for . +[$2400-$CFFF]. +Please note that the first load chunk (which checks the system +compatibilty and available memory) will always be loaded at +$2E00, regardless of the specified start address. This address +can only be changed by a custom linker config file. Special locations: @@ -459,6 +460,49 @@ All mouse devices connect to joystick port #0. Default drivers: Mouse callbacks

+ +There are two mouse callbacks available. +

+The "text mode" callbacks ( + .export mouse_txt_char : zp = 96 ; 'diamond' screen code + +

+The "P/M" callbacks ( + .export mouse_pm_bits + .export mouse_pm_height : zeropage + .export mouse_pm_hotspot_x : zeropage + .export mouse_pm_hotspot_y : zeropage + .rodata +mouse_pm_bits: + .byte %11110000 + .byte %11000000 + .byte %10100000 + .byte %10010000 + .byte %10001000 + .byte %00000100 + .byte %00000010 +mouse_pm_height = * - mouse_pm_bits +; hot spot is upper left corner +mouse_pm_hotspot_x = 0 +mouse_pm_hotspot_y = 0 + +

+ +The default callbacks definition (RS232 device drivers

Currently there is one RS232 driver. It uses the R: device (therefore @@ -649,7 +693,7 @@ Function keys are mapped to Atari + number key. Passing arguments to the program

-Command line arguments can be passed to Arguments are separated by spaces. @@ -668,6 +712,8 @@ subroutines and will be called automatically by the VBI handler code when they are linked into a program. See the discussion of the . +Please note that on the Atari targets the Reserving a memory area inside a program