simulator - manual page for simulator (SIM) 12.1
avr-run [options] [VAR=VAL|--] program
[program args]
- -t[on|off],
--trace[=on|off]
- Trace useful things
- --trace-insn[=on|off]
- Perform instruction tracing
- --trace-disasm[=on|off]
- Disassemble instructions (slower, but more accurate)
- --trace-decode[=on|off]
- Trace instruction decoding
- --trace-extract[=on|off]
- Trace instruction extraction
- --trace-linenum[=on|off]
- Perform line number tracing (implies --trace-insn)
- --trace-memory[=on|off]
- Trace memory operations
- --trace-alu[=on|off]
- Trace ALU (Arithmetic Logic Unit) operations
- --trace-fpu[=on|off]
- Trace FPU (Floating Point Unit) operations
- --trace-vpu[=on|off]
- Trace VPU (Vector Processing Unit) operations
- --trace-branch[=on|off]
- Trace branching
- --trace-semantics[=on|off]
- Perform ALU, FPU, VPU, MEMORY, and BRANCH tracing
- --trace-model[=on|off]
- Include model performance data
- --trace-core[=on|off]
- Trace core operations
- --trace-events[=on|off]
- Trace events
- --trace-syscall[=on|off]
- Trace system calls
- --trace-register[=on|off]
- Trace cpu register accesses
- --trace-debug[=on|off]
- Add information useful for debugging the simulator to the tracing
output
- --trace-file
FILE NAME
- Specify tracing output file
- -p[on|off],
--profile[=on|off]
- Perform profiling
- --profile-insn[=on|off]
- Perform instruction profiling
- --profile-memory[=on|off]
- Perform memory profiling
- --profile-core[=on|off]
- Perform CORE profiling
- --profile-model[=on|off]
- Perform model profiling
- --profile-cpu-frequency
CPU FREQUENCY
- Specify the speed of the simulated cpu clock
- --profile-file
FILE NAME
- Specify profile output file
- --profile-pc[=on|off]
- Perform PC profiling
- -F PC PROFILE FREQUENCY,
--profile-pc-frequency PC PROFILE FREQUENCY
- Specified PC profiling frequency
- -S PC PROFILE SIZE,
--profile-pc-size PC PROFILE SIZE
- Specify PC profiling size
- --profile-pc-granularity
PC PROFILE GRANULARITY
- Specify PC profiling sample coverage
- --profile-pc-range
BASE,BOUND
- Specify PC profiling address range
- --hw-info,
--info-hw
- List configurable hw regions
- --hw-trace[=on|off],
--trace-hw
- Trace all hardware devices
- --hw-device
DEVICE
- Add the specified device
- --hw-list
- List the device tree
- --hw-file FILE
- Add the devices listed in the file
- --sockser-addr
SOCKET ADDRESS
- Set serial emulation socket address
- --watch-cycles-ACTION
[+]COUNT
- Watch the simulator, take ACTION in COUNT cycles (`+' for every COUNT
cycles), ACTION is int breakpoint
- --watch-pc-ACTION
[!]ADDRESS
- Watch the PC, take ACTION when matches ADDRESS (in range ADDRESS,ADDRESS),
`!' negates test
- --watch-clock-ACTION
[+]MILLISECONDS
- Watch the clock, take ACTION after MILLISECONDS (`+' for every
MILLISECONDS)
- --watch-delete
IDENT|all|pc|cycles|clock
- Delete a watchpoint
- --watch-info
- List scheduled watchpoints
- --memory-delete
ADDRESS|all, --delete-memory ADDRESS
- Delete memory at ADDRESS (all addresses)
- --memory-region
ADDRESS,SIZE[,MODULO]
- Add a memory region
- --memory-alias
ADDRESS,SIZE{,ADDRESS}
- Add memory shadow
- --memory-size
<size>[in bytes, Kb (k suffix), Mb (m suffix) or Gb (g
suffix)]
- Add memory at address zero
- --memory-fill
VALUE
- Fill subsequently added memory regions
- --memory-clear
- Clear subsequently added memory regions
- --memory-mapfile
FILE
- Memory-map next memory region from file
- --memory-info,
--info-memory
- List configurable memory regions
- --map-info
- List mapped regions
- --model
MODEL
- Specify model to simulate
- --model-info,
--info-model
- List selectable models
- -v, --verbose
- Verbose output
- -E B|big|L|little,
--endian B|big|L|little
- Set endianness
- --environment
user|virtual|operating
- Set running environment
- --alignment
strict|nonstrict|forced
- Set memory access alignment
- -D, --debug
- Print debugging messages
- --debug-insn
- Print instruction debugging messages
- --debug-file FILE
NAME
- Specify debugging output file
--do-command COMMAND
- -h, --help
- Print help information
- --version
- Print version information
- --architecture
MACHINE
- Specify the architecture to use
- --architecture-info,
--info-architecture
- List supported architectures
- --target
BFDNAME
- Specify the object-code format for the object files
- --target-info,
--info-target
- List supported targets
- --load-{lma,vma}
- Use VMA or LMA addresses when loading image (default LMA)
- --sysroot
SYSROOT
- Root for system calls with absolute file-names and cwd at start
- --argv0
ARGV0
- Set argv[0] to the specified string
- --env-set
VAR=VAL
- Set the variable in the program's environment
- --env-unset
VAR
- Unset the variable in the program's environment
- --env-clear
- Clear the program's environment
Note: Depending on the simulator configuration some options
- may not be applicable
VAR=VAL Environment variables to set. Ignored if -- is
used. program args Arguments to pass to simulated program.
- Note: Very few simulators support this.
Copyright © 2021 Free Software Foundation, Inc. License
GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it. There is NO
WARRANTY, to the extent permitted by law.
The full documentation for simulator is maintained as a
Texinfo manual. If the info and simulator programs are
properly installed at your site, the command
- info simulator
should give you access to the complete manual.