From ce210be14caca7154b96c389a813f2075b9db4d4 Mon Sep 17 00:00:00 2001
From: Igor Opaniuk <igor.opaniuk@foundries.io>
Date: Fri, 29 Sep 2023 14:43:01 +0300
Subject: [PATCH] rm: boards: am62xx-evk: update flashing instructions

Update flashing instructions, as new flash.sh script is used for
flash automation.

Signed-off-by: Igor Opaniuk <igor.opaniuk@foundries.io>
---
 .../boards/am62xx-sk-prepare.rst              | 22 ++++++-
 source/reference-manual/boards/am62xx-sk.rst  | 65 +++++++++++++------
 2 files changed, 66 insertions(+), 21 deletions(-)

diff --git a/source/reference-manual/boards/am62xx-sk-prepare.rst b/source/reference-manual/boards/am62xx-sk-prepare.rst
index 2c63d68bb..7dd6a2a7f 100644
--- a/source/reference-manual/boards/am62xx-sk-prepare.rst
+++ b/source/reference-manual/boards/am62xx-sk-prepare.rst
@@ -36,7 +36,7 @@ Download necessary files from ``https://app.foundries.io/factories/<factory>/tar
    machine.**
 
    | E.g: ``lmp-factory-image-am62xx-evm.wic.gz``
-   
+
    .. figure:: /_static/boards/am62xx-sk-steps-2.png
       :align: center
       :width: 600
@@ -44,6 +44,26 @@ Download necessary files from ``https://app.foundries.io/factories/<factory>/tar
 
       gunzip lmp-factory-image-am62xx-evm.wic.gz
 
+#. Expand the **run** in the :guilabel:`Runs` section which corresponds
+   with the name of the board ti-mfgtool-files and **download the tools for that
+   machine.**
+
+   E.g: ``ti-mfgtool-files-am62xx-evm.tar.gz``
+
+#. Download and extract the file ``ti-mfgtool-files-am62xx-evm.tar.gz``::
+
+      tar -zxvf ti-mfgtool-files-am62xx-evm.tar.gz
+
+#. Organize all the files like the tree below::
+
+      ├── lmp-factory-image-am62xx-evm.wic
+      ├── lmp-factory-image-am62xx-evm.wic.gz
+      └── ti-mfgtool-files-am62xx-evm
+          ├── flash.sh
+          ├── tiboot3.bin
+          ├── tispl.bin
+          └── uboot.img
+
 .. _SK-AM62B:
    https://www.ti.com/tool/SK-AM62B
 
diff --git a/source/reference-manual/boards/am62xx-sk.rst b/source/reference-manual/boards/am62xx-sk.rst
index dd519e074..a95557ab8 100644
--- a/source/reference-manual/boards/am62xx-sk.rst
+++ b/source/reference-manual/boards/am62xx-sk.rst
@@ -8,7 +8,7 @@ Texas Instruments AM62x SKEVM
 Hardware Preparation
 --------------------
 
-Set up the board for booting from MMC1 - SDCard:
+Set up the board for booting from USD DFU mode:
 
 #. Ensure that the power is off (remove cable from J11)
 
@@ -18,26 +18,51 @@ Set up the board for booting from MMC1 - SDCard:
 
      AM62xx-sk top view
 
-2. Put the am62xx-sk into boot from SDCard Mode:
-
-.. figure:: /_static/boards/am62xx-sk-switches.png
-     :width: 300
-     :align: center
-
-     Switch settings
-
+2. Put the am62xx-sk into boot from USB DFU Mode,
+   changing boot switches to: ``00000000 11001010``
 
 Flashing
 --------
 
-Now, flash the ``lmp-factory-image-am62xx-evm.wic.gz`` retrieved from the
-previous section to an SD Card. This contains the :term:`system image` that the
-device will boot.
-
-.. include:: generic-flashing.rst
-
-.. figure:: /_static/boards/am62xx-sk-bottom.png
-     :width: 600
-     :align: center
-
-     SDCard location
+#. Power on the board and flash the ``lmp-factory-image-am62xx-evm.wic``
+   using ``flash.sh`` script from ``ti-mfgtool-files-am62xx-evm`` directory.
+   The wic image contains the :term:`system image` that the device will boot.
+
+.. prompt:: bash host:~$, auto
+
+	host:$ ./ti-mfgtool-files-am62xx-evm/flash.sh --wic lmp-factory-image-am62xx-evm.wic
+
+    Load U-Boot via DFU...
+    ------------------------------------------
+      DFU BOOT TIBOOT3: TIFS and R5
+    ------------------------------------------
+    dfu-util: can't detach
+    ------------------------------------------
+      DFU BOOT TISPL: TFA/OPTEE/ and A53 SPL
+    ------------------------------------------
+    ------------------------------------------
+      DFU BOOT UBOOT: A53 UBOOT
+    ------------------------------------------
+    ------------------------------------------
+      Exposing eMMC via USB using UMS
+    ------------------------------------------
+    Detected device: /dev/sda
+    Confirm flashing lmp-factory-image-am62xx-evm.wic to /dev/sda (y/N) >y
+    ------------------------------------------
+      Flashing /dev/sda via UMS
+    ------------------------------------------
+    844103680 bytes (844 MB, 805 MiB) copied, 57 s, 14,8 MB/s
+    814+1 records in
+    814+1 records out
+    854511616 bytes (855 MB, 815 MiB) copied, 57,7472 s, 14,8 MB/s
+    Flashing is finished
+
+2. Power off the board.
+
+Configure SD Boot
+-----------------
+
+#. Put the am62xx-sk into boot from SDCard Mode,
+   changing boot switches to: ``01000000 11000010``.
+
+#. Power on a board.
\ No newline at end of file