boards: shields: Add Adafruit 24LC32 EEPROM shield

Product photo from https://learn.adafruit.com/assets/123033
with license CC BY-SA 3.0.

Tested with the command mentioned on the index.rst page.

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

Author: pyhys

boards/shields/adafruit_24lc32/Kconfig.shield

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

boards/shields/adafruit_24lc32/adafruit_24lc32.overlay

@@ -0,0 +1,25 @@
+/*
+ * Copyright (c) 2025 Jonas Berg
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/ {
+	aliases {
+		eeprom-0 = &eeprom_adafruit_24lc32;
+	};
+};
+
+&zephyr_i2c {
+	status = "okay";
+
+	eeprom_adafruit_24lc32: eeprom@50 {
+		status = "okay";
+		compatible = "atmel,at24lc32", "atmel,at24";
+		reg = <0x50>;
+		size = <DT_SIZE_K(4)>;
+		pagesize = <8>;
+		address-width = <16>;
+		timeout = <5>;
+	};
+};

boards/shields/adafruit_24lc32/doc/adafruit_24lc32.webp

@@ -0,0 +1,64 @@
+.. _adafruit_24lc32:
+
+Adafruit 24LC32 EEPROM Shield
+#############################
+
+Overview
+********
+
+The `Adafruit 24LC32 EEPROM Shield`_ features a `Microchip 24LC32 EEPROM`_ (or
+equivalent) and two STEMMA QT connectors.
+It has a size of 32 kbit (4 kByte).
+
+.. figure:: adafruit_24lc32.webp
+   :align: center
+   :alt: Adafruit 24LC32 EEPROM Shield
+
+   Adafruit 24LC32 EEPROM 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          | 24LC32 I2C SDA               |
++--------------+------------------------------+
+| SCL          | 24LC32 I2C SCL               |
++--------------+------------------------------+
+| WP           | 24LC32 write protection      |
++--------------+------------------------------+
+| A0 - A2      | 24LC32 I2C address selection |
++--------------+------------------------------+
+
+See :dtcompatible:`atmel,at24` for documentation on how to adjust the
+devicetree file, for example to make the EEPROM read-only.
+
+
+Programming
+***********
+
+Set ``--shield adafruit_24lc32`` when you invoke ``west build``. For example
+when running the :zephyr:code-sample:`eeprom` sample:
+
+.. zephyr-app-commands::
+   :zephyr-app: samples/drivers/eeprom
+   :board: adafruit_qt_py_rp2040
+   :shield: adafruit_24lc32
+   :goals: build
+
+.. _Adafruit 24LC32 EEPROM Shield:
+   https://learn.adafruit.com/adafruit-24lc32-i2c-eeprom-breakout-32kbit-4-kb
+
+.. _Microchip 24LC32 EEPROM:
+   https://www.microchip.com/en-us/product/24lc32

boards/shields/adafruit_24lc32/doc/index.rst

@@ -0,0 +1,10 @@
+# SPDX-License-Identifier: Apache-2.0
+#
+# Copyright (c) 2025, Jonas Berg
+
+shield:
+  name: adafruit_24lc32
+  full_name: Adafruit 24LC32 EEPROM Shield
+  vendor: adafruit
+  supported_features:
+    - mtd

boards/shields/adafruit_24lc32/shield.yml

@@ -8,8 +8,11 @@ tests:
       - gd32f450i_eval
       - native_sim
       - native_sim/native/64
+      - adafruit_qt_py_rp2040/rp2040
     integration_platforms:
       - native_sim/native/64
+    extra_args:
+      - platform:adafruit_qt_py_rp2040/rp2040:SHIELD="adafruit_24lc32"
     harness: console
     harness_config:
       type: one_line