shields: add MikroE ILLUMINANCE Click shield

Adds support for the MikroE ILLUMINANCE Click shield

Signed-off-by: Benjamin Cabé <[email protected]>

Author: kartben

boards/shields/mikroe_illuminance_click/Kconfig.shield

@@ -0,0 +1,5 @@
+# Copyright The Zephyr Project Contributors
+# SPDX-License-Identifier: Apache-2.0
+
+config SHIELD_MIKROE_ILLUMINANCE_CLICK
+	def_bool $(shields_list_contains,mikroe_illuminance_click)

boards/shields/mikroe_illuminance_click/doc/images/mikroe_illuminance_click.webp

@@ -0,0 +1,50 @@
+.. _mikroe_illuminance_click_shield:
+
+MikroElektronika Illuminance Click
+==================================
+
+Overview
+********
+
+`Illuminance Click`_ is a compact add-on board that mimics how humans perceive light. This board
+features ams OSRAM TSL2583, a very-high sensitivity light-to-digital converter that transforms light
+intensity to a digital signal output capable of the direct I2C interface. It combines one broadband
+photodiode (visible plus infrared) and one infrared-responding photodiode on a single CMOS
+integrated circuit capable of providing a near-photopic response over an effective 16-bit dynamic
+range (16-bit resolution). This Click board |trade| is suitable for general-purpose light sensing
+applications to extend battery life and provide optimum viewing in diverse lighting conditions.
+
+.. figure:: images/mikroe_illuminance_click.webp
+   :align: center
+   :alt: Illuminance Click
+   :height: 300px
+
+   Illuminance Click
+
+Requirements
+************
+
+This shield can only be used with a board that provides a mikroBUS |trade| socket and defines a
+``mikrobus_i2c`` node label for the mikroBUS |trade| I2C interface. See :ref:`shields` for more
+details.
+
+Programming
+***********
+
+Set ``-DSHIELD=mikroe_illuminance_click`` when you invoke ``west build``. For example:
+
+.. zephyr-app-commands::
+   :zephyr-app: samples/sensor/light_polling
+   :board: mikroe_quail
+   :shield: mikroe_illuminance_click
+   :goals: build
+
+See :dtcompatible:`ams,tsl2561` for documentation on the additional binding properties available for
+the TSL2561 sensor, for example to adjust the gain and integration time.
+
+References
+**********
+
+- `Illuminance Click`_
+
+.. _Illuminance Click: https://www.mikroe.com/illuminance-click

boards/shields/mikroe_illuminance_click/doc/index.rst

@@ -0,0 +1,19 @@
+/*
+ * Copyright The Zephyr Project Contributors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/ {
+	aliases {
+		light-sensor = &tsl2561_mikroe_illuminance_click;
+	};
+};
+
+&mikrobus_i2c {
+	status = "okay";
+
+	tsl2561_mikroe_illuminance_click: tsl2561@49 {
+		compatible = "ams,tsl2561";
+		reg = <0x49>;
+	};
+};

boards/shields/mikroe_illuminance_click/mikroe_illuminance_click.overlay

@@ -0,0 +1,6 @@
+shield:
+  name: mikroe_illuminance_click
+  full_name: Illuminance Click
+  vendor: mikroe
+  supported_features:
+    - sensor

boards/shields/mikroe_illuminance_click/shield.yml

@@ -24,6 +24,8 @@ tests:
       - frdm_mcxw71/mcxw716c
       - adafruit_qt_py_rp2040/rp2040       # adafruit_tsl2591 shield
       - mikroe_clicker_ra4m1/r7fa4m1ab3cfm # mikroe_ambient_2_click shield
+      - mikroe_quail/stm32f427xx           # mikroe_illuminance_click shield
     extra_args:
       - platform:adafruit_qt_py_rp2040/rp2040:SHIELD="adafruit_tsl2591"
       - platform:mikroe_clicker_ra4m1/r7fa4m1ab3cfm:SHIELD="mikroe_ambient_2_click"
+      - platform:mikroe_quail/stm32f427xx:SHIELD="mikroe_illuminance_click"