| 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 |