boards: Add support for Blue Clover PLT Demo V2

Added boards/arm/blueclover_plt_demo_v2_nrf52832.

Signed-off-by: Jeremy Wood <jeremy@bcdevices.com>
This commit is contained in:
Jeremy Wood 2021-12-13 18:07:21 -08:00 committed by Carles Cufí
commit 07056736fc
9 changed files with 376 additions and 0 deletions

View file

@ -0,0 +1,10 @@
# Blue Clover PLT Demo V2 Configuration
# Copyright (c) 2021 Blue Clover
# SPDX-License-Identifier: Apache-2.0
config BOARD_ENABLE_DCDC
bool "Enable DCDC mode"
select SOC_DCDC_NRF52X
default y
depends on BOARD_BLUECLOVER_PLT_DEMO_V2_NRF52832

View file

@ -0,0 +1,8 @@
# Blue Clover PLT Demo V2 Configuration
# Copyright (c) 2021 Blue Clover
# SPDX-License-Identifier: Apache-2.0
config BOARD_BLUECLOVER_PLT_DEMO_V2_NRF52832
bool "Blue Clover PLT Demo Board V2"
depends on SOC_NRF52832_QFAA

View file

@ -0,0 +1,14 @@
# Blue Clover PLT Demo V2 Configuration
# Copyright (c) 2021 Blue Clover
# SPDX-License-Identifier: Apache-2.0
if BOARD_BLUECLOVER_PLT_DEMO_V2_NRF52832
config BOARD
default "blueclover_plt_demo_v2_nrf52832"
config BT_CTLR
default BT
endif # BOARD_BLUECLOVER_PLT_DEMO_V2_NRF52832

View file

@ -0,0 +1,133 @@
// SPDX-License-Identifier: Apache-2.0
/*
* Copyright (c) 2021 Blue Clover
*/
/dts-v1/;
#include <nordic/nrf52832_qfaa.dtsi>
/ {
model = "Blue Clover PLT Demo Board V2";
compatible = "nordic,blueclover-plt-demo-v2-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;
};
buttons {
compatible = "gpio-keys";
button0: button_0 {
gpios = <&gpio0 26 (GPIO_PULL_UP | GPIO_ACTIVE_LOW)>;
label = "Push button switch 0";
};
button1: button_1 {
gpios = <&gpio0 21 (GPIO_PULL_UP | GPIO_ACTIVE_LOW)>;
label = "Push button switch 1";
};
};
/* These aliases are provided for compatibility with samples */
aliases {
sw0 = &button0;
sw1 = &button1;
pwm-buzzer = &pwm0;
};
};
&gpiote {
status ="okay";
};
&gpio0 {
status ="okay";
};
&uart0 {
status = "okay";
compatible = "nordic,nrf-uart";
current-speed = <115200>;
tx-pin = <6>;
rx-pin = <8>;
};
&i2c0 {
compatible = "nordic,nrf-twi";
status = "okay";
sda-pin = <12>;
scl-pin = <14>;
sht3xd@44 {
compatible = "sensirion,sht3xd";
reg = <0x44>;
label = "SHT3XD";
};
bmi270@68 {
compatible = "bosch,bmi270";
reg = <0x68>;
label = "BMI270";
};
};
&pwm0 {
/* buzzer */
status = "okay";
ch0-pin = <22>;
ch0-inverted;
};
&spi1 {
compatible = "nordic,nrf-spi";
status = "okay";
sck-pin = <2>;
mosi-pin = <3>;
miso-pin = <27>; /* unused */
apa102@0 {
compatible = "apa,apa102";
reg = <0>;
spi-max-frequency = <5250000>;
label = "APA102";
};
};
&flash0 {
/*
* For more information, see:
* http://docs.zephyrproject.org/latest/guides/dts/index.html#flash-partitions
*/
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,19 @@
# SPDX-License-Identifier: Apache-2.0
identifier: blueclover_plt_demo_v2_nrf52832
name: Blue Clover PLT Demo Board V2
type: mcu
arch: arm
toolchain:
- zephyr
- gnuarmemb
- xtools
ram: 64
flash: 512
supported:
- ble
- counter
- nvs
- i2c
- pwm
- spi
- watchdog

View file

@ -0,0 +1,28 @@
# Kconfig - Blue Clover PLT Demo V2 Configuration
#
# Copyright (c) 2021 Blue Clover
#
# SPDX-License-Identifier: Apache-2.0
CONFIG_SOC_SERIES_NRF52X=y
CONFIG_SOC_NRF52832_QFAA=y
CONFIG_BOARD_BLUECLOVER_PLT_DEMO_V2_NRF52832=y
# Enable MPU
CONFIG_ARM_MPU=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

@ -0,0 +1,10 @@
# SPDX-License-Identifier: Apache-2.0
set(OPENOCD_NRF5_SUBFAMILY "nrf52")
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: 271 KiB

View file

@ -0,0 +1,154 @@
.. _blueclover_plt_demo_v2_nrf52832:
Blue Clover PLT Demo V2 nRF52832
################################
Overview
********
The Blue Clover PLT Demo V2 is an open source (OSWHA certified) hardware
product, featuring the Nordic Semiconductor nRF52832 ARM Cortex-M4F MCU
and several useful external peripherals.
The Nordic Semiconductor nRF52832 ARM Cortex-M4F MCU features the following:
* :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/blueclover_plt_demo_v2.png
:width: 614px
:align: center
:alt: Blue Clover PLT Demo V2 nRF52832
Hardware
********
- nRF52832 ARM Cortex-M4F processor at 64 MHz
- 512 KB flash memory and 64 KB of SRAM
- Bosch BMI270 IMU
- Sensiron SHT30 Humidity and Temperature sensor
- Murata PKLCS1212E4001R1 Piezo Buzzer
- Battery connector and charger for 3.7 V lithium polymer batteries
- 4 APA102C Addressable LEDs
- Reset button (can be configured as user button)
- 1 User button
- Tag-Connect TC2030-FP 6-pin Debug Connector
Supported Features
==================
The Blue Clover PLT Demo V2 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 |
+-----------+------------+----------------------+
| RTC | on-chip | system clock |
+-----------+------------+----------------------+
| RTT | Segger | console |
+-----------+------------+----------------------+
| SPI(M/S) | on-chip | spi |
+-----------+------------+----------------------+
| UART | on-chip | serial |
+-----------+------------+----------------------+
| WDT | on-chip | watchdog |
+-----------+------------+----------------------+
Connections and IOs
===================
Push buttons
------------
* RESET = P0.21
* STATUS = P0.26
UART
----
* TXD = P0.06
* RXD = P0.08
Power
-----
* USB-C Connector
* JST-PH Battery Connector
NFC
---
* U.FL Connector, on NFC1/P0.09, NFC2/P0.10
Programming and Debugging
*************************
Applications for the ``blueclover_plt_demo_v2_nrf52832`` board configuration
can be built and flashed in the usual way (see :ref:`build_an_application`
and :ref:`application_run` for more details).
Flashing
========
Flashing Zephyr onto the ``blueclover_plt_demo_v2_nrf52832`` board requires
an external programmer. The programmer is attached to the SWD header.
Build the Zephyr kernel and the :ref:`led_apa102_sample` sample application.
.. zephyr-app-commands::
:zephyr-app: samples/drivers/led_apa102
:board: blueclover_plt_demo_v2_nrf52832
:goals: build
:compact:
Flash the image.
.. zephyr-app-commands::
:zephyr-app: samples/drivers/led_apa102
:board: blueclover_plt_demo_v2_nrf52832
:goals: flash
:compact:
References
**********
.. target-notes::
.. _Blue Clover PLT Demo V2 Product site:
https://bcdevices.com/products/plt-demo-board
.. _Blue Clover PLT Demo V2 OSWHA Certification:
https://certification.oshwa.org/us002054.html
.. _Schematic, layout, and gerbers:
https://github.com/bcdevices/plt-docs/tree/master/PLT-DEMOv2