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
33The holyiot_yj16019 board configuration supports the following
34hardware features:
35
36+-----------+------------+----------------------+
37| Interface | Controller | Driver/Component     |
38+===========+============+======================+
39| CLOCK     | on-chip    | clock_control        |
40+-----------+------------+----------------------+
41| FLASH     | on-chip    | flash                |
42+-----------+------------+----------------------+
43| GPIO      | on-chip    | gpio                 |
44+-----------+------------+----------------------+
45| MPU       | on-chip    | arch/arm             |
46+-----------+------------+----------------------+
47| NVIC      | on-chip    | arch/arm             |
48+-----------+------------+----------------------+
49| PWM       | on-chip    | pwm                  |
50+-----------+------------+----------------------+
51| RADIO     | on-chip    | Bluetooth            |
52+-----------+------------+----------------------+
53| RTC       | on-chip    | system clock         |
54+-----------+------------+----------------------+
55| RTT       | Segger     | console              |
56+-----------+------------+----------------------+
57| WDT       | on-chip    | watchdog             |
58+-----------+------------+----------------------+
59
60Other hardware features have not been enabled yet for this board.
61
62Connections and IOs
63===================
64
65LED and push button
66-------------------
67
68* Push button = P0.28
69* LED = P0.29
70
71Programming and Debugging
72*************************
73
74Applications for the ``holyiot_yj16019`` board configuration can be
75built and flashed in the usual way (see :ref:`build_an_application`
76and :ref:`application_run` for more details); however, an external
77Segger J-Link is required since the board does not have any on-board
78debug IC.
79
80The following pins of the Segger J-Link must be connected to the following test
81pads on the PCB (see image):
82
83* VTref = VCC
84* GND = GND
85* SWDIO = SDO
86* SWCLK = SCK
87
88.. figure:: img/holyiot_yj16019_pcb.jpg
89     :align: center
90     :alt: Holyiot YJ-16019 PCB
91
92     Holyiot YJ-16019 PCB (Credit: Holyiot)
93
94Flashing
95========
96
97Follow the instructions in the :ref:`nordic_segger` page to install
98and configure all the necessary software. Further information can be
99found in :ref:`nordic_segger_flashing`. Then build and flash
100applications as usual (see :ref:`build_an_application` and
101:ref:`application_run` for more details).
102
103Here is an example for the :zephyr:code-sample:`blinky` application.
104
105.. zephyr-app-commands::
106   :zephyr-app: samples/basic/blinky
107   :board: holyiot_yj16019
108   :goals: build flash
109
110Debugging
111=========
112
113Refer to the :ref:`nordic_segger` page to learn about debugging Nordic
114nRF52x-based boards with a Segger debugger.
115
116
117Testing the LED and button on the Holyiot YJ-16019
118**************************************************
119
120There are 2 samples that allow you to test that the button and LED on
121the board are working properly with Zephyr:
122
123.. code-block:: console
124
125   samples/basic/blinky
126   samples/basic/button
127
128You can build and flash the examples to make sure Zephyr is running
129correctly on your board. The button and LED definitions can be found
130in :zephyr_file:`boards/holyiot/yj16019/holyiot_yj16019.dts`.
131
132References
133**********
134
135.. target-notes::
136
137.. _Holyiot: http://www.holyiot.com
138.. _Nordic Semiconductor Infocenter: https://infocenter.nordicsemi.com
139