arm_chip_stm32.h File Reference

ARM common macros for STM32. More...

#include "main.h"
#include <ARM_CMSIS_INC>

Include dependency graph for arm_chip_stm32.h:

Macros
#define	STM_HEADER(f)
	concatenate <stm32(f)xx.h> name following stm family f
#define	STM_CONF_HEADER(f)
	concatenate <stm32(f)xx_hal.h> name following stm family f
#define	ARM_CMSIS_INC   STM_HEADER(STM_FAMILY)
	Alias for STM32 CMSIS include.
#define	ARM_HAL_CFG   STM_CONF_HEADER(STM_FAMILY)
	Alias for STM32 HAL config include.
#define	stm_port(mnem)
	Wrapper for PORT Alias.
#define	stm_pin(mnem)
	Wrapper for PIN Alias.
#define	GPIO(mnem)
	Wrapper for PORT/PIN Alias (when using HAL_GPIO_ReadPin for example)
#define	stm_timer(mnem)
#define	stm_channel(mnem)
#define	TIM(mnem)
	Wrapper for mnem TIM/CHAN Alias (when using HAL_TIM_PWM_Start for example)
#define	STM32_OPTION_BYTES   (VAL_AT(OB_BASE, uint64_t))
	Option Bytes register address content.
#define	STM32_FLASHSIZE   (VAL_AT(FLASHSIZE_BASE, uint16_t))
	Flash size register address content.
#define	STM32_UNIQUE_ID1   (VAL_AT(UID_BASE, uint32_t))
	Unique ID 1 register address content.
#define	STM32_UNIQUE_ID2   (VAL_AT(UID_BASE+4, uint32_t))
	Unique ID 2 register address content.
#define	STM32_UNIQUE_ID3   (VAL_AT(UID_BASE+8, uint32_t))
	Unique ID 3 register address content.
#define	FLASH_SIZE   (STM32_FLASHSIZE * 1024)
	Flash size in bytes.
#define	HAL_MAX_TICKS   ((uint32_t) -1)
	HAL max Ticks value.
#define	HAL_MS_TICKS_FACTOR   1U
	HAL milliseconds multiplier (depending tick counter frequency)
#define	HAL_ResetSource()
	Get STM32 Reset Source.

Enumerations
enum	eResetSource {   RST_POR = 1U , RST_BOR , RST_PIN , RST_SW ,   RST_IWDG , RST_WWDG , RST_LPWR , RST_OBL ,   RST_V18PWR , RST_FW , RST_UNKNOWN = 0xFFU }
	Source of last reset. More...

Detailed Description

ARM common macros for STM32.

Author

SMFSW

Copyright

MIT (c) 2017-2026, SMFSW

MISRA C:2012 Deviations

Header scope legitimate use derogation authorized for:
Rule-5.6 - Required: unique typedef name (misra-c2012-5.6)
Rule-5.9 - Advisory: internal linkage unique function name (misra-c2012-5.9)
Justification: typedefs name are only defined once (other arm_chip_xxx files are not included at the same time).

Macro Definition Documentation

ARM_CMSIS_INC

#define ARM_CMSIS_INC   STM_HEADER(STM_FAMILY)

Alias for STM32 CMSIS include.

ARM_HAL_CFG

#define ARM_HAL_CFG   STM_CONF_HEADER(STM_FAMILY)

Alias for STM32 HAL config include.

FLASH_SIZE

#define FLASH_SIZE   (STM32_FLASHSIZE * 1024)

Flash size in bytes.

Note

FLASHSIZE_BASE is uint16_t type (given in kB)

GPIO

#define GPIO

(

mnem

)

Value:

stm_port(mnem), stm_pin(mnem)

Wrapper for PORT/PIN Alias (when using HAL_GPIO_ReadPin for example)

HAL_MAX_TICKS

#define HAL_MAX_TICKS   ((uint32_t) -1)

HAL max Ticks value.

Note

Define HAL_MAX_TICKS with custom max value in project if tick max value is not using 32b variable full scale

HAL_MS_TICKS_FACTOR

#define HAL_MS_TICKS_FACTOR   1U

HAL milliseconds multiplier (depending tick counter frequency)

Note

Define HAL_MS_TICKS_FACTOR with custom multiplier in project if tick period is not 1ms

HAL_ResetSource

#define HAL_ResetSource

(

void

)

Value:

Get_Reset_Source()

Get STM32 Reset Source.

Warning

This function should be called soon after reset (before or after SystemClock_Config())

Note

This function using some special macros can't be inlined, thus can't be in sarmfsw stm32 header unfortunately

Returns

Last reset source Alias for HARMcksL Get_Reset_Source function

STM32_FLASHSIZE

#define STM32_FLASHSIZE   (VAL_AT(FLASHSIZE_BASE, uint16_t))

Flash size register address content.

STM32_OPTION_BYTES

#define STM32_OPTION_BYTES   (VAL_AT(OB_BASE, uint64_t))

Option Bytes register address content.

STM32_UNIQUE_ID1

#define STM32_UNIQUE_ID1   (VAL_AT(UID_BASE, uint32_t))

Unique ID 1 register address content.

STM32_UNIQUE_ID2

#define STM32_UNIQUE_ID2   (VAL_AT(UID_BASE+4, uint32_t))

Unique ID 2 register address content.

STM32_UNIQUE_ID3

#define STM32_UNIQUE_ID3   (VAL_AT(UID_BASE+8, uint32_t))

Unique ID 3 register address content.

stm_channel

#define stm_channel

(

mnem

)

Value:

XCAT(mnem, _Chan)

Note

Shall define mnemonic mnem name corresponding to TIMER instance defined in CubeMX (for consistency with STM32 HAL) Wrapper for mnem TIM Channel Alias

STM_CONF_HEADER

#define STM_CONF_HEADER

(

f

)

Value:

XCAT(<stm32, XCAT(f, xx_hal.h>))

concatenate <stm32(f)xx_hal.h> name following stm family f

STM_HEADER

#define STM_HEADER

(

f

)

Value:

XCAT(<stm32, XCAT(f, xx.h>))

concatenate <stm32(f)xx.h> name following stm family f

stm_pin

#define stm_pin

(

mnem

)

Value:

XCAT(mnem, _Pin)

Wrapper for PIN Alias.

stm_port

#define stm_port

(

mnem

)

Value:

XCAT(mnem, _GPIO_Port)

Wrapper for PORT Alias.

stm_timer

#define stm_timer

(

mnem

)

Value:

XCAT(mnem, _Tim)

Note

Shall define mnemonic mnem name corresponding to TIMER instance defined in CubeMX (for consistency with STM32 HAL) Wrapper for mnem TIM Alias

TIM

#define TIM

(

mnem

)

Value:

stm_timer(mnem), stm_channel(mnem)

Wrapper for mnem TIM/CHAN Alias (when using HAL_TIM_PWM_Start for example)

Note

Shall define mnemonic mnem name corresponding to TIMER instance defined in CubeMX (for consistency with STM32 HAL)

Enumeration Type Documentation

eResetSource

enum eResetSource

Source of last reset.

Enumerator
RST_POR	Power On Reset.
RST_BOR	Brown Out Reset (H7)
RST_PIN	Pin Reset (External Reset)
RST_SW	Software Reset.
RST_IWDG	Independent Watchdog Reset.
RST_WWDG	Window Watchdog Reset.
RST_LPWR	Low Power Reset.
RST_OBL	Option Byte Load Reset.
RST_V18PWR	1.8V Domain Power Reset (F3)
RST_FW	Firewall Reset (L4)
RST_UNKNOWN	Unknown Reset Source.