README.rst
1.. zephyr:code-sample:: amp_audio_output
2 :name: Audio output AMP sample.
3
4 AMP system example for NXP i.MX RTxxx platforms - audio output.
5
6Overview
7********
8
9This sample demonstrates the use of the DSP domains on supported NXP i.MX RTxxx
10platforms in an asymmetric multiprocessing (AMP) scenario. It's a sample with
11separate projects for Cortex-M and DSP domains, that are built together into a
12single resulting image using Sysbuild. The Cortex-M domain is responsible for
13setting up the DSP domain (clock and power setup, code load and start), the DSP
14domain is programmed to write a "hello world" message to the board's chosen
15console UART, initialise hardware responsible for audio playback and perform
16playback of a periodic audio signal.
17
18Building and Running
19********************
20
21This sample can be built and started on supported boards as follows:
22
23.. zephyr-app-commands::
24 :zephyr-app: samples/boards/nxp/adsp/rtxxx/amp_audio_output
25 :board: <board>
26 :goals: build flash
27 :build-args: --sysbuild
28 :flash-args: -r jlink
29 :compact:
30
31Currently, these boards are supported:
32- ``mimxrt685_evk/mimxrt685s/cm33``
33
34The use of J-Link firmware on integrated debug probes of those boards or a
35standalone J-Link probe is desired as the J-Link probes have the ability
36to directly debug the Xtensa-based DSP cores.
37
38Sample output
39=============
40
41.. code-block:: console
42
43 *** Booting Zephyr OS build v4.1.0-1858-gab989bfb4894 ***
44 Hello World! mimxrt685_evk/mimxrt685s/cm33
45 [ARM] Starting DSP...
46 *** Booting Zephyr OS build v4.1.0-1858-gab989bfb4894 ***
47 [DSP] Hello World! mimxrt685_evk/mimxrt685s/hifi4
48 [DSP] Will start playback.
49 [DSP] Playback stopped.
50