Common Commands

The general format of commands is:
command <options, parameters>
Elements are separated by the space character. Other control characters, such as Tab or editing keys (Insert) are not currently supported.

Numbers, such as a memory location, may be specified in either decimal or hexadecimal (requires a 0x prefix).

Commands may be abbreviated to any unique string. For example, lo is equivalent to loa and load.

Connectivity

ip_address [-l <local_ip_address>] [-h <server_address>]

This command is used to show/change the basic IP addresses used by RedBoot. The -l option is used to set the IP address used by the target device. The -h option is used to set the default server address, such as is used by the load command.

ping - Check network connectivity ping

ping [-v] [-n <count>] [-l <length>] [-t <timeouts>] [-r <rate>][-i <IP_addr>] -h <IP_addr>

The ping command checks the connectivity of the local network by sending special (ICMP) packets to a specific host. These packets should be automatically returned by that host. The command will indicate how many of these round-trips were successfully completed.

Arguments

General

dump -b <location> [-l <length>] [-s]

Display (hex dump) a range of memory.

This command displays the contents of memory in hexadecimal format. It is most useful for examining a segment of RAM or flash. If the optional -s switch is provided, then the dump will be formatted as Motorola S-records. The x command is a synonym for dump.

Note that this command could be detrimental if used on memory mapped hardware registers.

The memory is displayed at most sixteen bytes per line, first as the raw hex value, followed by an ASCII interpretation of the data.
RedBoot> du -b 0x100 -l 0x80
0x00000100: 3C60 0004 6063 2000 7C68 03A6 4E80 0020 |<`..`c .|h..N.. |
0x00000110: 0000 0000 0000 0000 0000 0000 0000 0000 |................|
0x00000120: 0000 0000 0000 0000 0000 0000 0000 0000 |................|
0x00000130: 0000 0000 0000 0000 0000 0000 0000 0000 |................|
0x00000140: 0000 0000 0000 0000 0000 0000 0000 0000 |................|
0x00000150: 0000 0000 0000 0000 0000 0000 0000 0000 |................|
0x00000160: 0000 0000 0000 0000 0000 0000 0000 0000 |................|
0x00000170: 0000 0000 0000 0000 0000 0000 0000 0000 |................|
RedBoot> d -b 0xfe00b000 -l 0x80
0xFE00B000: 2025 700A 0000 0000 4174 7465 6D70 7420 | %p.....Attempt |
0xFE00B010: 746F 206C 6F61 6420 532D 7265 636F 7264 |to load S-record|
0xFE00B020: 2064 6174 6120 746F 2061 6464 7265 7373 | data to address|
0xFE00B030: 3A20 2570 205B 6E6F 7420 696E 2052 414D |: %p [not in RAM|
0xFE00B040: 5D0A 0000 2A2A 2A20 5761 726E 696E 6721 |]...*** Warning!|
0xFE00B050: 2043 6865 636B 7375 6D20 6661 696C 7572 | Checksum failur|
0xFE00B060: 6520 2D20 4164 6472 3A20 256C 782C 2025 |e - Addr: %lx, %|
0xFE00B070: 3032 6C58 203C 3E20 2530 326C 580A 0000 |02lX <> %02lX...|
0xFE00B080: 456E 7472 7920 706F 696E 743A 2025 702C |Entry point: %p,|
RedBoot> x -b 0x3e00000 -s -l 0x80
S31503E00000803C04E980880000808800008088000046
S31503E00010825010188948100088400001C01A040174
S31503E00020825010188948100088400002C01A03FD68
S31503E00030825010188948100088400003C01A03F95B
S31503E00040825010188948100088400004C01A03F54E
S31503E00050825010188948100088400005C01A03F141
S31503E00060825010188948100088400006C01A03ED34
S31503E00070825010188948100088400007C01A03E927

Download Process

Arguments

fileThe name of the file on the TFTP server or the local disk. Details of how this is specified for TFTP are host-specific. For local disk files, the name must be in disk: filename format. The disk portion must match one of the disk names listed by the disks command.
-vDisplay a small spinner (indicator) while the download is in progress. This is just for feedback, especially during long loads. Note that the option has no effect when using a serial download method since it would interfere with the protocol.
-dDecompress gzipped image during download.
-cSpecify which I/O channel to use for download. This option is only supported when using either xmodem or ymodem protocol.
-bSpecify the location in memory to which the file should be loaded. Executable images normally load at the location to which the file was linked. This option allows the file to be loaded to a specific memory location, possibly overriding any assumed location.
-rDownload raw data. Normally, the load command is used to load executable images into memory. This option allows for raw data to be loaded. If this option is given, -b will also be required.
-m

The -m option is used to select the download method. The choices are:

xmodem, ymodem

serial download using standard protocols over a port. If no -c option is used, the current console port will be used, otherwise the protocol transfer will take place on the specified channel. When using this method, the file parameter is not required.

tftp

network based download using the TFTP protocol.

disk

load a file from local disk.

-hUsed explicitly to name a host computer to contact for the download data. This works in TFTP mode only.

RedBoot> lo redboot.ROM -b 0x8c400000
Address offset = 0x0c400000
Entry point: 0x80000000, address range: 0x80000000-0x8000fe80