                  FRUSDR Loader Utility - Release Notes
               Copyright (c) 2006 Intel Corporation
                          All Rights Reserved
                            April 11,2006


The FRUSDR Load Utility is an EFI application program used for updating the 
server management subsystem product level Field Replacement Unit (FRU) and 
Sensor Data Repository (SDR).

This utility is used to update the non-volatile storage device associated 
with the Baseboard Management Controller (BMC), which holds the SDR & FRU 
area. The utility has the capability to generically handle FRU devices that
may not be associated with the BMC.

RELEASE NOTES FOR FRUSDR LOADER UTILITY VERSION 2.1 

A. CHANGES SINCE THE PREVIOUS VERSION 2.1 RC1

   1. Fixed Trackers SSBU Tracker#28250, 28251.
   2. Version change has been made.

B. DEPENDENCIES

   1. Executes under the EFI Shell ver 0.99 or greater.
   2. IPMI driver is required.

C. SUPPORTED PLATFORMS

   1. SR870BN4
   2. SR870BH2

D. HOW TO USE THIS UTILITY

   The FRUSDR Loader is meant to be used as an EFI application on an Itanium(TM)
   server. The utility should be placed onto a floppy or hard drive and the 
   system rebooted prior to and after using. There is no need to actually install 
   the application on to a server. Running the utility from within an operating
   system is not supported and will provide incorrect results. 

   The FRUSDR Loader command line provides the following options:

   Usage: 
      /? or /H          Displays detailed usage information
      /D SDR            Displays the Sensor Data Records
      /D FRU [Address]  Displays the FRU located at a given Address
      /CFG [Filename]   Uses the specified custom configuration file
      /p                Pauses the display between blocks of data  

   (a) Update the SDR records

       1. Boot to EFI shell.

       2. Copy the entire FRUSDR package files to an LS120 or HD:

       3. Execute FRUSDR utility as follows

               FS0:>FRUSDR /CFG <filename>

       4. To update the SDR records, select 1 - Load the SDR records.

   (b) Display SDR Information

       The SDR area can be displayed by using the /D SDR parameter with the FRUSDR 
       Command. To display the SDR records from the non-volatile repository:

         FS0:> FRUSDR /D SDR 

   (c) Display FRU Information

       The /D FRU command displays the FRU located at a given Address. 
       The Addressing mode may be "Indirect" or "Direct".

       Indirect: FRUSDR /D FRU [NVS_TYPE | DEV_CNTR | NVS_LUN | DEV_ID]
       Direct:   FRUSDR /D FRU [NVS_TYPE | DEV_CNTR | NVS_LUN | DEV_BUS | DEV_ADDR]
 
       NVS_TYPE - The type of EEPROM, { AT24C02, DS1624S, or IMBDEVICE (default) }
       DEV_CNTR - Controller's Address; defaults to 'C20'. Must be prefixed by 'C'.
       NVS_LUN  - The LUN; defaults to 'L00'. Must be prefixed by 'L'.
       DEV_ID   - The Device ID; defaults to 00. Used only if NVS_TYPE is IMBDEVICE.
       DEV_BUS  - The Device's bus; has no default value.
       DEV_ADDR - The Device's address; has no default value.

       The DEV_BUS and DEV_ADDR are required only if NVS_TYPE is not IMBDEVICE.
       If DEV_CNTR is specified, it must be 3 characters in length, including 
       the 'C'. All numbers entered for DEV_CNTR, DEV_ID, DEV_BUS, and DEV_ADDR are
       interpreted as hexadecimal values, in the range 0 - FF; LUN must be 0, 1, 2 
       or 3. The command line arguments may be specified in any order, and if one of
       the arguments is not specified then its default value will be used, if it has
       one. However, if DEV_BUS and DEV_ADDR are specified, DEV_BUS is assumed to be 
       first. If no arguments are specified for [Address] then the BMC FRU will be 
       displayed.

       Examples: FRUSDR /D FRU 
                 FRUSDR /D FRU IMBDEVICE 00
                 FRUSDR /D FRU IMBDEVICE C20 L00 00
                 FRUSDR /D FRU AT24C02   09 AA
                 FRUSDR /D FRU AT24C02   C20 09 AA
                 FRUSDR /D FRU DS1624S   C20 05 90

       See the device's FRU file to determine the NVS_TYPE, DEV_CNTR, NVS_LUN, 
       DEV_BUS DEV_ADDR, and DEV_ID required to address the device.

   (d) FRU Field Lengths

       If a user is going to develop their own Configuration, FRU or SDR files, then 
       they need a thorough understanding of FRU areas and lengths. That discussion 
       is beyond the scope of this document. Although, only a basic understanding of 
       how the FRUSDR application uses FRU files is needed before one modifies 
       information in a FRU field via a configuration file prompt.

       The governing FRU format and specifications do not specify a 
       maximum FRU field length. However, a length constraint does exist due to the 
       limited amount of space available in the Non-Volatile Storage device 
       containing these items. These maximum lengths are artificial since, if all 
       strings were of the maximum length, the FRU file would overflow the FRU area. 
       Therefore, the true maximum field length is actually controlled by the space 
       available to the FRU file. 

       As a rule, the length defined in the header of the FRU file and the sizes 
       defined in each FRU area of the FRU file must not be altered. These were 
       originally chosen so that the FRU file would fit into the FRU area. Often 
       each FRU area does contain a certain amount of padding, which will allow an 
       increase in the length of some strings. To be on the safe side, if FRU 
       strings are modified, they should be kept at the same length as the current 
       string in that FRU area. For fields such as the Asset Tag, for which data may 
       not exist to fill the field, the length should be kept to as few characters 
       as needed, not to exceed 31 characters.

   (e) Documentation

       Additional information on the FRUSDR Loader may be found in the Product 
       Manual, the FRUSDR Loader EPS (External Product Specification), and in 
       the FRUSDR Configuration file developers guide.

E. Errata Items and Firmware Dependancy

   NONE

F. PACKAGE VERSIONS

   Each version of the FRUSDR Loader Utility package contains the FRUSDR Loader
   utility program as well as the latest FRU, SDR, and CFG files available at the
   time the FRUSDR Package is released.  The package version number is a three 
   digit number, (x.y.z), where the first digit (x) specifies the major version 
   of the utility, the second digit (y) specifies the minor version of the
   utility, and the third digit(z) specifies the version of the package.


*  Third-party brands and names are the property of their respective owners. 
