Difference between revisions of "AMSDOS Hidden RSX Functions"
From CPCWiki - THE Amstrad CPC encyclopedia!
m (→Notes) |
m (→Init) |
||
| (2 intermediate revisions by 2 users not shown) | |||
| Line 39: | Line 39: | ||
"V ROM" Vortex VDOS2.0 | "V ROM" Vortex VDOS2.0 | ||
"Pdos" PARADOS | "Pdos" PARADOS | ||
| + | "Vdos" VARADOS | ||
"ROMDOS " KDS ROMDOS, Siren Software ROMDOS XL, and XL 4.0 | "ROMDOS " KDS ROMDOS, Siren Software ROMDOS XL, and XL 4.0 | ||
"XDDOS ROM" Dobbertin X-DDOS 1.11 and X-DDOS 2.10 | "XDDOS ROM" Dobbertin X-DDOS 1.11 and X-DDOS 2.10 | ||
"RODOS ROM" Romantic Robot RODOS 2.11, 2.15, 2.19 | "RODOS ROM" Romantic Robot RODOS 2.11, 2.15, 2.19 | ||
| − | The names are typically containing "invalid" characters like spaces or lowercase letters, so they can't be | + | The names are typically containing "invalid" characters like spaces or lowercase letters, so they can't be accidentally used in BASIC as |NAME. |
== Notes == | == Notes == | ||
| Line 48: | Line 49: | ||
* The above chr(8xh) function vectors are usually at ROM7:C033h..C04Dh in AMSDOS, however, clones like VDOS, RODOS, ROMDOS, X-DDOS have the vectors arranged differently, so always use KL_FIND_COMMAND to obtain the function address. | * The above chr(8xh) function vectors are usually at ROM7:C033h..C04Dh in AMSDOS, however, clones like VDOS, RODOS, ROMDOS, X-DDOS have the vectors arranged differently, so always use KL_FIND_COMMAND to obtain the function address. | ||
| + | |||
| + | [[Category:Programming]] | ||
Latest revision as of 09:40, 4 April 2015
Below "Hidden" RSX commands are having non-ASCII names, so they cannot be used under BASIC by typing |NAME. Instead, they can be used only in machine code, by obtaining the function address via KL_FIND_COMMAND, for details see: BIOS Kernel RSX Functions (Resident System Extensions)
Contents
Message On/Off
chr(81h) MESSAGE_ON_OFF ;in: A=flag(00h=on, >=01h=off) (R,I,C);out:A=old
Set Drive Speed
chr(82h) SET_DRIVE_SPEED ;in: HL=ptr to 9 bytes
00h 2 spin-up time in 1/50sec ticker ticks (usually 50)
02h 2 spin-down time in 1/50sec ticker ticks (usually 250)
04h 1 usually AFh, delay for chr(86h) function
05h 1 whatever? in 1ms units (usually 15 = 15ms)
06h 1 settletime AND steprate in 1ms units (usually 12 = 12ms)
07h 1 head unload time in 32ms units (usually 1 = 32ms)
08h 1 head load time, bit0=DMA disable (usually 16ms)
Set Disk Type
chr(83h) SET_DISK_TYPE ;in: A=type (0xh=IBM, 4xh=CPM, Cxh=DATA)
Read/Write Sector
chr(84h) READ_SECTOR ;in: E=drv, D=trk, C=sec, HL=dest chr(85h) WRITE_SECTOR ;in: E=drv, D=trk, C=sec, HL=src
Format Track
chr(86h) FORMAT_TRACK ;in: E=drv, D=trk, C=sec1, HL=ptr to 9x4 byte
Seek Track
chr(87h) SEEK_TRACK ;in: E=drv, D=trk, out: cy=1=okay
Test Drive
chr(88h) TEST_DRIVE ;in: A=drv, out: cy=1=okay
Set Retry Count
chr(89h) SET_RETRY_COUNT ;in: A=retry count (default=10) (01h..(1)00h)
Init
[C006h] INIT ;in/out: DE=LORAM, HL=HIRAM, CY=?
This the initialization function (called by KL_ROM_WALK, which is automatically done on power-up). The function is always found in the first entry of the RSX lists, ie. [C006h]=address, and [C004h]=name. Where known names are:
"CPM ROM" Amstrad AMSDOS and Vortex VDOS1.0 "V ROM" Vortex VDOS2.0 "Pdos" PARADOS "Vdos" VARADOS "ROMDOS " KDS ROMDOS, Siren Software ROMDOS XL, and XL 4.0 "XDDOS ROM" Dobbertin X-DDOS 1.11 and X-DDOS 2.10 "RODOS ROM" Romantic Robot RODOS 2.11, 2.15, 2.19
The names are typically containing "invalid" characters like spaces or lowercase letters, so they can't be accidentally used in BASIC as |NAME.
Notes
- AMSDOS supports only single-sided disks (the FDC supports two sides, but AMSDOS doesn't). All other DOS clones like VDOS, RODOS, ROMDOS, PARADOS, XD-DOS support double-sided disks. However, unknown if/how some/all/which of that clones allow to access the 2nd side via above functions (possibly/best by unused bits in the drive number, or by extending track number to 0..159 for 2x80 tracks)?
- The above chr(8xh) function vectors are usually at ROM7:C033h..C04Dh in AMSDOS, however, clones like VDOS, RODOS, ROMDOS, X-DDOS have the vectors arranged differently, so always use KL_FIND_COMMAND to obtain the function address.
