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