User`s guide

Real-Time Data Exchange
Instrumentation 3-41
An OLE automation client can send data to the target using the OLE
Interface. All data to be sent to the target is written to a memory buffer within
the RTDX host library. When the RTDX host library receives a read request
from the target application, the data in the host buffer is sent to the target via
the JTAG interface. The data is written to the requested location on the target
in real time. The host notifies the RTDX target library when the operation is
complete.
3.7.3.3 RTDX Target Library User Interface
The user interface provides the safest method of exchanging data between a
target application and the RTDX host library.
The data types and functions defined in the user interface handle the
following functions:
❏ Enable a target application to send data to the RTDX host library
❏ Enable a target application to request data from the RTDX host library
❏ Provide data buffering on the target. A copy of your data is stored in a
target buffer prior to being sent to the host. This action helps ensure the
integrity of the data and minimizes real-time interference.
❏ Provide interrupt safety. You can call the routines defined in the user
interface from within interrupt handlers.
❏ Ensure correct utilization of the communication mechanism. It is a
requirement that only one datum at a time can be exchanged between
the host and target using the JTAG interface. The routines defined in the
user interface handle the timing of calls into the lower-level interfaces.
3.7.3.4 RTDX Host OLE Interface
The OLE interface describes the methods that enable an OLE automation
client to communicate with the RTDX host library.
The functions defined in the OLE interface:
❏ Enable an OLE automation client to access the data that was recorded in
an RTDX log file or is being buffered by the RTDX Host Library
❏ Enable an OLE automation client to send data to the target via the RTDX
host library