
UDI Developer’s Toolkit
6-10
Universal Debugger Interface Specification
DFE and TIP Parameters
Only the version numbers are significant in these parameters. These are UDI
version numbers that the DFE or TIP can handle. The UDI specification
describes how the TIP should inspect the input parameter,
DFE
, and supply the
output parameter,
TIP
. If your DFE or TIP is building with the current toolkit,
your version parameter should remain at 0x140 (UDI 1.4.0). This is the
UDILatestVersion
definition in
udiids.h
.
DFEIPCId and TIPIPCId Parameters
These consist of the normal company, product, and version fields. These are
filled in by the IPC layers, and, in this toolkit, are defined in the IPC source
files:
udip2dos.c
,
dos2udip.c
,
udip2soc.c
, and
soc2udip.c
. If you use the IPC
sources from this toolkit unchanged, the IPCIds should be left unchanged as
well. If you modify the IPC sources before you use them, please change the
company code to your company’s code, and change the IPCId version number
and IPCId product codes for your own tracking purposes.
Notes for DFE Developers
As of UDI 1.3, a DFE is both a UDI client (making UDI calls) and a UDI
server (implementing UDIDFE calls).
As a UDI client, a DFE may use whatever subset of the UDI services that it
requires. Be aware that TIPs are not required to implement all of the UDI
services, so a DFE should be written to be reasonably workable with a
minimum TIP. See page 3-1 for a discussion of which UDI services a TIP is
required to implement.
You will also find a list of which UDIDFE services a DFE is required to
implement on page 3-1.
To make the TIP implementations somewhat simpler, there are some
requirements made on the sequencing of UDI calls by the DFE. These are
discussed elsewhere in this specification, but we list them here as a reminder:
After calling
UDIGetErrorMessage
, the DFE must continue calling it
until
Countdone
is less than
MsgSize
.
After calling
UDIGetStdout
or
UDIGetStderr
, the DFE must continue
calling it until
Countdone
is less than
BufSize
, unless the DFE calls
UDIStop
.