Skip to content

Commit 9712486

Browse files
aronkisaronkis
authored
Merge branch 'analogdevicesinc:main' into main
2 parents f292663 + 33783b2 commit 9712486

24 files changed

+5150
-21
lines changed

‎docs/conf.py‎

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -53,3 +53,21 @@
5353
# -- Show TODOs ---------------------------------------------------------------
5454

5555
todo_include_todos = True
56+
57+
# -- Linkcheck ----------------------------------------------------------------
58+
59+
linkcheck_sitemaps = [
60+
"https://wiki.analog.com/doku.php?do=sitemap",
61+
"https://www.analog.com/media/en/en-pdf-sitemap.xml",
62+
"https://www.analog.com/media/en/en-pdp-sitemap.xml",
63+
]
64+
linkcheck_timeout = 5
65+
linkcheck_request_headers = {
66+
"*": {
67+
"User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:142.0) Gecko/20100101 Firefox/142.0",
68+
"Accept-Language": "en-US,en;q=0.5",
69+
},
70+
}
71+
linkcheck_ignore = [
72+
r'https://www.digikey.com/',
73+
]

‎docs/products/adsp/index.rst‎

Lines changed: 97 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -3,36 +3,112 @@
33
Digital Signal Processors (ADSP)
44
================================
55

6+
.. toctree::
7+
:hidden:
8+
:glob:
9+
10+
*
11+
612
ADI has a large portfolio of :adi:`Digital Signal Processors <en/product-category/dsp.html>`
713
(see :adi:`Selection Table for Digital Signal Processors <en/parametricsearch/3020#/>`).
814
A subset of those processors include ARM Cortex cores and are prefixed with SC
915
for "SHARC Connect". They can run baremetal applications, an RTOS or Linux.
1016
Cortex-M33 models are appropriate for a baremetal application or an RTOS, while
1117
Cortex-A5 and Cortex-A55 can also run 32-bit or 64-bit Linux respectively.
1218

13-
Cortex-M33
14-
----------
19+
.. list-table:: ADSP SHARC Connect SoCs
20+
:header-rows: 1
21+
22+
* - Cortex-M33
23+
- Cortex-A5
24+
- Cortex-A55
25+
* - :adi:`ADSP-SC834 <en/products/ADSP-SC834.html>`
26+
- :adi:`ADSP-SC570 <en/products/ADSP-SC570.html>`
27+
- :adi:`ADSP-SC596 <en/products/ADSP-SC596.html>`
28+
* - :adi:`ADSP-SC835 <en/products/ADSP-SC835.html>`
29+
- :adi:`ADSP-SC571 <en/products/ADSP-SC571.html>`
30+
- :adi:`ADSP-SC598 <en/products/ADSP-SC598.html>`
31+
* -
32+
- :adi:`ADSP-SC572 <en/products/ADSP-SC572.html>`
33+
-
34+
* -
35+
- :adi:`ADSP-SC573 <en/products/ADSP-SC573.html>`
36+
-
37+
* -
38+
- :adi:`ADSP-SC582 <en/products/ADSP-SC582.html>`
39+
-
40+
* -
41+
- :adi:`ADSP-SC583 <en/products/ADSP-SC583.html>`
42+
-
43+
* -
44+
- :adi:`ADSP-SC584 <en/products/ADSP-SC584.html>`
45+
-
46+
* -
47+
- :adi:`ADSP-SC587 <en/products/ADSP-SC587.html>`
48+
-
49+
* -
50+
- :adi:`ADSP-SC589 <en/products/ADSP-SC589.html>`
51+
-
52+
* -
53+
- :adi:`ADSP-SC592 <en/products/ADSP-SC592.html>`
54+
-
55+
* -
56+
- :adi:`ADSP-SC594 <en/products/ADSP-SC594.html>`
57+
-
58+
59+
Linux support
60+
-------------
61+
62+
ADI supports running Linux on all ADSP SoCs with Cortex-A5 and A55 cores.
63+
That includes the following repositories. New features are tracked in the
64+
`ADSP Github Project <https://github.com/orgs/analogdevicesinc/projects/20/views/1>`__
65+
and coordinated with the community during weekly public office hours at 17:00 CET
66+
on Thursdays using a
67+
`Jitsi meeting <https://meet.jit.si/AnalogDevicesIncDigitalSignalProcessingOfficeHours>`__.
68+
69+
Upstream forks
70+
--------------
1571

16-
- :adi:`ADSP-SC834 <en/products/ADSP-SC834.html>`
17-
- :adi:`ADSP-SC835 <en/products/ADSP-SC835.html>`
72+
The ADSP Linux team maintains branches based on upstream releases. Changes made
73+
to support ADI hardware is upstreamed as quickly as possible. Until those
74+
changes have been accepted upstream, they are maintained in the following ADI
75+
forks.
1876

19-
Cortex-A5
20-
---------
77+
Release versions include the upstream version and a ADI specific release number
78+
(e.g. ``1``, ``2``, ...).
2179

22-
- :adi:`ADSP-SC570 <en/products/ADSP-SC570.html>`
23-
- :adi:`ADSP-SC571 <en/products/ADSP-SC571.html>`
24-
- :adi:`ADSP-SC572 <en/products/ADSP-SC572.html>`
25-
- :adi:`ADSP-SC573 <en/products/ADSP-SC573.html>`
26-
- :adi:`ADSP-SC582 <en/products/ADSP-SC582.html>`
27-
- :adi:`ADSP-SC583 <en/products/ADSP-SC583.html>`
28-
- :adi:`ADSP-SC584 <en/products/ADSP-SC584.html>`
29-
- :adi:`ADSP-SC587 <en/products/ADSP-SC587.html>`
30-
- :adi:`ADSP-SC589 <en/products/ADSP-SC589.html>`
31-
- :adi:`ADSP-SC592 <en/products/ADSP-SC592.html>`
32-
- :adi:`ADSP-SC594 <en/products/ADSP-SC594.html>`
80+
- :git-linux:`+`:
81+
- v6.12.0:
82+
:git-linux:`Commits <commits/adsp-6.12.0-y+>`
83+
:git-linux:`Release 1 <releases/tag/adsp-6.12.0-1+>`
84+
- v6.12.38:
85+
:git-linux:`Commits <commits/adsp-6.12.38-y+>`
86+
- :git-u-boot:`+`
87+
- v2025.07:
88+
:git-u-boot:`Commits <commits/adi-u-boot-2025.07.y+>`
89+
:git-u-boot:`Release 1 <releases/tag/v2025.07-1+>`
90+
- v2025.10:
91+
:git-u-boot:`Commits <commits/adi-u-boot-2025.10.y+>`
92+
:git-u-boot:`Release 1 <releases/tag/v2025.10-1+>`
93+
- :git-buildroot:`+`
94+
- v2025.05:
95+
:git-buildroot:`Commits <commits/adi-2025.05.x+>`
96+
:git-buildroot:`Release 1 <releases/tag/2025.05-1+>`
97+
- :git-trusted-firmware-a:`+`
98+
- :git-optee_os:`+`
99+
- :git-openocd:`+`
100+
- :git-openocd:`0.12.0-1.0.0 <releases/tag/0.12.0-1.0.0+>`
101+
:git-openocd:`0.12.0-1.1.1 <releases/tag/0.12.0-1.1.1+>`
102+
:git-openocd:`0.12.0-1.1.2 <releases/tag/0.12.0-1.1.2+>`
103+
:git-openocd:`0.12.0-1.2.0 <releases/tag/0.12.0-1.2.0+>`
104+
:git-openocd:`0.12.0-1.3.0 <releases/tag/0.12.0-1.3.0+>`
33105

34-
Cortex-A55
35-
----------
106+
ADI repositories
107+
----------------
36108

37-
- :adi:`ADSP-SC596 <en/products/ADSP-SC596.html>`
38-
- :adi:`ADSP-SC598 <en/products/ADSP-SC598.html>`
109+
- :git-adsp-ldr:`+`
110+
- :git-adsp-ldr:`v1.0.0 <releases/tag/v1.0.0+>`
111+
:git-adsp-ldr:`v1.0.1 <releases/tag/v1.0.1+>`
112+
:git-adsp-ldr:`v1.0.2 <releases/tag/v1.0.2+>`
113+
- :git-lnxdsp-repo-manifest:`+`
114+
- :git-br2-external:`+`

‎docs/products/adsp/setup.rst‎

Lines changed: 81 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,81 @@
1+
.. _adsp setup:
2+
3+
Getting started
4+
===============
5+
6+
ADSP evaluation boards do not ship with pre-installed software. The chips also
7+
do not support booting directly from SD cards. Therefore the evaluation boards
8+
need to be bootstrapped over JTAG using a :adi:`ADI ICE-1000 or ICE-2000 JTAG
9+
debugger <en/resources/evaluation-hardware-and-software/evaluation-boards-kits/emulators.html>`.
10+
11+
Setup a JTAG connection
12+
-----------------------
13+
14+
Build and install the ADI fork of OpenOCD:
15+
16+
.. shell:: sh
17+
18+
$git clone https://github.com/analogdevicesinc/openocd
19+
$cd openocd
20+
$./bootstrap
21+
$./configure
22+
$make -j$(nproc)
23+
24+
Run ``openocd`` with either ``ice1000.cfg`` or ``ice2000.cfg`` and one of the
25+
following configs:
26+
27+
- ``adspsc58x.cfg``
28+
- ``adspsc59x_a55.cfg``
29+
30+
For example, for the ICE-1000 and ADZS-SC589-EZLITE run the following:
31+
32+
.. shell:: sh
33+
34+
~/openocd
35+
$src/openocd -f ice1000.cfg \
36+
$ -f adspsc58x.cfg \
37+
$ --search tcl/ \
38+
$ --search tcl/interface/ \
39+
$ --search tcl/target/
40+
41+
Boot U-Boot Proper
42+
------------------
43+
44+
To boot U-Boot SPL and U-Boot Proper using GDB install
45+
``gdb-multiarch`` on Debian or Ubuntu systems:
46+
47+
.. shell:: sh
48+
49+
$sudo apt-get install -y gdb-multiarch
50+
51+
In the terminal, ``cd`` into the extracted release archive or the appropriate
52+
build output directory.
53+
54+
Then download the GDB automation :download:`u-boot.gdb` script using:
55+
56+
.. shell:: sh
57+
58+
$curl -O https://raw.githubusercontent.com/analogdevicesinc/documentation/refs/heads/main/docs/products/adsp/u-boot.gdb
59+
60+
Once downloaded, start GDB and run the following command with the script in order to
61+
load and run both U-Boot stages as:
62+
63+
.. shell:: sh
64+
65+
$gdb-multiarch -x u-boot.gdb
66+
67+
Boot Linux
68+
----------
69+
70+
Once U-Boot Proper is running and a U-Boot prompt is accessible over serial it
71+
is possible to load and boot Linux.
72+
73+
In a new terminal ``cd`` into the extracted release archive and run a web
74+
server (e.g. ``python -m http.server``).
75+
76+
In the console of U-Boot, we can load images as:
77+
78+
.. code-block:: console
79+
80+
=> dhcp
81+
=> wget ${fdt_addr_r} <host-ip-addr>:/<path-to-image>

‎docs/products/adsp/u-boot.gdb‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
set pagination off
2+
file u-boot-spl
3+
target remote :3333
4+
tbreak board_init_r
5+
load
6+
continue
7+
load u-boot
8+
continue

‎docs/solutions/reference-designs/ad-ethernetapldevice-sl/02-083152-01-b.pdf‎

132 Bytes
Binary file not shown.

‎docs/solutions/reference-designs/ad-ethernetapldevice-sl/02-083153-01-c.pdf‎

132 Bytes
Binary file not shown.

‎docs/solutions/reference-designs/ad-ethernetapldevice-sl/02-084576-01-b.pdf‎

132 Bytes
Binary file not shown.

‎docs/solutions/reference-designs/ad-ethernetapldevice-sl/05-083152-01-b.csv.zip‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
version https://git-lfs.github.com/spec/v1
2+
oid sha256:e6dd62b36879d6ac80245ebef7a6f6c37d20587552ea29df99abf1ff708e41f3
3+
size 4610

‎docs/solutions/reference-designs/ad-ethernetapldevice-sl/05-083153-01-c.csv.zip‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
version https://git-lfs.github.com/spec/v1
2+
oid sha256:ff98c998a3ff22d3716311c89298e130510eb30bc1453c870bdbc802fefb4bbf
3+
size 4356

‎docs/solutions/reference-designs/ad-ethernetapldevice-sl/05-084576-01-b.csv.zip‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
version https://git-lfs.github.com/spec/v1
2+
oid sha256:f44c3d63c9db0b64b83f806931f5c0563fd6b8952dce74ae7bc97add5718bd18
3+
size 4357

0 commit comments

Comments
 (0)