mirror of
https://github.com/cc65/cc65.git
synced 2024-11-14 05:05:45 +00:00
2c975d3642
Up to now static drivers were created via co65 from dynamic drivers. However there was an issue with that approach: The dynamic drivers are "o65 simple files" which obligates that they start with the 'code' segment. However dynamic drivers need to start with the module header - which is written to. For dynamic drivers this isn't more than a conceptual issue because they are always contain a 'data' segment and may therefore only be loaded into writable memory. However when dynamic drivers are converted to static drivers using co65 then that issue becomes a real problem as then the 'code' segment may end up in non-writable memory - and thus writing to the module header fails. Instead of changing the way dynamic drivers work I opted to rather make static driver creation totally independent from dynamic drivers. This allows to place the module header in the 'data' segment (see 'module.mac').
451 lines
13 KiB
ArmAsm
451 lines
13 KiB
ArmAsm
;
|
|
; 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
|
|
.macpack module
|
|
|
|
|
|
; ------------------------------------------------------------------------
|
|
; Header. Includes jump table.
|
|
|
|
module_header _cbm510_inkwl_mou
|
|
|
|
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
|
|
CPREP: jmp $0000 ; Prepare to move the cursor
|
|
CDRAW: jmp $0000 ; Draw 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: jsr CPREP
|
|
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: jsr CDRAW
|
|
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
|