Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

show system firmware (Junos OS Evolved)

Syntax

Description

Display firmware information.

Use Feature Explorer to confirm platform and release support for specific features.

Required Privilege Level

view

Options

detail

Displays the current, primary, golden, and available versions of firmware in addition to the fields usually displayed.

optics cdb-advertisement fpc-slot number pic-slot number port-number number Show CMIS 4.0 optics module information: Command Data Block (CDB) advertisements, capabilities, and firmware version on a per module basis.
optics status Show status of firmware upgrades for CMIS 4.0 optics modules.

Output Fields

The following table lists all possible output fields for the detail and optics status options of the show system firmware command. The output fields for the optics cdb-advertisement option of the show system firmware command are in a separate table. The fields that are displayed may vary depending on the platform and software release.

Table 1 lists the output fields for the show system firmware command.

Table 1: show system firmware Output Fields for the detail and optics status Options

Field Name

Field Description

With Command Options

Part

Physical part on the router or switch affected by the firmware.

none, detail

Type

Type of firmware on the router or switch.

none, detail

Tag

Location of the firmware on the interface.

none, detail

Current Version

Firmware version on the affected router or switch parts.

none, detail

Primary Version

Primary version number for the particular component, If NA, a primary firmware package is not available for that component.

detail

Available Version

New versions of firmware for upgrading or downgrading. If 0, you cannot upgrade the firmware for that component. If NA, a firmware package is not available for that component.

all

Golden Version

Recovery firmware version for the particular component (recovery image, if the component fails to boot from the primary image. If NA, a golden firmware package is not available for that component.

detail

Status

Firmware condition on the device.

none, detail, optics status

Xcvr

Identifier for the optics transceiver.

optics status

Table 2 lists the output fields for the show system firmware optics cdb-advertisement command.

Table 2: show system firmware optics cdb-advertisement Output Fields

Field Name

Field Description

CDB Implemented

Whether CDB is implemented, and how many instances. Possible values are:

  • not implemented

  • One instance of CDB

  • Two instances of CDB

Background CDB Information

Whether or not CDB background operation is implemented. Possible values are:

  • not implemented: The module may NACK after CDB command is triggered, until the command is complete.

  • implemented

CDB Auto Paging

Auto paging happens when the memory map address pointer advances past the end of an EPL CDB page. The page number automatically increments and the memory map address pointer automatically wraps to 128. Possible values are:

  • not implemented

  • implemented

EPL Pages

Number of EPL pages implemented. Possible values are:

  • not implemented

  • A0h implemented

  • A0h-A1h implemented

  • A0h-A2h implemented

  • A0h-A3h implemented

  • A0h-A7h implemented

  • A0h-AFh implemented

Max TWI Bytes per write

On the two-wire serial interface (TWI), the maximum number of bytes per write to volatile memory. The maximum is usually 8 bytes. However, the CdbMaxTWIWriteBytes field in the CDB allows the module to advertise support for longer TWI write transactions, but on CDB pages 9Fh-AFh only. The encoding of this field is as follows:

CdbMaxTWIWriteBytes = (Byte 164+1) * 8.

A value of 0 indicates that a maximum write length of 8 bytes is permitted. A value of 255 indicates a maximum write length of 2048 bytes is permitted. The command displays the actual number of bytes, and not the value of the CdbMaxTWIWriteBytes field in the CDB.

CDB command processing

How to process CDB commands. Possible values:

  • on STOP bit: CDB commands are processed on STOP bit when CMD 128/129 registers are within the write I2C transaction.

  • on write: CDB commands are processed on a write to Byte 129 of Page 9F.

CDB tNACK time (ms)

Amount of time in milliseconds for a CDB to accept a single or sequential write to volatile memory, if above 80 ms.

The encoding of tNACK for CDB is this register value*160 ms. The maximum supported tNACK is 4960 ms (register value = 31). This value is ignored when Byte 166 bit 7 is 0b.

tNACK time indicator

Whether or not the CDB tNACK in bits 6-0 also applies to CDB generic commands. CDB tNACK may be equal to 80 ms or as advertised in Byte 165 Bits 4-0.

Max tNACK time (ms)

Maximum amount of time in milliseconds waiting for a tNACK. The tNACK = (80 - XX) ms. XX is the value of this register in millisseconds. A value of 000 0000b (0) defines the module's maximum tNACK of 80 ms. Values of XX>= 80 are interpreted as having a tNACK of 0.

FW download password type

How downloads are unlocked. Possible values are:

  • unlocked by vendor password

  • unlocked by vendor password sequence

  • unlocked by standard MSA password

Abort 102h

The CMIS 4.0 abort command 102h is either supported or not supported.

Copy 108h

The CMIS 4.0 copy command 108h is either supported or not supported.

Skip erased

Whether or not skipping erased blocks is supported. Possible values are:

  • not supported

  • supported

Image readback

Whether or not full image readback is supported. Possible values are:

  • not supported

  • supported

Start command payload size

Number of bytes in the start command that must be extracted from the firmware binary file and sent to the module.

Erased byte

This is the default erased byte. Typically for NAND flash, the erased state is FFh. For some flash or EEPROM technology, the erased state is 00h. The purpose of this byte is to optimize the wire transfer time.

Max FW download block size

Maximum firmware download block size for optimum firmware upgrade performance, in bytes.

This byte in the CDB defines the maximum block size to write or read data, encoded as

block size = (bsize value + 1) * 8.

For example, if:

  • bsize = 0, then block size = 8.

  • bsize = 13, then block size = 112.

  • bsize = 63, then block size = 512.

  • bsize = 255, then block size = 2048.

Write LPL/EPL

To upgrade the firmware, which commands are supported. The Write Local Payload Length (LPL)/Extended Payload Length (EPL) commands are supported, none supported, or unknown. If the module advertises that Write LPL or EPL is not supported then the module may not be able to download firmware using this CDB mechanism, but the module may still be able to query firmware information using the CDB CMD 0100h.

Only LPL supported

Only LPL is supported, true or false.

Readback LPL/EPL

The Readback LPL/EPL commands are supported, none supported, or unknown.

Hitless mode

Whether or not hitless firmware upgrade is supported. Possible values are:

  • not supported: The firmware upgrade causes a reset of the optics module. Traffic is affected.

  • supported: The optics module may reset, but the module does its best to maintain traffic and management states. Data path functions are not reset.

CDB start max time (ms)

Maximum amount of time it takes to start the download of the firmware upgrade file to the optics module, using the CDB Start Download 0101h command.

CDB abort max time (ms)

Maximum amount of time it takes to cancel the firmware file download, using the CDB Abort 0102h command.

CDB write max time (ms)

Maximum amount of time to download the firmware upgrade file to the optics module, using a CDB Write 0103h command.

CDB complete max time (ms)

Maximum amount of time to complete the firmware upgrade file download using the CMD Complete 0107h command. If an error occurs during Write/Read LPL or EPL commands, the host shall also send a CMD Complete.

CDB copy max time (ms)

Maximum amount of time to complete a copy of the firmware image, using a CMD Copy 0108h command.

Firmware Image status, Image A

Image A status

Firmware Image info, Image A

Contains the version and build numbers for firmware image A.

Firmware Image status, Image B

Image B status.

Firmware Image info, Image B and Factory

Contains the version and build numbers for firmware image B and for the factory-supplied firmware boot image.

Sample Output

show system firmware (ACX Series)

show system firmware (Junos OS Evolved)

Note: Due to differences between platforms, your device may show more, fewer, and/or different entries and options than those listed in the general output example below.

show system firmware detail (Junos OS Evolved)

show system firmware optics cdb-advertisement (Junos OS Evolved)

show system firmware optics status (Junos OS Evolved)