xref: /openbmc/qemu/docs/system/arm/nrf.rst (revision b14df228)
1Nordic nRF boards (``microbit``)
2================================
3
4The `Nordic nRF`_ chips are a family of ARM-based System-on-Chip that
5are designed to be used for low-power and short-range wireless solutions.
6
7.. _Nordic nRF: https://www.nordicsemi.com/Products
8
9The nRF51 series is the first series for short range wireless applications.
10It is superseded by the nRF52 series.
11The following machines are based on this chip :
12
13- ``microbit``       BBC micro:bit board with nRF51822 SoC
14
15There are other series such as nRF52, nRF53 and nRF91 which are currently not
16supported by QEMU.
17
18Supported devices
19-----------------
20
21 * ARM Cortex-M0 (ARMv6-M)
22 * Serial ports (UART)
23 * Clock controller
24 * Timers
25 * Random Number Generator (RNG)
26 * GPIO controller
27 * NVMC
28 * SWI
29
30Missing devices
31---------------
32
33 * Watchdog
34 * Real-Time Clock (RTC) controller
35 * TWI (i2c)
36 * SPI controller
37 * Analog to Digital Converter (ADC)
38 * Quadrature decoder
39 * Radio
40
41Boot options
42------------
43
44The Micro:bit machine can be started using the ``-device`` option to load a
45firmware in `ihex format`_. Example:
46
47.. _ihex format: https://en.wikipedia.org/wiki/Intel_HEX
48
49.. code-block:: bash
50
51  $ qemu-system-arm -M microbit -device loader,file=test.hex
52