]> git.sur5r.net Git - cc65/commitdiff
Merge remote-tracking branch 'upstream/master'
authorChristian Groessler <chris@groessler.org>
Tue, 10 Sep 2013 11:36:28 +0000 (13:36 +0200)
committerChristian Groessler <chris@groessler.org>
Tue, 10 Sep 2013 11:36:28 +0000 (13:36 +0200)
asminc/cbm510.inc
include/cbm510.h
libsrc/cbm/exec.c
libsrc/cbm510/mou/cbm510-inkwl.s [new file with mode: 0644]
libsrc/cbm510/mou/cbm510-joy.s
libsrc/cbm510/pencalib.c [new file with mode: 0755]
samples/mousetest.c

index dfeee1d4e6e8cdf2f60abc44dc3a38284a415a4a..abc36372804d7c2930cd5f9c91888e045140e88a 100644 (file)
@@ -23,6 +23,9 @@ YSIZE           = 25
 
 ;-----------------------------------------------------------------------------
 ; I/O Definitions
+; Note:  These numbers aren't addresses.  They are offsets from the start of
+; each chip's register set.  They are used in the indirect indexed addressing
+; mode.
 
 ; I/O  $d800: VIC-II
 
@@ -66,6 +69,9 @@ VIC_CTRL2       = $16
 
 VIC_HLINE       = $12
 
+VIC_LPEN_X      = $13
+VIC_LPEN_Y      = $14
+
 VIC_VIDEO_ADR   = $18
 
 VIC_IRR         = $19           ; Interrupt request register
index 797b2c4fa95c45642df6f69f5674a4eb6bda6163..25ea0754039287a1f4cb5b2c4334cba0c20c7fc1 100644 (file)
 
 
 /* The addresses of the static drivers */
-extern void cbm510_joy_mou[];  /* Referred to by mouse_static_stddrv[] */
+extern void cbm510_inkwl_mou[];
+extern void cbm510_joy_mou[];   /* Referred to by mouse_static_stddrv[] */
 extern void cbm510_ram_emd[];
 extern void cbm510_std_joy[];   /* Referred to by joy_static_stddrv[] */
 extern void cbm510_std_ser[];
index dec2e00801780ac6a9c14afc936c5dedde6446a5..36c3afe006bb428fb39aa392a1aa31f8fb3300d6 100644 (file)
@@ -1,12 +1,18 @@
 /*
 ** Program-chaining function for Commodore platforms.
 **
-** 2013-08-24, Greg King
+** 2013-09-04, Greg King
 **
 ** This function exploits the program-chaining feature in CBM BASIC's ROM.
-** It puts the desired program's name and unit number into a LOAD statement.
-** Then, it points BASIC to that statement, so that the ROM will run that
-** statement after this program quits.  The ROM will load the next program,
+**
+** CC65's CBM programs have a BASIC program stub.  We start those programs by
+** RUNning that stub; it SYSes to the Machine Language code.  Normally, after
+** the ML code exits, the BASIC ROM continues running the stub.  But, it has
+** no more statements; so, the program stops.
+**
+** This function puts the desired program's name and device number into a LOAD
+** statement.  Then, it points BASIC to that statement, so that the ROM will run
+** that statement after this program quits.  The ROM will load the next program,
 ** and will execute it (because the LOAD will be seen in a running program).
 */
 
 #endif
 
 
+/* The struct below is a line of BASIC code.  It sits in the LOWCODE segment
+** to make sure that it won't be hidden by a ROM when BASIC is re-enabled.
+** The line is:
+**  0 LOAD""+""                    ,01
+** After this function has written into the line, it might look like this:
+**  0 LOAD""+"program name"        ,08
+**
+** When BASIC's LOAD command asks the Kernal to load a file, it gives the
+** Kernal a pointer to a file-name string.  CC65's CBM programs use that
+** pointer to give a copy of the program's name to main()'s argv[0] parameter.
+** But, when BASIC uses a string literal that's in a program, it points
+** directly to that literal -- in the models that don't use banked RAM
+** (Pet/CBM, VIC-20, and 64).  The literal is overwritten by the next program
+** that's loaded.  So, argv[0] would point to machine code.  String operations
+** create a new result string -- even when that operation changes nothing.  The
+** result is put in the string space at the top of BASIC's memory.  So, the ""+
+** in this BASIC line guarantees that argv[0] will get a name from a safe place.
+*/
 #pragma data-name(push, "LOWCODE")
 static struct line {
     const char end_of_line;
@@ -33,13 +57,8 @@ static struct line {
     const char comma;
     char unit[3];
 } basic = {
-    '\0', &basic + 1,           /* high byte must be non-zero */
-    0, 0x93,
-
-    /* This string operation copies the name to high BASIC RAM.
-    ** So, it won't be overwritten when the next program is loaded.
-    */
-    "\"\"", 0xaa, '\"',
+    '\0', &basic + 1,           /* high byte of link must be non-zero */
+    0, 0x93, "\"\"", 0xaa, '\"',
     "\"                    ",   /* format: "123:1234567890123456\"" */
     ',', "01"
 };
diff --git a/libsrc/cbm510/mou/cbm510-inkwl.s b/libsrc/cbm510/mou/cbm510-inkwl.s
new file mode 100644 (file)
index 0000000..8502a70
--- /dev/null
@@ -0,0 +1,444 @@
+;
+; Driver for the Inkwell Systems 170-C and 184-C lightpens.
+;
+; This driver reads only the main button on the 184-C.
+;
+; 2013-09-05, Greg King
+;
+
+        .include        "zeropage.inc"
+        .include        "../extzp.inc"
+
+        .include        "mouse-kernel.inc"
+        .include        "cbm510.inc"
+
+        .macpack        generic
+
+; ------------------------------------------------------------------------
+; Header. Includes jump table.
+
+.segment        "JUMPTABLE"
+
+HEADER:
+
+; Driver signature
+
+        .byte   $6d, $6f, $75           ; ASCII "mou"
+        .byte   MOUSE_API_VERSION       ; Mouse driver API version number
+
+; Library reference
+
+LIBREF: .addr   $0000
+
+; Jump table
+
+        .addr   INSTALL
+        .addr   UNINSTALL
+        .addr   HIDE
+        .addr   SHOW
+        .addr   SETBOX
+        .addr   GETBOX
+        .addr   MOVE
+        .addr   BUTTONS
+        .addr   POS
+        .addr   INFO
+        .addr   IOCTL
+        .addr   IRQ
+
+; Mouse driver flags
+
+        .byte   MOUSE_FLAG_EARLY_IRQ
+
+; Callback table, set by the kernel before INSTALL is called.
+
+CHIDE:  jmp     $0000                   ; Hide the cursor
+CSHOW:  jmp     $0000                   ; Show the cursor
+CMOVEX: jmp     $0000                   ; Move the cursor to X co-ord.
+CMOVEY: jmp     $0000                   ; Move the cursor to Y co-ord.
+
+
+;----------------------------------------------------------------------------
+; Constants
+
+SCREEN_WIDTH    = XSIZE * 8
+SCREEN_HEIGHT   = YSIZE * 8
+
+;----------------------------------------------------------------------------
+; Global variables. The bounding box values are sorted so that they can be
+; written with the least effort in the SETBOX and GETBOX routines; so, don't
+; re-order them.
+
+.rodata
+
+; Default values for below variables
+; (We use ".proc" because we want to define both a label and a scope.)
+
+.proc   DefVars
+        .word   0                       ; XMin
+        .word   0                       ; YMin
+        .word   SCREEN_WIDTH - 1        ; XMax
+        .word   SCREEN_HEIGHT - 1       ; YMax
+.endproc
+
+.bss
+
+Vars:
+XMin:           .res    2               ; X1 value of bounding box
+YMin:           .res    2               ; Y1 value of bounding box
+XMax:           .res    2               ; X2 value of bounding box
+YMax:           .res    2               ; Y2 value of bounding box
+
+XPos:           .res    2               ; Current lightpen position, X
+YPos:           .res    2               ; Current lightpen position, Y
+
+OldPenX:        .res    1               ; Previous HW-counter values
+OldPenY:        .res    1
+
+.data
+
+; Default Inkwell calibration.
+; The first number is the width of the left border;
+; the second number is the actual calibration value.
+
+XOffset:        .byte   (24 + 24) / 2   ; x-offset
+
+; Jump to a function that puts a new calibration value into XOffset.
+Calibrate:      jmp     $0000
+
+
+.code
+
+;----------------------------------------------------------------------------
+; INSTALL routine. Is called after the driver is loaded into memory. If
+; possible, check if the hardware is present.
+; Must return a MOUSE_ERR_xx code in .XA.
+
+INSTALL:
+
+; Initiate variables. Just copy the default stuff over.
+
+        ldx     #.sizeof (DefVars) - 1
+@L0:    lda     DefVars,x
+        sta     Vars,x
+        dex
+        bpl     @L0
+
+        ldx     #15                    ; Change to system bank
+        stx     IndReg
+        ldy     #VIC_LPEN_X
+        lda     (vic),y
+        sta     OldPenX
+        ldy     #VIC_LPEN_Y
+        lda     (vic),y
+        sta     OldPenY
+        ldx     ExecReg                 ; Change back to execution bank
+        stx     IndReg
+
+; Call a calibration function through the library-reference.
+
+        lda     LIBREF
+        ldx     LIBREF+1
+        sta     ptr1                    ; Point to mouse_adjuster
+        stx     ptr1+1
+        ldy     #1
+        lda     (ptr1),y
+        bze     @L1                     ; Don't call pointer if it's NULL
+        sta     Calibrate+2             ; Point to function
+        dey
+        lda     (ptr1),y
+        sta     Calibrate+1
+        lda     #<XOffset               ; Function will set this variable
+        ldx     #>XOffset
+        jsr     Calibrate
+
+; Be sure that the lightpen cursor is invisible and at the default location.
+; It needs to be done here because the lightpen interrupt handler doesn't
+; set the lightpen position if it hasn't changed.
+
+@L1:    sei
+        jsr     CHIDE
+
+        lda     #<(SCREEN_HEIGHT / 2)
+        ldx     #>(SCREEN_HEIGHT / 2)
+        jsr     MoveY
+        lda     #<(SCREEN_WIDTH / 2)
+        ldx     #>(SCREEN_WIDTH / 2)
+        jsr     MoveX
+        cli
+
+; Done, return zero.
+
+        lda     #MOUSE_ERR_OK
+        tax
+        rts
+
+;----------------------------------------------------------------------------
+; UNINSTALL routine. Is called before the driver is removed from memory.
+; No return code required (the driver is removed from memory on return).
+
+UNINSTALL       := HIDE                 ; Hide cursor on exit
+
+;----------------------------------------------------------------------------
+; HIDE routine. Is called to hide the lightpen pointer. The mouse kernel manages
+; a counter for calls to show/hide, and the driver entry point is called only
+; if the mouse is currently visible, and should get hidden. For most drivers,
+; no special action is required besides hiding the lightpen cursor.
+; No return code required.
+
+HIDE:   sei
+        jsr     CHIDE
+        cli
+        rts
+
+;----------------------------------------------------------------------------
+; SHOW routine. Is called to show the lightpen pointer. The mouse kernel manages
+; a counter for calls to show/hide, and the driver entry point is called only
+; if the mouse is currently hidden, and should become visible. For most drivers,
+; no special action is required besides enabling the lightpen cursor.
+; No return code required.
+
+SHOW:   sei
+        jsr     CSHOW
+        cli
+        rts
+
+;----------------------------------------------------------------------------
+; SETBOX: Set the lightpen bounding box. The parameters are passed as they come
+; from the C program, that is, a pointer to a mouse_box struct in .XA.
+; No checks are done if the lightpen is currently inside the box, that is the job
+; of the caller. It is not necessary to validate the parameters; trust the
+; caller; and, save some code here. No return code required.
+
+SETBOX: sta     ptr1
+        stx     ptr1+1                  ; Save data pointer
+
+        ldy     #.sizeof (MOUSE_BOX) - 1
+        sei
+
+@L1:    lda     (ptr1),y
+        sta     XMin,y
+        dey
+        bpl     @L1
+
+        cli
+        rts
+
+;----------------------------------------------------------------------------
+; GETBOX: Return the lightpen bounding box. The parameters are passed as they
+; come from the C program, that is, a pointer to a mouse_box struct in .XA.
+
+GETBOX: sta     ptr1
+        stx     ptr1+1                  ; Save data pointer
+
+        ldy     #.sizeof (MOUSE_BOX) - 1
+@L1:    lda     XMin,y
+        sta     (ptr1),y
+        dey
+        bpl     @L1
+        rts
+
+;----------------------------------------------------------------------------
+; MOVE: Move the mouse to a new position. The position is passed as it comes
+; from the C program, that is: X on the stack and Y in .XA. The C wrapper will
+; remove the parameter from the stack on return.
+; No checks are done if the new position is valid (within the bounding box or
+; the screen). No return code required.
+;
+
+MOVE:   sei                             ; No interrupts
+        jsr     MoveY
+
+        ldy     #$01
+        lda     (sp),y
+        tax
+        dey
+        lda     (sp),y
+        jsr     MoveX                   ; Move the cursor
+
+        cli                             ; Allow interrupts
+        rts
+
+;----------------------------------------------------------------------------
+; BUTTONS: Return the button mask in .XA.
+
+BUTTONS:
+        ldx     #15                     ; To system bank
+        stx     IndReg
+        ldy     #CIA::PRB
+        lda     (cia2),y                ; Read joystick inputs
+        ldx     ExecReg                 ; Back to execution bank
+        stx     IndReg
+
+; Joystick 1, directions in bits 3-0.
+; Make the lightpen button look like a 1351 mouse.
+
+        asl     a                       ; Move joystick-left bit ...
+        asl     a                       ; ... to fire-button bit
+        eor     #MOUSE_BTN_LEFT
+        and     #MOUSE_BTN_LEFT
+        ldx     #>0
+        rts
+
+;----------------------------------------------------------------------------
+; POS: Return the lightpen position in the MOUSE_POS struct pointed to by ptr1.
+; No return code required.
+
+POS:    ldy     #MOUSE_POS::XCOORD      ; Structure offset
+
+        sei                             ; Disable interrupts
+        lda     XPos                    ; Transfer the position
+        sta     (ptr1),y
+        lda     XPos+1
+        iny
+        sta     (ptr1),y
+        lda     YPos
+        iny
+        sta     (ptr1),y
+        lda     YPos+1
+        cli                             ; Enable interrupts
+
+        iny
+        sta     (ptr1),y                ; Store last byte
+        rts
+
+;----------------------------------------------------------------------------
+; INFO: Returns lightpen position and current button mask in the MOUSE_INFO
+; struct pointed to by ptr1. No return code required.
+;
+; We're cheating here, to keep the code smaller: The first fields of the
+; mouse_info struct are identical to the mouse_pos struct; so, we'll just
+; call _mouse_pos to initiate the struct pointer, and fill the position
+; fields.
+
+INFO:   jsr     POS
+
+; Fill in the button state
+
+        jsr     BUTTONS                 ; Will not touch ptr1
+        ldy     #MOUSE_INFO::BUTTONS
+        sta     (ptr1),y
+        rts
+
+;----------------------------------------------------------------------------
+; IOCTL: Driver-defined entry point. The wrapper will pass a pointer to ioctl-
+; specific data in ptr1, and the ioctl code in .A.
+; Must return an error code in .XA.
+;
+
+IOCTL:  lda     #<MOUSE_ERR_INV_IOCTL     ; We don't support ioctls, for now
+        ldx     #>MOUSE_ERR_INV_IOCTL
+        rts
+
+;----------------------------------------------------------------------------
+; IRQ: Irq.-handler entry point. Called as a subroutine, but in the IRQ context
+; (so, be careful). The routine MUST return carry set if the interrupt has been
+; 'handled' -- which means that the interrupt source is gone. Otherwise, it
+; MUST return carry clear.
+;
+
+IRQ:    ldx     #15                     ; To system bank
+        stx     IndReg
+
+; Read the VIC-II lightpen registers.
+
+        ldy     #VIC_LPEN_Y
+        lda     (vic),y
+        cmp     OldPenY
+
+; Skip processing if nothing has changed.
+
+        beq     @SkipY
+        sta     OldPenY
+        ldx     ExecReg                 ; Back to execution bank
+        stx     IndReg
+
+; Subtract the height of the top border, so that the lightpen co-ordinate
+; will match the TGI co-ordinate.
+
+        sub     #50
+        tay                             ; Remember low byte
+        ldx     #>0
+
+; Limit the Y co-ordinate to the bounding box.
+
+        txa
+        cpy     YMin
+        sbc     YMin+1
+        bpl     @L3
+        ldy     YMin
+        ldx     YMin+1
+        jmp     @L4
+
+@L3:    txa
+        cpy     YMax
+        sbc     YMax+1
+        bmi     @L4
+        ldy     YMax
+        ldx     YMax+1
+
+@L4:    tya
+        jsr     MoveY
+
+        ldx     #15                     ; To system bank
+        stx     IndReg
+@SkipY: ldy     #VIC_LPEN_X
+        lda     (vic),y
+        ldx     ExecReg                 ; Back to execution bank
+        stx     IndReg
+        cmp     OldPenX
+
+; Skip processing if nothing has changed.
+
+        beq     @SkipX
+        sta     OldPenX
+
+; Adjust the value by the calibration offset.
+
+        sub     XOffset
+
+; Calculate the new X co-ordinate.
+; The VIC-II register is eight bits; but, the screen co-ordinate is nine bits.
+; Therefore, the VIC-II number is doubled. Then, it points to every other pixel;
+; but, it can reach across the screen.
+
+        asl     a
+        tay                             ; Remember low byte
+        lda     #>0
+        rol     a
+        tax                             ; Remember high byte
+
+; Limit the X co-ordinate to the bounding box.
+
+        cpy     XMin
+        sbc     XMin+1
+        bpl     @L1
+        ldy     XMin
+        ldx     XMin+1
+        jmp     @L2
+
+@L1:    txa
+        cpy     XMax
+        sbc     XMax+1
+        bmi     @L2
+        ldy     XMax
+        ldx     XMax+1
+
+@L2:    tya
+        jsr     MoveX
+
+; Done
+
+@SkipX: clc                             ; Interrupt not "handled"
+        rts
+
+; Move the lightpen pointer to the new Y pos.
+
+MoveY:  sta     YPos
+        stx     YPos+1
+        jmp     CMOVEY
+
+; Move the lightpen pointer to the new X pos.
+
+MoveX:  sta     XPos
+        stx     XPos+1
+        jmp     CMOVEX
index 7a98f8d39c3c94f5262eb20cf1804bafcccebae4..9381cf7616b9ae9238ef02422a57838aba5332e5 100644 (file)
@@ -2,7 +2,7 @@
 ; Driver for a "joystick mouse".
 ;
 ; 2009-09-26, Ullrich von Bassewitz
-; 2013-08-22, Greg King
+; 2013-09-05, Greg King
 ;
 
         .include        "zeropage.inc"
@@ -252,7 +252,7 @@ BUTTONS:
 ; Joystick 1, fire button is in bit 6.
 
         and     #%11000000
-        rol     a                       ; Move bits 7,6 to bits 1,0
+        asl     a                       ; Move bits 7,6 to bits 1,0
         rol     a
         rol     a
         adc     #%00001110              ; Move bit 1 to bit 4
diff --git a/libsrc/cbm510/pencalib.c b/libsrc/cbm510/pencalib.c
new file mode 100755 (executable)
index 0000000..3ff3faf
--- /dev/null
@@ -0,0 +1,94 @@
+/*
+** Calibrate lightpen drivers to the current video hardware.
+**
+** 2013-09-05, Greg King
+**
+*/
+
+
+#include <conio.h>
+#include <mouse.h>
+#include <pen.h>
+
+
+#define COMMAND1 "Adjust by clicking on line."
+#define COMMAND2 "Finish by clicking off bar."
+
+
+/*
+** There is a delay between when the VIC sends its signal, and when the display
+** shows that signal.  There is another delay between the display and when
+** the lightpen says that it saw that signal. Each display and pen is different.
+** Therefore, the driver must be calibrated to them.  A white bar is painted on
+** the screen; and, a line is drawn down the middle of it.  When the user clicks
+** on that line, the difference between its position and where the VIC thinks
+** that the pen is pointing becomes an offset that is subtracted from what the
+** VIC sees.
+*/
+void __fastcall__ pen_calibrate (unsigned char *XOffset)
+{
+    unsigned char oldBg = bgcolor (COLOR_BLUE);
+    unsigned char oldText = textcolor (COLOR_GRAY3);
+    unsigned char oldRev = revers (1);
+    unsigned char sprite0Color = peekbsys ((unsigned)&VIC.spr_color[0]);
+    unsigned char width, width2, height, height4, height8;
+    struct mouse_info info;
+
+    screensize (&width, &height);
+    width2 = width / 2;
+    height4 = height / 4;
+    height8 = height4 * 8;
+
+    /* Draw a bar and line. */
+
+    clrscr ();
+    cclearxy (0, height4, height4 * width);
+    cvlinexy (width2, height4 + 1, height4 - 2);
+    revers (0);
+
+    /* Print instructions. */
+
+    cputsxy (width2 - (sizeof COMMAND1) / 2, height / 2 + 1, COMMAND1);
+    cputsxy (width2 - (sizeof COMMAND2) / 2, height / 2 + 3, COMMAND2);
+
+    pokebsys ((unsigned)&VIC.spr_color[0], COLOR_GRAY2);
+    mouse_show ();
+    mouse_move (width2 * 8, height8 / 2);
+
+    for (;;) {
+        /* Wait for the main button to be released. */
+
+        do ; while ((mouse_buttons () & MOUSE_BTN_LEFT));
+
+        /* Wait for the main button to be pressed. */
+
+        do {
+            mouse_info (&info);
+        } while (!(info.buttons & MOUSE_BTN_LEFT));
+
+        /* Find out if the pen is on or off the bar. */
+
+        if (info.pos.y < height8 || info.pos.y >= height8 * 2) {
+            break;
+        }
+
+        /* On the bar; adjust the offset. */
+        /* Characters are eight pixels wide.
+        ** The VIC-II sees every other pixel;
+        ** so, we use half of the difference.
+        */
+
+        *XOffset += (info.pos.x - (width2 * 8 + 8/2)) / 2;
+    }
+
+    /* Off the bar; wait for the main button to be released. */
+
+    do ; while ((mouse_buttons () & MOUSE_BTN_LEFT));
+
+    mouse_hide ();
+    pokebsys ((unsigned)&VIC.spr_color[0], sprite0Color);
+    revers (oldRev);
+    textcolor (oldText);
+    bgcolor (oldBg);
+    clrscr ();
+}
index e5ee4ca49e5ae0120d8c5b7f6e743bc44748decf..7d94096596018f69b1a1db5f19c447769355950c 100644 (file)
@@ -3,7 +3,7 @@
 ** Will work for the C64/C128/CBM510/Atari/Apple2.
 **
 ** 2001-09-13, Ullrich von Bassewitz
-** 2013-08-23, Greg King
+** 2013-09-05, Greg King
 **
 */
 
@@ -183,7 +183,7 @@ int main (void)
     ** the value will be put into this file, for the next time.
     ** (Other drivers will ignore this.)
     */
-#if defined(__C64__) || defined(__C128__)
+#if defined(__C64__) || defined(__C128__) || defined(__CBM510__)
     pen_adjust ("pen.dat");
 #endif