X-Git-Url: https://git.gag.com/?a=blobdiff_plain;f=sim%2Fucsim%2Fdoc%2Fcmd_exec.html;h=8bca134842dfb67e9a8bc7cf18e6965c580c1648;hb=f27cbdc6513b26748661452e50ed3af99fac16a2;hp=624daa4617dde73961c9b0a93a3993410d56b4dd;hpb=4c3872ef27c1263faae7d9b85c1821381646ece8;p=fw%2Fsdcc diff --git a/sim/ucsim/doc/cmd_exec.html b/sim/ucsim/doc/cmd_exec.html index 624daa46..8bca1348 100644 --- a/sim/ucsim/doc/cmd_exec.html +++ b/sim/ucsim/doc/cmd_exec.html @@ -5,83 +5,8 @@ - -

Execution commands of uCsim

- - -

g [start [stop]]

 - -Go, start execution. Parameters are optional. First parameter -specifies start address of the execution. By default execution starts -at address specified by actual value of the PC. This can be overridden -by first parameter. If second parameter is specified it places a -dynamic breakpoint at specified address which stops the execution. If -stop address is not given the simulator stops if it reaches a -breakpoint, or the CPU accepts an interrupt and stopit option -is TRUE, or fatal error occures or stop command is -used. Note that first instruction is executed without effect of -breakpoints. It means that if there is a breakpoint at start address -then it will not be hit. - -
-$ s51 remoansi.hex
-ucsim 0.2.24, Copyright (C) 1997 Daniel Drotos, Talker Bt.
-ucsim comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
-This is free software, and you are welcome to redistribute it
-under certain conditions; type `show c' for details.
-55755 bytes read from remoansi.hex
-> b 0x187
-> sopt stopit y
-> g
-Simulation started, PC=0x000000
-Stop at 000187: (4) Breakpoint
-F 000187
->
- -After execution is started the Simulaton started message -appears with value of PC where the execution started and the simulator -is ready to accept other commands while the simulation is running in -background. - - +

Execution commands of uCsim

stop

 @@ -114,12 +39,10 @@ PC is dissassembled, see the dis command for description of disassembled form. -

[Repeatable] s -[step]

 +

s,step

 Step command. It executes one instruction without effect of -breakpoints. Optional parameter can specify number of requested -steps. +breakpoints. 
 $ s51 remoansi.hex
@@ -133,23 +56,13 @@ under certain conditions; type `show c' for details.
 000000 00 .  ACC= 0x00   0 .  B= 0x00   DPTR= 0x0000 @DPTR= 0x00   0 .
 000000 00 .  PSW= 0x00 CY=0 AC=0 OV=0 P=0
    000160 c2 90    CLR   P1.0
-> s 2
-000000 00 00 00 00 00 00 00 00 ........
-000000 00 .  ACC= 0x00   0 .  B= 0x00   DPTR= 0x0000 @DPTR= 0x00   0 .
-000000 00 .  PSW= 0x00 CY=0 AC=0 OV=0 P=0
-   000162 c2 97    CLR   P1.7
-000000 00 00 00 00 00 00 00 00 ........
-000000 00 .  ACC= 0x00   0 .  B= 0x00   DPTR= 0x0000 @DPTR= 0x00   0 .
-000000 00 .  PSW= 0x00 CY=0 AC=0 OV=0 P=0
-   000164 d2 b5    SETB  P3.5
 >
After execution of actual instruction pointed by PC the step -command executes dr command. +command dumps out the register set. -

[Repeatable] n -[step]

 +

n,next

 Execute until next instruction is reached. This command is similar to step command described above but if actual @@ -167,8 +80,7 @@ ucsim comes with ABSOLUTELY NO WARRANTY; for details type `show w'. This is free software, and you are welcome to redistribute it under certain conditions; type `show c' for details. 58659 bytes read from remoansi.hex -> g 0 0x172 -4 +> run 0 0x172 000172 79 04 MOV R1,#04 > dis 0x172 0 5 000170 7f 00 MOV R7,#00 @@ -177,19 +89,16 @@ under certain conditions; type `show c' for details. 000177 0f INC R7 000178 d9 fa DJNZ R1,0174 00017a 75 0b 00 MOV 0b,#00 -> n 3 +> n 000000 00 04 00 00 00 00 00 00 ........ 000000 00 . ACC= 0x00 0 . B= 0x00 DPTR= 0x0000 @DPTR= 0x00 0 . 000004 00 . PSW= 0x00 CY=0 AC=0 OV=0 P=0 000174 12 0d b8 LCALL 0db8 +> n 000000 00 04 00 00 00 00 00 00 ........ 000000 00 . ACC= 0x00 0 . B= 0x00 DPTR= 0x0167 @DPTR= 0x00 0 . 000004 00 . PSW= 0x00 CY=0 AC=0 OV=0 P=0 000177 0f INC R7 -000000 00 04 00 00 00 00 00 01 ........ -000000 00 . ACC= 0x00 0 . B= 0x00 DPTR= 0x0167 @DPTR= 0x00 0 . -000004 00 . PSW= 0x00 CY=0 AC=0 OV=0 P=0 - 000178 d9 fa DJNZ R1,0174 > @@ -216,10 +125,50 @@ Warning: maybe not instruction at 000020 > -

run

 +

r,run,go [start [stop]]

 This command starts the execution of the simulated program. +

Parameters are optional. First parameter specifies start address of +the execution. By default execution starts at address specified by +actual value of the PC. This can be overridden by first parameter. + +

If second parameter is specified it places a dynamic breakpoint at +specified address which stops the execution. If stop address is not +given the simulator stops if it reaches a breakpoint, or the CPU +accepts an interrupt and stopit option is TRUE, or fatal error +occures or stop command is used on an other +console, or ENTER key is pressed on the console where the run command +was issued. + +

If program execution is started the console is frozen it is +not possible to give commands on this console to the simulator while +execution is running. If it is needed to control the simulator during +program execution then more consoles can be used. See using multiple consoles for more information. + +

Note that first instruction is executed without effect of +breakpoints and simulation will be started afterwards. It means that +if there is a breakpoint at start address then it will not be hit. See +following example: + +

+$ ./s51
+ucsim 0.2.38-pre1, Copyright (C) 1997 Daniel Drotos, Talker Bt.
+ucsim comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+This is free software, and you are welcome to redistribute it
+under certain conditions; type `show c' for details.
+> b 0x10
+Breakpoint 1 at 0x000010: MOV   R7,A
+> b 0x20
+Breakpoint 2 at 0x000020: MOV   R7,A
+> run 0x10
+Warning: maybe not instruction at 0x000010
+Simulation started, PC=0x000010
+Stop at 0x000020: (104) Breakpoint
+F 0x000020
+> 
+