DBus hardware access - From TI view (registers)


DBus hardware access (TI9x only)

Well, the whole doc is focused on link from a PC view. This topic add a TI view.
While I was working on TiEmu II, I had to fix linkport support which was quite broken. Unfortunately, I didn't know very much about how linkport works on TI side. This was quite annoying. Then, I decided to dis-assemble low-level linkport routines and the result of this work is below.

1°) DBus registers in $600000 ports

Informations below comes from Johan Eilert's j89hw.txt documentation and TI's TI89/TI92 Plus Developper Guide:

DBus Control & Status
Control ($60000C)
Status ($60000D)
15
14
13
12
11
10
9
8
7
6
5
4
3
2
1
0
AE
LD
LTO

CLE
CA
CTX
CRX
SLE
STX
SRX
SLI
SA
EA?



Control:
AE
Autostart Enable
Bit set and bit 3 of $600005 set : wake-up calc on Dbus activity.
LD
Link Disable
Set it to 1 when you want to use direct access to register $60000E. Disable byte sender/receiver.
LTO
Link Time-out Disable
Disable link time-out (red/white are low for more than 2 seconds).



CLE
Link Error Interrupt Enable
Allow SLE to trigger interrupt.
CA
AutoStart Interrupt Enable Allow SA to trigger interrupt.
CTX
TX buffer empty Interrupt Enable Allow STX to trigger interrupt (and triggers interrupt immediately given that STX is usually set).
CRX
RX buffer full Interrupt Enable Allow SRX to trigger interrupt.

Status:
SLE
Link Error
Dbus error (timing or protocol violation).
STX
TX buffer empty
Transmit buffer is empty.
SRX
RX buffer full
Receive buffer is empty.
SLI
Link Interrupt
Never used (at least in TI AMS). SLI = SLE | STX | SRX | SA.
SA
AutoStart
Link activity on DBus port.
EA ?
External Activity ?
External activity (DBus lines are toggling). Used by AMS >= 2.08


Always 1.


Always 0.
Warning: reading this register resets it ! Take care to read it once and store its value for subsequent operations.
Warning2: this is what TI says in their SDK but I'm not sure that's true (at least in TiEmu).

DBus Direct & Data
Direct ($60000E)
Data ($60000F)
15
14
13
12
11
10
9
8
7
6
5
4
3
2
1
0




D1I
(white)
D0I
(red)
D1O
D0O
RX/TX 1-byte buffer

Direct access:
D1I
D1 input
Live status of D1/ring/white  (1=pulled down).
D0I
D0 input
Live status of D0/tip/red  (1=pulled down).
D1O
D1 output
Activate (pull down) D1/ring/white.
D0O
D0 output
Activate (pull down) D1/ring/white.

2°) Link behaviour

The link is interrupt-driven and relies on 2 circular buffers of 128 bytes each. Each buffer is managed as a stucture.
In normal operating mode, AE, CLE, CA and CRX are enabled. CTX is set in the transmit routine. It is disabled at the end of the handler when no more chars have to be transmitted.

Some informations comes from dis-assembling, some others comes from TIGCC documentation (after check-up).

* AI4 handler : it begins by checking some flags in the control register:
- SA=1 => exit,
- SLE=1 => reset link port ($E0, $8D in ctrl reg),
- SRX=1 => receive char from rx/tx register and put it in circular buffer,
AMS < 2.08:
- STX=1 => transmit char from circular buffer (please note this step is blocking),
AMS >= 2.08: (AMS208 add a bit check before entering into tx routine).
- EA = 0 => exit,
- STX=1 => transmit char.


* OSLinkReset : OSLinkReset resets the link interface. It also resets all link variables and performs OSLinkClose. Ints are disabled during call.

* OSLinkOpen : OSLinkOpen clears both transmit and receive queues, then set a flag which tells that the communication is opened.

* OSLinkClose : OSLinkClose waits until eventual bytes waiting in transmit queue are sent out, then clears both transmit and receive queues, and clear a flag which tells that the communication is opened. Ints are disabled during call.

* OSLinkTxQueueInquire : OSLinkTxQueueInquire returns the number of free bytes in the link transmit buffer. Ints are disabled during call.

* OSLinkTxQueueActive : OSLinkTxQueueActive returns TRUE if the transmit queue is active, else returns FALSE. This function checks CTX bit. Ints are disabled during call.

* OSWriteLinkBlock : inserts num bytes from buffer into the link transmit buffer. Returns 0 if the operation was sucessful, else returns a non-zero value. num must be in the range 1-128. Ints are disabled during call.
Note: the routine enables TX interrupt by setting the CTX bit. Consequently, the AI4 handler will be called as soon as ints (SR) will be enabled given that STX is set.
 
* OSCheckSilentLink : OSCheckSilentLink returns an integer which determines the link state..

* OSLinkCmd : to do...

Dis-assembled output: here. The output contains comments only. I can put source code, this is strictly forbidden by TI. I will not distribute it, neither here, nor by mail.

3°) Remarks

Sending 4 bytes on the linkport sets the followinf flags : TRIA TRIA TRIA TRI TI ( T = STX, R = SRX, I = SLI and A = EA).

More Information

You may find some informations in the TIGCC documentation.

[previous page]
Introduction

[home]
Table of Contents

[next page]
Link Cables


Site maintained by Romain Liévin (roms@tilp.info) and Tim Singer (tsinger@gladstone.uoregon.edu)