13. General-purpose I/Os (GPIO)

13.1 Introduction

Each general-purpose I/O port has four 32-bit configuration registers (GPIOx_MODER, GPIOx_OTYPER, GPIOx_OSPEEDR and GPIOx_PUPDR), two 32-bit data registers (GPIOx_IDR and GPIOx_ODR), a 16-bit reset register (GPIOx_BRR), and a 32-bit set/reset register (GPIOx_BSRR).

In addition, all GPIOs have a 32-bit locking register (GPIOx_LCKR), two 32-bit alternate function selection registers (GPIOx_AFRH and GPIOx_AFRL), a secure configuration register (GPIOx_SECCFGR), and a high-speed low-voltage register (GPIOx_HSLVR).

13.2 GPIO main features

13.3 GPIO functional description

Subject to the specific hardware characteristics of each I/O port listed in the datasheet, each port bit of the general-purpose I/O (GPIO) ports can be individually configured by software in several modes:

Each I/O port bit is freely programmable, however the I/O port registers must be accessed as 32-bit words, half-words, or bytes. The GPIOx_BSRR and GPIOx_BRR registers allow atomic read/modify accesses to any of the GPIOx_ODR registers. In this way, there is no risk of an IRQ occurring between the read and the modify access.

Figure 59 shows the basic structure of a 3- or 5-V tolerant GPIO (TT or FT). Table 125 gives the possible port bit configurations.

Figure 59. Structure of 3- or 5-V tolerant GPIO (TT or FT)

Figure 59: Structure of 3- or 5-V tolerant GPIO (TT or FT). The diagram shows the internal circuitry of a GPIO pin, divided into Analog and Digital sections. The Analog section includes an Analog IP, a parasitic diode and resistor connected to VDDA, and an analog switch. The Digital section includes an alternate function input, an input data register, an input buffer, an output data register, an alternate function output, an output control, and an output buffer. The output buffer consists of PMOS and NMOS transistors connected to VDD and VSS. The I/O pin is connected to the output buffer and includes ESD protection and pull-up/pull-down resistors (RPU, RPD) connected to VDD and VSS respectively. The diagram is labeled MSv46873V1.
Figure 59: Structure of 3- or 5-V tolerant GPIO (TT or FT). The diagram shows the internal circuitry of a GPIO pin, divided into Analog and Digital sections. The Analog section includes an Analog IP, a parasitic diode and resistor connected to VDDA, and an analog switch. The Digital section includes an alternate function input, an input data register, an input buffer, an output data register, an alternate function output, an output control, and an output buffer. The output buffer consists of PMOS and NMOS transistors connected to VDD and VSS. The I/O pin is connected to the output buffer and includes ESD protection and pull-up/pull-down resistors (RPU, RPD) connected to VDD and VSS respectively. The diagram is labeled MSv46873V1.

Note: On a TT GPIO, the analog switch is not present, it is replaced by a direct connection. The analog bloc parasitic circuitry does not allow 5-V tolerance.

Table 125. Port bit configuration (1)

MODE(i)[1:0]OTYPE(i)OSPEED(i)[1:0]PUPD(i)[1:0]I/O configuration
01
010SPEED[1:0]00GP outputPP
001GP outputPP + PU
010GP outputPP + PD
011Reserved
100GP outputOD
101GP outputOD + PU
110GP outputOD + PD
111Reserved (GP output OD)
Table 125. Port bit configuration (1) (continued)
MODE(i)[1:0]OTYPE(i)OSPEED(i)[1:0]PUPD(i)[1:0]I/O configuration
100SPEED[1:0]00AFPP
001AFPP + PU
010AFPP + PD
011Reserved
100AFOD
101AFOD + PU
110AFOD + PD
111Reserved
00xxx00InputFloating
xxx01InputPU
xxx10InputPD
xxx11Reserved (input floating)
11xxx00Input/outputAnalog
xxx01Reserved
xxx10
xxx11

1. GP = general-purpose, PP = push-pull, PU = pull-up, PD = pull-down, OD = open-drain, AF = alternate function.

13.3.1 General-purpose I/O (GPIO)

During and just after reset, the alternate functions are not active and most of the I/O ports are configured in analog mode.

The debug pins are in AF pull-up/pull-down after reset:

BOOT0 is in input mode during the reset until at least the end of the option byte loading phase (see Section 13.3.15 ).

When the pin is configured as output, the value written to the output data register (GPIOx_ODR) is output on the I/O pin. It is possible to use the output driver in push-pull mode or open-drain mode (only the low level is driven, high level is high-Z).

The input data register (GPIOx_IDR) captures the data present on the I/O pin at every AHB clock cycle.

All GPIO pins have weak internal pull-up and pull-down resistors, which can be activated or not, depending upon the value in the GPIOx_PUPDR register.

13.3.2 I/O pin alternate function multiplexer and mapping

The device I/O pins are connected to on-board peripherals/modules through a multiplexer that allows only one peripheral alternate function (AF) connected to an I/O pin at a time. In this way, there is no conflict between peripherals available on the same I/O pin.

Each I/O pin has a multiplexer with up to 16 alternate function inputs (AF0 to AF15) that can be configured through the GPIOx_AFRL (for pin 0 to 7) and GPIOx_AFRH (for pin 8 to 15) registers:

In addition to this flexible I/O multiplexing architecture, each peripheral has alternate functions mapped onto different I/O pins to optimize the number of peripherals available in smaller packages.

To use an I/O in a given configuration, the user must proceed as follows:

Refer to the “Alternate function mapping” table in the device datasheet for the detailed mapping of the alternate function I/O pins.

13.3.3 I/O port control registers

Each of the GPIO ports has four 32-bit memory-mapped control registers (GPIOx_MODER, GPIOx_OTYPER, GPIOx_OSPEEDR, GPIOx_PUPDR) to configure up to 16 I/Os. The GPIOx_MODER register is used to select the I/O mode (input, output, AF, analog). The GPIOx_OTYPER and GPIOx_OSPEEDR registers are used to select the output type (push-pull or open-drain) and speed. The GPIOx_PUPDR register is used to select the pull-up/pull-down whatever the I/O direction.

13.3.4 I/O port data registers

Each GPIO has two 16-bit memory-mapped data registers: input and output data registers ( GPIO port input data register (GPIOx_IDR) (x = A to I) and GPIO port output data register (GPIOx_ODR) (x = A to I) ).

GPIOx_ODR stores the data to be output, it is read/write accessible. The data entered through the I/Os are stored into the input data register (GPIOx_IDR), a read-only register.

13.3.5 I/O data bitwise handling

The bit set reset register (GPIOx_BSRR) is a 32-bit register that allows the application to set and reset each individual bit in the output data register (GPIOx_ODR). The bit set reset register has twice the size of GPIOx_ODR.

To each bit in GPIOx_ODR, correspond two control bits in GPIOx_BSRR: BS(i) and BR(i). When written to 1, BS(i) sets the corresponding ODR(i) bit. When written to 1, BR(i) resets the ODR(i) corresponding bit.

Writing any bit to 0 in GPIOx_BSRR does not have any effect on the corresponding bit in GPIOx_ODR. If there is an attempt to both set and reset a bit in GPIOx_BSRR, the set action takes priority.

Using the GPIOx_BSRR register to change the values of individual bits in GPIOx_ODR is a “one-shot” effect that does not lock the GPIOx_ODR bits. The GPIOx_ODR bits can always be accessed directly. The GPIOx_BSRR register provides a way of performing atomic bitwise handling.

There is no need for the software to disable interrupts when programming the GPIOx_ODR at bit level: one or more bits can be modified in a single atomic AHB write access.

13.3.6 GPIO locking mechanism

The GPIO control registers can be frozen by applying a specific write sequence to the GPIOx_LCKR register. The frozen registers are GPIOx_MODER, GPIOx_OTYPER, GPIOx_OSPEEDR, GPIOx_PUPDR, GPIOx_AFRL, GPIOx_AFRH and GPIOx_HSLVR.

To write the GPIOx_LCKR register, a specific write/read sequence must be applied. When the right LOCK sequence is applied to the bit 16 in this register, the value of LCKR[15:0] is used to lock the configuration of the I/Os (during the write sequence the LCKR[15:0] value must be the same). When the LOCK sequence is applied to a port bit, the value of the port bit can no longer be modified until the next MCU reset or peripheral reset. Each GPIOx_LCKR bit freezes the corresponding bit in the control registers (GPIOx_MODER, GPIOx_OTYPER, GPIOx_OSPEEDR, GPIOx_PUPDR, GPIOx_AFRL and GPIOx_AFRH).

The LOCK sequence can be performed only using a word (32-bit long) access to the GPIOx_LCKR register, because GPIOx_LCKR bit 16 must be set at the same time as the [15:0] bits.

13.3.7 I/O alternate function input/output

Two registers are provided to select one of the alternate function inputs/outputs available for each I/O. With these registers, the user can connect an alternate function to some other pin as required by the application.

This means that some peripheral functions are multiplexed on each GPIO using the GPIOx_AFRL and GPIOx_AFRH alternate function registers. The application can thus

select any one of the possible functions for each I/O. The AF selection signal being common to the alternate function input and alternate function output, a single channel is selected for the alternate function input/output of a given I/O.

To know which functions are multiplexed on each GPIO pin, refer to the device datasheet.

13.3.8 External interrupt/wake-up lines

All ports have external interrupt capability. To use external interrupt lines, the port can be configured in input, output, or alternate function mode (the port must not be configured in analog mode). Refer to Section 18: Extended interrupts and event controller (EXTI) .

13.3.9 Input configuration

When the I/O port is programmed as input:

Figure 60 shows the input configuration of the I/O port bit.

Figure 60. Input floating/pull-up/pull-down configurations

Figure 60: Input floating/pull-up/pull-down configurations. This block diagram illustrates the internal circuitry of a GPIO pin in input mode. On the left, a 'Read' signal connects to an 'Input data register'. A 'Write' signal connects to 'Bit set/reset registers', which in turn connect to an 'Output data register'. A 'Read/write' signal also connects to the 'Output data register'. The 'Output data register' is connected to an 'Output driver' (containing a switch) and an 'Input driver' (containing a TTL Schmitt trigger). The 'TTL Schmitt trigger' has an 'on' control. The 'Output driver' has an 'on/off' control. The 'Input driver' has an 'on/off' control. The 'I/O pin' is connected to the 'TTL Schmitt trigger', the 'Output driver', a 'Pull up' resistor (connected to VDDIOx), a 'Pull down' resistor (connected to Vss), an 'ESD protection' circuit (connected to Vss), and a 'Protection diode' (connected to Vss). The diagram is labeled MSv63602V1.
Figure 60: Input floating/pull-up/pull-down configurations. This block diagram illustrates the internal circuitry of a GPIO pin in input mode. On the left, a 'Read' signal connects to an 'Input data register'. A 'Write' signal connects to 'Bit set/reset registers', which in turn connect to an 'Output data register'. A 'Read/write' signal also connects to the 'Output data register'. The 'Output data register' is connected to an 'Output driver' (containing a switch) and an 'Input driver' (containing a TTL Schmitt trigger). The 'TTL Schmitt trigger' has an 'on' control. The 'Output driver' has an 'on/off' control. The 'Input driver' has an 'on/off' control. The 'I/O pin' is connected to the 'TTL Schmitt trigger', the 'Output driver', a 'Pull up' resistor (connected to VDDIOx), a 'Pull down' resistor (connected to Vss), an 'ESD protection' circuit (connected to Vss), and a 'Protection diode' (connected to Vss). The diagram is labeled MSv63602V1.

13.3.10 Output configuration

When the I/O port is programmed as output:

Figure 61 shows the output configuration of the I/O port bit.

Figure 61. Output configuration. A block diagram showing the internal circuitry of a GPIO pin in output mode. On the left, 'Read' and 'Write' signals connect to 'Bit set/reset registers'. These registers connect to an 'Output data register' (Read/write) and an 'Input data register' (Read). The 'Output data register' connects to an 'Output control' block. The 'Input data register' connects to a 'TTL Schmitt trigger' (on). The 'Output control' block connects to a 'Push-pull or open-drain' driver consisting of a P-MOS (VDDIOX) and an N-MOS (VSS). The 'TTL Schmitt trigger' also connects to this driver. The driver output connects to the 'I/O pin'. The 'I/O pin' is connected to 'Pull up' (VDDIOX) and 'Pull down' (VSS) resistors, an 'ESD protection' circuit (VSS), and a 'Protection diode' (VSS). The diagram is labeled MSV63641V1.

Figure 61. Output configuration

Figure 61. Output configuration. A block diagram showing the internal circuitry of a GPIO pin in output mode. On the left, 'Read' and 'Write' signals connect to 'Bit set/reset registers'. These registers connect to an 'Output data register' (Read/write) and an 'Input data register' (Read). The 'Output data register' connects to an 'Output control' block. The 'Input data register' connects to a 'TTL Schmitt trigger' (on). The 'Output control' block connects to a 'Push-pull or open-drain' driver consisting of a P-MOS (VDDIOX) and an N-MOS (VSS). The 'TTL Schmitt trigger' also connects to this driver. The driver output connects to the 'I/O pin'. The 'I/O pin' is connected to 'Pull up' (VDDIOX) and 'Pull down' (VSS) resistors, an 'ESD protection' circuit (VSS), and a 'Protection diode' (VSS). The diagram is labeled MSV63641V1.

13.3.11 Alternate function configuration

When the I/O port is programmed as alternate function:

Figure 62 shows the alternate function configuration of the I/O port bit.

Figure 62: Alternate function configuration diagram. This schematic shows the internal architecture of a GPIO pin configured for alternate functions. On the left, an 'Alternate function input' is connected to an 'on' switch, which is controlled by an 'Input data register'. This input is also connected to an 'on-chip peripheral'. A 'Read' signal is shown for the input data register. Below it, an 'Alternate function output' is connected to a 'Push-pull or open-drain' driver, which consists of a P-MOS and an N-MOS transistor controlled by an 'Output control' block. This output is connected to an 'on-chip peripheral' via a 'Read/write' signal. The 'Output control' block is also connected to 'Bit set/reset registers' and an 'Output data register'. The 'Input driver' and 'Output driver' are shown as dashed boxes. The 'TTL Schmitt trigger' is shown with its input connected to the I/O pin and its output connected to the 'on' switch. The 'I/O pin' is connected to 'VDDIOX', 'VSS', and a 'Protection diode'. 'Pull up' and 'Pull down' resistors are also shown, controlled by 'on/off' switches. The diagram is labeled MSV63642V1.

Figure 62. Alternate function configuration

Figure 62: Alternate function configuration diagram. This schematic shows the internal architecture of a GPIO pin configured for alternate functions. On the left, an 'Alternate function input' is connected to an 'on' switch, which is controlled by an 'Input data register'. This input is also connected to an 'on-chip peripheral'. A 'Read' signal is shown for the input data register. Below it, an 'Alternate function output' is connected to a 'Push-pull or open-drain' driver, which consists of a P-MOS and an N-MOS transistor controlled by an 'Output control' block. This output is connected to an 'on-chip peripheral' via a 'Read/write' signal. The 'Output control' block is also connected to 'Bit set/reset registers' and an 'Output data register'. The 'Input driver' and 'Output driver' are shown as dashed boxes. The 'TTL Schmitt trigger' is shown with its input connected to the I/O pin and its output connected to the 'on' switch. The 'I/O pin' is connected to 'VDDIOX', 'VSS', and a 'Protection diode'. 'Pull up' and 'Pull down' resistors are also shown, controlled by 'on/off' switches. The diagram is labeled MSV63642V1.

13.3.12 Analog configuration

When the I/O port is programmed as analog configuration:

Figure 63 shows the high-Z, analog-input configuration of the I/O port bits.

Figure 63: High-impedance analog configuration diagram. This schematic shows the internal architecture of a GPIO pin configured for analog input. The 'Analog' input is connected to the 'I/O pin' through a switch. The 'TTL Schmitt trigger' is shown with its input connected to the 'I/O pin' and its output connected to the 'off' switch, which is controlled by the 'Input data register'. The 'Input driver' and 'Output driver' are shown as dashed boxes. The 'Output driver' is disabled. The 'I/O pin' is connected to 'VSS' and a 'Protection diode'. 'ESD protection' is also shown. The diagram is labeled MSV63643V1.

Figure 63. High-impedance analog configuration

Figure 63: High-impedance analog configuration diagram. This schematic shows the internal architecture of a GPIO pin configured for analog input. The 'Analog' input is connected to the 'I/O pin' through a switch. The 'TTL Schmitt trigger' is shown with its input connected to the 'I/O pin' and its output connected to the 'off' switch, which is controlled by the 'Input data register'. The 'Input driver' and 'Output driver' are shown as dashed boxes. The 'Output driver' is disabled. The 'I/O pin' is connected to 'VSS' and a 'Protection diode'. 'ESD protection' is also shown. The diagram is labeled MSV63643V1.

13.3.13 Using the HSE or LSE oscillator pins as GPIOs

When the HSE or LSE oscillator is switched off (default state after reset), the related oscillator pins can be used as normal GPIOs.

When the HSE or LSE oscillator is switched on (by setting the HSEON or LSEON bit in the RCC_CSR register), the oscillator takes control of its associated pins and the GPIO configuration of these pins has no effect.

When the oscillator is configured in a user external clock mode, only the pin is reserved for clock input, and the OSC_OUT or OSC32_OUT pin can still be used as normal GPIO.

13.3.14 Using the GPIO pins in the RTC supply domain

The PC13/PC14/PC15/PI8 GPIO functionality is lost when the core supply domain is powered off (when the device enters Standby mode). In this case, if their GPIO configuration is not bypassed by the RTC configuration, these pins are set in an analog input mode.

For details about I/O control by the RTC, refer to Section 46.3: RTC functional description

13.3.15 I/Os state retention during standby mode

In the Standby mode, the I/Os are by default in floating state.

If the IORETEN bit in the PWR_IORETR register is set, the I/Os state is sampled during standby entry. The state of I/Os is applied to the pin via pull-up and pull-down resistors. The pull-up and pull-down resistors remains applied after Standby wake-up until the IORETEN bit in the PWR_IORETR register is cleared by software.

13.3.16 TrustZone security

The TrustZone security is activated by the TZEN option byte in the FLASH option byte register. When the TrustZone is active (TZEN = 0xB4), each I/O pin of GPIO port can be individually configured as secure through the GPIOx_SECCFGR register.

When the selected I/O pin is configured as secure, its corresponding configuration bits for alternate function, mode selection, I/O data are secure against a non-secure access. In case of non-secure access, these bits are RAZ/WI.

The I/Os with peripherals functions are also conditioned by the peripheral security configuration (see Section 5: Global TrustZone® controller (GTZC) for more details):

Refer to the device pins definition table in datasheet for more information about peripherals alternate functions and additional functions mapping.

After reset, all GPIO ports are secure.

The table below gives a summary of the I/O port secured bits following the security configuration bit in the GPIO_SECCFGR register. When the I/O bit port is configured as secure:

When the TrustZone security is disabled (TZEN = 0xC3 in FLASH_OPTSR2 register), all registers bits are non-secure. The GPIOx_SECCFGR register is RAZ/WI.

Table 126. GPIO secured bits

Secure configuration bitSecured bitRegister nameNon-secure access on secure bits
SECy = 1 in GPIOx_SECCFGR (1) (2)MODEy[1:0]GPIOx_MODERRAZ/WI
OTyGPIOx_OTYPER
OSPEEDy[1:0]GPIOx_OSPEEDR
PUPDy[1:0]GPIOx_PUPDR
IDyGPIOx_IDR
ODyGPIOx_ODR
BSy and BRyGPIOx_BSRR
LCKyGPIOx_LCKR
BRyGPIOx_BRR
AFSELy[3:0]GPIOx_AFRH
GPIOx_AFRL
HSLVyGPIOx_HSLVR

1. GPIOx, x = A to I. For x = A to H, y = 0 to 15. For x = I, y = 0 to 11.

2. The number of GPIOx ports depends upon the device. Refer to the product datasheet for availability of a particular port. If not present, consider the associated bits as reserved, and keep them at reset value.

13.3.17 Privileged and unprivileged modes

All GPIO registers can be read and written by privileged and unprivileged accesses, whatever the security state (secure or non-secure).

13.3.18 High-speed low-voltage mode (HSLV)

Some I/Os have the capability to increase their maximum speed at low voltage by configuring them in HSLV mode. The I/O HSLV bit controls whether the I/O output speed is optimized to operate at 3.3 V (default setting) or at 1.8 V (HSLV = 1).

Caution: The I/O HSLV configuration bit must not be set if the I/O supply ( \( V_{DD} \) or \( V_{DDIO2} \) ) is above 2.7 V. Setting it while the voltage is higher than 2.7 V can damage the device. The I/O HSLV bit can be set only when the corresponding option bit is activated (IO_VDD_HSLV or IO_VDDIO2_HSLV depending on the I/O supply, refer to Section 7.4: FLASH option bytes ).

There is no hardware protection associated to this feature so it is recommended to use it only as a static configuration for fixed I/O supply.

13.3.19 I/O compensation cell

The I/O commutation slew rate (tfall / trise) can be adapted by software depending on process, voltage and temperatures conditions, to reduce the I/O noise on power supply. Refer to Section 14: System configuration, boot, and security (SBS) for more details.

13.4 GPIO registers

This section gives a detailed description of the GPIO registers. Note that the number of GPIOx ports depends upon the device. Refer to the product datasheet for the availability of a particular port. If not present, consider the associated bits as reserved, and keep them at reset value.

The peripheral registers can be written in word, half word, or byte mode.

13.4.1 GPIO port mode register (GPIOx_MODER) (x = A to I)

Address offset: 0x00

Reset value: 0xABFF FFFF (for port A)

Reset value: 0xFFFF FEBF (for port B)

Reset value: 0xFFFF FFFF (for ports C..H)

Reset value: 0x00FF FFFF (for port I)

31302928272625242322212019181716
MODE15[1:0]MODE14[1:0]MODE13[1:0]MODE12[1:0]MODE11[1:0]MODE10[1:0]MODE9[1:0]MODE8[1:0]
rwrwrwrwrwrwrwrwrwrwrwrwrwrwrwrw
1514131211109876543210
MODE7[1:0]MODE6[1:0]MODE5[1:0]MODE4[1:0]MODE3[1:0]MODE2[1:0]MODE1[1:0]MODE0[1:0]
rwrwrwrwrwrwrwrwrwrwrwrwrwrwrwrw

Bits 31:0 MODEy[1:0] : Port x configuration I/O pin y (y = 15 to 0)

These bits are written by software to configure the I/O mode.

00: Input mode

01: General purpose output mode

10: Alternate function mode

11: Analog mode (reset state)

Note: The bitfield is reserved and must be kept to reset value when the corresponding I/O is not available on the selected package.

13.4.2 GPIO port output type register (GPIOx_OTYPER) (x = A to I)

Address offset: 0x04

Reset value: 0x0000 0000

31302928272625242322212019181716
ResResResResResResResResResResResResResResResRes
1514131211109876543210
OT15OT14OT13OT12OT11OT10OT9OT8OT7OT6OT5OT4OT3OT2OT1OT0
rwrwrwrwrwrwrwrwrwrwrwrwrwrwrwrw

Bits 31:16 Reserved, must be kept at reset value.

Bits 15:0 OTy : Port x configuration I/O pin y (y = 15 to 0)

These bits are written by software to configure the I/O output type.

0: Output push-pull (reset state)

1: Output open-drain

Note: The bit is reserved and must be kept to reset value when the corresponding I/O is not available on the selected package.

13.4.3 GPIO port output speed register (GPIOx_OSPEEDR) (x = A to I)

Address offset: 0x08

Reset value: 0x0C00 0000 (for port A)

Reset value: 0x0000 00C0 (for port B)

Reset value: 0x0000 0000 (for the other ports)

31302928272625242322212019181716
OSPEED15[1:0]OSPEED14[1:0]OSPEED13[1:0]OSPEED12[1:0]OSPEED11[1:0]OSPEED10[1:0]OSPEED9[1:0]OSPEED8[1:0]
rwrwrwrwrwrwrwrwrwrwrwrwrwrwrwrw
1514131211109876543210
OSPEED7[1:0]OSPEED6[1:0]OSPEED5[1:0]OSPEED4[1:0]OSPEED3[1:0]OSPEED2[1:0]OSPEED1[1:0]OSPEED0[1:0]
rwrwrwrwrwrwrwrwrwrwrwrwrwrwrwrw

Bits 31:0 OSPEEDy[1:0] : Port x configuration I/O pin y (y = 15 to 0)

These bits are written by software to configure the I/O output speed.

00: Low speed

01: Medium speed

10: High speed

11: Very-high speed

Note: Refer to the device datasheet for the frequency specifications, the power supply, and the load conditions for each speed.

The bitfield is reserved and must be kept to reset value when the corresponding I/O is not available on the selected package.

13.4.4 GPIO port pull-up/pull-down register (GPIOx_PUPDR) (x = A to I)

Address offset: 0x0C

Reset value: 0x6400 0000 (for port A)

Reset value: 0x0000 0100 (for port B)

Reset value: 0x0000 0000 (for the other ports)

31302928272625242322212019181716
PUPD15[1:0]PUPD14[1:0]PUPD13[1:0]PUPD12[1:0]PUPD11[1:0]PUPD10[1:0]PUPD9[1:0]PUPD8[1:0]
rwrwrwrwrwrwrwrwrwrwrwrwrwrwrwrw
1514131211109876543210
PUPD7[1:0]PUPD6[1:0]PUPD5[1:0]PUPD4[1:0]PUPD3[1:0]PUPD2[1:0]PUPD1[1:0]PUPD0[1:0]
rwrwrwrwrwrwrwrwrwrwrwrwrwrwrwrw

Bits 31:0 PUPDy[1:0] : Port x configuration I/O pin y (y = 15 to 0)

These bits are written by software to configure the I/O pull-up or pull-down

00: No pull-up, pull-down

01: Pull-up

10: Pull-down

11: Reserved

Note: The bitfield is reserved and must be kept to reset value when the corresponding I/O is not available on the selected package.

13.4.5 GPIO port input data register (GPIOx_IDR) (x = A to I)

Address offset: 0x10

Reset value: 0x0000 XXXX

31302928272625242322212019181716
Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.
1514131211109876543210
ID15ID14ID13ID12ID11ID10ID9ID8ID7ID6ID5ID4ID3ID2ID1ID0
rrrrrrrrrrrrrrrr

Bits 31:16 Reserved, must be kept at reset value.

Bits 15:0 IDy : Port x input data I/O pin y (y = 15 to 0)

These bits are read-only. They contain the input value of the corresponding I/O port.

Note: The bit is reserved and must be kept to reset value when the corresponding I/O is not available on the selected package.

13.4.6 GPIO port output data register (GPIOx_ODR) (x = A to I)

Address offset: 0x14

Reset value: 0x0000 0000

31302928272625242322212019181716
Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.
1514131211109876543210
OD15OD14OD13OD12OD11OD10OD9OD8OD7OD6OD5OD4OD3OD2OD1OD0
rwrwrwrwrwrwrwrwrwrwrwrwrwrwrwrw

Bits 31:16 Reserved, must be kept at reset value.

Bits 15:0 ODy : Port output data I/O pin y (y = 15 to 0)

These bits can be read and written by software.

Note: For atomic bit set/reset, the OD bits can be individually set and/or reset by writing to the GPIOx_BSR or GPIOx_BRR registers (x = A to I).

The bit is reserved and must be kept to reset value when the corresponding I/O is not available on the selected package.

13.4.7 GPIO port bit set/reset register (GPIOx_BSR) (x = A to I)

Address offset: 0x18

Reset value: 0x0000 0000

31302928272625242322212019181716
BR15BR14BR13BR12BR11BR10BR9BR8BR7BR6BR5BR4BR3BR2BR1BR0
wwwwwwwwwwwwwwww
1514131211109876543210
BS15BS14BS13BS12BS11BS10BS9BS8BS7BS6BS5BS4BS3BS2BS1BS0
wwwwwwwwwwwwwwww

Bits 31:16 BRy : Port x reset I/O pin y (y = 15 to 0)

These bits are write-only. A read to these bits returns the value 0x0000.

0: No action on the corresponding ODy bit

1: Resets the corresponding ODy bit

Note: If both BSy and BRy are set, BSy has priority.

The bit is reserved and must be kept to reset value when the corresponding I/O is not available on the selected package.

Bits 15:0 BSy : Port x set I/O pin y (y = 15 to 0)

These bits are write-only. A read to these bits returns the value 0x0000.

0: No action on the corresponding ODy bit

1: Sets the corresponding ODy bit

Note: The bit is reserved and must be kept to reset value when the corresponding I/O is not available on the selected package.

13.4.8 GPIO port configuration lock register (GPIOx_LCKR) (x = A to I)

This register is used to lock the configuration of the port bits when a correct write sequence is applied to bit 16 (LCKK). The value of bits [15:0] is used to lock the configuration of the GPIO. During the write sequence, the value of LCKR[15:0] must not change. When the LOCK sequence has been applied on a port bit, the value of this port bit can no longer be modified until the next MCU reset or peripheral reset.

Note: A specific write sequence is used to write to the GPIOx_LCKR register. Only word access (32-bit long) is allowed during this locking sequence.

Each bit freezes a specific configuration register (control and alternate function registers).

Address offset: 0x1C

Reset value: 0x0000 0000

31302928272625242322212019181716
ResResResResResResResResResResResResResResResLCKK
rw
1514131211109876543210
LCK15LCK14LCK13LCK12LCK11LCK10LCK9LCK8LCK7LCK6LCK5LCK4LCK3LCK2LCK1LCK0
rwrwrwrwrwrwrwrwrwrwrwrwrwrwrwrw

Bits 31:17 Reserved, must be kept at reset value.

Bit 16 LCKK : Lock key

This bit can be read any time. It can only be modified using the lock key write sequence.

0: Port configuration lock key not active

1: Port configuration lock key active. The GPIOx_LCKR register is locked until the next MCU reset or peripheral reset.

- LOCK key write sequence:

WR LCKR[16] = 1 + LCKR[15:0]

WR LCKR[16] = 0 + LCKR[15:0]

WR LCKR[16] = 1 + LCKR[15:0]

- LOCK key read

RD LCKR[16] = 1 (this read operation is optional but it confirms that the lock is active)

Note: During the LOCK key write sequence, the value of LCK[15:0] must not change.

Any error in the lock sequence aborts the LOCK.

After the first LOCK sequence on any bit of the port, any read access on the LCKK bit returns 1 until the next MCU reset or peripheral reset.

Bits 15:0 LCKy : Port x lock I/O pin y (y = 15 to 0)

These bits are read/write but can only be written when the LCKK bit is 0

0: Port configuration not locked

1: Port configuration locked

Note: The bit is reserved and must be kept to reset value when the corresponding I/O is not available on the selected package.

13.4.9 GPIO alternate function low register (GPIOx_AFRL) (x = A to I)

Address offset: 0x20

Reset value: 0x0000 0000

31302928272625242322212019181716
AFSEL7[3:0]AFSEL6[3:0]AFSEL5[3:0]AFSEL4[3:0]
rwrwrwrwrwrwrwrwrwrwrwrwrwrwrwrw
1514131211109876543210
AFSEL3[3:0]AFSEL2[3:0]AFSEL1[3:0]AFSEL0[3:0]
rwrwrwrwrwrwrwrwrwrwrwrwrwrwrwrw

Bits 31:0 AFSELy[3:0] : Alternate function selection for port x I/O pin y (y = 7 to 0)

These bits are written by software to configure alternate function I/Os.

0000: AF0
0001: AF1
0010: AF2
0011: AF3
0100: AF4
0101: AF5
0110: AF6
0111: AF7
1000: AF8
1001: AF9
1010: AF10
1011: AF11
1100: AF12
1101: AF13
1110: AF14
1111: AF15

Note: The bitfield is reserved and must be kept to reset value when the corresponding I/O is not available on the selected package.

13.4.10 GPIO alternate function high register (GPIOx_AFRH) (x = A to H)

Address offset: 0x24

Reset value: 0x0000 0000

31302928272625242322212019181716
AFSEL15[3:0]AFSEL14[3:0]AFSEL13[3:0]AFSEL12[3:0]
rwrwrwrwrwrwrwrwrwrwrwrwrwrwrwrw
1514131211109876543210
AFSEL11[3:0]AFSEL10[3:0]AFSEL9[3:0]AFSEL8[3:0]
rwrwrwrwrwrwrwrwrwrwrwrwrwrwrwrw

Bits 31:0 AFSELY[3:0] : Alternate function selection for port x I/O pin y (y = 15 to 8)

These bits are written by software to configure alternate function I/Os.

0000: AF0
0001: AF1
0010: AF2
0011: AF3
0100: AF4
0101: AF5
0110: AF6
0111: AF7
1000: AF8
1001: AF9
1010: AF10
1011: AF11
1100: AF12
1101: AF13
1110: AF14
1111: AF15

Note: The bitfield is reserved and must be kept to reset value when the corresponding I/O is not available on the selected package.

13.4.11 GPIO port bit reset register (GPIOx_BRR) (x = A to I)

Address offset: 0x28

Reset value: 0x0000 0000

31302928272625242322212019181716
Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.
1514131211109876543210
BR15BR14BR13BR12BR11BR10BR9BR8BR7BR6BR5BR4BR3BR2BR1BR0
wwwwwwwwwwwwwwww

Bits 31:16 Reserved, must be kept at reset value.

Bits 15:0 BRy : Port x reset IO pin y (y = 15 to 0)

These bits are write-only. A read to these bits returns the value 0x0000.

0: No action on the corresponding ODy bit

1: Reset the corresponding ODy bit

Note: The bit is reserved and must be kept to reset value when the corresponding I/O is not available on the selected package.

13.4.12 GPIO high-speed low-voltage register (GPIOx_HSLVR) (x = A to I)

Address offset: 0x2C

Reset value: 0x0000 0000

31302928272625242322212019181716
Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.
1514131211109876543210
HSLV
15
HSLV
14
HSLV
13
HSLV
12
HSLV
11
HSLV
10
HSLV
9
HSLV
8
HSLV
7
HSLV
6
HSLV
5
HSLV
4
HSLV
3
HSLV
2
HSLV
1
HSLV
0
rwrwrwrwrwrwrwrwrwrwrwrwrwrwrwrw

Bits 31:16 Reserved, must be kept at reset value.

Bits 15:0 HSLVy : Port x high-speed low-voltage configuration (y = 15 to 0)

These bits are written by software to optimize the I/O speed when the I/O supply is low.

Each bit is active only if the corresponding IO_VDD_HSLV/IO_VDDIO2_HSLV user option bit is set. It must be used only if the I/O supply voltage is below 2.7 V.

Setting these bits when the I/O supply (VDD or VDDIO2) is higher than 2.7 V may be destructive.

0: I/O speed optimization disabled

1: I/O speed optimization enabled

Note: Not all I/Os support the HSLV mode. Refer to the I/O structure in the corresponding datasheet for the list of I/Os supporting this feature. Other I/Os HSLV configuration must be kept at reset value.

The bit is reserved and must be kept to reset value when the corresponding I/O is not available on the selected package.

13.4.13 GPIO secure configuration register (GPIOx_SECCFGR) (x = A to I)

When the system is secure (TZEN = 0xB4), this register provides write access security and can be written only by a secure access. It is used to configure a selected I/O as secure. A non-secure write access to this register is discarded.

When the system is not secure (TZEN = 0xC3), this register is RAZ/WI.

Address offset: 0x30

Reset value: 0x0000 FFFF (for ports A to H)

Reset value: 0x0000 0FFF (for port I)

31302928272625242322212019181716
Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.
1514131211109876543210
SEC15SEC14SEC13SEC12SEC11SEC10SEC9SEC8SEC7SEC6SEC5SEC4SEC3SEC2SEC1SEC0
rwrwrwrwrwrwrwrwrwrwrwrwrwrwrwrw

Bits 31:16 Reserved, must be kept at reset value.

Bits 15:0 SECy : I/O pin of Port x secure bit enable y (y = 15 to 0)

These bits are written by software to enable or disable the I/O port pin security.

0: The I/O pin is non-secure

1: The I/O pin is secure. Refer to Table 126 for all corresponding secured bits.

Note: The bit is reserved and must be kept to reset value when the corresponding I/O is not available on the selected package.

13.4.14 GPIO register map

Table 127. GPIO register map and reset values

OffsetRegister313029282726252423222120191817161514131211109876543210
0x00GPIOx_MODER
(x = A to I)
MODE15[1:0]MODE14[1:0]MODE13[1:0]MODE12[1:0]MODE11[1:0]MODE10[1:0]MODE9[1:0]MODE8[1:0]MODE7[1:0]MODE6[1:0]MODE5[1:0]MODE4[1:0]MODE3[1:0]MODE2[1:0]MODE1[1:0]MODE0[1:0]
Reset value for port A10101011111111111111111111111111
Reset value for port B11111111111111111111111010111111
Reset value for ports C...H11111111111111111111111111111111
Reset value for port I00000000111111111111111111111111
0x04GPIOx_OTYPER
(x = A to I)
Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.OT15OT14OT13OT12OT11OT10OT9OT8OT7OT6OT5OT4OT3OT2OT1OT0
Reset value0000000000000000
0x08GPIOx_OSPEEDR
(x = A to I)
OSPEED15[1:0]OSPEED14[1:0]OSPEED13[1:0]OSPEED12[1:0]OSPEED11[1:0]OSPEED10[1:0]OSPEED9[1:0]OSPEED8[1:0]OSPEED7[1:0]OSPEED6[1:0]OSPEED5[1:0]OSPEED4[1:0]OSPEED3[1:0]OSPEED2[1:0]OSPEED1[1:0]OSPEED0[1:0]
Reset value for port A00001100000000000000000000000000
Reset value for port B00000000000000000000000110000000
Reset value for ports C...I00000000000000000000000000000000
0x0CGPIOx_PUPDR
(x = A to I)
PUPD15[1:0]PUPD14[1:0]PUPD13[1:0]PUPD12[1:0]PUPD11[1:0]PUPD10[1:0]PUPD9[1:0]PUPD8[1:0]PUPD7[1:0]PUPD6[1:0]PUPD5[1:0]PUPD4[1:0]PUPD3[1:0]PUPD2[1:0]PUPD1[1:0]PUPD0[1:0]
Reset value for port A01100100000000000000000000000000
Reset value for port B00000000000000000000000100000000
Reset value for ports C...I00000000000000000000000000000000
0x10GPIOx_IDR
(x = A to I)
Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.ID15ID14ID13ID12ID11ID10ID9ID8ID7ID6ID5ID4ID3ID2ID1ID0
Reset valueXXXXXXXXXXXXXXXX
0x14GPIOx_ODR
(x = A to I)
Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.OD15OD14OD13OD12OD11OD10OD9OD8OD7OD6OD5OD4OD3OD2OD1OD0
Reset value0000000000000000
0x18GPIOx_BSRR
(x = A to I)
BR15BR14BR13BR12BR11BR10BR9BR8BR7BR6BR5BR4BR3BR2BR1BR0BS15BS14BS13BS12BS11BS10BS9BS8BS7BS6BS5BS4BS3BS2BS1BS0
Reset value00000000000000000000000000000000
0x1CGPIOx_LCKR
(x = A to I)
Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.LCKKLCK15LCK14LCK13LCK12LCK11LCK10LCK9LCK8LCK7LCK6LCK5LCK4LCK3LCK2LCK1LCK0
Reset value00000000000000000
0x20GPIOx_AFRL
(x = A to I)
AFSEL7[3:0]AFSEL6[3:0]AFSEL5[3:0]AFSEL4[3:0]AFSEL3[3:0]AFSEL2[3:0]AFSEL1[3:0]AFSEL0[3:0]
Reset value00000000000000000000000000000000
0x24GPIOx_AFRH
(x = A to H)
AFSEL15[3:0]AFSEL14[3:0]AFSEL13[3:0]AFSEL12[3:0]AFSEL11[3:0]AFSEL10[3:0]AFSEL9[3:0]AFSEL8[3:0]
Reset value00000000000000000000000000000000

Table 127. GPIO register map and reset values (continued)

OffsetRegister313029282726252423222120191817161514131211109876543210
0x28GPIOx_BRR
(x = A to I)
Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.BR15BR14BR13BR12BR11BR10BR9BR8BR7BR6BR5BR4BR3BR2BR1BR0
Reset value0000000000000000
0x2CGPIOx_HSLVR
(x = A to I)
Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.HSLV15HSLV14HSLV13HSLV12HSLV11HSLV10HSLV9HSLV8HSLV7HSLV6HSLV5HSLV4HSLV3HSLV2HSLV1HSLV0
Reset value000000000000000
0x30GPIOx_SECCFGR
(x = A to I)
Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.Res.SEC15SEC14SEC13SEC12SEC11SEC10SEC9SEC8SEC7SEC6SEC5SEC4SEC3SEC2SEC1SEC0
Reset value for A to H1111111111111111
Reset value for port I0000111111111111

Refer to Section 2.3 for the register boundary addresses.