Exceptionally, this wiki is under maintenance.

You can continue to browse it to discover the STM32MP1 series and associated ecosystems (STM32 boards, embedded software, development tools, trace & debug tools...) but contributors can not improve their favorite articles, during phase.

Thank you for your understanding.

STM32MP13 ADC internal peripheral

Applicable for STM32MP13x lines

1 Article purpose[edit]

The purpose of this article is to

  • briefly introduce the ADC peripheral and its main features
  • indicate the level of security supported by this hardware block
  • explain how each instance can be allocated to the runtime contexts and linked to the corresponding software components
  • explain how to configure the ADC peripheral.

2 Peripheral overview[edit]

The STM32 ADC is a successive approximation analog-to-digital converter.

2.1 Features[edit]

The STM32MP13x SoCs have two ADC blocks, except for the STM32MP131 SoC which has only one ADC block. There is one physical ADC per block:

  • Each ADC has up to 19 multiplexed channels (including 6 internal channels available only on ADC2).
  • Configurable resolution: 6, 8, 10, 12 bits.
  • The conversions can be performed in single, continuous, scan or discontinuous mode.
  • The result can be read in a left- or right-aligned 32-bit data register by using CPU or DMA[1].
  • The analog watchdog feature allows the application to detect if the input voltage goes beyond the user-defined, high or low thresholds.
  • Each ADC clock can be selected between two different clock[2] sources (Synchronous or Asynchronous clock).
  • The common reference voltage can be provided by either VREFBUF[3] or any other external regulator[4] wired to VREF+ pin.

Each ADC supports two contexts to manage conversions:

  • Regular conversions can be done in sequence, running in background
  • Injected conversions have higher priority, and so have the ability to interrupt the regular sequence (either triggered in SW or HW). The regular sequence is resumed, in case it has been interrupted.
  • Each context has its own configurable sequence and trigger: software, TIM[5], LPTIM[6] and EXTI[7].

Refer to STM32MP13 reference manuals for the complete features list, and to the software components, introduced below, to know which features are really implemented.

2.2 Security support[edit]

Both ADC1 and ADC2 are secure peripherals (under ETZPC control).

3 Peripheral usage and associated software[edit]

3.1 Boot time[edit]

The ADC is usually not used at boot time. But it may be used by the SSBL (see Boot chain overview), to check for power supplies for example.


3.2 Runtime[edit]

3.2.1 Overview[edit]

The ADCs can be allocated to:

  • the Arm® Cortex®-A7 non-secure core to be used under Linux® with IIO framework.

or

  • the Arm® Cortex®-A7 secure core.


The Peripheral assignment chapter describes which peripheral instance can be assigned to which context.

3.2.2 Software frameworks[edit]

Domain Peripheral Software components Comment
OP-TEE Linux
Analog ADC IIO framework


3.2.3 Peripheral configuration[edit]

The configuration is applied by the firmware running in the context to which the peripheral is assigned. The configuration by itself can be performed via the STM32CubeMX tool for all internal peripherals. It can then be manually completed (especially for external peripherals) according to the information given in the corresponding software framework article.

For the Linux kernel configuration, please refer to ADC device tree configuration and ADC OpenSTLinux drivers articles.

3.2.4 Peripheral assignment[edit]

Click on the right to expand the legend...

STM32MP13IPsOverview.png

Check boxes illustrate the possible peripheral allocations supported by STM32 MPU Embedded Software:

  • means that the peripheral can be assigned () to the given runtime context.
  • means that the peripheral can be assigned to the given runtime context, but this configuration is not supported in STM32 MPU Embedded Software distribution.
  • is used for system peripherals that cannot be unchecked because they are statically connected in the device.

Refer to How to assign an internal peripheral to an execution context for more information on how to assign peripherals manually or via STM32CubeMX.
The present chapter describes STMicroelectronics recommendations or choice of implementation. Additional possiblities might be described in STM32MP13 reference manuals.

Domain Peripheral Runtime allocation Comment
Instance Cortex-A7
secure
(OP-TEE)
Cortex-A7
non-secure
(Linux)
Analog ADC ADC1 Assignment (single choice)
ADC2 Assignment (single choice)
ADC2 can be used for system supplies monitoring

4 How to go further[edit]

See application notes:

  • How to get the best ADC accuracy in STM32[8].

5 References[edit]