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