From 44ba2836d4be01bcbf2f63be4dbd0e5760a86e86 Mon Sep 17 00:00:00 2001 From: Jonathan Humphreys Date: Fri, 14 Jun 2024 11:35:36 -0500 Subject: [PATCH] doc: board: ti: j721e: document OSPI layout Updated OSPI flash layout diagram. Signed-off-by: Jonathan Humphreys Reviewed-by: Tom Rini --- doc/board/ti/img/ospi_sysfw.svg | 1464 +++++++++++++++++-------------- doc/board/ti/j721e_evm.rst | 58 +- 2 files changed, 847 insertions(+), 675 deletions(-) diff --git a/doc/board/ti/img/ospi_sysfw.svg b/doc/board/ti/img/ospi_sysfw.svg index 648f6fd03e..2a2fd3f486 100644 --- a/doc/board/ti/img/ospi_sysfw.svg +++ b/doc/board/ti/img/ospi_sysfw.svg @@ -1,725 +1,897 @@ - + + inkscape:current-layer="g19241" /> + id="defs19023" /> - - - - - + id="g19241"> + + + + + + + + style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 198px; height: 1px; padding-top: 35px; margin-left: 121px;"> ospi.tiboot3(512k) + data-drawio-colors="color: rgb(0, 0, 0); " + style="box-sizing: border-box; font-size: 0px; text-align: center;"> + ospi.tiboot3(512k) + - - - ospi.tiboot3(512k) - - - - - - - + + ospi.tiboot3(512k) + + + + + + + + + + + style="display: flex; align-items: unsafe center; justify-content: unsafe flex-end; width: 58px; height: 1px; padding-top: 20px; margin-left: 60px;"> - 0x0 + data-drawio-colors="color: rgb(0, 0, 0); " + style="box-sizing: border-box; font-size: 0px; text-align: right;"> + + 0x0 + - - - 0x0 - - - - - - - + + 0x0 + + + + + + + + + + + style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 198px; height: 1px; padding-top: 75px; margin-left: 121px;"> ospi.tispl(2M) + data-drawio-colors="color: rgb(0, 0, 0); " + style="box-sizing: border-box; font-size: 0px; text-align: center;"> + ospi.tispl(2M) + - - - ospi.tispl(2M) - - - - - - - + + ospi.tispl(2M) + + + + + + + + + + + style="display: flex; align-items: unsafe center; justify-content: unsafe flex-end; width: 118px; height: 1px; padding-top: 60px; margin-left: 0px;"> - 0x80000 + data-drawio-colors="color: rgb(0, 0, 0); " + style="box-sizing: border-box; font-size: 0px; text-align: right;"> + + 0x80000 + - - - 0x80000 - - - - - - - + + 0x80000 + + + + + + + + + + + style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 198px; height: 1px; padding-top: 115px; margin-left: 121px;"> ospi.u-boot(4M) + data-drawio-colors="color: rgb(0, 0, 0); " + style="box-sizing: border-box; font-size: 0px; text-align: center;"> + ospi.u-boot(4M) + - - - ospi.u-boot(4M) - - - - - - - + + ospi.u-boot(4M) + + + + + + + + + + + style="display: flex; align-items: unsafe center; justify-content: unsafe flex-end; width: 118px; height: 1px; padding-top: 100px; margin-left: 0px;"> - 0x280000 + data-drawio-colors="color: rgb(0, 0, 0); " + style="box-sizing: border-box; font-size: 0px; text-align: right;"> + + 0x280000 + - - - 0x280000 - - - - - - - + + 0x280000 + + + + + + + + + + + style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 198px; height: 1px; padding-top: 155px; margin-left: 121px;"> ospi.env(128K) + data-drawio-colors="color: rgb(0, 0, 0); " + style="box-sizing: border-box; font-size: 0px; text-align: center;"> + ospi.env(128K) + - - - ospi.env(128K) - - - - - - - + + ospi.env(128K) + + + + + + + + + + + style="display: flex; align-items: unsafe center; justify-content: unsafe flex-end; width: 118px; height: 1px; padding-top: 140px; margin-left: 0px;"> - 0x680000 + data-drawio-colors="color: rgb(0, 0, 0); " + style="box-sizing: border-box; font-size: 0px; text-align: right;"> + + 0x680000 + - - - 0x680000 - - - - - - - + + 0x680000 + + + + + + + + + + + style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 198px; height: 1px; padding-top: 195px; margin-left: 121px;"> ospi.env.backup(128K) + data-drawio-colors="color: rgb(0, 0, 0); " + style="box-sizing: border-box; font-size: 0px; text-align: center;"> + ospi.env.backup(128K) + - - - ospi.env.backup(128K) - - - - - - - + + ospi.env.backup(128K) + + + + + + + + + + + style="display: flex; align-items: unsafe center; justify-content: unsafe flex-end; width: 118px; height: 1px; padding-top: 180px; margin-left: 0px;"> - 0x6A0000 + data-drawio-colors="color: rgb(0, 0, 0); " + style="box-sizing: border-box; font-size: 0px; text-align: right;"> + + 0x6A0000 + - - - 0x6A0000 - - - - - - - + + 0x6A0000 + + + + + + + + + + + style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 198px; height: 1px; padding-top: 235px; margin-left: 121px;"> ospi.sysfw(1M) + data-drawio-colors="color: rgb(0, 0, 0); " + style="box-sizing: border-box; font-size: 0px; text-align: center;"> + ospi.sysfw(1M) + - - - ospi.sysfw(1M) - - - - - - - + + ospi.sysfw(1M) + + + + + + + + + + + style="display: flex; align-items: unsafe center; justify-content: unsafe flex-end; width: 118px; height: 1px; padding-top: 220px; margin-left: 0px;"> - 0x6C0000 + data-drawio-colors="color: rgb(0, 0, 0); " + style="box-sizing: border-box; font-size: 0px; text-align: right;"> + + 0x6C0000 + - - - 0x6C0000 - - - - - - - + + 0x6C0000 + + + + + + + + + + + style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 198px; height: 1px; padding-top: 275px; margin-left: 121px;"> padding(256K) + data-drawio-colors="color: rgb(0, 0, 0); " + style="box-sizing: border-box; font-size: 0px; text-align: center;"> + padding(256K) + - - - padding(256K) - - - - - - - + + padding(256K) + + + + + + + + + + + style="display: flex; align-items: unsafe center; justify-content: unsafe flex-end; width: 118px; height: 1px; padding-top: 260px; margin-left: 0px;"> - 0x7C0000 + data-drawio-colors="color: rgb(0, 0, 0); " + style="box-sizing: border-box; font-size: 0px; text-align: right;"> + + 0x7C0000 + - - - 0x7C0000 - - - - - - - + + 0x7C0000 + + + + + + + + + + + style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 198px; height: 1px; padding-top: 315px; margin-left: 121px;"> ospi.rootfs(UBIFS) + data-drawio-colors="color: rgb(0, 0, 0); " + style="box-sizing: border-box; font-size: 0px; text-align: center;"> + ospi.rootfs(UBIFS) + - - - ospi.rootfs(UBIFS) - - - - - - - + + ospi.rootfs(UBIFS) + + + + + + + + + + + + + + 0x800000 + + + + + 0x800000 + + + + + + + + + + + + + ospi.phypattern(128k) + + + + ospi.phypattern(128k) + + + + + + + + + + + style="display: flex; align-items: unsafe center; justify-content: unsafe flex-end; width: 118px; height: 1px; padding-top: 340px; margin-left: 0px;"> - 0x800000 + data-drawio-colors="color: rgb(0, 0, 0); " + style="box-sizing: border-box; font-size: 0px; text-align: right;"> + + 0x3FE0000 + - - - 0x800000 - + + 0x3FE0000 + + - - - - Text is not SVG - cannot display - - diff --git a/doc/board/ti/j721e_evm.rst b/doc/board/ti/j721e_evm.rst index a422a9bf1a..80d91cafab 100644 --- a/doc/board/ti/j721e_evm.rst +++ b/doc/board/ti/j721e_evm.rst @@ -150,6 +150,33 @@ 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: + +.. image:: img/ospi_sysfw.svg + :alt: OSPI flash partition layout + R5 Memory Map: -------------- @@ -193,35 +220,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.39.5