2.10.10. Using the Network Flash Utility

The Network Flash Utility (NFU) is supplied with V2.0 of the firmware. This utility uses the TFTP protocol to access files over the Ethernet network. You can copy files to Disk on Chip or program them into flash.

To connect to a server and program a file to flash:

  1. Start the NFU utility from the debugger console:

    1. Set the on setting the Boot Monitor configuration switches to force the console to use either UART-0 or the LCD and keyboard. See Boot Monitor configuration switch for details.

      Note

      The debugger console cannot be used because the semihosted console I/O is blocking.

    2. Start the NFU utility.

      Note

      It typically takes several seconds for NFU start. Do not enter any commands until the prompt is displayed.

  2. Use the DHCP protocol get an IP address by entering:

    manage dhcpc start
    
  3. Use the map command to map a drive letter to the TFTP server. For example to access a file on a TFTP server with the IP address 192.168.0.1, use:

    manage map n: 192.168.0.1
    
  4. After the drive letter has been mapped, use the normal Boot Monitor command on the remote file by specifying the drive letter:

    flash write image n:/hello.axf
    

NFU commands

The NFU supports most of the standard Boot Monitor commands and adds a new MANAGE submenu.

The NFU commands are listed in Table 2.12.

Table 2.12. NFU commands

CommandAction
CONVERT BINARY binary_file LOAD_ADDRESS address [ENTRY_POINT address]Provides information to the system that is required by the RUN command in order to execute a binary file. A new file with name binary_file is produced, but with an .exe file extension.
DIRECTORY [directory]

List the files in a directory.

Files that only accessible from semihosting cannot be listed.

EXITExit the NFU. The processor is held in a tight loop until it is interrupted by a JTAG debugger.
FLASHEnter the flash file system for the NOR flash on the baseboard. See Table 2.10 for flash commands.
HELPLists the NFU commands.
MANAGE

Enter the network management submenu. See Table 2.13 for MANAGE commands.

QUITAlias for EXIT. Exit the Boot Monitor.

The MANAGE submenu listed in Table 2.13 contains the network management commands.

Entering MANAGE on the command line means that all future commands, until EXIT is entered, are commands from the MANAGE submenu.

A single command can be executed by entering MANAGE followed by the command. For example, MANAGE DHCP START gets a IP address from the DHCP server. The next command entered must be from an NFU command.

Table 2.13. NFU MANAGE commands

CommandAction
ARP [-a]Display Address Resolution Protocol host table.
ARP -s hostnameAdd static entry to ARP table.
ARP -d hostnameDelete static entry from ARP table.
DHCPC START ifnameUse Dynamic Host Configuration Protocol (DHCP) to start a connection with the network interface ifname.
DHCPC RELEASE ifnameUse DHCP to release the connection with the network interface ifname.
DHCPC SIZEOFReturns information on the size of the DHCP packet.
DHCP INFORM ifname ip_addressUses the DHCP protocol send information to the server located at ip_address with the network interface ifname.
EXITExit the MANAGE submenu. The commands listed in Table 2.12 can be entered at the NFU prompt.
HELPLists the NFU MANAGE commands.
IFCONFIG Displays the IP settings that are used for communications with the server.
IFCONFIG [ifname [ip_address]]Displays the current IP address if ip_address is not suppled. Otherwise, the current IP address for the interface ifname is set to ip_address.
IFCONFIG [ifname [option]]

Configures the IP interface ifname. The value for option can be:

netmask maskvalue

set the netmask

dstaddr address

set the destination IP address

mtu n

set the maximum transfer unit

up

activate the interface

down

shutdown the interface

MAP drive addressMaps the IP address specified in address to drive.
NETSTAT [-option]

Displays active network connections. The value for option can be:

a

display all connections

m

display all multicast connections

i

display interface information

im

display interface information for multicast

r

display routing table

s

display statistics

b

display buffer usage

PING ip_addressSend ICMP ECHO_REQUEST packets to the network host. The data in the packet is returned by the host. Reception of the return packet indicates that the TCP/IP connection is functioning.
QUITAlias for EXIT. Exit the MANAGE submenu.
ROUTE ADD type target [NETMASK mask] gateway

Adds a static route to the network address specified by target. The gateway address is specified by gateway.

type can be either -net or -host.

If NETMASK is used, mask is the netmask for the target network address.

ROUTE DEL targetDeletes the static route to the network address specified by target.
SHOW DNSDisplays Domain Name System (DNS) configuration details received from DHCP.

Using a script file with NFU

When NFU starts, if attempts to run the NETSTART.BAT file on the Disk on Chip. If the script does not exist, a prompt is displayed on the console. For example, to map a drive and write a file to flash, create the following script file:

manage map n: 192.168.0.1
flash write image n:/hello.axf

After the file is executed, you can enter additional NFU commands. To run the file, reset the board and use the RUN command from Boot Monitor.

Copyright © 2005-2011 ARM Limited. All rights reserved.ARM DUI 0411D
Non-Confidential