STM32F2xx Standard Peripheral Library
1.1.2 Naming conventions
The following naming conventions are used in the library:
PPP refers to any peripheral acronym, for example ADC. See Section 1.1: "Coding
rules and conventions" for more information.
System and source/header file names are preceded by „stm32f2xx_‟, for example
stm32f2xx_conf.h.
Constants used in one file are defined within this file. A constant used in more than
one file is defined in a header file. All constants are written in upper case, except for
peripheral driver function parameters.
typedef variable names should be suffixed with _TypeDef.
Registers are considered as constants. In most cases, their name is in upper case and
uses the same acronyms as in the STM32F2xx reference manual document.
Peripheral registers are declared in the PPP_TypeDef structure (e.g. ADC_TypeDef)
in stm32fxx.h file.
Almost all peripheral function names are preceded by the corresponding peripheral
acronym in upper case followed by an underscore. The first letter in each word is in
upper case, for example USART_SendData. Only one underscore is allowed in a
function name to separate the peripheral acronym from the rest of the function name.
The structure containing the initialization parameters for the PPP peripheral are
named PPP_InitTypeDef (e.g. ADC_InitTypeDef).
The functions used to initialize the PPP peripheral according to parameters specified
in PPP_InitTypeDef are named PPP_Init, e.g. TIM_Init.
The functions used to reset the PPP peripheral registers to their default values are
named PPP_DeInit, e.g. TIM_DeInit.
The functions used to fill the PPP_InitTypeDef structure with the reset values of each
member are named PPP_StructInit, e.g. USART_StructInit.
The functions used to enable or disable the specified PPP peripheral are named
PPP_Cmd, for example USART_Cmd.
The functions used to enable or disable an interrupt source for the specified PPP
peripheral are named PPP_ITConfig, e.g. RCC_ITConfig.
The functions used to enable or disable the DMA interface for the specified PPP
peripheral are named PPP_DMAConfig, e.g. TIM_DMAConfig.
The functions used to configure a peripheral function always end with the string
„Config‟, for example GPIO_PinAFConfig.
The functions used to check whether the specified PPP flag is set or reset are named
PPP_GetFlagStatus, e.g. I2C_GetFlagStatus.
The functions used to clear a PPP flag are named PPP_ClearFlag, for example
I2C_ClearFlag.
The functions used to check whether the specified PPP interrupt has occurred or not
are named PPP_GetITStatus, e.g. I2C_GetITStatus.
The functions used to clear a PPP interrupt pending bit are named
PPP_ClearITPendingBit, e.g. I2C_ClearITPendingBit.