Upgrading Field Programmable Hardware Devices for Cisco ASR 1000 Series Routers
Upgrading Field Programmable Hardware Devices Overview
Displaying Incompatible CPLD Version
Displaying the Current Field Programmable Device Version
CPLD Field Programmable Upgrade, Cisco IOS XE Release 3.1S
CPLD Field Programmable Upgrade Overview
Upgrading an Active Cisco ASR1000-RP2 or Cisco ASR1000-RP3
Upgrading a Standby Cisco ASR1000-RP2 or Cisco ASR1000-RP3
Upgrading a Cisco ASR1000-SIP10
Unsupported ASR1000-RP2 and ASR1000-SIP10 Scenarios
Unsupported Active ASR1000-RP2 Requires Upgrade
Unsupported Standby ASR1000-RP2 or ASR1000-SIP10 Requires Upgrade
Field Programmable Hardware Devices Commands
FPGA Field Programmable Upgrade, Cisco IOS XE Release 3.10S
FPGA Field Programmable Upgrade Overview
Scenarios When Upgrade is Required
Upgrading FPGA on ASR1001-X, ASR1002-HX, and ASR1001-HX
Link to Download Latest HW-Programmables Package
Upgrading Cisco ASR 1000 Ethernet Line Card
Example: FPGA Field Programmable Logs
CPLD and FPGA Field Programmable Upgrade, Cisco IOS XE Release 17.2.1r
CPLD and FPGA Field Programmable Upgrade Overview
Upgrading CPLD of Cisco ASR 1000-ESP100-X and ASR 1000-ESP200-X
Upgrading FPGA of Cisco ASR 1000-ESP100-X and ASR 1000-ESP200-X
Sample Logs after Upgrading CPLD and FPGA
Example: Sample CPLD Field Programmable Logs
Example: FPGA Field Programmable Logs
First Published: July 30, 2010
Last Revised: January 19, 2017
Beginning with Cisco IOS XE Release 3.1.0S, Cisco ASR 1000 Series Routers have the capability to allow users to perform upgrades in the field on programmable hardware devices. Field programmable hardware devices include the Complex Programmable Logic Device (CPLD) and the field programmable gate array (FPGA). This document describes the procedures to perform an upgrade on a field programmable hardware device.
For the latest feature information and caveats, see the release notes for your platform and software release. To find information about the features documented in this module, and to see a list of the releases in which each feature is supported, see the “Feature Information” section.
Use Cisco Feature Navigator to find information about platform support and Cisco IOS XE software image support. To access Cisco Feature Navigator, go to http://www.cisco.com/go/cfn. An account on Cisco.com is not required.
This document includes the following sections:
If the Cisco ASR 1000 Series Router contains an old version of the hardware programmable firmware on the Cisco ASR1000-RP, Cisco ASR1000-SIP, or Cisco ASR1000-ESP, then that hardware programmable firmware may need to be upgraded. To do this upgrade, a hardware programmable package, asr1000-hw-programmables.<release_name>.pkg, is released to customers.
Generally an upgrade is only necessary in cases where a system message indicates one of the field programmable devices on the Cisco ASR 1000 Series Routers needs an upgrade or a Cisco technical support representative suggests an upgrade.
In Cisco IOS XE Release 3.1.0S and later, a CPLD field upgrade is required to support old versions of firmware on Cisco ASR1000-RP2 and Cisco ASR1000-SIP10 modules in the Cisco ASR 1013 Router. See the “CPLD Field Programmable Upgrade, Cisco IOS XE Release 3.1S” section for upgrade procedures you can use in the field.
If you received an error message indicating the field programmable device needs an upgrade and your cards are held in reset or your standby RP or SIP10 has powered down, you have an incompatible CPLD version on the device. Use the show platform command to display the state of your active and RPs and SIP carrier cards.
The following example shows that the Cisco ASR1000-SIP10 has a state of “cpld_incompatible” that means the SIP10 has an older, incompatible CPLD version and will require an upgrade to be compatible with the Cisco ASR 1013 Router.
For more information on performing an upgrade o f the CPLD firmware, see the “CPLD Field Programmable Upgrade, Cisco IOS XE Release 3.1S” section.
You can use the show hw-programmable command to display the current version of CPLD and FPGA running on any RP, ESP, or SIP card in your Cisco ASR 1000 Series Router.
Note The versions in this example are provided for illustrative purposes only.
This section covers the following topics:
In Cisco IOS XE Release 3.1.0S and later, a CPLD field upgrade is required to upgrade old versions of firmware on Cisco ASR1000-RP2 and Cisco ASR1000-SIP10 components in the Cisco ASR 1013 Router. These hardware components are not compatible when inserted in the Cisco ASR 1013 Router because they contain an older CPLD version.
If you want to reuse existing Cisco ASR1000-RP2 and Cisco ASR1000-SIP10 components in the Cisco ASR 1013 Router, you must perform a CPLD field programmable upgrade on these components. If an incompatible component is inserted into the Cisco ASR 1013 Router, Cisco software detects out-of-revision hardware. The next sections describe how to upgrade the out-of revision hardware components in the Cisco ASR 1013 Router.
If out-of-revision hardware is detected, you will receive the following types of error messages notifying you of the out-of-revision component:
For an incompatible active ASR1000-RP2:
For an incompatible standby ASR1000-RP2:
For an incompatible Cisco ASR1000-SIP10:
To corroborate or determine if one of the components has an incompatible CPLD version, you can use the show platform command. See the “Displaying Incompatible CPLD Version” section.
Note No CPLD upgrade is necessary for the Cisco ASR1000-ESP40 and Cisco ASR1000-SIP40.
If you have an incompatible Cisco ASR1000-RP2 or Cisco ASR1000-SIP10 components on your chassis, the active RP behaves differently than the standby RP or SIP10:
In Cisco IOS XE Release 3.1.0S, a hardware programmable package called “asr1000-hw-programmables.03.01.00.S.150-1.S.pkg” is released to customers in cases where a CPLD upgrade is required.
To down load the hardware programmable package from Cisco.com, log in to the Download Software page with your Cisco.com password at: http://www.cisco.com/cisco/web/download/index.html. In the “Select a Software Product Category,” select “Routers,” select a product such as “Service Provider Edge Routers,” select “Cisco ASR 1000 Series Aggregation Services Routers,” select “Cisco ASR 1013 Router,” select the “15.0(1)S” release, and then click on “Download Now.”
A CPLD upgrade using the downloaded image is only necessary in cases where a system message indicates one of the CPLDs on the Cisco ASR 1000 Series Routers needs an upgrade.
You can upgrade the CPLD firmware on the Cisco ASR1000-RP2 and Cisco ASR1000-SIP10 individually using the upgrade hw-programmable command. The CPLD upgrade can take up to ten minutes for each component or card. You can perform the upgrade on the Cisco ASR1000-RP2 and Cisco ASR1000-SIP10 at any time as long as you can access the privileged EXEC mode prompt on the router.
The following steps describe a Cisco ASR1000-RP2 or Cisco ASR1000-RP3 CPLD field upgrade on the Cisco ASR Router. In the example described in these steps, R0 is the active RP2. If R1 is the active RP, follow the same upgrade steps on R1.
Note If the active RP has an incompatible version—the active RP will hold the standby RP, SIP10, and ESP cards in reset, even if those cards have the latest CPLD version. The active RP will continue to run to allow you to upgrade the firmware.
Step 1 Cold boot the active RP.
Step 2 During bootup, if you receive the following error message:
This means that the active RP did the minimum CPLD version check and the check failed. All other cards are held in reset, even if they have the latest CPLD or FPGA version, and the active RP will continue to run to allow the user to upgrade the firmware.
Explanation of error message: The active RP requires a newer CPLD firmware to function properly in this chassis. You need to upgrade the CPLD firmware.
Note If you chose the option to perform the CPLD upgrade on a non-production Cisco ASR 1004 Router or Cisco ASR 1006 Router, you will not see this error message on those routers.
Step 3 Copy the hw-programmable upgrade package to your hard disk as follows:
To download this package from Cisco.com, log in with your Cisco.com password to: http://tools.cisco.com/support/downloads/go/Redirect.x?mdfid=268437899.
Step 4 Upgrade the active Cisco ASR1000-RP CPLD with the following command:
Step 5 The active Cisco ASR1000-RP CPLD firmware is upgraded successfully and you will receive the following success message:
Step 6 Power cycle the chassis.
Step 7 After the power cycle, the active RP reboots with the latest CPLD programmable firmware and comes online.
The following steps describe a Cisco ASR1000-RP2 or Cisco ASR1000-RP3 CPLD field upgrade on the Cisco ASR Router. In the example described in these steps, R1 is the standby RP. If R0 is the standby RP, follow the same upgrade steps on R0.
Step 1 When the standby RP starts booting, the active RP checks the CPLD version of the standby RP.
If the standby RP has an incompatible version, you receive the following error message and the standby RP is powered down:
Explanation of error message: The standby RP requires a newer CPLD firmware to function properly in this chassis. You need to upgrade the CPLD firmware.
Note If you chose the option to perform the CPLD upgrade on a Cisco ASR 1004 Router or Cisco ASR 1006 Router, you will not see this error message on those routers.
Step 2 Copy the hw-programmable upgrade package to your hard disk as follows:
To download this package from Cisco.com, log in with your Cisco.com password to: http://tools.cisco.com/support/downloads/go/Redirect.x?mdfid=268437899.
Step 3 Upgrade the standby RP with the following command:
Step 4 The standby RP is powered up and CPLD firmware on the standby RP is upgraded.
Step 5 After the upgrade is successful, you will receive the following success message in the active RP:
Step 6 The active RP power cycles the standby RP. The standby RP reboots with the latest CPLD programmable firmware and comes online.
The following steps describe a Cisco ASR1000-SIP10 CPLD field upgrade on the Cisco ASR 1013 Router. In the example described in these steps, slot 2 on the SIP10 is used for the upgrade. If another slot number (zero, 1, 3, or 4) is used for the upgrade, following the same upgrade steps for that slot number.
Note For the ASR1000-SIP10 CPLD upgrade, do not use slot 5. Use one of slots zero (0) through 4.
Step 1 When the Cisco ASR1000-SIP10 starts booting, the Cisco ASR1000-SIP10 relays the CPLD version to the active RP. If the SIP10 has an incompatible version, you receive the following error message:
This means that the active RP did the minimum CPLD version check and the check failed. SIP10 was powered down and the active RP logged the error message.
Explanation of error message: The SIP10 requires a newer CPLD firmware to function properly in this chassis. You need to upgrade the CPLD firmware.
Note If you chose the option to perform the CPLD upgrade on a non-production Cisco ASR 1004 Router or Cisco ASR 1006 Router, you will not see this error message on those routers.
Step 2 If you receive the additional error message:
This means that the Cisco ASR1000-SIP10 CPLD card is in slot 5 and has the older CPLD firmware that does not support a field upgrade on slot 5. You must move the card to a different slot before continuing the upgrade procedure.
Note If you chose the option to perform the CPLD upgrade on a non-production Cisco ASR 1004 Router or Cisco ASR 1006 Router, you will not see this error message on those routers.
Step 3 Copy the hw-programmable upgrade package to your hard disk as follows:
To download this package from Cisco.com, log in with your Cisco.com password to: http://tools.cisco.com/support/downloads/go/Redirect.x?mdfid=268437899.
Step 4 Upgrade the Cisco ASR1000-SIP10 CPLD in slot 2 with the following command:
Step 5 The Cisco ASR1000-SIP10 is powered up and CPLD firmware on it is upgraded.
Step 6 After the upgrade is successful, you will receive the following success message on the RP:
Step 7 The Cisco ASR1000-SIP10 reboots with the latest CPLD programmable firmware and comes online.
This section describes two scenarios where you would receive error messages and under what conditions when inserting a prior released ASR1000-RP2 or ASR1000-SIP10 with an incompatible CPLD version into a Cisco ASR 1013 Router.
This section describes what happens when an active Cisco ASR1000-RP2 with an older version of CPLD is inserted into the Cisco ASR 1013 Router. This section describes the error message, reason, and under what types of configuration an upgrade of CPLD firmware is required.
Active RP requires a newer CPLD firmware to function properly in this chassis.
Upgrade the CPLD firmware on this FRU using the upgrade hw-programmable CPLD filename pkg-file slot fru-slot command.
Configurations—When an Upgrade of CPLD Firmware Is Required
In order to use existing ASR1000-RP2 and ASR1000-SIP10 hardware components in a Cisco ASR 1013 router, you must perform a CPLD upgrade on the RP2 and SIP10 components (with older CPLD) if the following configurations occur:
This section describes what happens when a standby Cisco ASR1000-RP2 or Cisco ASR1000-SIP10 with an older version of CPLD is inserted into the Cisco ASR 1013 Router. The error message that displays at the console and the message explanation and recommended action are described.
This FRU requires a newer CPLD firmware to function properly in this chassis.
Upgrade the CPLD firmware on this FRU using the upgrade hw-programmable CPLD filename pkg-file slot fru-slot command.
You can use the following field programmable commands to perform a CPLD upgrade or display the package file version or display progress during the upgrade:
For command syntax and detailed information, see the Cisco IOS Interface and Hardware Component Command Reference at: http://www.cisco.com/en/US/docs/ios/interface/command/reference/ir_book.html
This section covers the following topics:
In Cisco IOS XE Release 3.10S and later, FRU FPGA field upgrade is required to upgrade old versions of FPGA on Cisco ASR 1000 Ethernet Line Cards. If the card FPGA version is less than the minimum required version for FPGA, then a message is displayed to upgrade to the latest FPGA version.
Download the image from the CCO website and copy it to USB or bootflash of the router which is scheduled for the upgrade.
Note Do not perform any power cycle or remove the power cable during the FPGA upgrade. If there is a power loss during the upgrade, it may result in corruption of the boot image and it may require RMA of the equipment.
Step 1 Copy the utility to USB or to bootflash: using FTP or TFTP.
Step 2 Save the current running configurations and backup it to bootflash.
Step 3 Change the configuration register to 0x0.
Step 4 Issue the router reload command and ensure that the Rommon prompt is displayed on the router.
Step 5 Initiate the upgrade using the following CLI.
a. If the Upgrade fails, retry the upgrade by issuing Yes to retry the upgrade.
b. After the retry, if the upgrade still fails, reach out to Cisco TAC for further assistance.
Step 6 Once the upgrade is complete, device power cycles automatically, and the rommon prompt is displayed to boot the IOS image.
Step 7 Once the IOS is up, verify that the FPGA images are upgraded to the latest version.
The latest HW-programmables package for ASR 1000 Ethernet Line Cards can be downloaded from the following link.
https://software.cisco.com/download/release.html?i=!y&mdfid=282450665&softwareid=283425232&release=15.4(3)S1&os=
1. Download the HW-programmables package from the following link and copy it to router's harddisk:
https://software.cisco.com/download/release.html?i=!y&mdfid=282450665&softwareid=283425232&release=15.4(3)S1&os=
2. Find the slot in which Cisco Ethernet Line Card is plugged in.
3. Upgrade the Cisco ASR 1000 Ethernet Line Card with the following command:
4. User will be asked to confirm if they really want to upgrade.
5. The new FRU FPGA will be programmed in the line card. Line card will then reload to successfully complete the upgrade process.
This section covers the following topics:
In Cisco IOS XE Release 17.2.1r and later, it is mandatory to upgrade old versions of CPLD and FPGA on Cisco ASR 1000-ESP100-X and ASR 1000-ESP200-X.
Upgrading the CPLD and FPGA involves the following high-level steps:
Step 1 Check if all the FRU’s are functional by using the show platform command.
a. Check the version of FPGA and CPLD on Cisco ASR 1000-ESP100-X and ASR 1000-ESP200-X by using the show hw-programmable all command.
b. If you are on ASR 1009-X/ASR-1006-X, the recommended version of FPGA is 1908010d,
c. If you are on ASR 1013, the recommended version of FPGA version is 19080510
For any of the supported platforms, the recommended version of CPLD is 20030413.
If the FPGA and CPLD versions are lower than what is recommended, it is strongly recommended to run the upgrade procedure.
Step 2 Upgrade the software image of the device to IOS XE 17.2.1r.
Step 3 Check the ROMmon version. If the ROMmon version is less than 16.12(8r), upgrade to 16.12(8r) from Cisco Software Downloads page. For details on upgrading ROMmon, see ROMmon upgrade guide.
Step 4 Download the IOS XE Hardware Programmable Devices Package from the following link and copy it to the router’s hard disk:
https://software.cisco.com/download/home/282450665/type/283425232/release/17.2.1
Step 5 Execute the process to update the CPLD and FPGA versions. For details see,Upgrading CPLD of Cisco ASR 1000-ESP100-X and ASR 1000-ESP200-Xand Upgrading FPGA of Cisco ASR 1000-ESP100-X and ASR 1000-ESP200-X.
Step 6 Verify that the FPGA and CPLD is upgraded using show hw-programmable all commands.
Step 1 Locate the slot in which ASR 1000 ESP 100-X and ASR 1000 ESP-200-X are plugged in.
Step 2 Upgrade CPLD ASR 1000 ESP 100-X and ASR 1000 ESP-200-X with the following command:
Step 3 Confirm that you want to proceed with the upgrade. The CPLD versions are upgraded and the ASR 1000 ESP 100-X and ASR 1000 ESP-200-X cards are reloaded to complete the upgrade process.
Step 1 Locate the slot in which ASR 1000 ESP 100-X and ASR 1000 ESP-200-X are plugged in.
Step 2 Upgrade FPGA of ASR 1000 ESP 100-X and ASR 1000 ESP-200-X FPGA with the following command:
Step 3 Confirm that you want to proceed with the upgrade. The FPGA versions are upgraded and the ASR 1000 ESP 100-X and ASR 1000 ESP-200-X are reloaded to complete the upgrade process.
The following sections provide references related to this function.
Table 1 lists the release history for this functionality on the Cisco ASR 1000 Series Routers.
For information on a feature in this technology that is not documented here, see the Cisco ASR 1000 Series Aggregation Services Routers Documentation Roadmap.
Use Cisco Feature Navigator to find information about platform support and software image support. Cisco Feature Navigator enables you to determine which Cisco IOS XE software images support a specific software release, feature set, or platform. To access Cisco Feature Navigator, go to http://www.cisco.com/go/cfn. An account on Cisco.com is not required.
Note Table 1 lists only the Cisco IOS XE software release that introduced support for a given feature in a given Cisco IOS XE software release train. Unless noted otherwise, subsequent releases of that Cisco IOS XE software release train also support that feature.