============================
R E L E A S E N O T E S
============================
Broadcom Network Controller Firmware Upgrade Utility
for Windows NT 4.0, Windows 2000, XP
.NET 2003 Server 23/64 bit
Version 1.0.8
Copyright (c) 2002 Broadcom Corporation
All rights reserved.
Feb. 24, 2003
Revision History
================
6.0.1:
- Fix CQ7103: Unable to upgrade ASF firmware (non-interactive mode)
eventhough NDIS driver version is greater than 3.28.
The problem is caused by the WinFWUpg not getting driver version
number in non-interactive mode. It is fixed in this version.
6.0.0:
- Support .NET Server 2003 32/64 bit environment.
- 'asfprg' command requires driver 3.28 or later.
1.0.7:
- Support ASF on 5705.
1.0.6:
- Require BMAPI v3.0.3.
- Support ASFCFG version 5.
- Fix:
4938: WinFWUpg help menu needs correction on certain words.
1.0.5:
- Fix:
4931: WinFwUPG does not check for file before erasing current ASF firmware
4932: WinFWUpg does NOT upgrade bootcode when the firmware upgrade process
requires NVRAM gap cleaning routine.
1.0.4:
- Add MAC address as one of method to select target adapter from command
line parameters.
- 'restorenvram' accepts option to restore complete image except MAC address.
- Fix:
4887: sechksum command needs to allow user to correct (update) EEPROM
checksum as stated in the help menu.
4885: 'Following' and 'complete' are misspelled as 'Fowllowing' and
'compelete' in help menu..
1.0.3:
- Take out commands (erase, seread, sewrite) that are for development
purposes.
- Parameters of 'seread' and 'sewrite' are changed to all hexdecimal.
1.0.2:
- Require network adapter driver 2.78 or later.
- Add to support command line for 'upgfrm', 'asfprg', 'dumpnvram' and
'restorenvram'.
- Add exit code definition. Please refer to 'General Information' section.
Initial Release
------------------
- Require BMAPI v2.2.19 or later.
- Support Broadcom 570x network adapters only.
- Require network adapter driver 2.67 or later.
- Support boot code and PXE upgrade. ASF firmware update is not supported.
==============================================================================
General Information
==============================================================================
1. Information
This utility is a Win32 console application. Users could run it from a
Windows command prompt. The application will use the console and interact
with users.
When calling the utility from another process and use the utility as a command
line tool, the utility will take command from parameters return appropriate
exit code to indicate result of the command. If the calling process do not
want Windows to pop up a console window, it could use Windows API to make
OS not to pop up the console window. For example, the calling process could
use 'CREATE_NO_WINDOW' flag in CreateProcess() API when create the process.
2. Command line usage
Usage:
WinFWUpg.exe [service_name | MAC] [Commands]
'service_name' is the service name of the NIC in the system. For example,
{188AC7E8-5000-4575-B826-6042FB944A5E} is a valid service name in w2k.
'MAC' is the MAC address name of the NIC in the system. For example,
'00-10-18-00-11-99' is a valid MAC address from 'ipconfig' utility. Use
'001018001199' as an input parameter to select the NIC.
[Commands] could be one of following:
upgfrm {pxe | boot} new_image save_image
This command reads code from a file and program into pxe or boot area.
All parameter, the programming target 'pxe' or 'boot' and two filenames,
must be specified.
'new_image' is the pxe or boot code image file.
'save_image' is the file to save current complete NVRAM image.
asfprg [init_img [rx_img [tx_img]]]
The default files names are asfinit.bin, asfcpua.bin, and asfcpub.bin,
which can be over written by parameters.
restorenvram filename [config [mac]] [force | verify]
This command reads complete NVRAM image from a file and write to NVRAM.
Before write the NVRAM image to adapter, checksum verifications against
source NVRAM image will be performed. If any verification failed, the
image will not be written to adapter. Whole source image will be copied
into NVRAM except configuration area.
'filename' is the file name of NVRAM image.
'config' means configuration area will copy from source image except MAC
address. Configuration area includes MAC address and various options.
'mac' applies only when 'config' is specified. When 'mac' is specified,
all configuration are copied including MAC address.
'force' flag will skip all verification against source NVRAM image.
'verify' flag will do all verification against source NVRAM image and
will not write the image to adapter.
dumpnvram filename
This command reads complete NVRAM content and save to a file.
'filename' is the file name of NVRAM image.
3. Exit Code on Process Termination
#define WFWUPG_OK 0 // Upgrade firmware OK
#define WFWUPG_PARAM_ERROR 2 // Not correct parameters
#define WFWUPG_NOT_CORRECT_TARGET 3 // Not correct target. It
// must be 'pxe' or 'boot'
#define WFWUPG_CANNOT_READ_NVRAM 4 // Cannot read NVRAM
#define WFWUPG_FAILED_GET_NVRAM_SIZE 5 // Cannot get NVRAM size
#define WFWUPG_CANNOT_GET_HANDLE 6 // Cannot get NIC handle
#define WFWUPG_ADAPTER_NOT_FOUND 7 // Adapter not found
#define WFWUPG_CANNOT_LOCK_ADAPTER 8 // Cannot lock adapter
#define WFWUPG_FAILED_GET_PXE_INFO 9 // Failed to get PXE
// information
#define WFWUPG_FAILED_CREATE_NVRAM_IMAGE_FILE 10 // Failed to create NVRAM
// image file
#define WFWUPG_FAILED_WRITE_NVRAM_IMAGE_FILE 11 // Failed to write to
// NVRAM image file
#define WFWUPG_GET_CLOSE_EVENT 12 // Get close event
#define WFWUPG_FAILED_READ_NVRAM_FILE 13 // Failed to read NVRAM
// image file
#define WFWUPG_INIT_FAILED 14 // Initialization failed
#define WFWUPG_UNSUPPORTED_BMAPI_VER 15 // BMAPI is too old
#define WFWUPG_NIC_NOT_SUPPORTED 16 // NIC is not supported
#define WFWUPG_UNKNOWN_COMMAND 17 // Unknown command
#define WFWUPG_NVRAM_WRITE_FAILED 18 // NVRAM update failed
#define WFWUPG_WONRG_NVRAM_FILE_SIZE 19 // NVRAM image file size
#define WFWUPG_NVRAM_IMAGE_CHKSUM_FAILED 20 // NVRAM image file
// checksum failed
#define WFWUPG_NVRAM_CHKSUM_FAILED 21 // NVRAM checksum failed
#define WFWUPG_NVRAM_IMAGE_FILE_DEVID_MISMATCH 22 // device ID in NVRAM image
// file does not match NIC
#define WFWUPG_ASF_NOT_SUPPORTED_BY_BOOTCODE 23 // ASF is not supported by
// the bootcode firmware
#define WFWUPG_ASF_NOT_SUPPORTED_BY_NIC 24 // ASF is not supported by
// the NIC hardware
#define WFWUPG_DIR_FULL 25 // No NVRAM directory entry
// available
#define WFWUPG_INVALID_NVRAM_FILE 26 // Incorrect NVRAM file
// format
#define WFWUPG_NVRAM_FULL 27 // not enough NVRAM space
#define WFWUPG_DIR_NOT_SUPPORTED 28 // Directory is not
// supported by bootcode
#define WFWUPG_NVRAM_CORRUPTED 29 // NVRAM corrupted
#define WFWUPG_DIR_NOT_FOUND 30 // a directory entry is
// not found
#define WFWUPG_DIR_UPDATE_FAILED 31 // Update NVRAM directory
// failed
#define WFWUPG_DIR_FOUND 32 // a directory entry is
// found
#define WFWUPG_CANNOT_READ_MEM 33 // Cannot read NIC register
// or memory
#define WFWUPG_MALLOC_ERROR 34 // memory allocation error
4. Dependency
This module is dependent on BMAPI module and device driver for firmware access.
Download Driver Pack
After your driver has been downloaded, follow these simple steps to install it.
Expand the archive file (if the download file is in zip or rar format).
If the expanded file has an .exe extension, double click it and follow the installation instructions.
Otherwise, open Device Manager by right-clicking the Start menu and selecting Device Manager.
Find the device and model you want to update in the device list.
Double-click on it to open the Properties dialog box.
From the Properties dialog box, select the Driver tab.
Click the Update Driver button, then follow the instructions.
Very important: You must reboot your system to ensure that any driver updates have taken effect.
For more help, visit our Driver Support section for step-by-step videos on how to install drivers for every file type.