mirror of
https://github.com/hsoft/collapseos.git
synced 2024-11-27 12:28:06 +11:00
Add TRS-80 model 4P hardware doc
It's a condensed version of the technical manual that can be a bit more practical to use for quick referencing.
This commit is contained in:
Virgil Dupras
parent
a74ee81822
commit
9d8aa3a0d0
@ -17,3 +17,4 @@ Most of that information can already be found elsewhere, but the goal is to have
|
|||||||
the most vital documentation in one single place.
|
the most vital documentation in one single place.
|
||||||
|
|
||||||
* [TI-83+/TI-84+](ti8x.md)
|
* [TI-83+/TI-84+](ti8x.md)
|
||||||
|
* [TRS-80 model 4p](trs80-4p.md)
|
||||||
|
|||||||
203
doc/trs80-4p.md
Normal file
203
doc/trs80-4p.md
Normal file
@ -0,0 +1,203 @@
|
|||||||
|
# TRS-80 Model 4p
|
||||||
|
|
||||||
|
## Ports
|
||||||
|
|
||||||
|
Address Read Write
|
||||||
|
FC-FF Cassette in Cassette out, resets
|
||||||
|
F8-FB Rd printer status Wr to printer
|
||||||
|
F4-F7 - Drive select
|
||||||
|
F3 FDC data reg FDC data reg
|
||||||
|
F2 FDC sector reg FDC sector reg
|
||||||
|
F1 FDC track reg FDC track reg
|
||||||
|
F0 FDC status reg FDC cmd reg
|
||||||
|
EC-EF Reset RTC INT Mode output
|
||||||
|
EB RS232 recv holding reg RS232 xmit holding reg
|
||||||
|
EA UART status reg UART/modem control
|
||||||
|
E9 - Baud rate register
|
||||||
|
E8 Modem status Master reset/enable
|
||||||
|
UART control reg
|
||||||
|
E4-E7 Rd NMI status Wr NMI mask reg
|
||||||
|
E0-E3 Rd INT status Wr INT mask reg
|
||||||
|
CF HD status HD cmd
|
||||||
|
CE HD size/drv/hd HD size/drv/hd
|
||||||
|
CD HD cylinder high HD cylinder high
|
||||||
|
CC HD cylinder low HD cylinder low
|
||||||
|
CB HD sector # HD sector #
|
||||||
|
CA HD sector cnt HD sector cnt
|
||||||
|
C9 HD error reg HD write precomp
|
||||||
|
C8 HD data reg HD data reg
|
||||||
|
C7 HD CTC chan 3 HD CTC chan 3
|
||||||
|
C6 HD CTC chan 2 HD CTC chan 2
|
||||||
|
C5 HD CTC chan 1 HD CTC chan 1
|
||||||
|
C4 HD CTC chan 0 HD CTC chan 0
|
||||||
|
C2-C3 HD device ID -
|
||||||
|
C1 HD control reg HD Control reg
|
||||||
|
C0 HD wr prot reg -
|
||||||
|
94-9F - -
|
||||||
|
90-93 - Sound option
|
||||||
|
8C-8F Graphic sel 2 Graphic sel 2
|
||||||
|
8B CRTC Data reg CRTC Data reg
|
||||||
|
8A CRTC Control reg CRTC Control reg
|
||||||
|
89 CRTC Data reg CRTC Data reg
|
||||||
|
88 CRTC Control reg CRTC Control reg
|
||||||
|
84-87 - Options reg
|
||||||
|
83 - Graphic X reg
|
||||||
|
82 - Graphic Y reg
|
||||||
|
81 Graphics RAM Graphics RAM
|
||||||
|
80 - Graphics options reg
|
||||||
|
|
||||||
|
Bit map
|
||||||
|
|
||||||
|
Address D7 D6 D5 D4 D3 D2 D1 D0
|
||||||
|
F8-FB-Rd Busy Paper Select Fault - - - -
|
||||||
|
EC-EF-Rd (any read causes reset of RTC interrupt)
|
||||||
|
EC-EF-Wr - CPU - Enable Enable Mode Cass -
|
||||||
|
Fast EX I/O Altset Select Mot on
|
||||||
|
E0-E3-Rd - Recv Recv Xmit 10 Bus RTC C Fall C Rise
|
||||||
|
Error Data Empty int Int Int Int
|
||||||
|
E0-E3-Wr - Enable Enable En.Xmit Enable Enable Enable Enable
|
||||||
|
Rec err Rec dat Emp 10 int RTC int CF int CR int
|
||||||
|
90-93-Wr - - - - - - - Sound
|
||||||
|
Bit
|
||||||
|
84-87-Wr Page Fix upr Memory Memory Invert 80/64 Select Select
|
||||||
|
mem bit 1 bit 0 video Bit 1 Bit 0
|
||||||
|
|
||||||
|
## Memory map
|
||||||
|
|
||||||
|
### Memory map 1 - model III mode
|
||||||
|
|
||||||
|
0000-1fff ROM A (8K)
|
||||||
|
2000-2fff ROM B (4K)
|
||||||
|
3000-37ff ROM C (2K) - less 37e8/37e9
|
||||||
|
37e8-37e9 Printer Status Port
|
||||||
|
3800-3bff Keyboard
|
||||||
|
3c00-3fff Video RAM (page bit selects 1K or 2K)
|
||||||
|
4000-7fff RAM (16K system)
|
||||||
|
4000-ffff RAM (64K system)
|
||||||
|
|
||||||
|
### Memory map 2
|
||||||
|
|
||||||
|
0000-37ff RAM (14K)
|
||||||
|
3800-3bff Keyboard
|
||||||
|
3c00-3fff Video RAM
|
||||||
|
4000-7fff RAM (16K) end of one 32K bank
|
||||||
|
8000-ffff RAM (32K) second 32K bank
|
||||||
|
|
||||||
|
### Memory map 3
|
||||||
|
|
||||||
|
0000-7fff RAM (32K) bank 1
|
||||||
|
8000-f3ff RAM (29K) bank 2
|
||||||
|
f400-f7ff Keyboard
|
||||||
|
f800-ffff Video RAM
|
||||||
|
|
||||||
|
### Memory map 4
|
||||||
|
|
||||||
|
0000-7fff RAM (32K) bank 1
|
||||||
|
8000-ffff RAM (32K) bank 2
|
||||||
|
|
||||||
|
## Supervisor calls
|
||||||
|
|
||||||
|
SVC are made by loading the correct SVC number in A, other params in other regs,
|
||||||
|
and then call `rst 0x28`.
|
||||||
|
|
||||||
|
Z is pretty much always used for success or as a boolean indicator. It is
|
||||||
|
sometimes not specified when there's not enough tabular space, but it's there.
|
||||||
|
When `-` is specified, it means that the routine either never returns or is
|
||||||
|
always successful.
|
||||||
|
|
||||||
|
Num Name Args Res Desc
|
||||||
|
00 IPL - - Reboot the system
|
||||||
|
01 KEY - AZ Scan *KI, wait for char
|
||||||
|
02 DSP C=char AZ Display character
|
||||||
|
03 GET DE=F/DCB AZ Get one byte from device or file
|
||||||
|
04 PUT DE=F/DCB C=char AZ Write one byte to device or file
|
||||||
|
05 CTL DE=DBC C=func CAZ Output a control byte
|
||||||
|
06 PRT C=char AZ Send character to printer
|
||||||
|
07 WHERE - HL Locate origin of SVC
|
||||||
|
08 KBD - AZ Scan keyboard and return
|
||||||
|
09 KEYIN HL=buf b=len c=0 HLBZ Accept a line of input
|
||||||
|
0a DSPLY HL=str AZ Display message line
|
||||||
|
0b LOGER HL=str AZ Issue log message
|
||||||
|
0c LOGOT HL=str AZ Display and log message
|
||||||
|
0d MSG DE=F/DCB HL=str AZ Send message to device
|
||||||
|
0e PRINT HL=str AZ Print message line
|
||||||
|
0f VDCTL special spc Video functions
|
||||||
|
10 PAUSE BC=delay - Suspend program execution
|
||||||
|
11 PARAM DE=ptbl HL=str Z Parse parameter string
|
||||||
|
12 DATE HL=recvbuf HLDE Get date
|
||||||
|
13 TIME HL=recvbuf HLDE Get time
|
||||||
|
14 CHNIO IX=DCB B=dir C=char - Pass control to next module in device chain
|
||||||
|
15 ABORT - - Abort Program
|
||||||
|
16 EXIT HL=retcode - Exit to TRSDOS
|
||||||
|
18 CMNDI HL=cmd - Exec Cmd w/ return to system
|
||||||
|
19 CMNDR HL=cmd HL Exec Cmd
|
||||||
|
1a ERROR C=errno - Entry to post an error message
|
||||||
|
1b DEBUG - - Enter DEBUG
|
||||||
|
1c CKTSK C=slot Z Check if task slot in use
|
||||||
|
1d ADTSK C=slot - Remove interrupt level task
|
||||||
|
1e RMTSK DE=TCB C=slot - Add an interrupt level task
|
||||||
|
1f RPTSK - - Replace task vector
|
||||||
|
20 KLTSK - - Remove currently executing task
|
||||||
|
21 CKDRV C=drvno Z Check drive
|
||||||
|
22 DODIR C=drvno b=func ZBHL Do directory display/buffer
|
||||||
|
23 RAMDIR HL=buf B=dno C=func AZ Get directory record or free space
|
||||||
|
28 DCSTAT C=drvno Z Test if drive assigned in DCT
|
||||||
|
29 SLCT C=drvno AZ Select a new drive
|
||||||
|
2a DCINIT C=drvno AZ Initialize the FDC
|
||||||
|
2b DCRES C=drvno AZ Reset the FDC
|
||||||
|
2c RSTOR C=drvno AZ Issue a FDC RESTORE command
|
||||||
|
2d STEPI C=drvno AZ Issue a FDC STEP IN command
|
||||||
|
2e SEEK C=drvno DE=addr - Seek a cylinder
|
||||||
|
2f RSLCT C=drvno - Test for drive busy
|
||||||
|
30 RDHDR HL=buf DCE=addr AZ Read a sector header
|
||||||
|
31 RDSEC HL=buf DCE=addr AZ Read a sector
|
||||||
|
32 VRSEC DCE=addr AZ Verify sector
|
||||||
|
33 RDTRK HL=buf DCE=addr AZ Read a track
|
||||||
|
34 HDFMT C=drvno AZ Hard disk format
|
||||||
|
35 WRSEC HL=buf DCE=addr AZ Write a sector
|
||||||
|
36 WRSSC HL=buf DCE=addr AZ Write system sector
|
||||||
|
37 WRTRK HL=buf DCE=addr AZ Write a track
|
||||||
|
38 RENAM DE=FCB HL=str AZ Rename file
|
||||||
|
39 REMOV DE=D/FCB AZ Remove file or device
|
||||||
|
3a INIT HL=buf DE=FCB B=LRL AZ Open or initialize file
|
||||||
|
3b OPEN HL=buf DE=FCB B=LRL AZ Open existing file or device
|
||||||
|
3c CLOSE DE=FCB/DCB AZ Close a file or device
|
||||||
|
3d BKSP DE=FCB AZ Backspace one logical record
|
||||||
|
3e CKEOF DE=FCB AZ Check for EOF
|
||||||
|
3f LOC DE=FCB BCAZ Calculate current logical record number
|
||||||
|
40 LOF DE=FCB BCAZ Calculate the EOF logical record number
|
||||||
|
41 PEOF DE=FCB AZ Position to end of file
|
||||||
|
42 POSN DE=FCB BC=LRN AZ Position file
|
||||||
|
43 READ DE=FCB HL=ptr AZ Read a record
|
||||||
|
44 REW DE=FCB AZ Rewind file to beginning
|
||||||
|
45 RREAD DE=FCB AZ Reread sector
|
||||||
|
46 RWRIT DE=FCB AZ Rewrite sector
|
||||||
|
47 SEEKSC DE=FCB - Seek cylinder and sector of record
|
||||||
|
48 SKIP DE=FCB AZ Skip a record
|
||||||
|
49 VER DE=FCB HLAZ Write and verify a record
|
||||||
|
4a WEOF DE=FCB AZ Write end of file
|
||||||
|
4b WRITE DE=FCB HL=ptr AZ Write a record
|
||||||
|
4c LOAD DE=FCB HLAZ Load program file
|
||||||
|
4d RUN DE=FCB HLAZ Run program file
|
||||||
|
4e FSPEC HL=buf DE=F/DCB HLDE Assign file or device specification
|
||||||
|
4f FEXT DE=FCB HL=str - Set up default file extension
|
||||||
|
50 FNAME DE=buf B=DEC C=drv AZHL Get filename
|
||||||
|
51 GTDCT C=drvno IY Get drive code table address
|
||||||
|
52 GTDCB DE=devname HLAZ Get device control block address
|
||||||
|
53 GTMOD DE=modname HLDE Get memory module address
|
||||||
|
55 RDSSC HL=buf DCE=addr AZ Read system sector
|
||||||
|
57 DIRRD B=dirent C=drvno HLAZ Directory record read
|
||||||
|
58 DIRWR B=dirent C=drvno HLAZ Directory record write
|
||||||
|
5a MUL8 C*E A Multiply C by E
|
||||||
|
5b MUL16 HL*C HLA Multiply HL by C
|
||||||
|
5d DIV8 E/C AE Divides E by C
|
||||||
|
5e DIV16 HL/C HLA Divides HL by C
|
||||||
|
60 DECHEX HL=str BCHL Convert Decimal ASCII to binary
|
||||||
|
61 HEXDEC HL=num DE=buf DE Convert binary to decimal ASCII
|
||||||
|
62 HEX8 C=num HL=buf HL Convert 1 byte to hex ASCII
|
||||||
|
53 HEX16 DE=num HL=buf HL Convert 2 bytes to hex ASCII
|
||||||
|
64 HIGH$ B=H/L HL=get/set HLAZ Get or Set HIGH$/LOW$
|
||||||
|
65 FLAGS - IY Point IY to system flag table
|
||||||
|
66 BANK B=func C=bank BZ Memory bank use
|
||||||
|
67 BREAK HL=vector HL Set Break vector
|
||||||
|
68 SOUND B=func - Sound generation
|
||||||
Loading…
Reference in New Issue
Block a user