boards: arm: add Electronut labs papyr (nrf52840_papyr)
Added config for https://docs.electronut.in/papyr/ Signed-off-by: Tavish Naruka <tavishnaruka@gmail.com>
This commit is contained in:
parent
23ba884b2b
commit
df500c164c
10 changed files with 439 additions and 0 deletions
14
boards/arm/nrf52840_papyr/Kconfig
Normal file
14
boards/arm/nrf52840_papyr/Kconfig
Normal file
|
@ -0,0 +1,14 @@
|
|||
# Kconfig - Electronut Labs Papyr board configuration
|
||||
#
|
||||
# Copyright (c) 2018 Electronut Labs
|
||||
#
|
||||
# SPDX-License-Identifier: Apache-2.0
|
||||
|
||||
if BOARD_NRF52840_PAPYR
|
||||
|
||||
config BOARD_ENABLE_DCDC
|
||||
bool "Enable DCDC mode"
|
||||
select SOC_DCDC_NRF52X
|
||||
default y
|
||||
|
||||
endif # BOARD_NRF52840_PAPYR
|
9
boards/arm/nrf52840_papyr/Kconfig.board
Normal file
9
boards/arm/nrf52840_papyr/Kconfig.board
Normal file
|
@ -0,0 +1,9 @@
|
|||
# Kconfig - Electronut Labs Papyr board configuration
|
||||
#
|
||||
# Copyright (c) 2018 Electronut Labs
|
||||
#
|
||||
# SPDX-License-Identifier: Apache-2.0
|
||||
|
||||
config BOARD_NRF52840_PAPYR
|
||||
bool "NRF52840 PAPYR"
|
||||
depends on SOC_NRF52840_QIAA
|
50
boards/arm/nrf52840_papyr/Kconfig.defconfig
Normal file
50
boards/arm/nrf52840_papyr/Kconfig.defconfig
Normal file
|
@ -0,0 +1,50 @@
|
|||
# Kconfig - Electronut Labs Papyr board configuration
|
||||
#
|
||||
# Copyright (c) 2018 Electronut Labs
|
||||
#
|
||||
# SPDX-License-Identifier: Apache-2.0
|
||||
|
||||
if BOARD_NRF52840_PAPYR
|
||||
|
||||
config BOARD
|
||||
default "nrf52840_papyr"
|
||||
|
||||
if USB
|
||||
|
||||
config USB_NRF52840
|
||||
default y
|
||||
|
||||
config USB_DEVICE_STACK
|
||||
default y
|
||||
|
||||
endif # USB
|
||||
|
||||
if IEEE802154
|
||||
|
||||
config IEEE802154_NRF5
|
||||
default y
|
||||
|
||||
endif # IEEE802154
|
||||
|
||||
if PWM
|
||||
|
||||
config PWM_0
|
||||
default y
|
||||
|
||||
endif # PWM
|
||||
|
||||
if I2C
|
||||
|
||||
config I2C_0
|
||||
default y
|
||||
|
||||
endif # I2C
|
||||
|
||||
if SPI
|
||||
|
||||
config SPI_1
|
||||
default y
|
||||
|
||||
endif # SPI
|
||||
|
||||
endif # BOARD_NRF52840_PAPYR
|
1
boards/arm/nrf52840_papyr/board.cmake
Normal file
1
boards/arm/nrf52840_papyr/board.cmake
Normal file
|
@ -0,0 +1 @@
|
|||
include(${ZEPHYR_BASE}/boards/common/blackmagicprobe.board.cmake)
|
BIN
boards/arm/nrf52840_papyr/doc/img/nrf52840_papyr.jpg
Normal file
BIN
boards/arm/nrf52840_papyr/doc/img/nrf52840_papyr.jpg
Normal file
Binary file not shown.
After Width: | Height: | Size: 71 KiB |
195
boards/arm/nrf52840_papyr/doc/nrf52840_papyr.rst
Normal file
195
boards/arm/nrf52840_papyr/doc/nrf52840_papyr.rst
Normal file
|
@ -0,0 +1,195 @@
|
|||
.. _nrf52840_papyr:
|
||||
|
||||
Electronut Labs Papyr
|
||||
#####################
|
||||
|
||||
Overview
|
||||
********
|
||||
|
||||
Zephyr applications use the nrf52840_papyr board configuration
|
||||
to run on Electronut Labs Papyr hardware. It provides
|
||||
support for the Nordic Semiconductor nRF52840 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 and 802.15.4)
|
||||
* :abbr:`RTC (nRF RTC System Clock)`
|
||||
* :abbr:`SPI (Serial Peripheral Interface)`
|
||||
* :abbr:`UART (Universal asynchronous receiver-transmitter)`
|
||||
* :abbr:`USB (Universal Serial Bus)`
|
||||
* :abbr:`WDT (Watchdog Timer)`
|
||||
* COUNTER
|
||||
|
||||
.. figure:: img/nrf52840_papyr.jpg
|
||||
:width: 442px
|
||||
:align: center
|
||||
:alt: Electronut Labs Papyr
|
||||
|
||||
Electronut Labs Papyr (Credit: Electronut Labs)
|
||||
|
||||
More information about the board is available at https://docs.electronut.in/papyr/.
|
||||
|
||||
Hardware
|
||||
********
|
||||
|
||||
Papyr has two external oscillators. The frequency of
|
||||
the slow clock is 32.768 kHz. The frequency of the main clock
|
||||
is 32 MHz.
|
||||
|
||||
Supported Features
|
||||
==================
|
||||
|
||||
The nrf52840_papyr board configuration supports the following
|
||||
hardware features currently:
|
||||
|
||||
+-----------+------------+----------------------+
|
||||
| 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, |
|
||||
| | | ieee802154 |
|
||||
+-----------+------------+----------------------+
|
||||
| RTC | on-chip | system clock |
|
||||
+-----------+------------+----------------------+
|
||||
| SPI(M/S) | on-chip | spi |
|
||||
+-----------+------------+----------------------+
|
||||
| UART | on-chip | serial |
|
||||
+-----------+------------+----------------------+
|
||||
| USB | on-chip | usb |
|
||||
+-----------+------------+----------------------+
|
||||
| WDT | on-chip | watchdog |
|
||||
+-----------+------------+----------------------+
|
||||
|
||||
Connections and IOs
|
||||
===================
|
||||
|
||||
LED
|
||||
---
|
||||
|
||||
* LED1 (green) = P0.13
|
||||
* LED2 (blue) = P0.15
|
||||
* LED3 (red) = P0.14
|
||||
|
||||
Push buttons
|
||||
------------
|
||||
|
||||
* Reset = SW0 = P0.18 (can be used as GPIO also)
|
||||
|
||||
UART
|
||||
----
|
||||
|
||||
* TX = P0.8
|
||||
* RX = P0.7
|
||||
|
||||
I2C
|
||||
---
|
||||
|
||||
I2C pins connected to onboard sensors (I2C_0):
|
||||
|
||||
* SDA = P0.5
|
||||
* SCL = P0.6
|
||||
|
||||
SPI
|
||||
---
|
||||
|
||||
The e-paper display is connected to the chip via SPI on the following pins (SPI_1):
|
||||
|
||||
* SCK = P0.31
|
||||
* MOSI = P0.29
|
||||
* MISO = P1.1 (not used by the display)
|
||||
|
||||
NOTE: P1.1 is pin 33 in absolute enumeration.
|
||||
|
||||
Other pins used by the e-paper display are:
|
||||
|
||||
* E-ink enable = P0.11 (cuts off power to the display with MOSFET)
|
||||
* CS = P0.30
|
||||
* BUSY = P0.3
|
||||
* D/C = P0.28
|
||||
* RES = P0.2
|
||||
|
||||
Programming and Debugging
|
||||
*************************
|
||||
|
||||
Applications for the ``nrf52840_papyr`` board configuration can be
|
||||
built and flashed in the usual way (see :ref:`build_an_application`
|
||||
and :ref:`application_run` for more details); Black Magic
|
||||
Probe debugger presents itself as two USB-serial ports. On Linux,
|
||||
they may come up as ``/dev/ttyACM0`` and ``/dev/ttyACM1``. The first
|
||||
one of these (``/dev/ttyACM0`` here) is the debugger port.
|
||||
GDB can directly connect to this port without requiring a GDB server by specifying
|
||||
``target external /dev/ttyACM0``. The second port acts as a
|
||||
serial port, connected to the SoC.
|
||||
|
||||
Flashing
|
||||
========
|
||||
|
||||
By default, papyr is configured to be used with a blackmagicprobe compatible
|
||||
debugger (see _Bumpy).
|
||||
|
||||
Applications are flashed and run 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 serial port of Black Magic Probe.
|
||||
For example, under Linux, :code:`/dev/ttyACM1`.
|
||||
|
||||
Then build and flash the application in the usual way.
|
||||
|
||||
.. zephyr-app-commands::
|
||||
:zephyr-app: samples/hello_world
|
||||
:board: nrf52840_papyr
|
||||
:goals: build flash
|
||||
|
||||
Debugging
|
||||
=========
|
||||
|
||||
Debug and attach configurations are available using Black Magic Probe, and
|
||||
``ninja debug``, or ``ninja attach`` (or with ``make``) are available.
|
||||
|
||||
NOTE: You may need to press the reset button once after using ``ninja flash``
|
||||
to start executing the code. (not required with ``debug`` or ``attach``)
|
||||
|
||||
References
|
||||
**********
|
||||
|
||||
.. target-notes::
|
||||
|
||||
.. _Electronut Labs website: https://electronut.in
|
||||
.. _Store link: https://www.tindie.com/stores/ElectronutLabs/
|
||||
.. _Papyr website: https://docs.electronut.in/papyr/
|
||||
.. _Schematic: https://gitlab.com/electronutlabs-public/papyr/raw/master/hardware/papyr_schematic_v_0_3.pdf?inline=false
|
||||
.. _Datasheet: https://gitlab.com/electronutlabs-public/papyr/raw/master/papyr_v0.3_datasheet.pdf?inline=false
|
||||
.. _Nordic Semiconductor Infocenter: http://infocenter.nordicsemi.com/
|
||||
.. _Black Magic Probe website: https://github.com/blacksphere/blackmagic
|
||||
.. _Bumpy website: https://docs.electronut.in/bumpy/
|
||||
|
134
boards/arm/nrf52840_papyr/nrf52840_papyr.dts
Normal file
134
boards/arm/nrf52840_papyr/nrf52840_papyr.dts
Normal file
|
@ -0,0 +1,134 @@
|
|||
/*
|
||||
* Copyright (c) 2019 Ajay Meena <intajayk@gmail.com>
|
||||
*
|
||||
* SPDX-License-Identifier: Apache-2.0
|
||||
*/
|
||||
|
||||
/dts-v1/;
|
||||
#include <nordic/nrf52840_qiaa.dtsi>
|
||||
|
||||
/ {
|
||||
model = "Papyr";
|
||||
compatible = "nordic,pca10056-dk", "nordic,nrf52840-qiaa",
|
||||
"nordic,nrf52840";
|
||||
|
||||
chosen {
|
||||
zephyr,console = &uart0;
|
||||
zephyr,uart-mcumgr = &uart0;
|
||||
zephyr,sram = &sram0;
|
||||
zephyr,flash = &flash0;
|
||||
};
|
||||
|
||||
leds {
|
||||
compatible = "gpio-leds";
|
||||
led0: led_0 {
|
||||
gpios = <&gpio0 13 GPIO_INT_ACTIVE_LOW>;
|
||||
label = "Green LED 0";
|
||||
};
|
||||
led1: led_1 {
|
||||
gpios = <&gpio0 15 GPIO_INT_ACTIVE_LOW>;
|
||||
label = "Blue LED 1";
|
||||
};
|
||||
led2: led_2 {
|
||||
gpios = <&gpio0 14 GPIO_INT_ACTIVE_LOW>;
|
||||
label = "Red LED 2";
|
||||
};
|
||||
};
|
||||
|
||||
buttons {
|
||||
compatible = "gpio-keys";
|
||||
button0: button_0 {
|
||||
gpios = <&gpio0 18 GPIO_PUD_PULL_UP>;
|
||||
label = "Push button switch 0";
|
||||
};
|
||||
};
|
||||
|
||||
/* These aliases are provided for compatibility with samples */
|
||||
aliases {
|
||||
led0 = &led0;
|
||||
led1 = &led1;
|
||||
led2 = &led2;
|
||||
sw0 = &button0;
|
||||
};
|
||||
};
|
||||
|
||||
&adc {
|
||||
status ="ok";
|
||||
};
|
||||
|
||||
&gpiote {
|
||||
status ="ok";
|
||||
};
|
||||
|
||||
&gpio0 {
|
||||
status ="ok";
|
||||
};
|
||||
|
||||
&gpio1 {
|
||||
status ="ok";
|
||||
};
|
||||
|
||||
&uart0 {
|
||||
compatible = "nordic,nrf-uart";
|
||||
current-speed = <115200>;
|
||||
status = "ok";
|
||||
tx-pin = <8>;
|
||||
rx-pin = <7>;
|
||||
};
|
||||
|
||||
&i2c0 {
|
||||
status = "ok";
|
||||
sda-pin = <5>;
|
||||
scl-pin = <6>;
|
||||
};
|
||||
|
||||
&spi1 {
|
||||
status = "ok";
|
||||
sck-pin = <31>;
|
||||
mosi-pin = <29>;
|
||||
miso-pin = <33>;
|
||||
};
|
||||
|
||||
&pwm0 {
|
||||
status = "ok";
|
||||
ch0-pin = <13>;
|
||||
ch0-inverted;
|
||||
};
|
||||
|
||||
&flash0 {
|
||||
/*
|
||||
* For more information, see:
|
||||
* http://docs.zephyrproject.org/latest/devices/dts/flash_partitions.html
|
||||
*/
|
||||
partitions {
|
||||
compatible = "fixed-partitions";
|
||||
#address-cells = <1>;
|
||||
#size-cells = <1>;
|
||||
|
||||
boot_partition: partition@0 {
|
||||
label = "mcuboot";
|
||||
reg = <0x000000000 0x0000C000>;
|
||||
};
|
||||
slot0_partition: partition@c000 {
|
||||
label = "image-0";
|
||||
reg = <0x0000C000 0x000069000>;
|
||||
};
|
||||
slot1_partition: partition@75000 {
|
||||
label = "image-1";
|
||||
reg = <0x00075000 0x000069000>;
|
||||
};
|
||||
scratch_partition: partition@de000 {
|
||||
label = "image-scratch";
|
||||
reg = <0x000de000 0x0001e000>;
|
||||
};
|
||||
storage_partition: partition@fc000 {
|
||||
label = "storage";
|
||||
reg = <0x000fc000 0x00004000>;
|
||||
};
|
||||
};
|
||||
};
|
||||
|
||||
&usbd {
|
||||
compatible = "nordic,nrf-usbd";
|
||||
status = "ok";
|
||||
};
|
16
boards/arm/nrf52840_papyr/nrf52840_papyr.yaml
Normal file
16
boards/arm/nrf52840_papyr/nrf52840_papyr.yaml
Normal file
|
@ -0,0 +1,16 @@
|
|||
identifier: nrf52840_papyr
|
||||
name: Electronut Labs Papyr
|
||||
type: mcu
|
||||
arch: arm
|
||||
toolchain:
|
||||
- zephyr
|
||||
- gnuarmemb
|
||||
- xtools
|
||||
supported:
|
||||
- adc
|
||||
- usb_device
|
||||
- ble
|
||||
- ieee802154
|
||||
- pwm
|
||||
- watchdog
|
||||
- counter
|
19
boards/arm/nrf52840_papyr/nrf52840_papyr_defconfig
Normal file
19
boards/arm/nrf52840_papyr/nrf52840_papyr_defconfig
Normal file
|
@ -0,0 +1,19 @@
|
|||
CONFIG_ARM=y
|
||||
CONFIG_SOC_FAMILY_NRF=y
|
||||
CONFIG_SOC_SERIES_NRF52X=y
|
||||
CONFIG_SOC_NRF52840_QIAA=y
|
||||
CONFIG_BOARD_NRF52840_PAPYR=y
|
||||
|
||||
# Enable MPU
|
||||
CONFIG_ARM_MPU=y
|
||||
|
||||
# enable uart driver
|
||||
CONFIG_SERIAL=y
|
||||
CONFIG_UART_0_NRF_UART=y
|
||||
|
||||
# enable console
|
||||
CONFIG_CONSOLE=y
|
||||
CONFIG_UART_CONSOLE=y
|
||||
|
||||
# additional board options
|
||||
CONFIG_GPIO_AS_PINRESET=y
|
|
@ -33,6 +33,7 @@
|
|||
#elif defined(CONFIG_BOARD_NRF52_PCA10040) || \
|
||||
defined(CONFIG_BOARD_NRF52840_PCA10056) || \
|
||||
defined(CONFIG_BOARD_NRF52840_BLIP) || \
|
||||
defined(CONFIG_BOARD_NRF52840_PAPYR) || \
|
||||
defined(CONFIG_BOARD_BL652_DVK) || \
|
||||
defined(CONFIG_BOARD_BL654_DVK)
|
||||
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue