September 24, 2002
Overview
The following changes are introduced in this release:
Note: This release includes new FPGA configurations and embedded code. Run the dpflashup program after installation to update the FPGA configuration data on the DPT4 board(s).
The software and FPGA configurations are not compatible with previous versions. Therefore some warning messages about version conflicts may appear when the flash program is run.
Updates to DPT Device Driver
The installation of the Solaris device driver now correctly puts the
pcie1drv.conf file in /usr/kernel/drv for both 32-bit and 64-bit systems.
The Linux device driver is fixed to return the number of bytes transfered
as the status when reading from a signalling channel.
When the Linux device driver is installed, using the make install-dev
command, the driver module is copied into the directory,
/lib/modules/kernel-version/misc.
The bootup initialization script now looks for the driver module there
rather than the directory in which it was built.
The default number of boards configured for the Linux device driver
has been changed from 1 to 4.
This only affects the number of deivce entries created in /dev by the
make install-dev command and the boot-up initialization script.
It does not matter if fewer boards are actually installed in the system.
The Windows (2000 & XP) device driver is fixed to not loose error status
when it returns data that was available prior to the error.
Changes in the Host API Library
The changes are only implemented in the functions provided specifically for
access of the DM5420 modules.
When transferring data to and from DM5420 modules, the dm5420_up_..
and dm5420_dl_.. functions should be used rather than the generic
DPT4 transfer functions.
New library functions are provided for accessing registers in the
E1/T1 framers (Comet chips) and the H.100 interface.
The new functions are named comet_peek8, comet_poke8,
h100_peek8 and h100_poke8 and are documented in the
DPT4 Programmer Reference Manual (version 1.4.0 or higher).
These functions must be used instead of the generic pci_peek..
and pci_poke... functions to access the Comet and H100 resources.
The pciopen and pciopenex functions are fixed to check
to device driver version for compatibility before attempting to use
features that may not be supported by incompatible versions.
New and Modified Utility and Diagnostic Programs
The dpdebug program is modified to have specific commands for
reading and writing Comet and H.100 interface registers using the new
library functions.
The commands, rt and wt, read and write Comet registers.
The commands, rh and wh, read and write H.100 interface registers.
The dpcons and dpdmastat programs are modified to run
even if mismatched versions are detected.
They will display a warning if versions don't match but will continue to run.
The device drivers for the DPT4 on all platforms includes support
for the new embedded code commands and messages for handling signalling data.
(See "Updates for Embedded Code" below.)
The library functions used for transferring data to and from DM5420 smPCI
modules have been fixed to properly handle transfers that cross page boundaries
of the modules' SDRAM.
The dpmemtest diagnostic program now includes internal memory
of DSPs on smPCI expansion modules.
Changes to Configuration and Installation for Unix
The configure program has a new option to modify this default
behavior.
The option is:
The Makefiles in the top-level directory and in the "bin" and device driver
directories have added commands for creating a software package that includes
the necessary files for using and maintaining DPT boards on non-development
systems.
This is especially useful for deployment systems that do not have
software development tools.
The updated
DPT4 Software Installation Instructions contain details on this feature
(see step 8 of the "DPT4 Software Installation for Solaris Sparc and Intel
Platforms and Linux Intel x86 Platforms").
The new package facility supercedes the older package facility
that only worked for packaging the Solaris device driver.
The older facility still exists (running "make package" in the the soldev
subdirectory) and has been fixed to work properly when using the pre-built
device driver.
Version 3.2 of the Gnu C compiler (gcc 3.2) has been tested on Solaris
and may be used to complie both the API library and the device driver.
The API library only supports compilation for 32-bit applactions.
However, GCC version 3.2 may be used to compile the device driver
with 64-bit code.
The configure script for the Soalris device driver recognizes GCC
version 3.2 (or higher) and will create a Makefile capable of using gcc
to build the DPT4 device driver.
Other changes in the Unix software configuration scripts and Makefiles include
various bug fixes.
The software configuration for Unix now searches for a version of the
readline or compatible library already installed on the system.
If one is found it will be used rather than building and installing
the readline library included with the CAC software distribution.
--with-readline=option
where option is one of:
Disabling the use of readline will disable some of the user interface
features of the dpdebug diagnostic program.
That is currently the only CAC provided application that makes use of the
readline facilities.
cac - force the use if the readline library provided by CAC
disable - disable the use of any readline library