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:
ADC
CLOCK
FLASH
GPIO
I2C
MPU
NVIC
PWM
RADIO (Bluetooth Low Energy and 802.15.4)
RTC
SPI
UART
USB
WDT
COUNTER
More information about the board is available at https://gitlab.com/electronutlabs-public/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 supports the hardware features listed below.
- on-chip / on-board
- Feature integrated in the SoC / present on the board.
- 2 / 2
-
Number of instances that are enabled / disabled.
Click on the label to see the first instance of this feature in the board/SoC DTS files. -
vnd,foo -
Compatible string for the Devicetree binding matching the feature.
Click on the link to view the binding documentation.
nrf52840_papyr/nrf52840 target
Type |
Location |
Description |
Compatible |
|---|---|---|---|
CPU |
on-chip |
ARM Cortex-M4F CPU1 |
|
ADC |
on-chip |
Nordic Semiconductor nRF family SAADC node1 |
|
ARM architecture |
on-chip |
Nordic UICR (User Information Configuration Registers)1 |
|
on-chip |
Nordic EGU (Event Generator Unit)6 |
||
on-chip |
Nordic nRF family ACL (Access Control List)1 |
||
on-chip |
Nordic nRF family MWU (Memory Watch Unit)1 |
||
Audio |
on-chip |
Nordic PDM (Pulse Density Modulation interface)1 |
|
Clock control |
on-chip |
Nordic nRF clock control node1 |
|
Comparator |
on-chip |
Nordic nRF COMP (analog COMParator)1 |
|
Counter |
on-chip |
Nordic nRF timer node5 |
|
Cryptographic accelerator |
on-chip |
Nordic ECB (AES electronic codebook mode encryption)1 |
|
on-chip |
Nordic nRF family CCM (AES CCM mode encryption)1 |
||
on-chip |
ARM TrustZone CryptoCell 3101 |
||
Debug |
on-chip |
ARMv7 instrumentation trace macrocell1 |
|
Flash controller |
on-chip |
Nordic NVMC (Non-Volatile Memory Controller)1 |
|
on-chip |
Properties defining the interface for the Nordic QSPI peripheral1 |
||
GPIO & Headers |
on-chip |
NRF5 GPIOTE1 |
|
on-chip |
NRF5 GPIO2 |
||
I2C |
on-chip |
Nordic nRF family TWI (TWI master)1 |
|
on-chip |
Nordic nRF family TWIM (TWI master with EasyDMA)1 |
||
I2S |
on-chip |
Nordic I2S (Inter-IC sound interface)1 |
|
IEEE 802.15.4 |
on-chip |
Nordic nRF IEEE 802.15.4 node1 |
|
Input |
on-board |
Group of GPIO-bound input keys1 |
|
Interrupt controller |
on-chip |
ARMv7-M NVIC (Nested Vectored Interrupt Controller)1 |
|
LED |
on-board |
Group of GPIO-controlled LEDs1 |
|
on-board |
Group of PWM-controlled LEDs1 |
||
Miscellaneous |
on-chip |
Nordic FICR (Factory Information Configuration Registers)1 |
|
on-chip |
Nordic nRF family PPI (Programmable Peripheral Interconnect)1 |
||
MTD |
on-chip |
Flash node1 |
|
on-chip |
Fixed partitions of a flash (or other non-volatile storage) memory1 |
||
Networking |
on-chip |
Nordic nRF family RADIO peripheral1 |
|
on-chip |
Nordic nRF family NFCT (Near Field Communication Tag)1 |
||
Pin control |
on-chip |
The nRF pin controller is a singleton node responsible for controlling pin function selection and pin properties1 |
|
Power management |
on-chip |
Nordic nRF power control node1 |
|
PWM |
on-chip |
||
on-chip |
nRFx S/W PWM1 |
||
Regulator |
on-chip |
Nordic nRF5X regulator (fixed stage of the core supply)1 |
|
on-chip |
Nordic nRF52X regulator (high voltage stage of the main supply)1 |
||
Retained memory |
on-chip |
Nordic GPREGRET (General Purpose Register Retention) device2 |
|
RNG |
on-chip |
Nordic nRF family RNG (Random Number Generator)1 |
|
RTC |
on-chip |
Nordic nRF RTC (Real-Time Counter)3 |
|
Sensors |
on-chip |
Nordic nRF family TEMP node1 |
|
on-chip |
Nordic nRF quadrature decoder (QDEC) node1 |
||
Serial controller |
on-chip |
Nordic nRF family UART1 |
|
on-chip |
Nordic nRF family UARTE (UART with EasyDMA)1 |
||
SPI |
on-chip |
Nordic nRF family SPIM (SPI master with EasyDMA)3 |
|
on-chip |
Nordic nRF family SPI (SPI master)1 |
||
SRAM |
on-chip |
Generic on-chip SRAM description1 |
|
Timer |
on-chip |
ARMv7-M System Tick1 |
|
USB |
on-chip |
Nordic nRF52 USB device controller1 |
|
Watchdog |
on-chip |
Nordic nRF family WDT (Watchdog Timer)1 |
Connections and IOs
LED
LED1 (green) = P0.13
LED2 (blue) = P0.15
LED3 (red) = P0.14
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 Building an Application
and Run an Application 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 Building an Application and Run an Application for more details).
Here is an example for the Hello World application.
First, run your favorite terminal program to listen for output.
$ minicom -D <tty_device> -b 115200
Replace <tty_device> with the serial port of Black Magic Probe.
For example, under Linux, /dev/ttyACM1.
Then build and flash the application in the usual way.
# From the root of the zephyr repository
west build -b nrf52840_papyr samples/hello_world
west 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)