This section describes the in field procedure for upgrading the HiperMAX Software Defined Radio (SDR) blade Intelligent Platform Management Controller (IPMC) firmware. The document covers upgrading the code on the ATCA specific chipset residing on the SDR blade to allow it to work in the ATCA shelf not the code that runs on the SDR blade to enable WiMAX functionality. The SDR IPMC Firmware upgrade is for both commissioned and non-commissioned HiperMAX base stations It will not normally be required as ATCA functionality changes rarely. The upgrade process consists of 3 discrete steps as follows:
Assigning an IP address to the shelf manager. It is anticipated that this step will have already been performed for a commissioned base station, and the shelf manager will be contactable via telnet and ftp.
Installing the upgrade utility and firmware release on the shelf manager.
Performing the actual firmware upgrade.
For a new Shelf a serial connection is used to provide a local access terminal (LAT). It is only required if the Shelf Managers IP address needs setting/changing. Otherwise the whole process can be completed via Ethernet. This allows manipulation of the shelf manager at all levels including the boot prompt, Linux command line and the shelf manager command line interface. For details on connection see Connecting to Shelf Manager.
At this point the shelf manager can now be physically attached to the network via Ethernet cable to the port on the shelf manager front panel.
For a new Shelf a serial connection is used to provide a local access terminal (LAT). This allows manipulation of the shelf manager at all levels including the boot prompt, Linux command line and the shelf manager command line interface. Connecting to Shelf Manager.
At this point the shelf manager can now be physically attached to the network via Ethernet cable to the port on the shelf manager front panel.
Once the shelf manager is visible on the network, the tools necessary to perform the upgrade and the firmware itself may be transferred to the shelf manager.
It is not possible to predict the location at which a customer will store a released firmware upgrade, so it is assumed here that it is in the current working directory of a PC and the PC’s command line interface can log onto an ftp server running on the Shelf manager. The following steps will copy the necessary files to the shelf manager:
<local host prompt>: ftp <shelf manager ipaddress>
user : ftp
password : ftp
230 Guest login ok, access restrictions apply.
Remote system type is UNIX.
Using binary mode to transfer files.
ftp> cd /tmp
250 CWD command successful.
ftp> bin
200 Type set to I.
ftp> put upgradefw.500
local: upgradefw.500 remote: upgradefw.500
200 PORT command successful.
150 Opening BINARY mode data connection for upgradefw.500.
226 Transfer complete.
35616 bytes sent in 0.02 secs (1695.7 kB/s)
ftp> put upgrade.img
local: upgrade.img remote: upgrade.img
200 PORT command successful.
150 Opening BINARY mode data connection for upgrade.img.
226 Transfer complete.
57295 bytes sent in 0.03 secs (1661.8 kB/s)
ftp> quit
221-You have transferred 92911 bytes in 2 files.
221-Total traffic for this session was 93564 bytes in 2 transfers.
221-Thank you for using the FTP service on sentry.
221 Goodbye.
<local host prompt>:
The upgrade utility and firmware image will now reside in the /tmp directory of the shelf manager and may be used to perform the upgrade itself. Note, space on the shelf manager file system is limited, and it may not be possible to hold more than one copy of the upgrade image at any given time.
In order to perform the upgrade, we need to determine the IPMB (Intelligent Platform Management Bus) Addresses of the SDRs which require firmware upgrade. It is assumed here that the SDRs are inserted and properly seated in a shelf slot. The example which follows shows the upgrade of a single SDR IPMC in the primary master slot.
If it is know that all SDRs in a given shelf require upgrade, the following tables may be used to determine IPMB addresses for 14 and 5 slot chassis:
14 slot Shelf
|
Physical Slot |
1 |
2 |
3 |
4 |
5 |
6 |
7 |
|
H/W Address |
0x4D |
0x4B |
0x49 |
0x47 |
0x45 |
0x43 |
0x41 |
|
IPMB Address |
0x9A |
0x96 |
0x92 |
0x8E |
0x8A |
0x86 |
0x82 |
|
Physical Slot |
8 |
9 |
10 |
11 |
12 |
13 |
14 |
|
H/W Address |
0x42 |
0x44 |
0x46 |
0x48 |
0x4A |
0x4C |
0x4E |
|
IPMB Address |
0x84 |
0x88 |
0x8C |
0x90 |
0x94 |
0x98 |
0x9C |
5 Slot shelf
|
Physical Slot |
1 |
2 |
3 |
4 |
5 |
|
H/W Address |
0x41 |
0x42 |
0x43 |
0x44 |
0x45 |
|
IPMB Address |
0x82 |
0x84 |
0x86 |
0x88 |
0x8A |
N.B. It is recommended that individual SDR IPMC firmware upgrades are performed in a serial manner to avoid confusion.
If it is known that all SDRs in the shelf require IPMC firmware upgrade, this section may be skipped.
To determine the blade population and firmware versions, it is necessary to log on to the shelf manager and submit a query to obtain this information. This is achieved thus:
<local host prompt>: telnet <shelf manager ipaddress>
Trying <shelf manager ipaddress>...
Connected to <shelf manager ipaddress>.
Escape character is '^]'.
BusyBox on sentry login: root
Password:
Welcome to μClinux
BusyBox v0.60.5 (2004.10.20-19:22+0000) Built-in shell (msh)
# clia ipmc -v (Note: Alternative commands can be used to just query a specific slot e.g. to just look at the Primary Master in slot 9 use: 'clia ipmc 86 –v'. See table above.)
Lots of output would be produced here, but for clarity, this document only captures that of the Primary Master SDR.
86: Entity: (0xa0, 0x60) Maximum FRU device ID: 0x01
PICMG Version 2.1
Hot Swap State: M4 (Active), Previous: M3 (Activation In Process), Last State Change Cause: Normal State Change (0x0)
Device ID: 0x12, Revision: 0, Firmware: 1.18, IPMI ver 1.5
Manufacturer ID: 00400a, Product ID: bebe, Auxiliary Rev: 00000000
Device ID String: "Airspan SDR-A-1"
Global Initialization: 0xc, Power State Notification: 0xc, Device Capabilities: 0x29
Controller provides Device SDRs
Supported features: 0x29
"Sensor Device" "FRU Inventory Device" "IPMB Event Generator"
It can be seen that the Primary Master SDR has an IPMB address of 0x86, and that it is at firmware level 1.18. If this is the correct level, nothing need be done. Otherwise, the upgrade should be performed. The following shows the upgrade command for the primary master in slot 9 (Ox86) There is no need to log off the shelf manager from the previous step.
# cd /tmp
# ./upgradefw.500 -I /dev/i2c1:86 upgrade.img
BMR-AVR firmware upgrade utility. Pigeon Point Systems (c) 2004.
Upgrade interface: IPMB, device: /dev/i2c1, options: 86
Firmware upgrade image: upgrade.img
Preparing Master AVR for programming ................. OK
Programming xxxxx bytes to Master AVR at 000000 ... 100%
Preparing Slave AVR for programming ... OK
Programming xxxx bytes to Slave AVR at 000000 ... 100%
#
The upgrade is now complete. This may be verified with ‘clia ipmc -v’ (Note: Alternative commands can be used to just query a specific slot e.g. to just look at the Primary Master in slot 9 use: 'clia ipmc 86 –v'), as above, from the shelf manager command line.