[PATCH v3 04/19] doc: board: ti: am64x: document OSPI layout

[Jonathan Humphreys]

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

diff --git a/doc/board/ti/am64x_evm.rst b/doc/board/ti/am64x_evm.rst
index 6ae35b3fee3..a7468fbd254 100644
--- a/doc/board/ti/am64x_evm.rst
+++ b/doc/board/ti/am64x_evm.rst
@@ -140,6 +140,54 @@ Image formats:
 .. image:: img/nodm_tispl.bin.svg
   :alt: tispl.bin 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, and u-boot.img,
+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 0x100000 $filesize
+  tftp ${loadaddr} u-boot.img
+  sf update $loadaddr 0x300000 $filesize
+
+Flash layout for OSPI:
+
+    .. code-block:: console
+
+             0x0 +----------------------------+
+                 |     ospi.tiboot3(1m)       |
+                 |                            |
+        0x100000 +----------------------------+
+                 |     ospi.tispl(2m)         |
+                 |                            |
+        0x300000 +----------------------------+
+                 |     ospi.u-boot(4m)        |
+                 |                            |
+        0x700000 +----------------------------+
+                 |     ospi.env(128k)         |
+                 |                            |
+        0x720000 +----------------------------+
+                 |   ospi.env.backup(128k)    |
+                 |                            |
+        0x740000 +----------------------------+
+                 |      padding (768k)        |
+        0x800000 +----------------------------+
+                 |     ospi.rootfs(ubifs)     |
+                 |                            |
+       0x3fc0000 +----------------------------+
+                 |   ospi.phypattern (256k)   |
+                 |                            |
+                 +----------------------------+
+
 Switch Setting for Boot Mode
 ----------------------------
 
-- 
2.34.1