random.s
Original bytes preserved. This is a browser-readable view.
; ======================================================================
; CS617 CHAPTER 03 - RANDOM LAB - r006 POST-DELIVERY UI CANDIDATE
; PB-2000C / AI-1000 standalone language-card ROM
; Source-only r006 from accepted SHELL r005; do NOT recast historical
; delivery or claim a new machine acceptance before build and runtime gates.
; Product UI decision: sol/DECISION_RECORD_CH03_UI_r006_20261011.md
; Startup: TM-sampled auto-advance replaces startup EXE only. Error EXE stays.
;
; PURPOSE
; Final human-facing consumer of the accepted Chapter 03 numerical layer.
;
; FK1 SEED enter/reset unsigned 16-bit seed (0..65535)
; FK2 NEXT advance accepted LCG exactly once and display x
; FK3 N enter positive unsigned 16-bit sample count (1..65535)
; FK4 SIM reseed from configured SEED, generate exactly N values,
; and display mean + population sigma
;
; SIM CONTRACT
; SIM always starts from the configured SEED, independent of prior NEXTs.
; On completion, the LCG state is the final simulation state; a following
; NEXT continues from that point.
;
; NEW CODE IN THIS FILE
; keyboard/menu/display glue, decimal u16 entry, shell state, and the
; parameterized statistics driver STATS_RUN_CFG.
;
; ACCEPTED SURFACES ARE REUSED; NO NEW NUMERICAL PRIMITIVE IS INTRODUCED.
; ======================================================================
ORG 0
LEVEL 0
OFFCHK: EQU &H04EF
FK1: EQU &HFC
FK2: EQU &HFD
FK3: EQU &HFE
FK4: EQU &HFF
KEYBS: EQU &H08
KEYEXE: EQU &H0D
; ----------------------------------------------------------------------
; RAM workspace. These addresses follow the already accepted Chapter 03
; ROM-test convention: code executes from the language card while IX data
; accesses reach writable machine RAM.
; ----------------------------------------------------------------------
WS_STATE: EQU &H2000
WS_TMP: EQU &H2010
WS_DEN: EQU &H2020
WS_X: EQU &H2030
WS_SUM: EQU &H2040
WS_SUMSQ: EQU &H2050
WS_NFP: EQU &H2060
WS_MEAN: EQU &H2070
WS_M2: EQU &H2080
WS_VAR: EQU &H2090
WS_SIG: EQU &H20A0
WS_COUNT: EQU &H20B0
WS_NBIN: EQU &H20B2
WS_SEED: EQU &H20B4
WS_NCFG: EQU &H20B6
WS_HAVEX: EQU &H20B8
WS_HAVEST:EQU &H20B9
WS_SBUF: EQU &H20C0
WS_SLEN: EQU &H20C5
WS_NBUF: EQU &H20D0
WS_NLEN: EQU &H20D5
WS_NEW: EQU &H20D6
WS_FBUF: EQU &H20E0
WS_FLEN: EQU &H20F0
WS_CUR: EQU &H20F1
WS_TICK: EQU &H20F2
WS_EDIT: EQU &H20F3
; ----------------------------------------------------------------------
; Language-card header.
; ----------------------------------------------------------------------
DB &H43,&H4D
DB &HFF,&HFF,&HFF,&HFF
DB &H01,&H04,&H10,&H10
DB &HFF,&HFF,&HFF,&HFF
DB &HFF,&HFF,&HFF,&HFF
DB &HFF,&HFF,&HFF,&HFF
DB &HFF,&HFF,&HFF,&HFF
DB &HFF
DB &H03
DB &HC0
DB &HFF,&HFF,&HFF
; ======================================================================
; ACCEPTED DIRECT KEYBOARD SCANNER / KEYSCAN CONVENTION
; Reused from the Chapter 01/02 standalone PB-2000C line.
; ======================================================================
ORG &H0C60
INKEY:
CAL OFFCHK
LD $17,$31
LD $0,&H4B
IKEYLP:
PST IA,$0
GRE KY,$1
GRE KY,$1
DID $2
ANCW $1,$1
JR Z,IKEY40
SBC $0,&H41
JP Z,APP_START
IKEY10:
LD $3,$31
IKEY20:
BIDW $2
JR C,IKEY30
AD $3,$30,IKEY20
IKEY30:
LD $5,$0
SB $5,$30
BIU $5
BIU $5
LD $4,$5
BIU $4
BIU $4
SB $4,$5
PST UA,&H44
PRE IX,KEYSCAN
LDD $0,(IX+$4)
LDD $0,(IX+$3)
PST UA,&H54
JR IKEY50
IKEY40:
SB $0,$30
JR LNZ,IKEYLP
LD $0,$31
IKEY50:
AN $0,$0
JR Z,IKEYRET
LD $17,$30
IKEYRET:
RTN
; ----------------------------------------------------------------------
; Canonical standalone vector table.
; ----------------------------------------------------------------------
ORG &H0D80
JP MAIN
JP TRAP
JP &H01AA
JP &H01BC
JP TRAP
JP TRAP
JP TRAP
JP &H00E3
DEFRT: RTN
DB &HFF,&HFF
RTN
DB &HFF,&HFF
JP DEFRT
JP POFF
JP DEFRT
JP DEFRT
JP MAIN
JP DEFRT
JP DEFRT
JP DEFRT
JP DEFRT
DB &H11
DB &H10
TRAP: RTNI
POFF: OFF
OFF
OFF
JR POFF
; ----------------------------------------------------------------------
; BOOT-ROM key translation table.
; ----------------------------------------------------------------------
KEYSCAN:
DB 0,0,0,0,0,0,0,1,0,0,0,0
DB "W","Q","A",0,"Z",0,0,0,0,0,"'",7
DB "R","E","D","S","C","X",0,0,&HFC,0,&H29,&H28
DB "Y","T","G","F","B","V",0,0,&HFD,0,&H5D,&H5B
DB "I","U","J","H","M","N",0,0,&HFE,0,&H90,&H7C
DB "P","O","L","K",&H20,",",0,0,&HFF,0,&H93,&H94
DB 0,"=",":",";",0,0,0,0,&H95,0,0,&H9B
DB "5","4","2","1",0,"0",0,"7",0,0,0,0
DB "-","6","+","3",&H0D,".",0,"9",0,0,0,0
DB &H9D,&H1C,"/",&H08,0,0,0,"*",0,0,&H9C,&H11
DB &H1F,&H1D,&H0C,0,0,0,0,"8",0,0,&H1E,&H12
; ----------------------------------------------------------------------
; Bootstrap remains intentionally tiny. All shell/application code lives
; after the accepted numerical surface layout.
; ----------------------------------------------------------------------
ORG &H0E80
MAIN:
PRE SS,&H0100
LD $30,1
LD $31,0
PSR SZ,0
PSR SY,30
PSR SX,31
PST UA,&H14
JP APP_START
; ======================================================================
; ACCEPTED CHAPTER 03 NUMERICAL SURFACES
; Layout preserves the accepted Sprint 10 dependency map and adds the
; accepted PRESENT r002 BCD_TO_F32 donor at 1000.
; ======================================================================
ORG &H0F00
#INCLUDE (../lib/bcd_mod.inc)
#LIST
ORG &H0F40
#INCLUDE (../lib/bcd_div.inc)
#LIST
ORG &H0F60
#INCLUDE (../lib/bcd_mul.inc)
#LIST
ORG &H0F70
#INCLUDE (../lib/bcd_sub.inc)
#LIST
ORG &H0F80
#INCLUDE (../lib/bcd_from_u16.inc)
#LIST
ORG &H0FB0
#INCLUDE (../lib/bcd_add.inc)
#LIST
ORG &H0FD0
#INCLUDE (../lib/bcd_sqrt.inc)
#LIST
ORG &H1000
#INCLUDE (../lib/bcd_to_f32_r002.inc)
#LIST
; ======================================================================
; FINAL APPLICATION / GLUE
; ======================================================================
ORG &H1100
; ----------------------------------------------------------------------
; Native-FP workspace helpers.
; ----------------------------------------------------------------------
STORE_STATE:
PRE IX,WS_STATE
STIM $10,(IX+$SX),8
STI $18,(IX+$SX)
RTN
LOAD_STATE:
PRE IX,WS_STATE
LDIM $10,(IX+$SX),8
LDD $18,(IX+$SX)
RTN
STORE_TMP:
PRE IX,WS_TMP
STIM $10,(IX+$SX),8
STI $18,(IX+$SX)
RTN
LOAD_TMP:
PRE IX,WS_TMP
LDIM $10,(IX+$SX),8
LDD $18,(IX+$SX)
RTN
STORE_DEN:
PRE IX,WS_DEN
STIM $10,(IX+$SX),8
STI $18,(IX+$SX)
RTN
LOAD_DEN_B:
PRE IX,WS_DEN
LDIM $0,(IX+$SX),8
LDD $8,(IX+$SX)
RTN
STORE_X:
PRE IX,WS_X
STIM $10,(IX+$SX),8
STI $18,(IX+$SX)
RTN
LOAD_X:
PRE IX,WS_X
LDIM $10,(IX+$SX),8
LDD $18,(IX+$SX)
RTN
STORE_SUM:
PRE IX,WS_SUM
STIM $10,(IX+$SX),8
STI $18,(IX+$SX)
RTN
LOAD_SUM:
PRE IX,WS_SUM
LDIM $10,(IX+$SX),8
LDD $18,(IX+$SX)
RTN
STORE_SUMSQ:
PRE IX,WS_SUMSQ
STIM $10,(IX+$SX),8
STI $18,(IX+$SX)
RTN
LOAD_SUMSQ:
PRE IX,WS_SUMSQ
LDIM $10,(IX+$SX),8
LDD $18,(IX+$SX)
RTN
STORE_NFP:
PRE IX,WS_NFP
STIM $10,(IX+$SX),8
STI $18,(IX+$SX)
RTN
LOAD_NFP_B:
PRE IX,WS_NFP
LDIM $0,(IX+$SX),8
LDD $8,(IX+$SX)
RTN
STORE_MEAN:
PRE IX,WS_MEAN
STIM $10,(IX+$SX),8
STI $18,(IX+$SX)
RTN
LOAD_MEAN:
PRE IX,WS_MEAN
LDIM $10,(IX+$SX),8
LDD $18,(IX+$SX)
RTN
STORE_M2:
PRE IX,WS_M2
STIM $10,(IX+$SX),8
STI $18,(IX+$SX)
RTN
LOAD_M2:
PRE IX,WS_M2
LDIM $10,(IX+$SX),8
LDD $18,(IX+$SX)
RTN
STORE_VAR:
PRE IX,WS_VAR
STIM $10,(IX+$SX),8
STI $18,(IX+$SX)
RTN
LOAD_VAR:
PRE IX,WS_VAR
LDIM $10,(IX+$SX),8
LDD $18,(IX+$SX)
RTN
STORE_SIG:
PRE IX,WS_SIG
STIM $10,(IX+$SX),8
STI $18,(IX+$SX)
RTN
LOAD_SIG:
PRE IX,WS_SIG
LDIM $10,(IX+$SX),8
LDD $18,(IX+$SX)
RTN
; ----------------------------------------------------------------------
; Accepted LCG glue, unchanged in substance from Sprint 09.
; ----------------------------------------------------------------------
LCG_SEED_U16:
CAL BCD_FROM_U16
JP STORE_STATE
LCG_NEXT:
LDW $15,&H6255
CAL BCD_FROM_U16
LDM $0,$10,8
LD $8,$18
CAL LOAD_STATE
CAL BCD_MUL
CAL STORE_TMP
LDW $15,&H3619
CAL BCD_FROM_U16
LDM $0,$10,8
LD $8,$18
CAL LOAD_TMP
CAL BCD_ADD
CAL STORE_TMP
LDW $15,&H8000
CAL BCD_FROM_U16
LDM $0,$10,8
LD $8,$18
CAL BCD_ADD
CAL STORE_DEN
CAL LOAD_DEN_B
CAL LOAD_TMP
CAL BCD_MOD
CAL STORE_STATE
CAL LOAD_DEN_B
CAL LOAD_STATE
CAL BCD_DIV
RTN
; ----------------------------------------------------------------------
; STATS_RUN_CFG
;
; Input $24,$25 = positive N.
; SIM policy: reseed from WS_SEED, generate exactly N values, and leave the
; final LCG state in WS_STATE. Arithmetic/statistics body is the accepted
; Sprint 10 algorithm; only seed sourcing is shell policy.
; ----------------------------------------------------------------------
STATS_RUN_CFG:
PRE IX,WS_NBIN
STM $24,(IX+$SX),2
PRE IX,WS_COUNT
STM $24,(IX+$SX),2
PRE IX,WS_SEED
LDM $15,(IX+$SX),2
CAL LCG_SEED_U16
XRM $10,$10,8
CAL STORE_SUM
CAL STORE_SUMSQ
ST_LOOP:
PRE IX,WS_COUNT
LDM $24,(IX+$SX),2
ANCW $24,$24
JP Z,ST_FINISH
CAL LCG_NEXT
CAL STORE_X
LDM $0,$10,8
LD $8,$18
CAL LOAD_SUM
CAL BCD_ADD
CAL STORE_SUM
CAL LOAD_X
LDM $0,$10,8
LD $8,$18
CAL BCD_MUL
CAL STORE_TMP
LDM $0,$10,8
LD $8,$18
CAL LOAD_SUMSQ
CAL BCD_ADD
CAL STORE_SUMSQ
PRE IX,WS_COUNT
LDM $24,(IX+$SX),2
SBW $24,$SY
STM $24,(IX+$SX),2
JP ST_LOOP
ST_FINISH:
PRE IX,WS_NBIN
LDM $15,(IX+$SX),2
CAL BCD_FROM_U16
CAL STORE_NFP
CAL LOAD_NFP_B
CAL LOAD_SUM
CAL BCD_DIV
CAL STORE_MEAN
CAL LOAD_NFP_B
CAL LOAD_SUMSQ
CAL BCD_DIV
CAL STORE_M2
CAL LOAD_MEAN
LDM $0,$10,8
LD $8,$18
CAL BCD_MUL
CAL STORE_TMP
LDM $0,$10,8
LD $8,$18
CAL LOAD_M2
CAL BCD_SUB
CAL STORE_VAR
CAL BCD_SQRT
CAL STORE_SIG
RTN
; ----------------------------------------------------------------------
; Accepted PRESENT r002 formatter glue for nonnegative 0 <= x < 1.
; ----------------------------------------------------------------------
FMT_UNIT_FP:
CAL BCD_TO_F32
LD $20,$15
LD $21,$16
LD $22,$17
LD $23,$18
PRE IX,WS_FBUF
LD $13,0
LD $16,"0"
CAL FPUT
LD $16,"."
CAL FPUT
AN $23,$23
JR NZ,FMT_NONZERO
LD $14,6
FMT_ZLOOP:
LD $16,"0"
CAL FPUT
SB $14,$SY
JR NZ,FMT_ZLOOP
JR FMT_DONE
FMT_NONZERO:
LD $14,$23
AN $14,&H3F
SB $14,$SY
FMT_LEAD:
AN $14,$14
JR Z,FMT_DIGITS
LD $16,"0"
CAL FPUT
SB $14,$SY
JR FMT_LEAD
FMT_DIGITS:
LD $12,$22
CAL FPAIR
LD $12,$21
CAL FPAIR
LD $12,$20
CAL FPAIR
FMT_DONE:
PRE IX,WS_FLEN
ST $13,(IX+$SX)
RTN
FPUT:
STI $16,(IX+$SX)
AD $13,$SY
RTN
FPAIR:
LD $16,$12
DID $16
AN $16,&H0F
AD $16,&H30
CAL FPUT
LD $16,$12
AN $16,&H0F
AD $16,&H30
CAL FPUT
RTN
; ======================================================================
; SHELL STATE AND DECIMAL INPUT
; ======================================================================
INIT_CFG:
; Default seed = 1, N = 100.
PRE IX,WS_SEED
LDW $15,1
STW $15,(IX+$SX)
PRE IX,WS_NCFG
LDW $15,100
STW $15,(IX+$SX)
PRE IX,WS_SBUF
LD $0,"1"
ST $0,(IX+$SX)
PRE IX,WS_SLEN
LD $0,1
ST $0,(IX+$SX)
PRE IX,WS_NBUF
LD $0,"1"
ST $0,(IX+$SX)
LD $0,"0"
ST $0,(IX+$SY)
LD $13,2
ST $0,(IX+$13)
PRE IX,WS_NLEN
LD $0,3
ST $0,(IX+$SX)
PRE IX,WS_HAVEX
LD $0,0
ST $0,(IX+$SX)
PRE IX,WS_HAVEST
ST $0,(IX+$SX)
LDW $15,1
CAL LCG_SEED_U16
RTN
; Parse 0..5 ASCII digits at IX into unsigned word $15,$16.
; $13 = length. $4=0 success, $4=1 invalid/overflow.
PARSE_U16:
AN $13,$13
JR Z,PU_BAD
SBW $15,$15
LD $12,0
PU_LOOP:
SBC $12,$13
JR NC,PU_OK
LD $5,(IX+$12)
SB $5,&H30
; value *= 10 using word additions, checking carry at every step.
LDW $20,$15
ADW $15,$15
JR C,PU_BAD
ADW $15,$15
JR C,PU_BAD
ADW $15,$15
JR C,PU_BAD
ADW $15,$20
JR C,PU_BAD
ADW $15,$20
JR C,PU_BAD
LD $6,0
ADW $15,$5
JR C,PU_BAD
AD $12,$SY
JR PU_LOOP
PU_OK:
LD $4,0
RTN
PU_BAD:
LD $4,1
RTN
; ----------------------------------------------------------------------
; Main menu dispatch.
; ----------------------------------------------------------------------
MENU_LOOP:
CAL DRAW_MAIN
MN_WAIT:
CAL INKEY
PST UA,&H14
AN $17,$17
JR Z,MN_WAIT
LD $12,$0
SBC $12,FK1
JR Z,MN_SEED
SBC $12,FK2
JR Z,MN_NEXT
SBC $12,FK3
JR Z,MN_N
SBC $12,FK4
JR Z,MN_SIM
CAL WAIT_RELEASE
JR MN_WAIT
MN_SEED:
CAL WAIT_RELEASE
CAL EDIT_SEED
JP MENU_LOOP
MN_N:
CAL WAIT_RELEASE
CAL EDIT_N
JP MENU_LOOP
MN_NEXT:
CAL WAIT_RELEASE
CAL LCG_NEXT
CAL STORE_X
PRE IX,WS_HAVEX
LD $0,1
ST $0,(IX+$SX)
PRE IX,WS_HAVEST
LD $0,0
ST $0,(IX+$SX)
JP MENU_LOOP
MN_SIM:
CAL WAIT_RELEASE
CAL DRAW_BUSY
PRE IX,WS_NCFG
LDM $24,(IX+$SX),2
CAL STATS_RUN_CFG
PRE IX,WS_HAVEST
LD $0,1
ST $0,(IX+$SX)
PRE IX,WS_HAVEX
LD $0,0
ST $0,(IX+$SX)
JP MENU_LOOP
; ----------------------------------------------------------------------
; SEED editor. First digit/BS starts a replacement; EXE with no edit keeps
; the old value. Invalid values stay in the editor after a concise error.
; ----------------------------------------------------------------------
EDIT_SEED:
PRE IX,WS_EDIT
LD $0,0
ST $0,(IX+$SX)
PRE IX,WS_NEW
LD $0,1
ST $0,(IX+$SX)
CAL RESET_BLINK
CAL DRAW_SEED
CAL DRAW_ECUR
ES_WAIT:
CAL INKEY
PST UA,&H14
AN $17,$17
JR NZ,ES_READY
CAL BLINK_TICK
JR ES_WAIT
ES_READY:
LD $12,$0
CAL RESET_BLINK
SBC $12,&H30
JR C,ES_OTHER
SBC $12,&H3A
JR NC,ES_OTHER
CAL S_DIGIT
CAL WAIT_RELEASE
CAL DRAW_EFIELD
CAL DRAW_ECUR
JR ES_WAIT
ES_OTHER:
SBC $12,KEYBS
JR Z,ES_BS
SBC $12,KEYEXE
JR Z,ES_EXE
CAL WAIT_RELEASE
CAL DRAW_ECUR
JR ES_WAIT
ES_BS:
CAL S_BACKSP
CAL WAIT_RELEASE
CAL DRAW_EFIELD
CAL DRAW_ECUR
JR ES_WAIT
ES_EXE:
CAL WAIT_RELEASE
PRE IX,WS_NEW
LD $0,(IX+$SX)
AN $0,$0
RTN NZ
PRE IX,WS_SLEN
LD $13,(IX+$SX)
PRE IX,WS_SBUF
CAL PARSE_U16
AN $4,$4
JR NZ,ES_BAD
PRE IX,WS_SEED
STW $15,(IX+$SX)
CAL LCG_SEED_U16
PRE IX,WS_HAVEX
LD $0,0
ST $0,(IX+$SX)
PRE IX,WS_HAVEST
ST $0,(IX+$SX)
RTN
ES_BAD:
CAL ERR_SEED
CAL RESET_BLINK
CAL DRAW_SEED
CAL DRAW_ECUR
JP ES_WAIT
S_DIGIT:
PRE IX,WS_NEW
LD $0,(IX+$SX)
AN $0,$0
JR Z,SD_ACTIVE
LD $0,0
ST $0,(IX+$SX)
PRE IX,WS_SLEN
ST $0,(IX+$SX)
SD_ACTIVE:
PRE IX,WS_SLEN
LD $13,(IX+$SX)
SBC $13,5
RTN NC
PRE IX,WS_SBUF
ST $12,(IX+$13)
AD $13,$SY
PRE IX,WS_SLEN
ST $13,(IX+$SX)
RTN
S_BACKSP:
PRE IX,WS_NEW
LD $0,(IX+$SX)
AN $0,$0
JR Z,SB_ACTIVE
LD $0,0
ST $0,(IX+$SX)
PRE IX,WS_SLEN
ST $0,(IX+$SX)
RTN
SB_ACTIVE:
PRE IX,WS_SLEN
LD $13,(IX+$SX)
AN $13,$13
RTN Z
SB $13,$SY
ST $13,(IX+$SX)
RTN
; ----------------------------------------------------------------------
; N editor. N=0 is rejected after successful u16 parsing.
; ----------------------------------------------------------------------
EDIT_N:
PRE IX,WS_EDIT
LD $0,1
ST $0,(IX+$SX)
PRE IX,WS_NEW
LD $0,1
ST $0,(IX+$SX)
CAL RESET_BLINK
CAL DRAW_N
CAL DRAW_ECUR
EN_WAIT:
CAL INKEY
PST UA,&H14
AN $17,$17
JR NZ,EN_READY
CAL BLINK_TICK
JR EN_WAIT
EN_READY:
LD $12,$0
CAL RESET_BLINK
SBC $12,&H30
JR C,EN_OTHER
SBC $12,&H3A
JR NC,EN_OTHER
CAL N_DIGIT
CAL WAIT_RELEASE
CAL DRAW_EFIELD
CAL DRAW_ECUR
JR EN_WAIT
EN_OTHER:
SBC $12,KEYBS
JR Z,EN_BS
SBC $12,KEYEXE
JR Z,EN_EXE
CAL WAIT_RELEASE
CAL DRAW_ECUR
JR EN_WAIT
EN_BS:
CAL N_BACKSP
CAL WAIT_RELEASE
CAL DRAW_EFIELD
CAL DRAW_ECUR
JR EN_WAIT
EN_EXE:
CAL WAIT_RELEASE
PRE IX,WS_NEW
LD $0,(IX+$SX)
AN $0,$0
RTN NZ
PRE IX,WS_NLEN
LD $13,(IX+$SX)
PRE IX,WS_NBUF
CAL PARSE_U16
AN $4,$4
JR NZ,EN_BAD
ANCW $15,$15
JR Z,EN_BAD
PRE IX,WS_NCFG
STW $15,(IX+$SX)
PRE IX,WS_HAVEST
LD $0,0
ST $0,(IX+$SX)
RTN
EN_BAD:
CAL ERR_N
CAL RESET_BLINK
CAL DRAW_N
CAL DRAW_ECUR
JP EN_WAIT
N_DIGIT:
PRE IX,WS_NEW
LD $0,(IX+$SX)
AN $0,$0
JR Z,ND_ACTIVE
LD $0,0
ST $0,(IX+$SX)
PRE IX,WS_NLEN
ST $0,(IX+$SX)
ND_ACTIVE:
PRE IX,WS_NLEN
LD $13,(IX+$SX)
SBC $13,5
RTN NC
PRE IX,WS_NBUF
ST $12,(IX+$13)
AD $13,$SY
PRE IX,WS_NLEN
ST $13,(IX+$SX)
RTN
N_BACKSP:
PRE IX,WS_NEW
LD $0,(IX+$SX)
AN $0,$0
JR Z,NB_ACTIVE
LD $0,0
ST $0,(IX+$SX)
PRE IX,WS_NLEN
ST $0,(IX+$SX)
RTN
NB_ACTIVE:
PRE IX,WS_NLEN
LD $13,(IX+$SX)
AN $13,$13
RTN Z
SB $13,$SY
ST $13,(IX+$SX)
RTN
; ----------------------------------------------------------------------
; Field-only editor redraw.
; Rewrites row 1 VALUE: + the active buffer and blanks the remaining field
; cells. This avoids clearing/repainting the whole 32x4 screen per key.
; ----------------------------------------------------------------------
DRAW_EFIELD:
LD $6,&H20
PRE IZ,TXT_VALUE
CAL PRINTZ
PRE IX,WS_EDIT
LD $9,(IX+$SX)
AN $9,$9
JR NZ,DEF_N
PRE IX,WS_SLEN
LD $13,(IX+$SX)
PRE IX,WS_SBUF
JR DEF_PRINT
DEF_N:
PRE IX,WS_NLEN
LD $13,(IX+$SX)
PRE IX,WS_NBUF
DEF_PRINT:
CAL PRINT_BUF
; Blank from current length through five digits plus the cursor cell.
LD $14,6
SB $14,$13
DEF_BLANK:
AN $14,$14
RTN Z
LD $16,&H20
CAL PUTC
SB $14,$SY
JR DEF_BLANK
; ----------------------------------------------------------------------
; Accepted small blinking '_' editor convention.
; WS_NEW=1: cursor starts at position 0 and typing replaces current value.
; WS_NEW=0: cursor follows the active replacement text.
; ----------------------------------------------------------------------
RESET_BLINK:
PRE IX,WS_CUR
LD $0,1
ST $0,(IX+$SX)
PRE IX,WS_TICK
LD $0,0
ST $0,(IX+$SX)
RTN
BLINK_TICK:
PRE IX,WS_TICK
LD $0,(IX+$SX)
AD $0,$SY
SBC $0,128
JR Z,BT_TOGGLE
ST $0,(IX+$SX)
RTN
BT_TOGGLE:
LD $0,0
ST $0,(IX+$SX)
PRE IX,WS_CUR
LD $1,(IX+$SX)
AN $1,$1
JR Z,BT_ON
LD $1,0
ST $1,(IX+$SX)
JP DRAW_ECUR
BT_ON:
LD $1,1
ST $1,(IX+$SX)
JP DRAW_ECUR
DRAW_ECUR:
; Cursor position: 0 before replacement begins, otherwise at current length.
PRE IX,WS_NEW
LD $9,(IX+$SX)
AN $9,$9
JR Z,DEC_ACTIVE
LD $10,0
JR DEC_POS
DEC_ACTIVE:
PRE IX,WS_EDIT
LD $9,(IX+$SX)
AN $9,$9
JR NZ,DEC_NPOS
PRE IX,WS_SLEN
LD $10,(IX+$SX)
JR DEC_POS
DEC_NPOS:
PRE IX,WS_NLEN
LD $10,(IX+$SX)
DEC_POS:
; Both edit screens put VALUE: at row 1, columns 0..6.
LD $6,&H27
AD $6,$10
PRE IX,WS_CUR
LD $8,(IX+$SX)
PRE IX,WS_EDIT
LD $9,(IX+$SX)
AN $9,$9
JR NZ,DEC_N
PRE IX,WS_SLEN
LD $11,(IX+$SX)
PRE IX,WS_SBUF
JR DEC_CHAR
DEC_N:
PRE IX,WS_NLEN
LD $11,(IX+$SX)
PRE IX,WS_NBUF
DEC_CHAR:
AN $8,$8
JR Z,DEC_OFF
LD $16,&H5F
JP PUTC
DEC_OFF:
SBC $10,$11
JR NC,DEC_SPACE
LD $16,(IX+$10)
JP PUTC
DEC_SPACE:
LD $16,&H20
JP PUTC
; ======================================================================
; DISPLAY
; ======================================================================
APP_START:
CAL SCREEN_INIT
CAL INIT_CFG
CAL SHOW_SPLASH
CAL WAIT_SPLASH_R006
JP MENU_LOOP
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
CAL &H0304
CAL &H0306
RTN
CLEAR_ALL:
LD $6,$SX
LD $8,128
CAL &H018D
RTN
SHOW_SPLASH:
CAL CLEAR_ALL
LD $6,$SX
PRE IZ,TXT_SPL0
CAL PRINTZ
LD $6,&H20
PRE IZ,TXT_SPL1
CAL PRINTZ
LD $6,&H40
PRE IZ,TXT_SPL2
CAL PRINTZ
LD $6,&H60
PRE IZ,TXT_SPL3
CAL PRINTZ
RTN
; Post-delivery UI readiness r006, not part of the original r005 WHAT:
; auto-advance the STARTUP splash after three stabilized TM transitions.
; Reuses the accepted Chapter 01/02 family pattern. We call OFFCHK directly
; because the accepted Chapter 03 INKEY/SCREEN_INIT already use this firmware
; convention; do not copy Chapter 02's different bank-bridge semantics.
; No EXE is consumed here. The original WAIT_EXE still serves ERR_SEED/ERR_N.
; This change is deliberately limited to the APP_START splash lifecycle.
WAIT_SPLASH_R006:
CAL SAMPLE_TM_R006
LD $22,$8
LD $23,0
R6_WSP_LOOP:
CAL OFFCHK
CAL SAMPLE_TM_R006
SBC $8,$22
JR Z,R6_WSP_LOOP
LD $22,$8
AD $23,$SY
SBC $23,3
JR NZ,R6_WSP_LOOP
RTN
; Avoid torn TM reads: require two consecutive equal samples.
SAMPLE_TM_R006:
GST TM,$8
R6_STM_AGAIN:
LD $9,$8
GST TM,$8
SBC $8,$9
JR NZ,R6_STM_AGAIN
LD $9,0
RTN
DRAW_MAIN:
CAL CLEAR_ALL
; Row 0: configured seed and N.
LD $6,$SX
PRE IZ,TXT_SEED
CAL PRINTZ
PRE IX,WS_SLEN
LD $13,(IX+$SX)
PRE IX,WS_SBUF
CAL PRINT_BUF
PRE IZ,TXT_NSEP
CAL PRINTZ
PRE IX,WS_NLEN
LD $13,(IX+$SX)
PRE IX,WS_NBUF
CAL PRINT_BUF
; After SIM, devote one full row to each statistic.
PRE IX,WS_HAVEST
LD $0,(IX+$SX)
AN $0,$0
JR Z,DM_NEXTMODE
LD $6,&H20
PRE IZ,TXT_MEAN
CAL PRINTZ
CAL LOAD_MEAN
CAL FMT_UNIT_FP
CAL PRINT_FBUF
LD $6,&H40
PRE IZ,TXT_SDEV
CAL PRINTZ
CAL LOAD_SIG
CAL FMT_UNIT_FP
CAL PRINT_FBUF
JR DM_KEYS
; Otherwise show the most recent explicit NEXT value; row 2 remains quiet.
DM_NEXTMODE:
LD $6,&H20
PRE IZ,TXT_X
CAL PRINTZ
PRE IX,WS_HAVEX
LD $0,(IX+$SX)
AN $0,$0
JR Z,DM_NOX
CAL LOAD_X
CAL FMT_UNIT_FP
CAL PRINT_FBUF
JR DM_KEYS
DM_NOX:
PRE IZ,TXT_DASH
CAL PRINTZ
DM_KEYS:
LD $6,&H60
PRE IZ,TXT_KEYS
CAL PRINTZ
RTN
DRAW_BUSY:
CAL CLEAR_ALL
LD $6,$SX
PRE IZ,TXT_SIM
CAL PRINTZ
LD $6,&H20
PRE IZ,TXT_SEED
CAL PRINTZ
PRE IX,WS_SLEN
LD $13,(IX+$SX)
PRE IX,WS_SBUF
CAL PRINT_BUF
PRE IZ,TXT_NSEP
CAL PRINTZ
PRE IX,WS_NLEN
LD $13,(IX+$SX)
PRE IX,WS_NBUF
CAL PRINT_BUF
LD $6,&H40
PRE IZ,TXT_WORK
CAL PRINTZ
RTN
DRAW_SEED:
CAL CLEAR_ALL
LD $6,$SX
PRE IZ,TXT_SETSEED
CAL PRINTZ
LD $6,&H20
PRE IZ,TXT_VALUE
CAL PRINTZ
PRE IX,WS_SLEN
LD $13,(IX+$SX)
PRE IX,WS_SBUF
CAL PRINT_BUF
LD $6,&H40
PRE IZ,TXT_REPLACE
CAL PRINTZ
LD $6,&H60
PRE IZ,TXT_EDIT
CAL PRINTZ
RTN
DRAW_N:
CAL CLEAR_ALL
LD $6,$SX
PRE IZ,TXT_SETN
CAL PRINTZ
LD $6,&H20
PRE IZ,TXT_VALUE
CAL PRINTZ
PRE IX,WS_NLEN
LD $13,(IX+$SX)
PRE IX,WS_NBUF
CAL PRINT_BUF
LD $6,&H40
PRE IZ,TXT_REPLACE
CAL PRINTZ
LD $6,&H60
PRE IZ,TXT_EDIT
CAL PRINTZ
RTN
ERR_SEED:
CAL CLEAR_ALL
LD $6,$SX
PRE IZ,TXT_BADSEED
CAL PRINTZ
LD $6,&H20
PRE IZ,TXT_SEEDRNG
CAL PRINTZ
LD $6,&H60
PRE IZ,TXT_EXE
CAL PRINTZ
JP WAIT_EXE
ERR_N:
CAL CLEAR_ALL
LD $6,$SX
PRE IZ,TXT_BADN
CAL PRINTZ
LD $6,&H20
PRE IZ,TXT_NRNG
CAL PRINTZ
LD $6,&H60
PRE IZ,TXT_EXE
CAL PRINTZ
JP WAIT_EXE
PRINT_FBUF:
PRE IX,WS_FLEN
LD $13,(IX+$SX)
PRE IX,WS_FBUF
JP PRINT_BUF
; IX -> RAM text, $13 = length.
PRINT_BUF:
LD $12,0
PB_LOOP:
SBC $12,$13
RTN NC
LD $16,(IX+$12)
CAL PUTC
AD $12,$SY
JR PB_LOOP
PUTC:
LD $7,$16
LD $0,$7
DIU $7
DID $0
OR $7,$SZ
CAL &H0197
RTN
PRINTZ:
LDI $7,(IZ+$SX)
LD $0,$7
DIU $7
DID $0
OR $7,$SZ
RTN Z
CAL &H0197
JR PRINTZ
WAIT_RELEASE:
WR_LOOP:
CAL INKEY
PST UA,&H14
AN $17,$17
JR NZ,WR_LOOP
RTN
WAIT_EXE:
WE_WAIT:
CAL INKEY
PST UA,&H14
AN $17,$17
JR Z,WE_WAIT
SBC $0,KEYEXE
JR Z,WE_REL
WE_IGN:
CAL INKEY
PST UA,&H14
AN $17,$17
JR NZ,WE_IGN
JR WE_WAIT
WE_REL:
CAL INKEY
PST UA,&H14
AN $17,$17
JR NZ,WE_REL
RTN
; ----------------------------------------------------------------------
; ROM strings.
; ----------------------------------------------------------------------
TXT_SPL0:
DB " Xandrian Labs ",0
TXT_SPL1:
DB " CS617 - Chapter 03 ",0
TXT_SPL2:
DB " Random Lab ",0
TXT_SPL3:
DB " r006 ",0
TXT_SEED:
DB "SEED=",0
TXT_NSEP:
DB " N=",0
TXT_N:
DB "N=",0
TXT_X:
DB "X=",0
TXT_MEAN:
DB "MEAN=",0
TXT_SDEV:
DB "SDEV=",0
TXT_DASH:
DB "--",0
TXT_KEYS:
DB "[seed ][next ][n ][sim ]",0
TXT_SIM:
DB "Simulation",0
TXT_WORK:
DB "Working...",0
TXT_SETSEED:
DB "Set seed 0..65535",0
TXT_SETN:
DB "Set N 1..65535",0
TXT_VALUE:
DB "Value: ",0
TXT_REPLACE:
DB "Typing replaces current value",0
TXT_EDIT:
DB "0-9 type BS erase EXE save",0
TXT_BADSEED:
DB "Invalid seed",0
TXT_SEEDRNG:
DB "Use 0..65535",0
TXT_BADN:
DB "Invalid N",0
TXT_NRNG:
DB "Use 1..65535",0
TXT_EXE:
DB "Press EXE",0
ORG &HFFFF
DB 0