boards: shields: Add Adafruit VCNL4040 proximity sensor shield

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

Tested with command mentioned in the index.rst page.

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

Author: pyhys

boards/shields/adafruit_vcnl4040/Kconfig.shield

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

boards/shields/adafruit_vcnl4040/adafruit_vcnl4040.overlay

@@ -0,0 +1,14 @@
+/*
+ * Copyright (c) 2025 Jonas Berg
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+&zephyr_i2c {
+	status = "okay";
+
+	adafruit_vcnl4040: vcnl4040@60 {
+		compatible = "vishay,vcnl4040";
+		reg = <0x60>;
+	};
+};

boards/shields/adafruit_vcnl4040/doc/adafruit_vcnl4040.webp

@@ -0,0 +1,62 @@
+.. _adafruit_vcnl4040:
+
+Adafruit VCNL4040 Shield
+########################
+
+Overview
+********
+
+The `Adafruit VCNL4040 Proximity and Lux Sensor Shield`_ features
+a `Vishay VCNL4040 Proximity and Lux Sensor`_ and two STEMMA QT connectors.
+
+.. figure:: adafruit_vcnl4040.webp
+   :align: center
+   :alt: Adafruit VCNL4040 Shield
+
+   Adafruit VCNL4040 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          | VCNL4040 I2C SDA       |
++--------------+------------------------+
+| SCL          | VCNL4040 I2C SCL       |
++--------------+------------------------+
+| INT          | VCNL4040 interrupt out |
++--------------+------------------------+
+
+In order to use interrupts you need to connect a separate wire from the
+shield to a GPIO pin on your microcontroller board. See
+:dtcompatible:`vishay,vcnl4040` for documentation on how to adjust the
+devicetree file.
+
+Programming
+***********
+
+Set ``--shield adafruit_vcnl4040`` when you invoke ``west build``. For example
+when running the :zephyr:code-sample:`vcnl4040` proximity and light sample:
+
+.. zephyr-app-commands::
+   :zephyr-app: samples/sensor/vcnl4040/
+   :board: adafruit_qt_py_rp2040
+   :shield: adafruit_vcnl4040
+   :goals: build
+
+.. _Adafruit VCNL4040 Proximity and Lux Sensor Shield:
+   https://learn.adafruit.com/adafruit-vcnl4040-proximity-sensor
+
+.. _Vishay VCNL4040 Proximity and Lux Sensor:
+   https://www.vishay.com/en/product/84274/

boards/shields/adafruit_vcnl4040/doc/index.rst

@@ -0,0 +1,10 @@
+# SPDX-License-Identifier: Apache-2.0
+#
+# Copyright (c) 2025, Jonas Berg
+
+shield:
+  name: adafruit_vcnl4040
+  full_name: Adafruit VCNL4040 Proximity and Lux Sensor Shield
+  vendor: adafruit
+  supported_features:
+    - sensor

boards/shields/adafruit_vcnl4040/shield.yml

@@ -3,8 +3,12 @@ sample:
 tests:
   sample.sensor.vcnl4040:
     harness: sensor
-    platform_allow: adafruit_feather_stm32f405
+    platform_allow:
+      - adafruit_feather_stm32f405
+      - adafruit_qt_py_rp2040/rp2040
     integration_platforms:
       - adafruit_feather_stm32f405
+    extra_args:
+      - platform:adafruit_qt_py_rp2040/rp2040:SHIELD="adafruit_vcnl4040"
     tags: sensors
     filter: dt_compat_enabled("vishay,vcnl4040")