From 4067b0d311df86703b76ce9dcf767ef7363c0769 Mon Sep 17 00:00:00 2001
From: Ali Hozhabri <ali.hozhabri@st.com>
Date: Wed, 10 Apr 2024 17:41:15 +0200
Subject: [PATCH] boards: shields: Add X-NUCLEO-WB05KN1 BLE expansion board

Add support for X-NUCLEO-WB05KN1 which is a BLE expansion board based on
the BLUENRG-LPS.

Signed-off-by: Ali Hozhabri <ali.hozhabri@st.com>
---
 .../x_nucleo_wb05kn1/Kconfig.defconfig        |  33 ++++++
 .../shields/x_nucleo_wb05kn1/Kconfig.shield   |   8 ++
 .../boards/nucleo_h563zi.overlay              |  24 +++++
 .../boards/nucleo_u575zi_q.overlay            |  28 +++++
 .../doc/img/x-nucleo-wb05kn1.webp             | Bin 0 -> 19054 bytes
 boards/shields/x_nucleo_wb05kn1/doc/index.rst |  99 ++++++++++++++++++
 .../x_nucleo_wb05kn1_spi.overlay              |  28 +++++
 .../x_nucleo_wb05kn1_uart.overlay             |  20 ++++
 8 files changed, 240 insertions(+)
 create mode 100644 boards/shields/x_nucleo_wb05kn1/Kconfig.defconfig
 create mode 100644 boards/shields/x_nucleo_wb05kn1/Kconfig.shield
 create mode 100644 boards/shields/x_nucleo_wb05kn1/boards/nucleo_h563zi.overlay
 create mode 100644 boards/shields/x_nucleo_wb05kn1/boards/nucleo_u575zi_q.overlay
 create mode 100644 boards/shields/x_nucleo_wb05kn1/doc/img/x-nucleo-wb05kn1.webp
 create mode 100644 boards/shields/x_nucleo_wb05kn1/doc/index.rst
 create mode 100644 boards/shields/x_nucleo_wb05kn1/x_nucleo_wb05kn1_spi.overlay
 create mode 100644 boards/shields/x_nucleo_wb05kn1/x_nucleo_wb05kn1_uart.overlay

diff --git a/boards/shields/x_nucleo_wb05kn1/Kconfig.defconfig b/boards/shields/x_nucleo_wb05kn1/Kconfig.defconfig
new file mode 100644
index 00000000000..9ca34477181
--- /dev/null
+++ b/boards/shields/x_nucleo_wb05kn1/Kconfig.defconfig
@@ -0,0 +1,33 @@
+# Copyright (c) 2024 STMicroelectronics
+# SPDX-License-Identifier: Apache-2.0
+
+if SHIELD_X_NUCLEO_WB05KN1_UART || SHIELD_X_NUCLEO_WB05KN1_SPI
+
+if BT
+
+config SPI
+	default y
+	depends on SHIELD_X_NUCLEO_WB05KN1_SPI
+
+config SPI_STM32_INTERRUPT
+	default y
+	depends on SPI
+
+config BT_SPI
+	default y
+	depends on DT_HAS_ST_HCI_SPI_V2_ENABLED
+
+config BT_H4
+	default y
+	depends on DT_HAS_ZEPHYR_BT_HCI_UART_ENABLED
+
+config BT_BLUENRG_ACI
+	default y
+
+# Disable Flow control
+config BT_HCI_ACL_FLOW_CONTROL
+	default n
+
+endif # BT
+
+endif # SHIELD_X_NUCLEO_WB05KN1_UART || SHIELD_X_NUCLEO_WB05KN1_SPI
diff --git a/boards/shields/x_nucleo_wb05kn1/Kconfig.shield b/boards/shields/x_nucleo_wb05kn1/Kconfig.shield
new file mode 100644
index 00000000000..2beed10e746
--- /dev/null
+++ b/boards/shields/x_nucleo_wb05kn1/Kconfig.shield
@@ -0,0 +1,8 @@
+# Copyright (c) 2024 STMicroelectronics
+# SPDX-License-Identifier: Apache-2.0
+
+config SHIELD_X_NUCLEO_WB05KN1_UART
+	def_bool $(shields_list_contains,x_nucleo_wb05kn1_uart)
+
+config SHIELD_X_NUCLEO_WB05KN1_SPI
+	def_bool $(shields_list_contains,x_nucleo_wb05kn1_spi)
diff --git a/boards/shields/x_nucleo_wb05kn1/boards/nucleo_h563zi.overlay b/boards/shields/x_nucleo_wb05kn1/boards/nucleo_h563zi.overlay
new file mode 100644
index 00000000000..3c16686fd63
--- /dev/null
+++ b/boards/shields/x_nucleo_wb05kn1/boards/nucleo_h563zi.overlay
@@ -0,0 +1,24 @@
+/*
+ * Copyright (c) 2024 STMicroelectronics
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+&spi1_sck_pa5 {
+	/delete-property/ bias-pull-down;
+	bias-pull-up;
+};
+
+&spi1_miso_pg9 {
+	slew-rate = "high-speed";
+};
+
+&spi1_mosi_pb5 {
+	slew-rate = "high-speed";
+};
+
+/ {
+	chosen {
+		zephyr,bt-c2h-uart = &usart3;
+	};
+};
diff --git a/boards/shields/x_nucleo_wb05kn1/boards/nucleo_u575zi_q.overlay b/boards/shields/x_nucleo_wb05kn1/boards/nucleo_u575zi_q.overlay
new file mode 100644
index 00000000000..f6ff77a52c7
--- /dev/null
+++ b/boards/shields/x_nucleo_wb05kn1/boards/nucleo_u575zi_q.overlay
@@ -0,0 +1,28 @@
+/*
+ * Copyright (c) 2024 STMicroelectronics
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+&spi1_sck_pa5 {
+	/delete-property/ bias-pull-down;
+	bias-pull-up;
+};
+
+&spi1_miso_pa6 {
+	slew-rate = "high-speed";
+};
+
+&spi1_mosi_pa7 {
+	slew-rate = "high-speed";
+};
+
+&arduino_spi {
+	pinctrl-0 = <&spi1_sck_pa5 &spi1_miso_pa6 &spi1_mosi_pa7>;
+};
+
+/ {
+	chosen {
+		zephyr,bt-c2h-uart = &usart1;
+	};
+};
diff --git a/boards/shields/x_nucleo_wb05kn1/doc/img/x-nucleo-wb05kn1.webp b/boards/shields/x_nucleo_wb05kn1/doc/img/x-nucleo-wb05kn1.webp
new file mode 100644
index 0000000000000000000000000000000000000000..a9e58836e5cc6f1e15cdf2e52c866f3031f075ce
GIT binary patch
literal 19054
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
p#By$2zda#7<kN%w83sw`loyD200000000000000000000006bDvgiN+

literal 0
HcmV?d00001

diff --git a/boards/shields/x_nucleo_wb05kn1/doc/index.rst b/boards/shields/x_nucleo_wb05kn1/doc/index.rst
new file mode 100644
index 00000000000..04f8bb5c052
--- /dev/null
+++ b/boards/shields/x_nucleo_wb05kn1/doc/index.rst
@@ -0,0 +1,99 @@
+.. _x-nucleo-wb05kn1:
+
+X-NUCLEO-WB05KN1: BLE expansion board
+#####################################
+
+Overview
+********
+The X-NUCLEO-WB05KN1 is a Bluetooth Low Energy evaluation board which allows the
+expansion of the STM32 Nucleo boards.
+The RF module is FCC (FCC ID: YCP-MB203202) and IC certified (IC: 8976A-MB203202).
+
+The X-NUCLEO-WB05KN1 is compatible out of the box with the Arduino UNO R3 connector.
+The board interfaces with the host microcontroller via UART (default) or SPI peripheral.
+
+.. image:: img/x-nucleo-wb05kn1.webp
+     :align: center
+     :alt: X-NUCLEO-WB05KN1
+
+More information about the board can be found at the
+`X-NUCLEO-WB05KN1 website`_.
+
+Configurations
+**************
+
+X-NUCLEO-WB05KN1 can be utilized as a Bluetooth Low-Energy controller shield
+with a UART or SPI host controller interface (HCI-UART/HCI-SPI).
+
+The UART default settings are:
+
+* Baudrate: 921600 bps
+* 8 bits, no parity, 1 stop bit
+
++----------+-----------------------+
+| UART Pin | Arduino Connector Pin |
++==========+=======================+
+| RX       | D0                    |
++----------+-----------------------+
+| TX       | D1                    |
++----------+-----------------------+
+
+.. note::
+   Please, bear in mind in order to use SPI interface you need to change the shield firmware
+   to ``DTM_SPI_WITH_UPDATER_CONTROLLER`` according to the SDK provided by ST at `X-CUBE-WB05N`_.
+
+IRQ and reset pins are also necessary in addition to SPI pins.
+
++----------------+-----------------------+
+| SPI Config Pin | Arduino Connector Pin |
++================+=======================+
+| SCK            | D13                   |
++----------------+-----------------------+
+| MISO           | D12                   |
++----------------+-----------------------+
+| MOSI           | D11                   |
++----------------+-----------------------+
+| CS             | D10                   |
++----------------+-----------------------+
+| IRQ            | A0                    |
++----------------+-----------------------+
+| RESET          | D7                    |
++----------------+-----------------------+
+
+More information about X-NUCLEO-WB05KN1 can be found here:
+       - `X-NUCLEO-WB05KN1 datasheet`_
+
+Programming
+***********
+
+Activate the presence of the shield for the project build by adding the
+``--shield x_nucleo_wb05kn1_uart`` or ``--shield x_nucleo_wb05kn1_spi`` when you invoke
+``west build`` based on UART or SPI interface:
+
+ .. zephyr-app-commands::
+    :zephyr-app: your_app
+    :board: your_board_name
+    :shield: x_nucleo_wb05kn1_uart
+    :goals: build
+
+or
+
+ .. zephyr-app-commands::
+    :zephyr-app: your_app
+    :board: your_board_name
+    :shield: x_nucleo_wb05kn1_spi
+    :goals: build
+
+References
+**********
+
+.. target-notes::
+
+.. _X-NUCLEO-WB05KN1 website:
+   https://www.st.com/en/evaluation-tools/x-nucleo-wb05kn1.html
+
+.. _X-CUBE-WB05N:
+   https://www.st.com/en/embedded-software/x-cube-wb05n.html
+
+.. _X-NUCLEO-WB05KN1 datasheet:
+   https://www.st.com/resource/en/datasheet/stm32wb05kn.pdf
diff --git a/boards/shields/x_nucleo_wb05kn1/x_nucleo_wb05kn1_spi.overlay b/boards/shields/x_nucleo_wb05kn1/x_nucleo_wb05kn1_spi.overlay
new file mode 100644
index 00000000000..43cf2be0d2a
--- /dev/null
+++ b/boards/shields/x_nucleo_wb05kn1/x_nucleo_wb05kn1_spi.overlay
@@ -0,0 +1,28 @@
+/*
+ * Copyright (c) 2024 STMicroelectronics
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/ {
+	 chosen {
+		 zephyr,bt-hci = &hci_spi;
+	 };
+};
+
+&arduino_spi {
+	cs-gpios = <&arduino_header 16 GPIO_ACTIVE_LOW>;	      /* D10 */
+
+	hci_spi: wb05n@0 {
+		compatible = "st,hci-spi-v2";
+		reg = <0>;
+		reset-gpios = <&arduino_header 13 GPIO_ACTIVE_LOW>; /* D7 */
+		irq-gpios = <&arduino_header 0 (GPIO_ACTIVE_HIGH | GPIO_PULL_DOWN)>;  /* A0 */
+		spi-cpol; /* CPOL=1 */
+		spi-cpha; /* CPHA=1 */
+		spi-hold-cs;
+		spi-max-frequency = <DT_FREQ_M(8)>; /* the maximum supported SPI speed */
+		reset-assert-duration-ms = <6>;
+		status = "okay";
+	};
+};
diff --git a/boards/shields/x_nucleo_wb05kn1/x_nucleo_wb05kn1_uart.overlay b/boards/shields/x_nucleo_wb05kn1/x_nucleo_wb05kn1_uart.overlay
new file mode 100644
index 00000000000..a0ae0ca0e8b
--- /dev/null
+++ b/boards/shields/x_nucleo_wb05kn1/x_nucleo_wb05kn1_uart.overlay
@@ -0,0 +1,20 @@
+/*
+ * Copyright (c) 2024 STMicroelectronics
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/ {
+	chosen {
+		zephyr,bt-hci = &bt_hci_uart;
+	};
+};
+
+&arduino_serial {
+	current-speed = <921600>;
+
+	bt_hci_uart: bt_hci_uart {
+		compatible = "zephyr,bt-hci-uart";
+		status = "okay";
+	};
+};