aboutsummaryrefslogtreecommitdiff
path: root/docs/system/arm/nrf.rst
blob: eda87bd7602e33b1b78535ccea6736b7c1a518b6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
Nordic nRF boards (``microbit``)
================================

The `Nordic nRF`_ chips are a family of ARM-based System-on-Chip that
are designed to be used for low-power and short-range wireless solutions.

.. _Nordic nRF: https://www.nordicsemi.com/Products

The nRF51 series is the first series for short range wireless applications.
It is superseded by the nRF52 series.
The following machines are based on this chip :

- ``microbit``       BBC micro:bit board with nRF51822 SoC

There are other series such as nRF52, nRF53 and nRF91 which are currently not
supported by QEMU.

Supported devices
-----------------

 * ARM Cortex-M0 (ARMv6-M)
 * Serial ports (UART)
 * Clock controller
 * Timers
 * Random Number Generator (RNG)
 * GPIO controller
 * NVMC
 * SWI

Missing devices
---------------

 * Watchdog
 * Real-Time Clock (RTC) controller
 * TWI (i2c)
 * SPI controller
 * Analog to Digital Converter (ADC)
 * Quadrature decoder
 * Radio

Boot options
------------

The Micro:bit machine can be started using the ``-device`` option to load a
firmware in `ihex format`_. Example:

.. _ihex format: https://en.wikipedia.org/wiki/Intel_HEX

.. code-block:: bash

  $ qemu-system-arm -M microbit -device loader,file=test.hex