1.. _x-nucleo-wb05kn1:
2
3X-NUCLEO-WB05KN1: BLE expansion board
4#####################################
5
6Overview
7********
8The X-NUCLEO-WB05KN1 is a Bluetooth Low Energy evaluation board which allows the
9expansion of the STM32 Nucleo boards.
10The RF module is FCC (FCC ID: YCP-MB203202) and IC certified (IC: 8976A-MB203202).
11
12The X-NUCLEO-WB05KN1 is compatible out of the box with the Arduino UNO R3 connector.
13The board interfaces with the host microcontroller via UART (default) or SPI peripheral.
14
15.. image:: img/x-nucleo-wb05kn1.webp
16     :align: center
17     :alt: X-NUCLEO-WB05KN1
18
19More information about the board can be found at the
20`X-NUCLEO-WB05KN1 website`_.
21
22Configurations
23**************
24
25X-NUCLEO-WB05KN1 can be utilized as a Bluetooth Low-Energy controller shield
26with a UART or SPI host controller interface (HCI-UART/HCI-SPI).
27
28The UART default settings are:
29
30* Baudrate: 921600 bps
31* 8 bits, no parity, 1 stop bit
32
33+----------+-----------------------+
34| UART Pin | Arduino Connector Pin |
35+==========+=======================+
36| RX       | D0                    |
37+----------+-----------------------+
38| TX       | D1                    |
39+----------+-----------------------+
40
41.. note::
42   Please, bear in mind in order to use SPI interface you need to change the shield firmware
43   to ``DTM_SPI_WITH_UPDATER_CONTROLLER`` according to the SDK provided by ST at `X-CUBE-WB05N`_.
44
45IRQ and reset pins are also necessary in addition to SPI pins.
46
47+----------------+-----------------------+
48| SPI Config Pin | Arduino Connector Pin |
49+================+=======================+
50| SCK            | D13                   |
51+----------------+-----------------------+
52| MISO           | D12                   |
53+----------------+-----------------------+
54| MOSI           | D11                   |
55+----------------+-----------------------+
56| CS             | D10                   |
57+----------------+-----------------------+
58| IRQ            | A0                    |
59+----------------+-----------------------+
60| RESET          | D7                    |
61+----------------+-----------------------+
62
63More information about X-NUCLEO-WB05KN1 can be found here:
64       - `X-NUCLEO-WB05KN1 datasheet`_
65
66Programming
67***********
68
69Activate the presence of the shield for the project build by adding the
70``--shield x_nucleo_wb05kn1_uart`` or ``--shield x_nucleo_wb05kn1_spi`` when you invoke
71``west build`` based on UART or SPI interface:
72
73 .. zephyr-app-commands::
74    :app: your_app
75    :board: your_board_name
76    :shield: x_nucleo_wb05kn1_uart
77    :goals: build
78
79or
80
81 .. zephyr-app-commands::
82    :app: your_app
83    :board: your_board_name
84    :shield: x_nucleo_wb05kn1_spi
85    :goals: build
86
87References
88**********
89
90.. target-notes::
91
92.. _X-NUCLEO-WB05KN1 website:
93   https://www.st.com/en/evaluation-tools/x-nucleo-wb05kn1.html
94
95.. _X-CUBE-WB05N:
96   https://www.st.com/en/embedded-software/x-cube-wb05n.html
97
98.. _X-NUCLEO-WB05KN1 datasheet:
99   https://www.st.com/resource/en/datasheet/stm32wb05kn.pdf
100