Command Reference
Commands
?
Alias for temu-help.
add-eth-delay
Add delay to eth link
as
Alias for memory-assemble.
assemble
Alias for memory-assemble.
b
Alias for breakpoint-set.
bp-del
Alias for breakpoint-delete.
bp-list
Alias for breakpoint-list.
bp-set
Alias for breakpoint-set.
break
Alias for breakpoint-set.
break-del
Alias for breakpoint-delete.
break-delete
Alias for break-uart-delete.
break-list
Alias for breakpoint-list.
break-print
Alias for break-uart-list.
break-set
Alias for breakpoint-set.
break-uart
Create breakpoint using uart logging
break-uart-delete
Print all breakpoints for an object
can-bus-disconnect
Disconnect device from CAN bus
can-connect
Alias for can-bus-connect.
can-disconnect
Alias for can-bus-disconnect.
checkpoint
Alias for snapshot-save.
checkpoint-restore
Alias for snapshot-restore.
checkpoint-save
Alias for snapshot-save.
class-generate-reg-images
Generate register packetdiag images for class
| This command does not have any aliases. |
class-list
List all classes
| This command does not have any aliases. |
| This command takes no named arguments. |
clear-faulty
Alias for memory-clear-faulty.
component-forest
Print component forrest
| This command does not have any aliases. |
| This command takes no named arguments. |
config-bool
Print configuration entry
| This command does not have any aliases. |
| This command takes no named arguments. |
config-float
Print configuration entry
| This command does not have any aliases. |
| This command takes no named arguments. |
config-int
Print configuration entry
| This command does not have any aliases. |
| This command takes no named arguments. |
config-str
Print configuration entry
| This command does not have any aliases. |
| This command takes no named arguments. |
config-uint
Print configuration entry
| This command does not have any aliases. |
| This command takes no named arguments. |
connect
Alias for object-connect.
connect-timesource
Alias for object-set-timesource.
cpu-disable-mode-switch-events
Disable generation on mode switch events.
| This command does not have any aliases. |
cpu-enable-mode-switch-events
Enable generation of mode switch events. Note that no event handler will be installed. By default the events will not be reported for performance reasons. To for example get a message for every mode switch, a mode switch event listner must also be installed by e.g. a plugin.
| This command does not have any aliases. |
cpu-enable-trap-events
Enable generation of trap events. Note that no event handler will be installed. By default the events will not be reported for performance reasons. To for example get a message for every trap, a trap handler event listner must also be installed by e.g. a plugin.
| This command does not have any aliases. |
cpu-set-reg
set register
del
Alias for breakpoint-delete.
delwp
Alias for watchpoint-delete.
deserialise
Alias for snapshot-restore.
deserialize
Alias for snapshot-restore.
diag-err
Alias for diag-error.
diag-warn
Alias for diag-warning.
dis
Alias for memory-disassemble.
disable-binary-translation
Disable binary translation for all processors that supports it.
| This command does not have any aliases. |
| This command takes no named arguments. |
disassemble
Alias for memory-disassemble.
echo
Write string to stdout
| This command does not have any aliases. |
| This command takes no named arguments. |
elf-load
Alias for experimental-elf-load.
enable-binary-translation
Enable binary translation for all processors supporting it.
| This command does not have any aliases. |
| This command takes no named arguments. |
env
Alias for var-print-all.
err
Alias for diag-error.
eth-connect
Alias for ethernet-connect.
eth-delay
Alias for add-eth-delay.
eth-disconnect
Alias for ethernet-disconnect.
eth-enable-capture
Alias for ethernet-enable-capture.
ethernet-enable-capture
Enable capture to file
event-list
List all events, sources and event ids
| This command does not have any aliases. |
| This command takes no named arguments. |
exec
Alias for temu-exec.
exec-path-append
Append search path for the exec command
| This command does not have any aliases. |
| This command takes no named arguments. |
exec-path-list
List search paths used by the exec command
| This command does not have any aliases. |
| This command takes no named arguments. |
exec-path-prepend
Prepend search paths for the exec command
| This command does not have any aliases. |
| This command takes no named arguments. |
exit
Alias for temu-quit.
exp-pcr
Alias for experimental-print-class-registers.
exp-pcregs
Alias for experimental-print-class-registers.
exp-pr
Alias for experimental-print-registers.
exp-pregs
Alias for experimental-print-registers.
exp-set-field
Alias for experimental-register-set-field.
exp-write-field
Alias for experimental-register-write-field.
experimental-debug-demute-break
Unmute break point, when hit a message will be printed.
| This command does not have any aliases. |
experimental-debug-enable-auto-resume
| This command does not have any aliases. |
| This command takes no named arguments. |
experimental-debug-ignore-break
Set break point action to resume simulator. I.e. sim should ignore it.
| This command does not have any aliases. |
experimental-debug-list-contexts
| This command does not have any aliases. |
| This command takes no named arguments. |
experimental-debug-mute-break
Mute break point, when hit no message will be printed.
| This command does not have any aliases. |
experimental-debug-stop-break
Set break point action to stop simulator.
| This command does not have any aliases. |
get-attr
Alias for memory-get-attrs.
graph
Alias for object-generate-graph.
h
Alias for temu-help.
help
Alias for temu-help.
i
Alias for object-info.
i2c-bus-disconnect-target
Disconnect a target device from a I2C bus
| This command does not have any aliases. |
import
Alias for plugin-load.
import-env
Alias for var-init-from-environment.
import-global
Alias for plugin-load-global.
info
Alias for object-info.
license
Alias for license-info.
load
Alias for memory-load.
log-debug
Emit debug log message. Debug messages are only emitted in the asserts builds of TEMU.
| This command does not have any aliases. |
| This command takes no named arguments. |
log-disable-colours
Disable logging with colors to stdout/stderr
| This command does not have any aliases. |
| This command takes no named arguments. |
log-enable-colours
Enable logging with colors to stdout/stderr
| This command does not have any aliases. |
| This command takes no named arguments. |
log-error
Emit error log message
| This command does not have any aliases. |
| This command takes no named arguments. |
log-fatal
Emit fatal log message
| This command does not have any aliases. |
| This command takes no named arguments. |
log-info
Emit info log message
| This command does not have any aliases. |
| This command takes no named arguments. |
log-level
Show and set log level Log level is set by giving one of: fatal, error, warning, info, trace or debug as a positional argument
| This command does not have any aliases. |
log-set-file
Set file for TEMU log. Setting file to '<default>' will restore default behaviour. The log file will be appended to if it already exist.
| This command does not have any aliases. |
log-trace
Emit trace log message
| This command does not have any aliases. |
| This command takes no named arguments. |
log-warn
Emit warning log message
| This command does not have any aliases. |
| This command takes no named arguments. |
map
Alias for memory-map.
memory-clear-faulty
Clear multiple event upset / uncorrectable bit
memory-clear-upset
Clear single event upset bit
memory-clear-user
Clear user definable attribute in memory space
| This command does not have any aliases. |
memory-disassemble
disassemble memory range
memory-load
Load file to memory. Set the address parameter to treat the file as binary, otherwise the type will be auto-detected.
Arguments
| Option | Type | Description |
|---|---|---|
obj |
object |
|
file |
path |
|
addr |
integer |
Address to load file to (if set, treating file as binary) |
dwarf |
integer |
enable experimental dwarf parsing |
start-addr-var |
string |
Variable name to set start address in. |
use-pa |
integer |
Use physical load address instead of virtual (supported by ELF files) |
memory-map
Maps object in a memory space. An object can be either given with the object argument in which case the default memory access interface of MemAccessIface will be used. If 'iface' is specified instead, an explicit memory access interface can be provided. This is usefulf for devices that multiple memory ranges to map.
memory-read
Show the contents of the memory
memory-set-faulty
Simulate multiple event upset / uncorrectable
memory-set-upset
Simulate single event upset
memory-set-user
Set user definable attribute in memory space
| This command does not have any aliases. |
memory-write
write memory contents
meu
Alias for memory-set-faulty.
meu-clear
Alias for memory-clear-faulty.
meu-set
Alias for memory-set-faulty.
mil-std-1553-connect
Connect remote terminal to 1553 bus
milbus-connect
Alias for mil-std-1553-connect.
milbus-disconnect
Alias for mil-std-1553-disconnect.
milbus-setbc
Alias for mil-std-1553-setbc.
notification-list
List all notifications
| This command does not have any aliases. |
| This command takes no named arguments. |
object-assembly-complete
Mark the end of object assembly in a script. This will emit the temu.object-assembly-complete notification.
| This command does not have any aliases. |
| This command takes no named arguments. |
object-assembly-started
Mark the start of object assembly in a script. This will ensure temu.object-assembly-complete is published.
| This command does not have any aliases. |
| This command takes no named arguments. |
object-connect
connect two objects
object-generate-graph
Generate the object graph as a dot file. If display is set to non-zero, the graph will be rendered and displayed using eog and a random file name will be generated in the current dir. NOTE: You need eog and graphviz installed to actually display the graph.
object-list
List all objects
| This command does not have any aliases. |
| This command takes no named arguments. |
object-run
Run the machine or cpu for the given time. If time is omitted, the machine or CPU will run forever (or until a non-normal stop (halt, break, watch hit etc.))
object-step
Step processor
Arguments
| Option | Type | Description |
|---|---|---|
obj |
object |
Object to step (if cpu object is to be stepped). |
cpuidx |
integer |
CPU to step in a machine. Defaults to current CPU. |
steps |
integer |
Number of steps, default is 1. |
perf |
integer |
Set to 1 to report emulator performance of step operation. |
pc |
integer |
PC to start stepping from. |
object-trace
Trace machine or processor
Arguments
| Option | Type | Description |
|---|---|---|
obj |
object |
Object to step (machine or cpu). |
cpuidx |
integer |
CPU to step in a machine. Defaults to current CPU. |
steps |
integer |
Number of steps, default is 1. |
cpuid |
integer |
CPU index. |
pc |
integer |
PC to start stepping from. |
symbols |
path |
ELF file where to query symbols, optional |
ignore |
string |
Comma separated symbol list to ignore traces from |
call-graph |
integer |
Limit traces to function changes |
objsys-check-sanity
Check sanity of object system
| This command does not have any aliases. |
| This command takes no named arguments. |
objsys-delete-all-objects
Erase all objects
| This command does not have any aliases. |
| This command takes no named arguments. |
objsys-delete-all-objects-and-classes
Erase all objects and classes
| This command does not have any aliases. |
| This command takes no named arguments. |
objsys-deserialise
Alias for snapshot-restore.
objsys-serialise
Alias for snapshot-save.
plugin-append-path
Add plugin path
| This command does not have any aliases. |
| This command takes no named arguments. |
plugin-list
Show loaded plugins
| This command does not have any aliases. |
| This command takes no named arguments. |
plugin-load-global
Load plugin into temu making symbols available globally
| This command takes no named arguments. |
plugin-remove-path
Remove plugin path
| This command does not have any aliases. |
| This command takes no named arguments. |
plugin-show-paths
Show plugin paths
| This command does not have any aliases. |
| This command takes no named arguments. |
pp
Alias for object-print.
Alias for object-print.
q
Alias for temu-quit.
quit
Alias for temu-quit.
raise-trap
Alias for cpu-raise-trap.
read
Alias for memory-read.
read-prop
Alias for object-prop-read.
reg-write
Write register value.
regs
Alias for cpu-show-regs.
reset
Alias for cpu-reset.
restore
Alias for snapshot-restore.
run
Alias for object-run.
save
Alias for snapshot-save.
serialise
Alias for snapshot-save.
serialize
Alias for snapshot-save.
set
Alias for var-set.
set-faulty
Alias for memory-set-faulty.
set-reg
Alias for cpu-set-reg.
set-timesource
Alias for object-set-timesource.
set-ts
Alias for object-set-timesource.
seu
Alias for memory-set-upset.
seu-clear
Alias for memory-clear-upset.
seu-set
Alias for memory-set-upset.
snapshot-restore
reload a snapshot from file
source
Alias for temu-exec.
spw-bus-connect
Connect two SpaceWire ports
spw-bus-disconnect
Disconnect two SpaceWire ports
spw-connect
Alias for spw-bus-connect.
spw-disconnect
Alias for spw-bus-disconnect.
step
Alias for object-step.
stop-uart-log
Alias for serial-stop-logging-to-pcap.
time
Alias for object-time.
trace
Alias for object-trace.
uart-break
Alias for break-uart.
uart-log
Alias for serial-log-to-pcap.
unset
Alias for var-delete.
var-init-from-environment
Import environmental variables into the TEMU command line. If var is not given, all environment variables are imported.
var-unset
Alias for var-delete.
vars
Alias for var-print-all.
version
Alias for temu-version.
w
Alias for watchpoint-set.
walk
Alias for memory-translate.
warn
Alias for diag-warning.
watch
Alias for watchpoint-set.
watch-del
Alias for watchpoint-delete.
watch-list
Alias for watchpoint-list.
watch-set
Alias for watchpoint-set.
wp-del
Alias for watchpoint-delete.
wp-list
Alias for watchpoint-list.
wp-set
Alias for watchpoint-set.
wr
Alias for memory-write.
wreg
Alias for reg-write.
write
Alias for memory-write.
write-prop
Alias for object-prop-write.
x
Alias for memory-read.