Scroll to navigation

SIMULATOR(1) User Commands SIMULATOR(1)

NAME

simulator - GNU simulator for AVR

SYNOPSIS

avr-run [options] [VAR=VAL|--] program [program args]

OPTIONS

Trace useful things
Perform instruction tracing
Disassemble instructions (slower, but more accurate)
Trace instruction decoding
Trace instruction extraction
Perform line number tracing (implies --trace-insn)
Trace memory operations
Trace ALU (Arithmetic Logic Unit) operations
Trace FPU (Floating Point Unit) operations
Trace VPU (Vector Processing Unit) operations
Trace branching
Perform ALU, FPU, VPU, MEMORY, and BRANCH tracing
Include model performance data
Trace core operations
Trace events
Trace system calls
Trace cpu register accesses
Add information useful for debugging the simulator to the tracing output
Specify tracing output file
Perform profiling
Perform instruction profiling
Perform memory profiling
Perform CORE profiling
Perform model profiling
Specify the speed of the simulated cpu clock
Specify profile output file
Perform PC profiling
Specified PC profiling frequency
Specify PC profiling size
Specify PC profiling sample coverage
Specify PC profiling address range
List configurable hw regions
Trace all hardware devices
Add the specified device
List the device tree
Add the devices listed in the file
Set serial emulation socket address
Watch the simulator, take ACTION in COUNT cycles (`+' for every COUNT cycles), ACTION is int breakpoint
Watch the PC, take ACTION when matches ADDRESS (in range ADDRESS,ADDRESS), `!' negates test
Watch the clock, take ACTION after MILLISECONDS (`+' for every MILLISECONDS)
Delete a watchpoint
List scheduled watchpoints
Delete memory at ADDRESS (all addresses)
Add a memory region
Add memory shadow
Add memory at address zero
Fill subsequently added memory regions
Clear subsequently added memory regions
Memory-map next memory region from file
List configurable memory regions
List mapped regions
Specify model to simulate
List selectable models
Verbose output
Set endianness
Set running environment
Set memory access alignment
Print debugging messages
Print instruction debugging messages
Specify debugging output file

--do-command COMMAND

Print help information
Print version information
Specify the architecture to use
List supported architectures
Specify the object-code format for the object files
List supported targets
Use VMA or LMA addresses when loading image (default LMA)
Root for system calls with absolute file-names and cwd at start
Set argv[0] to the specified string
Set the variable in the program's environment
Unset the variable in the program's environment
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

Copyright © 2023 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.

SEE ALSO

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.

September 2023 GNU simulator (SIM) 13.2