4.378 init-flash
Use this command to load the Board PROM to the inactive FLASH memory of a specified card or range of cards. When a card is reinitialized, it runs this version of the GPL in the card’s inactive FLASH memory.
Parameters
- bits (optional)
- This parameter must be specified for one E5-class card in conjunction with mode=rplcebl or mode=cnvrtbit. It indicates whether the bootloader or the flash image will be converted to a 32-bit or a 64-bit image. The E5-class card must be inhibited before the bootloader or the flash image can be changed through this mode.
- boot (optional)
- This parameter specifies whether the EPME5-class card should boot after the command
successfully completes.
Multiple images can be flashed without having to boot after each flash. If multiple images are being flashed to the E5-class card, this parameter can be used to prevent the card from booting after each image is flashed. If multiple images are being flashed and the card is allowed to boot after each flash, an image that is not activated after the card boots will be lost on a subsequent reset of the card. This option does not apply to MUX cardsor IMT Switch cards.
For E5-class cards, if the mode parameter is not specified or if mode=foregrnd, mode=imgselct or mode=pvjoy, then default value of boot parameter is yes. If the mode parameter is specified for E5-class card(s) as mode=backgrnd, then default value of boot parameter is no.
- gpl (optional)
- Generic program load. The flash GPL type that is running on the cards in the specified range of cards.
- initclk (optional)
- Initialize clock. If this parameter is specified, then the card location should be 1113 or 1115.
- mode (optional)
- If this parameter is specified for the E5-class cards, it indicates that the flashing of the E5-class card or range of cards will be performed in the specified mode. This parameter can be specified only for E5-class cards.
Example
init-flash:loc=1105:code=trial
init-flash:loc=1113:code=appr:initclk=yes
init-flash:loc=1115:code=appr:initclk=yes:force=yes
init-flash:loc=1115:code=trial:initclk=no
init-flash:sloc=1302:eloc=1306:gpl=blisim:code=appr
init-flash:sloc=6305:eloc=6305:code=appr:gpl=blispm
init-flash:sloc=1105:eloc=1306:appr:gpl=blmcap:mode=foregrnd
init-flash:loc=1205:code=appr:mode=backgrnd
init-flash:sloc=1201:eloc=1311:code=trial:gpl=blmcap:mode=backgrnd
init-flash:sloc=1201:eloc=1311:code=trial:mode=imgselct
init-flash:loc=1301:mode=rplcebl:bits=64
init-flash:loc=1301:code=trial:mode=cnvrtbit:bits=64
init-flash:sloc=1103:eloc=1306:code=appr:gpl=blmcap
Dependencies
The specified card must be an E5-class card or Service Module card. A MUX card can be specified for locations xy09 and xy10 (x is the frame and y is the shelf).
Each specified card does not have to be defined in the database, but it does have to be aligned on the IMT bus.
If the card in the specified card location is provisioned, then the card must be inhibited before this command is entered (unless the card is a MUX card or E5-class card with mode set to backgrnd, imgselct or pvjoy).
If the target card is a MUX card, then both card locations specified in the sloc and eloc parameters must contain MUX cards on the same IMT bus. For these cards, the bus is implicit based on the specified location. Location xy09 specifies the MUX A Bus, and location xy10 specifies the MUX B Bus (x is the frame and y is the shelf). For example, sloc=1109:eloc=6109 specifies all MUX cards on the A Bus only; sloc=1110:eloc-6110 specifies all MUX cards on the B Bus only. MUX cards from both the A bus and B bus cannot be flash downloaded simultaneously.
The boot parameter can be specified only if the target is an E5-class card.
A card location that contains the active MASP cannot be specified for the loc, sloc, or eloc parameter.
The provisioning subsystem mode (simple, duplex) must be established prior to executing the command.
The loc parameter cannot be specified with the eloc and sloc parameters.
The loc parameter or the eloc and sloc parameters must be specified.
If the eloc and sloc parameters are specified, the gpl parameter must be specified. MUX cards in the locations specified in the sloc and eloc parameters must be running the specified general program load (gpl). If the GPL specified is not multiple, then other cards in the range of card locations can be running other GPLs, but will not be initialized and only the cards within the range that are running the specified GPL will be initialized.
The sloc parameter value must be less than the eloc parameter value, when the two parameters are specified.
The specified card cannot be running an inactive flash GPL when the command is executed. If the sloc and eloc parameters are specified, cards within the range running an inactive flash GPL will be skipped. If there are no cards in the list because all the cards are running an inactive flash GPL, then UIM 1119 (example in Notes section) will be raised and the command will be rejected.
If the initclk parameter is specified, the card location parameter value must be 1113 or 1115.
If TDM reload would cause a system clock outage, the initclk parameter cannot be specified unless force=yes is also specified.
Caution:
The resulting clock outage will probably cause loss of traffic on all links.No other related command can be in progress when this command is entered.
A card location that is valid and defined in the database must be specified.
The eloc and sloc parameters must be specified together in the command.
MUX cards specified in the sloc and eloc location parameters must be running the specified GPL. For other GPLs including multiple, all cards within the range running the specified GPL will be flashed.
This command cannot be entered if an IMT Rate Change sequence is in progress.
This command cannot be entered during an Extended Bit Error Rate Test (BERT).
The boot parameter cannot be specified with the mode=backgrnd, mode=imgselct or mode=pvjoy for the E5-class card.
A card location that contains the MASP cannot be specified for the sloc or eloc parameter.
The mode parameter cannot be specified with the non E5-class card.
The gpl=multiple parameter can be specified only if the sloc and eloc parameters are specified.
The gpl=multiple parameter can be specified only if the card locations in the sloc and eloc parameters are E5-class cards.
The code parameter cannot be specified with mode=imgselct parameter for the E5-class card(s). If the mode=imgselct parameter is not specified, then the code parameter must be specified.
The GPL parameter cannot be specified when the mode=rplcebl or mode=cnvrtbit parameter is used with the E5-class card.
The mode=cnvrtbit parameter must be specified with the loc, code, and bits parameters. Any other parameters like force, boot, initclk, and sloc/eloc cannot be specified when the mode=cnvrtbit parameter is specified.
The mode=rplcebl parameter must be specified with the loc and bits parameters. Any other parameters like force, boot, initclk, code, and sloc/eloc cannot be specified when the mode=rplcebl parameter is specified.
The mode=cnvrtbit parameter can be specified only when the E5-class card is an SM8GB card type.
The mode=rplcebl parameter can be specified only when the E5-class card is either an SM8GB or a SLIC card type.
The mode=cnvrtbit parameter can be specified with the bits=64 parameter only when the E5-class card is running a 32-bit flash image (i.e., either BLMCAP or BLSLC32).
The mode=cnvrtbit parameter can be specified with the bits=32 parameter only when the E5-class card is running a 64-bit flash image (as in, BLDC64).
Notes
Card locations 1114, 1116, and 1117 are not valid and cannot be specified.
For the E5-class cards, multiple images can be flashed
without having to boot the card after each flash. If multiple images are being
flashed to the card the
boot=no parameter can be used to
prevent the card from booting after each image is flashed. After flashing any
number of images, the card can be reset either by entering the
init-flash
command with the
boot=yes parameter or by entering
the
init-card
command. If multiple images are being flashed and the card
is allowed to boot after each flash, any images that are not activated after
the card boots will be lost on a subsequent reset of the card.
If E5-OAMs are being used, then the init-flash command can be accepted even when the cards specified in the sloc and eloc parameter range contains 1113 and/or 1115 locations in it. But the cards in 1113 and 1115 are never included in the list to flash the cards.
For example, if "sloc=1111:eloc=1215:gpl=blmcap", neither 1113 nor 1115 would be included in the list to flash the cards and the command will be accepted. The only way to flash an E5-OAM card is to specify loc=1113/1115 but the card location specified cannot be the active E5-MASP.
For mode=backgrnd or mode=imgselct to be accepted, the E5-class target card must already be running a 45.0.0=64.XX.YY release version or higher.
When the sloc and eloc parameters are specified for E5-class cards and one or more cards in the range are running an inactive Flash GPL, then UIM 1119 will be raised along with the flash results. UIM 1119 will capture the first 5 card locations along with the total number of cards that have been skipped because of running an inactive Flash GPL. Example:
XXXX.1119 CARD <Active OAM location> INFO Cards out of phase with flash procedure
Card List: 1101, 1102, 1103, 1105, 1111, ... ( 1 others)
To use a 64-bit flash image, the EAGLE must be running Release 46.3 or higher. Steps for converting an E5-SM8G-B card running BLMCAP to BLDC64 GPL and vice-versa:
- Flash BLMCAP --> BLDC64:
- Make sure the E5-SM8G-B card is running BLMCAP Release 46.3 or higher.
- Replace the bootloader with the new 64-bit
version:
init-flash:loc=xxxx:mode=rplcebl:bits=64
- This command will not cause the card to boot.
- If the card is already running the new bootloader, this command does nothing.
- Flash card to BLDC64:
init-flash:loc=xxxx:code=yyyyy:mode=cnvrtbit:bits=64
- Activate flash.
- The card is now running the 64-bit flash image.
- Flash BLDC64 --> BLMCAP:
- The card is running BLDC64.
- Flash card to BLMCAP (Release 46.3 or higher):
init-flash:loc=xxxx:code=yyyyy:mode=cnvrtbit:bits=32
- Activate flash.
- The card is now running the 32-bit flash image.
SLIC cards run either the 32-bit BLSLC32 flash GPL or the 64-bit BLSLC64 flash GPL.
To convert a SLIC card from the 32-bit to the 64-bit flash image:
- Inhibit the card:
inh-card:loc=xxxx:force=yes
The card will boot and return to state OOS-MT-DSBLD.
- Flash the card:
init-flash:loc=xxxx:code=appr:64gpl=blslc64
The card will boot and return to state OOS-MT-DSBLD.
- Activate the 64-bit BLSLC64 flash GPL:
act-flash:loc=xxxx
The card will now accept 64-bit application GPLs from the OAM.
To convert a SLIC card from the 64-bit to the 32-bit flash image:
- Inhibit the card:
inh-card:loc=xxxx:force=yes
The card will boot and return to state OOS-MT-DSBLD.
- Flash the card:
init-flash:loc=xxxx:code=appr:gpl=blslc32
The card will boot and return to state OOS-MT-DSBLD.
- Activate the 32-bit BLSLC32 flash GPL:
act-flash:loc=xxxx
The card will now accept 32-bit application GPLs from the OAM.
Output
init-flash:loc=1105:code=trial
rlghncxa03w 04-01-05 13:05:05 EST EAGLE 31.3.0
FLASH Memory Downloading for card 1105 Started.
rlghncxa03w 04-01-05 13:05:05 EST EAGLE 31.3.0
BPHCAP Downloading for card 1105 Complete.
rlghncxa03w 04-01-05 13:05:05 EST EAGLE 31.3.0
Command Completed.
;
init-flash:loc=1113:code=appr:initclk=yes
rlghncxa03w 04-03-08 10:02:04 EST EAGLE 31.6.0
FLASH Memory Download for card 1113 Started.
;
rlghncxa03w 04-03-08 10:02:23 EST EAGLE 31.6.0
FLASH Memory Download for card 1113 Completed.
;
init-flash:sloc=1101:eloc=1112:gpl=blmcap:code=appr
tekelecstp 18-01-15 02:28:23 EST EAGLE 46.6.0.0.0-71.5.0
FLASH Memory Download for cards 1101 - 1112 Started.
LOC 1101 : PASSED
LOC 1102 : PASSED
LOC 1112 : PASSED
ALL CARD RESULTS PASSED
;
Command Completed.