diff --git a/MAINTAINERS.yml b/MAINTAINERS.yml index 1b9e5d36079..071122d12fc 100644 --- a/MAINTAINERS.yml +++ b/MAINTAINERS.yml @@ -3338,6 +3338,7 @@ ADI Platforms: - microbuilder files: - boards/adi/ + - boards/shields/pmod_acl/ - drivers/*/*max* - drivers/*/*max*/ - drivers/dac/dac_ltc* diff --git a/boards/shields/pmod_acl/Kconfig.shield b/boards/shields/pmod_acl/Kconfig.shield new file mode 100644 index 00000000000..033dffd5d66 --- /dev/null +++ b/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) diff --git a/boards/shields/pmod_acl/boards/apard32690_max32690_m4.overlay b/boards/shields/pmod_acl/boards/apard32690_max32690_m4.overlay new file mode 100644 index 00000000000..283feab0877 --- /dev/null +++ b/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; + }; +}; diff --git a/boards/shields/pmod_acl/doc/index.rst b/boards/shields/pmod_acl/doc/index.rst new file mode 100644 index 00000000000..7a635f435ad --- /dev/null +++ b/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 diff --git a/boards/shields/pmod_acl/pmod_acl.overlay b/boards/shields/pmod_acl/pmod_acl.overlay new file mode 100644 index 00000000000..935655b1971 --- /dev/null +++ b/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 = ; + status = "okay"; + }; +};