1.. _mikroe_ble_tiny_click_shield:
2
3MikroElektronika BLE TINY Click
4###############################
5
6Overview
7********
8
9The MikroElektronika BLE TINY Click carries the Renesas `DA14531MOD`_ Bluetooth
10LE module in a `mikroBUS`_ |trade| form factor.
11
12.. figure:: ble-tiny-click.webp
13   :align: center
14   :alt: MikroElektronika BLE TINY Click
15
16   MikroElektronika BLE TINY Click (Credit: MikroElektronika)
17
18Requirements
19************
20
21This shield can only be used with a board that provides a mikroBUS |trade|
22socket and defines the ``mikrobus_serial`` node label (see :ref:`shields`
23for more details).
24
25.. note::
26
27   The reset input on the DA14531 Module is active high and is connected to
28   the RST pin on the mikroBUS socket. On many host boards this RST pin is
29   connected to a system reset signal that is active low. This results in the
30   host system unintentionally holding the DA14531 Module in reset. This issue
31   can be overcome by removing resistor R3 on the BLE TINY Click board, see
32   the `BLE TINY Click Schematic`_ for further details.
33
34The DA14531 Module contained on the shield must be programmed with a binary
35file that supports the HCI interface over UART, without hardware flow control
36as these signals are not supported on the Click footprint.
37
38The `Renesas SmartBond Flash Programmer`_ tool can be used to download a
39suitable binary and then program it into the DA14531 via the SWD header
40present on the Click board. Once the tool has been installed, open it and
41press the "Search Online" button. The required binary file can be selected
42for download as follows:
43
44.. figure:: da14531-hci-binary.webp
45   :align: center
46   :alt: DA14531 HCI Binary File Selection
47
48   Selecting the DA14531 HCI Binary File for Download
49
50Press the "Program" button to program the binary file into the DA14531 Module.
51
52For more information about interfacing to the DA14531 and the BLE TINY Click,
53see the following documentation:
54
55- `DA14531MOD Datasheet`_
56- `BLE TINY Click`_
57
58Programming
59***********
60
61Set ``--shield mikroe_ble_tiny_click`` when you invoke ``west build``. For
62example:
63
64.. zephyr-app-commands::
65   :zephyr-app: samples/bluetooth/beacon
66   :board: ek-ra8m1
67   :shield: mikroe_ble_tiny_click
68   :goals: build
69
70References
71**********
72
73.. target-notes::
74
75.. _DA14531MOD:
76   https://www.renesas.com/us/en/products/wireless-connectivity/bluetooth-low-energy/da14531mod-smartbond-tiny-bluetooth-low-energy-module
77
78.. _mikroBUS:
79   https://www.mikroe.com/mikrobus
80
81.. _DA14531MOD Datasheet:
82   https://www.renesas.com/us/en/document/dst/da14531-module-datasheet?r=1601921
83
84.. _BLE TINY Click:
85   https://www.mikroe.com/ble-tiny-click
86
87.. _BLE TINY Click Schematic:
88   https://download.mikroe.com/documents/add-on-boards/click/ble_tiny_click/BLE_TINY_click_v102_Schematic.pdf
89
90.. _Renesas SmartBond Flash Programmer:
91   https://www.renesas.com/us/en/software-tool/smartbond-flash-programmer
92