1.. zephyr:board:: bbc_microbit
2
3Overview
4********
5
6The Micro Bit (also referred to as BBC Micro Bit, stylized as micro:bit) is an
7ARM-based embedded system designed by the BBC for use in computer education in
8the UK.
9
10The board is 4 cm × 5 cm and has an ARM Cortex-M0 processor, accelerometer and
11magnetometer sensors, Bluetooth and USB connectivity, a display consisting of
1225 LEDs, two programmable buttons, and can be powered by either USB or an
13external battery pack. The device inputs and outputs are through five ring
14connectors that are part of the 23-pin edge connector.
15
16* :abbr:`NVIC (Nested Vectored Interrupt Controller)`
17* :abbr:`RTC (nRF RTC System Clock)`
18* UART
19* GPIO
20* FLASH
21* RADIO (Bluetooth Low Energy)
22
23More information about the board can be found at the `microbit website`_.
24
25Hardware
26********
27
28The micro:bit has the following physical features:
29
30* 25 individually-programmable LEDs
31* 2 programmable buttons
32* Physical connection pins
33* Light and temperature sensors
34* Motion sensors (accelerometer and compass)
35* Wireless Communication, via Radio and Bluetooth
36* USB interface
37
38
39Supported Features
40==================
41
42The bbc_microbit board configuration supports the following nRF51
43hardware features:
44
45+-----------+------------+----------------------+
46| Interface | Controller | Driver/Component     |
47+===========+============+======================+
48| NVIC      | on-chip    | nested vectored      |
49|           |            | interrupt controller |
50+-----------+------------+----------------------+
51| RTC       | on-chip    | system clock         |
52+-----------+------------+----------------------+
53| UART      | on-chip    | serial port          |
54+-----------+------------+----------------------+
55| GPIO      | on-chip    | gpio                 |
56+-----------+------------+----------------------+
57| FLASH     | on-chip    | flash                |
58+-----------+------------+----------------------+
59| RADIO     | on-chip    | Bluetooth            |
60+-----------+------------+----------------------+
61
62Programming and Debugging
63*************************
64
65Flashing
66========
67
68Build and flash applications as usual (see :ref:`build_an_application` and
69:ref:`application_run` for more details).
70
71Here is an example for the :zephyr:code-sample:`hello_world` application.
72
73First, run your favorite terminal program to listen for output.
74
75.. code-block:: console
76
77   $ minicom -D <tty_device> -b 115200
78
79Replace :code:`<tty_device>` with the port where the board nRF51 DK
80can be found. For example, under Linux, :code:`/dev/ttyACM0`.
81
82Then build and flash the application in the usual way.
83
84.. zephyr-app-commands::
85   :zephyr-app: samples/hello_world
86   :board: bbc_microbit
87   :goals: build flash
88
89
90References
91**********
92
93.. target-notes::
94
95.. _microbit website: http://www.microbit.org/
96