1.. _renesas_us159_da14531evz_shield:
2
3Renesas DA14531 Pmod Board
4##########################
5
6Overview
7********
8
9The Renesas US159 DA14531EVZ carries a `DA14531MOD`_ Bluetooth LE module
10in a `Digilent Pmod`_ |trade| form factor.
11
12.. figure:: us159-da14531evz-pmod.webp
13   :align: center
14   :alt: Renesas US159 DA14531EVZ Pmod
15
16   Renesas US159 DA14531EVZ Pmod (Credit: Renesas Electronics)
17
18Requirements
19************
20
21This shield can only be used with a board that provides a Pmod |trade|
22socket and defines the ``pmod_serial`` node label (see :ref:`shields` for
23more details).
24
25The DA14531 Module contained on the shield must be programmed with a binary
26file that supports the HCI interface over UART, with hardware flow control
27enabled.
28
29The `Renesas SmartBond Flash Programmer`_ tool can be used to download a
30suitable binary and then program it into the DA14531 via the SWD header
31present on the Pmod board. Once the tool has been installed, open it and
32press the "Search Online" button. The required binary file can be selected
33for download as follows:
34
35.. figure:: da14531-hci-hw-flow-binary.webp
36   :align: center
37   :alt: DA14531 HCI Binary File Selection
38
39   Selecting the DA14531 HCI Binary File for Download
40
41Press the "Program" button to program the binary file into the DA14531 Module.
42
43For more information about interfacing to the DA14531 and the US159 DA14531EVZ
44Pmod, see the following documentation:
45
46- `DA14531MOD Datasheet`_
47- `US159 DA14531EVZ Pmod`_
48
49Programming
50***********
51
52Set ``--shield renesas_us159_da14531evz`` when you invoke ``west build``. For
53example:
54
55.. zephyr-app-commands::
56   :zephyr-app: samples/bluetooth/beacon
57   :board: ek_ra8m1
58   :shield: renesas_us159_da14531evz
59   :goals: build
60
61References
62**********
63
64.. target-notes::
65
66.. _DA14531MOD:
67   https://www.renesas.com/us/en/products/wireless-connectivity/bluetooth-low-energy/da14531mod-smartbond-tiny-bluetooth-low-energy-module
68
69.. _Digilent Pmod:
70   https://digilent.com/reference/pmod/start
71
72.. _Renesas SmartBond Flash Programmer:
73   https://www.renesas.com/us/en/software-tool/smartbond-flash-programmer
74
75.. _DA14531MOD Datasheet:
76   https://www.renesas.com/us/en/document/dst/da14531-module-datasheet?r=1601921
77
78.. _US159 DA14531EVZ Pmod:
79   https://www.renesas.com/en/products/wireless-connectivity/bluetooth-low-energy/us159-da14531evz-low-power-bluetooth-pmod-board-renesas-quickconnect-iot
80