32016 PANDORA API ================= On entry, R0-R7 contain values to pass to SVC call On exit, R0-R7 contain returned data F=0 - no error occured F=1 - error occured, R1=error number, use OS_ERROR to get string SVC &00 (0) - Indirect SVC call ------------------------------- On entry: On exit: R0=SVC call R1-R7=as called SVC R1-R7=as called SVC SVC &01 (1) - OS_WRCH --------------------- On entry: On exit: R1=character R1=preserved SVC &02 (2) - OS_STRING - Print String -------------------------------------- On entry: On exit: R1=>text R1=preserved R2=length R2=preserved SVC &03 (3) - OS_ASCI --------------------- On entry: On exit: R1=character R1=preserved SVC &04 (4) - OS_NEWL --------------------- On entry: On exit: no parameters all preserved SVC &05 (5) - OS_RDCH --------------------- On entry: On exit: no parameters R1=character Cy=carry flag SVC &06 (6) - OS_BYTE --------------------- On entry: On exit: R1=function R1= R2=first parameter R2=returned word R3=second parameter R3=returned word DIV 256 Cy=returned carry flag SVC &07 (7) - OS_WORD --------------------- On entry: On exit: R1=function Control block updated R2=>control block SVC &08 (8) - OS_CLI -------------------- On entry: R1=>command string R2=max string length SVC &09 (9) - UNUSED -------------------- SVC &0A (10) - OS_FILE ---------------------- On entry: On exit: R1=function R1=result R2=>filename R2=undefined R3=max name length R3=undefined R4=load R4=load R5=exec R5=exec R6=length/start R6=length R7=attrs/end R7=attrs SVC &0B (11) - OS_FIND ---------------------- On entry: On exit: R1=function R1=handle R2=>string or handle R3=max string length SCV &0C (12) - OS_ARGS ---------------------- On entry: On exit: R1=function R1=result R2=handle R2=preserved R3=data R3=data SVC &0D (13) - OS_BGET ---------------------- On entry: On exit: R1=byte R2=handle Cy=carry flag SVC &0E (14) - OS_BPUT ---------------------- On entry: On exit: R1=byte R1=preserved R2=handle R2=preserved SVC &0F (15) - OS_GBPB ---------------------- On entry: On exit: R1=function R1=result R2=channel R2=updated channel R3=address R3=updated address R4=number R4=updated number R5=pointer R5=updated pointer Cy=carry flag SVC &10 (16) - UNUSED --------------------- SVC &11 (17) - OS_EXIT ---------------------- Enters current control program with R1=2 SVC &12 (18) - OS_DEBUG ----------------------- SVC &13 (19) - UNUSED --------------------- SVC &14 (20) - OS_ESCAPE - Read Escape flag ------------------------------------------- On entry: On exit: no parameters F flag=1 - Escape state set SVC &15 (21) - OS_INLINE - Print inline text -------------------------------------------- On entry: On exit: no parameters all preserved SVC &15 EQUB length EQUS "string" SVC &16 (22) to &1D (29) - UNUSED --------------------------------- SVC &1E (30) - OS_HANDLER - Set event handler --------------------------------------------- On entry: On exit: R1=event number R1=preserved R2=offset/module R2=preserved procedure descriptor SVC &1F (31) - OS_ERROR - Read last error ----------------------------------------- On entry: On exit: R1=>buffer R1=preserved R2=max size of buffer R2=length of error R3=error number SVC &20 (32) - OS_SVR - Enter supervisor mode --------------------------------------------- SVC &21 (33) - OS_ABORT - Jump through ABORT vector --------------------------------------------------- SVC &22 (34) to &27 (39) - UNUSED --------------------------------- SVC &28 (40) - OS_SETVDT - Set Virtual Dispatch Table address ------------------------------------------------------------- On entry: On exit: R1=new VDT address R1=preserved SVC &29 (41) to &31 (49) - UNUSED --------------------------------- SVC &32 (50) - OS_SPLIT ----------------------- Just exits without doing anything SVC &33 (51) - OS_ENTRY - Set Control Program Entry ---------------------------------------------------- On entry: On exit: R1=Entry address R1=preserved SVC &34 (52) - OS_VERSION - Get version --------------------------------------- On entry: On exit: no parameters R1=version*256, eg &200 for 2.00 SVC &35 (53) - OS_SETVDU - Set VDU Handler ------------------------------------------ On entry: On exit: R1<256 - Handler ID R1=previous handler R1>255 - =>handler SVC &36 (54) - OS_CONFIG - Read config setting ---------------------------------------------- On entry: On exit: no parameters R1.b0=FPU present R1.b1=MMU present SVC &37 (55) - OS_PRIV - Enable/Disable Pandora SVCs ---------------------------------------------------- On entry: On exit: R1=SVC call number R1=preserved R2.b0=0 - This SVC passed on to VDT R2=previous state R2.b0=1 - This SVC performed by Kernel SVC &38 (56) - OS_NOLOAD - No OSCLI Load ---------------------------------------- On entry: On exit: R1.b0=0 - disable LOADs from OSCLI R1=previous state R1.b0=1 - enable LOADs from OSCLI SVC &39 (57) - OS_CONTROL - Enable/Disable event ------------------------------------------------ On entry: On exit R1=event number &FB..&FE R1=preserved R2.b0=0 - disable R2=previous state R2.b0=1 - enable