boards: shields: Add x_nucleo_idb05a1

Add shield x_nucleo_idb05a1.
Tested samples with the disco_l475_iot1 (SPI3 disabled to ensure
to test the shield on SPI1, and not the on-board BlueNRG-MS chip):
Beacon, Central and Peripheral have been tested and are working.

Signed-off-by: Yaël Boutreux <[email protected]>
Signed-off-by: Erwan Gouriou <[email protected]>

Author: yboutreux

boards/shields/x_nucleo_idb05a1/doc/img/x-nucleo-idb05a1.jpg

@@ -0,0 +1,93 @@
+.. _x-nucleo-idb05a1:
+
+X-NUCLEO-IDB05A1: BLE expansion board
+#####################################
+
+Overview
+********
+The X-NUCLEO-IDB05A1 is a Bluetooth Low Energy evaluation board based on the
+SPBTLE-RF BlueNRG-MS RF module to allow expansion of the STM32 Nucleo boards.
+The SPBTLE-RF module is FCC (FCC ID: S9NSPBTLERF) and IC certified
+(IC: 8976C-SPBTLERF).
+
+The X-NUCLEO-IDB05A1 is compatible with the ST Morpho and Arduino UNO R3
+connector layout (the user can mount the ST Morpho connectors, if required). The
+X-NUCLEO-IDB05A1 interfaces with the host microcontroller via the SPI pin, and
+the user can change the default SPI clock, the SPI chip select and SPI IRQ by
+changing one resistor on the evaluation board.
+
+IMPORTANT NOTICE : This shield is not compatible out of the box with Arduino
+UNO R3 connectors. Adaptation is required on most boards for compatibility.
+Please refer to "Hardware configuration" section.
+
+.. image:: img/x-nucleo-idb05a1.jpg
+     :width: 400px
+     :height: 350px
+     :align: center
+     :alt: X-NUCLEO-IDB05A1
+
+More information about the board can be found at the
+`X-NUCLEO-IDB05A1 website`_.
+
+Hardware configuration
+**********************
+
+Out of the box, X-NUCLEO-IDB05A1 shield expect SPI SCK to be available on pin
+D3 instead of usual Arduino UNO R3 SPI SCK D13.
+Adaptation should be done on shield or board configuration to restore
+compatibility. Shield configuration could be modified by moving resistors as
+follows:
+
+ - SPI SCK: to use D13 instead of D3, remove R4 and add R6
+
+Additionally, depending on your host board, some modifications of the BLE
+expansion board could be made:
+
+ - CS: To use D10 instead of A1, remove R2 and add R7
+ - IRQ: To use D9 instead of A0, remove R1 and add R8
+
+You could check Figure 3 in `X-NUCLEO-IDB05A1 databrief`_ for more details.
+
+Hardware
+********
+
+X-NUCLEO-IDB05A1 provides a SPBTLE-RF chip with the following key features:
+
+ - Bluetooth Low Energy FCC and IC certified module based on Bluetooth ® SMART
+   4.1 network processor BlueNRG-MS
+ - Integrated Balun (BALF-NRG-01D3)
+ - Chip antenna
+
+More information about X-NUCLEO-IDB05A1 can be found here:
+       - `X-NUCLEO-IDB05A1 databrief`_
+
+Programming
+***********
+
+You can use the X-NUCLEO-IDB05A1 as a Bluetooth Low-Energy controller
+shield with an SPI host controller interface (HCI-SPI).  Activate the presence
+of the shield for the project build by adding the ``-DSHIELD`` arg to the
+build command:
+
+ .. zephyr-app-commands::
+    :zephyr-app: your_app
+    :board: your_board_name
+    :shield: x_nucleo_idb05a1
+    :goals: build
+
+Alternatively, set use of this shield in the project's ``CMakeLists.txt`` file:
+
+.. code-block:: none
+
+	set(SHIELD x_nucleo_idb05a1)
+
+References
+**********
+
+.. target-notes::
+
+.. _X-NUCLEO-IDB05A1 website:
+   http://www.st.com/en/ecosystems/x-nucleo-idb05a1.html
+
+.. _X-NUCLEO-IDB05A1 databrief:
+   https://www.st.com/resource/en/data_brief/x-nucleo-idb05a1.pdf

boards/shields/x_nucleo_idb05a1/doc/index.rst

@@ -0,0 +1,6 @@
+CONFIG_SPI=y
+CONFIG_BT_SPI=y
+CONFIG_BT_SPI_BLUENRG=y
+CONFIG_BT_HCI_VS_EXT=n
+CONFIG_BT_BLUENRG_ACI=y
+CONFIG_BT_HCI_ACL_FLOW_CONTROL=n

boards/shields/x_nucleo_idb05a1/x_nucleo_idb05a1.conf

@@ -0,0 +1,18 @@
+/*
+ * Copyright (c) 2019 STMicroelectronics
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+&arduino_spi {
+	cs-gpios = <&arduino_header 16 0>;		/* D10 */
+
+	spbtle-rf@0 {
+		compatible = "zephyr,bt-hci-spi";
+		reg = <0>;
+		reset-gpios = <&arduino_header 13 0>;	/* D7 */
+		irq-gpios = <&arduino_header 0 0>;	/* A0 */
+		spi-max-frequency = <2000000>;
+		label = "SPBTLE-RF";
+	};
+};