» User Guide « NetBootLoader Composite User Guide for All CPU Boards Which Utilize the NetBootLoader Software Doc. ID: 1022-8317, Rev. 2.0 November 30, 2010 If it’s embedded, it’s Kontron.
Preface NetBootLoader Revision History Publication Title: NetBootLoader User Guide Doc. ID: 1022-8317 Rev. Brief Description of Changes Date of Issue 1.0 Initial issue 19-Sep-2008 2.0 “JUMP” Command added; new functionality added for the DHCP and TFTP commands 30-Nov-2010 Imprint Kontron Modular Computers GmbH may be contacted via the following: MAILING ADDRESS TELEPHONE AND E-MAIL Kontron Modular Computers GmbH +49 (0) 800-SALESKONTRON Sudetenstraße 7 sales@kontron.
NetBootLoader Preface Table of Contents Revision History .........................................................................................................ii Imprint ........................................................................................................................ii Disclaimer ..................................................................................................................ii Table of Contents ....................................................................
Preface NetBootLoader 2.7.8 NET ................................................................................................... 12 2.7.9 PASSWD ........................................................................................... 12 2.7.10 PF ...................................................................................................... 12 2.7.11 SCRIPT ............................................................................................. 12 2.7.12 SQ ..........................
NetBootLoader Preface List of Tables 1 NetBootLoader Control Commands .............................................................. 3 2 Network Accessing Commands .................................................................... 4 3 NBL Flash Operation Commands ................................................................. 5 4 NAND Flash Operation Commands .............................................................. 6 5 System Status Monitoring Commands ..................................
Preface NetBootLoader This page has been intentionally left blank. Page vi ID 1022-8317, Rev. 2.
NetBootLoader Preface Proprietary Note This document contains information proprietary to Kontron. It may not be copied or transmitted by any means, disclosed to others, or stored in any retrieval system or media without the prior written consent of Kontron or one of its authorized agents. The information contained in this document is, to the best of our knowledge, entirely correct.
Preface NetBootLoader This page has been intentionally left blank. Page viii ID 1022-8317, Rev. 2.
NetBootLoader 1. Introduction Introduction The NetBootLoader is a proprietary software utility for Kontron’s families of PowerPC products – E²Brains, AMC CPUs, CPCI CPUs, VME CPUs – which is designed to initialize and configure these modules for operation before turning control over to either an application or to an operator.
Introduction NetBootLoader This page has been intentionally left blank. Page 2 ID 1022-8317, Rev. 2.
NetBootLoader 2. NBL Operation NetBootLoader Operation The basic function of the NetBootLoader is to configure the CPU module for operation and then to load and start an operating system. In addition, it provides functionality for controlling the operation of the NetBootLoader itself, for programming images or data to the NBL-Flash(es) and NAND Flash, remote operation access, accessing TFTP or FTP servers, and acquiring Motorola S-Record images. Note ...
NBL Operation Table 1: NetBootLoader NetBootLoader Control Commands CMD TITLE ALIAS FUNCTION REMARKS SCRIPT - NBL command scripting Contents are executed only during boot up SETCORE - Set or display core number For CPUs with multicore processors SPEED - Set or display fast booting SQ Boot Sequence Set or display boot sequence SWAP - Set or display NBL Flash usage For CPUs with two NBL Flashes 2.
NetBootLoader 2.2.1 NBL Operation DHCP/ BOOTP Server Access Use of this access method requires the availability of either a DHCP or BOOTP server in the same network as the NetBootLoader. The DHCP command causes the NetBootLoader to first attempt to establish contact with a DHCP server. If contact is not achieved, it then tries to contact a BOOTP server.
NBL Operation Table 3: NetBootLoader NBL Flash Operation Commands CMD TITLE ALIAS FUNCTION REMARKS SF Store Flash Reads NBL Flash memory to data buffer Uses data buffer as target SL SLoad Download Motorola S-Records Uses data buffer as target 2.4 NAND Flash Operation The NetBootLoader provides various functions for performing operations with the NAND Flash memory. The following table provides an overview of the available NAND Flash memory operation functions.
NetBootLoader 2.5 NBL Operation System Status Monitoring The NetBootLoader provides various functions for monitoring the overall status of the system during the operation of the NetBootLoader. The following table provides an overview of available system status monitoring functions.
NBL Operation NetBootLoader Availability of the command interpreter depends on the system status. If a valid image is not available, the command interpreter is active as long as the operator requires it. If a valid image is available, the command interpreter is only active for the duration of the boot wait time. If the operator requires the command interpreter for a longer time he must terminate the boot operation before the boot wait time has elapsed.
NetBootLoader NBL Operation use of appropriate configuration files, pre-setting of the SCRIPT command, pre-setting of the SQ (Sequence) command, and pre-programming of bootable images to the NOR and/or NAND Flashes.
NBL Operation NetBootLoader In the event a bootable FAT partition is not found or if a “net.cfg” file is not found or its execution does not result in an image being loaded and started or the boot process being aborted, the NetBootLoader executes the following command sequence: “dhcp; tftp; run”. If this command sequence is not successfully executed, the boot process is aborted and a command interpreter is made available for operator inputs. 2.6.3.
NetBootLoader NBL Operation Refer to the SETCORE command for further information. When RUN is executed, BL is used in addition to the common bootline from the NBL EEPROM which was set with “cbl c ”. The sum of all bootlines (bl and cbl) for one core must not exceed 256 characters. To verify the status of bootlines, use the FDT_SHOW command. When no bootline is specified, the bootline 0 from the NBL EEPROM (cbl 0) is used as the bootline. 2.7.
NBL Operation 2.7.6 NetBootLoader DHCP This command is used to obtain automatically networking parameters from either a DHCP or BOOTP server for an Ethernet port. Its use requires the availability of one or the other of these servers to function. Initially the CPU module does not have a valid Ethernet interface configuration, and, therefore, this interface is inoperable.
NetBootLoader NBL Operation For example, in the event the first image specified is defect, the NetBootLoader will attempt to load the next image specified. This is continued until either a valid image is loaded or no further image is available. If no valid image is found, the NetBootLoader remains available for inputs. 2.7.
NBL Operation NetBootLoader When programming the NetBootLoader Flash memory using offsets (with the -o option), it is possible to unintentionally overwrite portions of previously programmed images. This may result in either an invalid image or erroneous data contents of the NetBootLoader Flash memory. It is recommended to first verify the contents of the NetBootLoader Flash memory using the INFO command before performing any programming with offsets. Refer to the INFO command for further information. 2.
NetBootLoader 2.8.4 NBL Operation Motorola S-Records The NetBootLoader will also accept Motorola S-Records as an image. The SL command accepts S1, S2 and S3 records. Operation is terminated by the appropriate S9, S8 or S7 record. Other types of records are ignored. The checksum of every record except end records is checked. Bad records are rejected by the NetBootLoader. The address range of every record is also checked. Records which fall outside of the internal buffer are rejected.
NBL Operation 2.8.6 NetBootLoader Uploading an NBL Flash Memory Area The NetBootLoader also has the possibility to upload certain areas of the NBL Flash memory to a host using an Ethernet port. To use this interface, the Ethernet port parameters must first be set and then the operator must gain control of the NetBootLoader and perform an FTP server login. After a successful login, the operator then stores the NBL Flash memory area to be uploaded to the local data buffer using the SF command.
NetBootLoader 2.11.1 NBL Operation NBL Flash Usage With the introduction of a redundant NBL Flash device, the capability to support different versions of the NetBootLoader and provide backup capability was added. This functionality is supported by the NetBootLoader, the onboard IPMI management system, and onboard hardware switching. The exact configuration is a function of application requirements. 2.11.
NBL Operation NetBootLoader This page has been intentionally left blank. Page 18 ID 1022-8317, Rev. 2.
NetBootLoader 3. Command Support Product Command Support The following table provides a complete listing of all NetBootLoader commands. Each Kontron product which employs the NetBootLoader is shown along with a matrix entry indicating the applicability of the command for the product. As can readily be seen, not all commands are applicable to a given product, and, in some cases, commands available depend on the operational mode or configuration of the product indicated.
Command Support Table 6: NetBootLoader Command / Product Table X X X X X X X X X X X GET X X X X X X X X X X X X X X X X X HELP or ? X X X X X X X X X X X X X X X X X JUMP X X INFO X X X X X X X X X X X X X X X X X IPMI X X (NBL-FL) X X X X X X X X X X X X X X X X X (NAND-FL) X X LOGIN X X X X X X X X X X X X X X X X X LOGOUT X X X X X X X X X X X X X X X X X (FTP) X X X X
NetBootLoader Table 6: Command Support Command / Product Table AM4100 AM4101 CP320 CP321 CP620 CP6200 EB405 EB425 EB8245 EB8347 EB8540 EB8541 EB860 VMP1 VMP2 VMP60 DX11 PRODUCTS PING X X X X X X X X X X X X X X X X X PUT X X X X X X X X X X X X X X X X X (FTP) X X X X X X X X X X X X X X X X X PWD, PWDCF (NAND) X X RM, RMCF (NAND) X X RMDIR, RMDIRCF(NAND) X X RS X X X X X X X X X X X X X X X X X X X X
Command Support NetBootLoader This page has been intentionally left blank. Page 22 ID 1022-8317, Rev. 2.
NetBootLoader 4. Command Syntax Command Syntax Reference The following provides command syntax reference information, a short description, and, in some cases, usage examples. For some commands, not all products have the exact same command syntax as indicated here. Use the HELP command, to ascertain the command syntax for the product in use. Where an ellipsis (…) appears in the command syntax it means that the command is continued from the previous line.
Command Syntax ASSIGN FUNCTION: SYNTAX: NetBootLoader (ASMP) Assign devices to the core specified or display the current assignments assign [default | … | all] where: assign command issuing the command without arguments will display the current assignment for both cores default option: set the default assignment parameter: string 0, 1 defines the core to which the device(s) specified is(are) to be assigned parameter: string <[x … ]x> de
NetBootLoader ASSIGNMEM FUNCTION: SYNTAX: Command Syntax (ASMP) Assign memory to the cores or display the current assignments assignmem [ ] where: assignmem command issuing the command without arguments will display the current assignment for both cores parameter: string 0, 1 defines the core to which the memory is to be assigned parameter: string <[x … ]x> defines the memory size to be assigned to the core specified entry should be hexadecimal: e.g.
Command Syntax NetBootLoader BL FUNCTION: SYNTAX: Set or display the parameters of the bootline stored in RAM bl [-|] where: bl - command option: delete bootline parameter: value: string <[x … ]x> defines the bootline to be used with the next RUN command DESCRIPTION: The commnd BL only specifies the bootline for the image in the data buffer at the time the RUN command is invoked.
NetBootLoader Command Syntax BW FUNCTION: SYNTAX: Set or display the parameters of the boot wait function of the NetBootLoader bw [
Command Syntax NetBootLoader BYE FUNCTION: SYNTAX: DESCRIPTION: Page 28 Terminate an FTP server session bye An FTP server session which has been established with the command LOGIN is terminated with the command BYE. ID 1022-8317, Rev. 2.
NetBootLoader Command Syntax CBL FUNCTION: SYNTAX: Set or display the parameters of the bootline(s) stored in NBL Flash cbl [ (-|)] where: cbl command: change bootline parameter: string 0, 1, 2, 3, c ID number of the image to be associated with the bootline or bootline which is common to all images no other values than those above are supported - option: delete bootline for image specified or common parameter: value: string <[x … ]x> defines the bootline to be used w
Command Syntax CD NetBootLoader (FTP) FUNCTION: SYNTAX: Change the current FTP server directory cd where: cd command: change directory parameter: string <[x … ]x> new directory path DESCRIPTION: If an FTP server session has been established with the LOGIN command, the command CD is used to change the current FTP server directory. The argument “” may be an absolute or relative path. The format depends on what the server accepts.
NetBootLoader Command Syntax CHECK FUNCTION: SYNTAX: DESCRIPTION: USAGE: Verify validity of image programmed to NBL Flash memory check When an image is programmed to NBL Flash memory, a CRC is performed and the results are stored along with the image. The CHECK command provides status information for the current images in NBL Flash memory.
Command Syntax CLONE NetBootLoader (One NBL Flash) FUNCTION: SYNTAX: Program the NetBootLoader to FLASH clone [-n] where: clone -n command option: program from data buffer DESCRIPTION: USAGE: To update the NetBootLoader itself, the command “clone” is used. If the application image source for programming is to be the data buffer, the image must first be downloaded to the data buffer from an tftp/ftp server.
NetBootLoader CLONE FUNCTION: SYNTAX: Command Syntax ( Tw o N B L F l a s h e s ) Program the NetBootLoader to NBL Flash memory clone [-n] [-a] [-y] where: clone -n command option: program from data buffer to program from either the active or inactive NBL Flash memory, do not specify this option -a option: specify this option to program the active NBL Flash memory (if -n is not specified, source is the inactive NBL Flash memory) to program the inactive NBL Flash memory, do not specify this option (if
Command Syntax CLONE NetBootLoader ( Two N B L F l a s h e s ) DESCRIPTION: Programming the NetBootLoader: • from the data buffer to the active NBL Flash: clone -n -a • from the inactive NBL Flash to the active NBL Flash: clone -a • from the data buffer to the inactive NBL Flash: clone -n • from the active NBL Flash to the inactive NBL Flash: clone USAGE: Program NetBootLoader to the inactive NBL Flash COMMAND / RESPONSE: NetBtLd> clone -n clone: Fixup FLASH info from ftp buffer This will overwrite
NetBootLoader Command Syntax DHCP FUNCTION: SYNTAX: Interface to a DHCP or BOOTP server; exchange network configuration parameters dhcp [-e|] where: dhcp -e command option: continue sending requests until answer is received parameter: value: numeric string <[n … ]n> time, in seconds; must be ≥ 5 seconds DESCRIPTION: This command is used to set the network parameters for operation of an Ethernet port via either a DHCP or BOOTP server.
Command Syntax NetBootLoader ECAT FUNCTION: SYNTAX: View or create boot script configuration files on the NAND Flash ecat [-f] [] where: ecat -f DESCRIPTION: Page 36 command: edit(concatenate) option: force file overwrite if the “” file exists on NAND Flash it will be overwritten parameter: string name of the file to be viewed or created nbl[0 … 9].cfg or net.cfg for NetBootLoader configuration files <[x... ]x[.[x..
NetBootLoader Command Syntax E C AT USAGE: Create config file “nbl2.cfg”; attempt to create new config file; create new config file: COMMAND / RESPONSE: NetBtLd> ecat nbl2.cfg dhcp; tftp; run NetBtLd> ecat nbl2.cfg tftp 172.100.1.35 ... root.bin; run File nbl2.cfg already exists, use option -f ... to overwrite NetBtLd> ecat nbl3.cfg tftp 172.100.1.35 ... root.
Command Syntax NetBootLoader FDISK FUNCTION: Create or remove primary partitions on the NAND Flash SYNTAX: fdisk -p|-a |-d |-n … where: fdisk -p -a -d -n Page 38 command option: display data show geometry and defined partitions option: set boot flag parameter: numeric string 0, 1, 2, 3, 4 set the boot flag on partition and remove it from the other partitions when set to 0 (zero) the boot flag is removed from all parti
NetBootLoader Command Syntax FDISK DESCRIPTION: This command is used to specify the partitioning of the NAND Flash and control the setting of the partition boot flag. A maximum of four partitions are definable whereby only one partition at a time may have the boot flag set. The cylinders specified for partition creation are inclusive. Use the “-p” option to obtain exact information concerning the status of the NAND Flash.
Command Syntax NetBootLoader FDT FUNCTION: SYNTAX: Enable creation of a flattened device tree (FDT) fdt [] where: fdt command parameter: numeric string 0,1 when set to 0 (zero) disables creation of an FDT, image is booted from 0x100 when set to 1 (one) enables creation of an FDT, image is booted from 0x0 when not specified, displays current setting DESCRIPTION: This command is used to specify the creation of an FDT for an operating system if required.
NetBootLoader Command Syntax FDT_SHOW FUNCTION: SYNTAX: Display the flattened device tree (FDT) information, and copy FDT information to the data buffer if required fdt_show [] [-o] where: fdt_show command parameter: string 0, 1, 2, 3 ID number of the image for which FDT information is to be displayed no other values than those above are supported when not specified, displays FDT information for image in the data buffer -o option: overwrite copy FDT contents to the data buffer (will overw
Command Syntax NetBootLoader FRU FUNCTION: SYNTAX: Display a hexdump of the “FRU” data fru where: fru DESCRIPTION: command This command is used to display FRU data in hexadecimal format.
NetBootLoader Command Syntax HELP or ? FUNCTION: SYNTAX: Display online help pages help | ? [] where: help or ? command parameter: string <[x … ]x> print all commands starting with DESCRIPTION: ID 1022-8317, Rev. 2.0 This command displays the online help pages. The syntax of every command and a brief description is shown. The display output pauses after every page. The output can be continued with any key. Entering a “.” (period) aborts the help function.
Command Syntax NetBootLoader INFO FUNCTION: SYNTAX: DESCRIPTION: Display system information info The command INFO is used to display an information summary for the running system. Images programmed using the “-o” option of the command LF are not shown.
NetBootLoader Command Syntax IPMI FUNCTION: SYNTAX: Display IPMI information ipmi where: ipmi DESCRIPTION: command This command is used to display the currently active IPMI firmware version and the general status of the MMC. JUMP FUNCTION: SYNTAX: Jump to script specified by jump where: jump command parameter: string 0 ... 9 ID number of the “nbl.
Command Syntax LF NetBootLoader (NBL F lash ) FUNCTION: SYNTAX: Load Flash (active NBL Flash) lf [] [[-r]|[[-o[=][ -k]] … [-m[=] -l[=]]]] where: lf -r -o -k -m -l DESCRIPTION: command parameter: numeric string 0, 1, 2, 3 ID number assigned to this image option: delete image specified, or, if none specified, delete image 0 option: offset parameter: hexadecimal <[x … ]x> program to FLASH offset of ...
NetBootLoader LF Command Syntax (NBL Flash) DESCRIPTION: If the “-o” option is specified, the contents are programmed exactly at this offset in NBL Flash memory. No length and no CRC information is added. In addition, no image number is assigned (even if specified), and the image cannot be loaded and started with the RUN command. The “-k” option can be specified to prevent deletion of the surrounding NBL Flash memory contents. Flash memory can only be erased sector-wise.
Command Syntax LOAD NetBootLoader (NAND Flash) FUNCTION: SYNTAX: Load an operating system image and optionally a RAMdisk filesystem from the NAND Flash to the data buffer load [-b] [-r ] where: load -b -r DESCRIPTION: command option: backup only load file(s) if image(s) in data buffer invalid, or the md5sum check(s) failed option: ramdisk load initrd specified by parameter: string <[x … ]x> filename of initrd parameter: string <[x …
NetBootLoader LOAD Command Syntax (NAND Flash) USAGE: Sample configuration file for loading files: setcore 0; load -r initrd1 img1; md5 -r initrd1.md5 img1.md5; load -b -r initrd2 img2; md5 -b -r initrd2.md5 img2.md5; load -b initrd3 img3; setcore 1; load -r initrd4 img4; md5 -r initrd4.md5 img4.md5; load -b -r initrd5 img5 run -c In this example, core 0 is prepared first: If image 1 does not have a valid md5sum, image 2 is loaded. If image 2 is invalid, image 3 is loaded. On core 1 image 4 is tried.
Command Syntax NetBootLoader LOGIN FUNCTION: SYNTAX: Initiate FTP server session login [] where: login DESCRIPTION: command parameter: string IP address of host parameter: string <[x … ]x> FTP server user name parameter: string <[x … ]x> user’s password The command LOGIN is used to establish an FTP server session. The “” parameter is not necessary if the server does not require one.
NetBootLoader LS Command Syntax (FTP) FUNCTION: SYNTAX: DESCRIPTION: LS, LSCF FUNCTION: SYNTAX: When logged into an FTP server, this command displays a listing of the current FTP server directory ls To display a listing of the current FTP server directory the command LS is used. This command downloads the listing to the data buffer and then the listing is displayed. Any previously loaded image in the data buffer is overwritten.
Command Syntax NetBootLoader MD FUNCTION: SYNTAX: Display visible memory md [] where: md DESCRIPTION: Page 52 command parameter: hexadecimal <[x … ]x> starting address of a visible memory area To display a visible memory area the command MD is used. The first time the command MD is issued, visible memory contents starting at the address 0x0 are displayed if no “” parameter is used.
NetBootLoader MD5 Command Syntax (NAND Flash) FUNCTION: SYNTAX: Performs checksum verification of the data buffer contents md5 [-b|-n [-f]] [-r ] where: md5 -b -n -f -r DESCRIPTION: command option: do not calculate md5sum(s) if last specified file(s) was (were) not loaded option: new create new md5sum(s) and write them to the file(s) option: force file overwrite overwrite file(s) if file(s) already exist(s) option: ramdisk check/create
Command Syntax MKDIR, MKDIRCF FUNCTION: SYNTAX: NetBootLoader (NAND Flash) Create a directory on the NAND Flash mkdir mkdirCF where: mkdir; mkdircf DESCRIPTION: Page 54 command parameter: string <[x … ]x> name of the directory to be created on the NAND Flash To access the NAND Flash when logged on to an ftp server, use the command MKDIRCF. ID 1022-8317, Rev. 2.
NetBootLoader MKFS Command Syntax (NAND Flash) FUNCTION: SYNTAX: Create a filesystem for the partition specified on the NAND Flash mkfs [-f] where: mkfs -f DESCRIPTION: command option: force creation of filesystem invoking this option will overwrite any existing filesystem on the partition specified parameter: numeric string 1, 2, 3, 4 number of the partition where filesystem is to be created This command creates a FAT-16 filesystem.
Command Syntax M V, M V C F FUNCTION: SYNTAX: NetBootLoader (NAND Flash) Rename a file on the NAND Flash mv -f mvcf -f where: mv -f DESCRIPTION: Page 56 command option: force file overwrite if the “” file exists on NAND Flash it will be overwritten parameter: string <[x … ]x> name of the file to be renamed on the NAND Flash parameter: string <[x … ]x> new name for the file to be renamed if a file with t
NetBootLoader NET Command Syntax (NON-AMC) FUNCTION: SYNTAX: Set or display the parameters for the Ethernet interface net [] [-netmask ] … [-gw ] [-num ] [-f] where: net -netmask -gw -num -f DESCRIPTION: ID 1022-8317, Rev. 2.0 command parameter: numerical string IP address of CPU board: nnn.nnn.nnn.nnn option: netmask parameter: numerical string netmask of CPU board: nnn.nnn.nnn.
Command Syntax NET NetBootLoader (AMC) FUNCTION: SYNTAX: Set or display the parameters for an Ethernet port net [] [] … [-netmask ] [-gw ] … [-a] [-f] where: net -netmask -gw -a -f Page 58 command parameter: numerical string 0, 1 ... n logical identifier of Ethernet port addressed by this command where: 0 = TSEC1 1 = TSEC2 2 = TSEC3 3 = TSEC4 parameter: string
NetBootLoader NET DESCRIPTION: ID 1022-8317, Rev. 2.0 Command Syntax (AMC) To set or display the parameters of an Ethernet port the command NET is used. Initially the CPU board does not have any valid Ethernet port configurations, therefore, these interfaces are inoperable. The initial configuration of the Ethernet ports must be done from the primary serial interface using the command “net ... -f”.
Command Syntax NetBootLoader PA S S W D FUNCTION: SYNTAX: Set the telnet password passwd [-f|-d] where: passwd -f -d DESCRIPTION: USAGE: command option: if password is not known option: disable disable telnet login (remote access) To set the password for telnet sessions with the NetBootLoader the command PASSWD is used.
NetBootLoader Command Syntax PCI FUNCTION: SYNTAX: DESCRIPTION: Display PCI information pci The command PCI is used to display detailed information on all detected PCI devices. The bus number, device number, function number, vendor, and device ID’s are displayed together with the configured base addresses and the assigned IRQ number.
Command Syntax NetBootLoader PF DESCRIPTION: To set or display the operational parameters for the serial interfaces the command PF is used. At startup the settings for the primary and the secondary interfaces are always set to the default values (9600/8/n/1). This is to avoid a possible system lockout. If other settings are required during operation of the NetBootLoader they may be made. If changes are made, it must be ensured that corresponding parameters are used for the operator console.
NetBootLoader Command Syntax PING FUNCTION: SYNTAX: Verify operability of an Ethernet interface ping [-c ] [-s ] … [-w ] where: ping -c -s -w DESCRIPTION: command parameter: string IP address of target option: count parameter: numeric string <[n ... ]n> number of packets to send option: size parameter: numeric string <[n ... ]n> size of packet to send in bytes option: wait parameter: numeric string <[n ...
Command Syntax NetBootLoader PUT FUNCTION: SYNTAX: Upload contents of the data buffer to the FTP server put where: put DESCRIPTION: PWD command parameter: string file name to be used for contents of data buffer to be uploaded To upload the contents of the data buffer (of the currently specified core) to a file on an FTP server, the command PUT is used. The file indicated by the parameter “” is created on the server.
NetBootLoader RM, RMCF FUNCTION: SYNTAX: Command Syntax (NAND Flash) Remove a file on the NAND Flash rm rmcf where: rm; rmcf DESCRIPTION: RMDIR, RMDIRCF FUNCTION: SYNTAX: command parameter: string <[x … ]x> name of the file to be removed from the NAND Flash To access the NAND Flash when logged on to an ftp server, use the command RMCF.
Command Syntax NetBootLoader RS FUNCTION: SYNTAX: DESCRIPTION: RUN Reset the system rs To permit the operator to force a restart of the system, the command RS is used. This command terminates the NetBootLoader command interpreter and resets the entire system. If this command is issued over a remote telnet connection, the telnet session is terminated prior to the generation of the reset.
NetBootLoader RUN Command Syntax (ASMP) FUNCTION: SYNTAX: (Loads and) starts (a) bootable image(s) run [-c] [ []] where: run -c command option: check do not start the image(s) if the “md5” check failed parameter: string 0, 1, 2, 3 load and start image with the number from NBL Flash on core 0 4 start image in the data buffer on core 0 -1 do not start image on core 0 parameter: string 0, 1, 2, 3 load and start image with the number from
Command Syntax NetBootLoader S AV E FUNCTION: SYNTAX: Store contents of the data buffer to a file in the NAND Flash save -f where: save -f DESCRIPTION: Page 68 command option: force file overwrite if file exists on NAND Flash it will be overwritten parameter: string <[x … ]x> name of the file under which the intermediate buffer contents are to be stored on the NAND Flash if a file with this name already exists on the NAND Flash the error message: “File filename already exists, u
NetBootLoader Command Syntax SCRIPT FUNCTION: SYNTAX: Provides very basic scripting capability script [|-] where: script - DESCRIPTION: command parameter: string <[x … ]x> “” may only include NBL commands; flow control constructs are not permitted; commands must be separated by semi-colons option: delete script contents With the SCRIPT command, it is possible to control the boot process.
Command Syntax NetBootLoader SF FUNCTION: SYNTAX: Store NBL Flash memory contents to data buffer sf (-o[=] -l[=])| …(-m[=] -l[=])| …([ -o[=]][ -l[=]]) where: sf -o -l -m DESCRIPTION: USAGE: command option: offset parameter: value: hexadecimal relative offset to start of FLASH contents or image to be stored to the data buffer option: length parameter: value: hexadecimal length of FLASH contents or area of visible memory
NetBootLoader SETCORE FUNCTION: SYNTAX: Command Syntax (ASMP) Specify the core for which selected commands apply or display the currently selected core setcore [] where: setcore DESCRIPTION: ID 1022-8317, Rev. 2.0 command if command is issued without an argument, the currently set core number is displayed parameter: string 0, 1 number of the core to be set (default is 0) For ASMP operation each core is provided with its own data buffer and BL bootline.
Command Syntax NetBootLoader SL FUNCTION: SYNTAX: Download Motorola S-Records to data buffer sl [-o[=]] [-u] where: sl -o -u DESCRIPTION: USAGE: command option: offset parameter: hexadecimal: unsigned <[x … ]x> offset to be subtracted from each record's address option: source = secondary serial interface instead of the primary serial interface With the command SL Motorola S-Records are downloaded to the data buffer (of the currently specified core) and the record addresses modified
NetBootLoader Command Syntax SPEED FUNCTION: SYNTAX: Enables or disables fast booting speed [] where: speed command parameter: numeric string 0, 1 when set to 0 (zero) disables “fast” boot mode when set to 1 (one) enables “fast” boot mode when not specified, displays current setting DESCRIPTION: This command is used to specify to the NetBootLoader that either the complete booting process is to be performed or that a shortened boot process is to be performed.
Command Syntax SQ NetBootLoader (NON-AMC / SMP) FUNCTION: SYNTAX: Set or display the boot sequence sq [] where: sq command parameter: numeric string: “0, 1, 2, 3” ID number of image to be booted parameter: numeric string: “0, 1, 2, 3” ID number of image to be booted parameter: numeric string: “0, 1, 2, 3” ID number of image to be booted parameter: numeric string: “0, 1, 2, 3” ID number of image to be booted DESCRIPTION: USAGE: Up to four boo
NetBootLoader S WA P Command Syntax ( Tw o N B L F l a s h e s ) FUNCTION: SYNTAX: Modify or display the current NBL Flash memory device usage swap [-t|-p] where: swap -t -p DESCRIPTION: ID 1022-8317, Rev. 2.0 command option: temporary temporary NBL Flash swap option: permanent permanent NBL Flash swap The configuration of the NBL Flash memory devices (active or inactive) is controlled by the IPMI controller, the payload (HOST), and the switch SW2 (DIP switch position 2).
Command Syntax S WA P NetBootLoader ( Tw o N B L F l a s h e s ) USAGE: Swap the NBL Flashes temporarily and verify COMMAND / RESPONSE: NetBtLd> swap -t Flash config swapped till next reboot via HOST bit NetBtLd> NetBtLd> swap Active Flash is NOR flash 1 Fallback Flash is NOR flash 0 Configuration Details: IPMI : straight HOST : reverse DIP SW : straight == off NetBtLd> Swap the NBL flashes permanently COMMAND / RESPONSE: NetBtLd> swap -p Flash config permanently swapped NetBtLd> Page 76 ID 1022-831
NetBootLoader Command Syntax TFTP FUNCTION: SYNTAX: Download file from a TFTP server tftp [-e] [] [] where: tftp -e DESCRIPTION: USAGE: command option: repeat tftp until download is successful parameter: string
Command Syntax NetBootLoader VER FUNCTION: SYNTAX: Display version number ver where: ver DESCRIPTION: USAGE: command The command VER displays the actual version number of the currently active NetBootLoader and when present the inactive NetBootLoader. Determine the current versions of the NetBootLoder: NetBtLd> ver Version of running NetBootLoader: 0809101408 Version in active flash: 0809101408 No valid NetBootLoader found in fallback … flash. NetBtLd> Page 78 ID 1022-8317, Rev. 2.