Enhanced BASIC, extending CALL
CALL <address> calls a machine code routine at location address. While this in itself is useful it can be extended by adding parameters to the CALL and parsing them from within the routine.
This technique can also be used to pass extra parameters to the USR() function.
B>How to.
First you need to define the parameters for your CALL. This example is for an imaginary bitmapped graphic device.
CALL PLOT,x,y | Set the pixel at x,y | |
PLOT | routine address | |
x | x axis value, range 0 to 255 | |
y | y axis value, range 0 to 64 |
This will then be the form that the call will always take.
Now you need to write the code.
.include BASIC.DIS ; include the BASIC labels file. this allows you ; easy access to the internal routines you need ; to parse the command stream and access some of ; the internals of BASIC. It is usually output ; by the assembler as part of the listing or as a ; separate, optional, file. ; for now we'll put this in the spare RAM at $F400 *= $F400 PLOT JSR LAB_SCGB ; scan for "," and get byte STX PLOT_XBYT ; save plot x JSR LAB_SCGB ; scan for "," and get byte CPX #$40 ; compare with max+1 BCS PLOT_FCER ; if 64d or greater do function call error STX PLOT_YBYT ; save plot y ; now would be your code to perform the plot command ;. ;. ;. ;. ;. RTS ; return to BASIC ; does BASIC function call error PLOT_FCER JMP LAB_FCER ; do function call error, then warm start ; now we just need the variable storage PLOT_XBYT .byte $00 ; set default PLOT_YBYT .byte $00 ; set default END
Finally you need to set the value of PLOT in your BASIC program and use that to callit.
E.g.
. 10 PLOT = $F400 . . 145 CALL PLOT,25,14 : REM set pixel .
See also:
KIM Clone Rev 5
After almost a year (2019)of on-again, off-again, development we finally have a new revision of the KIM Clone.
It...
KIM Clone Rev 3
Changes between Revision 2 and Revision 3 Boards
Revision 3 boards had a number of minor changes to fix know issues o...
Multifunction and Motherboard
This board combines several existing boards into one, and puts it into a form factor meant for those who have legacy mot...
KIM-1 RAM ROM 60K board
This is a combination RAM and EPROM board with a fair amount of flexibility for adding more functionality to your KIM-1!...