Skip to content

products/adsp: Improvments on boot flow #91

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Nov 21, 2025
Merged

products/adsp: Improvments on boot flow #91

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
40 changes: 27 additions & 13 deletions docs/products/adsp/setup.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,8 +4,8 @@
===============

ADSP evaluation boards do not ship with pre-installed software. The chips also
do not support booting directly from SD cards. Therefore the evaluation boards

Check warning on line 7 in docs/products/adsp/setup.rst

View workflow job for this annotation

GitHub Actions / check-doc 

vale:write-good.TooWordy:docs/products/adsp/setup.rst:7:48 'Therefore' is too wordy.
need to be bootstrapped over JTAG using a :adi:`ADI ICE-1000 or ICE-2000 JTAG

Check warning on line 8 in docs/products/adsp/setup.rst

View workflow job for this annotation

GitHub Actions / check-doc 

vale:write-good.Passive:docs/products/adsp/setup.rst:8:9 'be bootstrapped' may be passive voice. Use active voice if you can.
debugger <en/resources/evaluation-hardware-and-software/evaluation-boards-kits/emulators.html>`.

Setup a JTAG connection
Expand All @@ -22,7 +22,7 @@
$make -j$(nproc)

Run ``openocd`` with either ``ice1000.cfg`` or ``ice2000.cfg`` and one of the
following configs:

Check failure on line 25 in docs/products/adsp/setup.rst

View workflow job for this annotation

GitHub Actions / check-doc 

vale:Vale.Spelling:docs/products/adsp/setup.rst:25:11 Did you really mean 'configs'?

- ``adspsc58x.cfg``
- ``adspsc59x_a55.cfg``
Expand All @@ -41,20 +41,34 @@
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.
To boot U-Boot SPL and U-Boot Proper using GDB install
``gdb-multiarch`` on Debian or Ubuntu systems:

After loading U-Boot SPL wait 2-3 seconds to allow SPL to complete execution
before interrupting it with ``^C``.
.. shell:: sh

$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 command with
using the script
:download:`u-boot.gdb <u-boot.gdb>` to load and run both U-Boot stages.

.. shell:: sh

$gdb-multiarch -x path/to/u-boot.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

sudo apt-get install -y gdb-multiarch
gdb-multiarch
(gdb) load u-boot-spl
(gdb) c
^C
(gdb) load u-boot
(gdb) c
=> dhcp
=> wget ${fdt_addr_r} <host-ip-addr>:/<path-to-image>
8 changes: 8 additions & 0 deletions docs/products/adsp/u-boot.gdb
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
set pagination off
file u-boot-spl
target remote :3333
tbreak board_init_r
load
continue
load u-boot
continue