[PATCH v3 07/19] doc: board: ti: j721e: document OSPI layout

[Jonathan Humphreys]

Signed-off-by: Jonathan Humphreys <j-humphreys at ti.com>
---
 doc/board/ti/j721e_evm.rst | 85 +++++++++++++++++++++++++-------------
 1 file changed, 56 insertions(+), 29 deletions(-)

diff --git a/doc/board/ti/j721e_evm.rst b/doc/board/ti/j721e_evm.rst
index a422a9bf1a0..a0fc37ab6d7 100644
--- a/doc/board/ti/j721e_evm.rst
+++ b/doc/board/ti/j721e_evm.rst
@@ -150,6 +150,60 @@ Image formats:
 .. image:: img/sysfw.itb.svg
   :alt: sysfw.itb image format
 
+OSPI:
+-----
+ROM supports booting from OSPI from offset 0x0.
+
+Flashing images to OSPI:
+
+Below commands can be used to download tiboot3.bin, tispl.bin, u-boot.img,
+and sysfw.itb over tftp and then flash those to OSPI at their respective
+addresses.
+
+.. prompt:: bash =>
+
+  sf probe
+  tftp ${loadaddr} tiboot3.bin
+  sf update $loadaddr 0x0 $filesize
+  tftp ${loadaddr} tispl.bin
+  sf update $loadaddr 0x80000 $filesize
+  tftp ${loadaddr} u-boot.img
+  sf update $loadaddr 0x280000 $filesize
+  tftp ${loadaddr} sysfw.itb
+  sf update $loadaddr 0x6C0000 $filesize
+
+Flash layout for OSPI:
+
+    .. code-block:: console
+
+             0x0 +----------------------------+
+                 |     ospi.tiboot3(512K)     |
+                 |                            |
+         0x80000 +----------------------------+
+                 |     ospi.tispl(2M)         |
+                 |                            |
+        0x280000 +----------------------------+
+                 |     ospi.u-boot(4M)        |
+                 |                            |
+        0x680000 +----------------------------+
+                 |     ospi.env(128K)         |
+                 |                            |
+        0x6A0000 +----------------------------+
+                 |   ospi.env.backup (128K)   |
+                 |                            |
+        0x6C0000 +----------------------------+
+                 |      ospi.sysfw(1M)        |
+                 |                            |
+        0x7C0000 +----------------------------+
+                 |      padding (256k)        |
+        0x800000 +----------------------------+
+                 |     ospi.rootfs(UBIFS)     |
+                 |                            |
+       0x3FE0000 +----------------------------+
+                 |   ospi.phypattern (128k)   |
+                 |                            |
+                 +----------------------------+
+
 R5 Memory Map:
 --------------
 
@@ -193,35 +247,8 @@ R5 Memory Map:
      - 0x41cffbfc
      - 0x41cfffff
 
-OSPI:
------
-ROM supports booting from OSPI from offset 0x0.
-
-Flashing images to OSPI:
-
-Below commands can be used to download tiboot3.bin, tispl.bin, u-boot.img,
-and sysfw.itb over tftp and then flash those to OSPI at their respective
-addresses.
-
-.. prompt:: bash =>
-
-  sf probe
-  tftp ${loadaddr} tiboot3.bin
-  sf update $loadaddr 0x0 $filesize
-  tftp ${loadaddr} tispl.bin
-  sf update $loadaddr 0x80000 $filesize
-  tftp ${loadaddr} u-boot.img
-  sf update $loadaddr 0x280000 $filesize
-  tftp ${loadaddr} sysfw.itb
-  sf update $loadaddr 0x6C0000 $filesize
-
-Flash layout for OSPI:
-
-.. image:: img/ospi_sysfw.svg
-  :alt: OSPI flash partition layout
-
-Firmwares:
-----------
+Firmware:
+---------
 
 The J721e u-boot allows firmware to be loaded for the Cortex-R5 subsystem.
 The CPSW5G in J7200 and CPSW9G in J721E present in MAIN domain is configured
-- 
2.34.1