Every command which changes content of ROM area such as dl or set
-memory deletes result of code analyzer and causes to
-re-analyze the code.
+conf
+Conf command can be used to display different kind of information
+about µCsim. It can be followed by a subcommand:
-show
+
conf
+
conf objects
-Show command can be used to display different kind of information. It
-must be followed by a subcommand. Subcommands are:
+
-+show copying -
show warranty +conf
+This command (without a subcommand) prints out configuration of the +simulator: -show copying
++0> conf +ucsim version 0.5.0-pre3 +Type of microcontroller: 51 CMOS +Controller has 9 hardware element(s). + timer0[0] + timer1[1] + uart[0] + port[0] + port[1] + port[2] + port[3] + irq[0] + _51_dummy[0] +0> +-This command can be used to list licensing information. It is first 10 -point of the version 2 of GNU Genral Public License. If you do not -accept GPL simply do not use the program. +First line contains version number of the program. Second line informs +about type of the simulated microcontroller. Third line prints out how +many hardware elements are simulated. +conf objects
-show warranty
+This command is for development only. -This command prints out last 2 point of the license ("NO WARRANTY" -message). +
If a command name is given as parameter then µCsim prints out all +command that has similar names:
-$ s51 -V -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. -> do -:03000000020003F8 -:1000030075812078207600D8FC900000AE83AF8203 -:100013009000001200416005E4F0A380F690009F79 -:1000230012004A9000A312004A9000A712006890A1 -:1000330000AD12006875D0001200B50200B3EF6581 -:10004300827003EE658322E493F8740193F97402DA -:1000530093FE740393F5828E83E869700122E4931F -:10006300F6A30880F4E493FC740193FD740293FEF9 -:10007300740393FF740493F8740593F582888312D1 -:100083000041700122E493A3A883A9828C838D820B -:10009300F0A3AC83AD828883898280E3212100B5FC -:1000A300212100B5000000B500B5000000B500B582 -:0200B30080FECD -:1000B5007520117501AA850120750102850120228F -:00000001FF -197 bytes loaded ->+0> ? s +show subcommand Generic command for showing things about the uCsim +set subcommand Set, see `set' command for more help +stop Stop +step Step +state State of microcontroller +statistic [mem [startaddr [endaddr]]] + Statistic of memory accesses +0> ? s o +show option [name] Show internal data of options +set option name|nr value + Set value of an option +0> + + +Some commands have more than one name which can produce interesting +result: + +
+0> ? t r +timer delete id Delete a timer +timer start id Start a timer +0> ++ +It looks that names of listed subcommands start with no "r" but take a +closer look on that commands: + +
+0> ? t d +timer delete id Delete a timer +Names of command: delete remove +long help of timer delete +0> ? t start +timer start id Start a timer +Names of command: run start +long help of timer run +0>+ +
If parameter is unique name of a command then long description of +the command is printed out. + +
If a command name is given as parameter then uCsim prints out all -command that has the same name. +Reads commands from "file" and executes them. This command opens a new +console (which will use same in/out file as the actual one) to execute +the file. This means the "quit" command in the file will not exit the +simulator: -
If parameter is unique name of a command then long description of -the command is printed out. +
+drdani@emma:~$ cat /tmp/x +get opt +quit +conf +drdani@emma:~$ s51 +uCsim 0.5.0-pre3, 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. +0> exec "/tmp/x" +1> get opt + 0. config_file(by application) is hidden! + 1. console_on(by application) is hidden! + 2. cpu_type(by application) is hidden! + 3. debug(by console1): FALSE - Debug messages to console1 + 4. debug(by console0): FALSE - Debug messages to console0 + 5. debug(by application): FALSE - Print debug messages (-V) + 6. irq_stop(by mcs51_controller): FALSE - Stop when IRQ accepted + 7. null_prompt(by application): FALSE - Use \0 as prompt (-P) + 8. prompt(by console1): "" - Prompt string of console1 + 9. prompt(by console0): "" - Prompt string of console0 +10. prompt(by application): (null) - String of prompt (-p) +11. serial_in_file(by application) is hidden! +12. serial_out_file(by application) is hidden! +13. xtal(by application): 11059200.000 - Frequency of XTAL in Hz +1> quit +0> ++
-$ s51 -V remoansi.hex -ucsim 0.2.24, Copyright (C) 1997 Daniel Drotos, Talker Bt. +0> expr 1 + 2 +3 +0> expr xram[256*dph+dpl]= &sp +129 +0> ++ + +
show copying
+
show warranty
+
show option
+
show error
+
+
+ ++show copying
+ +This command can be used to list licensing information. It is first 10 +point of the version 2 of GNU Genral Public License. If you do not +accept GPL simply do not use the program. + +
+ +show warranty
+ +This command prints out last 2 point of the license ("NO WARRANTY" +message). + +
+ +show option
+ +This command is for development only. + +
+ +show error
+ +Errors or warnings are events which can happen in the simulated system +during simulation. Report of that events can be turned on or off using +set error command. Errors are +organized in parent-child relationship. Childs are listed under the +parent: + ++0> sh er +Error: non-classified [on/ON] + Error: memory [on/ON] + Error: invalid_address [unset/ON] + Error: non_decoded [unset/ON] + Error: stack [off/OFF] + Error: stack_tracker [unset/OFF] + Error: stack_tracker_wrong_handle [unset/OFF] + Error: operation_on_empty_stack [unset/OFF] + Warning: stack_operation_unmatched_to_top_of_stack [unset/OFF] + Warning: stack_looks_corrupted [unset/OFF] +0>+ +First element is the type (Error or Warning). Error stops the +simulation. Warning is just reported and simulation goes on. Next +element is the name of the error. Last element shows actual value and +state. Value can be: + ++ +If state is ON and the event happens, it is reported. If state +is OFF then the event is silently ignored. + +
- on
- state is ON + +
- off
- state is OFF + +
- unset
- state is inherited from the parent. +
+ ++ +get sfr address...
+ +This command can be used to check values of SFR location(s) if SFR +exists in simulated memory. Note that dump memory or ds can be used as well. + +Parameters are interpreted as SFR names or addresses and values of +addressed locations are dumped out. + +
+$ s51 +ucsim 0.5.0-pre3, 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. -58659 bytes read from remoansi.hex -> dr -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 - 000000 02 01 60 LJMP 0160 -> 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 - 000160 c2 90 CLR P1.0 -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 -> res -> dr -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 - 000000 02 01 60 LJMP 0160 +0> get sfr pcon p1 0 0x80 kahd scon 256 +0x87 00 . +0x90 ff . +Warning: Invalid address 0 +0x80 ff . +Warning: Invalid address kahd +0x98 00 . +Warning: Invalid address 256 +0>+ +
+ + +get option [name]
+ +Get actual value of option(s). Some options can be set by set option to modify behavior of the +simulator. Using get option you can get actual value of these +options. If you use this command without parameter you get list of all +options known by the program. In this way you can figure out which +options can be used. + ++$ s51 -V +ucsim 0.5.0, 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. +0> get opt + 3. debug(by console0): FALSE - Debug messages to console0 + 4. debug(by application): FALSE - Print debug messages (-V) + 5. irq_stop(by mcs51_controller): FALSE - Stop when IRQ accepted + 6. null_prompt(by application): FALSE - Use \0 as prompt (-P) + 7. prompt(by console0): "" - Prompt string of console0 + 8. prompt(by application): (null) - String of prompt (-p) +11. xtal(by application): 11059200.000 - Frequency of XTAL in Hz +0> ++ +First element of the list is the number of the option. It is followed +by name of the option (debug, irq_stop, etc.). Number or +the name can be used to identify the option in +get option and set option +command. Next element shows which part of the simulator created the +option. + +Next element of the list is the value of the option. It can be an +integer or a floating point number, a string or a boolean value. + +
Last part describes the option. + +
Some options can have same name. An example is the debug +option. One is created by the application to store value given by -V +(see invokation). This will be used as +default value when a new instance of a console is created: + +
+$ cat /tmp/x +get opt debug +$ s51 +uCsim 0.5.0-pre3, 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. +0> get opt debug + 3. debug(by console0): FALSE - Debug messages to console0 + 4. debug(by application): FALSE - Print debug messages (-V) +0> set opt 4 1 +0> get opt debug + 3. debug(by console0): FALSE - Debug messages to console0 + 4. debug(by application): TRUE - Print debug messages (-V) +0> exec "/tmp/x" +1> get opt debug + 3. debug(by console1): TRUE - Debug messages to console1 + 4. debug(by console0): FALSE - Debug messages to console0 + 5. debug(by application): TRUE - Print debug messages (-V) +1> +0> ++ +
set option
+
set error
+
set memory
+
set bit
+
set hardware
+
+
+
+ ++ +set option name|nr value
+ +Set option value. Options described at (get option) command can be set using +this command. First parameter must be an option name or number and +second the new value. Interpretation of the value depends on type of +the option. Value for a boolean type of option interpreted as follows: +if first character of the value is one of 1, t, +T, y, Y then value will be TRUE otherwise +it will be FALSE. + +
+$ s51 -V +uCsim 0.5.0-pre3, 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. +> get opt + 0. config_file(by application) is hidden! + 1. console_on(by application) is hidden! + 2. cpu_type(by application) is hidden! + 3. debug(by console0): TRUE - Debug messages to console0 + 4. debug(by application): TRUE - Print debug messages (-V) + 5. irq_stop(by mcs51_controller): FALSE - Stop when IRQ accepted + 6. null_prompt(by application): FALSE - Use \0 as prompt (-P) + 7. prompt(by console0): "" - Prompt string of console0 + 8. prompt(by application): (null) - String of prompt (-p) + 9. serial_in_file(by application) is hidden! +10. serial_out_file(by application) is hidden! +11. xtal(by application): 11059200.000 - Frequency of XTAL in Hz +> set opt debug f +Ambiguous option name, use number instead +> set opt 3 f +> get opt debug + 3. debug(by console0): FALSE - Debug messages to console0 + 4. debug(by application): TRUE - Print debug messages (-V) >+
+ + +set error error_name +on|off|unset
+ +This command can be used to set if an error event should be reported +or not. Actual settings can be retrieved by show +error command. + +
+ + +set memory memory_type address +data...
+ +This command can be used to modify content of any simulated +memory. First parameter must be a class name to specify type of +memory. Class names can de checked by info memory command. Chips and +address spaces can be used as well. + +Second parameter specifies start address of the modification. + +
Remaining parameters will be written into the memory starting at +address specified by second parameter. Data list can include numbers +as well as strings. See syntax for more +details. + +
Modified memory locations will be dumped out. + +
+0> set mem xram 1 "ab\tcd\0ef\012ghq" 2 "ABC" +0x0001 61 62 09 63 64 00 65 66 ab.cd.ef +0x0009 0a 67 68 71 02 41 42 43 .ghq.ABC +0> set mem sfr pcon 0x34 +0x87 34 4 +0> set mem xram_chip 1 2 +0x0001 02 . +0>-where,Where memory_type data...
+
-Searching for some data in memory. First parameter specifies -memory. Class name of the memory must be used, it can be checked using -conf command which lists size and -class name of all available memories. -Other parameters can be mixed list of strings (characters between " -and ") and numbers. Strings can contain escape sequencies. Ucsim -merges all parameters together and will search for megred list of -values in specified memory. +
set bit address 0|1
-where command do case unsensitive search while Where -command is for case sensitive search. +Set one bit to 0 or 1. First parameter specifies the bit. It can be +the address of the bit (number or syqmbolic name) or it can be +specified in address.bitnumber format where +address addresses SFR area and bitnumber is number of +bit in specified SFR location. Using this syntax any SFR (and 8051's +internal RAM) location can be modified it need not be really bit +addressable. -
Search is done in whole memory and all matches are dumped out. +
Second parameter interpreted as 1 if it is not zero. + +
Modified memory location is dumped out.
-$ /s51 +$ s51 ucsim 0.2.38-pre2, 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. -> set mem x 20 "Dani d ani D ani dani Dani" -0x0014 44 61 6e 69 20 64 20 61 Dani d a -0x001c 6e 69 20 44 20 61 6e 69 ni D ani -0x0024 20 64 61 6e 69 20 44 61 dani Da -0x002c 6e 69 ni -> where x "dani" -0x0014 44 61 6e 69 Dani -0x0025 64 61 6e 69 dani -0x002a 44 61 6e 69 Dani -> Where x "d ani" -0x0019 64 20 61 6e 69 d ani ->+> set bit tf1 1 +0x88 80 . +> set bit 130 0 +0x80 fb . +> set bit pcon.2 1 +0x87 04 . +> set bit 10.7 1 +0x0a 80 . +> + +
-conf
-This command prints out configuration of the simulator: +set hardware hardware_id data
+ +This command can be used to set value into a hardware element of the +controller (conf command lists them). + +Actually only port element of MCS51 accepts this method. It +can be used to set value of external circuits which +connected to ports of simulated controller. First parameter specifies +port element (as an array), second is the new value.
-> conf -ucsim version 0.2.37 +0> conf Type of microcontroller: 51 CMOS -Controller has 8 hardware element(s). +Controller has 9 hardware element(s). timer0[0] timer1[1] uart[0] @@ -200,21 +536,27 @@ Controller has 8 hardware element(s). port[2] port[3] irq[0] -Memories: - ROM size= 0x010000 65536 width= 8 class= "rom" - XRAM size= 0x010000 65536 width= 8 class= "xram" - IRAM size= 0x000100 256 width= 8 class= "iram" - SFR size= 0x000100 256 width= 8 class= "sfr" -> + _51_dummy[0] +0> set hw port[0] 12 +0> i h po[0] +port[0] +P0 11111111 0xff 255 . (Value in SFR register) +Pin0 00001100 0x0c 12 . (Output of outside circuits) +Port0 00001100 0x0c 12 . (Value on the port pins) +0> set hw port[0] 23 +0> i h po[0] +port[0] +P0 11111111 0xff 255 . (Value in SFR register) +Pin0 00010111 0x17 23 . (Output of outside circuits) +Port0 00010111 0x17 23 . (Value on the port pins) +0> set hw irq[0] 12 +Nothing to do +0>-First line contains version number of the program. Second line informs -about type of the simulated microcontroller. Third line prints out how -many hardware elements are simulated. Following lines contain -information about memories. Note that size of the simulated memory -segment can be bigger than size of addressable part of the memory as -you see above SFR type of the memory has bigger simulated than -addressable size. +
Last line infroms about maximum value of the stack pointer and a "not very well" calculated average value of it. +
-> file "../../remo.hex" -55470 words read from ../../remo.hex -> -+$ s51 -V 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. +58659 bytes read from remoansi.hex +> i r +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 + 000000 02 01 60 LJMP 0160 +> s +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 + 000160 c2 90 CLR P1.0 +> s +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 +> res +> i r +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 + 000000 02 01 60 LJMP 0160 +> -Don't forget to enclose file name in quotes to make the parameter to -be a string. +
info breakpoints
-
info registers
-
info hardware
+
info breakpoints
+
info registers
+
info hardware
+
info stack
+
info memory
+
--info breakpoints
+info breakpoints
This subcommand prints out information about breakpoints:-> b 12 +0> b 12 Breakpoint 1 at 0x00000c: MOV R7,A -> tb 43 +0> tb 43 Breakpoint 2 at 0x00002b: MOV R7,A -> bse ws f 0x80 -> i b +0> b sfr w 0x80 +0> i b Num Type Disp Hit Cnt Address What 1 fetch keep 1 1 0x00000c MOV R7,A 2 fetch del 1 1 0x00002b MOV R7,A -1 event keep 1 1 0x000080 ws -> +3 event keep 1 1 0x000080 write +0>As you see above, the command can be shortened to "i b". The list of breakpoints contains 7 columns: -
- Num
- Number of the breakpoint. Normal and event -breakpoints are numbered separately. +
-
- Num
- Number of the breakpoint.
- Type
- This column shows type of the breakpoint. It can be fetch for normal breakpoints or event for event @@ -317,7 +686,10 @@ breakpoints it contains type of event.
info registers
+
+ + +info registers
This subcommand prints out full register set of the CPU. Output of this command depends of type of CPU. @@ -396,16 +768,68 @@ the status register too, and value of the stack pointer.Following line shows indirect addressing registers X, Y, and Z as well as pointed memory values. -
Last line is disassembled instruction ap PC. +
Last line is disassembled instruction at PC. -
info hardware|hw identifier
+Registers of Z80 family
+ ++$ sz80 +uCsim 0.5.0-pre3, 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. +0> i r +SZ-A--P-C Flags= 0x00 0 . A= 0x00 0 . +00-0--0-0 +BC= 0x0000 [BC]= 00 0 . DE= 0x0000 [DE]= 00 0 . HL= 0x0000 [HL]= 00 0 . +IX= 0x0000 [IX]= 00 0 . IY= 0x0000 [IY]= 00 0 . SP= 0x0000 [SP]= 00 0 . + ? 0x0000 00 NOP +0> ++ +Registers of XA family
+ ++$ sxa +uCsim 0.5.0-pre3, 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. +The XA Simulator is in development, UNSTABLE, DEVELOPERS ONLY! +0> i r +CA---VNZ | R0:0100 R1:0302 R2:0504 R3:0706 +00---000 | R4:0908 R5:0b0a R6:0d0c SP:0100 ES:0000 DS:0000 + ? 0x0302 02 03 ADD R0l,[R3] +0> ++ +Registers of HC08 family
+ ++$ shc08 +uCsim 0.5.0-pre3, 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. +0> i r +V--HINZC Flags= 0x60 96 ` A= 0x00 0 . +0--00000 H= 0x00 0 . X= 0x00 0 . +SP= 0x00ff [SP+1]= 00 0 . + ? 0x0000 00 01 02 brset #0,*0x01,0x0005 +0> ++ +
+ + +info hardware|hw identifier
This subcommand prints out information about a unit of the controller. identifier specifies hardware element. One form of it is a name. Names of hardware elements can be checked by conf command. This form is accepted only when name is unique. If more than one element exists with the same name then name -must be followed by id number is squere brackets in same form as it is +must be followed by id number in squere brackets in same form as it is listed by conf command.Ouput format of this command depends on CPU family and type of the @@ -414,12 +838,12 @@ controller even in the same CPU family.
$ s51 -t 51 -ucsim 0.2.38-pre2, Copyright (C) 1997 Daniel Drotos, Talker Bt. +ucsim 0.5.0-pre3, 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. -> conf -ucsim version 0.2.38-pre2 +0> conf +ucsim version 0.5.0-pre3 Type of microcontroller: 51 CMOS Controller has 8 hardware element(s). timer0[0] @@ -430,325 +854,237 @@ Controller has 8 hardware element(s). port[2] port[3] irq[0] -Memories: - ROM size= 0x010000 65536 width= 8 class= "rom" - XRAM size= 0x010000 65536 width= 8 class= "xram" - IRAM size= 0x000100 256 width= 8 class= "iram" - SFR size= 0x000100 256 width= 8 class= "sfr" -> i h port[2] + _51_dummy[0] +0> i h port[2] port[2] P2 11111111 0xff 255 . (Value in SFR register) Pin2 11111111 0xff 255 . (Output of outside circuits) Port2 11111111 0xff 255 . (Value on the port pins) -> i h t[0] +0> i h t[0] timer0[0] 0x0000 13 bit timer OFF irq=0 dis prio=0 -> i h u +0> i h u uart[0] Shift, fixed clock MultiProc=none irq=dis prio=0 Receiver OFF RB8=0 irq=0 Transmitter TB8=0 irq=0 -> +0>Timer #2 differs a little bit from other timers of MCS51:$ s51 -t 52 -ucsim 0.2.38-pre2, Copyright (C) 1997 Daniel Drotos, Talker Bt. +ucsim 0.5.0-pre3, 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. -> i h timer0 +0> i h timer0 timer0[0] 0x0000 13 bit timer OFF irq=0 dis prio=0 -> i h t[2] +0> i h t[2] timer2[2] 0x0000 reload 0x0000 timer OFF irq=0 dis prio=0 -> +0>+
-timer a|d|g|r|s|v id [value]
- -Handling of timers. First parameter of timer command determines the -operation which can be - -+
- add (or simply a)
- to create a new timer. New timers -are turned ON by default and initialized to value 0. - -
- del (or simply d)
- to remove a timer if you don't need -it any more. - -
- get (or simply g)
- to get value of timers. See comment -below. - -
- run (or simply r)
- to turn a timer ON. - -
- stop (or simply s)
- to turn a timer OFF. It still exist -but doesn't count xtal periods. - -
- value (or simply v)
- to set value of the timer (number -of xtal periods). `param' is the new value. -
info stack
-id can be a number or a string. Timers are numbered from 1. You -can use any number greater than 0 to identify a timer. Or you can use -a simbolic name, in this case simulator uses the first unused number -to allocate a new timer: +This command prints out information about data stored in the CPU's +stack and operations which put them there.-> tim a 3 -> tim g 0 -timer #0("time") ON: 0.463255 sec (5123232 clks) -timer #0("isr") ON: 0.0051888 sec (57384 clks) -timer #3("unnamed") ON: 0 sec (0 clks) -> tim a "a" -> tim g 0 -timer #0("time") ON: 0.463255 sec (5123232 clks) -timer #0("isr") ON: 0.0051888 sec (57384 clks) -timer #1("a") ON: 0 sec (0 clks) -timer #3("unnamed") ON: 0 sec (0 clks) -> +$ s51 ~/remo.hex +uCsim 0.5.0-pre3, 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. +55470 words read from /home/staff/drdani/remo.hex +0> set opt irq_stop true +0> r +Simulation started, PC=0x000000 +Stop at 0x000023: (2) Interrupt +F 0x000023 +0> i s +OP SP before-after L DATA/ADDR INSTRUCTION +call 0x000022-0x000024 2 0x002976 0x022a 12 29 76 LCALL 2976 +call 0x000024-0x000026 2 0x002379 0x2976 12 23 79 LCALL 2379 +call 0x000026-0x000028 2 0x003612 0x2517 12 36 12 LCALL 3612 +intr 0x000028-0x00002a 2 0x000023 0x366f 20 0c 02 JB 21.4,3674 +0>-If you use 0 as timer id in "get" operation, simulator prints out -value of all timers including predefined ones. - - -set
- -This command can be used to set various kind of things. It requires a -subcommand to specify what is going to be set. Known subcommands are: - -set memory -
set bit -
set port -
set option - +First column shows the operation which can be call or +push or intr (interrupt call). Next column contains +value of the SP register before and after the operation. Column "L" +shows size of the data, and the next column the data itself. Note, +that for call operations (call, and intr) the called address is +printed, not the pushed one! Last column is the instruction which has +been executed when the operation occured. -set memory memory_type address -data...
+
-This command can be used to modify content of any simulated -memory. First parameter must be a class name to specify type of -memory. Class names can de checked by conf command. -Second parameter specifies start address of the modification. +
info memory
-Remaining parameters will be written into the memory starting at -address specified by second parameter. Data list can include numbers -as well as strings. See syntax for more -details. -q -
Modified memory locations are dumped out. +This command shows information about memory +system: chips, address spaces and address decoders.
$ s51 -ucsim 0.2.38-pre2, Copyright (C) 1997 Daniel Drotos, Talker Bt. -ucsim comes with ABSOLUTELY NO WARRANTY; for details type `show w'. +uCsim 0.5.0-pre3, 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. -> set mem x 1 "ab\tcd\0ef\012ghq" 2 "ABC" -0x0001 61 62 09 63 64 00 65 66 ab.cd.ef -0x0009 0a 67 68 71 02 41 42 43 .ghq.ABC -> set mem sfr pcon 0x34 -0x87 34 4 ->- +0> i m +Memory chips: + 0x000000-0x010000 65536 rom_chip (8,%02x,0x%04x) + 0x000000-0x000080 128 iram_chip (8,%02x,0x%02x) + 0x000000-0x010000 65536 xram_chip (8,%02x,0x%04x) + 0x000000-0x000080 128 sfr_chip (8,%02x,0x%02x) +Address spaces: + 0x000000-0x010000 65536 rom (8,%02x,0x%04x) + 0x000000-0x000080 128 iram (8,%02x,0x%02x) + 0x000080-0x000080 128 sfr (8,%02x,0x%02x) + 0x000000-0x010000 65536 xram (8,%02x,0x%04x) +Address decoders: + 0 rom 0x0000 0xffff -> rom_chip 0x0000 activated + 0 iram 0x00 0x7f -> iram_chip 0x00 activated + 0 sfr 0x80 0xff -> sfr_chip 0x00 activated + 0 xram 0x0000 0xffff -> xram_chip 0x0000 activated +0> + -set bit address 0|1
+First column shows address ranges, next one is the size followed by +the name of the memory. This name can be used in other commands (such +as dump, set +memory, etc.). Last column shows some technical information +(width in bits, format specifier to print out content and address). -Set one bit to 0 or 1. First parameter specifies the bit. It can be -the address of the bit (number or syqmbolic name) or it can be -specified in address.bitnumber format where -address addresses SFR area and bitnumber is number of -bit in specified SFR location. Using this syntax any SFR (and 8051's -internal RAM) location can be modified it need not be really bit -addressable. +Address decoders are associated with address spaces. Each address +space has a list of decoders. First column of the address decoder +information is the number of the decoder. Next three columns specifies +name and area of the address space which is handled by the +decoder. After "->" sign the name and the address of the memory +chip is printed where the decoder maps the area of the address space. -
Second parameter interpreted as 1 if it is not zero. - -
Modified memory location is dumped out. +
Memory system of other controller family can be different.
-$ s51 -ucsim 0.2.38-pre2, Copyright (C) 1997 Daniel Drotos, Talker Bt. -ucsim comes with ABSOLUTELY NO WARRANTY; for details type `show w'. +$ savr +uCsim 0.5.0-pre3, 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. -> set bit tf1 1 -0x88 80 . -> set bit 130 0 -0x80 fb . -> set bit pcon.2 1 -0x87 04 . -> set bit 10.7 1 -0x0a 80 . -> +0> i m +Memory chips: + 0x000000-0x00ffff 65536 rom_chip (16,%04x,0x%04x) + 0x000000-0x00007f 128 iram_chip (8,%02x,0x%02x) +Address spaces: + 0x000000-0x00ffff 65536 rom (16,%04x,0x%04x) + 0x000000-0x00ffff 65536 iram (8,%02x,0x%04x) +Address decoders: + 0 rom 0x0000 0xffff -> rom_chip 0x0000 activated + 0 iram 0x0000 0x007f -> iram_chip 0x00 activated +0>+
-> set port 0 12 -> i h po[0] -port[0] -P0 11111111 0xff 255 . (Value in SFR register) -Pin0 00001100 0x0c 12 . (Output of outside circuits) -Port0 00001100 0x0c 12 . (Value on the port pins) -> set port port[0] 23 -> i h po[0] -port[0] -P0 11111111 0xff 255 . (Value in SFR register) -Pin0 00010111 0x17 23 . (Output of outside circuits) -Port0 00010111 0x17 23 . (Value on the port pins) ->+
Known subcommands are: -
Set option value. Options described at (get option) command can be set using -this command. First parameter must be an option name and second the -new value. Interpretation of the value depends on type of the -option. Value for a boolean type of option interpreted as follows: if -first character of the value is one of 1, t, -T, y, Y then value will be TRUE otherwise -it will be FALSE. +
timer add
+
timer delete
+
timer get
+
timer start
+
timer stop
+
timer set
-
-$ s51 -V -ucsim 0.2.38, 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. -> get opt -verbose TRUE Verbose flag. -stopit FALSE Stop if interrupt accepted. -debug FALSE Debug messages appears on this console. -> set opt debug t -> get opt -verbose TRUE Verbose flag. -stopit FALSE Stop if interrupt accepted. -debug TRUE Debug messages appears on this console. ->+
Each subcommand can (some must) be followed by a timer id which can be +a number or a string. Timers are numbered from 1. You can use any +number greater than 0 to identify a timer. Or you can use a simbolic +name, in this case simulator uses the first unused number to allocate +a new timer. +
-get
+timer add|create|make id [direction +[in_isr]]
-This command can be used to get value of various kind of things. It -requires a subcommand to specify what is going to be set. Known -subcommands are: +To create a new timer. New timers are turned ON by default and +initialized to value 0. Direction is an integer (can be +positive or negative) number which is added to the actual value in +every step. If in_isr is TRUE the timer counts only when +execution is in an interrupt handler. -
-get sfr address...
+timer delete|remove id
-This command can be used to check values of SFR location(s) if SFR -exists in simulated memory. Note that dump memory or ds can be used as well. +To remove a timer if you don't need it any more. -Parameters are interpreted as SFR names or addresses and values of -addressed locations are dumped out. +
--$ s51 -ucsim 0.2.38-pre2, 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. -> get sfr pcon p1 0 0x80 kahd scon -0x87 00 . -0x90 ff . -0x00 00 . -0x80 ff . -Warning: Invalid address kahd -0x98 00 . ->+timer get [id]
-get option name
+To get value of timers. If you don't use timer id in this command +simulator prints out value of all timers including predefined +ones. See example below. -Get actual value of option(s). Some options can be set by set option to modify behavior of the -simulator. Using get option you can get actual value of these -options. If you use this command without parameter you get list of all -options known by the program. In this way you can figure out which -options can be used. +
--$ s51 -V -ucsim 0.2.38, 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. -> get opt -verbose TRUE Verbose flag. -stopit FALSE Stop if interrupt accepted. -debug FALSE Debug flag. -> get opt stopit -stopit FALSE Stop if interrupt accepted. ->-This version of the simulator knows about three options. First element -of the list is name of the option (verbose, debug and -stopit). This name can be used to identify the option in -gopt and set option -command. Second element of the list is the value of the option. In -this case type of both options is boolean, their value can be TRUE or -FALSE. Third element is a short description of the option. +timer start|run id
-+
- verbose
- ? +To turn a timer ON. -
- debug
- Debug flag can be set by -V option of the -program to TRUE otherwise its default value is FALSE. If it is TRUE, -the simulator prints out short messages about important events. +
-- stopit
- Setting this option to TRUE (default value is -FALSE) forces execution to stop every time when CPU accepts an -interrupt. You do not have to use breakpoints to inspect interrupts. -
timer stop id
+ +To turn a timer OFF. It still exist but doesn't count xtal periods. +
-fill memory_type start end data
-Fill memory region with specified data. First parameter specifies -memory. Class name of the memory must be used, it can be checked using -conf command which lists size and -class name of all available memories. +timer set|value id value
-start and end parameters specify first and last -address of the memory region to be filled. +To set value of the timer (number of xtal periods). value is +the new value. -
data parameter specifies the data which is used to fill the -memory region.
-$ s51 -ucsim 0.2.38-pre2, 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. -> fill x 12 0x12 0x56 -> dump x 0 0x20 -0x0000 00 00 00 00 00 00 00 00 ........ -0x0008 00 00 00 00 56 56 56 56 ....VVVV -0x0010 56 56 56 00 00 00 00 00 VVV..... -0x0018 00 00 00 00 00 00 00 00 ........ -0x0020 00 . ->+0> tim a 3 +0> tim g +timer #0("time") ON: 0.463255 sec (5123232 clks) +timer #0("isr") ON: 0.0051888 sec (57384 clks) +timer #0("idle") ON,ISR: 0 sec (0 clks) +timer #3("unnamed") ON: 0 sec (0 clks) +0> tim a "a" +0> tim g +timer #0("time") ON: 0.463255 sec (5123232 clks) +timer #0("isr") ON: 0.0051888 sec (57384 clks) +timer #0("idle") ON,ISR: 0 sec (0 clks) +timer #1("a") ON: 0 sec (0 clks) +timer #3("unnamed") ON: 0 sec (0 clks) +0> + +