1.. zephyr:board:: holyiot_yj16019
2
3Overview
4********
5
6The `Holyiot`_ YJ-16019 hardware provides support for the Nordic
7Semiconductor nRF52832 ARM Cortex-M4 CPU and the following devices:
8
9* CLOCK
10* FLASH
11* :abbr:`GPIO (General Purpose Input Output)`
12* :abbr:`MPU (Memory Protection Unit)`
13* :abbr:`NVIC (Nested Vectored Interrupt Controller)`
14* :abbr:`PWM (Pulse Width Modulation)`
15* RADIO (Bluetooth Low Energy)
16* :abbr:`RTC (nRF RTC System Clock)`
17* Segger RTT (RTT Console)
18* :abbr:`WDT (Watchdog Timer)`
19
20The board is equipped with one LED, one push button, and is powered by
21a CR2032 coin cell. The `Nordic Semiconductor Infocenter`_
22contains the processor's information and the datasheet.
23
24Hardware
25********
26
27The nRF52832 of the Holyiot YJ-16019 is clocked by an external crystal with a frequency of 32 MHz
28(Y1). The 32.768 kHz crystal (Y2) shown on the board schematics is not mounted.
29
30Supported Features
31==================
32
33.. zephyr:board-supported-hw::
34
35Connections and IOs
36===================
37
38LED and push button
39-------------------
40
41* Push button = P0.28
42* LED = P0.29
43
44Programming and Debugging
45*************************
46
47Applications for the ``holyiot_yj16019`` board configuration can be
48built and flashed in the usual way (see :ref:`build_an_application`
49and :ref:`application_run` for more details); however, an external
50Segger J-Link is required since the board does not have any on-board
51debug IC.
52
53The following pins of the Segger J-Link must be connected to the following test
54pads on the PCB (see image):
55
56* VTref = VCC
57* GND = GND
58* SWDIO = SDO
59* SWCLK = SCK
60
61.. figure:: img/holyiot_yj16019_pcb.jpg
62     :align: center
63     :alt: Holyiot YJ-16019 PCB
64
65     Holyiot YJ-16019 PCB (Credit: Holyiot)
66
67Flashing
68========
69
70Follow the instructions in the :ref:`nordic_segger` page to install
71and configure all the necessary software. Further information can be
72found in :ref:`nordic_segger_flashing`. Then build and flash
73applications as usual (see :ref:`build_an_application` and
74:ref:`application_run` for more details).
75
76Here is an example for the :zephyr:code-sample:`blinky` application.
77
78.. zephyr-app-commands::
79   :zephyr-app: samples/basic/blinky
80   :board: holyiot_yj16019
81   :goals: build flash
82
83Debugging
84=========
85
86Refer to the :ref:`nordic_segger` page to learn about debugging Nordic
87nRF52x-based boards with a Segger debugger.
88
89
90Testing the LED and button on the Holyiot YJ-16019
91**************************************************
92
93There are 2 samples that allow you to test that the button and LED on
94the board are working properly with Zephyr:
95
96.. code-block:: console
97
98   samples/basic/blinky
99   samples/basic/button
100
101You can build and flash the examples to make sure Zephyr is running
102correctly on your board. The button and LED definitions can be found
103in :zephyr_file:`boards/holyiot/yj16019/holyiot_yj16019.dts`.
104
105References
106**********
107
108.. target-notes::
109
110.. _Holyiot: http://www.holyiot.com
111.. _Nordic Semiconductor Infocenter: https://infocenter.nordicsemi.com
112