version 0.5.2
[fw/sdcc] / sim / ucsim / doc / commref.html
1 <html>
2 <head>
3 <title>&micro;Csim: Command Reference</title>
4 </head>
5
6 <body bgcolor="white">
7
8 <h1>Command reference</h1>
9
10
11 <p>The simulator can be controlled with a simple monitor program which
12 uses the command console to read commands and print out results. After
13 starting the program you see a prompt on the command console and you
14 can write in commands after the prompt:
15
16 <a name="help_example"><pre>
17 <a href="cmd.html#g">g</a> [start [stop]]   Go
18 <a href="cmd.html#stop">stop</a>               Stop
19 <a href="cmd.html#pc">pc [address]</a>       Get/set content of PC
20 <a href="cmd.html#s">s [step]</a>           Step
21 <a href="cmd.html#n">n [step]</a>           Next
22 <a href="cmd.html#bse">bse wi|ri|wx|rx|ws|rs|rc f|d addr [hit]</a>
23                    Set EVENT Breakpoint
24 <a href="cmd.html#bde">bde wi|ri|wx|rx|ws|rs|rc addr</a>
25                    Delete EVENT Breakpoint
26 <a href="cmd.html#ba">ba</a>                 Delete all breakpoints
27 <a href="cmd.html#dis">dis [start [offset [lines]]]</a>
28                    Disassemble code
29 <a href="cmd.html#dp">dp</a>                 Dump ports
30 <a href="cmd.html#ds">ds [addr...]</a>       Dump SFR
31 <a href="cmd.html#db">db addr...</a>         Dump bit
32 <a href="cmd.html#si">si addr data...</a>    Set Internal RAM
33 <a href="cmd.html#sx">sx addr data...</a>    Set External RAM
34 <a href="cmd.html#sc">sc addr data...</a>    Set code (ROM)
35 <a href="cmd.html#ss">ss addr data...</a>    Set SFR area
36 <a href="cmd.html#sb">sb addr data...</a>    Set bit
37 <a href="cmd.html#sp">sp port data</a>       Set port pins
38 <a href="cmd.html#fi">fi start stop data</a> Fill IRAM area with `data'
39 <a href="cmd.html#fx">fx start stop data</a> Fill XRAM area with `data'
40 <a href="cmd.html#fs">fs start stop data</a> Fill SFR area with `data'
41 <a href="cmd.html#fc">fc start stop data</a> Fill ROM area with `data'
42 <a href="cmd.html#wi">wi,Wi string</a>       Search for `string' in IRAM (Wi case sensitive)
43 <a href="cmd.html#wx">wx,Wx string</a>       Search for `string' in XRAM (Wx case sensitive)
44 <a href="cmd.html#wc">wc,Wc string</a>       Search for `string' in ROM (Wc case sensitive)
45 <a href="cmd.html#sopt">sopt opt value</a>     Set value of option
46 <a href="cmd.html#gopt">gopt [opt]</a>         Get value of option(s)
47 <a href="cmd.html#show">show c|w</a>           Show licensing information
48 ----
49 Set of new commands:
50 <a href="cmd.html#conf">conf</a>               Configuration<img src="new.gif">
51 <a href="cmd.html#state">state</a>              State of simulator<img src="new.gif">
52 <a href="cmd.html#file">file,load "FILE"</a>   Load FILE into ROM<img src="new.gif">
53 <a href="cmd.html#dl">download,dl</a>        Download (intel hex) data
54 <a href="cmd.html#info">info</a>               Information<img src="new.gif">
55 get                Get
56 set                Set
57 <a href="cmd.html#timer">timer a|d|g|r|s|v id [value]</a>
58                    Timer add|del|get|run|stop|value<img src="new.gif">
59 <a href="cmd.html#run">run</a>                Go<img src="new.gif">
60 step               Step
61 <a href="cmd.html#reset">reset</a>              Reset
62 dump i|x|r|s [start [stop]]
63                    Dump memory
64 <a href="cmd.html#di">di [start [stop]]</a>  Dump Internal RAM
65 <a href="cmd.html#dx">dx [start [stop]]</a>  Dump External RAM
66 <a href="cmd.html#dch">dch [start [stop]]</a> Dump code in hex form
67 <a href="cmd.html#dc">dc [start [stop]]</a>  Dump code in disass form
68 <a href="cmd.html#break">break addr [hit]</a>   Set fix breakpoint<img src="new.gif">
69 <a href="cmd.html#tbreak">tbreak addr [hit]</a>  Set temporary breakpoint<img src="new.gif">
70 <a href="cmd.html#clear">clear [addr...]</a>    Clear fix breakpoint<img src="new.gif">
71 <a href="cmd.html#h">help,?</a>             Help about commands
72 <a href="cmd.html#q">quit</a>               Quit
73 <a href="cmd.html#kill">kill</a>               Shut down the simulator
74 </pre></a>
75
76 In <a href="cmd.html">command reference</a> you can find more
77 information about breakpoints and execution of the simulated program.
78
79
80 <hr>
81
82 </body>
83 </html>