michaelh/zephyr
1
0
Fork 0
Code Releases Activity

boards: arm: Add support for BMD-360-EVAL

Browse source 
Add support for u-blox BMD-360-EVAL which uses the nRF52811.
This board is functionally equivalent to the nRF52dk with a
nRF52811 mounted in place of the nRF52832 with the exception
of not having debug-in and the shield SWD header.
DEVELOP_IN_NRF52832 is *not* required since the IC
used is the nRF52811.

Note that header pin numbers noted in index.rst are shown with
respect to the pin 1 markings on the BMD-3xx-EVAL boards, and are
flipped from the nRF52dk_nrf52811.

Tested with blinky, button, and Bluetooth peripheral_hr
Edited to include changes similar to those requested in
https://github.com/zephyrproject-rtos/zephyr/pull/33850
(nRF52810 there vs. nRF52811 here)

Signed-off-by: Bob Recny <bob.recny@u-blox.com>
This commit is contained in:
Bob Recny 2021-03-29 22:49:02 +00:00 • committed by Carles Cufí
commit 6f3b30ecb5
11 changed files with 687 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

14
boards/arm/ubx_bmd360eval_nrf52811/Kconfig Normal file
View file

@ -0,0 +1,14 @@
# BMD-360-EVAL 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_BMD360EVAL_NRF52811
# BT_CTLR depends on BT. When BT is enabled we should default to also
# enabling the controller.
config BT_CTLR
default y if BT

8
boards/arm/ubx_bmd360eval_nrf52811/Kconfig.board Normal file
View file

@ -0,0 +1,8 @@
# BMD-360-EVAL board configuration
# Copyright (c) 2021 u-blox AG
# SPDX-License-Identifier: Apache-2.0
config BOARD_UBX_BMD360EVAL_NRF52811
bool "u-blox BMD-360-EVAL"
depends on SOC_NRF52811_QFAA

11
boards/arm/ubx_bmd360eval_nrf52811/Kconfig.defconfig Normal file
View file

@ -0,0 +1,11 @@
# BMD-360-EVAL board configuration
# Copyright (c) 2021 u-blox AG
# SPDX-License-Identifier: Apache-2.0
if BOARD_UBX_BMD360EVAL_NRF52811
config BOARD
default "ubx_bmd360eval_nrf52811"
endif # BOARD_UBX_BMD360EVAL_NRF52811

9
boards/arm/ubx_bmd360eval_nrf52811/board.cmake Normal file
View file

@ -0,0 +1,9 @@
# BMD-360-EVAL board configuration
# Copyright (c) 2021 u-blox AG
# SPDX-License-Identifier: Apache-2.0
board_runner_args(jlink "--device=nrf52" "--speed=4000")
include(${ZEPHYR_BASE}/boards/common/nrfjprog.board.cmake)
include(${ZEPHYR_BASE}/boards/common/jlink.board.cmake)
include(${ZEPHYR_BASE}/boards/common/openocd-nrf5.board.cmake)

BIN
boards/arm/ubx_bmd360eval_nrf52811/doc/img/BMD-30-33-35-36-EVAL.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 460 KiB

BIN
boards/arm/ubx_bmd360eval_nrf52811/doc/img/bmd-300-eval_pin_out.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 408 KiB

388
boards/arm/ubx_bmd360eval_nrf52811/doc/index.rst Normal file
View file

@ -0,0 +1,388 @@
.. _ubx_bmd360eval_nrf52811:
u-blox EVK-BMD-360: BMD-360-EVAL
################################
Overview
********
The BMD-360-EVAL hardware provides support for the
u-blox BMD-360 Bluetooth 5 module, based on The
Nordic Semiconductor nRF52811 ARM Cortex-M4 CPU and
the following devices:
* :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/BMD-30-33-35-36-EVAL.png
:width: 593px
:align: center
:alt: BMD-300-EVAL
BMD-300-EVAL (Credit: u-blox AG)
.. note::
The BMD-360-EVAL shares the same pin headers and assignments as the
BMD-300-EVAL. The BMD-300-EVAL is shown here.
More information about the BMD-360-EVAL and the BMD-360 module
can be found at the `u-blox website`_.
Hardware
********
The BMD-360 on the BMD-360-EVAL contains an internal
high-frequency oscillator at 32MHz. There is also a low frequency
(slow) oscillator of 32.768kHz. The BMD-360 itself does not include
the slow crystal; however, the BMD-360-EVAL does.
.. note::
When targeting a custom design without a slow crystal,
be sure to modify code to utilize the internal RC
oscillator for the slow clock.
Supported Features
==================
The BMD-360-EVAL 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 |
+-----------+------------+----------------------+
| 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 the `u-blox website`_ for a complete list of
BMD-360-EVAL hardware features.
Connections and IOs
===================
LED
---
* LED1 (red) = P0.17
* LED2 (red) = P0.18
* LED3 (green) = P0.19
* LED4 (green) = P0.20
* D5 (red) = OB LED 1
* D6 (green) = OB LED 2
Push buttons
------------
* BUTTON1 = SW1 = P0.13
* BUTTON2 = SW2 = P0.14
* BUTTON3 = SW3 = P0.15
* BUTTON4 = SW4 = P0.16
* BOOT = SW5 = boot/reset
External Connectors
-------------------
.. figure:: img/bmd-300-eval_pin_out.png
:width: 659px
:align: center
:alt: BMD-300-EVAL pin-out
BMD-300-EVAL pin-out (Credit: u-blox AG)
.. note::
The BMD-360-EVAL shares the same pin headers and assignments
as the BMD-300-EVAL. The BMD-300-EVAL is shown here.
.. note::
The pin numbers noted below are referenced to
the pin 1 markings on the BMD-360-EVAL
for each header
J-Link Prog Connector (J2)
+-------+--------------+
| PIN # | Signal Name |
+=======+==============+
| 1 | VDD |
+-------+--------------+
| 2 | IMCU_TMSS |
+-------+--------------+
| 3 | GND |
+-------+--------------+
| 4 | IMCU_TCKS |
+-------+--------------+
| 5 | V5V |
+-------+--------------+
| 6 | IMCU_TDOS |
+-------+--------------+
| 7 | Cut off |
+-------+--------------+
| 8 | IMCU_TDIS |
+-------+--------------+
| 9 | Cut off |
+-------+--------------+
| 10 | IMCU_RESET |
+-------+--------------+
Debug OUT (J3)
+-------+----------------+
| PIN # | Signal Name |
+=======+================+
| 1 | EXT_VTG |
+-------+----------------+
| 2 | EXT_SWDIO |
+-------+----------------+
| 3 | GND |
+-------+----------------+
| 4 | EXT_SWDCLK |
+-------+----------------+
| 5 | GND |
+-------+----------------+
| 6 | EXT_SWO |
+-------+----------------+
| 7 | N/C |
+-------+----------------+
| 8 | N/C |
+-------+----------------+
| 9 | EXT_GND_DETECT |
+-------+----------------+
| 10 | EXT_RESET |
+-------+----------------+
Auxiliary (J9)
+-------+----------------+
| PIN # | Signal Name |
+=======+================+
| 1 | P0.10 |
+-------+----------------+
| 2 | P0.09 |
+-------+----------------+
| 3 | P0.08 |
+-------+----------------+
| 4 | P0.07 |
+-------+----------------+
| 5 | P0.06 |
+-------+----------------+
| 6 | P0.05 / AIN3 |
+-------+----------------+
| 7 | P0.21 / RESET |
+-------+----------------+
| 8 | P0.01 / XL2 |
+-------+----------------+
| 9 | P0.00 / XL1 |
+-------+----------------+
| 10 | GND |
+-------+----------------+
Arduino Headers
---------------
Power (J5)
+-------+--------------+-------------------------+
| PIN # | Signal Name | BMD-360 Functions |
+=======+==============+=========================+
| 1 | VSHLD | N/A |
+-------+--------------+-------------------------+
| 2 | VSHLD | N/A |
+-------+--------------+-------------------------+
| 3 | RESET | P0.21 / RESET |
+-------+--------------+-------------------------+
| 4 | VSHLD | N/A |
+-------+--------------+-------------------------+
| 5 | V5V | N/A |
+-------+--------------+-------------------------+
| 6 | GND | N/A |
+-------+--------------+-------------------------+
| 7 | GND | N/A |
+-------+--------------+-------------------------+
| 8 | N/C | N/A |
+-------+--------------+-------------------------+
Analog in (J8)
+-------+--------------+-------------------------+
| PIN # | Signal Name | BMD-360 Functions |
+=======+==============+=========================+
| 1 | A0 | P0.03 / AIN1 |
+-------+--------------+-------------------------+
| 2 | A1 | P0.04 / AIN2 |
+-------+--------------+-------------------------+
| 3 | A2 | P0.28 / AIN4 |
+-------+--------------+-------------------------+
| 4 | A3 | P0.29 / AIN5 |
+-------+--------------+-------------------------+
| 5 | A4 | P0.30 / AIN6 |
+-------+--------------+-------------------------+
| 6 | A5 | P0.31 / AIN7 |
+-------+--------------+-------------------------+
Digital I/O (J7)
+-------+--------------+----------------------------+
| PIN # | Signal Name | BMD-360 Functions |
+=======+==============+============================+
| 1 | D7 | P0.18 |
+-------+--------------+----------------------------+
| 2 | D6 | P0.17 |
+-------+--------------+----------------------------+
| 3 | D5 | P0.16 |
+-------+--------------+----------------------------+
| 4 | D4 | P0.15 |
+-------+--------------+----------------------------+
| 5 | D3 | P0.14 |
+-------+--------------+----------------------------+
| 6 | D2 | P0.13 |
+-------+--------------+----------------------------+
| 7 | D1 (TX) | P0.12 |
+-------+--------------+----------------------------+
| 8 | D0 (RX) | P0.11 |
+-------+--------------+----------------------------+
Digital I/O (J6)
+-------+--------------+-------------------------+
| PIN # | Signal Name | BMD-360 Functions |
+=======+==============+=========================+
| 1 | SCL | P0.27 |
+-------+--------------+-------------------------+
| 2 | SDA | P0.26 |
+-------+--------------+-------------------------+
| 3 | AREF | P0.02 / AIN0 |
+-------+--------------+-------------------------+
| 4 | GND | N/A |
+-------+--------------+-------------------------+
| 5 | D13 (SCK) | P0.25 |
+-------+--------------+-------------------------+
| 6 | D12 (MISO) | P0.24 |
+-------+--------------+-------------------------+
| 7 | D11 (MOSI) | P0.23 |
+-------+--------------+-------------------------+
| 8 | D10 (SS) | P0.22 |
+-------+--------------+-------------------------+
| 9 | D9 | P0.20 |
+-------+--------------+-------------------------+
| 10 | D8 | P0.19 |
+-------+--------------+-------------------------+
J11
+-------+--------------+-------------------------+
| PIN # | Signal Name | BMD-360 Functions |
+=======+==============+=========================+
| 1 | D12 (MISO) | P0.24 |
+-------+--------------+-------------------------+
| 2 | V5V | N/A |
+-------+--------------+-------------------------+
| 3 | D13 (SCK) | P0.25 |
+-------+--------------+-------------------------+
| 4 | D11 (MOSI) | P0.23 |
+-------+--------------+-------------------------+
| 5 | RESET | N/A |
+-------+--------------+-------------------------+
| 6 | N/A | N/A |
+-------+--------------+-------------------------+
Programming and Debugging
*************************
Flashing
========
Follow the instructions in the :ref:`nordic_segger` page to install
and configure all the necessary software. Further information can be
found in :ref:`nordic_segger_flashing`. Then 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.
First, run your favorite terminal program to listen for output.
.. code-block:: console
$ minicom -D <tty_device> -b 115200
Replace :code:`<tty_device>` with the port where the
BMD-360-EVAL can be found. For example, under Linux,
:code:`/dev/ttyACM0`.
Then build and flash the application in the usual way.
.. zephyr-app-commands::
:zephyr-app: samples/hello_world
:board: ubx_bmd360eval_nrf52811
:goals: build flash
Debugging
=========
Refer to the :ref:`nordic_segger` page to learn about debugging
u-blox boards with a Segger J-LINK-OB IC.
Testing the LEDs and buttons in the BMD-360-EVAL
************************************************
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_bmd360eval_nrf52811/ubx_bmd360eval_nrf52811.dts`.
References
**********
.. target-notes::
.. _u-blox website: https://www.u-blox.com/en/product/bmd-360-open-cpu

204
boards/arm/ubx_bmd360eval_nrf52811/ubx_bmd360eval_nrf52811.dts Normal file
View file

@ -0,0 +1,204 @@
/*
* Copyright (c) 2021 u-blox AG
*
* SPDX-License-Identifier: Apache-2.0
*/
/dts-v1/;
#include <nordic/nrf52811_qfaa.dtsi>
/ {
model = "u-blox BMD-360-EVAL EVK nRF52811";
compatible = "u-blox, ubx_bmd360eval_nrf52811";
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 {
gpios = <&gpio0 17 GPIO_ACTIVE_LOW>;
label = "Red LED 0";
};
led1: led_1 {
gpios = <&gpio0 18 GPIO_ACTIVE_LOW>;
label = "Red LED 1";
};
led2: led_2 {
gpios = <&gpio0 19 GPIO_ACTIVE_LOW>;
label = "Green LED 2";
};
led3: led_3 {
gpios = <&gpio0 20 GPIO_ACTIVE_LOW>;
label = "Green LED 3";
};
};
pwmleds {
compatible = "pwm-leds";
pwm_led0: pwm_led_0 {
pwms = <&pwm0 17>;
};
};
buttons {
compatible = "gpio-keys";
button0: button_0 {
gpios = <&gpio0 13 (GPIO_PULL_UP | \
GPIO_ACTIVE_LOW)>;
label = "Push button switch 0";
};
button1: button_1 {
gpios = <&gpio0 14 (GPIO_PULL_UP | \
GPIO_ACTIVE_LOW)>;
label = "Push button switch 1";
};
button2: button_2 {
gpios = <&gpio0 15 (GPIO_PULL_UP | \
GPIO_ACTIVE_LOW)>;
label = "Push button switch 2";
};
button3: button_3 {
gpios = <&gpio0 16 (GPIO_PULL_UP | \
GPIO_ACTIVE_LOW)>;
label = "Push button switch 3";
};
};
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 3 0>, /* A0 */
<1 0 &gpio0 4 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 11 0>, /* D0 */
<7 0 &gpio0 12 0>, /* D1 */
<8 0 &gpio0 13 0>, /* D2 */
<9 0 &gpio0 14 0>, /* D3 */
<10 0 &gpio0 15 0>, /* D4 */
<11 0 &gpio0 16 0>, /* D5 */
<12 0 &gpio0 17 0>, /* D6 */
<13 0 &gpio0 18 0>, /* D7 */
<14 0 &gpio0 19 0>, /* D8 */
<15 0 &gpio0 20 0>, /* D9 */
<16 0 &gpio0 22 0>, /* D10 */
<17 0 &gpio0 23 0>, /* D11 */
<18 0 &gpio0 24 0>, /* D12 */
<19 0 &gpio0 25 0>, /* D13 */
<20 0 &gpio0 26 0>, /* D14 */
<21 0 &gpio0 27 0>; /* D15 */
};
arduino_adc: analog-connector {
compatible = "arduino,uno-adc";
#io-channel-cells = <1>;
io-channel-map = <0 &adc 1>, /* A0 = P0.3 = AIN1 */
<1 &adc 2>, /* A1 = P0.4 = 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;
led3 = &led3;
pwm-led0 = &pwm_led0;
sw0 = &button0;
sw1 = &button1;
sw2 = &button2;
sw3 = &button3;
bootloader-led0 = &led0;
};
};
&adc {
status = "okay";
};
&gpiote {
status = "okay";
};
&gpio0 {
status = "okay";
};
arduino_serial: &uart0 {
compatible = "nordic,nrf-uarte";
status = "okay";
current-speed = <115200>;
tx-pin = <6>;
rx-pin = <8>;
rts-pin = <5>;
cts-pin = <7>;
};
arduino_i2c: &i2c0 {
compatible = "nordic,nrf-twi";
status = "okay";
/* Arduino compatible PINs */
sda-gpios = <&gpio0 26 0>;
scl-gpios = <&gpio0 27 0>;
};
&pwm0 {
status = "okay";
ch0-pin = <17>;
ch0-inverted;
};
arduino_spi: &spi0 {
compatible = "nordic,nrf-spi";
status = "okay";
sck-pin = <25>;
mosi-pin = <23>;
miso-pin = <24>;
cs-gpios = <&arduino_header 16 GPIO_ACTIVE_LOW>; /* D10 */
};
&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 0xd000>;
};
slot1_partition: partition@19000 {
label = "image-1";
reg = <0x00019000 0xd000>;
};
scratch_partition: partition@26000 {
label = "image-scratch";
reg = <0x00026000 0x3000>;
};
storage_partition: partition@29000 {
label = "storage";
reg = <0x00029000 0x00007000>;
};
};
};

22
boards/arm/ubx_bmd360eval_nrf52811/ubx_bmd360eval_nrf52811.yaml Normal file
View file

@ -0,0 +1,22 @@
identifier: ubx_bmd360eval_nrf52811
name: UBX_BMD360EVAL_NRF52811
type: mcu
arch: arm
toolchain:
- zephyr
- gnuarmemb
- xtools
ram: 24
flash: 192
supported:
- adc
- arduino_gpio
- arduino_i2c
- arduino_spi
- gpio
- counter
- nvs
- i2c
- pwm
- spi
- watchdog

30
boards/arm/ubx_bmd360eval_nrf52811/ubx_bmd360eval_nrf52811_defconfig Normal file
View file

@ -0,0 +1,30 @@
# BMD-360-EVAL board configuration
# Copyright (c) 2021 u-blox AG
# SPDX-License-Identifier: Apache-2.0
CONFIG_SOC_SERIES_NRF52X=y
CONFIG_SOC_NRF52811_QFAA=y
CONFIG_BOARD_UBX_BMD360EVAL_NRF52811=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

1
tests/drivers/adc/adc_api/src/test_adc.c
View file

@ -53,6 +53,7 @@
defined(CONFIG_BOARD_UBX_BMD300EVAL_NRF52832) || \ defined(CONFIG_BOARD_UBX_BMD300EVAL_NRF52832) || \
defined(CONFIG_BOARD_UBX_BMD330EVAL_NRF52810) || \ defined(CONFIG_BOARD_UBX_BMD330EVAL_NRF52810) || \
defined(CONFIG_BOARD_UBX_BMD340EVAL_NRF52840) || \ defined(CONFIG_BOARD_UBX_BMD340EVAL_NRF52840) || \
defined(CONFIG_BOARD_UBX_BMD360EVAL_NRF52811) || \
defined(CONFIG_BOARD_UBX_BMD380EVAL_NRF52840) defined(CONFIG_BOARD_UBX_BMD380EVAL_NRF52840)
#include <hal/nrf_saadc.h> #include <hal/nrf_saadc.h>