View 2001664_292368.PDF datasheet online --- IC-ON-LINE

Datasheet File OCR Text:

SPECTRA-2488 (PM5315) Device Driver Release Notes
PM5315
SPECTRA-2488 DEVICE DRIVER
RELEASE NOTES
PROPRIETARY AND CONFIDENTIAL RELEASED ISSUE 2: NOVEMBER, 01
Proprietary and Confidential to PMC-Sierra, Inc., and for its Customers' Internal Use Document ID: PMC-2001664, Issue 2
SPECTRA-2488 (PM5315) Device Driver Release Notes
LEGAL INFORMATION
Copyright
(c) 2001 PMC-Sierra, Inc. All rights reserved. The information is proprietary and confidential to PMC-Sierra, Inc., and for its customers' internal use. In any event, you cannot reproduce any part of this document, in any form, without the express written consent of PMC-Sierra, Inc. PMC-2001664 (R2)
Disclaimer
None of the information contained in this document constitutes an express or implied warranty by PMC-Sierra, Inc. as to the sufficiency, fitness or suitability for a particular purpose of any such information or the fitness, or suitability for a particular purpose, merchantability, performance, compatibility with other parts or systems, of any of the products of PMC-Sierra, Inc., or any portion thereof, referred to in this document. PMC-Sierra, Inc. expressly disclaims all representations and warranties of any kind regarding the contents or use of the information, including, but not limited to, express and implied warranties of accuracy, completeness, merchantability, fitness for a particular use, or non-infringement. In no event will PMC-Sierra, Inc. be liable for any direct, indirect, special, incidental or consequential damages, including, but not limited to, lost profits, lost business or lost data resulting from any use of or reliance upon the information, whether or not PMC-Sierra, Inc. has been advised of the possibility of such damage.
Proprietary and Confidential to PMC-Sierra, Inc., and for its Customers' Internal Use Document ID: PMC-2001664, Issue 2
2
SPECTRA-2488 (PM5315) Device Driver Release Notes
Contacting PMC-Sierra
PMC-Sierra 8555 Baxter Place Burnaby, BC Canada V5A 4V7 Tel: +1-604-415-6000 Fax: +1-604-415-6200 Document Information: document@pmc-sierra.com Corporate Information: info@pmc-sierra.com Technical Support: apps@pmc-sierra.com Web Site: http://www.pmc-sierra.com
Proprietary and Confidential to PMC-Sierra, Inc., and for its Customers' Internal Use Document ID: PMC-2001664, Issue 2
3
SPECTRA-2488 (PM5315) Device Driver Release Notes
REVISION HISTORY
Issue No. 1 2 Issue Date Nov 2000 Nov 2001 Details of Change Document created Updated for production release
Proprietary and Confidential to PMC-Sierra, Inc., and for its Customers' Internal Use Document ID: PMC-2001664, Issue 2
4
SPECTRA-2488 (PM5315) Device Driver Release Notes
1
ABOUT THIS RELEASE
This is release rel-1.0 of the PM5315 (SPECTRA-2488) device driver. Rel-1.0 is intended for use with PM5315 Revision A and B SPECTRA-2488 devices. Rel-1.0 is functionally complete and has been tested by PMC-Sierra as described in Section 4 below.
2
WHAT'S INCLUDED IN THIS RELEASE
This rel-1.0 release of the SPECTRA-2488 driver includes the following files: Directory
/src
Filename
spe2488_api1.c spe2488_api2.c spe2488_hw.c spe2488_isr.c spe2488_prof.c spe2488_rtos.c spe2488_stat.c spe2488_util.c
File Version 1.18 1.43 1.5 1.14 1.3 1.2 1.14 1.17 1.21 1.18 1.2 1.8 1.6
/inc
spe2488_api.h spe2488_defs.h spe2488_err.h spe2488_fns.h spe2488_hw.h
Proprietary and Confidential to PMC-Sierra, Inc., and for its Customers' Internal Use Document ID: PMC-2001664, Issue 2
5
SPECTRA-2488 (PM5315) Device Driver Release Notes
Directory
/inc
Filename
spe2488_rtos.h spe2488_strs.h spe2488_typs.h
File Version 1.4 1.13 1.3 1.10 1.5 1.6 1.3 1.10 n/a n/a
/example
spe2488_app.c spe2488_app.h spe2488_debug.c spe2488_debug.h
/ / /
Makefile software.lic spe2488_relnotes_r2.pdf
(this file)
Notes: 1. spe2488_app.c, spe2488_app.h contain example callback function implementation and example code. 2. spe2488_debug.c, spe2488_debug.h contain an example debugging task that reports register accesses to the device.
Proprietary and Confidential to PMC-Sierra, Inc., and for its Customers' Internal Use Document ID: PMC-2001664, Issue 2
6
SPECTRA-2488 (PM5315) Device Driver Release Notes
3
INSTALLATION
Please perform the following steps to install the PM5315 (SPECTRA-2488) device driver in your system. * Unzip the release zip file, and install the files and its directory structure under your local drive. Modify the directory variable names in the Makefile, if necessary, to reflect your actual driver and directory names. Modify spe2488_typs.h, spe2488_hw.h and spe2488_rtos.h as per your system's characteristics. Also, modify/implement the hardware and RTOS dependent functions in spe2488_hw.c and spe2488_rtos.c. Please refer to Section 8 of the SPECTRA-2488 driver manual (PMC-2001285, Issue 2), Porting the SPECTRA-2488 driver, for detailed instructions on porting the driver to your specific environment. Set up compile switches or other environment variables in the Makefile. Please refer to the Makefile for a detailed description of the available compile switches. Compile the source files and build the SPECTRA-2488 driver using your make utility. Link the SPECTRA-2488 driver to your application code.
*
* * *
4
TESTING STATUS OF THIS RELEASE
All SPECTRA-2488 device driver Application Programming Interface (API) functions have been tested in-house using the PM5315 on a proprietary PMC-Sierra, Inc. validation platform running VxWorksTM RTOS. As of the publication date of this document, there are no known bugs in this release. However, the customer is advised to consult our web site (http://www.pmc-sierra.com) for any relevant errata that may have been issued subsequent to the publication of this document.
5
WHAT'S NEW IN THIS RELEASE?
rel-1.0: Production release for the PM5315 device driver
* * Fixed parameter validation in spe2488ReadBlock and spe2488WriteBlock APIs. Added two new API functions to retrieve device status and counts on a per-port basis: spe2488GetStatusStm4 and spe2488GetCntStm4. They provide a way to retrieve device status and counts when the device is used in QUAD mode and at least one port is not being used. Use of the new API functions lifts a limitation of spe2488GetStatus and spe2488GetCnt, which try and fail to access the indirect registers corresponding to the unused ports, therefore removing unnecessary code latency in this kind of setup. This limitation has been documented as a side effect in the function headers of spe2488GetStatus and spe2488GetCnt.
Proprietary and Confidential to PMC-Sierra, Inc., and for its Customers' Internal Use Document ID: PMC-2001664, Issue 2
7
SPECTRA-2488 (PM5315) Device Driver Release Notes
*
Fixed offset calculations in statSpe2488GetCntXX functions where an incorrect register offset was used to poll the TIP bit, as well as in statSpe2488GetStatusTAPI where an incorrect offset was used to retrieve device status from TAPI. Fixed a bug in spe2488GetStatus where statSpe2488GetStatusRRMP was called with an incorrect statLOH field. Added additional required steps in spe2488DiagSysSideLineLoop to configure systemside line loopbacks as documented in the latest hardware data sheet. Added additional required steps in spe2488DiagLineSideLineLoop to configure lineside line loopbacks as documented in the latest hardware data sheet. Removed support for spe2488DiagSysSideSysLoop as this is no longer supported by the device. Software workarounds for Revision B devices have been added. Please refer to Section 6 for details.
* * * * *
6
WORKAROUNDS FOR DEVICE ERRATA
The SPECTRA-2488 driver performs software workarounds only for the applicable revision of the device, i.e., the driver performs Revision A workarounds only on Revision A devices and Revision B workarounds only on Revision B devices. Any exception to this rule is explicitly stated. The SPECTRA-2488 driver includes these workarounds by default so that it is compatible with all revisions of the device.
6.1
Workarounds for Revision A devices
The PM5315 (SPECTRA-2488) device driver performs the following workarounds for the device errata for PM5315 Revision A devices. The reader is referred to the PM5315 SPECTRA-2488 Revision A Device Errata (PMC- 2001834, Issue 2) for a detailed description of the device errata. * For the SPECTRA-2488 device issue where the receive SVCA is sensitive to mode transition from slave to master, a workaround is provided to force an NDF generation after the receive SVCA is configured. For the SPECTRA-2488 device issue where the DLL might lock to an invalid clock reference after a chip reset, a workaround is provided that resets the DLL after a software chip reset is performed.
*
Proprietary and Confidential to PMC-Sierra, Inc., and for its Customers' Internal Use Document ID: PMC-2001664, Issue 2
8
SPECTRA-2488 (PM5315) Device Driver Release Notes
6.2
Workarounds for Revision B devices
The SPECTRA-2488 driver performs the following workarounds for the device errata for PM5315 Revision B devices. The reader is referred to the PM5315 SPECTRA-2488 Revision B Device Errata (PMC-2001834, Issue 3) for a detailed description of the device errata. * For the SPECTRA-2488 device issue where the receive SVCA is sensitive to mode transition from slave to master, a workaround is provided to force an NDF generation after the receive SVCA is configured. Note this is the same erratum and workaround as that for Revision A devices described in section 6.1
Proprietary and Confidential to PMC-Sierra, Inc., and for its Customers' Internal Use Document ID: PMC-2001664, Issue 2
9

▲Up To Search▲

Price & Availability of 2001664

	To Download 2001664 Datasheet File
If you can't view the Datasheet, Please click here to try to view without PDF Reader .