Feature/41 update readme with better instructions

README.md

@@ -5,47 +5,79 @@ Tool for generating diagrams that show the mapping of regions in memory, specifc
 
 ||
 |:-:|
-|![](doc/example/example_normal_diagram.png)|
-|![](doc/example/example_normal_table.png)|
+|![](doc/example/example_two_maps_diagram.png)|
+|![](doc/example/example_two_maps_table.png)|
+
+### Features
+
+- Regions are plotted onto a diagram. Freespace is measured and put into the accompanying table.
+- Region collisions are highlighted on the diagram and in the accompnaying table. The table will detail which regions have collided as well as related measurements.
+
+  ![](doc/example/example_region_collisions_diagram.png)
+  ![](doc/example/example_region_collisions_table.png)
+
+- The output is available as:
+    - separate images for diagram and table.
+    - markdown table with inline diagram image.
+- Command line and JSON input are supported. NOTE: Command line input has a limited subset of features compared to JSON input.. Some extra features available with JSON input are:
+    - Multi map support with links
+    - All graphic properties are available
+    - Max address and diagram size
+
+- Diagram width and height can be specified using JSON. The contents will be automatically draw to the correct scale within the requested diagram size. If height is not set then the correct height will be calculated from the region data. NOTE: Command line input can ONLY set both the diagram height and max address simulataneously using the 'limit' option. 
+- Max address can be set using JSON. If this is higher than the diagram height, the contents will be scaled. If regions exceed this max address, the collision will be highlighted both in the diagram and table. 
+
+  ![](doc/example/example_end_collision_diagram.png)
+  ![](doc/example/example_end_collision_table.png)
+
+  If max address is not set then the diagram height will be used. NOTE: Command line input can ONLY set both the diagram height and max address simulataneously using the 'limit' option.
+
+- Many additional settings are available in the JSON input. Please see the [schema](mm/schema.json) for more information. 
 
-As well as the `png` format diagram image, a `markdown` report is also created:
-- inline image of the diagram
-- collision data table
 
 More examples can be found in [doc/example/main.md](doc/example/main.md)
 
 ### Usage:
 
 ```
-usage: diagram.py [-h] [-o OUT] [-l LIMIT] [-s SCALE] [-v VOIDTHRESHOLD] [regions ...]
+python3 -m mm.diagram -h
+```
 
-usage: diagram.py [-h] [-o OUT] [-l LIMIT] [-t THRESHOLD] [-n NAME] [-f FILE] [regions ...]
+```
+usage: diagram.py [-h] [-o OUT] [-l LIMIT] [-t THRESHOLD] [-n NAME] [-f FILE] [-v] [--no_whitespace_trim] [regions ...]
 
 Generate a diagram showing how binary regions co-exist within memory.
 
 positional arguments:
-  regions               command line input for regions should be tuples of name, origin and size.
+  regions               Sequence of region data. Should be tuples of name, origin and size: <name1> <origin1> <size1> <nameN> <originN> <sizeN>
 
 options:
   -h, --help            show this help message and exit
-  -o OUT, --out OUT     path to the markdown output report file. Default: "out/report.md"
+  -o OUT, --out OUT     The path to the markdown output report file. Diagram and table images will be written using this path and name (using png extension). Default:
+                        'out/report.md'
   -l LIMIT, --limit LIMIT
-                        The height for the diagram. Please use hex. Memory regions exceeding this height will be
-                        scaled to fit. Ignored when using JSON file input.
+                        The 'height' in pixels and 'max address' in bytes for the diagram. Please use hex format. Ignored when using JSON file input. Memory regions exceeding
+                        this value will be scaled to fit when drawn but collision measurements will use the original value. If you need to set 'height' and 'max address' to
+                        different values, please use the JSON input file instead.
   -t THRESHOLD, --threshold THRESHOLD
-                        The threshold for skipping void sections. Please use hex.
+                        The threshold for replacing large empty sections with 'SKIPPED' regions. Any space over this value will be replaced. Please use hex. Default = 0x16
   -n NAME, --name NAME  Provide a name for the memory map. Ignored when JSON file is provided.
-  -f FILE, --file FILE  JSON input file for multiple memory maps (and links) support. Please see
-                        doc/example/input.json for help.
+  -f FILE, --file FILE  JSON input file for multiple memory maps (and links) support. Please see doc/example for help.
+  -v                    Enable debug output.
+  --no_whitespace_trim  Force disable of whitespace trim in diagram images. If this option is set, diagram images may be created larger than requested.
 ```
 
-- Generate five regions called `kernel`, `rootfs`, `dtb`, `uboot` and `uboot-scr` where four of the five regions intersect/collide. The default report output path is used. Diagram output is shown at the top of the page.
+#### Examples
+
+- Generate five regions called `kernel`, `rootfs`, `dtb`, `uboot` and `uboot-scr` where four of the five regions intersect/collide. The default report output path is used. 
 
     ```
-    python3 -m mm.diagram kernel 0x10 0x50 rootfs 0x50 0x30 dtb 0x90 0x30 uboot 0xD0 0x50 uboot-scr 0x110 0x30
+    python3 -m mm.diagram kernel 0x10 0x50 rootfs 0x50 0x30 dtb 0x90 0x30 uboot 0xD0 0x50 uboot-scr 0x110 0x30 -l 0x3e8
     ```
 
-- Using JSON the same options (plus many others) can be set. See example files in [doc/example](doc/example) folder.
-
+- Using JSON many other options can be set. See json files in [doc/example](doc/example) folder.
 
+    ```
+    python3 -m mm.diagram -f doc/example/input.json
+    ```
 

doc/example/A3_maxaddress_lower_than_memregions.md

@@ -1,9 +1,9 @@
 ![memory map diagram](A3_maxaddress_lower_than_memregions_diagram.png)
 |region (parent)|origin|size|free Space|collisions|links|draw scale|
 |:-|:-|:-|:-|:-|:-|:-|
-|<span style='color:(39, 9, 9)'>Boot Image (Flash)</span>|0xbb8 (3000)|0x7d0 (2000)|-0xbb8 (-3000)| end @ 0x7d0 |('Global System Address Map', 'OCM')|2:1|
-|<span style='color:(54, 27, 19)'>OCM (Global System Address Map)</span>|0x7e0 (2016)|0x7d0 (2000)|0x3b1 (945)|||1:1|
-|<span style='color:(16, 62, 28)'>DDR Memory Controller (Global System Address Map)</span>|0x10 (16)|0x3e8 (1000)|0x3e8 (1000)|||1:1|
+|<span style='color:(31, 2, 31)'>Boot Image (Flash)</span>|0xbb8 (3000)|0x7d0 (2000)|-0xbb8 (-3000)| end @ 0x7d0 |('Global System Address Map', 'OCM')|2:1|
+|<span style='color:(20, 62, 24)'>OCM (Global System Address Map)</span>|0x7e0 (2016)|0x7d0 (2000)|0x3b1 (945)|||1:1|
+|<span style='color:(28, 51, 54)'>DDR Memory Controller (Global System Address Map)</span>|0x10 (16)|0x3e8 (1000)|0x3e8 (1000)|||1:1|
 
 ---
 #### Global System Address Map:

doc/example/A3_region_exceeds_height-no_maxaddress_set.md

@@ -1,9 +1,9 @@
 ![memory map diagram](A3_region_exceeds_height-no_maxaddress_set_diagram.png)
 |region (parent)|origin|size|free Space|collisions|links|draw scale|
 |:-|:-|:-|:-|:-|:-|:-|
-|<span style='color:(16, 34, 21)'>OCM (Global System Address Map)</span>|0x7e0 (2016)|0x7d0 (2000)|0x3b1 (945)|||1:1|
-|<span style='color:(23, 20, 42)'>DDR Memory Controller (Global System Address Map)</span>|0x10 (16)|0x3e8 (1000)|0x3e8 (1000)|||1:1|
-|<span style='color:(37, 66, 4)'>Boot Image (Flash)</span>|0x0 (0)|0xffffff (16777215)|-0xffec9e (-16772254)| end @ 0x1361 ||3382:1|
+|<span style='color:(7, 31, 35)'>OCM (Global System Address Map)</span>|0x7e0 (2016)|0x7d0 (2000)|0x3b1 (945)|||1:1|
+|<span style='color:(65, 7, 6)'>DDR Memory Controller (Global System Address Map)</span>|0x10 (16)|0x3e8 (1000)|0x3e8 (1000)|||1:1|
+|<span style='color:(68, 68, 40)'>Boot Image (Flash)</span>|0x0 (0)|0xffffff (16777215)|-0xffec9e (-16772254)| end @ 0x1361 ||3382:1|
 
 ---
 #### Global System Address Map:

doc/example/A3_region_freespace_exceeds_height-higher_maxaddress_set.md

@@ -1,9 +1,9 @@
 ![memory map diagram](A3_region_freespace_exceeds_height-higher_maxaddress_set_diagram.png)
 |region (parent)|origin|size|free Space|collisions|links|draw scale|
 |:-|:-|:-|:-|:-|:-|:-|
-|<span style='color:(50, 52, 14)'>OCM (Global System Address Map)</span>|0x7e0 (2016)|0x7d0 (2000)|0xfffff04f (4294963279)|||1:1|
-|<span style='color:(4, 56, 23)'>DDR Memory Controller (Global System Address Map)</span>|0x10 (16)|0x3e8 (1000)|0x3e8 (1000)|||1:1|
-|<span style='color:(2, 21, 53)'>Boot Image (Flash)</span>|0x0 (0)|0xffffff (16777215)|0xff000000 (4278190080)|||3544:1|
+|<span style='color:(68, 15, 67)'>OCM (Global System Address Map)</span>|0x7e0 (2016)|0x7d0 (2000)|0xfffff04f (4294963279)|||1:1|
+|<span style='color:(56, 39, 2)'>DDR Memory Controller (Global System Address Map)</span>|0x10 (16)|0x3e8 (1000)|0x3e8 (1000)|||1:1|
+|<span style='color:(18, 42, 17)'>Boot Image (Flash)</span>|0x0 (0)|0xffffff (16777215)|0xff000000 (4278190080)|||3544:1|
 
 ---
 #### Global System Address Map:

doc/example/A4_maxaddress_lower_than_memregions.md

@@ -1,9 +1,9 @@
 ![memory map diagram](A4_maxaddress_lower_than_memregions_diagram.png)
 |region (parent)|origin|size|free Space|collisions|links|draw scale|
 |:-|:-|:-|:-|:-|:-|:-|
-|<span style='color:(62, 29, 62)'>Boot Image (Flash)</span>|0xbb8 (3000)|0x7d0 (2000)|-0xbb8 (-3000)| end @ 0x7d0 |('Global System Address Map', 'OCM')|2:1|
-|<span style='color:(56, 28, 50)'>OCM (Global System Address Map)</span>|0x7e0 (2016)|0x7d0 (2000)|-0x1fc (-508)| end @ 0xdb4 ||2:1|
-|<span style='color:(52, 1, 55)'>DDR Memory Controller (Global System Address Map)</span>|0x10 (16)|0x3e8 (1000)|0x3e8 (1000)|||2:1|
+|<span style='color:(50, 1, 22)'>Boot Image (Flash)</span>|0xbb8 (3000)|0x7d0 (2000)|-0xbb8 (-3000)| end @ 0x7d0 |('Global System Address Map', 'OCM')|2:1|
+|<span style='color:(33, 55, 16)'>OCM (Global System Address Map)</span>|0x7e0 (2016)|0x7d0 (2000)|-0x1fc (-508)| end @ 0xdb4 ||2:1|
+|<span style='color:(16, 48, 67)'>DDR Memory Controller (Global System Address Map)</span>|0x10 (16)|0x3e8 (1000)|0x3e8 (1000)|||2:1|
 
 ---
 #### Global System Address Map:

doc/example/A4_region_exceeds_height-no_maxaddress_set.md

@@ -1,9 +1,9 @@
 ![memory map diagram](A4_region_exceeds_height-no_maxaddress_set_diagram.png)
 |region (parent)|origin|size|free Space|collisions|links|draw scale|
 |:-|:-|:-|:-|:-|:-|:-|
-|<span style='color:(4, 35, 60)'>OCM (Global System Address Map)</span>|0x7e0 (2016)|0x7d0 (2000)|-0x1fc (-508)| end @ 0xdb4 ||2:1|
-|<span style='color:(23, 7, 25)'>DDR Memory Controller (Global System Address Map)</span>|0x10 (16)|0x3e8 (1000)|0x3e8 (1000)|||2:1|
-|<span style='color:(50, 39, 31)'>Boot Image (Flash)</span>|0x0 (0)|0xffffff (16777215)|-0xfff24b (-16773707)| end @ 0xdb4 ||4783:1|
+|<span style='color:(10, 54, 5)'>OCM (Global System Address Map)</span>|0x7e0 (2016)|0x7d0 (2000)|-0x1fc (-508)| end @ 0xdb4 ||2:1|
+|<span style='color:(58, 51, 40)'>DDR Memory Controller (Global System Address Map)</span>|0x10 (16)|0x3e8 (1000)|0x3e8 (1000)|||2:1|
+|<span style='color:(2, 23, 51)'>Boot Image (Flash)</span>|0x0 (0)|0xffffff (16777215)|-0xfff24b (-16773707)| end @ 0xdb4 ||4783:1|
 
 ---
 #### Global System Address Map:

doc/example/A4_region_freespace_exceeds_height-higher_maxaddress_set.md

@@ -1,9 +1,9 @@
 ![memory map diagram](A4_region_freespace_exceeds_height-higher_maxaddress_set_diagram.png)
 |region (parent)|origin|size|free Space|collisions|links|draw scale|
 |:-|:-|:-|:-|:-|:-|:-|
-|<span style='color:(7, 20, 40)'>OCM (Global System Address Map)</span>|0x7e0 (2016)|0x7d0 (2000)|0xfffff04f (4294963279)|||2:1|
-|<span style='color:(23, 66, 3)'>DDR Memory Controller (Global System Address Map)</span>|0x10 (16)|0x3e8 (1000)|0x3e8 (1000)|||2:1|
-|<span style='color:(4, 7, 25)'>Boot Image (Flash)</span>|0x0 (0)|0xffffff (16777215)|0xff000000 (4278190080)|||5011:1|
+|<span style='color:(6, 25, 29)'>OCM (Global System Address Map)</span>|0x7e0 (2016)|0x7d0 (2000)|0xfffff04f (4294963279)|||2:1|
+|<span style='color:(12, 39, 57)'>DDR Memory Controller (Global System Address Map)</span>|0x10 (16)|0x3e8 (1000)|0x3e8 (1000)|||2:1|
+|<span style='color:(20, 5, 60)'>Boot Image (Flash)</span>|0x0 (0)|0xffffff (16777215)|0xff000000 (4278190080)|||5011:1|
 
 ---
 #### Global System Address Map:

doc/example/A5_maxaddress_lower_than_memregions.md

@@ -1,9 +1,9 @@
 ![memory map diagram](A5_maxaddress_lower_than_memregions_diagram.png)
 |region (parent)|origin|size|free Space|collisions|links|draw scale|
 |:-|:-|:-|:-|:-|:-|:-|
-|<span style='color:(65, 53, 63)'>Boot Image (Flash)</span>|0xbb8 (3000)|0x7d0 (2000)|-0xbb8 (-3000)| end @ 0x7d0 |('Global System Address Map', 'OCM')|3:1|
-|<span style='color:(36, 12, 45)'>OCM (Global System Address Map)</span>|0x7e0 (2016)|0x7d0 (2000)|-0x600 (-1536)| end @ 0x9b0 ||2:1|
-|<span style='color:(23, 53, 29)'>DDR Memory Controller (Global System Address Map)</span>|0x10 (16)|0x3e8 (1000)|0x3e8 (1000)|||2:1|
+|<span style='color:(66, 7, 16)'>Boot Image (Flash)</span>|0xbb8 (3000)|0x7d0 (2000)|-0xbb8 (-3000)| end @ 0x7d0 |('Global System Address Map', 'OCM')|3:1|
+|<span style='color:(2, 46, 61)'>OCM (Global System Address Map)</span>|0x7e0 (2016)|0x7d0 (2000)|-0x600 (-1536)| end @ 0x9b0 ||2:1|
+|<span style='color:(7, 42, 49)'>DDR Memory Controller (Global System Address Map)</span>|0x10 (16)|0x3e8 (1000)|0x3e8 (1000)|||2:1|
 
 ---
 #### Global System Address Map:

doc/example/A5_region_exceeds_height-no_maxaddress_set.md

@@ -1,9 +1,9 @@
 ![memory map diagram](A5_region_exceeds_height-no_maxaddress_set_diagram.png)
 |region (parent)|origin|size|free Space|collisions|links|draw scale|
 |:-|:-|:-|:-|:-|:-|:-|
-|<span style='color:(42, 52, 15)'>OCM (Global System Address Map)</span>|0x7e0 (2016)|0x7d0 (2000)|-0x600 (-1536)| end @ 0x9b0 ||2:1|
-|<span style='color:(67, 44, 56)'>DDR Memory Controller (Global System Address Map)</span>|0x10 (16)|0x3e8 (1000)|0x3e8 (1000)|||2:1|
-|<span style='color:(30, 29, 18)'>Boot Image (Flash)</span>|0x0 (0)|0xffffff (16777215)|-0xfff64f (-16774735)| end @ 0x9b0 ||6766:1|
+|<span style='color:(16, 30, 65)'>OCM (Global System Address Map)</span>|0x7e0 (2016)|0x7d0 (2000)|-0x600 (-1536)| end @ 0x9b0 ||2:1|
+|<span style='color:(62, 31, 16)'>DDR Memory Controller (Global System Address Map)</span>|0x10 (16)|0x3e8 (1000)|0x3e8 (1000)|||2:1|
+|<span style='color:(26, 18, 17)'>Boot Image (Flash)</span>|0x0 (0)|0xffffff (16777215)|-0xfff64f (-16774735)| end @ 0x9b0 ||6766:1|
 
 ---
 #### Global System Address Map:

doc/example/A5_region_freespace_exceeds_height-higher_maxaddress_set.md

@@ -1,9 +1,9 @@
 ![memory map diagram](A5_region_freespace_exceeds_height-higher_maxaddress_set_diagram.png)
 |region (parent)|origin|size|free Space|collisions|links|draw scale|
 |:-|:-|:-|:-|:-|:-|:-|
-|<span style='color:(17, 47, 46)'>OCM (Global System Address Map)</span>|0x7e0 (2016)|0x7d0 (2000)|0xfffff04f (4294963279)|||2:1|
-|<span style='color:(60, 68, 64)'>DDR Memory Controller (Global System Address Map)</span>|0x10 (16)|0x3e8 (1000)|0x3e8 (1000)|||2:1|
-|<span style='color:(19, 67, 55)'>Boot Image (Flash)</span>|0x0 (0)|0xffffff (16777215)|0xff000000 (4278190080)|||7088:1|
+|<span style='color:(2, 9, 61)'>OCM (Global System Address Map)</span>|0x7e0 (2016)|0x7d0 (2000)|0xfffff04f (4294963279)|||2:1|
+|<span style='color:(19, 28, 61)'>DDR Memory Controller (Global System Address Map)</span>|0x10 (16)|0x3e8 (1000)|0x3e8 (1000)|||2:1|
+|<span style='color:(57, 13, 0)'>Boot Image (Flash)</span>|0x0 (0)|0xffffff (16777215)|0xff000000 (4278190080)|||7088:1|
 
 ---
 #### Global System Address Map:

doc/example/A6_maxaddress_lower_than_memregions.md

@@ -1,9 +1,9 @@
 ![memory map diagram](A6_maxaddress_lower_than_memregions_diagram.png)
 |region (parent)|origin|size|free Space|collisions|links|draw scale|
 |:-|:-|:-|:-|:-|:-|:-|
-|<span style='color:(36, 51, 25)'>Boot Image (Flash)</span>|0xbb8 (3000)|0x7d0 (2000)|-0xbb8 (-3000)| end @ 0x7d0 |('Global System Address Map', 'OCM')|3:1|
-|<span style='color:(19, 58, 36)'>OCM (Global System Address Map)</span>|0x7e0 (2016)|0x7d0 (2000)|-0x8dc (-2268)| end @ 0x6d4 ||3:1|
-|<span style='color:(51, 30, 9)'>DDR Memory Controller (Global System Address Map)</span>|0x10 (16)|0x3e8 (1000)|0x3e8 (1000)|||3:1|
+|<span style='color:(46, 28, 53)'>Boot Image (Flash)</span>|0xbb8 (3000)|0x7d0 (2000)|-0xbb8 (-3000)| end @ 0x7d0 |('Global System Address Map', 'OCM')|3:1|
+|<span style='color:(17, 39, 29)'>OCM (Global System Address Map)</span>|0x7e0 (2016)|0x7d0 (2000)|-0x8dc (-2268)| end @ 0x6d4 ||3:1|
+|<span style='color:(27, 3, 48)'>DDR Memory Controller (Global System Address Map)</span>|0x10 (16)|0x3e8 (1000)|0x3e8 (1000)|||3:1|
 
 ---
 #### Global System Address Map:

doc/example/A6_region_exceeds_height-no_maxaddress_set.md

@@ -1,9 +1,9 @@
 ![memory map diagram](A6_region_exceeds_height-no_maxaddress_set_diagram.png)
 |region (parent)|origin|size|free Space|collisions|links|draw scale|
 |:-|:-|:-|:-|:-|:-|:-|
-|<span style='color:(23, 62, 48)'>OCM (Global System Address Map)</span>|0x7e0 (2016)|0x7d0 (2000)|-0x8dc (-2268)| end @ 0x6d4 ||3:1|
-|<span style='color:(41, 30, 68)'>DDR Memory Controller (Global System Address Map)</span>|0x10 (16)|0x3e8 (1000)|0x3e8 (1000)|||3:1|
-|<span style='color:(7, 45, 51)'>Boot Image (Flash)</span>|0x0 (0)|0xffffff (16777215)|-0xfff92b (-16775467)| end @ 0x6d4 ||9598:1|
+|<span style='color:(7, 26, 47)'>OCM (Global System Address Map)</span>|0x7e0 (2016)|0x7d0 (2000)|-0x8dc (-2268)| end @ 0x6d4 ||3:1|
+|<span style='color:(9, 57, 67)'>DDR Memory Controller (Global System Address Map)</span>|0x10 (16)|0x3e8 (1000)|0x3e8 (1000)|||3:1|
+|<span style='color:(58, 14, 64)'>Boot Image (Flash)</span>|0x0 (0)|0xffffff (16777215)|-0xfff92b (-16775467)| end @ 0x6d4 ||9598:1|
 
 ---
 #### Global System Address Map:

doc/example/A6_region_freespace_exceeds_height-higher_maxaddress_set.md

@@ -1,9 +1,9 @@
 ![memory map diagram](A6_region_freespace_exceeds_height-higher_maxaddress_set_diagram.png)
 |region (parent)|origin|size|free Space|collisions|links|draw scale|
 |:-|:-|:-|:-|:-|:-|:-|
-|<span style='color:(54, 25, 43)'>OCM (Global System Address Map)</span>|0x7e0 (2016)|0x7d0 (2000)|0xfffff04f (4294963279)|||3:1|
-|<span style='color:(46, 24, 11)'>DDR Memory Controller (Global System Address Map)</span>|0x10 (16)|0x3e8 (1000)|0x3e8 (1000)|||3:1|
-|<span style='color:(9, 7, 33)'>Boot Image (Flash)</span>|0x0 (0)|0xffffff (16777215)|0xff000000 (4278190080)|||10056:1|
+|<span style='color:(17, 15, 66)'>OCM (Global System Address Map)</span>|0x7e0 (2016)|0x7d0 (2000)|0xfffff04f (4294963279)|||3:1|
+|<span style='color:(25, 41, 33)'>DDR Memory Controller (Global System Address Map)</span>|0x10 (16)|0x3e8 (1000)|0x3e8 (1000)|||3:1|
+|<span style='color:(61, 47, 42)'>Boot Image (Flash)</span>|0x0 (0)|0xffffff (16777215)|0xff000000 (4278190080)|||10056:1|
 
 ---
 #### Global System Address Map:

doc/example/A7_maxaddress_lower_than_memregions.md

@@ -1,9 +1,9 @@
 ![memory map diagram](A7_maxaddress_lower_than_memregions_diagram.png)
 |region (parent)|origin|size|free Space|collisions|links|draw scale|
 |:-|:-|:-|:-|:-|:-|:-|
-|<span style='color:(44, 35, 60)'>Boot Image (Flash)</span>|0xbb8 (3000)|0x7d0 (2000)|-0xbb8 (-3000)| end @ 0x7d0 |('Global System Address Map', 'OCM')|5:1|
-|<span style='color:(15, 48, 12)'>OCM (Global System Address Map)</span>|0x7e0 (2016)|0x7d0 (2000)|-0xad8 (-2776)| end @ 0x4d8 ||4:1|
-|<span style='color:(42, 44, 45)'>DDR Memory Controller (Global System Address Map)</span>|0x10 (16)|0x3e8 (1000)|0x3e8 (1000)|||4:1|
+|<span style='color:(11, 50, 35)'>Boot Image (Flash)</span>|0xbb8 (3000)|0x7d0 (2000)|-0xbb8 (-3000)| end @ 0x7d0 |('Global System Address Map', 'OCM')|5:1|
+|<span style='color:(22, 19, 25)'>OCM (Global System Address Map)</span>|0x7e0 (2016)|0x7d0 (2000)|-0xad8 (-2776)| end @ 0x4d8 ||4:1|
+|<span style='color:(58, 49, 44)'>DDR Memory Controller (Global System Address Map)</span>|0x10 (16)|0x3e8 (1000)|0x3e8 (1000)|||4:1|
 
 ---
 #### Global System Address Map:

doc/example/A7_region_exceeds_height-no_maxaddress_set.md

@@ -1,9 +1,9 @@
 ![memory map diagram](A7_region_exceeds_height-no_maxaddress_set_diagram.png)
 |region (parent)|origin|size|free Space|collisions|links|draw scale|
 |:-|:-|:-|:-|:-|:-|:-|
-|<span style='color:(66, 0, 8)'>OCM (Global System Address Map)</span>|0x7e0 (2016)|0x7d0 (2000)|-0xad8 (-2776)| end @ 0x4d8 ||4:1|
-|<span style='color:(55, 18, 15)'>DDR Memory Controller (Global System Address Map)</span>|0x10 (16)|0x3e8 (1000)|0x3e8 (1000)|||4:1|
-|<span style='color:(26, 38, 13)'>Boot Image (Flash)</span>|0x0 (0)|0xffffff (16777215)|-0xfffb27 (-16775975)| end @ 0x4d8 ||13531:1|
+|<span style='color:(5, 45, 38)'>OCM (Global System Address Map)</span>|0x7e0 (2016)|0x7d0 (2000)|-0xad8 (-2776)| end @ 0x4d8 ||4:1|
+|<span style='color:(30, 49, 13)'>DDR Memory Controller (Global System Address Map)</span>|0x10 (16)|0x3e8 (1000)|0x3e8 (1000)|||4:1|
+|<span style='color:(35, 42, 4)'>Boot Image (Flash)</span>|0x0 (0)|0xffffff (16777215)|-0xfffb27 (-16775975)| end @ 0x4d8 ||13531:1|
 
 ---
 #### Global System Address Map: