1.. _ubx_evkannab1_nrf52832:
2
3u-blox EVK-ANNA-B11x
4####################
5
6Overview
7********
8
9The u-blox ANNA-B1 Evaluation Kit hardware is a Bluetooth low energy
10module based on the Nordic Semiconductor nRF52832 ARM Cortex-M4F CPU
11and 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-ANNA-B112.jpg
29
30	EVK ANNA-B1
31
32More information about the ANNA-B1 module and the EVK-ANNA-B1
33can be found at `ANNA-B1 product page`_ and
34`EVK-ANNA-B1 product page`_.
35
36Supported Features
37==================
38
39The ubx_evkannab1_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
74Other hardware features have not been enabled yet for this board.
75See `EVK-ANNA-B1 product page`_ and `ANNA-B1 Data Sheet`_
76for a complete list of EVK ANNA-B1 hardware features.
77
78Connections and IOs
79===================
80
81LED
82---
83
84* LED0 (red) = P0.27
85* LED1 (green) = P0.25
86* LED2 (blue) = P0.26
87
88Push buttons
89------------
90
91* BUTTON1 = SW1 = P0.25
92* BUTTON2 = SW2 = P0.24
93
94General information on module pin numbering
95-------------------------------------------
96
97The numbering of the pins on the module and EVK do not follow the GPIO
98numbering on the nRF52832 SoC. Please see the `ANNA-B1 Data Sheet`_ for
99information on how to map ANNA-B1 pins to the pin numbering on the
100nRF52832 SoC.
101
102The reason for this is the u-blox module family concept where different
103modules share the same pinout and can be interchanged.
104
105Programming and Debugging
106*************************
107
108Applications for the ``ubx_evkannab1/nrf52832`` board configuration can be
109built and flashed in the usual way (see :ref:`build_an_application`
110and :ref:`application_run` for more details); however, the standard
111debugging targets are not currently available.
112
113Flashing
114========
115
116Build and flash applications as usual (see
117:ref:`build_an_application` and :ref:`application_run` for more details).
118
119Here is an example for the :zephyr:code-sample:`hello_world` application.
120
121Open a terminal program to the USB Serial Port installed when connecting
122the board and listen for output.
123
124Settings: 115200, 8N1, no flow control.
125
126Then build and flash the application in the usual way.
127
128.. zephyr-app-commands::
129   :zephyr-app: samples/hello_world
130   :board: ubx_evkannab1/nrf52832
131   :goals: build flash
132
133Debugging
134=========
135
136Refer to the :ref:`nordic_segger` page to learn about debugging boards
137containing a Nordic Semiconductor chip with a Segger IC.
138
139
140Testing the LEDs and buttons in the EVK NINA-B11x
141*************************************************
142
143There are 2 samples that allow you to test that the buttons (switches)
144and LEDs on the board are working properly with Zephyr:
145
146.. code-block:: console
147
148   samples/basic/blinky
149   samples/basic/button
150
151You can build and flash the examples to make sure Zephyr is running
152correctly on your board. The button and LED definitions can be found in
153:zephyr_file:`boards/u-blox/ubx_evkannab1/ubx_evkannab1_nrf52832.dts`.
154
155Note that the buttons on the EVK-ANNA-B1 are marked SW1 and SW2, which
156are named sw0 and sw1 in the dts file.
157Also note that the SW1 button and the green LED are connected on HW level.
158
159
160References
161**********
162
163.. target-notes::
164
165.. _ANNA-B1 product page: https://www.u-blox.com/en/product/anna-b112-open-cpu
166.. _EVK-ANNA-B1 product page: https://www.u-blox.com/en/product/evk-anna-b112
167.. _Nordic Semiconductor Infocenter: https://infocenter.nordicsemi.com
168.. _J-Link Software and documentation pack: https://www.segger.com/jlink-software.html
169.. _ANNA-B1 Data Sheet: https://www.u-blox.com/en/docs/UBX-18011707
170