November 7, 2001
Overview
This release incorporates the features added in version 1.2.1 (DM5420 smPCI module support and support for Framer Data over TDM) for the Solaris platform. See Version 1.2.1 Release Notes for details.
In addition, the following changes are introduced in this release:
Note: This release includes new embedded code and/or FPGA configurations. Customers must run dpflashup after installation to make the DPT4 boards compatible with the new version of the library and device driver.
When Non-blocking mode is enabled, reads from the channel will return 0
instead of waiting if a complete message has not yet been received.
Writes to the channel will return 0 instead of waiting if there is not
enough room in the transmit buffer to store the entire message.
An important note for non-blocking HDLC read operations is that the library
does store partial messages in the application's buffer space.
The partial message data must be preserved for future reads from the channel.
This means that the application program should maintain buffers for each
channel to be read.
Under certain conditions the embedded code was not clearing its "out of sync"
flag if the host application read all the valid data from a channel whose
framer went out of sync.
If this situation occurred, the embedded channelization code would not
resume collecting data when the framer came back into sync
and subsequent calls to pci_read_chan would result in an
ETIMEDOUT error.
This means that compiling user applications no longer requires
that macro to be defined on the compiler's command line.
Corrected Support for DM5420 Modules with JTAG
The DPT library is fixed to recognize DM5420 smPCI modules with JTAG
support.
The previous version did not recognize them as being DM5420 modules.
Implementation of Non-Blocking I/O for HDLC Channels
The HDLC support library now implements Non-blocking I/O mode.
To enable this mode include the macro, CHAN_NBLOCK, as part of the
flags argument to the pci_open_hdlc_chan function.
Corrected a Bug in Embedded Code for Reporting Framer Loss of Sync
A problem in the embedded channelization code was discovered and solved.
The nature of the problem is described below.
Corrected Problem in Header Files for Solaris Platform
The header file, include/dpincludes.h, no longer requires
a macro named HAVE_CONFIG_H to be defined in order to include
the dpconfig.h header file.