1.. _nrf51_blenano:
2
3Redbear Labs Nano
4#################
5
6Overview
7********
8
9The Nano is a development board equipped with Nordic's nRF51822 Bluetooth Low Energy SOC.
10This board is available on `RedBear Store`_.
11
12Hardware
13********
14
15nRF51 BLE Nano has two external oscillators. The frequency of the slow clock
16is 32.768 kHz. The frequency of the main clock is 16 MHz.
17
18Supported Features
19==================
20
21The nrf51_blenano board configuration supports the following nRF51
22hardware features:
23
24+-----------+------------+----------------------+
25| Interface | Controller | Driver/Component     |
26+===========+============+======================+
27| NVIC      | on-chip    | nested vectored      |
28|           |            | interrupt controller |
29+-----------+------------+----------------------+
30| RTC       | on-chip    | system clock         |
31+-----------+------------+----------------------+
32| UART      | on-chip    | serial port          |
33+-----------+------------+----------------------+
34| GPIO      | on-chip    | gpio                 |
35+-----------+------------+----------------------+
36| FLASH     | on-chip    | flash                |
37+-----------+------------+----------------------+
38| RADIO     | on-chip    | Bluetooth            |
39+-----------+------------+----------------------+
40
41Connections and IOs
42====================
43
44BLE nano pinout
45
46.. image:: img/nrf51_blenano.jpg
47   :align: center
48   :alt: BLE Nano
49
50DAPLink board
51
52.. image:: img/daplink.jpg
53   :align: center
54   :alt: DAPLink
55
56The DAPLink USB board acts as a dongle. DAPLink debug probes appear on the host computer as a USB disk.
57It also regulates 5V from USB to 3.3V via the onboard LDO to power Nano.
58
59More information about Nano and DAPLink can be found at the `RedBear Github`_.
60
61Programming and Debugging
62*************************
63
64Applications for the ``nrf51_blenano`` board configuration can be built and
65flashed in the usual way (see :ref:`build_an_application` and
66:ref:`application_run` for more details).
67
68Flashing
69========
70
71To flash an application, you'll need to connect your BLE Nano with the
72DAPLink board, then attach that to your computer via USB.
73
74.. warning::
75
76   Be careful to mount the BLE Nano correctly! The side of the board
77   with the VIN and GND pins should face **towards** the USB connector.
78   The `RedBear Store`_ page links to a tutorial video that shows how to
79   properly solder headers and assemble the DAPLink and BLE Nano boards.
80
81Now build and flash applications as usual. Here is an example for the
82:ref:`hello_world` application.
83
84.. zephyr-app-commands::
85   :zephyr-app: samples/hello_world
86   :board: nrf51_blenano
87   :goals: build flash
88
89Debugging
90=========
91
92After mounting the BLE Nano on its DAPLink board as described above,
93you can debug an application in the usual way. Here is an example for
94the :ref:`hello_world` application.
95
96.. zephyr-app-commands::
97   :zephyr-app: samples/hello_world
98   :board: nrf51_blenano
99   :maybe-skip-config:
100   :goals: debug
101
102References
103**********
104
105.. target-notes::
106
107.. _RedBear Store: https://redbear.cc/product/ble-nano-kit.html
108.. _RedBear Github: https://github.com/redbear/nRF5x
109