Model 100 System Map Part 2 (0DAB-290F)
From Bitchin100 DocGarden
Revision as of 13:00, 14 April 2009 by Jhoger
This is a derived work of the "Model 100 System Map", Copyright (C) 1985, Robert D. Covington, Systems Information Management Consultants.
0DABH - Main Evaluation Routine. This routine handles all evaluations of math operations and functions. Entry: HL - Points to text to evaluate plus 1. This routine assumes that an RST 10H was executed prior to entering the routine. To adjust for this, either execute a RST 10H or INC HL prior to entering the routine. Exit: HL - Incremented past evaluated expression FAC1 - Usually contains the result of the evaluated expression. 0F0DH - Integer Divide (FAC1=DE/HL) 0F1CH - Evaluate the function in the buffer pointed to by HL. Entry: HL - Points to the buffer containing the compressed function and parameters. Exit: FAC1 - Usually contains the result of the function. 0F47H - ERR Function 0F56H - ERL Function 0F7EH - VARPTR Function 0F86H - VARPTR(#buffer) Function 0F92H - VARPTR(variable) Function 0FDAH - Variable evaluation routine 0FE8H - Get the character pointed to by HL, convert it to upper case if needed, and place it in the A register. Entry: HL - Points to buffer Exit: A - Next character in buffer 0FE9H - Convert the character in the A register to uppercase if necessary. Entry: A - Character Exit: A - Character converted to UC 1054H - NOT Function 1069H - RST 28H routine (see 28H). 108CH - OR Function 1097H - AND Function 10A2H - XOR Function 10ADH - EQV Function 10B5H - IMP Function 10C8H - LPOS Function 10CEH - POS Function 10D1H - Load the integer in the A register into FAC1. Entry: A - Integer from 0-255 to put in FAC1 Exit: A - Destroyed 10E6H - Check for a running program. If a program is not running, generate an Illegal Direct (ID) error. Exit: A - Destroyed Z flag - Reset if program is running 10EFH - Generate ID error 1100H - INP Function 110CH - OUT Statement 1112H - Evaluate the expression in the buffer pointed to by HL leaving the result in DE. If the result is greater than 32767, an overflow error is generated. Entry: HL - Points to buffer of expression to evaluate. The buffer must end with a null or colon. Exit: DE - Result of expression HL - Incremented past expression in buffer A - Destroyed Z flag - Set if the evaluated expression is an 8 bit number. If so, the result of the operation will be just in the E register. 1113H - Same as 1112H except that the evalutation starts at HL-1. 112DH - Evaluate the expression in the buffer pointed to by HL leaving the result in the A register. If the result is greater than 255, a function error is generated. If the result is greater than 32767, an overflow error is generated. Entry: HL - Points to buffer to be evaluated. The buffer must end with a null or colon. Exit: HL - Incremented past expression in buffer A & E - Evaluated expression D - Destroyed 112EH - Same as 112DH except that evaluation starts at HL-1. 113BH - LLIST Statement 1140H - LIST Statement 11A2H - Send the buffer pointed to by HL to the screen. Text must end with a null. Entry: HL - Points to print buffer Exit: HL - Points to ending null A = 0 1284H - PEEK Function 128BH - POKE Function 1297H - Evaluate the expression in the buffer pointed to by HL leaving the result in DE. This routine differs from 1112H in that it will properly evaluate numbers up to 65535. If the result of the operation is greater than 65535, an overflow error will occur. Entry: HL - Points to buffer to evaluate. The buffer must end with a null or colon. Exit: DE - Evaluated expression HL - Incremented past expression in buffer. 12CBH - Wait for a key from the keyboard. All function keys are converted into their pre-programmed text. Exit: A - Character entered C flag - Set if special character 13A5H - Toggle function key label line if enabled. Exit: A - Destroyed 13DBH - Check keyboard queue for pending characters Exit: A - Destroyed Z flag - Set if no characters pending 1419H - POWER Statement 1431H - Normal TRAP (low power) interrupt routine 143FH - Turn off computer 1459H - POWER CONT Statement 1461H - POWER ON Statement 1470H - Output character to printer without tab expansions Entry: A - Character to print 148AH - Start tape and load tape header. If an error or Shift Break is pressed, generate an I/O error. 1494H - Generate I/O error 14A8H - Turn cassette motor on 14AAH - Turn cassette motor off 14B0H - Read a byte from tape and update checksum Entry: C - Current checksum Exit: A - Character read off tape C - Updated checksum 14C1H - Write a byte to tape and update checksum Entry: A - Character to write to tape C - Current checksum Exit: C - Updated checksum 14D2H - LCD Device control block 14D8H - LCD and LPT file open routine 14E5H - LCD file output routine 14EDH - Pop all registers off stack in the order AF, BC, DE, and HL. This routine is only useful if jumped to. If a call is done, stack integrity is lost. 14F2H - CRT device control block 14FCH - RAM device control block 1506H - RAM file open routine 158DH - RAM file close routine 15ACH - RAM file output routine 15C4H - RAM file input routine 161BH - Special RAM file I/O 167FH - CAS device control block 1689H - CAS file open routine 16ADH - CAS file close routine 16C7H - CAS file output routine 16D2H - CAS file input routine 1754H - LPT device control block 175AH - LPT file output routine 1762H - COM device control block 176CH - MDM file open routine 176DH - COM file open routine 179EH - COM file close routine 17A8H - COM and MDM file output routine 17B0H - COM and MDM file input routine 17CAH - Special COM and MDM I/O routine 17D1H - MDM device control block 17D8H - MDM file close routine 17E6H - Set RS232 parameters to string pointed to by HL. String must be in the same format as used by TELCOM. Entry: HL - Points to parameter string D - 2 if Modem is used C flag - Set if RS232, reset of Modem 1877H - WAND device control block 1889H - EOF Function 1904H - TIME$ Function 190FH - Read time from system clock and store it in the buffer pointed to by HL Entry: HL - Points to start of time buffer. The buffer will be filled with the time in the format hh:mm:ss. Exit: HL - Incremented to the end of the buffer. All other registers destroyed 1924H - DATE$ function 192FH - Read date and store it in the buffer pointed to by HL. Entry: HL - Points to start of date buffer. The buffer will be filled with the date in the format mm/dd/yy. Exit: HL - Incremented to the end of the buffer All other registers destroyed 1955H - DAY$ function 1962H - Read day and store it in the buffer pointed to by HL. Entry: HL - Points to start of day buffer. The buffer will be filled with the current 3 letter day abbreviation. Exit: HL - Incremented to the end of the buffer All other registers destroyed. 19A0H - Update the in memory clock values starting at F923H with the time in the internal hardware clock 19ABH - TIME$ Statement 19B3H - Update the internal clock chip with the values in the in memory time table starting at F923H 19BDH - DATE$ Statement 19F1H - DAY$ Statement 1A78H - IPL Statement 1A96H - Erase current IPL program (table) Exit: A - Destroyed 1A9EH - COM and MDM Statements 1AB2H - KEY() Statement 1AC3H - KEY STOP/ON/OFF Statements 1B0FH - ON TIME$ Statement 1B32H - RST 7.5 interrupt routine (see 3CH). 1BB8H - KEY Statement 1BBDH - KEY LIST Statement 1BE0H - Send B number of characters from the buffer pointed to by HL to the screen. Any control characters (0-31 and 127) are converted to spaces for printing. Entry: HL - Points to buffer to print B - Number of characters to print Exit: A - Destroyed HL - Incremented past last byte printed. 1C57H - PSET Statement 1C66H - PRESET Statement 1C6DH - LINE (graphic) Statement 1D90H - CSRLIN Function 1D9BH - MAX Function 1DA7H - MAXRAM Function 1DB2H - MAXFILES Functions 1DB9H - HIMEM Function 1DC3H - WIDTH Statement 1DC5H - SOUND Statement 1DE5H - SOUND OFF Statement 1DE6H - SOUNF ON Statement 1DECH - MOTOR Statement 1DF1H - MOTOR ON Statement 1DF5H - MOTOR OFF Statement 1DFAH - CALL Statement 1E22H - SCREEN Statement 1E5EH - LCOPY Statement. This routine will print the textual contents of the screen on the printer.. Exit: HL, DE, and AF are destroyed. 1F3AH - FILES Statement 1F42H - Display Catalog Exit: All registers are destroyed 1F91H - KILL Statement 1FBFH - KILASC: Kill a text file Entry: (result of SRCNAM call, normally) HL - Address of directory entry DE - Start address of file 1FD9H - Kill a CO file Entry: (result of SRCNAM call, normally) HL - Address of directory entry DE - Start address of file 2017H - Kill a BASIC binary program file Entry: (result of SRCNAM call, normally) HL - Address of directory entry DE - Start address of file 2037H - NAME Statement 20AFH - SRCNAM - Find File This routine finds a file, if it exists, in the RAM file directory. Entry: FILNAM ($FC93..$FC9A) holds 9 character filename to lookup Exit: Not found: Zero flag set Found: Zero flag clear, A - File type flag for found entry DE - Address where file with matching name begins HL - Address of matching name in directory table (BC is destroyed) 20AFH (21H) LXI H,F957H ; start 11 back from directory table at F962 (multiple entry point code) FIRST_TIME: 20B2H (3EH) MVI A,E1H ; load A with E1 (225) or CLEAN_AGAIN: 20B3H (E1) POP H ; discard saved H 20B4H (CDH) CALL 20D5H ; find next valid file table entry 20B7H (C8H) RZ ; return if no more valid entries 20B8H (E5H) PUSH H ; preserve the entry pointer for next iteration 20B9H (23H) INX H 20BAH (23H) INX H ; position HL pointing just before filename 20BBH (11H) LXI D,FC92H ; DE point just before filename argument at $FC92..$FC9A 20BEH (06H) MVI B,08H ; B <- 8 limits iteration in name compare to 8 characters TEST_NEXT_NAME_CHAR: 20C0H (13H) INX D ; D updated to reference next character of filename argument 20C1H (23H) INX H ; H updated to reference next character of valid directory filename 20C2H (1AH) LDAX D ; fetch next character of arg filename 20C3H (BEH) CMP M ; compare arg filename character to dir entry 20C4H (C2H) JNZ 20B3H ; quite comparison, next entry if any mismatch 20C7H (05H) DCR B ; otherwise countdown the 8 char name length limit 20C8H (C2H) JNZ 20C0H ; test next char if more to test. ; we found the entry; return file type (A) , @ of file (DE), @ of dir entry (HL) 20CBH (E1H) POP H ; restore pointer to current entry 20CCH (7EH) MOV A,M ; A <- file type flags 20CDH (23H) INX H ; DE <- address of file itself (as opposed to entry) 20CEH (5EH) MOV E,M 20CFH (23H) INX H 20D0H (56H) MOV D,M 20D1H (2BH) DCX H ; HL <- pointer to start of matching file table entry 20D2H (2BH) DCX H 20D3H (A7H) ANA A ; this ensures zero flag is clear if the entry IS found 20D4H (C9H) RET NEXT_FILE_ENTRY: ; add 11 to HL pointer (size of a directory entry) 20D5H (C5H) PUSH B ; preserve B 20D6H (01H) LXI B,000BH 20D9H (09H) DAD B 20DAH (C1H) POP B ; load file type flags into A 20DBH (7EH) MOV A,M ; return with zero flag set if type $FF (end-of-directory) 20DCH (FEH) CPI FFH 20DEH (C8H) RZ ; skip this entry if bit 7 of type is not set (null/blank entry or killed file) 20DFH (A7H) ANA A 20E0H (F2H) JP 20D5H ; return, with zero flag not set, and HL pointing to a vaild file entry 20E3H (C9H) RET 20E4 - Find unused file entry Exit: HL - points to flags type byte of an unused file entry 20E4H (3AH) LDA F651H 20E7H (A7H) ANA A 20E8H (21H) LXI H,F9AFH 20EBH (C0H) RNZ 20ECH (21H) LXI H,F9AFH 20EFH (01H) LXI B,000BH 20F2H (09H) DAD B 20F3H (7EH) MOV A,M 20F4H (FEH) CPI FFH 20F6H (CAH) JZ 5066H ; Generate FL error 20F9H (87H) ADD A 20FAH (DAH) JC 20F2H 20FDH (C9H) RET 20FEH - NEW Statement 21FAH - Count the number of characters in the buffer pointed to by HL. Buffer ends with a null Entry: HL - Points to the buffer to count Exit: E - Number of characters in the buffer pointed to by HL A - Destroyed 220FH - Create or Open a text file Entry: (FC93H) - Filename (8 bytes). DO not required Exit: HL - Points to start of text file DE - Points to directory entry C flag - Set if file already exist, reset if it is a new file. 2280H - CSAVE Statement 22B9H - Save the buffer pointed to by HL to tape. After execution of this routine, return resumes at BASIC ready. Entry: HL - Start of buffer to save DE - Number of characters to save Exit: All registers destroyed 22CCH - SAVEM Statement 22DDH - CSAVEM Statement 2377H - CLOAD Statement 2413H - Load a record from the cassette and put it in the buffer pointed to by HL. Entry: HL - Points to start of receiving buffer DE - Number of bytes to load. Exit: All registers destroyed 2491H - LOADM and RUNM Statement 24A7H - CLOADM Statement 2542H - Move memory pointed to by HL to the memory pointed to by DE for B number of bytes. HL and DE are incremented on each cycle of the move. Entry: HL - Points to the start of the source memory DE - Points to the start of the destination memory B - Number of bytes to move Exit: HL & DE - Incremented past last byte moved A - Destroyed 260BH - CAS open for output for BASIC files 260EH - CAS open for output for TEXT files 2611H - CAS open for output for Command files 2650H - CAS open for input for BASIC files 2653H - CAS open for input for text files 2656H - CAS open for input for Command files 273AH - STR$ Function 27B1H - Print buffer pointed to by HL until a null (00H) or '"' is found. Print begins at current cursor position. Entry: HL - Points to buffer to be printed 290FH - Move the memory pointed to by BC to the memory pointed to by DE L times. BC and DE are incremented on each cycle of the move. Entry: BC - Points to the start of the source memory DE - Points to the start of the destination memory L - Number of bytes to move Exit: HL & DE - Incremented past last byte moved A - Destroyed