1.. zephyr:board:: nrf51_vbluno51
2
3Overview
4********
5
6Zephyr uses the nrf51_vbluno51 board configuration to run on the VBLUno51 board,
7a VNG Bluetooth Low Energy UNO using an nRF51822 ARM processor.
8
9.. figure:: img/nrf51_vbluno51_bot.jpg
10     :align: center
11     :alt: nRF51_VBLUno51 Bottom
12
13     nrf51_vbluno51 Bottom
14
15More information about the board can be found at the
16`VBLUno51 wiki page`_.
17
18Hardware
19********
20
21VBLUno51 board has two external oscillators. The frequency of
22the slow clock is 32.768 kHz. The frequency of the main clock
23is 16 MHz.
24
25Supported Features
26==================
27
28- CPU:
29	+ Nordic nRF51822: ARM |reg| Cortex |trade| M0 32bit.
30	+ *Bluetooth Low Energy interface.*
31	+ 256KB Flash, 32KB RAM.
32	+ UART(1), I2C(2), SPI(1), PWM(3), SWD, Timer 16bit(3).
33	+ 21 digital channels, 6 ADC 10bit channels.
34	+ 1 Led and 1 Button onboard.
35	+ GPIO Voltage: 0 - 3.3V.
36- DAPLink (CMSIS-DAP) interface for program and debug:
37	+ USB MSD: Drag and Drop programming flash memory.
38	+ USB HID (DAP): CMSIS-DAP compliant debug channel.
39	+ USB CDC: Virtual COM port for log, trace and terminal emulation.
40
41- Supports hardware flow control features (RTS/CTS).
42- *Energy monitoring for BLE module by current measurement (Only VBLUno51_EM)*
43- FOTA (Firmware over the air): Upgrade firmware over BLE interface.
44- Build good applications with:
45	+ Compiler and IDE: GCC, Keil MDK, IAR, Eclipse, Qt Creator.
46	+ Frameworks: Arduino, ARM mbed-OS, Zephyr-OS, Nordic SDK, RIOT-OS, MyNewt-OS, ChibiOS, NuttX RTOS
47	+ A lot of tutorials for Arduino, mbed-os and more.
48- Pinout: Arduino Uno Rev3 compliant.
49- Power:
50	+ USB port.
51	+ Power adapter: +9 -> +12V.
52	+ 3V Battery: CR20xx holder
53	+ Rechargeable battery jump: +3.7 -> +12V
54- Open source: Hardware design, firmware, packages, tutorial and example codes
55
56See `VBLUno51 wiki page`_ for full documents and tutorials about the VBLUno51 board.
57
58Connections and IOs
59===================
60
61LED
62---
63
64* LED = LED0 (green) = P0.7
65
66Push buttons
67------------
68
69* BUTTON = BUT = SW0 = P0.15
70
71More details
72------------
73
74.. figure:: img/vbluno51_nordic_pinout.jpg
75     :align: center
76     :alt: nRF51_VBLUno51 Pinout
77
78     nrf51_vbluno51 Pinout
79
80.. figure:: img/vbluno51_frizting.jpg
81     :align: center
82     :alt: nRF51_VBLUno51 Fritzing part
83
84     nrf51_vbluno51 Fritzing part
85
86Programming and Debugging
87*************************
88
89Applications for the ``nrf51_vbluno51`` board configuration can be
90built and flashed in the usual way (see :ref:`build_an_application`
91and :ref:`application_run` for more details).
92
93Flashing
94========
95
96The VBLUno51 board has on-board DAPLink (CMSIS-DAP) interface for flashing and debugging.
97You do not need any other programming device.
98You only need to install pyOCD tool (https://pypi.python.org/pypi/pyOCD)
99
100This tutorial uses the blinky application :zephyr:code-sample:`blinky`.
101
102See the :ref:`getting_started` for general information on setting up
103your development environment. Then build and flash the application in
104the usual way.
105
106.. zephyr-app-commands::
107   :zephyr-app: samples/basic/blinky
108   :board: nrf51_vbluno51
109   :goals: build flash
110
111Debugging
112=========
113
114You can debug an application in the usual way.  Here is an example for the
115:zephyr:code-sample:`blinky` application.
116
117.. zephyr-app-commands::
118   :zephyr-app: samples/basic/blinky
119   :board: nrf51_vbluno51
120   :maybe-skip-config:
121   :goals: debug
122
123Testing the VBLUno51 with Zephyr: buttons, LEDs, UART, BLE
124**********************************************************
125
126 Here are some sample applications that you can use to test different
127 components on the VBLUno51 board:
128
129 * :zephyr:code-sample:`hello_world`
130 * :zephyr:code-sample:`blinky`
131 * :zephyr:code-sample:`button`
132 * :zephyr:code-sample:`bluetooth_beacon`
133 * :zephyr:code-sample:`ble_peripheral_hr`
134
135References
136**********
137
138.. target-notes::
139
140.. _VBLUno51 website: http://iotviet.com.vn/store/detail?id=2
141.. _VBLUno51 wiki page: https://vngiotlab.github.io/vbluno/
142