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 <sabiy...@ti.com> > Signed-off-by: Apurva Nandan <a-nan...@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 > ------------------ -- Regards, Nishanth Menon Key (0xDDB5849D1736249D) / Fingerprint: F8A2 8693 54EB 8232 17A3 1A34 DDB5 849D 1736 249D
