boards: shields: Add Adafruit LIS3MDL magnetometer shield

Product photo from https://learn.adafruit.com/assets/86994

Tested with the command mentioned in the index.rst file.

Compile testing of the overlay file is done via the mag_polling
sample.

Signed-off-by: Jonas Berg <[email protected]>

Author: pyhys

boards/shields/adafruit_lis3mdl/Kconfig.shield

@@ -0,0 +1,5 @@
+# Copyright (c) 2025 Jonas Berg
+# SPDX-License-Identifier: Apache-2.0
+
+config SHIELD_ADAFRUIT_LIS3MDL
+	def_bool $(shields_list_contains,adafruit_lis3mdl)

boards/shields/adafruit_lis3mdl/adafruit_lis3mdl.overlay

@@ -0,0 +1,19 @@
+/*
+ * Copyright (c) 2025 Jonas Berg
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/ {
+	aliases {
+		magn0 = &adafruit_lis3mdl;
+	};
+};
+
+&zephyr_i2c {
+	status = "okay";
+
+	adafruit_lis3mdl: lis3mdl@1c {
+		compatible = "st,lis3mdl-magn";
+		reg = <0x1c>;
+	};
+};

boards/shields/adafruit_lis3mdl/doc/adafruit_lis3mdl.webp

@@ -0,0 +1,69 @@
+.. _adafruit_lis3mdl:
+
+Adafruit LIS3MDL Shield
+#######################
+
+Overview
+********
+
+The `Adafruit LIS3MDL Triple-Axis Magnetometer Sensor Shield`_ features
+a `ST LIS3MDL 3-axis magnetometer`_ and two STEMMA QT connectors.
+
+.. figure:: adafruit_lis3mdl.webp
+   :align: center
+   :alt: Adafruit LIS3MDL Shield
+
+   Adafruit LIS3MDL Shield (Credit: Adafruit)
+
+
+Requirements
+************
+
+This shield can be used with boards which provide an I2C connector, for
+example STEMMA QT or Qwiic connectors.
+The target board must define a ``zephyr_i2c`` node label.
+See :ref:`shields` for more details.
+
+
+Pin Assignments
+===============
+
++--------------+------------------------------------------------------+
+| Shield Pin   | Function                                             |
++==============+======================================================+
+| SDA          | LIS3MDL I2C SDA                                      |
++--------------+------------------------------------------------------+
+| SCL          | LIS3MDL I2C SCL                                      |
++--------------+------------------------------------------------------+
+| INT          | LIS3MDL Interrupt out                                |
++--------------+------------------------------------------------------+
+| DO/AD1       | LIS3MDL I2C address select pin                       |
++--------------+------------------------------------------------------+
+| CS           | LIS3MDL Force I2C mode by setting it to high level.  |
++--------------+------------------------------------------------------+
+| DRDY         | LIS3MDL Data ready out                               |
++--------------+------------------------------------------------------+
+
+In order to use the DRDY output you need to connect a separate wire from the
+shield to a GPIO pin on your microcontroller board. See
+:dtcompatible:`st,lis3mdl-magn` for documentation on how to adjust the
+devicetree file.
+
+
+Programming
+***********
+
+Set ``--shield adafruit_lis3mdl`` when you invoke ``west build``. For example
+when running the :zephyr:code-sample:`magn_polling` sample:
+
+.. zephyr-app-commands::
+   :zephyr-app: samples/sensor/magn_polling
+   :board: adafruit_feather_rp2040
+   :shield: adafruit_lis3mdl
+   :goals: build flash
+
+.. _Adafruit LIS3MDL Triple-Axis Magnetometer Sensor Shield:
+   https://learn.adafruit.com/lis3mdl-triple-axis-magnetometer
+
+.. _ST LIS3MDL 3-axis magnetometer:
+   https://www.st.com/en/mems-and-sensors/lis3mdl.html

boards/shields/adafruit_lis3mdl/doc/index.rst

@@ -0,0 +1,10 @@
+# SPDX-License-Identifier: Apache-2.0
+#
+# Copyright (c) 2025, Jonas Berg
+
+shield:
+  name: adafruit_lis3mdl
+  full_name: Adafruit LIS3MDL Triple-Axis Magnetometer Sensor Shield
+  vendor: adafruit
+  supported_features:
+    - sensor

boards/shields/adafruit_lis3mdl/shield.yml

@@ -14,7 +14,9 @@ tests:
   sample.sensor.magn_polling.shields:
     platform_allow:
       - adafruit_qt_py_rp2040/rp2040       # adafruit_lis2mdl shield
+      - adafruit_feather_rp2040/rp2040       # adafruit_lis3mdl shield
       - mikroe_clicker_ra4m1/r7fa4m1ab3cfm # mikroe_3d_hall_3_click shield
     extra_args:
       - platform:adafruit_qt_py_rp2040/rp2040:SHIELD="adafruit_lis2mdl"
+      - platform:adafruit_feather_rp2040/rp2040:SHIELD="adafruit_lis3mdl"
       - platform:mikroe_clicker_ra4m1/r7fa4m1ab3cfm:SHIELD="mikroe_3d_hall_3_click"