On 00:45-20231220, Apurva Nandan wrote:
TI K3 J784S4 and AM69 are new additions to the K3 SoC family. Add documentation about the J784S4 EVM and AM69 SK.
Signed-off-by: Dasnavis Sabiya sabiya.d@ti.com Signed-off-by: Apurva Nandan a-nandan@ti.com
doc/board/ti/j784s4_evm.rst | 303 ++++++++++++++++++++++++++++++++++++ doc/board/ti/k3.rst | 1 + 2 files changed, 304 insertions(+) create mode 100644 doc/board/ti/j784s4_evm.rst
diff --git a/doc/board/ti/j784s4_evm.rst b/doc/board/ti/j784s4_evm.rst new file mode 100644 index 0000000000..bb7ed0b031 --- /dev/null +++ b/doc/board/ti/j784s4_evm.rst @@ -0,0 +1,303 @@
[...]
+More info can be found in TRM: http://www.ti.com/lit/zip/spruj52
+Platform information:
+* https://www.ti.com/tool/J784S4XEVM +* https://www.ti.com/tool/SK-AM69
+Boot Flow +--------- +Below is the pictorial representation of boot flow:
+.. image:: img/boot_diagram_k3_current.svg
- :alt: K3 boot flow
+- On this platform, "TI Foundational Security (TIFS)" functions as the
"TI Foundational Security" (TIFS)
- security enclave master. While "Device Manager (DM)", also known as the
"Device Manager" (DM)
[...]
+Switch Setting for Boot Mode +----------------------------
+Boot Mode pins provide means to select the boot mode and options before the +device is powered up. After every POR, they are the main source to populate +the Boot Parameter Tables.
+Boot Mode Pins for J784S4-EVM +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+The following tables show some common boot modes used on J784S4 SoC platform.
Pick EVM Platform - since we are talking about evm in this context.
+More details can be found in the Technical Reference Manual: +http://www.ti.com/lit/zip/spruj52 under the `Boot Mode Pins` section.
+.. list-table:: J784S4 EVM Boot Modes
- :widths: 16 16 16
- :header-rows: 1
- Switch Label
- SW9: 12345678- SW8: 12345678
- SD
- 00000000- 10000010
- EMMC
- 01000000- 10000000
- OSPI
- 01000000- 00000110
- UART
- 01110000- 00000000
- USB DFU
- 00100000- 10000000+For SW8 and SW9, the switch state in the "ON" position = 1.
+Boot Mode Pins for AM69-SK +^^^^^^^^^^^^^^^^^^^^^^^^^^
+The following table show some common boot modes used on AM69-SK platform. +More details can be found in the User Guide for AM69-SK: +https://www.ti.com/lit/ug/spruj70/spruj70.pdf under the `Bootmode Settings` +section.
+.. list-table:: AM69 SK Boot Modes
- :widths: 16 16
- :header-rows: 1
- Switch Label
- SW2: 1234
- SD
- 0000
- EMMC
- 0110
- OSPI
- 1110
- UART
- 1010
Just make sure that the dip switches match up to the boot modes we support in u-boot.
+For SW2, the switch state in the "ON" position = 1.
+Debugging U-Boot +----------------
+See :ref:`Common Debugging environment - OpenOCD<k3_rst_refer_openocd>`: for +detailed setup information.
+.. warning::
- **Debugging the platform via JTAG requires latest OpenOCD tag**
This very vague. Use the same terminology as doc/board/ti/am62ax_sk.rst
+Debugging U-Boot on J784S4-EVM and AM69-SK +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. include:: k3.rst
- :start-after: .. k3_rst_include_start_openocd_connect_XDS110
- :end-before: .. k3_rst_include_end_openocd_connect_XDS110
+To start OpenOCD and connect to J784S4-EVM or AM69-SK board, use the +following.
+.. code-block:: bash
- openocd -f board/ti_j784s4evm.cfg
diff --git a/doc/board/ti/k3.rst b/doc/board/ti/k3.rst index f19ee56f29..6b2faa9dc3 100644 --- a/doc/board/ti/k3.rst +++ b/doc/board/ti/k3.rst @@ -40,6 +40,7 @@ K3 Based SoCs ../beagle/j721e_beagleboneai64 j721e_evm j721s2_evm
- j784s4_evm
Boot Flow Overview