SOURCE VIEWER

app.s

Original bytes preserved. This is a browser-readable view.

DOWNLOAD ORIGINAL ↓

; =====================================================================
; Chapter 11 application shell, display, keyboard, input and formatting.
; New implementation logic.  ORG 0E80 is the application boundary.
; =====================================================================
        ORG     &H0E80

CH11_COLD:
        PRE     SS,&H0100
        LD      $30,1
        LD      $31,0
        PSR     SZ,0
        PSR     SY,30
        PSR     SX,31
        PST     UA,&H14

; Install the established BOOT-derived C-ROM bank-call template in RAM.
        PRE     IX,RCS_TOP
        PRE     IY,RCS_END-1
        PRE     IZ,RCS
        PST     UA,&H44
        BUP
        PST     UA,&H14

        PRE     SS,SSPTP
        PRE     US,USPTP
        CAL     SYS_INIT
        CAL     SCREEN_INIT

; Deterministic application keyboard mode; CRTKY owns decoded key semantics.
        PST     UA,&H54
        PRE     IX,KEYMD
        ST      $31,(IX+$SX)
        PST     UA,&H14

; Cold-start retained state required by NOTES.
        PRE     IX,Q_N
        LD      $0,8
        ST      $0,(IX+$SX)
        PRE     IX,H_N
        ST      $0,(IX+$SX)

        CAL     CH11_SPLASH
        JP      TOP_MENU

; True language-card BRK service: abandon Chapter 11 through native path.
CH11_BRK:
        JP      &H0001

SYS_INIT:
        LDW     $28,SYSCLR
        CAL     SYSCAL
        PST     UA,&H14
        LDW     $28,SETLCD
        CAL     SYSCAL
        PST     UA,&H14
        LDW     $28,SET4LN
        CAL     SYSCAL
        PST     UA,&H14
        RTN

SCREEN_INIT:
        PST     UA,&H14
        CAL     OFFCHK
        PPO     &HC0
        LDW     $0,&H12B5
SI_DELAY:
        SBW     $0,$SY
        JR      NZ,SI_DELAY
        CAL     &H02D4
        PPO     &HC3
        LD      $0,&H0C
        LDW     $1,&H3000
        STLM    $0,3
        LD      $6,$SX
        LD      $8,128
        CAL     &H018D
        CAL     &H0304
        CAL     &H0306
        CAL     CUR_OFF
        RTN

CUR_OFF:
        LDW     $28,CROFF
        CAL     SYSCAL
        PST     UA,&H14
        RTN

; $6 = physical LCD cursor position. EDCSR is C-ROM cursor state.
SETCUR:
        PST     UA,&H54
        PRE     IX,EDCSR
        ST      $6,(IX+$SX)
        PST     UA,&H14
        RTN

CUR_ON:
        LDW     $28,CSREN
        CAL     SYSCAL
        PST     UA,&H14
        RTN

; -------------------------- low-level display -------------------------
PUTC:
        LD      $7,$16
        LD      $0,$7
        DIU     $7
        DID     $0
        OR      $7,$SZ
        CAL     &H0197
        RTN

; IZ -> zero-terminated ROM string, $6 = firmware cursor.
LCD_PUTZ:
        LDI     $7,(IZ+$SX)
        LD      $0,$7
        DIU     $7
        DID     $0
        OR      $7,$SZ
        RTN     Z
        CAL     &H0197
        JR      LCD_PUTZ

; Exactly 32 ROM bytes at IZ.  $6 selects physical row start.
LCD_ROM32:
        LD      $20,32
LR32_LOOP:
        LDI     $16,(IZ+$SX)
        PHS     $20
        CAL     PUTC
        PPS     $20
        SB      $20,$SY
        JR      NZ,LR32_LOOP
        RTN

; $10/$11 RAM pointer, $13 length, $6 cursor.
LCD_RAMN:
        AN      $13,$13
        RTN     Z
LRN_LOOP:
        PRE     IX,$10
        LD      $16,(IX+$SX)
        CAL     PUTC
        ADW     $10,$SY
        SB      $13,$SY
        JR      NZ,LRN_LOOP
        RTN

LCD_CLEAR:
        LD      $6,&H00
        PRE     IZ,BLANK32
        CAL     LCD_ROM32
        LD      $6,&H20
        PRE     IZ,BLANK32
        CAL     LCD_ROM32
        LD      $6,&H40
        PRE     IZ,BLANK32
        CAL     LCD_ROM32
        LD      $6,&H60
        PRE     IZ,BLANK32
        CAL     LCD_ROM32
        CAL     CUR_OFF
        RTN

; --------------------------- decimal format ---------------------------
; Input $2/$3 unsigned word.  Output NUM_BUF, $13 length.  Value is consumed.
DEC16_BUF:
        PRE     IX,NUM_BUF
        LD      $13,0
        LD      $18,0

        LDW     $20,10000
        CAL     D16_COUNT
        CAL     D16_MAYBE

        LDW     $20,1000
        CAL     D16_COUNT
        CAL     D16_MAYBE

        LDW     $20,100
        CAL     D16_COUNT
        CAL     D16_MAYBE

        LDW     $20,10
        CAL     D16_COUNT
        CAL     D16_MAYBE

; Ones are always emitted, including value zero.
        LD      $16,$2
        AD      $16,&H30
        STI     $16,(IX+$SX)
        AD      $13,$SY
        LD      $16,0
        ST      $16,(IX+$SX)
        RTN

; Count how many times divisor $20 fits in value $2.  Return digit in $16.
D16_COUNT:
        LD      $16,0
D16_CLOOP:
        SBCW    $2,$20
        JR      C,D16_CDONE
        SBW     $2,$20
        AD      $16,$SY
        JP      D16_CLOOP
D16_CDONE:
        RTN

; Emit digit $16 only after first nonzero digit.
D16_MAYBE:
        AN      $18,$18
        JR      NZ,D16_EMIT
        AN      $16,$16
        RTN     Z
        LD      $18,1
D16_EMIT:
        AD      $16,&H30
        STI     $16,(IX+$SX)
        AD      $13,$SY
        RTN

; Input word $2, physical cursor $6.
LCD_DEC16:
        CAL     DEC16_BUF
        LDW     $10,NUM_BUF
        JP      LCD_RAMN

; ---------------------------- key handling ----------------------------
; Raw readiness gate from accepted Chapter 08 practice.
; $17=0 no key, 1 ordinary key, 2 BRK.  No translation is performed here.
RAW_READY:
        LD      $0,&H4B
RR_LOOP:
        PST     IA,$0
        GRE     KY,$1
        GRE     KY,$1
        DID     $2
        ANCW    $1,$1
        JR      NZ,RR_FOUND
        SB      $0,$30
        JR      LNZ,RR_LOOP
        LD      $17,$31
        RTN
RR_FOUND:
        SBC     $0,&H41
        JR      NZ,RR_NORMAL
        LD      $17,2
        RTN
RR_NORMAL:
        LD      $17,$30
        RTN

; Blocking application-level decoded key.
; Returns $17=1 and decoded $0 for ordinary keys; $17=2 for raw BRK.
KEY_WAIT:
KW_LOOP:
        CAL     RAW_READY
        SBC     $17,$SZ
        JR      Z,KW_LOOP
        SBC     $17,2
        RTN     Z
        LDW     $28,CRTKY
        CAL     SYSCAL
        PST     UA,&H14
        LD      $17,$30
        RTN

; Nonblocking cooperative control poll used inside Queens search.
; Return $0=0 none/other, $0=1 MENU. BRK exits through INKEY/native 0001h.
CTL_POLL:
        CAL     INKEY
        PST     UA,&H14
        AN      $17,$17
        JR      Z,CP_NONE
        LD      $12,$0
        SBC     $12,KEYMENU
        JR      Z,CP_MENU
CP_NONE:
        LD      $0,0
        RTN
CP_MENU:
        LD      $0,1
        RTN

; ---------------------------- cold splash -----------------------------
CH11_SPLASH:
        CAL     LCD_CLEAR
        LD      $6,&H00
        PRE     IZ,SPL0
        CAL     LCD_ROM32
        LD      $6,&H20
        PRE     IZ,SPL1
        CAL     LCD_ROM32
        LD      $6,&H40
        PRE     IZ,SPL2
        CAL     LCD_ROM32
        LD      $6,&H60
        PRE     IZ,SPL3
        CAL     LCD_ROM32
        CAL     CUR_OFF

; Bounded automatic delay: two distinct stable TM transitions, no EXE.
        GST     TM,$8
        GST     TM,$8
        LD      $10,$8
        LD      $11,2
SPL_WAIT:
        CAL     OFFCHK
        GST     TM,$8
        GST     TM,$8
        LD      $12,$8
        SBC     $12,$10
        JR      Z,SPL_WAIT
        LD      $10,$8
        SB      $11,$30
        JR      NZ,SPL_WAIT
        RTN

; ----------------------------- top menu -------------------------------
TOP_MENU:
        CAL     LCD_CLEAR
        LD      $6,&H00
        PRE     IZ,TOP1
        CAL     LCD_PUTZ
        LD      $6,&H20
        PRE     IZ,TOP2
        CAL     LCD_PUTZ
        LD      $6,&H60
        PRE     IZ,TOP_ACT
        CAL     LCD_ROM32
        CAL     CUR_OFF
TM_WAIT:
        CAL     KEY_WAIT
        SBC     $17,2
        JP      Z,CH11_BRK
        LD      $12,$0
        SBC     $12,KEYF1
        JP      Z,Q_ACTION
        LD      $12,$0
        SBC     $12,KEYF2
        JP      Z,H_ACTION
        LD      $12,$0
        SBC     $12,KEYF3
        JP      Z,VTTEST
        LD      $12,$0
        SBC     $12,KEYMENU
        JP      Z,TOP_MENU
        JP      TM_WAIT

; -------------------------- decimal N input ---------------------------
Q_NEWN:
        PRE     IX,IN_MODE
        LD      $0,0
        ST      $0,(IX+$SX)
        CAL     N_INPUT
        AN      $0,$0
        JP      Z,Q_ACTION
        JP      TOP_MENU

H_NEWN:
        PRE     IX,IN_MODE
        LD      $0,1
        ST      $0,(IX+$SX)
        CAL     N_INPUT
        AN      $0,$0
        JP      Z,H_ACTION
        JP      TOP_MENU

; Return $0=0 accepted, $0=1 MENU. BRK leaves Chapter 11.
N_INPUT:
        PRE     IX,IN_LEN
        LD      $0,0
        ST      $0,(IX+$SX)
        PRE     IX,IN_ERR
        ST      $0,(IX+$SX)
        CAL     N_DRAW
NI_LOOP:
        CAL     KEY_WAIT
        SBC     $17,2
        JP      Z,NI_BRK
        LD      $12,$0
        SBC     $12,KEYMENU
        JP      Z,NI_MENU
        LD      $12,$0
        SBC     $12,KEYBS
        JR      Z,NI_BACK
        LD      $12,$0
        SBC     $12,KEYEXE
        JP      Z,NI_EXE

; Accept only ASCII decimal digits.
        LD      $12,$0
        SBC     $12,&H30
        JR      C,NI_LOOP
        LD      $12,$0
        SBC     $12,&H3A
        JR      C,NI_DIGIT
        JP      NI_LOOP

NI_BACK:
        PRE     IX,IN_LEN
        LD      $0,0
        ST      $0,(IX+$SX)
        PRE     IX,IN_ERR
        ST      $0,(IX+$SX)
        CAL     N_DRAW
        JP      NI_LOOP

NI_DIGIT:
        PRE     IX,IN_LEN
        LD      $14,(IX+$SX)
        SBC     $14,2
        JP      Z,NI_LOOP
        LDW     $2,IN_D0
        AD      $2,$14
        PRE     IX,$2
        ST      $0,(IX+$SX)
        PRE     IX,IN_LEN
        AD      $14,$SY
        ST      $14,(IX+$SX)
        PRE     IX,IN_ERR
        LD      $12,0
        ST      $12,(IX+$SX)
        CAL     N_DRAW
        JP      NI_LOOP

NI_EXE:
        PRE     IX,IN_LEN
        LD      $14,(IX+$SX)
        SBC     $14,1
        JR      Z,NI_ONE
        SBC     $14,2
        JR      Z,NI_TWO
        JP      NI_BAD

NI_ONE:
        PRE     IX,IN_D0
        LD      $14,(IX+$SX)
        SBC     $14,&H31
        JP      C,NI_BAD
        SBC     $14,&H3A
        JP      NC,NI_BAD
        SB      $14,&H30
        JP      NI_STORE

NI_TWO:
        PRE     IX,IN_D0
        LD      $14,(IX+$SX)
        SBC     $14,&H31
        JR      NZ,NI_BAD
        PRE     IX,IN_D1
        LD      $14,(IX+$SX)
        SBC     $14,&H30
        JR      NZ,NI_BAD
        LD      $14,10

NI_STORE:
        PRE     IX,IN_MODE
        LD      $12,(IX+$SX)
        AN      $12,$12
        JR      NZ,NI_STH
        PRE     IX,Q_N
        ST      $14,(IX+$SX)
        LD      $0,0
        RTN
NI_STH:
        PRE     IX,H_N
        ST      $14,(IX+$SX)
        LD      $0,0
        RTN

NI_BAD:
        PRE     IX,IN_LEN
        LD      $0,0
        ST      $0,(IX+$SX)
        PRE     IX,IN_ERR
        LD      $0,1
        ST      $0,(IX+$SX)
        CAL     N_DRAW
        JP      NI_LOOP

NI_BRK:
        CAL     CUR_OFF
        JP      CH11_BRK

NI_MENU:
        LD      $0,1
        RTN

N_DRAW:
        CAL     LCD_CLEAR
        PRE     IX,IN_MODE
        LD      $0,(IX+$SX)
        AN      $0,$0
        JR      NZ,ND_H
        LD      $6,&H00
        PRE     IZ,NQ_TITLE
        CAL     LCD_PUTZ
        JR      ND_MSG
ND_H:
        LD      $6,&H00
        PRE     IZ,NH_TITLE
        CAL     LCD_PUTZ
ND_MSG:
        PRE     IX,IN_ERR
        LD      $0,(IX+$SX)
        AN      $0,$0
        JR      Z,ND_NORMAL
        LD      $6,&H20
        PRE     IZ,N_BAD
        CAL     LCD_PUTZ
        JR      ND_ENTRY
ND_NORMAL:
        LD      $6,&H20
        PRE     IZ,N_HELP
        CAL     LCD_PUTZ
ND_ENTRY:
        LD      $6,&H40
        PRE     IZ,N_PROMPT
        CAL     LCD_PUTZ
        PRE     IX,IN_LEN
        LD      $13,(IX+$SX)
        AN      $13,$13
        JR      Z,ND_BOTTOM
        LDW     $10,IN_D0
        CAL     LCD_RAMN
ND_BOTTOM:
        LD      $6,&H60
        PRE     IZ,N_BOTTOM
        CAL     LCD_PUTZ

; Native blinking insertion cursor follows the last entered digit.
        PRE     IX,IN_LEN
        LD      $0,(IX+$SX)
        LD      $6,&H43           ; row 3, immediately after "N: "
        AD      $6,$0
        CAL     SETCUR
        CAL     CUR_ON
        RTN

; ----------------------------- VTTEST ---------------------------------
VTTEST:
        CAL     VT_CLEAR
        LD      $18,1
VTT_LINE:
; Build exactly 32 bytes: two blanks, two-digit line number, blank, 27-byte pseudo-text.
        PRE     IX,LINE_BUF
        LD      $16,&H20
        STI     $16,(IX+$SX)
        STI     $16,(IX+$SX)
        LD      $14,$18
        SBC     $14,20
        JR      C,VTT_LT20
        LD      $16,&H32
        SB      $14,20
        JR      VTT_ONES
VTT_LT20:
        LD      $14,$18
        SBC     $14,10
        JR      C,VTT_LT10
        LD      $16,&H31
        SB      $14,10
        JR      VTT_ONES
VTT_LT10:
        LD      $16,&H30
        LD      $14,$18
VTT_ONES:
        STI     $16,(IX+$SX)
        LD      $16,$14
        AD      $16,&H30
        STI     $16,(IX+$SX)
        LD      $16,&H20
        STI     $16,(IX+$SX)
        PRE     IZ,LOREM27
        LD      $20,27
VTT_COPY:
        LDI     $16,(IZ+$SX)
        STI     $16,(IX+$SX)
        SB      $20,$SY
        JR      NZ,VTT_COPY

        PHS     $18
        LD      $8,$18
        LD      $9,1
        LDW     $10,LINE_BUF
        LD      $12,SRC_RAM
        LD      $13,32
        CAL     VT_WRITE
        PPS     $18
        AD      $18,$SY
        SBC     $18,25
        JP      C,VTT_LINE

        CAL     VT_VIEW
        SBC     $0,2
        JP      Z,CH11_BRK
        JP      TOP_MENU

; ----------------------------- strings --------------------------------
BLANK32:DB      "                                "
SPL0:   DB      "                                "
SPL1:   DB      "         Xandrian Labs          "
SPL2:   DB      "        CS617 Chapter 11        "
SPL3:   DB      "           Recursion            "

TOP1:   DB      "CS617 Chapter 11 - Recursion",0
TOP2:   DB      0
TOP_ACT:DB      "[queens][hanoi ][vttest][      ]"

NQ_TITLE:DB     "Queens - new N",0
NH_TITLE:DB     "Hanoi - new N",0
N_HELP: DB      "Enter N (1..10), then EXE",0
N_BAD:  DB      "Invalid N - use 1..10",0
N_PROMPT:DB     "N: ",0
N_BOTTOM:DB     "MENU=top   BRK=exit",0

LOREM27:DB      "Lorem ipsum dolor sit amet."