If it’s embedded, it’s Kontron.» User Guide «NetBootLoaderComposite User Guide for AllCPU Boards Which Utilize the NetBootLoader SoftwareDoc. ID: 102

ID 1022-8317, Rev. 2.0Introduction NetBootLoaderPage 2This page has been intentionally left blank.

ID 1022-8317, Rev. 2.0NBL OperationNetBootLoaderPage 32. NetBootLoader OperationThe basic function of the NetBootLoader is to configure the CPU module

ID 1022-8317, Rev. 2.0NBL Operation NetBootLoaderPage 42.2 Network AccessingTo support application development and operational requirements for variou

ID 1022-8317, Rev. 2.0NBL OperationNetBootLoaderPage 52.2.1 DHCP/ BOOTP Server AccessUse of this access method requires the availability of either a D

ID 1022-8317, Rev. 2.0NBL Operation NetBootLoaderPage 62.4 NAND Flash OperationThe NetBootLoader provides various functions for performing operations

ID 1022-8317, Rev. 2.0NBL OperationNetBootLoaderPage 72.5 System Status MonitoringThe NetBootLoader provides various functions for monitoring the over

ID 1022-8317, Rev. 2.0NBL Operation NetBootLoaderPage 8Availability of the command interpreter depends on the system status. If a valid image is notav

ID 1022-8317, Rev. 2.0NBL OperationNetBootLoaderPage 9use of appropriate configuration files, pre-setting of the SCRIPT command, pre-setting of theSQ

ID 1022-8317, Rev. 2.0NBL Operation NetBootLoaderPage 10In the event a bootable FAT partition is not found or if a “net.cfg” file is not found or its

ID 1022-8317, Rev. 2.0NBL OperationNetBootLoaderPage 11Refer to the SETCORE command for further information.When RUN is executed, BL is used in additi

ID 1022-8317, Rev. 2.0Page iiPreface NetBootLoaderRevision HistoryImprintKontron Modular Computers GmbH may be contacted via the following:MAILING ADD

ID 1022-8317, Rev. 2.0NBL Operation NetBootLoaderPage 122.7.6 DHCPThis command is used to obtain automatically networking parameters from either a DHC

ID 1022-8317, Rev. 2.0NBL OperationNetBootLoaderPage 13For example, in the event the first image specified is defect, the NetBootLoader will attempt t

ID 1022-8317, Rev. 2.0NBL Operation NetBootLoaderPage 14When programming the NetBootLoader Flash memory using offsets (with the -o option), it ispossi

ID 1022-8317, Rev. 2.0NBL OperationNetBootLoaderPage 152.8.4 Motorola S-RecordsThe NetBootLoader will also accept Motorola S-Records as an image. The

ID 1022-8317, Rev. 2.0NBL Operation NetBootLoaderPage 162.8.6 Uploading an NBL Flash Memory AreaThe NetBootLoader also has the possibility to upload c

ID 1022-8317, Rev. 2.0NBL OperationNetBootLoaderPage 172.11.1 NBL Flash UsageWith the introduction of a redundant NBL Flash device, the capability to

ID 1022-8317, Rev. 2.0NBL Operation NetBootLoaderPage 18This page has been intentionally left blank.

ID 1022-8317, Rev. 2.0Command SupportNetBootLoaderPage 193. Product Command SupportThe following table provides a complete listing of all NetBootLoade

ID 1022-8317, Rev. 2.0Command Support NetBootLoaderPage 20DHCP XX XXXXXXECAT (NAND-FL) X XEXE (NAND-FL) X XFDISK (NAND-FL) X XFDT X X X X XFDT_SHOW X

ID 1022-8317, Rev. 2.0Command SupportNetBootLoaderPage 21PING XXXXXXXXXXXXXXXXXPUT XXXXXXXXXXXXXXXXXPWD (FTP)XXXXXXXXXXXXXXXXXPWD, PWDCF (NAND) X XRM,

ID 1022-8317, Rev. 2.0 Page iiiNetBootLoader PrefaceTable of ContentsRevision History ...

ID 1022-8317, Rev. 2.0Command Support NetBootLoaderPage 22This page has been intentionally left blank.

ID 1022-8317, Rev. 2.0Command SyntaxNetBootLoaderPage 234. Command Syntax ReferenceThe following provides command syntax reference information, a shor

ID 1022-8317, Rev. 2.0Command Syntax NetBootLoaderPage 24 ASSIGN (ASMP)FUNCTION: Assign devices to the core specified or display the current assignme

ID 1022-8317, Rev. 2.0Command SyntaxNetBootLoaderPage 25 ASSIGNMEM (ASMP)FUNCTION: Assign memory to the cores or display the current assignmentsSYNTA

ID 1022-8317, Rev. 2.0Command Syntax NetBootLoaderPage 26 BLFUNCTION: Set or display the parameters of the bootline stored in RAMSYNTAX:bl [-|<boo

ID 1022-8317, Rev. 2.0Command SyntaxNetBootLoaderPage 27 BWFUNCTION: Set or display the parameters of the boot wait function of the NetBootLoaderSYNT

ID 1022-8317, Rev. 2.0Command Syntax NetBootLoaderPage 28 BYEFUNCTION: Terminate an FTP server sessionSYNTAX:byeDESCRIPTION: An FTP server session wh

ID 1022-8317, Rev. 2.0Command SyntaxNetBootLoaderPage 29 CBLFUNCTION: Set or display the parameters of the bootline(s) stored in NBL FlashSYNTAX:cbl

ID 1022-8317, Rev. 2.0Command Syntax NetBootLoaderPage 30 CD (FTP)FUNCTION: Change the current FTP server directorySYNTAX:cd <new-path>where:

ID 1022-8317, Rev. 2.0Command SyntaxNetBootLoaderPage 31 CHECKFUNCTION: Verify validity of image programmed to NBL Flash memorySYNTAX:checkDESCRI

ID 1022-8317, Rev. 2.0Page ivPreface NetBootLoader2.7.8 NET ...

ID 1022-8317, Rev. 2.0Command Syntax NetBootLoaderPage 32CLONE (One NBL Flash)FUNCTION: Program the NetBootLoader to FLASHSYNTAX:clone [-n]where:clone

ID 1022-8317, Rev. 2.0Command SyntaxNetBootLoaderPage 33CLONE (Two NBL Flashes)FUNCTION: Program the NetBootLoader to NBL Flash memorySYNTAX:clone [-n

ID 1022-8317, Rev. 2.0Command Syntax NetBootLoaderPage 34 DESCRIPTION: Programming the NetBootLoader:• from the data buffer to the active NBL Flas

ID 1022-8317, Rev. 2.0Command SyntaxNetBootLoaderPage 35DHCPFUNCTION: Interface to a DHCP or BOOTP server; exchange network configuration parametersSY

ID 1022-8317, Rev. 2.0Command Syntax NetBootLoaderPage 36ECATFUNCTION: View or create boot script configuration files on the NAND FlashSYNTAX:ecat [-f

ID 1022-8317, Rev. 2.0Command SyntaxNetBootLoaderPage 37 USAGE: Create config file “nbl2.cfg”; attempt to create new config file; create new confi

ID 1022-8317, Rev. 2.0Command Syntax NetBootLoaderPage 38FDISKFUNCTION: Create or remove primary partitions on the NAND FlashSYNTAX:fdisk -p|-a <nu

ID 1022-8317, Rev. 2.0Command SyntaxNetBootLoaderPage 39 DESCRIPTION: This command is used to specify the partitioning of the NAND Flash and control

ID 1022-8317, Rev. 2.0Command Syntax NetBootLoaderPage 40 FDTFUNCTION: Enable creation of a flattened device tree (FDT)SYNTAX:fdt [<switch>]whe

ID 1022-8317, Rev. 2.0Command SyntaxNetBootLoaderPage 41 FDT_SHOWFUNCTION: Display the flattened device tree (FDT) information, and copy FDT inf

ID 1022-8317, Rev. 2.0 Page vNetBootLoader PrefaceList of Tables1 NetBootLoader Control Commands ...

ID 1022-8317, Rev. 2.0Command Syntax NetBootLoaderPage 42 FRUFUNCTION: Display a hexdump of the “FRU” dataSYNTAX:fruwhere:fru commandDESC

ID 1022-8317, Rev. 2.0Command SyntaxNetBootLoaderPage 43HELP or ?FUNCTION: Display online help pagesSYNTAX:help | ? [<cmdname>]where:help or ?

ID 1022-8317, Rev. 2.0Command Syntax NetBootLoaderPage 44 INFOFUNCTION: Display system informationSYNTAX:infoDESCRIPTION: The command INF

ID 1022-8317, Rev. 2.0Command SyntaxNetBootLoaderPage 45IPMIFUNCTION: Display IPMI informationSYNTAX:ipmiwhere:ipmi commandDESCRIPTION: This command i

ID 1022-8317, Rev. 2.0Command Syntax NetBootLoaderPage 46LF (NBL Flash)FUNCTION: Load Flash (active NBL Flash)SYNTAX:lf [<num>] [[-r]|[[-o[=]<

ID 1022-8317, Rev. 2.0Command SyntaxNetBootLoaderPage 47DESCRIPTION: If the “-o” option is specified, the contents are programmed exactly at this offs

ID 1022-8317, Rev. 2.0Command Syntax NetBootLoaderPage 48LOAD (NAND Flash)FUNCTION: Load an operating system image and optionally a RAMdisk filesystem

ID 1022-8317, Rev. 2.0Command SyntaxNetBootLoaderPage 49 USAGE: Sample configuration file for loading files:setcore 0;load -r initrd1 img1;md5 -r ini

ID 1022-8317, Rev. 2.0Command Syntax NetBootLoaderPage 50 LOGINFUNCTION: Initiate FTP server sessionSYNTAX:login <ip-of-host> <usernam

ID 1022-8317, Rev. 2.0Command SyntaxNetBootLoaderPage 51 LS (FTP)FUNCTION: When logged into an FTP server, this command displays a listing of t

ID 1022-8317, Rev. 2.0Page viPreface NetBootLoaderThis page has been intentionally left blank.

ID 1022-8317, Rev. 2.0Command Syntax NetBootLoaderPage 52 MDFUNCTION: Display visible memorySYNTAX:md [<adr>]where:md command<adr> parame

ID 1022-8317, Rev. 2.0Command SyntaxNetBootLoaderPage 53 MD5 (NAND Flash)FUNCTION: Performs checksum verification of the data buffer contentsSYNTAX:m

ID 1022-8317, Rev. 2.0Command Syntax NetBootLoaderPage 54 MKDIR,MKDIRCF(NAND Flash)FUNCTION: Create a directory on the NAND FlashSYNTAX:mkdi

ID 1022-8317, Rev. 2.0Command SyntaxNetBootLoaderPage 55 MKFS (NAND Flash)FUNCTION: Create a filesystem for the partition specified on the NAN

ID 1022-8317, Rev. 2.0Command Syntax NetBootLoaderPage 56MV, MVCF (NAND Flash)FUNCTION: Rename a file on the NAND FlashSYNTAX:mv -f <oldfilename>

ID 1022-8317, Rev. 2.0Command SyntaxNetBootLoaderPage 57NET (NON-AMC)FUNCTION: Set or display the parameters for the Ethernet interfaceSYNTAX:net [<

ID 1022-8317, Rev. 2.0Command Syntax NetBootLoaderPage 58NET (AMC)FUNCTION: Set or display the parameters for an Ethernet portSYNTAX:net [<num_net&

ID 1022-8317, Rev. 2.0Command SyntaxNetBootLoaderPage 59DESCRIPTION: To set or display the parameters of an Ethernet port the command NET is used.Init

ID 1022-8317, Rev. 2.0Command Syntax NetBootLoaderPage 60PASSWDFUNCTION: Set the telnet passwordSYNTAX:passwd [-f|-d]where:passwd command-f option:if

ID 1022-8317, Rev. 2.0Command SyntaxNetBootLoaderPage 61 PCIFUNCTION: Display PCI informationSYNTAX:pciDESCRIPTION: The command PCI is used to displa

ID 1022-8317, Rev. 2.0 Page viiNetBootLoader PrefaceProprietary NoteThis document contains information proprietary to Kontron. It may not be copied or

ID 1022-8317, Rev. 2.0Command Syntax NetBootLoaderPage 62 DESCRIPTION: To set or display the operational parameters for the serial interfacesthe

ID 1022-8317, Rev. 2.0Command SyntaxNetBootLoaderPage 63PINGFUNCTION: Verify operability of an Ethernet interfaceSYNTAX:ping <ip_addr> [-c <c

ID 1022-8317, Rev. 2.0Command Syntax NetBootLoaderPage 64 PUTFUNCTION: Upload contents of the data buffer to the FTP serverSYNTAX:put <fil

ID 1022-8317, Rev. 2.0Command SyntaxNetBootLoaderPage 65 RM, RMCF (NAND Flash)FUNCTION: Remove a file on the NAND FlashSYNTAX:rm <dirname>

ID 1022-8317, Rev. 2.0Command Syntax NetBootLoaderPage 66 RSFUNCTION: Reset the systemSYNTAX:rsDESCRIPTION: To permit the operator to forc

ID 1022-8317, Rev. 2.0Command SyntaxNetBootLoaderPage 67RUN (ASMP)FUNCTION: (Loads and) starts (a) bootable image(s)SYNTAX:run [-c] [<numcore0>

ID 1022-8317, Rev. 2.0Command Syntax NetBootLoaderPage 68 SAVEFUNCTION: Store contents of the data buffer to a file in the NAND FlashSYNTAX:save -

ID 1022-8317, Rev. 2.0Command SyntaxNetBootLoaderPage 69 SCRIPTFUNCTION: Provides very basic scripting capabilitySYNTAX:script [<newscr

ID 1022-8317, Rev. 2.0Command Syntax NetBootLoaderPage 70SFFUNCTION: Store NBL Flash memory contents to data bufferSYNTAX:sf (-o[=]<offset> -l[=

ID 1022-8317, Rev. 2.0Command SyntaxNetBootLoaderPage 71 SETCORE (ASMP)FUNCTION: Specify the core for which selected commands apply or display the cur

ID 1022-8317, Rev. 2.0Page viiiPreface NetBootLoaderThis page has been intentionally left blank.

ID 1022-8317, Rev. 2.0Command Syntax NetBootLoaderPage 72 SLFUNCTION: Download Motorola S-Records to data bufferSYNTAX:sl [-o[=]<offset>] [-u]

ID 1022-8317, Rev. 2.0Command SyntaxNetBootLoaderPage 73 SPEEDFUNCTION: Enables or disables fast bootingSYNTAX:speed [<switch>]whe

ID 1022-8317, Rev. 2.0Command Syntax NetBootLoaderPage 74SQ (NON-AMC / SMP)FUNCTION: Set or display the boot sequenceSYNTAX:sq [<num1><num2&g

ID 1022-8317, Rev. 2.0Command SyntaxNetBootLoaderPage 75SWAP (Two NBL Flashes)FUNCTION: Modify or display the current NBL Flash memory device usageSYN

ID 1022-8317, Rev. 2.0Command Syntax NetBootLoaderPage 76USAGE: Swap the NBL Flashes temporarily and verifyCOMMAND / RESPONSE:NetBtLd> swap -tFlash

ID 1022-8317, Rev. 2.0Command SyntaxNetBootLoaderPage 77 TFTPFUNCTION: Download file from a TFTP serverSYNTAX:tftp [-e] [<ip_addr>] [<filenam

ID 1022-8317, Rev. 2.0Command Syntax NetBootLoaderPage 78VERFUNCTION: Display version numberSYNTAX:verwhere:ver commandDESCRIPTION: The command VER di

ID 1022-8317, Rev. 2.0IntroductionNetBootLoaderPage 11. IntroductionThe NetBootLoader is a proprietary software utility for Kontron’s families of Powe