Page tree
Skip to end of metadata
Go to start of metadata

To download a PDF version of this MOP, click here 

Document ID: 550-06210
Document Version
: 2.0
Tested: XX, 2018
Published
: XX, 2018

 

Table of Contents

1 Introduction

1.1 Overview

This Method of Procedure (MOP) provides detailed instructions for upgrading SBC 7000 DSP-LC FPGA from the BMC GUI. Perform this MOP if the FPGA version precedes Version 15 (dated June 11, 2014). 

If the version received from the host is 0, the flash image could be corrupted. In that case, use Method 2 from How to Determine the FPGA Version.

 

1.2 Target Platform

Use this MOP only to upgrade the FPGA image of a SBC 7000 DSP- LC card.

1.3 Target Firmware and FPGA Version

Use this MOP only to upgrade the FPGA image of a SBC 7000 DSP-LC card, if the following conditions are met:

  • The BMC version is 1.25.0 or newer.

2 How to Determine the FPGA Version

 

Method 1 - From the Host

The application must be running and DSP-LC cards must be enabled.

Command Syntax

[root@DIAG1a  linuxadmin]# grep fpgaUtil.pl /var/log/messages | grep -i "require"

Sep 11 11:55:15 DIAG1a /opt/sonus/sbx/scripts/fpgaUtil.pl[4361]: updateAll:: Require update for slot 4 version  ::  and minVersionRequired 2014/06/11 16:34:07, versionStatus
Sep 11 11:55:18 DIAG1a /opt/sonus/sbx/scripts/fpgaUtil.pl[4361]: updateAll:: Require update for slot 1 version  ::  and minVersionRequired 2014/06/11 16:34:07, versionStatus
Sep 11 11:55:34 DIAG1a /opt/sonus/sbx/scripts/fpgaUtil.pl[4361]: NO ACTION REQUIRED FOR SLOT 3. version 2016/02/08 13:17:18, minVersionRequired 2014/06/11 16:34:07
Sep 11 11:55:48 DIAG1a /opt/sonus/sbx/scripts/fpgaUtil.pl[4361]: NO ACTION REQUIRED FOR SLOT 2. version 2014/06/11 16:34:07, minVersionRequired 2014/06/11 16:34:07

 

Method 2 - From the BMC

Running dsppldprogrammer will power-down the DSP-LC card. It disables the host's ability to power on the DSP-LC. The last step after running dsppldprogrammer must be a BMC reboot.

 

  1. Execute the steps given in Preparing the BMC for the FPGA Programming Utility.
  2. Execute the following command for each slot in which a DSP-LC card is installed:

 

Command Syntax:

# dsppldprogrammer –s[2,3,4,5] –t3 –aVERSION

The flag -s[2,3,4,5] denotes the possible options for slot numbers.

-s2 – DSP Physical Slot 1 (utility displays “SLOT 0”)

-s3 – DSP Physical Slot 2 (utility displays “SLOT 1”)
-s4 – DSP Physical Slot 3 (utility displays “SLOT 2”)
-s5 – DSP Physical Slot 4 (utility displays “SLOT 3”)

Command Example:
# dsppldprogrammer –s2 –t3 –aVERSION

Sample Output:
JAM STAPL ByteCode Player Version 2.2 
Copyright © 1998-2001 Altera Corporation

LOADING DSP-LC FPGA Header From SPI Flash…
===================================================== 
      FPGA SPI FLASH VERSION INFORMATION SLOT 0
=====================================================
Design Name: sps_fic2;UserID=0XFFFFFFFF 
Device Name:   7vx415tffg1158
Version:       2014/06/11 16:34:07 
Image Length:  0x009b60cc
=====================================================

 

3. Review the results.

Table : Actions Based on Version

If...Then
Any of the DSP-LC cards are found to be programmed with FPGA version 14: 2014/03/20 11:16:26,Then follow the steps outlined in section 3 to reprogram the FPGA image
The FPGA version is 15 or 16,Then  no further action is required.

If any DSP-LC cards have a corrupted or incompletely programmed FPGA image, follow the steps in Section 3.

 

4. Reboot the BMC.

Command Example:
# reboot

3 DSP-LC Programming Procedure

 

The current version of the  dsp100_sps_fic2_0.bit file can be found on the host side. Log into the host and cd to /opt/sonus/sbx/firmware and see if the file is present. Copy the file to a server that the BMC can access and go to step 3.1 (substep 4) below. If the file is not present then go to step 3.1 (substep 1).

 

3.1 Uploading the DSP-LC File in the BMC Web GUI

  1. Untar/extract the compressed and zipped file firmware-7X00-V01.25.00- R000_dsp_fic_fpga_20140611.tar.gz (contact your designated Ribbon representative to obtain the firmware). This file contains the following files: firmware-7X00-V01.25.00-R000.img, dsp100_sps_fic2_0.bit, and the associated .md5 files.
  2. Login to the BMC Web GUI as user root.

  3. Click the Dashboard tab and verify the BMC Version. Ensure that the BMC version is 1.25.0 or newer.

  4. Click the Firmware Update tab.

    Figure : Firmware Update tab

  5. Click Browse and select the FPGA package file.

    Figure : Browse FPGA Package

  6. Click Upload. This may take several minutes to get completed.

    Figure : Upload FPGA Package


  7. After the upload is complete, a pop-up appears with the message “Image verification encountered error”. Click OK to ignore this error.

    Figure : Ignore message - Image Verification Encountered Error

3.2 Preparing the BMC for the FPGA Programming Utility

  1. Login to the BMC GUI as user root with the appropriate credentials.
  2. From the BMC GUI Dashboard (home screen), navigate to the Remote Control > Server Power Control tab.

    Figure : Server Power Control tab

  3. Select Power Off Server – Orderly Shutdown and click Perform Action. The process may take a few minutes to complete.

    Figure : Orderly Shutdown of Host

  4. Confirm a status of "Host is currently off".

    Figure : Power Off status

  5. Login to the BMC through any remote access client program, using the ssh protocol.
  6. Stop the IPMI and Automatic LOGOUT processes using the following  commands:

    # /etc/init.d/ipmistack stop
    # /etc/init.d/timeout stop

     

     

3.3 Programming the FPGA Utility

  1. Login to the BMC through any remote connection client, using the ssh protocol.
  2. Execute the following commands to program the FPGA utility:

    The execution of these commands could take 15 - 20 minutes to complete.

    Command Syntax:
    # cd /var
    # cp upgrade/fw.img ./dsp100fpga.rom
    # dsppldprogrammer –s[2,3,4,5] -t3 -aPROGRAM dsp100fpga.rom
     

    The flag -s[2,3,4,5] denotes the possible options for slot numbers. For example:

    -s2 – DSP Physical Slot 1 (utility displays “SLOT 0”)
    -s3 – DSP Physical Slot 2 (utility displays “SLOT 1”)
    -s4 – DSP Physical Slot 3 (utility displays “SLOT 2”)
    -s5 – DSP Physical Slot 4 (utility displays “SLOT 3”)
    Sample Output:
    # cd /var
    
    # cp upgrade/fw.img ./dsp100fpga.rom
    
    # dsppldprogrammer -s2 -t3 -aPROGRAM dsp100fpga.rom
    
    Jam STAPL ByteCode Player Version 2.2
    
    Copyright (C) 1998-2001 Altera Corporation
    
     Loading DSP100 FPGA Image from File [dsp100fpga.rom] to memory... COMPLETE
    
     Erasing DSP100 SPI Flash [Slot 0]... COMPLETE
    
     Programming DSP100 SPI Flash [Slot 0]...***********************************************************************************************************************************************************************************************************************************************************************--> COMPLETE

     

    3. After the upgrade, execute these commands from the host in order to verify the FPGA version:

    The application must be running and the DSP-LC cards must be enabled.

    Command Syntax:
    From the Host
    [root@DIAG1a linuxadmin]# cat /proc/pnps/ph_stats |grep 'SLOT\|REV'
            SLOT 1 STATUS
            REV_REG           0x00000016  0x00000016  0x00000016  0x00000016
            SLOT 2 STATUS
            REV_REG           0x00000016  0x00000016  0x00000016  0x00000016
    

 

  4. To program more DSP slots, repeat the steps 1 to 2 of this section.

  5. Reboot the BMC.

  6. After the host comes back up and the application is running, verify that the FPGA version is 15 or newer using steps described in Section 2 above. Verify that all DSP-LC cards are running using CLI.

3.4 Verify the FPGA Version Post-Upgrade

Execute these commands from the host.

 

The application must be running and the DSP-LC cards must be enabled.

 

Command Syntax:
From the Host
[root@DIAG1a linuxadmin]# cat /proc/pnps/ph_stats |grep 'SLOT\|REV'
        SLOT 1 STATUS
        REV_REG           0x00000016  0x00000016  0x00000016  0x00000016
        SLOT 2 STATUS
        REV_REG           0x00000016  0x00000016  0x00000016  0x00000016

4 Troubleshooting

If the DSP-LC card status shows "Failed/Disabled" after the upgrade, perform the following steps.

Command Syntax:
# set system daughterBoardAdmin <SYSTEM NAME> 1 state disabled

# set system daughterBoardAdmin <SYSTEM NAME> 1 state enabled

 

 

In HA SBC, the post-upgrade DSP-LC status could show locked on one server and disabled in another. Perform the following steps to rectify:

Command Syntax:
# set system admin <SYSTEM NAME> dspMismatchAction preserveCapacity


# set system daughterBoardAdmin <HOST NAME> 1 state disabled


# set system daughterBoardAdmin <HOSTNAME>1 state enabled


# set system admin <SYSTEM NAME> dspMismatchAction preserveRedundancy

 

Refer to the following pages for more information about dspMismatchAction: