Memory manipulation commands of μCsim

From 268a53de823a6750d6256ee1fb1e7707b4b45740 Mon Sep 17 00:00:00 2001 From: Xavier ASUS Date: Fri, 18 Oct 2019 00:31:54 +0200 Subject: sdcc-3.9.0 fork implementing GNU assembler syntax This fork aims to provide better support for stm8-binutils --- sim/ucsim/doc/cmd_memory.html | 287 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 287 insertions(+) create mode 100644 sim/ucsim/doc/cmd_memory.html (limited to 'sim/ucsim/doc/cmd_memory.html') diff --git a/sim/ucsim/doc/cmd_memory.html b/sim/ucsim/doc/cmd_memory.html new file mode 100644 index 0000000..2e4eca9 --- /dev/null +++ b/sim/ucsim/doc/cmd_memory.html @@ -0,0 +1,287 @@ + + + + Memory manipulation commands of μCsim + + +

Memory manipulation commands of μCsim

+ Every command which changes content of ROM area such as dl + or set + memory deletes result of code + analyser and causes to re-analyse the code. +

+ +

file,load "FILE"

+ + Loads file named FILE into the simulated code memory. File must + contain data in Intel HEX format. +

> file "../../remo.hex"
+55470 words read from ../../remo.hex
+> 
+

+ Don't forget to enclose file name in quotes to make the parameter to + be a string. +

+ +

download,dl

+ + Download command. It is same as load above but it + reads information from command console which is standard input by + default. This command stops read records when it detects an "END" + record which is normally the last record. This command has two + equivalent forms download and dl. +

$ 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
+>

+ +

fill memory_type start end data

+ + Fill memory region with specified data. First parameter specifies + memory. Name of the memory must be used, it can be checked using info + memory command which + lists size and name of all available memories. +

start and end parameters specify first and last + address of the memory region to be filled. +

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 xram 12 0x12 0x56
+> dump xram 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                      .
+>

+ +

where,Where memory_type data...

+ + Searching for some data in memory. First parameter specifies + memory. Name of the memory must be used, it can be checked using info + memory command which + lists size and name of all available memories. +

Other parameters can be mixed list of strings (characters between " + and ") and numbers. Strings can contain escape sequencies. μCsim + merges all parameters together and will search for merged list of + values in specified memory. +

where command do case unsensitive search while Where + command is for case sensitive search. +

Search is done in whole memory and all matches 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.
+> set mem xram 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 xram "dani"
+0x0014 44 61 6e 69             Dani
+0x0025 64 61 6e 69             dani
+0x002a 44 61 6e 69             Dani
+> Where xram "d ani"
+0x0019 64 20 61 6e 69          d ani
+>

+ +

hole [memory [length [value]]]

+ +

Searching for a memory area where all locations are filled with + value. By default this command searches rom but any memory can be + specified. Areas shorter than specified length (default is 100) + will not be listed. Searched value is 0 (zero) by default but + other can be sepcified as the last patrameter. +

$ s51
+uCsim 0.6-pre55, Copyright (C) 1997 Daniel Drotos.
+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> hole
+0x0000 65535
+0> hole xram
+0> fill xram 0x100 0x1ff 11
+0> hole xram 50 11
+0x0100 255
+0> fill xram 0x500 0x600 11
+0&ht; hole xram 50 11    
+0x0100 255
+0x0500 256
+0> rom[0x200]=1
+1
+0> hole
+0x0000 511
+0x0201 65022
+0>

+ Data of found areas are listed in two columns. First column is + the start address of the area in hexadecimal and the second + column is area lenght (in decimal). +

+ +

memory

+ + This set of commands can be used to manipulate memory + system including chips, address + spaces and address decoders. +

Subcommands are: +

memory createchip +
+ memory createaddressspace +
+ memory createaddressdecoder +
+ memory info +

+ +
memory createchip|cchip id size + cellsize
+ + This command creates a chip (array of storage elements). id + must be a unique name which will be used to identify the chip in other + commands. size is number of storage elements, cellsize + is number of bits stored in one element. +
+ +
memory +createaddressspace|caddressspace|caddrspace|caspace|createaddrspace|createaspace + id startaddr size
+ + This command should never be used. It defines an address space, names + it as id sets its starting address and size. Simulator programs + (s51, savr, etc.) define necessary address spaces for + themself, so this command is not needed. +
+ +
memory +createaddressdecoder|caddrdecoder|caddressdecoder|cadecoder|createaddrdecoder|createadecoder + addressspace begin end chip begin
+ + Address decoder maps a part of the address space to a chip + area. addressspace parameter is name of the address space, + begin and end specify address range of the address space + to be mapped. chip parameter is name of the memory chip and + the second begin parameter is the (start of the) chip address + where the area is mapped to. +
Address space will be split if a "middle" are is mapped: +
+
$ 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> i m
+Memory chips:
+  0x000000-0x00ffff    65536 rom_chip (8,%02x,0x%04x)
+  0x000000-0x00007f      128 iram_chip (8,%02x,0x%02x)
+  0x000000-0x00ffff    65536 xram_chip (8,%02x,0x%04x)
+  0x000000-0x00007f      128 sfr_chip (8,%02x,0x%02x)
+Address spaces:
+  0x000000-0x00ffff    65536 rom (8,%02x,0x%04x)
+  0x000000-0x00007f      128 iram (8,%02x,0x%02x)
+  0x000080-0x0000ff      128 sfr (8,%02x,0x%02x)
+  0x000000-0x00ffff    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> mem cchip myram 0x1000 8
+0> mem createaddressdecoder xram 1234 2000 myram 15
+0> i m
+Memory chips:
+  0x000000-0x00ffff    65536 rom_chip (8,%02x,0x%04x)
+  0x000000-0x00007f      128 iram_chip (8,%02x,0x%02x)
+  0x000000-0x00ffff    65536 xram_chip (8,%02x,0x%04x)
+  0x000000-0x00007f      128 sfr_chip (8,%02x,0x%02x)
+  0x000000-0x000fff     4096 myram (8,%02x,0x%03x)
+Address spaces:
+  0x000000-0x00ffff    65536 rom (8,%02x,0x%04x)
+  0x000000-0x00007f      128 iram (8,%02x,0x%02x)
+  0x000080-0x0000ff      128 sfr (8,%02x,0x%02x)
+  0x000000-0x00ffff    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 0x04d1 -> xram_chip 0x0000 activated
+ 1 xram 0x04d2 0x07d0 -> myram 0x00f activated
+ 2 xram 0x07d1 0xffff -> xram_chip 0x07d1 activated
+0> 
+
+ It is easy to share chip area between address spaces: +
$ 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> mem createaddressdecoder rom 0 0xfff xram_chip 0xf000
+0> i m
+Memory chips:
+  0x000000-0x00ffff    65536 rom_chip (8,%02x,0x%04x)
+  0x000000-0x00007f      128 iram_chip (8,%02x,0x%02x)
+  0x000000-0x00ffff    65536 xram_chip (8,%02x,0x%04x)
+  0x000000-0x00007f      128 sfr_chip (8,%02x,0x%02x)
+Address spaces:
+  0x000000-0x00ffff    65536 rom (8,%02x,0x%04x)
+  0x000000-0x00007f      128 iram (8,%02x,0x%02x)
+  0x000080-0x0000ff      128 sfr (8,%02x,0x%02x)
+  0x000000-0x00ffff    65536 xram (8,%02x,0x%04x)
+Address decoders:
+ 0 rom 0x0000 0x0fff -> xram_chip 0xf000 activated
+ 1 rom 0x1000 0xffff -> rom_chip 0x1000 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> rom[0]=0xab
+171
+0> xram[0xf000]
+171
+0> 
+
+
+

+ +

memory info

+ + This command is same as info + memory. +

+ + -- cgit v1.2.3