VxWorks Reference Manual : Libraries
wdbVioDrv - virtual tty I/O driver for the WDB agent
wdbVioDrv( ) - initialize the tty driver for a WDB agent
This library provides a psuedo-tty driver for use with the WDB debug agent. I/O is performed on a virtual I/O device just like it is on a VxWorks serial device. The difference is that the data is not moved over a physical serial channel, but rather over a virtual channel created between the WDB debug agent and the Tornado host tools.
The driver is installed with wdbVioDrv( ). Individual virtual I/O channels are created by opening the device (see wdbVioDrv for details). The virtual I/O channels are defined as follows:
Once data is written to a virtual I/O channel on the target, it is sent to the host-based target server. The target server allows this data to be sent to another host tool, redirected to the "virtual console," or redirected to a file. For details see the Tornado User's Guide.
Channel Usage 0 Virtual console 1-0xffffff Dynamically created on the host >= 0x1000000 User defined
wdbVioDrv( ) - initialize the tty driver for a WDB agent
STATUS wdbVioDrv ( char * name )
This routine initializes the VxWorks virtual I/O driver and creates a virtual I/O device of the specified name.
This routine should be called exactly once, before any reads, writes, or opens. Normally, it is called by usrRoot( ) in usrConfig.c, and the device name created is "/vio".
After this routine has been called, individual virtual I/O channels can be open by appending the channel number to the virtual I/O device name. For example, to get a file descriptor for virtual I/O channel 0x1000017, call open( ) as follows:
fd = open ("/vio/0x1000017", O_RDWR, 0)
OK, or ERROR if the driver cannot be installed.