1.. _ubx_evkninab1_nrf52832:
2
3u-blox EVK NINA-B11x
4####################
5
6Overview
7********
8
9The u-blox NINA-B1 Evaluation Kit hardware is a Bluetooth
10low energy module based on the Nordic Semiconductor nRF52832
11ARM Cortex-M4F CPU and has support for the following features:
12
13* :abbr:`ADC (Analog to Digital Converter)`
14* CLOCK
15* FLASH
16* :abbr:`GPIO (General Purpose Input Output)`
17* :abbr:`I2C (Inter-Integrated Circuit)`
18* :abbr:`MPU (Memory Protection Unit)`
19* :abbr:`NVIC (Nested Vectored Interrupt Controller)`
20* :abbr:`PWM (Pulse Width Modulation)`
21* RADIO (Bluetooth Low Energy)
22* :abbr:`RTC (nRF RTC System Clock)`
23* Segger RTT (RTT Console)
24* :abbr:`SPI (Serial Peripheral Interface)`
25* :abbr:`UART (Universal asynchronous receiver-transmitter)`
26* :abbr:`WDT (Watchdog Timer)`
27
28.. figure:: img/EVK-NINA-B1.jpg
29
30	EVK NINA-B1
31
32More information about the NINA-B1 module and the EVK NINA-B1
33can be found at `NINA-B1 product page`_ and
34`EVK-NINA-B1 product page`_.
35
36Supported Features
37==================
38
39The ubx_evkninab1/nrf52832 board configuration supports the
40following hardware features:
41
42+-----------+------------+----------------------+
43| Interface | Controller | Driver/Component     |
44+===========+============+======================+
45| ADC       | on-chip    | adc                  |
46+-----------+------------+----------------------+
47| CLOCK     | on-chip    | clock_control        |
48+-----------+------------+----------------------+
49| FLASH     | on-chip    | flash                |
50+-----------+------------+----------------------+
51| GPIO      | on-chip    | gpio                 |
52+-----------+------------+----------------------+
53| I2C(M)    | on-chip    | i2c                  |
54+-----------+------------+----------------------+
55| MPU       | on-chip    | arch/arm             |
56+-----------+------------+----------------------+
57| NVIC      | on-chip    | arch/arm             |
58+-----------+------------+----------------------+
59| PWM       | on-chip    | pwm                  |
60+-----------+------------+----------------------+
61| RADIO     | on-chip    | Bluetooth Low Energy |
62+-----------+------------+----------------------+
63| RTC       | on-chip    | system clock         |
64+-----------+------------+----------------------+
65| RTT       | Segger     | console              |
66+-----------+------------+----------------------+
67| SPI(M/S)  | on-chip    | spi                  |
68+-----------+------------+----------------------+
69| UART      | on-chip    | serial               |
70+-----------+------------+----------------------+
71| WDT       | on-chip    | watchdog             |
72+-----------+------------+----------------------+
73
74.. note::
75	Most Arduino interfaces are supported. Arduino pins
76	D5 and D8 are not available, so arduino_gpio is
77	disabled. On the EVK-NINA-B1, these pins are
78	assigned to SWDIO and SWDCLK, respectively.
79
80Other hardware features have not been enabled yet for this board.
81See `EVK-NINA-B1 product page`_ and `NINA-B1 Data Sheet`_
82for a complete list of EVK NINA-B1 hardware features.
83
84Connections and IOs
85===================
86
87LED
88---
89
90* LED0 (red) = P0.08
91* LED1 (green) = P0.16
92* LED2 (blue) = P0.18
93
94Push buttons
95------------
96
97* BUTTON1 = SW1 = P0.16
98* BUTTON2 = SW2 = P0.30
99
100
101General information on module pin numbering
102-------------------------------------------
103
104The numbering of the pins on the module and EVK do not follow the GPIO
105numbering on the nRF52832 SoC. Please see the `NINA-B1 Data Sheet`_ for
106information on how to map NINA-B1 pins to the pin numbering on the
107nRF52832 SoC.
108
109The reason for this is the u-blox module family concept where different
110modules share the same pinout and can be interchanged, see
111`NINA module family Nested design`_.
112
113Programming and Debugging
114*************************
115
116Applications for the ``ubx_evkninab1/nrf52832`` board configuration can be
117built and flashed in the usual way (see :ref:`build_an_application`
118and :ref:`application_run` for more details); however, the standard
119debugging targets are not currently available.
120
121Flashing
122========
123
124Build and flash applications as usual (see
125:ref:`build_an_application` and :ref:`application_run` for more details).
126
127Here is an example for the :zephyr:code-sample:`hello_world` application.
128
129Open a terminal program to the USB Serial Port installed when connecting
130the board and listen for output.
131
132Settings: 115200, 8N1, no flow control.
133
134Then build and flash the application in the usual way.
135
136.. zephyr-app-commands::
137   :zephyr-app: samples/hello_world
138   :board: ubx_evkninab1/nrf52832
139   :goals: build flash
140
141Debugging
142=========
143
144Refer to the :ref:`nordic_segger` page to learn about debugging boards
145containing a Nordic Semiconductor chip with a Segger IC.
146
147
148Testing the LEDs and buttons in the EVK NINA-B11x
149*************************************************
150
151There are 2 samples that allow you to test that the buttons (switches)
152and LEDs on the board are working properly with Zephyr:
153
154.. code-block:: console
155
156   samples/basic/blinky
157   samples/basic/button
158
159You can build and flash the examples to make sure Zephyr is running
160correctly on your board. The button and LED definitions can be found in
161:zephyr_file:`boards/u-blox/ubx_evkninab1/ubx_evkninab1_nrf52832.dts`.
162
163Note that the buttons on the EVK-NINA-B1 are marked SW1 and SW2, which
164are named sw0 and sw1 in the dts file.
165Also note that the SW1 button and the green LED are connected on HW level.
166
167
168References
169**********
170
171.. target-notes::
172
173.. _NINA-B1 product page: https://www.u-blox.com/en/product/nina-b1-series-open-cpu
174.. _EVK-NINA-B1 product page: https://www.u-blox.com/en/product/evk-nina-b1
175.. _Nordic Semiconductor Infocenter: https://infocenter.nordicsemi.com
176.. _J-Link Software and documentation pack: https://www.segger.com/jlink-software.html
177.. _NINA-B1 Data Sheet: https://www.u-blox.com/en/docs/UBX-15019243
178.. _NINA module family Nested design: https://www.u-blox.com/en/docs/UBX-17065600
179