Intel® Simics® Simulator for Intel® FPGAs: User Guide

ID 784383
Date 12/04/2023
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

A. Intel® Simics® Simulator Command Reference

The following sections list the Intel® Simics® simulator commands that were described in this document.

The text between < > indicates the type of object used to call the command (local scope command).

Intel® Simics® Simulator Help

help help help
help-search list-commands
api-help version

Simulation Control

run; r continue; c
stop stepi; si
step-cycle step-instruction

Hardware Inspection

list-objects  
Hardware Inspection - Processor
list-processors processor-status
<processor>.info <processor>.print-processor-registers; pregs
<processor>.read-reg <processor>.status
<processor>.write-reg %<processor reg>
psel
Hardware Inspection – Device Inspection
devs get-device-reg
get-device-offset print-device-regs
print-device-reg-info set-device-offset
set-device-reg write-device-offset
write-device-reg read-device-offset
read-device-reg
Hardware Inspection – Memory Inspection
<memory_space>.get; get <memory_space>.info
<memory_space>.load-file <memory_space>.load-binary
<memory_space>.log-level <memory_space>.map
<memory_space>.memory_map <memory_space>.read
<memory_space>.set; set <memory_space>.write

Time Control

disable-real-time-mode enable-real-time-mode
list-processors <processor>.info
<processor>.status <processor>.set-step-rate
ptime run # cycles,steps,us,ps,ns,ms
step-cycle stepi
step-instruction

Debug Target Software

add-pathmap-entry add-symbol-file
context-query-for-object debug-context
<debug context>.list <debug context>.next-instruction
<debug context>.next-line <debug context>.stack-trace
<debug context>.sym-address <debug context>.sym-type
<debug context>.sym-value <debug context>.sym-write
disable-debugger down
enable-debugger finish-function
frame list-debug-contexts
list-sections list-segments
remove-symbol-file show-memorymap
step-line up
start-eclipse-backend new-tracer-tool

Breakpoints

<bp manager>.bank.break <bp manager>.bank.run-until
<bp manager>.bank.trace <bp manager>.bank.wait-for
<bp manager>.console_string.break <bp manager>.control_register.break
<bp manager>.control_register.trace <bp manager>.cycle.break
<bp manager>.delete <bp manager>.list
<bp manager>.log.break <bp manager>.memory.trace
<bp manager>.memory.break <bp manager>.source_location.break
<bp manager>.show <bp manager>.source_location.trace
<bp manager>.source_line.break <bp manager>.step.break
<bp manager>.source_location.run-until <object>.regs.bp-break-bank
<bp manager>.source_location.wait-for <object>.regs.bp-trace-bank
<bp manager>.time.break <processor>.bp-break-cycle
<object>.regs.bp-run-until-bank <processor>.bp-break-step
<object>.regs.bp-wait-for-bank <processor>.break-register
<processor>.bp-break-control-register <text console>.con.bp-break-console-string
<processor>.bp-break-time  

Log Control

echo log-level
log-setup log-type
output-radix start-command-line-capture
stop-command-line-capture <SerialConsole>.con.capture-start
<SerialConsole>.con.capture-stop <SerialConsole>.con.save-to-file

File Handling

pwd ls
cd cat
%simics% %script%
add-directory clear-directories
list-directories lookup-file
resolve-file

Networking

connect-real-network connect-real-network-napt
connect-real-network-port-in connect-real-network-port-out
disconnect-real-network list-port-forwarding-setup
service_node_cmp0.arp service_node_cmp0.list-host-info
service_node_cmp0.log-level service_node_cmp0.sn.info
service_node_cmp0.sn.status

Scripting in CLI

$variable local $variable
if if-else
if-else if-else while
foreach signed
atoi bits
int-to-*-float bin
dec hex
oct sim->
try-except get-error-message
get-error-line get-error-file
get-error-command script-branch
wait-for-* list-script-branches
interrupt-script-branch run-command-file
run-python-file create-script-barrier
wait-for-script-barrier script-barrier-limit