DPI Driver
Application Program Interface
2-99
Important Note:
This driver will no longer be supported in the next
major release of DSP/BIOS. We recommend that you use the IOM
driver interface instead. See the
DSP/BIOS Driver Developer’s Guide
(SPRU616). This driver is still supported in DSP/BIOS 5.32 and will be
supported in any patch releases or minor enhancements to DSP/BIOS
5.32.
Description
The DPI driver is a software device used to stream data between tasks
on a single processor. It provides a mechanism similar to that of UNIX
named pipes; a reader and a writer task can open a named pipe device
and stream data to/from the device. Thus, a pipe simply provides a
mechanism by which two tasks can exchange data buffers.
Any stacking driver can be stacked on top of DPI. DPI can have only one
reader and one writer task.
It is possible to delete one end of a pipe with SIO_delete and recreate
that end with SIO_create without deleting the other end.
Configuring a
DPI Device
To add a DPI device, right-click on the DPI - Pipe Driver folder, and select
Insert DPI. From the Object menu, choose Rename and type a new name
for the DPI device.
Configuration
Properties
The following list shows the properties that can be configured in a Tconf
script, along with their types and default values. For details, see the DPI
Object Properties heading. For descriptions of data types, see Section
1.4,
Instance Configuration Parameters
Data Streaming
After adding a DPI device called pipe0 in the configuration, you can use
it to establish a communication pipe between two tasks. You can do this
dynamically, by calling in the function for one task:
inStr = SIO_create("/pipe0", SIO_INPUT, bufsize, NULL);
...
SIO_get(inStr, bufp);
DPI Driver
Pipe driver
Name
Type
Default
comment
String
"<add comments here>"
allowVirtual
Bool
false