Command Reference

From dmon2
Jump to navigationJump to search

Command List

Command Description
429 reg show the ARINC429 registers
about display information about DMON version
ad convert perform ADC conversion for all channels and display the result
ad input [channel] perform ADC conversion for channel and display the result
ad reg displays contents of the ADC registers
ad reset performs a ADC Controller Reset
ad status displays some status information about the ADC interface
ahb <size> display AHB trace buffer
ahbstat display AHB status register
ahbtrace Print first 10 rows starting at trace buffer index
ahbtrace bp <n> [address] [mask] Sets breakpoint n mask and address
ahbtrace bselect Selects the bus to trace
ahbtrace delay [cnt] Sets the trace buffer delay counter (DCNT)
ahbtrace disable Disables ahbtrace
ahbtrace enable Enables ahbtrace
ahbtrace filter mmask [mask] Sets the mmask
ahbtrace filter smask [mask] Sets the smask
ahbtrace print <all|length> displays the AHB trace buffer
ahbtrace status display AHB trace buffer settings
breakh <addr|symbol> display breakpoints or add hardware breakpoint
breaks <addr|symbol> display or add software breakpoint
breaks <addr|symbol> <cpu> display or add software breakpoint
bt <cpu#> display stack trace for CPU. Active CPU by default.
bt cpuall display stack trace for each CPU.
buildprom <cmderase,cmdblank,cmdload,cmdrun> mkf Create prom by calling mkf in make utility. Pass flash commands as parameters. buildprom cmderase cmdload cmdrun my_make_file
callgraph <symbol> <regex> display callgraph from root <symbol> excluding symbols matching <regex>
can reg Displays contents of the CAN registers
check <bin> <addr> [file_name] compare an ELF32 or SRECORD file with target memory
clear <num> delete all breakpoints or number
clear <num|address> delete all breakpoints or breakpoint at number or address
cls clear console
code <addr|PC> <length> <mode> Disassemble <length> instructions starting at
code [addr] <length> disassemble memory
continue continue execution
cpu <enable|disable|active> <id> control processors in multi-processor (MP) systems
cwd <path> display or change working directory
da output [channel] [data] write data to output register and perform DAC conversions
da reg displays contents of the DAC registers
da reset performs a DAC Controller Reset
da status displays some status information about the DAC interface
datacache [disable | enable] disable
datacachelookup [addr] <cpu> display the data cache state if address generates cache hit
datamon load [filename] load a DataSet from an xml file
datamon save [filename] save the current DataSet to an xml file
datamon start Validate the current DataSet if successful start monitoring
datamon stop stop monitoring
datamon xsd [filename] save schema for DataSet to the specified file
ddr2cfg1/2/3/4/5 <value> display DDR2CFG registers or change initial values
ddr2delay <value> Set the 16 LSB of DDR2CFG3 to <value>
ddr2delay dec <steps> Decrement all tap delays <steps> times, once by default
ddr2delay inc <steps> Increment all tap delays <steps> times, once by default
ddr2delay reset Reset the tap delays to hardware default value
ddr2ftbnd display DDR2 FT BND register
ddr2ftcfg display DDR2 FT CFG register
ddr2ftda display DDR2 FT DA register
ddr2ftdc display DDR2 FT DC register
ddr2ftdd display DDR2 FT DD register
ddr2skew dec <steps> Decrement clock phase <steps> times once by default
ddr2skew inc <steps> Increment clock phase <steps> times once by default
ddr2skew reset Reset clock phase to hardware default value
ddr2tsr1 display DDR2 TSR1 register
ddr2tsr2 display DDR2 TSR2 register
deldowndir [all/fileName] Delete all/fileName in Download Directory on The Server
devreg list available devices
devreg <name> display registers in <name>
devreg <name> <regname> display register detail for <regname> in <name>
devreg <name> <regname> <value> Write <value> to <regname> in <name>
devreg <name> list list register names in <name>
digilent Change debug link to Digilent JTAG Link
dmode [val]<force> Change initial value of Debug Mode Mask Register symbol. Default is 0x0000ffff. If force flag is used, will apply to the target immediately. dmode 0xff force
dmon Use only DMON commands.
download [filename] downloads a file to the remote server
echo [string] display string in the console (and log file if active)
ehci cpregs display capability registers
ehci endian display endianness conversion settings
ehci oprregs display operational registers
ehci reset reset USB EHCI controller
ep [value] <cpu#> set entry point for active cpu or cpu with index
eth [xx.xx.xx.xx] change from using serial port to using ethernet EDCL
examine [addr] <length> display memory
exec [command] execute shell command in OS
flash display the on-board flash memory configuration
flash blank [all | addr] check that the flash memory is completely blank or blank ins specified range
flash erase erase flash device
flash erase [all | addr | addr] erase a flash block at address or the complete flash memory
flash id <1-5> display supported flash types or initialise selected flash type
flash info display flash CFI registers
flash load [file_name] program the flash memory with ELF or srecord files or binary
flash lock [all | addr] lock a flash block at address or the complete flash memory
flash status display the flash lock status register
flash unlock [all | addr] unlock a flash block at address or the complete flash memory
flash write [addr][data] write a 32-bit data word to the flash at address if block empty
float display FPU registers
font show current font
font list list system fonts
font reset reset the font to the default
font set [value] set font
ftdi Change debug link to FTDI JTAG Link
gb2312 Use GB2312 character set for displaying memory and UART data
gdb <port> listen for GDB on optional port.Default port is 1234
gdb detach stop listening for GDB connections.
getb [address] <count> Returns a byte or array of <count> bytes
getintlog [fileName] Get Server's Internal Log and save to file
getstate returns 1 if an application is running on
getvw [addr] <cpu#> translate virtual address to physical for cpu index
getw [address] <count> Returns a word or array of <count> words
go <addr> start execution without initialization
grcg 1 enable all Enable all bits for second GRCLKGATE device
grcg clkinfo Show register values for GRCLKGATE
grcg disable number Disable single bit for GRCLKGATE
grcg enable number Enable single bit for GRCLKGATE
halt stop program on board
help <command> display commands or command
hist <size> display instruction and AHB trace buffers
i2c [dev#] [enable|disable] enable or disable I2C Block
i2c [dev#] bitrate [normal|fast] set i2c bit rate to 100KHz (normal) or 400KHz (fast)
i2c [dev#] read [i2cAddr] read from i2c slave with address
i2c [dev#] read [i2cAddr][addr] read memory from i2c slave with address
i2c [dev#] scan scan for i2c devices
i2c [dev#] status display status and configuration
i2c [dev#] write [i2cAddr][data] write data to i2c slave with address
info dev list devices available for info dev command
info dev <name> display information for device <name>
info sys display basic system information
init reinitialize the target board
inscache [disable | enable] disable
inscachelookup [addr] <cpu> display instruction cache state if address generates cache hit
inst <size> display instruction trace buffer
irq boot <mask> Boot CPUs specified by mask (for IRQ(A)MP)
irq ctrl <n> Show/select controller register interface to use (for IRQ(A)MP)
irq force [n|clear] force interrupt n or clear force register
irq help display this help message
irq reg display some of the core registers
irq route

<n>

Route processor p to internal controller n (for IRQ(A)MP)
irq routing Decode controller routing (for IRQ(A)MP)
irq tstamp Show timestamp registers (for IRQ(A)MP)
irq wdog Decode Watchdog control register (for IRQ(A)MP)
itrace [enable|disable] enable or disable tracing
itrace [status|print] display status or tracing data
keepsession [yes|no] keep current session on server alive or not after client disconnects - for use on client only
l2cache [disable | enable] enable or disable l2cache
l2cache edac [disable | enable] enable or disable EDAC protection
l2cache error display error status
l2cache error inject inject error
l2cache error reset reset error status
l2cache flushinvalidate flush data to memory and invalidate all cache lines
l2cache hit display the hit rate statistics
l2cache hprot [disable | enable] enable or disable support for HPROT
l2cache invalidate invalidate all l2cache lines
l2cache lookup [addr] display data and status of cache line
l2cache mtrr [reg] [value] display or set MTRR registers
l2cache show [way][count][start] display way data of count lines starting from index
l2cache status display l2cache status
l2cache wt [disable | enable] enable or disable write-through
l4stat events Show all events that can be selected/counted
l4stat events [hex][abbr][descr] Add new event to DMON (hardware must support this code). hex->code value, abbr->abbreviation, descr->description
l4stat clear [cnt] Clear the counter cnt.
l4stat status Display status of all available counters.
l4stat display [workers|counters] <all|n> Display information on workers or counters
l4stat set [cnt][flag=value] Count the event using counter cnt on processor cpu. Use enable flag(en) the last. Available flags: cpu=val, event=val, cl=1|0, su=0|1|2, en=1|0
l4stat duration [cnt][enable|disable]<lvl> If Enabled the core will save the maximum time the selected event has been at the level specified by the EL field. If level(lvl) is present the counter will count the cycles, otherwise will count the time between event assertions
l4stat poll [cnt][int]<hold><save> Continuously poll counter(cnt) at interval(int)(min value 100 ms).If hold parameter is passed, DMON will poll for Counter control register till software enables the counter and only then will start to poll for counter value. If save parameter is used, DMON will save data to csv file
l4stat runpoll [cnt][int]<save> Poll counter(cnt) at interval(int)(min value 100 ms) while application is running. DMON will start polling, when program starts running on the board. If breakpoint is hit, DMON will pause polling and resume after program will continue. If save parameter is used, DMON will save data to csv file
l4stat stop [cnt|all] Stop polling of Counter Register for counter(cnt) or all and disable counter
linfo Print License Information
listdowndir List Download Directory on The Server
load <addr> [file] Load file to target; for .bin file start at <addr>
load <bin|&addr> [file_name] load a file to memory (elf/srec/bin) BIN forces file to be handled as binary; address is only relevant to binary.
log [file_name] open log file or create new and output some system information
loglevel [level] set internal logging to level
logoff stop output to file
lookup [hex value] show the ELF symbol matching the hex address
lookup [symbol or expression] show the value of the symbol (internal or ELF)
mcfg1/2/3 <value> display mcfg registers or change initial values
mcfg4 <value> display MEMCFG4 register or change initial values
memset clear SRAM and SDRAM
memset <start stop> <value> write value (zero by default) to memory from start up to stop.
mmcfg1 <value> MMCTRL Display mmcfg1 registers or change initial values
mmctrl en2t [enable/disable] MMCTRL Enable/disable 2T signaling (EN2T)
mil reg Show the 1553 Registers
mil status Show information about the 1553 Registers
mmu <mreg|cpntr|creg> <val> <cpu#> display or write MMU registers
mon [addr] [script] <bit> Runs script everytime addr value changes or bit is set (DMON unset's this if bit)
mon [pen][clr][msk][scrp][b] Runs script everytime bit at pen is set (DMON unset's this through clr address)
mon [stop] Stops IRQ monitoring if running
pause -1 pause script until processor stops
pause [duration in ms] pause script until duration has elapsed
pcitrace addrmask [addr] display or set address mask
pcitrace addrpattern [addr] display or set address pattern
pcitrace enable enable pci trace buffer and start recording
pcitrace info display pci trace buffer status
pcitrace print display PCI trace buffer
pcitrace sigmask [value] display or set control signals mask
pcitrace sigpattern [value] display or set control signals pattern
pcitrace tcounter [value] display or set trigger counter value
pcitrace tdelay [value] display or set delay value
precont [filename] append a script to the user scripts executed
precont list list the user scripts executed
precont remove [index|all] remove the script at [index] in the user scripts
prerun [filename] append a script to the user scripts executed
prerun insert [index] [filename] insert a script at [index] in the user scripts
prerun list list the user scripts executed
prerun remove [index|all] remove the script at [index] in the user scripts
printreg display system registers
profile [disable | enable] disable
python Interpret command input as Python commands.
quit exit DMON
ramedacie [address] Inject one bit error in SRAM at address.EDAC must be enabled
rcheck [file] execute check command on the server
reg show values for all available registers
reg <name> show register named
reg <name> <value> write value to register named
reg show show available register names
rexamine <addr><count> execute examine command on the server
rload <bin|&addr> [file_name] execute load command on the server
rlog [fileName] Start user log on server and store in server download directory
rscript [file] execute script command on the server
rstop execute stop command on the server
rtc display RTC info
rtc <bcd|binary> set RTC in BCD or Binary format
rtc <enable|disable> enable or disable RTC
rtc <h12|h24> set RTC in 12-hour or 24-hour format
rtc <time|date> display RTC time or date stamp
rtc reg display RTC registers
rtc set sys set system current time
rtcl execute tcl command on the server
rtems Read current RTEMS thread information (if available)
rtems dump dump structures used to read RTEMS thread information
run <addr> start execution at entry point or address
run <pc> start the CPU from <pc>
runscript [filename] set the user script executed during
runscript list list the user script executed during
runscript remove clear the user script executed during
save [addr] [addr] [file] <bin> dump target memory to file in srecord (or binary) format
savecfg [file_name] save the current device configuration to a cfg file
script [file_name] execute a batch file of DMON commands
scrub <status> Display status and configuration
scrub ack Clear error and done status and display status
scrub init [start] [stop] Set scrubber to initialise memory area from address start up to
scrub reg Display all registers
scrub reset Clear status and reset configuration
send send command to OS running on the board
setv [label] [expression] Sets a DMON label to have a 64 bit integer value
shell In a startup script activate the
show <symbol> Displays value associated with a user defined label, or a list of all user defined symbols and associated values
spi disable <N> Disable the SPI device
spi enable <N> Enable the SPI device
spi mode clear all <N> Clear all spi mode option(s)
spi mode set [flag <value>]* <N> Set spi mode option(s)
spi reg <N> Displays registers in the SPI device
spi rx <N> Read the RX register(s) for SPI device
spi selftest <N> Run SPI device selftest
spi status <N> Displays some status information about the SPI device
spi tx [data] ... <N> Transmit data using SPI device
spw reg <which> Display all registers in SPW module, module 0 by default
spw reset <which> Reset SPW module, module 0 by default
spw status <which> Display all registers in SPW module in detail, module 0 by default
spwr reg <which> Display all registers in SPWROUTER module, module 0 by default
spwr reset <which> Reset SPWROUTER module, module 0 by default
spwr status <which> Display all registers in SPWROUTER module in detail, module 0 by default l
stack <value> <cpu#> display stack pointer or change initial value to cpu/cpuall
step <n> single step one or [n] times
stop Invoked on CTRL-C. Abort DMON command
symbols <file> show/load symbols
tcl Interpret command input as Tcl commands.
telecommand reg Displays registers in the TC device
telecommand reset Writes reset value to Global Reset Register in TC device
telecommand status Displays some status information about the TC device
telemetry reg Displays registers in the TM device
telemetry status Displays some status information about the TM device
timer display information about the timers
timer reg display timer registers
tmode [none|inst|ahb|both] enable instruction and/or AHB trace buffers
uart <port name/number> Change debug link to UART. Optional port name or number
uartloopback disable <n|all> disable UART loopback
uartloopback enable <n|all> enable UART loopback
uartloopback show Show for each UART whether loopback is enabled
uhci endian <dev#> display endianness conversion settings
uhci ioregs <dev#> display I/O registers
uhci reset <dev#> reset USB UHCI controller/controllers
usb Change debug link to USB Link
utf8 Use UTF-8 character set for displaying memory and UART data
vexamine [addr] <length> display virtual memory
vwrite [addr][data]<count> write data to virtual memory
walk [addr]<ctnx><cpu#> translate virtual address and display steps
watch <addr|symbol> display all breakpoint or add data watchpoint on read or write
watch <addr|symbol> <cpu> display all breakpoint or add data watchpoint on read or write
watchr <addr|symbol> display all breakpoint or add data watchpoint on read
watchr <addr|symbol> <cpu> display all breakpoint or add data watchpoint on read
watchw <addr|symbol> display all breakpoint or add data watchpoint on write
watchw <addr|symbol> <cpu> display all breakpoint or add data watchpoint on write
write [addr] [data] <number words> write one word of data to "number words" starting from addr
write8 [addr] [data] <no bytes> write one byte of data to "no bytes" starting from addr
xilinx <PRODUCT ID> Change debug link to Xilinx JTAG Link

Available Commands on Target SOCs

The following top level commands are available; the columns with “*” show targets where the command is available since the associated hardware, if required, is present.

Note: The help command while using DMON connected to the target SOC will display the available commands for that SOC.
Command GR71 E698MIL E698P4 E698T E698PM N2X AT697F ARM Remote
429 *
about * * * * * * * * *
ad *
ahb * * * *
ahbstat * * *
ahbtrace *
breakh * * * * * * * * *
breaks * * * * * * * * *
bt * * * * * * * *
callgraph * *
can *
check * * * * * * * *
clear * * * * * * * * *
cls * * * * * * * * *
code * * * * * * * * *
continue * * * * * * * * *
cpu * * * * *
cwd * * * * * * * * *
da *
datacache * * * * * * * *
datacachelookup * * * * * * * *
datamon * * * * * * * * *
ddr2cfg1/2/3/4/5 * *
ddr2delay * *
ddr2ftbnd * *
ddr2ftcfg * *
ddr2ftda * *
ddr2ftdc * *
ddr2ftdd * *
ddr2skew * *
ddr2tsr1 * *
ddr2tsr2 * *
deldowndir *
devreg *
digilent * *
dmon * * * * * * * * *
download *
echo * * * * * * * * *
ehci *
ep * * * * * * * *
eth * * * *
examine * * * * * * * * *
exec * * * * * * * * *
flash * * * * * * * * *
float * * * * * * * *
font * * * * * * * * *
ftdi * *
gb2312 * * * * * * * * *
gdb * * * * * * * *
getb * * * * * * * * *
getintlog *
getstate * * * * * * * * *
getvw * * *
getw * * * * * * * * *
go * * * * * * * *
grcg * *
halt * * * * * * * * *
help * * * * * * * * *
hist * * * *
i2c * *
info * * * * * * * * *
init * * * * * * * *
inscache * * * * * * * *
inscachelookup * * * * * * * *
inst * * * *
irq * * * * * * * *
itrace * *
keepsession *
l2cache * *
l4stat *
listdowndir *
load *
log * * * * * * * * *
loglevel * * * * * * * * *
logoff * * * * * * * * *
lookup * * * * * * * * *
mcfg1/2/3 * * * * * * * *
mcfg4 * * * *
memset * * * * * * * *
mil * * * * * *
mmu * * *
mon * * * * * * * * *
pause * * * * * * * * *
pcitrace *
precont * * * * * * * * *
prerun * * * * * * * * *
printreg * * * * * * * * *
profile * * * * * * * *
python * * * * * * * * *
quit * * * * * * * * *
rcheck *
reg *
rexamine *
rload *
rlog *
rscript *
rstop *
rtc *
rtcl *
rtems * * * * * * * *
run * * * * * * * * *
runscript * * * * * * * * *
save * * * * * * * * *
savecfg * * * * * * * *
script * * * * * * * * *
scrub * *
send * * *
setv * * * * * * * * *
shell * * * * * * * * *
show * * * * * * * * *
spi * * *
spw * * *
spwr *
stack * * * * * * * *
step * * * * * * * * *
stop * * * * * * * * *
symbols * * * * * * * * *
tcl * * * * * * * * *
telecommand * *
telemetry * *
timer * * * * * * * *
tmode * * * *
uart * * * * * *
uartloopback * * * * * * * *
uhci *
usb *
utf8 * * * * * * * * *
vexamine * * *
vwrite * * *
walk * * *
watch * * * * * * * * *
watchr * * * * * * * * *
watchw * * * * * * * * *
write * * * * * * * * *
xilinx * *