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

Add support for u-blox BMD-300-EVAL. Also includes BMD-301-EVAL
and BMD-350-EVAL. All share the nRF52832, and are functionally
equivalent to the nRF52dk_nrf52832 with the exception of not
having debug-in and the shield SWD header.

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_nrf52832.

Tested with blinky, button, and Bluetooth peripheral_hr
Corrected type in index.rst (should be nRF52dk_nrf52832, not ..810)

Signed-off-by: Bob Recny <bob.recny@u-blox.com>
This commit is contained in:
Bob Recny 2021-03-25 23:25:06 +00:00 committed by Anas Nashif
commit c36f0ca8af
11 changed files with 720 additions and 0 deletions

View file

@ -0,0 +1,10 @@
# BMD-300-EVAL, BMD-301-EVAL, and BMD-350-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_BMD300EVAL_NRF52832

View file

@ -0,0 +1,8 @@
# BMD-300-EVAL, BMD-301-EVAL, and BMD-350-EVAL board configuration
# Copyright (c) 2021 u-blox AG
# SPDX-License-Identifier: Apache-2.0
config BOARD_UBX_BMD300EVAL_NRF52832
bool "u-blox BMD-300-EVAL"
depends on SOC_NRF52832_QFAA

View file

@ -0,0 +1,14 @@
# BMD-300-EVAL, BMD-301-EVAL, and BMD-350-EVAL board configuration
# Copyright (c) 2021 u-blox AG
# SPDX-License-Identifier: Apache-2.0
if BOARD_UBX_BMD300EVAL_NRF52832
config BOARD
default "ubx_bmd300eval_nrf52832"
config BT_CTLR
default BT
endif # BOARD_UBX_BMD300EVAL_NRF52832

View file

@ -0,0 +1,11 @@
# BMD-300-EVAL, BMD-301-EVAL, and BMD-350-EVAL board configuration
# Copyright (c) 2021 u-blox AG
# SPDX-License-Identifier: Apache-2.0
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: 460 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 408 KiB

View file

@ -0,0 +1,399 @@
.. _ubx_bmd300eval_nrf52832:
u-blox EVK-BMD-30/35: BMD-300-EVAL, BMD-301-EVAL, and BMD-350-EVAL
##################################################################
Overview
********
The BMD-300-EVAL, BMD-301-EVAL, and BMD-350-EVAL hardware provides
support for the u-blox BMD-300, BMD-301, and BMD-350 Bluetooth 5
modules, based on the Nordic Semiconductor nRF52832 ARM Cortex-M4F
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-300-EVAL, BMD-301-EVAL, and BMD-350-EVAL share the same
pin headers and assignments. The boards are different only in
the module used on the board. The BMD-300 and BMD-301 modules
share the same footprint and differ only in the antenna. The
BMD-350 module utilizes the nRF52832 CIAA WLCSP package.
More information about the BMD-300-EVAL, BMD-301-EVAL, and
BMD-350-EVAL and the respective modules can be found at the
`u-blox website`_. All of the Nordic Semiconductor examples for
the nRF52 DK (nrf52dk_nrf52832) may be used without modification.
Hardware
********
The BMD-300/301/350 module on the board contains an internal
high-frequency oscillator at 32MHz. There is also a low frequency
(slow) oscillator of 32.768kHz. The module itself does not include
the slow crystal; however, the EVAL boards do.
.. 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-300/301/350-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-300/301/350-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-300-EVAL, BMD-301-EVAL, and BMD-350-EVAL share
the same pin headers and assignments.
The BMD-300-EVAL is shown here.
.. note::
The pin numbers noted below are referenced to
the pin 1 markings on the BMD-300/301/350-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-300/301/350 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-300/301/350 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-300/301/350 Functions |
+=======+==============+===========================+
| 1 | D7 | P0.18/TRACEDATA[0]/SWO |
+-------+--------------+---------------------------+
| 2 | D6 | P0.17 |
+-------+--------------+---------------------------+
| 3 | D5 | P0.16/TRACEDATA[1] |
+-------+--------------+---------------------------+
| 4 | D4 | P0.15/TRACEDATA[2] |
+-------+--------------+---------------------------+
| 5 | D3 | P0.14/TRACEDATA[3] |
+-------+--------------+---------------------------+
| 6 | D2 | P0.13 |
+-------+--------------+---------------------------+
| 7 | D1 (TX) | P0.12 |
+-------+--------------+---------------------------+
| 8 | D0 (RX) | P0.11 |
+-------+--------------+---------------------------+
Digital I/O (J6)
+-------+--------------+---------------------------+
| PIN # | Signal Name | BMD-300/301/350 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/TRACECLK |
+-------+--------------+---------------------------+
| 10 | D8 | P0.19 |
+-------+--------------+---------------------------+
J11
+-------+--------------+---------------------------+
| PIN # | Signal Name | BMD-300/301/350 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-300/301/350-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_bmd300eval_nrf52832
: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-330-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_bmd300eval_nrf52832/ubx_bmd300eval_nrf52832.dts`.
References
**********
.. target-notes::
.. _u-blox website: https://www.u-blox.com/en/product/bmd-3035-series-open-cpu

View file

@ -0,0 +1,228 @@
/*
* Copyright (c) 2020 u-blox AG
*
* SPDX-License-Identifier: Apache-2.0
*/
/dts-v1/;
#include <nordic/nrf52832_qfaa.dtsi>
/ {
model = "u-blox BMD-300-EVAL EVK nRF52832";
compatible = "u-blox, ubx_bmd300eval_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 {
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 {
status = "okay";
compatible = "nordic,nrf-uarte";
current-speed = <115200>;
tx-pin = <6>;
rx-pin = <8>;
rts-pin = <5>;
cts-pin = <7>;
};
arduino_i2c: &i2c0 {
compatible = "nordic,nrf-twi";
status = "okay";
sda-gpios = <&gpio0 26 0>;
scl-gpios = <&gpio0 27 0>;
};
&i2c1 {
compatible = "nordic,nrf-twi";
/* Cannot be used together with spi1. */
/* status = "okay"; */
sda-gpios = <&gpio0 30 0>;
scl-gpios = <&gpio0 31 0>;
};
&pwm0 {
status = "okay";
ch0-pin = <17>;
ch0-inverted;
};
&spi0 {
compatible = "nordic,nrf-spi";
/* Cannot be used together with i2c0. */
/* status = "okay"; */
sck-pin = <27>;
mosi-pin = <26>;
miso-pin = <28>;
};
&spi1 {
compatible = "nordic,nrf-spi";
status = "okay";
sck-pin = <31>;
mosi-pin = <30>;
miso-pin = <29>;
};
arduino_spi: &spi2 {
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 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_bmd300eval_nrf52832
name: UBX_BMD300EVAL_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,27 @@
# SPDX-License-Identifier: Apache-2.0
CONFIG_SOC_SERIES_NRF52X=y
CONFIG_SOC_NRF52832_QFAA=y
CONFIG_BOARD_UBX_BMD300EVAL_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

@ -50,6 +50,7 @@
defined(CONFIG_BOARD_PINNACLE_100_DVK) || \ defined(CONFIG_BOARD_PINNACLE_100_DVK) || \
defined(CONFIG_BOARD_ARDUINO_NANO_33_BLE) || \ defined(CONFIG_BOARD_ARDUINO_NANO_33_BLE) || \
defined(CONFIG_BOARD_BMD_345_EVAL) || \ defined(CONFIG_BOARD_BMD_345_EVAL) || \
defined(CONFIG_BOARD_UBX_BMD300EVAL_NRF52832) || \
defined(CONFIG_BOARD_UBX_BMD340EVAL_NRF52840) || \ defined(CONFIG_BOARD_UBX_BMD340EVAL_NRF52840) || \
defined(CONFIG_BOARD_UBX_BMD380EVAL_NRF52840) defined(CONFIG_BOARD_UBX_BMD380EVAL_NRF52840)