From 46b9b6bc207d7ca6a785bfe9facb45e9d8557675 Mon Sep 17 00:00:00 2001
From: Maureen Helm <maureen.helm@analog.com>
Date: Mon, 30 Sep 2024 18:24:29 -0500
Subject: [PATCH] boards: shields: Add EVAL-ADXL372-ARDZ accelerometer shield

Adds a new shield definition for the Analog Devices EVAL-ADXL372-ARDZ
accelerometer shield. This shield provides support for an ADI ADXL372
3-axis accelerometer over an Arduino SPI connector.

Signed-off-by: Maureen Helm <maureen.helm@analog.com>
---
 .../shields/eval_adxl372_ardz/Kconfig.shield  |  5 ++
 .../boards/apard32690_max32690_m4.overlay     | 11 ++++
 .../shields/eval_adxl372_ardz/doc/index.rst   | 52 +++++++++++++++++++
 .../eval_adxl372_ardz.overlay                 | 17 ++++++
 4 files changed, 85 insertions(+)
 create mode 100644 boards/shields/eval_adxl372_ardz/Kconfig.shield
 create mode 100644 boards/shields/eval_adxl372_ardz/boards/apard32690_max32690_m4.overlay
 create mode 100644 boards/shields/eval_adxl372_ardz/doc/index.rst
 create mode 100644 boards/shields/eval_adxl372_ardz/eval_adxl372_ardz.overlay

diff --git a/boards/shields/eval_adxl372_ardz/Kconfig.shield b/boards/shields/eval_adxl372_ardz/Kconfig.shield
new file mode 100644
index 00000000000..20b61c3b528
--- /dev/null
+++ b/boards/shields/eval_adxl372_ardz/Kconfig.shield
@@ -0,0 +1,5 @@
+# Copyright (c) 2024 Analog Devices, Inc.
+# SPDX-License-Identifier: Apache-2.0
+
+config SHIELD_EVAL_ADXL372_ARDZ
+	def_bool $(shields_list_contains,eval_adxl372_ardz)
diff --git a/boards/shields/eval_adxl372_ardz/boards/apard32690_max32690_m4.overlay b/boards/shields/eval_adxl372_ardz/boards/apard32690_max32690_m4.overlay
new file mode 100644
index 00000000000..0abd52f0bfa
--- /dev/null
+++ b/boards/shields/eval_adxl372_ardz/boards/apard32690_max32690_m4.overlay
@@ -0,0 +1,11 @@
+/*
+ * Copyright (c) 2024 Analog Devices, Inc.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/ {
+	aliases {
+		accel0 = &adxl372_eval_adxl372_ardz;
+	};
+};
diff --git a/boards/shields/eval_adxl372_ardz/doc/index.rst b/boards/shields/eval_adxl372_ardz/doc/index.rst
new file mode 100644
index 00000000000..77e75e37c9b
--- /dev/null
+++ b/boards/shields/eval_adxl372_ardz/doc/index.rst
@@ -0,0 +1,52 @@
+.. eval_adxl372_ardz:
+
+EVAL-ADXL372-ARDZ
+#################
+
+Overview
+********
+
+The EVAL-ADXL372-ARDZ is a 3-axis digital accelerometer Arduino shield powered
+by the Analog Devices ADXL372.
+
+Programming
+***********
+
+Set ``--shield eval_adxl372_ardz`` when you invoke ``west build``. For example:
+
+.. zephyr-app-commands::
+   :zephyr-app: samples/sensor/sensor_shell
+   :board: apard32690/max32690/m4
+   :shield: eval_adxl372_ardz
+   :goals: build
+
+Requirements
+************
+
+This shield can only be used with a board which provides a configuration for
+Arduino connectors and defines node aliases for SPI and GPIO interfaces (see
+:ref:`shields` for more details).
+
+References
+**********
+
+- `EVAL-ADXL372-ARDZ product page`_
+- `EVAL-ADXL372-ARDZ user guide`_
+- `EVAL-ADXL372-ARDZ schematic`_
+- `ADXL372 product page`_
+- `ADXL372 data sheet`_
+
+.. _EVAL-ADXL372-ARDZ product page:
+   https://www.analog.com/en/resources/evaluation-hardware-and-software/evaluation-boards-kits/eval-adxl372-ardz.html
+
+.. _EVAL-ADXL372-ARDZ user guide:
+   https://wiki.analog.com/resources/eval/user-guides/eval-adicup3029/hardware/adxl372
+
+.. _EVAL-ADXL372-ARDZ schematic:
+   https://www.analog.com/media/en/evaluation-documentation/evaluation-design-files/eval-adxl372-ardz-designsupport.zip
+
+.. _ADXL372 product page:
+   https://www.analog.com/en/products/adxl372.html
+
+.. _ADXL372 data sheet:
+   https://www.analog.com/media/en/technical-documentation/data-sheets/adxl372.pdf
diff --git a/boards/shields/eval_adxl372_ardz/eval_adxl372_ardz.overlay b/boards/shields/eval_adxl372_ardz/eval_adxl372_ardz.overlay
new file mode 100644
index 00000000000..349374a7c7a
--- /dev/null
+++ b/boards/shields/eval_adxl372_ardz/eval_adxl372_ardz.overlay
@@ -0,0 +1,17 @@
+/*
+ * Copyright (c) 2024 Analog Devices, Inc.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+&arduino_spi {
+	status = "okay";
+
+	adxl372_eval_adxl372_ardz: adxl372@0 {
+		compatible = "adi,adxl372";
+		reg = <0x0>;
+		spi-max-frequency = <DT_FREQ_M(1)>;
+		int1-gpios = <&arduino_header 13 GPIO_ACTIVE_HIGH>;
+		status = "okay";
+	};
+};