1.. zephyr:board:: bl654_dvk
2
3Overview
4********
5
6The BL654 Development Kit hardware provides
7support for the Ezurio BL654 module powered by a Nordic Semiconductor nRF52840 ARM Cortex-M4F CPU.
8
9It is also pin compatible with the BL654PA which adds a power amplifier. The "pa" variant provides
10this compatibility. Use board ``bl654_dvk/nrf52840/pa`` to build for that target.
11Bluetooth LE regulatory certifications obtained by Ezurio are not applicable to BL654PA variant.
12It should not be used in commercial applications prior to re-certification being performed - please review with the Ezurio team at www.ezurio.com/contact
13
14This development kit has the following features:
15
16* :abbr:`ADC (Analog to Digital Converter)`
17* CLOCK
18* FLASH
19* :abbr:`GPIO (General Purpose Input Output)`
20* :abbr:`I2C (Inter-Integrated Circuit)`
21* :abbr:`MPU (Memory Protection Unit)`
22* :abbr:`NVIC (Nested Vectored Interrupt Controller)`
23* :abbr:`PWM (Pulse Width Modulation)`
24* RADIO (Bluetooth Low Energy and 802.15.4)
25* :abbr:`RTC (nRF RTC System Clock)`
26* Segger RTT (RTT Console)
27* :abbr:`SPI (Serial Peripheral Interface)`
28* :abbr:`UART (Universal asynchronous receiver-transmitter)`
29* :abbr:`USB (Universal Serial Bus)`
30* :abbr:`WDT (Watchdog Timer)`
31
32.. figure:: img/455-00001_BoxContents.jpg
33     :align: center
34     :alt: 455-00001 Box Contents
35
36     455-00001 (BL654 DVK integrated antenna) Box Contents
37
38More information about the board can be found at the
39`BL654 website`_.
40
41Hardware
42********
43
44Supported Features
45==================
46
47.. zephyr:board-supported-hw::
48
49See `BL654 website`_
50for a complete list of BL654 Development Kit board hardware features.
51
52Connections and IOs
53===================
54
55LED
56---
57
58* LED1 (blue) = P0.13
59* LED2 (blue) = P0.14
60* LED3 (blue) = P0.15
61* LED4 (blue) = P0.16
62
63Push buttons
64------------
65
66* BUTTON1 = SW1 = P0.11
67* BUTTON2 = SW2 = P0.12
68* BUTTON3 = SW9 = P0.24
69* BUTTON4 = SW10 = P0.25
70* RESET = SW3 = nReset/IF BOOT
71
72Programming and Debugging
73*************************
74
75Applications for the ``bl654_dvk`` board configuration can be built, flashed,
76and debugged in the usual way. See :ref:`build_an_application` and
77:ref:`application_run` for more details on building and running.
78
79Flashing
80========
81
82Follow the instructions in the :ref:`nordic_segger` page to install
83and configure all the necessary software. Further information can be
84found in :ref:`nordic_segger_flashing`. Then build and flash
85applications as usual (see :ref:`build_an_application` and
86:ref:`application_run` for more details).
87
88Here is an example for the :zephyr:code-sample:`hello_world` application.
89
90First, run your favorite terminal program to listen for output.
91
92NOTE: On the BL654 DVK, the FTDI USB should be used to access the UART console.
93
94.. code-block:: console
95
96   $ minicom -D <tty_device> -b 115200
97
98Replace :code:`<tty_device>` with the port where the board nRF52 DK
99can be found. For example, under Linux, :code:`/dev/ttyUSB0`.
100
101Then build and flash the application in the usual way.
102
103.. zephyr-app-commands::
104   :zephyr-app: samples/hello_world
105   :board: bl654_dvk
106   :goals: build flash
107
108Debugging
109=========
110
111Refer to the :ref:`nordic_segger` page to learn about debugging Nordic based boards with a
112Segger IC.
113
114Testing Bluetooth on the BL654 DVK
115***********************************
116Many of the Bluetooth examples will work on the BL654 DVK.
117Try them out:
118
119* :zephyr:code-sample:`ble_peripheral`
120* :zephyr:code-sample:`bluetooth_eddystone`
121* :zephyr:code-sample:`bluetooth_ibeacon`
122
123
124Testing the LEDs and buttons on the BL654 DVK
125************************************************
126
127There are 2 samples that allow you to test that the buttons (switches) and LEDs on
128the board are working properly with Zephyr:
129
130* :zephyr:code-sample:`blinky`
131* :zephyr:code-sample:`button`
132
133You can build and flash the examples to make sure Zephyr is running correctly on
134your board. The button and LED definitions can be found in
135:zephyr_file:`boards/ezurio/bl654_dvk/bl654_dvk.dts`.
136
137
138References
139**********
140
141.. target-notes::
142
143.. _BL654 website: https://ezurio.com/wireless-modules/bluetooth-modules/bluetooth-5-modules/bl654-series
144.. _J-Link Software and documentation pack: https://www.segger.com/jlink-software.html
145