boards: shields: Add Pmod ACL sensor module

Adds a new shield definition for the Digilent Pmod ACL module. This
module provides support for an ADI ADXL345 3-axis accelerometer over a
Pmod SPI connector.

Signed-off-by: Maureen Helm <[email protected]>

Author: MaureenHelm

MAINTAINERS.yml

@@ -3338,6 +3338,7 @@ ADI Platforms:
     - microbuilder
   files:
     - boards/adi/
+    - boards/shields/pmod_acl/
     - drivers/*/*max*
     - drivers/*/*max*/
     - drivers/dac/dac_ltc*

boards/shields/pmod_acl/Kconfig.shield

@@ -0,0 +1,5 @@
+# Copyright (c) 2024 Analog Devices, Inc.
+# SPDX-License-Identifier: Apache-2.0
+
+config SHIELD_PMOD_ACL
+	def_bool $(shields_list_contains,pmod_acl)

boards/shields/pmod_acl/boards/apard32690_max32690_m4.overlay

@@ -0,0 +1,11 @@
+/*
+ * Copyright (c) 2024 Analog Devices, Inc.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/ {
+	aliases {
+		accel0 = &adxl345_pmod_acl;
+	};
+};

boards/shields/pmod_acl/doc/index.rst

@@ -0,0 +1,52 @@
+.. pmod_acl:
+
+Digilent Pmod ACL
+#################
+
+Overview
+********
+
+The Digilent Pmod ACL is a 3-axis digital accelerometer module powered by the
+Analog Devices ADXL345.
+
+Programming
+***********
+
+Set ``--shield pmod_acl`` when you invoke ``west build``. For example:
+
+.. zephyr-app-commands::
+   :zephyr-app: samples/sensor/sensor_shell
+   :board: apard32690/max32690/m4
+   :shield: pmod_acl
+   :goals: build
+
+Requirements
+************
+
+This shield can only be used with a board which provides a configuration
+for Pmod connectors and defines node aliases for SPI and GPIO interfaces
+(see :ref:`shields` for more details).
+
+References
+**********
+
+- `Pmod ACL product page`_
+- `Pmod ACL reference manual`_
+- `Pmod ACL schematic`_
+- `ADXL345 product page`_
+- `ADXL345 data sheet`_
+
+.. _Pmod ACL product page:
+   https://digilent.com/shop/pmod-acl-3-axis-accelerometer/
+
+.. _Pmod ACL reference manual:
+   https://digilent.com/reference/pmod/pmodacl/reference-manual
+
+.. _Pmod ACL schematic:
+   https://digilent.com/reference/_media/reference/pmod/pmodacl/pmodacl_sch.pdf
+
+.. _ADXL345 product page:
+   https://www.analog.com/en/products/adxl345.html
+
+.. _ADXL345 data sheet:
+   https://www.analog.com/media/en/technical-documentation/data-sheets/adxl345.pdf

boards/shields/pmod_acl/pmod_acl.overlay

@@ -0,0 +1,16 @@
+/*
+ * Copyright (c) 2024 Analog Devices, Inc.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+&pmod_spi {
+	status = "okay";
+
+	adxl345_pmod_acl: adxl345@0 {
+		compatible = "adi,adxl345";
+		reg = <0x0>;
+		spi-max-frequency = <DT_FREQ_M(1)>;
+		status = "okay";
+	};
+};