3.03 Mb

Monitor: EEPROM/I2C Commands


The icrc32 computes a CRC32 checksum.

Definition: icrc32 chip address[.0, .1, .2] count


The iloop command reads in an infinite loop on the specified address range.

Definition: iloop chip address[.0, .1, .2] [# of objects]


The imd command displays the primary I2C bus memory. For example:

imd 53 1800.2 100

displays 100 bytes from offset 0x1800 of I2C device 0x53(right-shifted7-bitaddress). The

.2 at the end of the offset is the length, in bytes, of the offset information sent to the device. The serial EEPROMs all havetwo-byteoffset lengths. TheReal-TimeClock (RTC) has aone-byteoffset length. The temperature sensors havezero-byteoffset lengths.

Definition: imd chip address[.0, .1, .2] [# of objects]


The imd2 command displays the secondary I2C bus memory. For example:

imd 53 1800.2 100

displays 100 bytes from offset 0x1800 of I2C device 0x53(right-shifted7-bitaddress). The

.2 at the end of the offset is the length, in bytes, of the offset information sent to the device. The serial EEPROMs all havetwo-byteoffset lengths. The RTC has aone-byteoffset length. The temperature sensors havezero-byteoffset lengths.

Definition: imd2 chip address[.0, .1, .2] [# of objects]


The imm command modifies the primary I2C memory and automatically increments the address.

Definition: imm chip address[.0, .1, .2]


The imm2 command modifies the secondary I2C memory and automatically increments the address.

Definition: imm2 chip address[.0, .1, .2]


KAT4000 User’s Manual





Monitor: IPMC Commands


The imw command writes (fills) memory.

Definition: imw chip address[.0, .1, .2] value [count]


The inm command modifies I2C memory, reads it, and keeps the address.

Definition: inm chip address[.0, .1, .2]


The iprobe command probes to discover valid primary I2C bus chip addresses.

Definition: iprobe


The iprobe command probes to discover valid secondary I2C bus chip addresses.

Definition: iprobe2


The switchsrom command reads bytes from the VSC7376 GbE switch EEPROM and writes bytes to the EEPROM.

Definition: switchsrom read <offset> <size> switchsrom write <source address> <size>


IPMI Baseboard Management Controller (BMC) watchdog is supported and serviced throughout the monitor boot process. The BMC watchdog is disabled if the monitor goes to the monitor prompt.


The fru command opens, closes, saves, sets, shows, dumps, and loads fru data to and from the IPMC.

Definition: fru <command> [ arg1 arg2 … ]

command := [ open | close | save | set | show | dump | load | create ] fru open <id>

fru close fru save

fru set <section [chassis|board|product]><field><value>

fru set <section> <field> <value> section := [ chassis | board | product ]


KAT4000 User’s Manual





Monitor: IPMC Commands

fru set chassis <field> <value> field := [ type | part | serial ]

fru set board <field> <value>

field := [ date | maker | name | serial | part | file ]

fru set product <field> <value>

field := [ maker | name | part | version |serial | asset | file ]

fru show

fru dump <address>

fru load <address><size>

Set data in the internal use area.

fru set internal <source addr> <internal use offset> <count>

The fru create command loads a default fru image to a blankfru device.

fru create <id> default <product name>

fru create <id> <address> <size> <product name>


The fruinit command initializes the following fru data fields: part number, build date, and serial number in the board and product sections.

Definition: fruinit <fru id> <part number> <build date> [ serial number ]


The fruled command allows the application programmer to get the status of the red out-of-service LED or to turn the LED on or off when an application fails to load.

Definition: fruled get <fru id> <led id> <led state> <led function (on/off)> <on time> <color> fruled set <fru id> <led id> <led function (on/off)> <on time> <color>

Example: Turns the redout-of-serviceLED on.

fruled set 0 1 0xff 0 2

Turns the red out-of-serviceLED off.

fruled set 0 1 0 0 2


The ipmcfw command restores the previous IPMC firmware from the backup IPMC firmware stored in the controller. The upgrade argument upgrades the IPMC firmware with the upgrade image held in memory.

Definition: ipmcfw [restore] [upgrade <source address>]


The sensor command probes, reads, and prints the sensor information from the IPMI.


KAT4000 User’s Manual





Monitor: Environment Parameter Commands

Definition: sensor [probe|read|dump]

Sensor probe prints out each sensor number and name.

sensor probe <sensor number>

Sensor read prints out the sensor reading for sensor.

sensor read <sensor number>

Sensor dump prints out the raw Sensor Data Record (SDR) information for sensor.

sensor dump <sensor number>


The monitor uses on-board,non-volatilememory for the storage of environment parameters. Environment parameters are stored as ASCII strings with the following format.

<Parameter Name>=<Parameter Value>

Some environment variables are used for board configuration and identification by the monitor. The environment parameter commands deal with the reading and writing of these parameters. Refer to “Environment Variables” on page 14-28for a list of monitor environment variables.

Redundant environment parameters allow you to store a “backup” copy of environment parameters should they ever become corrupt. The redundant environment parameters are only used if the main parameters are corrupt.

To save environment variables:

1Use moninit to save default environment variables to both primary and secondary environment parameters.

2Use saveenv to save to the primary environment variables.

3Set the next save to the secondary image. For example:

Primary Env Variables


Secondary Env Variables, if installed (0xE1F6,0000)


KAT4000 User’s Manual





Monitor: Test Commands


The printenv command displays all of the environment variables and their current values to the display.

Definition: Print the values of all environment variables.


Print the values of all environment variable (exact match) ‘name’.

printenv name …


The saveenv command writes the environment variables to non-volatilememory.

Definition: saveenv


The setenv command adds new environment variables, sets the values of existing environment variables, and deletes unwanted environment variables.

Definition: Set the environment variablename tovalue or adds the new variablename andvalue to the environment.

setenv name value

Removes the environment variable name from the environment.

setenv name


The commands described in this section perform diagnostic and memory tests.


The diags command runs the Power-OnSelf-Test(POST).

Definition: diags


The mtest command performs a simple SDRAM read/write test.

Definition: mtest [start [end [pattern]]]


KAT4000 User’s Manual





Monitor: Other Commands


The um command is a destructive memory test. Press the ‘q’ key to quit this test; the monitor completes running the most recent iteration, and exits to the default prompt after displaying cumulative results for the completed iterations.

Definition: um [.b, .w, .l] base_addr [top_addr]


This section describes all the remaining commands supported by the KAT4000 monitor.


The autoscr command runs a script, starting at address addr, from memory. A valid autoscr header must be present.

Definition: autoscr [addr]


The base command prints or sets the address offset for memory commands.

Definition: Displays the address offset for the memory commands.


Sets the address offset for the memory commands to off.

base off


The bdinfo command displays the Board Information Structure.

Definition: bdinfo


The coninfo command displays the information for all available console devices.

Definition: coninfo


The crc32 command computes a CRC32 checksum on count bytes starting ataddress.

Definition: crc32 address count


The date command will set or get the date and time, and reset the RTC device.


KAT4000 User’s Manual





Monitor: Other Commands

Definition: Set the date and time.

date [MMDDhhmm[[CC]YY][.ss]]

Display the date and time.


Reset the RTC device.

date reset


The echo command echoes args to console.

Definition: echo [args..]


The enumpci command enumerates the PCIe bus (when the hardware is the PCIe Root Complex in the system).

Definition: enumpci


The go command runs an application at address addr, passing the optional argumentarg to the called application.

Definition: go addr [arg…]


The help (or ?) command displays the online help. Without arguments, all commands are displayed with a short usage message for each. To obtain more detailed information for a specific command, enter the desired command as an argument.

Definition: help [command …]


The iminfo command displays the header information for an application image that is loaded into memory at address addr. Verification of the image contents (magic number, header, and payload checksums) are also performed.

Definition: iminfoaddr [addr …]


The isdram command displays the SDRAM configuration information (valid chip values range from 50 to 57).


KAT4000 User’s Manual





Monitor: Other Commands

Definition: isdram addr


The loop command executes an infinite loop on address range.

Definition: loop [.b, .w, .l] address number_of_objects


The memmap command displays the board’s memory map layout.

Definition: memmap


The moninit command resets the NVRAM and serial number, and it writes the monitor to Flash. The KAT4000 must be booted from the boot socket for this command to function in the default state. The proper region of Flash memory will be unlocked and erased prior to copying the monitor software into it.

The command flags, .s or .d, force the monitor to be programmed to a single (.s) bank of flash or dual (.d) banks of flash. If the command flags are not used, then moninit checks for the number of banks of flash. If there are two banks of flash, then moninit automatically programs both banks for redundancy. Also, the serial number can be obtained from the fru data if “fru” is used as a parameter.

Definition: Initialize environment variables and serial number in NVRAM and copy the monitor from the socket to NOR (soldered) Flash.

moninit[.s, .d] <serial# or “fru”>

Initialize environment variables and serial number in NVRAM but do not update the monitor in NOR Flash.

moninit[.s, .d] <serial# or “fru”> noburn

Initialize environment variables and serial number in NVRAM and copy the monitor from

<src_address> into NOR Flash.

moninit[.s, .d] <serial# or “fru”> <src_address>


The pci command enumerates the PCI bus. It displays enumeration information about each detected device. The pci command allows you to display values for and access the PCI Configuration Space.

Definition: Display a short orlong list of PCI devices on the bus specified bybus.

pci [bus] [long]


KAT4000 User’s Manual





Monitor: Other Commands

Show the header of PCI device bus.device.function.

pci header b.d.f

Display the PCI configuration space (CFG).

pci display[.b, .w, .l] b.d.f [address] [# of objects]

Modify, read, and keep the CFG address.

pci next[.b, .w, .l] b.d.f address

Modify, automatically increment the CFG address.

pci modify[.b, .w, .l] b.d.f address

Write to the CFG address.

pci write[.b, .w, .l] b.d.f address value


The phy command reads or writes to the contents of the PHY registers. The values changed via this command are not persistent and clear after a hard or soft reset. The port options are all, eTSEC1, eTSEC2, eTSEC3, and eTSEC4, and base1 and base2 via the switch. “R” reads the register contents at the address specified. “W” writes the address value to the register address specified. “A” reads the contents of all registers.

Definition: phy [port] [R|W|A] (address) (value)

Example: The following is an example of a read of register address 0x1a.

phy eTSEC2 r 0x1a

The following is an example of a write to register address 0x1a where 0 is the data to write.

phy eTSEC2 w 0x1a 0


The ping command sends a ping over Ethernet to check if the host can be reached. The port used is defined by the ethport environment variable. Ifall is selected forethport, the ping process cycles through each port until a connection is found or all ports have failed.

Definition: ping host


The reset command performs a hard reset of the CPU by writing to the reset register on the board. Without any arguments, the KAT4000 CPU is reset.

Definition: reset


KAT4000 User’s Manual





Monitor: Other Commands


The run command runs the commands in an environment variable var.

Definition: run var [ … ]

Use $ for variable substitution; the syntax “$(variable_name)” should be used for variable expansion.

Example: => setenv cons_opts console=tty0 console=ttyS0,\$(baudrate)

=> printenv cons_opts cons_opts=console=tty0 console=ttyS0,$(baudrate)

Use the \ character to escape execution of the $ as seen in the setenv command above. In this example, the value for baudrate will be inserted when cons_opts is executed.


The script command runs a list of monitor commands out of memory. The list is an ASCII string of commands separated by the ; character and terminated with the;; characters.<script address> is the starting location of the script.

Note: A script is limited to 1000 characters.

Definition: script <script address>


The showmac command displays the Processor MAC addresses assigned to each Ethernet port.

Definition: showmac


The showpci command scans the PCIe bus and lists the base address of the devices. The default PCI interface is PCI 1.

Definition: showpci


The sleep command executes a delay of N seconds.

Definition: Delay execution for N seconds (N is a decimal value).

sleep N


KAT4000 User’s Manual