Merge e655b6f into 19aad30

Author: ozan956

docs/products/adsp/setup.rst

@@ -41,20 +41,48 @@ For example, for the ICE-1000 and ADZS-SC589-EZLITE run the following:
 Boot U-Boot Proper
 ------------------
 
-In another terminal either ``cd`` into the extracted release archive or the
-appropriate build output directory when building from source. Then load and run
-the two U-Boot stages using ``gdb``. Note that Debian and Ubuntu ship
-multi-architecture GDB support in a separate package.
-
-After loading U-Boot SPL wait 2-3 seconds to allow SPL to complete execution
-before interrupting it with ``^C``.
+To debug both U-Boot SPL and U-Boot proper using GDB, one need to install
+`gdb-multiarch` on Debian or Ubuntu systems:
 
 .. code-block:: console
 
     sudo apt-get install -y gdb-multiarch
+
+In the terminal, ``cd`` into the extracted release archive or the appropriate
+build output directory. Then start GDB and run the following commands to load
+and run both U-Boot stages.
+
+.. code-block:: console
+
     gdb-multiarch
     (gdb) load u-boot-spl
-    (gdb) c
-    ^C
+    (gdb) set pagination off
+    (gdb) file u-boot-spl
+    (gdb) target remote :3333
+    (gdb) tbreak board_init_r
+    (gdb) load
+    (gdb) continue
     (gdb) load u-boot
-    (gdb) c
+    (gdb) continue
+
+To automate this, we can save the commands above into a file
+ ``debug-uboot.gdb`` and launch GDB with:
+
+.. code-block:: console
+
+    gdb-multiarch -x debug-uboot.gdb
+
+Boot Linux
+----------
+
+Once U-Boot Proper is running and a U-Boot prompt is accessible over serial it
+is possible to load and boot Linux.
+
+In a new terminal ``cd`` into the extracted release archive and run a web
+server (e.g. ``python -m http.server``).
+
+In the console of U-Boot, we can load images as:
+.. code-block:: console
+
+    => dhcp
+    => wget ${<memory-addr>} <host-ip-addr>:/<path-to-image>