boards: Add support for the NXP MIMXRT595 DSP core

Add board and soc files for the NXP MIMXRT595 DSP core.

Signed-off-by: Dmitry Lukyantsev <dmitrylu@google.com>

boards/arm/mimxrt595_evk/doc/index.rst

@@ -174,6 +174,20 @@ Serial Port
 The MIMXRT595 SoC has 13 FLEXCOMM interfaces for serial communication. One is
 configured as USART for the console and the remaining are not used.
 
+Fusion F1 DSP Core
+==================
+
+You can build a Zephyr application for the RT500 DSP core using nxp_adsp_rt595
+board. Xtensa toolchain supporting RT500 DSP core is included in Zephyr SDK.
+To build the hello_world sample for the RT500 DSP core:
+
+.. code-block:: shell
+
+   $ west build -b nxp_adsp_rt595 samples/hello_world
+
+For detailed instructions on how to debug DSP firmware, please refer to
+this document: `Getting Started with Xplorer for EVK-MIMXRT595`_
+
 Programming and Debugging
 *************************
 
@@ -313,3 +327,6 @@ steps:
 
 .. _i.MX RT595 Reference Manual:
    https://www.nxp.com/webapp/Download?colCode=IMXRT500RM
+
+.. _Getting Started with Xplorer for EVK-MIMXRT595:
+   https://www.nxp.com/docs/en/supporting-information/GSXEVKMIMXRT595.pdf

boards/xtensa/nxp_adsp_rt595/Kconfig

@@ -0,0 +1,41 @@
+# Copyright (c) 2023 Google LLC.
+# SPDX-License-Identifier: Apache-2.0
+
+DT_ADSP_RESET_MEM := $(dt_nodelabel_path,adsp_reset)
+DT_ADSP_DATA_MEM := $(dt_nodelabel_path,adsp_data)
+DT_ADSP_TEXT_MEM := $(dt_nodelabel_path,adsp_text)
+
+if BOARD_NXP_ADSP_RT595
+
+config RT595_ADSP_STACK_SIZE
+	hex "Boot time stack size"
+	default 0x1000
+	help
+	  Stack space is reserved at the end of the RT595_ADSP_DATA_MEM
+	  region, starting at RT595_ADSP_DATA_MEM_ADDR - RT595_ADSP_STACK_SIZE
+
+config RT595_ADSP_RESET_MEM_ADDR
+	hex
+	default $(dt_node_reg_addr_hex,$(DT_ADSP_RESET_MEM))
+
+config RT595_ADSP_RESET_MEM_SIZE
+	hex
+	default $(dt_node_reg_size_hex,$(DT_ADSP_RESET_MEM))
+
+config RT595_ADSP_DATA_MEM_ADDR
+	hex
+	default $(dt_node_reg_addr_hex,$(DT_ADSP_DATA_MEM))
+
+config RT595_ADSP_DATA_MEM_SIZE
+	hex
+	default $(dt_node_reg_size_hex,$(DT_ADSP_DATA_MEM))
+
+config RT595_ADSP_TEXT_MEM_ADDR
+	hex
+	default $(dt_node_reg_addr_hex,$(DT_ADSP_TEXT_MEM))
+
+config RT595_ADSP_TEXT_MEM_SIZE
+	hex
+	default $(dt_node_reg_size_hex,$(DT_ADSP_TEXT_MEM))
+
+endif # BOARD_NXP_ADSP_RT595

boards/xtensa/nxp_adsp_rt595/Kconfig.board

@@ -0,0 +1,6 @@
+# Copyright (c) 2023 Google LLC.
+# SPDX-License-Identifier: Apache-2.0
+
+config BOARD_NXP_ADSP_RT595
+	bool "NXP ADSP RT595"
+	depends on SOC_SERIES_NXP_RT5XX

boards/xtensa/nxp_adsp_rt595/Kconfig.defconfig

@@ -0,0 +1,9 @@
+# Copyright (c) 2023 Google LLC.
+# SPDX-License-Identifier: Apache-2.0
+
+if BOARD_NXP_ADSP_RT595
+
+config BOARD
+	default "nxp_adsp_rt595"
+
+endif # BOARD_NXP_ADSP_RT595

boards/xtensa/nxp_adsp_rt595/nxp_adsp_rt595.dts

@@ -0,0 +1,51 @@
+/*
+ * Copyright (c) 2023 Google LLC.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/dts-v1/;
+#include <mem.h>
+#include <xtensa/xtensa.dtsi>
+
+/ {
+	model = "nxp_adsp_rt595";
+	compatible = "nxp";
+
+	cpus {
+		#address-cells = <1>;
+		#size-cells = <0>;
+
+		cpu0: cpu@0 {
+			device_type = "cpu";
+			compatible = "cdns,tensilica-xtensa-lx6";
+			reg = <0>;
+		};
+	};
+
+	sram0: memory@0 {
+		#address-cells = <1>;
+		#size-cells = <1>;
+		device_type = "memory";
+		compatible = "mmio-sram";
+		/* Reserve first 512kB of shared memory for ADSP. */
+		reg = <0x0 DT_SIZE_K(512)>;
+		/* Reset section must always be at 0 and at least 1kB. */
+		adsp_reset: memory@0 {
+			reg = <0x0 DT_SIZE_K(1)>;
+		};
+		/* Code and data sections can be moved around and resized if needed. */
+		adsp_text: memory@400 {
+			reg = <0x400 DT_SIZE_K(255)>;
+		};
+		/* On RT595 ADSP shared RAM is mapped at offset 0 on the code bus and at
+		 * offset 0x800000 on the data bus.
+		 */
+		adsp_data: memory@840000 {
+			reg = <0x840000 DT_SIZE_K(256)>;
+		};
+	};
+
+	chosen {
+		zephyr,sram = &adsp_data;
+	};
+};

boards/xtensa/nxp_adsp_rt595/nxp_adsp_rt595.yaml

@@ -0,0 +1,9 @@
+identifier: nxp_adsp_rt595
+name: i.MXRT595 DSP
+type: mcu
+arch: xtensa
+toolchain:
+  - zephyr
+testing:
+  only_tags:
+    - kernel

boards/xtensa/nxp_adsp_rt595/nxp_adsp_rt595_defconfig

@@ -0,0 +1,7 @@
+CONFIG_SOC_SERIES_NXP_RT5XX=y
+CONFIG_SOC_NXP_RT595=y
+CONFIG_BOARD_NXP_ADSP_RT595=y
+
+CONFIG_GEN_ISR_TABLES=y
+CONFIG_GEN_IRQ_VECTOR_TABLE=n
+CONFIG_XTENSA_SMALL_VECTOR_TABLE_ENTRY=y

soc/xtensa/nxp_adsp/CMakeLists.txt

@@ -1,8 +1,12 @@
-# NXP i.MX8 SoC family CMake file
+# NXP i.MX8/RT SoC family CMake file
 #
 # Copyright (c) 2021 NXP
 # SPDX-License-Identifier: Apache-2.0
 
+if(CONFIG_SOC_NXP_RT595)
+  zephyr_compile_definitions(CPU_MIMXRT595SFFOC_dsp)
+endif()
+
 add_subdirectory(common)
 
 #  west sign

soc/xtensa/nxp_adsp/rt5xx/Kconfig.defconfig.series

@@ -0,0 +1,46 @@
+# Copyright (c) 2023 Google LLC.
+# SPDX-License-Identifier: Apache-2.0
+
+if SOC_SERIES_NXP_RT5XX
+
+config SOC_SERIES
+	string
+	default "rt5xx"
+
+config SOC_TOOLCHAIN_NAME
+	string
+	default "nxp_rt500_adsp"
+
+config SOC
+	string
+	default "nxp_rt5xx"
+
+config SOC_PART_NUMBER
+	string
+	default "MIMXRT595SFFOC_dsp" if SOC_NXP_RT595
+
+config SYS_CLOCK_HW_CYCLES_PER_SEC
+	default 198000000
+
+config XTENSA_CCOUNT_HZ
+	default SYS_CLOCK_HW_CYCLES_PER_SEC
+
+config SYS_CLOCK_TICKS_PER_SEC
+	default 1000
+
+config DYNAMIC_INTERRUPTS
+	default n
+
+config CACHE
+	default n
+
+config DCACHE
+	default n
+
+config CACHE_MANAGEMENT
+	default n
+
+config LOG
+	default n
+
+endif # SOC_SERIES_NXP_RT5XX

soc/xtensa/nxp_adsp/rt5xx/Kconfig.series

@@ -0,0 +1,12 @@
+# Copyright (c) 2023 Google LLC.
+# SPDX-License-Identifier: Apache-2.0
+
+config SOC_SERIES_NXP_RT5XX
+	bool "NXP RT5xx Series"
+	select SOC_FAMILY_NXP_ADSP
+	select XTENSA
+	select XTENSA_HAL if ("$(ZEPHYR_TOOLCHAIN_VARIANT)" != "xcc" && "$(ZEPHYR_TOOLCHAIN_VARIANT)" != "xt-clang")
+	select XTENSA_RESET_VECTOR
+	select XTENSA_USE_CORE_CRT1
+	help
+	  NXP RT5xx ADSP Series

soc/xtensa/nxp_adsp/rt5xx/Kconfig.soc

@@ -0,0 +1,10 @@
+# Copyright (c) 2023 Google LLC.
+# SPDX-License-Identifier: Apache-2.0
+
+choice
+	prompt "NXP RT5xx ADSP SoC Selection"
+
+	config SOC_NXP_RT595
+		bool "NXP RT595"
+		depends on SOC_SERIES_NXP_RT5XX
+endchoice