apple2_printm/printm.s
Michaelangel007 91c7925ab4 Ver 11
2016-02-18 12:19:00 -08:00

761 lines
15 KiB
ArmAsm

; Version 11
; ca65
.feature c_comments
.feature labels_without_colons
.feature leading_dot_in_identifiers
; 65C02
.PC02
; Force APPLE 'text' to have high bit on
; Will display as NORMAL characters
.macro APPLE text
.repeat .strlen(text), I
.byte .strat(text, I) | $80
.endrep
.endmacro
; Force APPLE 'text' with high bit on but last character has high bit off
; Will display as NORMAL characters (last character will appear FLASHING)
; Merlin: Macro Assembler -- Dextral Character Inverted
.macro DCI text
.repeat .strlen(text)-1, I
.byte .strat(text, I) | $80
.endrep
.byte .strat(text, .strlen(text)-1) & $7F
.endmacro
; Force ASCII 'text' to be control chars: $00..$1F
; Will display as INVERSE characters
.macro CTRL text
.repeat .strlen(text), I
.byte .strat(text, I) & $1F
.endrep
.endmacro
; Force ASCII 'text' to be control chars: $00..$3F
; Will display as INVERSE characters
.macro INV text
.repeat .strlen(text), I
.byte .strat(text, I) & $3F
.endrep
.endmacro
.macro PASCAL text
.byte .strlen(text)
APPLE text
.endmacro
.macro db val
.byte val
.endmacro
.macro dw val
.word val
.endmacro
.macro ds bytes
.res bytes
.endmacro
HOME = $FC58
TABV = $FB5B
; printm pointer for PrintPtr2, PrintPtr4, PrintStrA, PrintStrC, PrintStrP
_temp = $FE
__MAIN = $4000
; DOS3.3 meta -- remove these 2 if running under ProDOS
.word __MAIN ; 2 byte BLOAD address
.word __END - __MAIN ; 2 byte BLOAD size
/*
Output:
X=39 Y=191 $=2345:D5 11010101~10101011
Byte=-128 -001 000 001 127
Strings: 'HELLO','WORLD'
Apple: 'HOME' Pascal: 'String Len 13'
*/
.org __MAIN ; .org must come after header else offsets are wrong
; Demo printm
JSR HOME
LDA #$D5
LDX #$45
LDY #$23
STX DATA+6
STY DATA+7
STX DATA+8
STY DATA+9
STX _HgrAddr+1
STY _HgrAddr+2
_HgrAddr
STA $C0DE
STA DATA+10
JSR ReverseByte
STA DATA+12
LDY #0
JSR VTABY
LDX #<DATA ; Low Byte of Address
LDY #>DATA ; High Byte of Address
JSR PrintM
LDY #2
JSR VTABY
LDX #<DATA2
LDY #>DATA2
JSR PrintM
LDY #4
JSR VTABY
LDX #<DATA3
LDY #>DATA3
JSR PrintM
LDY #6
JSR VTABY
LDX #<DATA4
LDY #>DATA4
JSR PrintM
LDA #8
JMP TABV
ReverseByte
LDX #8
STA $FF ; temp working byte
ReverseBit
ASL $FF ; temp working byte
ROR
DEX
BNE ReverseBit
RTS
VTABY
LDA SCREEN_LO,Y
STA PutChar+1
LDA SCREEN_HI,Y
ORA #$04 ; TXT page 1
STA PutChar+2
RTS
; Y Lookup Table for 40x24 Text Screen
SCREEN_LO
.byte $00, $80, $00, $80
.byte $00, $80, $00, $80
.byte $28, $A8, $28, $A8
.byte $28, $A8, $28, $A8
.byte $50, $D0, $50, $D0
.byte $50, $D0, $50, $D0
SCREEN_HI
.byte $00, $00, $01, $01
.byte $02, $02, $03, $03
.byte $00, $00, $01, $01
.byte $02, $02, $03, $03
.byte $00, $00, $01, $01
.byte $02, $02, $03, $03
TEXT
;byte "X=## Y=ddd $=xxxx:@@ %%%%%%%%~????????"
APPLE "X="
.byte "#"
APPLE " Y="
.byte "d"
APPLE " $="
.byte "x"
APPLE ":"
.byte "@"
APPLE " "
.byte "%"
APPLE "~"
.byte "?"
.byte 0
DATA
dw TEXT ; aArg[ 0] text
dw 39 ; aArg[ 1] x
dw 191 ; aArg[ 2] y
dw $C0DE ; aArg[ 3] addr ScreenAddr
dw $C0DE ; aArg[ 4] byte ScreenAddr pointer
dw $DA1A ; aArg[ 5] bits ScreenByte
dw $DA1A ; aArg[ 6] bits ScreenByte reversed
TEXT2
;byte "Byte=b b b b Str=s,s"
APPLE "Byte="
.byte "b"
APPLE " "
.byte "b"
APPLE " "
.byte "b"
APPLE " "
.byte "b"
APPLE " "
.byte "b"
db 0
TEXT_HELLO
APPLE "HELLO"
db 0
TEXT_WORLD
APPLE "WORLD"
db 0
DATA2
dw TEXT2
dw $80 ; -128
dw $FF ; -1
dw $00 ; 0
dw $01 ; +1
dw $7F ; +127
TEXT3
APPLE "Strings: '"
.byte "s"
APPLE "','"
.byte "s"
APPLE "'"
db 0
DATA3
dw TEXT3
dw TEXT_HELLO
dw TEXT_WORLD
TEXT_DCI
DCI "HOME"
TEXT_PASCAL
PASCAL "String Len 13"
TEXT4
APPLE "Apple: '"
.byte "a"
APPLE "' Pascal: '"
.byte "p"
APPLE "'"
db 0
DATA4
dw TEXT4
dw TEXT_DCI
dw TEXT_PASCAL
; Pad until end of page so PrintM starts on new page
ds 256 - <*
/*
Problem:
We want to print this ...
.byte "X=## Y=### $=####:@@ %%%%%%%%~????????"
... without having to waste marking up literals with an escape character
printf() on the 6502
- is bloated by using a meta-character '%' instead of the high bit
- doesn't provide a standard way to print binary *facepalm*
- doesn't provide a standard way to print a deferenced pointer
- 2 digit, 3 digit and 5 digit decimals requiring wasting a "width" character
e.g. %2d, %3d, %5d
Solution:
Here is a micro replacement, printm()
* Literals have the high byte set (APPLE text)
* Meta characters have the high bit cleared (ASCII)
x Hex 2 Byte
$ Hex 4 Byte
@ Ptr 2 Byte at pointer
& Ptr 4 Byte at pointer
# Dec 1 Byte (max 2 digits)
d Dec 2 Byte (max 3 digits)
u Dec 2 Byte (max 5 digits)
% Bin 1 Byte normal one's and zeros
? Bin 1 Byte inverse one's, normal zeroes
a Str - APPLE text (high bit set), last char is ASCII
s Str - C string, zero terminated
p Str - Pascal string, first character is string length
Note: The dummy address $C0DE is to force the assembler
to generate a 16-bit address instead of optimizing a ZP operand
To toggle features on / off
*/
ENABLE_BIN = 1
ENABLE_DEC = 1
ENABLE_BYTE = 1
ENABLE_HEX = 1
ENABLE_PTR = 1
ENABLE_STR = 1
; Self-Modifying variable aliases
_pScreen = PutChar +1
_pFormat = GetFormat +1
_iArg = NxtArgByte+1
_pArg = IncArg +1
_nHexWidth = HexWidth +1
_nDecWidth = DecWidth +1
; printm( format, args, ... )
; ======================================================================
PrintM
STX _pArg+0
STY _pArg+1
STZ _iArg
NextArg
JSR NxtArgYX
STX _pFormat+0 ; lo
STY _pFormat+1 ; hi
BRA GetFormat ; always
; x Hex 2 Byte
; $ Hex 4 Byte
; ======================================================================
PrintHex4
LDA #4
BNE _PrintHex
PrintHex2
LDA #2
_PrintHex
STA _nHexWidth
JSR NxtArgYX
; Print 16-bit Y,X in hex
; Uses _nHexWidth to limit output width
PrintHexYX
STX _val+0 ; may be tempting to move this to NxtArgYX
STY _val+1 ; as XYtoVal but others call us
LDX #0
_HexDigit
LDA _val+0
AND #$F
CMP #$A ; n < 10 ?
BCC _Hex2Asc
ADC #6 ; n += 6 $A -> +6 + (C=1) = $11
_Hex2Asc
ADC #'0' + $80 ; inverse=remove #$80
STA _bcd, X ; NOTE: Digits are reversed!
LSR _val+1 ; 16-bit SHR nibble
ROR _val+0
LSR _val+1
ROR _val+0
LSR _val+1
ROR _val+0
LSR _val+1
ROR _val+0
INX
HexWidth
CPX #0 ; _nHexWidth NOTE: self-modifying!
BNE _HexDigit
; Intentional fall into reverse BCD
; On Entry: X number of chars to print in buffer _bcd
; ======================================================================
PrintReverseBCD
DEX
BMI NextFormat
LDA _bcd, X
JSR PutChar
BRA PrintReverseBCD
; @ Ptr 2 Byte
; & Ptr 4 Byte
; ======================================================================
PrintPtr4
LDA #4
BNE _PrintPtr
PrintPtr2
LDA #2
_PrintPtr
STA _nHexWidth
JSR NxtArgToTemp
; JSR NxtArgYX
; 13 bytes - zero page version
; STX _temp+0 ; zero-page for (ZP),Y
; STY _temp+1
LDY #$0
LDA (_temp),Y
TAX
INY
LDA (_temp),Y
TAY
; 20 bytes - self modifying code version if zero-page not available
; STX PtrVal+1
; STY PtrVal+2
; LDY #0 ; 0: A->X
;PrtVal
; TAX ; 1: A->Y
; LDA $C0DE, Y
; INY
; CPY #2
; BEQ _JumpPrintHexXY
; BNE _PtrVal
;_JumpPrintHexXY
; TAY
BRA PrintHexYX ; needs XYtoVal setup
; ======================================================================
Print
JSR PutChar
; Adjust pointer to next char in format
NextFormat
INC _pFormat+0
BNE GetFormat
INC _pFormat+1
GetFormat
LDA $C0DE ; _pFormat NOTE: self-modifying!
BEQ _Done
BMI Print ; neg = literal
LDX #NumMeta-1 ; pos = meta
FindMeta
CMP MetaChar,X
BEQ CallMeta
DEX
BPL FindMeta
BMI NextFormat ; always = invalid meta; ignore
CallMeta
TXA
ASL
TAX
JMP (MetaFunc,X)
_Done
RTS
; === Meta Ops ===
; # Dec 1 Byte (max 2 digits)
; d Dec 2 Byte (max 3 digits)
; u Dec 2 Byte (max 5 digits)
; ======================================================================
PrintDec5
LDA #5
BNE _PrintDec ; always
PrintDec3
LDA #3
BNE _PrintDec ; always
PrintDec2
LDA #2 ; 2 digits
_PrintDec
STA _nDecWidth
JSR NxtArgYX
PrintDecYX
STX _val+0 ; may be tempting to move this to NxtArgYX
STY _val+1 ; as XYtoVal but others call us
STZ _bcd+0
STZ _bcd+1
STZ _bcd+2
Dec2BCD
LDX #16
SED
_Dec2BCD
ASL _val+0
ROl _val+1
LDA _bcd+0
ADC _bcd+0
STA _bcd+0
LDA _bcd+1
ADC _bcd+1
STA _bcd+1
LDA _bcd+2
ADC _bcd+2
STA _bcd+2
DEX
BNE _Dec2BCD
CLD
BCD2Char
LDX #2
LDY #5
_BCD2Char
LDA _bcd,X ; __c??? _b_?XX a_YYXX
LSR
LSR
LSR
LSR
CLC
ADC #'0'+$80
STA _bcd,Y ; __c??X _b_YXX aZYYXX
DEY
LDA _bcd,X ; __c??X _b_YXX aZYYXX
AND #$F
CLC
ADC #'0'+$80
STA _bcd,Y ; __c?XX _bYYXX ZZYYXX
DEY
DEX
BPL _BCD2Char
DecWidth
LDX #0 ; _nDecDigits NOTE: self modifying!
JMP PrintReverseBCD
.if ENABLE_BIN
; % Bin 1 Byte normal one's and zeros
; ? Bin 1 Byte inverse one's, normal zeroes
; ======================================================================
PrintBinInv
LDA #$81
BNE _PrintBin
PrintBinAsc
LDA #$01
_PrintBin
STA _PrintBit+1
JSR NxtArgYX ; X = low byte
LDY #8 ; print 8 bits
_Bit2Asc
TXA
CMP #$80 ; C= A>=$80
ROL ; C<-76543210<-C
TAX
AND #$01 ; 0 -> B0
BEQ _FlipBit
_PrintBit
LDA #$81 ; 1 -> 31 NOTE: self-modifying!
_FlipBit
EOR #$B0
JSR PutChar
DEY
BNE _Bit2Asc
_JumpNextFormat
; BRA NextFormat ; always
JMP NextFormat ; JMP :-(
.endif ; ENABLE_BIN
; b Print a signed byte in decimal
; ======================================================================
PrintByte
JSR NxtArgYX ; X = low byte
TXA
BPL PrintBytePos
LDA #'-' + $80 ; X >= $80 --> $80 (-128) .. $FF (-1)
JSR PutChar
TXA
EOR #$FF ; 2's complement
AND #$7F
CLC
ADC #$01
PrintBytePos
TAX
LDY #00 ; 00XX
LDA #3 ; 3 digits max
STA _nDecWidth
JMP PrintDecYX ; needs XYtoVal setup
.if ENABLE_STR
; a String (APPLE text, last byte ASCII)
; See: DCI
; ======================================================================
PrintStrA
JSR NxtArgToTemp
LDY #$0
_PrintStrA
LDA (_temp),Y
BPL @_LastChar
JSR PutChar
INY
BNE _PrintStrA
INC _temp+1
BRA _PrintStrA
@_LastChar
LDX #1
ORA #$80
BRA _PrintCharA
; s String (C,ASCIIZ)
; ======================================================================
PrintStrC
JSR NxtArgToTemp
LDY #$0
@_NextByte
LDA (_temp),Y
BEQ _JumpNextFormat
JSR PutChar
INY
BNE @_NextByte
INC _temp+1
BRA @_NextByte
; p String (Pascal)
; ======================================================================
PrintStrP
; JMP PrintHex4 ; DEBUG
JSR NxtArgToTemp
LDY #$0
LDA (_temp),Y
BEQ _JumpNextFormat
TAX
_PrintStrP
INY
LDA (_temp),Y
_PrintCharA
JSR PutChar
DEX
BNE _PrintStrP
BEQ _JumpNextFormat ; always
.endif ; ENABLE_STR
; __________ Utility __________
; ======================================================================
PutChar
STA $400 ; NOTE: self-modifying!
INC PutChar+1 ; inc lo
RTS
; ======================================================================
; @return next arg as 16-bit arg value in Y,X
NxtArgToTemp
NxtArgYX
JSR NxtArgByte
TAX
; @return _Arg[ _Num ]
NxtArgByte
LDY #00 ; _iArg NOTE: self-modifying!
IncArg
LDA $C0DE,Y ; _pArg NOTE: self-modifying!
INC _iArg ;
BNE @_SamePage
INC _pArg+1 ;
@_SamePage
TAY
; Callers of NxtToArgYX don't use _temp
_NxtArgToTemp
STX _temp+0 ; zero-page for (ZP),Y
STY _temp+1
;XYtoVal
; STX _val+0 ; may be tempting to move this to NxtArgYX
; STY _val+1 ;
RTS
;
; ======================================================================
; Hex2/Hex4 temp
_bcd ds 6 ; 6 chars for printing dec
_val dw 0
MetaChar
.if ENABLE_BIN
db '?' ; PrintBinInv NOTE: 1's printed in inverse
db '%' ; PrintBinAsc
.endif
.if ENABLE_DEC
.if ENABLE_BYTE
db 'b' ; PrintByte NOTE: Signed -128 .. +127
.endif
db 'u' ; PrintDec5
db 'd' ; PrintDec3
db '#' ; PrintDec2
.endif
.if ENABLE_HEX
db 'x' ; PrintHex4
db '$' ; PrintHex2
.endif
.if ENABLE_PTR
db '&' ; PrintPtr4
db '@' ; PrintPtr2
.endif
.if ENABLE_STR
db 'p' ; PrintStrP NOTE: Pascal string; C printf 'p' is pointer!
db 's' ; PrintStrC NOTE: C string, zero terminated
db 'a' ; PrintStrA NOTE: Last byte is ASCII
.endif
_MetaCharEnd
NumMeta = _MetaCharEnd - MetaChar
MetaFunc
.if ENABLE_BIN
dw PrintBinInv
dw PrintBinAsc
.endif
.if ENABLE_DEC
.if ENABLE_BYTE
dw PrintByte
.endif
dw PrintDec5
dw PrintDec3
dw PrintDec2
.endif
.if ENABLE_HEX
dw PrintHex4
dw PrintHex2
.endif
.if ENABLE_PTR
dw PrintPtr4
dw PrintPtr2
.endif
.if ENABLE_STR
dw PrintStrP
dw PrintStrC
dw PrintStrA
.endif
__END