xref: /openbmc/qemu/docs/system/arm/stm32.rst (revision cffaca0f)
1STMicroelectronics STM32 boards (``netduino2``, ``netduinoplus2``, ``stm32vldiscovery``)
2========================================================================================
3
4The `STM32`_ chips are a family of 32-bit ARM-based microcontroller by
5STMicroelectronics.
6
7.. _STM32: https://www.st.com/en/microcontrollers-microprocessors/stm32-32-bit-arm-cortex-mcus.html
8
9The STM32F1 series is based on ARM Cortex-M3 core. The following machines are
10based on this chip :
11
12- ``stm32vldiscovery``  STM32VLDISCOVERY board with STM32F100RBT6 microcontroller
13
14The STM32F2 series is based on ARM Cortex-M3 core. The following machines are
15based on this chip :
16
17- ``netduino2``         Netduino 2 board with STM32F205RFT6 microcontroller
18
19The STM32F4 series is based on ARM Cortex-M4F core. This series is pin-to-pin
20compatible with STM32F2 series. The following machines are based on this chip :
21
22- ``netduinoplus2``     Netduino Plus 2 board with STM32F405RGT6 microcontroller
23- ``olimex-stm32-h405`` Olimex STM32 H405 board with STM32F405RGT6 microcontroller
24
25There are many other STM32 series that are currently not supported by QEMU.
26
27Supported devices
28-----------------
29
30 * ARM Cortex-M3, Cortex M4F
31 * Analog to Digital Converter (ADC)
32 * EXTI interrupt
33 * Serial ports (USART)
34 * SPI controller
35 * System configuration (SYSCFG)
36 * Timer controller (TIMER)
37
38Missing devices
39---------------
40
41 * Camera interface (DCMI)
42 * Controller Area Network (CAN)
43 * Cycle Redundancy Check (CRC) calculation unit
44 * Digital to Analog Converter (DAC)
45 * DMA controller
46 * Ethernet controller
47 * Flash Interface Unit
48 * GPIO controller
49 * I2C controller
50 * Inter-Integrated Sound (I2S) controller
51 * Power supply configuration (PWR)
52 * Random Number Generator (RNG)
53 * Real-Time Clock (RTC) controller
54 * Reset and Clock Controller (RCC)
55 * Secure Digital Input/Output (SDIO) interface
56 * USB OTG
57 * Watchdog controller (IWDG, WWDG)
58
59Boot options
60------------
61
62The STM32 machines can be started using the ``-kernel`` option to load a
63firmware. Example:
64
65.. code-block:: bash
66
67  $ qemu-system-arm -M stm32vldiscovery -kernel firmware.bin
68