docs/system/arm/nrf.rst

   1 Nordic nRF boards (``microbit``)
   2 ================================
   3
   4 The `Nordic nRF`_ chips are a family of ARM-based System-on-Chip that
   5 are designed to be used for low-power and short-range wireless solutions.
   6
   7 .. _Nordic nRF: https://www.nordicsemi.com/Products
   8
   9 The nRF51 series is the first series for short range wireless applications.
  10 It is superseded by the nRF52 series.
  11 The following machines are based on this chip :
  12
  13 - ``microbit``       BBC micro:bit board with nRF51822 SoC
  14
  15 There are other series such as nRF52, nRF53 and nRF91 which are currently not
  16 supported by QEMU.
  17
  18 Supported 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
  30 Missing 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
  41 Boot options
  42 ------------
  43
  44 The Micro:bit machine can be started using the ``-device`` option to load a
  45 firmware 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