boards: arm: Add u-blox EVK-ANNA-B1

Add support for u-blox EVK-ANNA-B1 which uses the nRF52832.

This board is similar to the nRF52dk_nrf52832 with
different pin assignments on the header pins and not having
the debug-in and shield SWD headers.

Tested with blinky, button, and Bluetooth peripheral_hr
Addressed review comments, including SW2
Rebased to pick up new board in test_adc.c - corrected typo
Reverted to sda-pin, scl-pin

Signed-off-by: Bob Recny <bob.recny@u-blox.com>
This commit is contained in:
Bob Recny 2021-04-02 21:16:07 +00:00 committed by Ioannis Glaropoulos
commit e2595cb211
10 changed files with 490 additions and 0 deletions

View file

@ -0,0 +1,10 @@
# u-blox EVK-ANNA-B1 board configuration
#
# Copyright (c) 2021 u-blox AG
# SPDX-License-Identifier: Apache-2.0
config BOARD_ENABLE_DCDC
bool "Enable DCDC mode"
select SOC_DCDC_NRF52X
default y
depends on BOARD_UBX_EVKANNAB1_NRF52832

View file

@ -0,0 +1,8 @@
# u-blox EVK-ANNA-B1 board configuration
#
# Copyright (c) 2021 u-blox AG
# SPDX-License-Identifier: Apache-2.0
config BOARD_UBX_EVKANNAB1_NRF52832
bool "u-blox EVK-ANNA-B1"
depends on SOC_NRF52832_QFAA

View file

@ -0,0 +1,14 @@
# u-blox EVK-ANNA-B1 board configuration
#
# Copyright (c) 2021 u-blox AG
# SPDX-License-Identifier: Apache-2.0
if BOARD_UBX_EVKANNAB1_NRF52832
config BOARD
default "ubx_evkannab1_nrf52832"
config BT_CTLR
default BT
endif # BOARD_UBX_EVKANNAB1_NRF52832

View file

@ -0,0 +1,12 @@
# u-blox EVK-ANNA-B1 board configuration
# Copyright (c) 2021 u-blox AG
# SPDX-License-Identifier: Apache-2.0
board_runner_args(nrfjprog "--nrf-family=NRF52")
board_runner_args(jlink "--device=nrf52" "--speed=4000")
board_runner_args(pyocd "--target=nrf52" "--frequency=4000000")
include(${ZEPHYR_BASE}/boards/common/nrfjprog.board.cmake)
include(${ZEPHYR_BASE}/boards/common/jlink.board.cmake)
include(${ZEPHYR_BASE}/boards/common/pyocd.board.cmake)
include(${ZEPHYR_BASE}/boards/common/openocd-nrf5.board.cmake)

Binary file not shown.

After

Width:  |  Height:  |  Size: 105 KiB

View file

@ -0,0 +1,169 @@
.. _ubx_evkannab1_nrf52832:
u-blox EVK-ANNA-B11x
####################
Overview
********
The u-blox ANNA-B1 Evaluation Kit hardware is a Bluetooth low energy
module based on the Nordic Semiconductor nRF52832 ARM Cortex-M4F CPU
and has support for the following features:
* :abbr:`ADC (Analog to Digital Converter)`
* CLOCK
* FLASH
* :abbr:`GPIO (General Purpose Input Output)`
* :abbr:`I2C (Inter-Integrated Circuit)`
* :abbr:`MPU (Memory Protection Unit)`
* :abbr:`NVIC (Nested Vectored Interrupt Controller)`
* :abbr:`PWM (Pulse Width Modulation)`
* RADIO (Bluetooth Low Energy)
* :abbr:`RTC (nRF RTC System Clock)`
* Segger RTT (RTT Console)
* :abbr:`SPI (Serial Peripheral Interface)`
* :abbr:`UART (Universal asynchronous receiver-transmitter)`
* :abbr:`WDT (Watchdog Timer)`
.. figure:: img/EVK-ANNA-B112.png
EVK ANNA-B1
More information about the ANNA-B1 module and the EVK-ANNA-B1
can be found at `ANNA-B1 product page`_ and
`EVK-ANNA-B1 product page`_.
Supported Features
==================
The ubx_evkannab1_nrf52832 board configuration supports the
following hardware features:
+-----------+------------+----------------------+
| Interface | Controller | Driver/Component |
+===========+============+======================+
| ADC | on-chip | adc |
+-----------+------------+----------------------+
| CLOCK | on-chip | clock_control |
+-----------+------------+----------------------+
| FLASH | on-chip | flash |
+-----------+------------+----------------------+
| GPIO | on-chip | gpio |
+-----------+------------+----------------------+
| I2C(M) | on-chip | i2c |
+-----------+------------+----------------------+
| MPU | on-chip | arch/arm |
+-----------+------------+----------------------+
| NVIC | on-chip | arch/arm |
+-----------+------------+----------------------+
| PWM | on-chip | pwm |
+-----------+------------+----------------------+
| RADIO | on-chip | Bluetooth Low Energy |
+-----------+------------+----------------------+
| RTC | on-chip | system clock |
+-----------+------------+----------------------+
| RTT | Segger | console |
+-----------+------------+----------------------+
| SPI(M/S) | on-chip | spi |
+-----------+------------+----------------------+
| UART | on-chip | serial |
+-----------+------------+----------------------+
| WDT | on-chip | watchdog |
+-----------+------------+----------------------+
Other hardware features are not supported by the Zephyr kernel.
See `EVK-ANNA-B1 product page`_ and `ANNA-B1 Data Sheet`_
for a complete list of EVK ANNA-B1 hardware features.
Connections and IOs
===================
LED
---
* LED0 (red) = P0.27
* LED1 (green) = P0.25
* LED2 (blue) = P0.26
Push buttons
------------
* BUTTON1 = SW1 = P0.25
* BUTTON2 = SW2 = P0.24
General information on module pin numbering
-------------------------------------------
The numbering of the pins on the module and EVK do not follow the GPIO
numbering on the nRF52832 SoC. Please see the `ANNA-B1 Data Sheet`_ for
information on how to map ANNA-B1 pins to the pin numbering on the
nRF52832 SoC.
The reason for this is the u-blox module family concept where different
modules share the same pinout and can be interchanged.
Programming and Debugging
*************************
Applications for the ``ubx_evkannab1_nrf52832`` board configuration can be
built and flashed in the usual way (see :ref:`build_an_application`
and :ref:`application_run` for more details); however, the standard
debugging targets are not currently available.
Flashing
========
Build and flash applications as usual (see
:ref:`build_an_application` and :ref:`application_run` for more details).
Here is an example for the :ref:`hello_world` application.
Open a terminal program to the USB Serial Port installed when connecting
the board and listen for output.
Settings: 115200, 8N1, no flow control.
Then build and flash the application in the usual way.
.. zephyr-app-commands::
:zephyr-app: samples/hello_world
:board: ubx_evkannab1_nrf52832
:goals: build flash
Debugging
=========
Refer to the :ref:`nordic_segger` page to learn about debugging boards
containing a Nordic Semiconductor chip with a Segger IC.
Testing the LEDs and buttons in the EVK NINA-B11x
*************************************************
There are 2 samples that allow you to test that the buttons (switches)
and LEDs on the board are working properly with Zephyr:
.. code-block:: console
samples/basic/blinky
samples/basic/button
You can build and flash the examples to make sure Zephyr is running
correctly on your board. The button and LED definitions can be found in
:zephyr_file:`boards/arm/ubx_evkannab1_nrf52832/ubx_evkannab1_nrf52832.dts`.
Note that the buttons on the EVK-ANNA-B1 are marked SW1 and SW2, which
are named sw0 and sw1 in the dts file.
Also note that the SW1 button and the green LED are connected on HW level.
References
**********
.. target-notes::
.. _ANNA-B1 product page: https://www.u-blox.com/en/product/anna-b112-open-cpu
.. _EVK-ANNA-B1 product page: https://www.u-blox.com/en/product/evk-anna-b112
.. _Nordic Semiconductor Infocenter: https://infocenter.nordicsemi.com
.. _J-Link Software and documentation pack: https://www.segger.com/jlink-software.html
.. _ANNA-B1 Data Sheet: https://www.u-blox.com/en/docs/UBX-18011707

View file

@ -0,0 +1,224 @@
/*
* Copyright (c) 2021 u-blox AG
*
* SPDX-License-Identifier: Apache-2.0
*/
/dts-v1/;
#include <nordic/nrf52832_qfaa.dtsi>
/ {
model = "u-blox EVK-ANNA-B1 NRF52832";
compatible = "u-blox,ubx_evkannab1_nrf52832";
chosen {
zephyr,console = &uart0;
zephyr,shell-uart = &uart0;
zephyr,uart-mcumgr = &uart0;
zephyr,bt-mon-uart = &uart0;
zephyr,bt-c2h-uart = &uart0;
zephyr,sram = &sram0;
zephyr,flash = &flash0;
zephyr,code-partition = &slot0_partition;
};
leds {
compatible = "gpio-leds";
led0: led_0 {
/* ANNA-B1 GPIO_29 */
gpios = <&gpio0 27 GPIO_ACTIVE_LOW>;
label = "Red LED";
};
led1: led_1 {
/* ANNA-B1 GPIO_30 */
gpios = <&gpio0 25 GPIO_ACTIVE_LOW>;
label = "Green LED";
};
led2: led_2 {
/*ANNA-B1 GPIO_31 */
gpios = <&gpio0 26 GPIO_ACTIVE_LOW>;
label = "Blue LED";
};
};
pwmleds {
compatible = "pwm-leds";
red_pwm_led: red_pwm_led {
pwms = <&pwm0 27>;
};
green_pwm_led: green_pwm_led {
pwms = <&pwm0 25>;
};
blue_pwm_led: blue_pwm_led {
pwms = <&pwm0 26>;
};
};
buttons {
compatible = "gpio-keys";
button0: button_0 {
/* EVK-ANNA-B1 SW1 button */
gpios = <&gpio0 25 (GPIO_PULL_UP | \
GPIO_ACTIVE_LOW)>;
label = "Push button switch SW1";
};
button1: button_1 {
/* EVK-ANNA-B1 SW2 button */
gpios = <&gpio0 24 (GPIO_PULL_UP | \
GPIO_ACTIVE_LOW)>;
label = "Push button switch SW2";
};
};
arduino_header: connector {
compatible = "arduino-header-r3";
#gpio-cells = <2>;
gpio-map-mask = <0xffffffff 0xffffffc0>;
gpio-map-pass-thru = <0 0x3f>;
gpio-map = <0 0 &gpio0 4 0>, /* A0 */
<1 0 &gpio0 5 0>, /* A1 */
<2 0 &gpio0 28 0>, /* A2 */
<3 0 &gpio0 29 0>, /* A3 */
<4 0 &gpio0 30 0>, /* A4 */
<5 0 &gpio0 31 0>, /* A5 */
<6 0 &gpio0 2 0>, /* D0 */
<7 0 &gpio0 3 0>, /* D1 */
<8 0 &gpio0 19 0>, /* D2 */
<9 0 &gpio0 11 0>, /* D3 */
<10 0 &gpio0 27 0>, /* D4 */
<11 0 &gpio0 26 0>, /* D5 */
<12 0 &gpio0 10 0>, /* D6 */
<13 0 &gpio0 9 0>, /* D7 */
<14 0 &gpio0 14 0>, /* D8 */
<15 0 &gpio0 24 0>, /* D9 */
<16 0 &gpio0 22 0>, /* D10 */
<17 0 &gpio0 23 0>, /* D11 */
<18 0 &gpio0 18 0>, /* D12 */
<19 0 &gpio0 20 0>, /* D13 */
<20 0 &gpio0 15 0>, /* D14 */
<21 0 &gpio0 16 0>; /* D15 */
};
arduino_adc: analog-connector {
compatible = "arduino,uno-adc";
#io-channel-cells = <1>;
io-channel-map = <0 &adc 1>, /* A0 = P0.4 = AIN1 */
<1 &adc 2>, /* A1 = P0.5 = AIN2 */
<2 &adc 4>, /* A2 = P0.28 = AIN4 */
<3 &adc 5>, /* A3 = P0.29 = AIN5 */
<4 &adc 6>, /* A4 = P0.30 = AIN6 */
<5 &adc 7>; /* A5 = P0.31 = AIN7 */
};
/* These aliases are provided for compatibility with samples */
aliases {
led0 = &led0;
led1 = &led1;
led2 = &led2;
pwm-led0 = &red_pwm_led;
pwm-led1 = &green_pwm_led;
pwm-led2 = &blue_pwm_led;
red-pwm-led = &red_pwm_led;
green-pwm-led = &green_pwm_led;
blue-pwm-led = &blue_pwm_led;
sw0 = &button0;
sw1 = &button1;
};
};
&adc {
status = "okay";
};
&gpiote {
status = "okay";
};
&gpio0 {
status = "okay";
};
&uart0 {
compatible = "nordic,nrf-uarte";
status = "okay";
current-speed = <115200>;
tx-pin = <3>;
rx-pin = <2>;
rts-pin = <11>;
cts-pin = <19>;
};
arduino_i2c: &i2c0 {
compatible = "nordic,nrf-twi";
status = "okay";
sda-pin = <15>;
scl-pin = <16>;
};
&i2c1 {
compatible = "nordic,nrf-twi";
/* Cannot be used together with spi1. */
/* status = "okay"; */
sda-pin = <31>;
scl-pin = <30>;
};
&pwm0 {
status = "okay";
ch0-pin = <27>;
ch0-inverted;
status = "okay";
ch1-pin = <25>;
ch1-inverted;
status = "okay";
ch2-pin = <26>;
ch2-inverted;
};
arduino_spi: &spi0 {
compatible = "nordic,nrf-spi";
/* Cannot be use simultaneously with i2c0 */
/* status = "okay"; */
sck-pin = <20>; /* D13 */
mosi-pin = <23>; /* D11 */
miso-pin = <18>; /* D12 */
cs-gpios = <&arduino_header 16 GPIO_ACTIVE_LOW>; /* D10 */
};
&spi1 {
compatible = "nordic,nrf-spi";
status = "okay";
sck-pin = <28>;
mosi-pin = <29>;
miso-pin = <30>;
};
&flash0 {
partitions {
compatible = "fixed-partitions";
#address-cells = <1>;
#size-cells = <1>;
boot_partition: partition@0 {
label = "mcuboot";
reg = <0x00000000 0xc000>;
};
slot0_partition: partition@c000 {
label = "image-0";
reg = <0x0000C000 0x32000>;
};
slot1_partition: partition@3e000 {
label = "image-1";
reg = <0x0003E000 0x32000>;
};
scratch_partition: partition@70000 {
label = "image-scratch";
reg = <0x00070000 0xa000>;
};
storage_partition: partition@7a000 {
label = "storage";
reg = <0x0007a000 0x00006000>;
};
};
};

View file

@ -0,0 +1,22 @@
identifier: ubx_evkannab1_nrf52832
name: UBX-EVKANNAB1-NRF52832
type: mcu
arch: arm
toolchain:
- zephyr
- gnuarmemb
- xtools
ram: 64
flash: 512
supported:
- adc
- arduino_gpio
- arduino_i2c
- arduino_spi
- gpio
- counter
- nvs
- i2c
- pwm
- spi
- watchdog

View file

@ -0,0 +1,30 @@
# u-blox EVK-ANNA-B1 board configuration
# Copyright (c) 2021 u-blox AG
# SPDX-License-Identifier: Apache-2.0
CONFIG_SOC_SERIES_NRF52X=y
CONFIG_SOC_NRF52832_QFAA=y
CONFIG_BOARD_UBX_EVKANNAB1_NRF52832=y
# Enable MPU
CONFIG_ARM_MPU=y
# Enable hardware stack protection
CONFIG_HW_STACK_PROTECTION=y
# Enable RTT
CONFIG_USE_SEGGER_RTT=y
# enable GPIO
CONFIG_GPIO=y
# enable uart driver
CONFIG_SERIAL=y
# enable console
CONFIG_CONSOLE=y
CONFIG_UART_CONSOLE=y
# additional board options
CONFIG_GPIO_AS_PINRESET=y

View file

@ -56,6 +56,7 @@
defined(CONFIG_BOARD_UBX_BMD340EVAL_NRF52840) || \ defined(CONFIG_BOARD_UBX_BMD340EVAL_NRF52840) || \
defined(CONFIG_BOARD_UBX_BMD360EVAL_NRF52811) || \ defined(CONFIG_BOARD_UBX_BMD360EVAL_NRF52811) || \
defined(CONFIG_BOARD_UBX_BMD380EVAL_NRF52840) || \ defined(CONFIG_BOARD_UBX_BMD380EVAL_NRF52840) || \
defined(CONFIG_BOARD_UBX_EVKANNAB1_NRF52832) || \
defined(CONFIG_BOARD_UBX_EVKNINAB3_NRF52840) defined(CONFIG_BOARD_UBX_EVKNINAB3_NRF52840)
#include <hal/nrf_saadc.h> #include <hal/nrf_saadc.h>