STM32CubeMX文档\hal库
Contents1 Acronyms and definitions.............................................................362 Overview of HAL drivers...............................................................382.1 HAL and user-application files.........................................................382.1.1 HAL driver files ................................................................................. 382.1.2 User-application files ........................................................................ 392.2 HAL data structures ........................................................................412.2.1 Peripheral handle structures ............................................................ 412.2.2 Initialization and configuration structure ........................................... 422.2.3 Specific process structures .............................................................. 432.3 API classification.............................................................................432.4 Devices supported by HAL drivers ..................................................442.5 HAL drivers rules.............................................................................512.5.1 HAL API naming rules ...................................................................... 512.5.2 HAL general naming rules................................................................ 522.5.3 HAL interrupt handler and callback functions................................... 532.6 HAL generic APIs............................................................................542.7 HAL extension APIs ........................................................................552.7.1 HAL extension model overview ........................................................ 552.7.2 HAL extension model cases............................................................. 552.8 File inclusion model.........................................................................572.9 HAL common resources..................................................................582.10 HAL configuration............................................................................592.11 HAL system peripheral handling .....................................................602.11.1 Clock................................................................................................. 602.11.2 GPIOs............................................................................................... 602.11.3 Cortex NVIC and SysTick timer........................................................ 622.11.4 PWR ................................................................................................. 622.11.5 EXTI.................................................................................................. 622.11.6 DMA.................................................................................................. 642.12 How to use HAL drivers ..................................................................662.12.1 HAL usage models ........................................................................... 662.12.2 HAL initialization ............................................................................... 672.12.3 HAL IO operation process ................................................................ 692.12.4 Timeout and error management....................................................... 72UM1850 ContentsDOCID027328 Rev 1 3/6553 HAL System Driver........................................................................763.1 HAL Firmware driver API description ..............................................763.1.1 How to use this driver....................................................................... 763.1.2 Initialization and de-initialization functions ....................................... 763.1.3 HAL Control functions....................................................................... 763.1.4 HAL_Init............................................................................................ 773.1.5 HAL_DeInit ....................................................................................... 773.1.6 HAL_MspInit ..................................................................................... 773.1.7 HAL_MspDeInit ................................................................................ 783.1.8 HAL_InitTick ..................................................................................... 783.1.9 HAL_IncTick ..................................................................................... 783.1.10 HAL_GetTick .................................................................................... 783.1.11 HAL_Delay ....................................................................................... 783.1.12 HAL_SuspendTick............................................................................ 783.1.13 HAL_ResumeTick............................................................................. 793.1.14 HAL_GetHalVersion ......................................................................... 793.1.15 HAL_GetREVID................................................................................ 793.1.16 HAL_GetDEVID................................................................................ 793.1.17 HAL_DBGMCU_EnableDBGSleepMode ......................................... 793.1.18 HAL_DBGMCU_DisableDBGSleepMode ........................................ 793.1.19 HAL_DBGMCU_EnableDBGStopMode ........................................... 803.1.20 HAL_DBGMCU_DisableDBGStopMode .......................................... 803.1.21 HAL_DBGMCU_EnableDBGStandbyMode ..................................... 803.1.22 HAL_DBGMCU_DisableDBGStandbyMode .................................... 803.2 HAL Firmware driver defines...........................................................813.2.1 HAL................................................................................................... 814 HAL ADC Generic Driver...............................................................824.1 ADC Firmware driver registers structures .......................................824.1.1 ADC_InitTypeDef.............................................................................. 824.1.2 ADC_ChannelConfTypeDef ............................................................. 834.1.3 ADC_AnalogWDGConfTypeDef....................................................... 844.1.4 ADC_HandleTypeDef....................................................................... 844.2 ADC Firmware driver API description..............................................854.2.1 ADC peripheral features ................................................................... 854.2.2 How to use this driver....................................................................... 854.2.3 Initialization and de-initialization functions ....................................... 884.2.4 IO operation functions ...................................................................... 88Contents UM18504/655 DOCID027328 Rev 14.2.5 Peripheral Control functions ............................................................. 894.2.6 Peripheral State and Errors functions .............................................. 894.2.7 HAL_ADC_Init .................................................................................. 894.2.8 HAL_ADC_DeInit.............................................................................. 894.2.9 HAL_ADC_MspInit ........................................................................... 904.2.10 HAL_ADC_MspDeInit....................................................................... 904.2.11 HAL_ADC_Start ............................................................................... 904.2.12 HAL_ADC_Stop................................................................................ 904.2.13 HAL_ADC_PollForConversion ......................................................... 914.2.14 HAL_ADC_PollForEvent .................................................................. 914.2.15 HAL_ADC_Start_IT .......................................................................... 914.2.16 HAL_ADC_Stop_IT .......................................................................... 914.2.17 HAL_ADC_Start_DMA ..................................................................... 914.2.18 HAL_ADC_Stop_DMA...................................................................... 924.2.19 HAL_ADC_GetValue........................................................................ 924.2.20 HAL_ADC_IRQHandler.................................................................... 924.2.21 HAL_ADC_ConvCpltCallback .......................................................... 924.2.22 HAL_ADC_ConvHalfCpltCallback.................................................... 934.2.23 HAL_ADC_LevelOutOfWindowCallback .......................................... 934.2.24 HAL_ADC_ErrorCallback ................................................................. 934.2.25 HAL_ADC_ConfigChannel ............................................................... 934.2.26 HAL_ADC_AnalogWDGConfig ........................................................ 944.2.27 HAL_ADC_GetState......................................................................... 944.2.28 HAL_ADC_GetError ......................................................................... 944.3 ADC Firmware driver defines ..........................................................944.3.1 ADC .................................................................................................. 945 HAL ADC Extension Driver......................................................... 1065.1 ADCEx Firmware driver registers structures .................................1065.1.1 ADC_InjectionConfTypeDef ........................................................... 1065.1.2 ADC_MultiModeTypeDef................................................................ 1075.2 ADCEx Firmware driver API description .......................................1085.2.1 IO operation functions .................................................................... 1085.2.2 Peripheral Control functions ........................................................... 1095.2.3 HAL_ADCEx_Calibration_Start...................................................... 1095.2.4 HAL_ADCEx_InjectedStart ............................................................ 1095.2.5 HAL_ADCEx_InjectedStop............................................................. 1095.2.6 HAL_ADCEx_InjectedPollForConversion ...................................... 1095.2.7 HAL_ADCEx_InjectedStart_IT ....................................................... 110UM1850 ContentsDOCID027328 Rev 1 5/6555.2.8 HAL_ADCEx_InjectedStop_IT ....................................................... 1105.2.9 HAL_ADCEx_MultiModeStart_DMA .............................................. 1105.2.10 HAL_ADCEx_MultiModeStop_DMA............................................... 1105.2.11 HAL_ADCEx_InjectedGetValue ..................................................... 1115.2.12 HAL_ADCEx_MultiModeGetValue ................................................. 1115.2.13 HAL_ADCEx_InjectedConvCpltCallback ....................................... 1115.2.14 HAL_ADCEx_InjectedConfigChannel ............................................ 1115.2.15 HAL_ADCEx_MultiModeConfigChannel ........................................ 1125.3 ADCEx Firmware driver defines....................................................1125.3.1 ADCEx............................................................................................ 1126 HAL CAN Generic Driver............................................................. 1186.1 CAN Firmware driver registers structures .....................................1186.1.1 CAN_InitTypeDef............................................................................ 1186.1.2 CanTxMsgTypeDef......................................................................... 1186.1.3 CanRxMsgTypeDef ........................................................................ 1196.1.4 CAN_HandleTypeDef..................................................................... 1206.2 CAN Firmware driver API description............................................1206.2.1 How to use this driver..................................................................... 1206.2.2 Initialization and de-initialization functions ..................................... 1216.2.3 IO operation functions .................................................................... 1226.2.4 Peripheral State and Error functions .............................................. 1226.2.5 HAL_CAN_Init ................................................................................ 1226.2.6 HAL_CAN_ConfigFilter................................................................... 1226.2.7 HAL_CAN_DeInit............................................................................ 1236.2.8 HAL_CAN_MspInit ......................................................................... 1236.2.9 HAL_CAN_MspDeInit..................................................................... 1236.2.10 HAL_CAN_Transmit....................................................................... 1236.2.11 HAL_CAN_Transmit_IT.................................................................. 1236.2.12 HAL_CAN_Receive........................................................................ 1246.2.13 HAL_CAN_Receive_IT................................................................... 1246.2.14 HAL_CAN_Sleep............................................................................ 1246.2.15 HAL_CAN_WakeUp ....................................................................... 1246.2.16 HAL_CAN_IRQHandler.................................................................. 1256.2.17 HAL_CAN_TxCpltCallback............................................................. 1256.2.18 HAL_CAN_RxCpltCallback ............................................................ 1256.2.19 HAL_CAN_ErrorCallback ............................................................... 1256.2.20 HAL_CAN_GetState....................................................................... 1266.2.21 HAL_CAN_GetError ....................................................................... 126Contents UM18506/655 DOCID027328 Rev 16.3 CAN Firmware driver defines ........................................................1266.3.1 CAN ................................................................................................ 1267 HAL CAN Extension Driver......................................................... 1367.1 CANEx Firmware driver registers structures .................................1367.1.1 CAN_FilterConfTypeDef................................................................. 1367.2 CANEx Firmware driver defines....................................................1377.2.1 CANEx............................................................................................ 1378 HAL CEC Generic Driver............................................................. 1388.1 CEC Firmware driver registers structures .....................................1388.1.1 CEC_InitTypeDef............................................................................ 1388.1.2 CEC_HandleTypeDef..................................................................... 1388.2 CEC Firmware driver API description............................................1398.2.1 How to use this driver..................................................................... 1398.2.2 Initialization and Configuration functions........................................ 1398.2.3 IO operation functions .................................................................... 1398.2.4 Peripheral Control functions ........................................................... 1408.2.5 HAL_CEC_Init ................................................................................ 1408.2.6 HAL_CEC_DeInit............................................................................ 1408.2.7 HAL_CEC_MspInit ......................................................................... 1418.2.8 HAL_CEC_MspDeInit..................................................................... 1418.2.9 HAL_CEC_Transmit....................................................................... 1418.2.10 HAL_CEC_Receive........................................................................ 1418.2.11 HAL_CEC_Transmit_IT.................................................................. 1428.2.12 HAL_CEC_Receive_IT................................................................... 1428.2.13 HAL_CEC_GetReceivedFrameSize............................................... 1428.2.14 HAL_CEC_IRQHandler.................................................................. 1438.2.15 HAL_CEC_TxCpltCallback............................................................. 1438.2.16 HAL_CEC_RxCpltCallback ............................................................ 1438.2.17 HAL_CEC_ErrorCallback ............................................................... 1438.2.18 HAL_CEC_GetState....................................................................... 1438.2.19 HAL_CEC_GetError ....................................................................... 1438.3 CEC Firmware driver defines ........................................................1448.3.1 CEC ................................................................................................ 1449 HAL CORTEX Generic Driver...................................................... 1509.1 CORTEX Firmware driver API description ....................................1509.1.1 Initialization and de-initialization functions ..................................... 1509.1.2 Peripheral Control functions ........................................................... 150UM1850 ContentsDOCID027328 Rev 1 7/6559.1.3 HAL_NVIC_SetPriorityGrouping .................................................... 1509.1.4 HAL_NVIC_SetPriority ................................................................... 1519.1.5 HAL_NVIC_EnableIRQ .................................................................. 1519.1.6 HAL_NVIC_DisableIRQ.................................................................. 1519.1.7 HAL_NVIC_SystemReset............................................................... 1529.1.8 HAL_SYSTICK_Config................................................................... 1529.1.9 HAL_NVIC_GetPriorityGrouping .................................................... 1529.1.10 HAL_NVIC_GetPriority................................................................... 1529.1.11 HAL_NVIC_SetPendingIRQ........................................................... 1539.1.12 HAL_NVIC_GetPendingIRQ .......................................................... 1539.1.13 HAL_NVIC_ClearPendingIRQ........................................................ 1539.1.14 HAL_NVIC_GetActive .................................................................... 1539.1.15 HAL_SYSTICK_CLKSourceConfig ................................................ 1549.1.16 HAL_SYSTICK_IRQHandler .......................................................... 1549.1.17 HAL_SYSTICK_Callback ............................................................... 1549.2 CORTEX Firmware driver defines.................................................1549.2.1 CORTEX......................................................................................... 15410 HAL CRC Generic Driver............................................................. 15610.1 CRC Firmware driver registers structures .....................................15610.1.1 CRC_HandleTypeDef..................................................................... 15610.2 CRC Firmware driver API description ...........................................15610.2.1 How to use this driver..................................................................... 15610.2.2 Initialization and de-initialization functions ..................................... 15610.2.3 Peripheral Control functions ........................................................... 15710.2.4 Peripheral State functions .............................................................. 15710.2.5 HAL_CRC_Init ................................................................................ 15710.2.6 HAL_CRC_DeInit ........................................................................... 15710.2.7 HAL_CRC_MspInit ......................................................................... 15710.2.8 HAL_CRC_MspDeInit..................................................................... 15810.2.9 HAL_CRC_Accumulate.................................................................. 15810.2.10 HAL_CRC_Calculate...................................................................... 15810.2.11 HAL_CRC_GetState....................................................................... 15810.3 CRC Firmware driver defines........................................................15910.3.1 CRC................................................................................................ 15911 HAL DAC Generic Driver............................................................. 16011.1 DAC Firmware driver registers structures .....................................16011.1.1 DAC_HandleTypeDef..................................................................... 160Contents UM18508/655 DOCID027328 Rev 111.1.2 DAC_ChannelConfTypeDef ........................................................... 16011.2 DAC Firmware driver API description............................................16111.2.1 DAC Peripheral features................................................................. 16111.2.2 How to use this driver..................................................................... 16211.2.3 Initialization and de-initialization functions ..................................... 16311.2.4 IO operation functions .................................................................... 16411.2.5 Peripheral Control functions ........................................................... 16411.2.6 Peripheral State and Errors functions ............................................ 16411.2.7 HAL_DAC_Init ................................................................................ 16411.2.8 HAL_DAC_DeInit............................................................................ 16511.2.9 HAL_DAC_MspInit ......................................................................... 16511.2.10 HAL_DAC_MspDeInit..................................................................... 16511.2.11 HAL_DAC_Start ............................................................................. 16511.2.12 HAL_DAC_Stop.............................................................................. 16611.2.13 HAL_DAC_Start_DMA ................................................................... 16611.2.14 HAL_DAC_Stop_DMA.................................................................... 16611.2.15 HAL_DAC_GetValue...................................................................... 16711.2.16 HAL_DAC_ConvCpltCallbackCh1.................................................. 16711.2.17 HAL_DAC_ConvHalfCpltCallbackCh1 ........................................... 16711.2.18 HAL_DAC_ErrorCallbackCh1 ........................................................ 16711.2.19 HAL_DAC_SetValue ...................................................................... 16811.2.20 HAL_DAC_ConfigChannel ............................................................. 16811.2.21 HAL_DAC_SetValue ...................................................................... 16811.2.22 HAL_DAC_GetState....................................................................... 16911.2.23 HAL_DAC_GetError ....................................................................... 16911.2.24 HAL_DAC_ConvCpltCallbackCh1.................................................. 16911.2.25 HAL_DAC_ConvHalfCpltCallbackCh1 ........................................... 16911.2.26 HAL_DAC_ErrorCallbackCh1 ........................................................ 17011.3 DAC Firmware driver defines ........................................................17011.3.1 DAC ................................................................................................ 17012 HAL DAC Extension Driver......................................................... 17212.1 DACEx Firmware driver API description .......................................17212.1.1 How to use this driver..................................................................... 17212.1.2 Extended features functions........................................................... 17212.1.3 HAL_DACEx_DualGetValue .......................................................... 17212.1.4 HAL_DACEx_TriangleWaveGenerate ........................................... 17212.1.5 HAL_DACEx_NoiseWaveGenerate ............................................... 17312.1.6 HAL_DACEx_DualSetValue........................................................... 174UM1850 ContentsDOCID027328 Rev 1 9/65512.1.7 HAL_DACEx_ConvCpltCallbackCh2 ............................................. 17412.1.8 HAL_DACEx_ConvHalfCpltCallbackCh2....................................... 17512.1.9 HAL_DACEx_ErrorCallbackCh2 .................................................... 17512.2 DACEx Firmware driver defines....................................................17512.2.1 DACEx............................................................................................ 17513 HAL DMA Generic Driver ............................................................ 17813.1 DMA Firmware driver registers structures.....................................17813.1.1 DMA_InitTypeDef ........................................................................... 17813.1.2 __DMA_HandleTypeDef................................................................. 17813.2 DMA Firmware driver API description ...........................................17913.2.1 How to use this driver..................................................................... 17913.2.2 Initialization and de-initialization functions ..................................... 18013.2.3 IO operation functions .................................................................... 18013.2.4 State and Errors functions .............................................................. 18113.2.5 HAL_DMA_Init................................................................................ 18113.2.6 HAL_DMA_DeInit ........................................................................... 18113.2.7 HAL_DMA_Start ............................................................................. 18113.2.8 HAL_DMA_Start_IT........................................................................ 18213.2.9 HAL_DMA_Abort ............................................................................ 18213.2.10 HAL_DMA_PollForTransfer............................................................ 18213.2.11 HAL_DMA_IRQHandler.................................................................. 18313.2.12 HAL_DMA_GetState ...................................................................... 18313.2.13 HAL_DMA_GetError....................................................................... 18313.3 DMA Firmware driver defines........................................................18313.3.1 DMA................................................................................................ 18314 HAL DMA Extension Driver......................................................... 18814.1 DMAEx Firmware driver defines....................................................18814.1.1 DMAEx............................................................................................ 18815 HAL ETH Generic Driver ............................................................. 19015.1 ETH Firmware driver registers structures......................................19015.1.1 ETH_InitTypeDef ............................................................................ 19015.1.2 ETH_MACInitTypeDef.................................................................... 19015.1.3 ETH_DMAInitTypeDef.................................................................... 19315.1.4 ETH_DMADescTypeDef................................................................. 19415.1.5 ETH_DMARxFrameInfos................................................................ 19415.1.6 ETH_HandleTypeDef ..................................................................... 19515.2 ETH Firmware driver API description ............................................195Contents UM185010/655 DOCID027328 Rev 115.2.1 How to use this driver..................................................................... 19515.2.2 Initialization and de-initialization functions ..................................... 19615.2.3 IO operation functions .................................................................... 19615.2.4 Peripheral Control functions ........................................................... 19715.2.5 Peripheral State functions .............................................................. 19715.2.6 HAL_ETH_Init................................................................................. 19715.2.7 HAL_ETH_DeInit ............................................................................ 19715.2.8 HAL_ETH_DMATxDescListInit....................................................... 19815.2.9 HAL_ETH_DMARxDescListInit ...................................................... 19815.2.10 HAL_ETH_MspInit.......................................................................... 19815.2.11 HAL_ETH_MspDeInit ..................................................................... 19815.2.12 HAL_ETH_TransmitFrame............................................................. 19915.2.13 HAL_ETH_GetReceivedFrame ...................................................... 19915.2.14 HAL_ETH_GetReceivedFrame_IT................................................. 19915.2.15 HAL_ETH_IRQHandler .................................................................. 19915.2.16 HAL_ETH_TxCpltCallback ............................................................. 19915.2.17 HAL_ETH_RxCpltCallback............................................................. 20015.2.18 HAL_ETH_ErrorCallback................................................................ 20015.2.19 HAL_ETH_ReadPHYRegister........................................................ 20015.2.20 HAL_ETH_WritePHYRegister ........................................................ 20015.2.21 HAL_ETH_Start.............................................................................. 20115.2.22 HAL_ETH_Stop .............................................................................. 20115.2.23 HAL_ETH_ConfigMAC................................................................... 20115.2.24 HAL_ETH_ConfigDMA................................................................... 20115.2.25 HAL_ETH_GetState ....................................................................... 20215.3 ETH Firmware driver defines.........................................................20215.3.1 ETH................................................................................................. 20216 HAL FLASH Generic Driver......................................................... 23216.1 FLASH Firmware driver registers structures .................................23216.1.1 FLASH_ProcessTypeDef ............................................................... 23216.2 FLASH Firmware driver API description........................................23216.2.1 FLASH peripheral features............................................................. 23216.2.2 How to use this driver..................................................................... 23216.2.3 IO operation functions .................................................................... 23316.2.4 Peripheral Control functions ........................................................... 23316.2.5 Peripheral State functions .............................................................. 23416.2.6 HAL_FLASH_Program ................................................................... 23416.2.7 HAL_FLASH_Program_IT.............................................................. 234UM1850 ContentsDOCID027328 Rev 1 11/65516.2.8 HAL_FLASH_IRQHandler.............................................................. 23516.2.9 HAL_FLASH_EndOfOperationCallback ......................................... 23516.2.10 HAL_FLASH_OperationErrorCallback ........................................... 23516.2.11 HAL_FLASH_Unlock ...................................................................... 23516.2.12 HAL_FLASH_Lock ......................................................................... 23516.2.13 HAL_FLASH_OB_Unlock............................................................... 23616.2.14 HAL_FLASH_OB_Lock .................................................................. 23616.2.15 HAL_FLASH_OB_Launch.............................................................. 23616.2.16 HAL_FLASH_GetError ................................................................... 23616.3 FLASH Firmware driver defines ....................................................23616.3.1 FLASH ............................................................................................ 23617 HAL FLASH Extension Driver..................................................... 24117.1 FLASHEx Firmware driver registers structures .............................24117.1.1 FLASH_EraseInitTypeDef .............................................................. 24117.1.2 FLASH_OBProgramInitTypeDef .................................................... 24117.2 FLASHEx Firmware driver API description....................................24217.2.1 IO operation functions .................................................................... 24217.2.2 Peripheral Control functions ........................................................... 24217.2.3 HAL_FLASHEx_Erase ................................................................... 24217.2.4 HAL_FLASHEx_Erase_IT .............................................................. 24317.2.5 HAL_FLASHEx_OBErase .............................................................. 24317.2.6 HAL_FLASHEx_OBProgram.......................................................... 24317.2.7 HAL_FLASHEx_OBGetConfig ....................................................... 24417.3 FLASHEx Firmware driver defines ................................................24417.3.1 FLASHEx........................................................................................ 24418 HAL GPIO Generic Driver............................................................ 24718.1 GPIO Firmware driver registers structures....................................24718.1.1 GPIO_InitTypeDef .......................................................................... 24718.2 GPIO Firmware driver API description ..........................................24718.2.1 GPIO Peripheral features ............................................................... 24718.2.2 How to use this driver..................................................................... 24818.2.3 Initialization and deinitialization functions....................................... 24818.2.4 IO operation functions .................................................................... 24918.2.5 HAL_GPIO_Init............................................................................... 24918.2.6 HAL_GPIO_DeInit .......................................................................... 24918.2.7 HAL_GPIO_ReadPin...................................................................... 24918.2.8 HAL_GPIO_WritePin...................................................................... 250Contents UM185012/655 DOCID027328 Rev 118.2.9 HAL_GPIO_TogglePin ................................................................... 25018.2.10 HAL_GPIO_LockPin....................................................................... 25018.2.11 HAL_GPIO_EXTI_IRQHandler ...................................................... 25118.2.12 HAL_GPIO_EXTI_Callback............................................................ 25118.3 GPIO Firmware driver defines.......................................................25118.3.1 GPIO............................................................................................... 25119 HAL GPIO Extension Driver........................................................ 25519.1 GPIOEx Firmware driver API description ......................................25519.1.1 GPIO Peripheral extension features............................................... 25519.1.2 How to use this driver..................................................................... 25519.1.3 Extended features functions........................................................... 25519.1.4 HAL_GPIOEx_ConfigEventout....................................................... 25519.1.5 HAL_GPIOEx_EnableEventout...................................................... 25619.1.6 HAL_GPIOEx_DisableEventout ..................................................... 25619.2 GPIOEx Firmware driver defines...................................................25619.2.1 GPIOEx .......................................................................................... 25620 HAL HCD Generic Driver............................................................. 26620.1 HCD Firmware driver registers structures .....................................26620.1.1 HCD_HandleTypeDef..................................................................... 26620.2 HCD Firmware driver API description ...........................................26620.2.1 How to use this driver..................................................................... 26620.2.2 Initialization and de-initialization functions ..................................... 26720.2.3 IO operation functions .................................................................... 26720.2.4 Peripheral Control functions ........................................................... 26720.2.5 Peripheral State functions .............................................................. 26720.2.6 HAL_HCD_Init ................................................................................ 26720.2.7 HAL_HCD_HC_Init......................................................................... 26820.2.8 HAL_HCD_HC_Halt ....................................................................... 26820.2.9 HAL_HCD_DeInit ........................................................................... 26820.2.10 HAL_HCD_MspInit ......................................................................... 26820.2.11 HAL_HCD_MspDeInit..................................................................... 26920.2.12 HAL_HCD_HC_SubmitRequest..................................................... 26920.2.13 HAL_HCD_IRQHandler.................................................................. 26920.2.14 HAL_HCD_SOF_Callback ............................................................. 27020.2.15 HAL_HCD_Connect_Callback ....................................................... 27020.2.16 HAL_HCD_Disconnect_Callback ................................................... 27020.2.17 HAL_HCD_HC_NotifyURBChange_Callback ................................ 27020.2.18 HAL_HCD_Start ............................................................................. 270UM1850 ContentsDOCID027328 Rev 1 13/65520.2.19 HAL_HCD_Stop ............................................................................. 27120.2.20 HAL_HCD_ResetPort..................................................................... 27120.2.21 HAL_HCD_GetState....................................................................... 27120.2.22 HAL_HCD_HC_GetURBState........................................................ 27120.2.23 HAL_HCD_HC_GetXferCount ....................................................... 27220.2.24 HAL_HCD_HC_GetState ............................................................... 27220.2.25 HAL_HCD_GetCurrentFrame ........................................................ 27220.2.26 HAL_HCD_GetCurrentSpeed ........................................................ 27220.3 HCD Firmware driver defines........................................................27220.3.1 HCD................................................................................................ 27321 HAL I2C Generic Driver............................................................... 27421.1 I2C Firmware driver registers structures .......................................27421.1.1 I2C_InitTypeDef.............................................................................. 27421.1.2 I2C_HandleTypeDef....................................................................... 27421.2 I2C Firmware driver API description..............................................27521.2.1 How to use this driver..................................................................... 27521.2.2 Initialization and de-initialization functions ..................................... 27821.2.3 IO operation functions .................................................................... 27821.2.4 Peripheral State and Errors functions ............................................ 28021.2.5 HAL_I2C_Init .................................................................................. 28021.2.6 HAL_I2C_DeInit.............................................................................. 28021.2.7 HAL_I2C_MspInit ........................................................................... 28021.2.8 HAL_I2C_MspDeInit....................................................................... 28021.2.9 HAL_I2C_Master_Transmit............................................................ 28121.2.10 HAL_I2C_Master_Receive............................................................. 28121.2.11 HAL_I2C_Slave_Transmit.............................................................. 28121.2.12 HAL_I2C_Slave_Receive............................................................... 28221.2.13 HAL_I2C_Master_Transmit_IT....................................................... 28221.2.14 HAL_I2C_Master_Receive_IT........................................................ 28221.2.15 HAL_I2C_Slave_Transmit_IT......................................................... 28221.2.16 HAL_I2C_Slave_Receive_IT.......................................................... 28321.2.17 HAL_I2C_Master_Transmit_DMA.................................................. 28321.2.18 HAL_I2C_Master_Receive_DMA................................................... 28321.2.19 HAL_I2C_Slave_Transmit_DMA.................................................... 28421.2.20 HAL_I2C_Slave_Receive_DMA..................................................... 28421.2.21 HAL_I2C_Mem_Write..................................................................... 28421.2.22 HAL_I2C_Mem_Read .................................................................... 28521.2.23 HAL_I2C_Mem_Write_IT ............................................................... 285Contents UM185014/655 DOCID027328 Rev 121.2.24 HAL_I2C_Mem_Read_IT ............................................................... 28521.2.25 HAL_I2C_Mem_Write_DMA .......................................................... 28621.2.26 HAL_I2C_Mem_Read_DMA .......................................................... 28621.2.27 HAL_I2C_IsDeviceReady............................................................... 28621.2.28 HAL_I2C_EV_IRQHandler ............................................................. 28721.2.29 HAL_I2C_ER_IRQHandler............................................................. 28721.2.30 HAL_I2C_MasterTxCpltCallback.................................................... 28721.2.31 HAL_I2C_MasterRxCpltCallback ................................................... 28721.2.32 HAL_I2C_SlaveTxCpltCallback...................................................... 28821.2.33 HAL_I2C_SlaveRxCpltCallback ..................................................... 28821.2.34 HAL_I2C_MemTxCpltCallback....................................................... 28821.2.35 HAL_I2C_MemRxCpltCallback ...................................................... 28821.2.36 HAL_I2C_ErrorCallback ................................................................. 28921.2.37 HAL_I2C_GetState......................................................................... 28921.2.38 HAL_I2C_GetError ......................................................................... 28921.3 I2C Firmware driver defines ..........................................................28921.3.1 I2C .................................................................................................. 28922 HAL I2S Generic Driver............................................................... 29622.1 I2S Firmware driver registers structures .......................................29622.1.1 I2S_InitTypeDef.............................................................................. 29622.1.2 I2S_HandleTypeDef ....................................................................... 29622.2 I2S Firmware driver API description..............................................29722.2.1 How to use this driver..................................................................... 29722.2.2 Initialization and de-initialization functions ..................................... 29922.2.3 IO operation functions .................................................................... 29922.2.4 Peripheral State and Errors functions ............................................ 30022.2.5 HAL_I2S_Init .................................................................................. 30022.2.6 HAL_I2S_DeInit.............................................................................. 30122.2.7 HAL_I2S_MspInit............................................................................ 30122.2.8 HAL_I2S_MspDeInit....................................................................... 30122.2.9 HAL_I2S_Transmit ......................................................................... 30122.2.10 HAL_I2S_Receive .......................................................................... 30222.2.11 HAL_I2S_Transmit_IT.................................................................... 30222.2.12 HAL_I2S_Receive_IT..................................................................... 30322.2.13 HAL_I2S_Transmit_DMA ............................................................... 30322.2.14 HAL_I2S_Receive_DMA ................................................................ 30322.2.15 HAL_I2S_DMAPause..................................................................... 30422.2.16 HAL_I2S_DMAResume.................................................................. 304UM1850 ContentsDOCID027328 Rev 1 15/65522.2.17 HAL_I2S_DMAStop........................................................................ 30422.2.18 HAL_I2S_IRQHandler .................................................................... 30522.2.19 HAL_I2S_TxHalfCpltCallback ........................................................ 30522.2.20 HAL_I2S_TxCpltCallback............................................................... 30522.2.21 HAL_I2S_RxHalfCpltCallback ........................................................ 30522.2.22 HAL_I2S_RxCpltCallback .............................................................. 30522.2.23 HAL_I2S_ErrorCallback ................................................................. 30622.2.24 HAL_I2S_GetState......................................................................... 30622.2.25 HAL_I2S_GetError ......................................................................... 30622.3 I2S Firmware driver defines ..........................................................30622.3.1 I2S .................................................................................................. 30623 HAL IRDA Generic Driver............................................................ 31123.1 IRDA Firmware driver registers structures ....................................31123.1.1 IRDA_InitTypeDef........................................................................... 31123.1.2 IRDA_HandleTypeDef.................................................................... 31123.2 IRDA Firmware driver API description...........................................31223.2.1 How to use this driver..................................................................... 31223.2.2 Initialization and Configuration functions........................................ 31423.2.3 IO operation functions .................................................................... 31423.2.4 Peripheral State and Errors functions ............................................ 31623.2.5 HAL_IRDA_Init ............................................................................... 31623.2.6 HAL_IRDA_DeInit........................................................................... 31623.2.7 HAL_IRDA_MspInit ........................................................................ 31623.2.8 HAL_IRDA_MspDeInit.................................................................... 31723.2.9 HAL_IRDA_Transmit...................................................................... 31723.2.10 HAL_IRDA_Receive....................................................................... 31723.2.11 HAL_IRDA_Transmit_IT................................................................. 31723.2.12 HAL_IRDA_Receive_IT.................................................................. 31823.2.13 HAL_IRDA_Transmit_DMA............................................................ 31823.2.14 HAL_IRDA_Receive_DMA............................................................. 31823.2.15 HAL_IRDA_DMAPause.................................................................. 31923.2.16 HAL_IRDA_DMAResume............................................................... 31923.2.17 HAL_IRDA_DMAStop..................................................................... 31923.2.18 HAL_IRDA_IRQHandler................................................................. 31923.2.19 HAL_IRDA_TxCpltCallback............................................................ 32023.2.20 HAL_IRDA_TxHalfCpltCallback ..................................................... 32023.2.21 HAL_IRDA_RxCpltCallback ........................................................... 32023.2.22 HAL_IRDA_RxHalfCpltCallback..................................................... 320Contents UM185016/655 DOCID027328 Rev 123.2.23 HAL_IRDA_ErrorCallback .............................................................. 32023.2.24 HAL_IRDA_GetState...................................................................... 32123.2.25 HAL_IRDA_GetError ...................................................................... 32123.3 IRDA Firmware driver defines .......................................................32123.3.1 IRDA ............................................................................................... 32124 HAL IWDG Generic Driver........................................................... 32824.1 IWDG Firmware driver registers structures ...................................32824.1.1 IWDG_InitTypeDef ......................................................................... 32824.1.2 IWDG_HandleTypeDef................................................................... 32824.2 IWDG Firmware driver API description .........................................32824.2.1 IWDG specific features................................................................... 32824.2.2 How to use this driver..................................................................... 32924.2.3 Initialization and de-initialization functions ..................................... 32924.2.4 IO operation functions .................................................................... 33024.2.5 Peripheral State functions .............................................................. 33024.2.6 HAL_IWDG_Init .............................................................................. 33024.2.7 HAL_IWDG_MspInit ....................................................................... 33024.2.8 HAL_IWDG_Start ........................................................................... 33024.2.9 HAL_IWDG_Refresh ...................................................................... 33124.2.10 HAL_IWDG_GetState..................................................................... 33124.3 IWDG Firmware driver defines ......................................................33124.3.1 IWDG.............................................................................................. 33125 HAL NAND Generic Driver.......................................................... 33425.1 NAND Firmware driver registers structures...................................33425.1.1 NAND_IDTypeDef .......................................................................... 33425.1.2 NAND_AddressTypedef ................................................................. 33425.1.3 NAND_InfoTypeDef........................................................................ 33425.1.4 NAND_HandleTypeDef .................................................................. 33525.2 NAND Firmware driver API description .........................................33525.2.1 How to use this driver..................................................................... 33525.2.2 NAND Initialization and de-initialization functions .......................... 33625.2.3 NAND Input and Output functions .................................................. 33625.2.4 NAND Control functions ................................................................. 33625.2.5 NAND State functions..................................................................... 33725.2.6 HAL_NAND_Init.............................................................................. 33725.2.7 HAL_NAND_DeInit......................................................................... 33725.2.8 HAL_NAND_MspInit....................................................................... 337UM1850 ContentsDOCID027328 Rev 1 17/65525.2.9 HAL_NAND_MspDeInit .................................................................. 33725.2.10 HAL_NAND_IRQHandler ............................................................... 33825.2.11 HAL_NAND_ITCallback ................................................................. 33825.2.12 HAL_NAND_Read_ID .................................................................... 33825.2.13 HAL_NAND_Reset......................................................................... 33825.2.14 HAL_NAND_Read_Page ............................................................... 33925.2.15 HAL_NAND_Write_Page................................................................ 33925.2.16 HAL_NAND_Read_SpareArea ...................................................... 33925.2.17 HAL_NAND_Write_SpareArea....................................................... 33925.2.18 HAL_NAND_Erase_Block .............................................................. 34025.2.19 HAL_NAND_Read_Status ............................................................. 34025.2.20 HAL_NAND_Address_Inc .............................................................. 34025.2.21 HAL_NAND_ECC_Enable ............................................................. 34125.2.22 HAL_NAND_ECC_Disable............................................................. 34125.2.23 HAL_NAND_GetECC..................................................................... 34125.2.24 HAL_NAND_GetState .................................................................... 34125.2.25 HAL_NAND_Read_Status ............................................................. 34225.3 NAND Firmware driver defines......................................................34225.3.1 NAND.............................................................................................. 34226 HAL NOR Generic Driver............................................................. 34426.1 NOR Firmware driver registers structures.....................................34426.1.1 NOR_IDTypeDef ............................................................................ 34426.1.2 NOR_CFITypeDef .......................................................................... 34426.1.3 NOR_HandleTypeDef..................................................................... 34426.2 NOR Firmware driver API description ...........................................34526.2.1 How to use this driver..................................................................... 34526.2.2 NOR Initialization and de_initialization functions ........................... 34626.2.3 NOR Input and Output functions .................................................... 34626.2.4 NOR Control functions.................................................................... 34626.2.5 NOR State functions....................................................................... 34626.2.6 HAL_NOR_Init................................................................................ 34626.2.7 HAL_NOR_DeInit ........................................................................... 34726.2.8 HAL_NOR_MspInit......................................................................... 34726.2.9 HAL_NOR_MspDeInit .................................................................... 34726.2.10 HAL_NOR_MspWait....................................................................... 34726.2.11 HAL_NOR_Read_ID ...................................................................... 34826.2.12 HAL_NOR_ReturnToReadMode.................................................... 34826.2.13 HAL_NOR_Read ............................................................................ 348Contents UM185018/655 DOCID027328 Rev 126.2.14 HAL_NOR_Program....................................................................... 34826.2.15 HAL_NOR_ReadBuffer .................................................................. 34926.2.16 HAL_NOR_ProgramBuffer............................................................. 34926.2.17 HAL_NOR_Erase_Block ................................................................ 34926.2.18 HAL_NOR_Erase_Chip.................................................................. 35026.2.19 HAL_NOR_Read_CFI .................................................................... 35026.2.20 HAL_NOR_WriteOperation_Enable ............................................... 35026.2.21 HAL_NOR_WriteOperation_Disable .............................................. 35026.2.22 HAL_NOR_GetState ...................................................................... 35126.2.23 HAL_NOR_GetStatus..................................................................... 35126.3 NOR Firmware driver defines........................................................35126.3.1 NOR................................................................................................ 35127 HAL PCCARD Generic Driver ..................................................... 35427.1 PCCARD Firmware driver registers structures..............................35427.1.1 PCCARD_HandleTypeDef ............................................................. 35427.2 PCCARD Firmware driver API description ....................................35427.2.1 How to use this driver..................................................................... 35427.2.2 PCCARD Initialization and de-initialization functions ..................... 35527.2.3 PCCARD Input Output and memory functions ............................... 35527.2.4 PCCARD Peripheral State functions .............................................. 35527.2.5 HAL_PCCARD_Init......................................................................... 35527.2.6 HAL_PCCARD_DeInit.................................................................... 35627.2.7 HAL_PCCARD_MspInit.................................................................. 35627.2.8 HAL_PCCARD_MspDeInit ............................................................. 35627.2.9 HAL_CF_Read_ID.......................................................................... 35627.2.10 HAL_CF_Read_Sector................................................................... 35727.2.11 HAL_CF_Write_Sector................................................................... 35727.2.12 HAL_CF_Erase_Sector.................................................................. 35727.2.13 HAL_CF_Reset .............................................................................. 35827.2.14 HAL_PCCARD_IRQHandler .......................................................... 35827.2.15 HAL_PCCARD_ITCallback ............................................................ 35827.2.16 HAL_PCCARD_GetState ............................................................... 35827.2.17 HAL_CF_GetStatus........................................................................ 35927.2.18 HAL_CF_ReadStatus ..................................................................... 35927.3 PCCARD Firmware driver defines.................................................35927.3.1 PCCARD ........................................................................................ 35928 HAL PCD Generic Driver............................................................. 36128.1 PCD Firmware driver registers structures .....................................361UM1850 ContentsDOCID027328 Rev 1 19/65528.1.1 PCD_HandleTypeDef..................................................................... 36128.2 PCD Firmware driver API description............................................36128.2.1 How to use this driver..................................................................... 36128.2.2 Initialization and de-initialization functions ..................................... 36228.2.3 IO operation functions .................................................................... 36228.2.4 Peripheral Control functions ........................................................... 36228.2.5 Peripheral State functions .............................................................. 36328.2.6 HAL_PCD_Init ................................................................................ 36328.2.7 HAL_PCD_DeInit............................................................................ 36328.2.8 HAL_PCD_MspInit ......................................................................... 36328.2.9 HAL_PCD_MspDeInit..................................................................... 36328.2.10 HAL_PCD_Start ............................................................................. 36428.2.11 HAL_PCD_Stop.............................................................................. 36428.2.12 HAL_PCD_IRQHandler.................................................................. 36428.2.13 HAL_PCD_DataOutStageCallback ................................................ 36428.2.14 HAL_PCD_DataInStageCallback ................................................... 36428.2.15 HAL_PCD_SetupStageCallback .................................................... 36528.2.16 HAL_PCD_SOFCallback................................................................ 36528.2.17 HAL_PCD_ResetCallback.............................................................. 36528.2.18 HAL_PCD_SuspendCallback......................................................... 36528.2.19 HAL_PCD_ResumeCallback.......................................................... 36528.2.20 HAL_PCD_ISOOUTIncompleteCallback........................................ 36628.2.21 HAL_PCD_ISOINIncompleteCallback............................................ 36628.2.22 HAL_PCD_ConnectCallback.......................................................... 36628.2.23 HAL_PCD_DisconnectCallback ..................................................... 36628.2.24 HAL_PCD_DevConnect ................................................................. 36628.2.25 HAL_PCD_DevDisconnect............................................................. 36728.2.26 HAL_PCD_SetAddress .................................................................. 36728.2.27 HAL_PCD_EP_Open ..................................................................... 36728.2.28 HAL_PCD_EP_Close..................................................................... 36728.2.29 HAL_PCD_EP_Receive ................................................................. 36828.2.30 HAL_PCD_EP_GetRxCount .......................................................... 36828.2.31 HAL_PCD_EP_Transmit ................................................................ 36828.2.32 HAL_PCD_EP_SetStall.................................................................. 36828.2.33 HAL_PCD_EP_ClrStall................................................................... 36928.2.34 HAL_PCD_EP_Flush ..................................................................... 36928.2.35 HAL_PCD_ActiveRemoteWakeup ................................................. 36928.2.36 HAL_PCD_DeActiveRemoteWakeup............................................. 369Contents UM185020/655 DOCID027328 Rev 128.2.37 HAL_PCD_GetState....................................................................... 36928.3 PCD Firmware driver defines ........................................................37028.3.1 PCD ................................................................................................ 37029 HAL PCD Extension Driver......................................................... 37929.1 PCDEx Firmware driver API description .......................................37929.1.1 Extended Peripheral Control functions........................................... 37929.1.2 HAL_PCDEx_PMAConfig .............................................................. 37929.1.3 HAL_PCDEx_SetConnectionState................................................. 37929.2 PCDEx Firmware driver defines....................................................37929.2.1 PCDEx............................................................................................ 38030 HAL PWR Generic Driver............................................................ 38130.1 PWR Firmware driver registers structures ....................................38130.1.1 PWR_PVDTypeDef ........................................................................ 38130.2 PWR Firmware driver API description...........................................38130.2.1 Initialization and de-initialization functions ..................................... 38130.2.2 Peripheral Control functions ........................................................... 38130.2.3 HAL_PWR_DeInit........................................................................... 38330.2.4 HAL_PWR_EnableBkUpAccess .................................................... 38430.2.5 HAL_PWR_DisableBkUpAccess.................................................... 38430.2.6 HAL_PWR_ConfigPVD .................................................................. 38430.2.7 HAL_PWR_EnablePVD.................................................................. 38430.2.8 HAL_PWR_DisablePVD................................................................. 38430.2.9 HAL_PWR_EnableWakeUpPin...................................................... 38530.2.10 HAL_PWR_DisableWakeUpPin ..................................................... 38530.2.11 HAL_PWR_EnterSLEEPMode....................................................... 38530.2.12 HAL_PWR_EnterSTOPMode......................................................... 38530.2.13 HAL_PWR_EnterSTANDBYMode ................................................. 38630.2.14 HAL_PWR_EnableSleepOnExit..................................................... 38630.2.15 HAL_PWR_DisableSleepOnExit .................................................... 38730.2.16 HAL_PWR_EnableSEVOnPend .................................................... 38730.2.17 HAL_PWR_DisableSEVOnPend.................................................... 38730.2.18 HAL_PWR_PVD_IRQHandler........................................................ 38730.2.19 HAL_PWR_PVDCallback............................................................... 38730.3 PWR Firmware driver defines .......................................................38830.3.1 PWR ............................................................................................... 38831 HAL RCC Generic Driver............................................................. 39331.1 RCC Firmware driver registers structures .....................................393UM1850 ContentsDOCID027328 Rev 1 21/65531.1.1 RCC_PLLInitTypeDef..................................................................... 39331.1.2 RCC_ClkInitTypeDef ...................................................................... 39331.2 RCC Firmware driver API description ...........................................39431.2.1 RCC specific features..................................................................... 39431.2.2 RCC Limitations.............................................................................. 39431.2.3 Initialization and de-initialization functions ..................................... 39431.2.4 Peripheral Control functions ........................................................... 39531.2.5 HAL_RCC_DeInit ........................................................................... 39631.2.6 HAL_RCC_OscConfig.................................................................... 39631.2.7 HAL_RCC_ClockConfig ................................................................. 39631.2.8 HAL_RCC_MCOConfig.................................................................. 39731.2.9 HAL_RCC_EnableCSS .................................................................. 39831.2.10 HAL_RCC_DisableCSS ................................................................. 39831.2.11 HAL_RCC_GetSysClockFreq ........................................................ 39831.2.12 HAL_RCC_GetHCLKFreq.............................................................. 39931.2.13 HAL_RCC_GetPCLK1Freq ............................................................ 39931.2.14 HAL_RCC_GetPCLK2Freq ............................................................ 39931.2.15 HAL_RCC_GetOscConfig .............................................................. 40031.2.16 HAL_RCC_GetClockConfig ........................................................... 40031.2.17 HAL_RCC_NMI_IRQHandler ......................................................... 40031.2.18 HAL_RCC_CSSCallback................................................................ 40031.3 RCC Firmware driver defines........................................................40031.3.1 RCC................................................................................................ 40132 HAL RCC Extension Driver......................................................... 41432.1 RCCEx Firmware driver registers structures.................................41432.1.1 RCC_OscInitTypeDef..................................................................... 41432.1.2 RCC_PeriphCLKInitTypeDef.......................................................... 41432.2 RCCEx Firmware driver API description .......................................41532.2.1 Extended Peripheral Control functions........................................... 41532.2.2 HAL_RCCEx_PeriphCLKConfig..................................................... 41532.2.3 HAL_RCCEx_GetPeriphCLKConfig............................................... 41632.2.4 HAL_RCCEx_GetPeriphCLKFreq.................................................. 41632.3 RCCEx Firmware driver defines....................................................41632.3.1 RCCEx............................................................................................ 41633 HAL RTC Generic Driver............................................................. 42533.1 RTC Firmware driver registers structures .....................................42533.1.1 RTC_TimeTypeDef......................................................................... 425Contents UM185022/655 DOCID027328 Rev 133.1.2 RTC_AlarmTypeDef ....................................................................... 42533.1.3 RTC_InitTypeDef............................................................................ 42533.1.4 RTC_DateTypeDef ......................................................................... 42633.1.5 RTC_HandleTypeDef ..................................................................... 42633.2 RTC Firmware driver API description............................................42733.2.1 How to use this driver..................................................................... 42733.2.2 WARNING: Drivers Restrictions..................................................... 42733.2.3 Backup Domain Operating Condition............................................. 42833.2.4 Backup Domain Reset.................................................................... 42833.2.5 Backup Domain Access.................................................................. 42833.2.6 RTC and low power modes ............................................................ 42933.2.7 Initialization and de-initialization functions ..................................... 42933.2.8 RTC Time and Date functions ........................................................ 42933.2.9 RTC Alarm functions ...................................................................... 42933.2.10 Peripheral State functions .............................................................. 43033.2.11 Peripheral Control functions ........................................................... 43033.2.12 HAL_RTC_Init ................................................................................ 43033.2.13 HAL_RTC_DeInit............................................................................ 43033.2.14 HAL_RTC_MspInit.......................................................................... 43033.2.15 HAL_RTC_MspDeInit ..................................................................... 43033.2.16 HAL_RTC_SetTime........................................................................ 43133.2.17 HAL_RTC_GetTime ....................................................................... 43133.2.18 HAL_RTC_SetDate ........................................................................ 43133.2.19 HAL_RTC_GetDate........................................................................ 43233.2.20 HAL_RTC_SetAlarm ...................................................................... 43233.2.21 HAL_RTC_SetAlarm_IT ................................................................. 43233.2.22 HAL_RTC_GetAlarm ...................................................................... 43333.2.23 HAL_RTC_DeactivateAlarm........................................................... 43333.2.24 HAL_RTC_AlarmIRQHandler......................................................... 43333.2.25 HAL_RTC_AlarmAEventCallback .................................................. 43333.2.26 HAL_RTC_PollForAlarmAEvent..................................................... 43433.2.27 HAL_RTC_GetState....................................................................... 43433.2.28 HAL_RTC_WaitForSynchro ........................................................... 43433.3 RTC Firmware driver defines ........................................................43433.3.1 RTC ................................................................................................ 43534 HAL RTC Extension Driver ......................................................... 44234.1 RTCEx Firmware driver registers structures .................................44234.1.1 RTC_TamperTypeDef .................................................................... 442UM1850 ContentsDOCID027328 Rev 1 23/65534.2 RTCEx Firmware driver API description........................................44234.2.1 RTC Tamper functions ................................................................... 44234.2.2 RTC Second functions.................................................................... 44234.2.3 Extension Peripheral Control functions .......................................... 44234.2.4 HAL_RTCEx_SetTamper ............................................................... 44334.2.5 HAL_RTCEx_SetTamper_IT.......................................................... 44334.2.6 HAL_RTCEx_DeactivateTamper ................................................... 44334.2.7 HAL_RTCEx_TamperIRQHandler ................................................. 44434.2.8 HAL_RTCEx_Tamper1EventCallback ........................................... 44434.2.9 HAL_RTCEx_PollForTamper1Event.............................................. 44434.2.10 HAL_RTCEx_SetSecond_IT .......................................................... 44434.2.11 HAL_RTCEx_DeactivateSecond.................................................... 44434.2.12 HAL_RTCEx_RTCIRQHandler ...................................................... 44534.2.13 HAL_RTCEx_RTCEventCallback .................................................. 44534.2.14 HAL_RTCEx_RTCEventErrorCallback .......................................... 44534.2.15 HAL_RTCEx_BKUPWrite............................................................... 44534.2.16 HAL_RTCEx_BKUPRead .............................................................. 44634.2.17 HAL_RTCEx_SetSmoothCalib....................................................... 44634.3 RTCEx Firmware driver defines ....................................................44634.3.1 RTCEx ............................................................................................ 44635 HAL SD Generic Driver ............................................................... 45435.1 SD Firmware driver registers structures........................................45435.1.1 SD_HandleTypeDef........................................................................ 45435.1.2 HAL_SD_CSDTypedef................................................................... 45435.1.3 HAL_SD_CIDTypedef .................................................................... 45635.1.4 HAL_SD_CardStatusTypedef ........................................................ 45735.1.5 HAL_SD_CardInfoTypedef............................................................. 45835.2 SD Firmware driver API description ..............................................45835.2.1 How to use this driver..................................................................... 45835.2.2 Initialization and de-initialization functions ..................................... 46035.2.3 IO operation functions .................................................................... 46035.2.4 Peripheral Control functions ........................................................... 46135.2.5 Peripheral State functions .............................................................. 46135.2.6 HAL_SD_Init................................................................................... 46135.2.7 HAL_SD_DeInit .............................................................................. 46135.2.8 HAL_SD_MspInit ............................................................................ 46135.2.9 HAL_SD_MspDeInit ....................................................................... 46235.2.10 HAL_SD_ReadBlocks .................................................................... 462Contents UM185024/655 DOCID027328 Rev 135.2.11 HAL_SD_WriteBlocks..................................................................... 46235.2.12 HAL_SD_ReadBlocks_DMA .......................................................... 46335.2.13 HAL_SD_WriteBlocks_DMA .......................................................... 46335.2.14 HAL_SD_CheckReadOperation..................................................... 46335.2.15 HAL_SD_CheckWriteOperation ..................................................... 46435.2.16 HAL_SD_Erase .............................................................................. 46435.2.17 HAL_SD_IRQHandler..................................................................... 46435.2.18 HAL_SD_XferCpltCallback............................................................. 46435.2.19 HAL_SD_XferErrorCallback ........................................................... 46435.2.20 HAL_SD_DMA_RxCpltCallback..................................................... 46535.2.21 HAL_SD_DMA_RxErrorCallback ................................................... 46535.2.22 HAL_SD_DMA_TxCpltCallback ..................................................... 46535.2.23 HAL_SD_DMA_TxErrorCallback.................................................... 46535.2.24 HAL_SD_Get_CardInfo.................................................................. 46535.2.25 HAL_SD_WideBusOperation_Config............................................. 46635.2.26 HAL_SD_StopTransfer................................................................... 46635.2.27 HAL_SD_HighSpeed...................................................................... 46635.2.28 HAL_SD_SendSDStatus................................................................ 46735.2.29 HAL_SD_GetStatus........................................................................ 46735.2.30 HAL_SD_GetCardStatus................................................................ 46735.3 SD Firmware driver defines...........................................................46735.3.1 SD................................................................................................... 46736 HAL SMARTCARD Generic Driver.............................................. 48136.1 SMARTCARD Firmware driver registers structures ......................48136.1.1 SMARTCARD_InitTypeDef ............................................................ 48136.1.2 SMARTCARD_HandleTypeDef...................................................... 48236.2 SMARTCARD Firmware driver API description.............................48336.2.1 How to use this driver..................................................................... 48336.2.2 Initialization and Configuration functions........................................ 48536.2.3 IO operation functions .................................................................... 48536.2.4 Peripheral State and Errors functions ............................................ 48736.2.5 HAL_SMARTCARD_Init................................................................. 48736.2.6 HAL_SMARTCARD_DeInit ............................................................ 48736.2.7 HAL_SMARTCARD_MspInit .......................................................... 48836.2.8 HAL_SMARTCARD_MspDeInit ..................................................... 48836.2.9 HAL_SMARTCARD_Transmit........................................................ 48836.2.10 HAL_SMARTCARD_Receive......................................................... 48836.2.11 HAL_SMARTCARD_Transmit_IT .................................................. 489UM1850 ContentsDOCID027328 Rev 1 25/65536.2.12 HAL_SMARTCARD_Receive_IT ................................................... 48936.2.13 HAL_SMARTCARD_Transmit_DMA.............................................. 48936.2.14 HAL_SMARTCARD_Receive_DMA............................................... 49036.2.15 HAL_SMARTCARD_IRQHandler................................................... 49036.2.16 HAL_SMARTCARD_TxCpltCallback ............................................. 49036.2.17 HAL_SMARTCARD_RxCpltCallback ............................................. 49136.2.18 HAL_SMARTCARD_ErrorCallback................................................ 49136.2.19 HAL_SMARTCARD_GetState ....................................................... 49136.2.20 HAL_SMARTCARD_GetError........................................................ 49136.3 SMARTCARD Firmware driver defines .........................................49236.3.1 SMARTCARD................................................................................. 49237 HAL SPI Generic Driver............................................................... 50237.1 SPI Firmware driver registers structures .......................................50237.1.1 SPI_InitTypeDef ............................................................................. 50237.1.2 __SPI_HandleTypeDef................................................................... 50337.2 SPI Firmware driver API description .............................................50337.2.1 How to use this driver..................................................................... 50337.2.2 Initialization and de-initialization functions ..................................... 50537.2.3 IO operation functions .................................................................... 50637.2.4 Peripheral State and Errors functions ............................................ 50637.2.5 HAL_SPI_Init .................................................................................. 50737.2.6 HAL_SPI_DeInit ............................................................................. 50737.2.7 HAL_SPI_MspInit ........................................................................... 50737.2.8 HAL_SPI_MspDeInit....................................................................... 50737.2.9 HAL_SPI_Transmit......................................................................... 50837.2.10 HAL_SPI_Receive.......................................................................... 50837.2.11 HAL_SPI_TransmitReceive............................................................ 50837.2.12 HAL_SPI_Transmit_IT.................................................................... 50837.2.13 HAL_SPI_Receive_IT..................................................................... 50937.2.14 HAL_SPI_TransmitReceive_IT ...................................................... 50937.2.15 HAL_SPI_Transmit_DMA............................................................... 50937.2.16 HAL_SPI_Receive_DMA................................................................ 51037.2.17 HAL_SPI_TransmitReceive_DMA.................................................. 51037.2.18 HAL_SPI_DMAPause..................................................................... 51037.2.19 HAL_SPI_DMAResume ................................................................. 51037.2.20 HAL_SPI_DMAStop ....................................................................... 51137.2.21 HAL_SPI_IRQHandler.................................................................... 51137.2.22 HAL_SPI_TxCpltCallback .............................................................. 511Contents UM185026/655 DOCID027328 Rev 137.2.23 HAL_SPI_RxCpltCallback .............................................................. 51137.2.24 HAL_SPI_TxRxCpltCallback .......................................................... 51137.2.25 HAL_SPI_TxHalfCpltCallback ........................................................ 51237.2.26 HAL_SPI_RxHalfCpltCallback........................................................ 51237.2.27 HAL_SPI_TxRxHalfCpltCallback.................................................... 51237.2.28 HAL_SPI_ErrorCallback ................................................................. 51237.2.29 HAL_SPI_GetState......................................................................... 51337.2.30 HAL_SPI_GetError......................................................................... 51337.3 SPI Firmware driver defines..........................................................51337.3.1 SPI.................................................................................................. 51338 HAL SRAM Generic Driver.......................................................... 52238.1 SRAM Firmware driver registers structures...................................52238.1.1 SRAM_HandleTypeDef .................................................................. 52238.2 SRAM Firmware driver API description.........................................52238.2.1 How to use this driver..................................................................... 52238.2.2 SRAM Initialization and de_initialization functions ......................... 52338.2.3 SRAM Input and Output functions.................................................. 52338.2.4 SRAM Control functions ................................................................. 52338.2.5 SRAM State functions .................................................................... 52438.2.6 HAL_SRAM_Init ............................................................................. 52438.2.7 HAL_SRAM_DeInit......................................................................... 52438.2.8 HAL_SRAM_MspInit....................................................................... 52438.2.9 HAL_SRAM_MspDeInit.................................................................. 52438.2.10 HAL_SRAM_DMA_XferCpltCallback ............................................. 52538.2.11 HAL_SRAM_DMA_XferErrorCallback............................................ 52538.2.12 HAL_SRAM_Read_8b.................................................................... 52538.2.13 HAL_SRAM_Write_8b.................................................................... 52538.2.14 HAL_SRAM_Read_16b.................................................................. 52638.2.15 HAL_SRAM_Write_16b.................................................................. 52638.2.16 HAL_SRAM_Read_32b.................................................................. 52638.2.17 HAL_SRAM_Write_32b.................................................................. 52738.2.18 HAL_SRAM_Read_DMA................................................................ 52738.2.19 HAL_SRAM_Write_DMA................................................................ 52738.2.20 HAL_SRAM_WriteOperation_Enable............................................. 52838.2.21 HAL_SRAM_WriteOperation_Disable............................................ 52838.2.22 HAL_SRAM_GetState.................................................................... 52838.3 SRAM Firmware driver defines .....................................................52838.3.1 SRAM ............................................................................................. 528UM1850 ContentsDOCID027328 Rev 1 27/65539 HAL TIM Generic Driver .............................................................. 52939.1 TIM Firmware driver registers structures.......................................52939.1.1 TIM_Base_InitTypeDef................................................................... 52939.1.2 TIM_OC_InitTypeDef...................................................................... 52939.1.3 TIM_OnePulse_InitTypeDef ........................................................... 53039.1.4 TIM_IC_InitTypeDef ....................................................................... 53139.1.5 TIM_Encoder_InitTypeDef ............................................................. 53139.1.6 TIM_ClockConfigTypeDef .............................................................. 53239.1.7 TIM_ClearInputConfigTypeDef....................................................... 53239.1.8 TIM_SlaveConfigTypeDef .............................................................. 53339.1.9 TIM_HandleTypeDef ...................................................................... 53339.2 TIM Firmware driver API description .............................................53439.2.1 TIMER Generic features................................................................. 53439.2.2 How to use this driver..................................................................... 53439.2.3 Time Base functions ....................................................................... 53539.2.4 Time Output Compare functions .................................................... 53539.2.5 Time PWM functions ...................................................................... 53639.2.6 Time Input Capture functions ......................................................... 53639.2.7 Time One Pulse functions .............................................................. 53739.2.8 Time Encoder functions.................................................................. 53739.2.9 IRQ handler management .............................................................. 53839.2.10 Peripheral Control functions ........................................................... 53839.2.11 TIM Callbacks functions ................................................................. 53839.2.12 Peripheral State functions .............................................................. 53939.2.13 HAL_TIM_Base_Init ....................................................................... 53939.2.14 HAL_TIM_Base_DeInit................................................................... 53939.2.15 HAL_TIM_Base_MspInit................................................................. 53939.2.16 HAL_TIM_Base_MspDeInit............................................................ 53939.2.17 HAL_TIM_Base_Start..................................................................... 54039.2.18 HAL_TIM_Base_Stop..................................................................... 54039.2.19 HAL_TIM_Base_Start_IT ............................................................... 54039.2.20 HAL_TIM_Base_Stop_IT................................................................ 54039.2.21 HAL_TIM_Base_Start_DMA .......................................................... 54039.2.22 HAL_TIM_Base_Stop_DMA........................................................... 54139.2.23 HAL_TIM_OC_Init .......................................................................... 54139.2.24 HAL_TIM_OC_DeInit...................................................................... 54139.2.25 HAL_TIM_OC_MspInit ................................................................... 54139.2.26 HAL_TIM_OC_MspDeInit............................................................... 542Contents UM185028/655 DOCID027328 Rev 139.2.27 HAL_TIM_OC_Start ....................................................................... 54239.2.28 HAL_TIM_OC_Stop........................................................................ 54239.2.29 HAL_TIM_OC_Start_IT .................................................................. 54239.2.30 HAL_TIM_OC_Stop_IT .................................................................. 54339.2.31 HAL_TIM_OC_Start_DMA ............................................................. 54339.2.32 HAL_TIM_OC_Stop_DMA ............................................................. 54339.2.33 HAL_TIM_PWM_Init....................................................................... 54439.2.34 HAL_TIM_PWM_DeInit .................................................................. 54439.2.35 HAL_TIM_PWM_MspInit................................................................ 54439.2.36 HAL_TIM_PWM_MspDeInit ........................................................... 54439.2.37 HAL_TIM_PWM_Start.................................................................... 54439.2.38 HAL_TIM_PWM_Stop .................................................................... 54539.2.39 HAL_TIM_PWM_Start_IT............................................................... 54539.2.40 HAL_TIM_PWM_Stop_IT............................................................... 54539.2.41 HAL_TIM_PWM_Start_DMA.......................................................... 54639.2.42 HAL_TIM_PWM_Stop_DMA.......................................................... 54639.2.43 HAL_TIM_IC_Init ............................................................................ 54639.2.44 HAL_TIM_IC_DeInit ....................................................................... 54739.2.45 HAL_TIM_IC_MspInit ..................................................................... 54739.2.46 HAL_TIM_IC_MspDeInit................................................................. 54739.2.47 HAL_TIM_IC_Start ......................................................................... 54739.2.48 HAL_TIM_IC_Stop ......................................................................... 54739.2.49 HAL_TIM_IC_Start_IT.................................................................... 54839.2.50 HAL_TIM_IC_Stop_IT .................................................................... 54839.2.51 HAL_TIM_IC_Start_DMA............................................................... 54839.2.52 HAL_TIM_IC_Stop_DMA ............................................................... 54939.2.53 HAL_TIM_OnePulse_Init................................................................ 54939.2.54 HAL_TIM_OnePulse_DeInit ........................................................... 54939.2.55 HAL_TIM_OnePulse_MspInit......................................................... 54939.2.56 HAL_TIM_OnePulse_MspDeInit .................................................... 55039.2.57 HAL_TIM_OnePulse_Start............................................................. 55039.2.58 HAL_TIM_OnePulse_Stop ............................................................. 55039.2.59 HAL_TIM_OnePulse_Start_IT........................................................ 55039.2.60 HAL_TIM_OnePulse_Stop_IT........................................................ 55139.2.61 HAL_TIM_Encoder_Init .................................................................. 55139.2.62 HAL_TIM_Encoder_DeInit ............................................................. 55139.2.63 HAL_TIM_Encoder_MspInit ........................................................... 55139.2.64 HAL_TIM_Encoder_MspDeInit....................................................... 55239.2.65 HAL_TIM_Encoder_Start ............................................................... 552UM1850 ContentsDOCID027328 Rev 1 29/65539.2.66 HAL_TIM_Encoder_Stop ............................................................... 55239.2.67 HAL_TIM_Encoder_Start_IT .......................................................... 55239.2.68 HAL_TIM_Encoder_Stop_IT .......................................................... 55339.2.69 HAL_TIM_Encoder_Start_DMA ..................................................... 55339.2.70 HAL_TIM_Encoder_Stop_DMA ..................................................... 55339.2.71 HAL_TIM_IRQHandler ................................................................... 55439.2.72 HAL_TIM_OC_ConfigChannel ....................................................... 55439.2.73 HAL_TIM_IC_ConfigChannel......................................................... 55439.2.74 HAL_TIM_PWM_ConfigChannel.................................................... 55539.2.75 HAL_TIM_OnePulse_ConfigChannel............................................. 55539.2.76 HAL_TIM_DMABurst_WriteStart.................................................... 55539.2.77 HAL_TIM_DMABurst_WriteStop .................................................... 55639.2.78 HAL_TIM_DMABurst_ReadStart.................................................... 55639.2.79 HAL_TIM_DMABurst_ReadStop.................................................... 55739.2.80 HAL_TIM_GenerateEvent .............................................................. 55739.2.81 HAL_TIM_ConfigOCrefClear.......................................................... 55839.2.82 HAL_TIM_ConfigClockSource ....................................................... 55839.2.83 HAL_TIM_ConfigTI1Input............................................................... 55839.2.84 HAL_TIM_SlaveConfigSynchronization ......................................... 55939.2.85 HAL_TIM_SlaveConfigSynchronization_IT.................................... 55939.2.86 HAL_TIM_ReadCapturedValue...................................................... 55939.2.87 HAL_TIM_PeriodElapsedCallback ................................................. 56039.2.88 HAL_TIM_OC_DelayElapsedCallback........................................... 56039.2.89 HAL_TIM_IC_CaptureCallback ...................................................... 56039.2.90 HAL_TIM_PWM_PulseFinishedCallback ....................................... 56039.2.91 HAL_TIM_TriggerCallback ............................................................. 56039.2.92 HAL_TIM_ErrorCallback................................................................. 56139.2.93 HAL_TIM_Base_GetState.............................................................. 56139.2.94 HAL_TIM_OC_GetState................................................................. 56139.2.95 HAL_TIM_PWM_GetState ............................................................. 56139.2.96 HAL_TIM_IC_GetState................................................................... 56139.2.97 HAL_TIM_OnePulse_GetState ...................................................... 56239.2.98 HAL_TIM_Encoder_GetState......................................................... 56239.3 TIM Firmware driver defines..........................................................56239.3.1 TIM.................................................................................................. 56240 HAL TIM Extension Driver........................................................... 58240.1 TIMEx Firmware driver registers structures...................................58240.1.1 TIM_HallSensor_InitTypeDef ......................................................... 582Contents UM185030/655 DOCID027328 Rev 140.1.2 TIM_BreakDeadTimeConfigTypeDef ............................................. 58240.1.3 TIM_MasterConfigTypeDef ............................................................ 58340.2 TIMEx Firmware driver API description.........................................58340.2.1 TIMER Extended features .............................................................. 58340.2.2 How to use this driver..................................................................... 58340.2.3 Timer Hall Sensor functions ........................................................... 58440.2.4 Timer Complementary Output Compare functions......................... 58540.2.5 Timer Complementary PWM functions........................................... 58540.2.6 Timer Complementary One Pulse functions................................... 58540.2.7 Peripheral Control functions ........................................................... 58640.2.8 Extension Callbacks functions........................................................ 58640.2.9 Extension Peripheral State functions ............................................. 58640.2.10 HAL_TIMEx_HallSensor_Init.......................................................... 58640.2.11 HAL_TIMEx_HallSensor_DeInit ..................................................... 58640.2.12 HAL_TIMEx_HallSensor_MspInit................................................... 58740.2.13 HAL_TIMEx_HallSensor_MspDeInit .............................................. 58740.2.14 HAL_TIMEx_HallSensor_Start....................................................... 58740.2.15 HAL_TIMEx_HallSensor_Stop ....................................................... 58740.2.16 HAL_TIMEx_HallSensor_Start_IT.................................................. 58840.2.17 HAL_TIMEx_HallSensor_Stop_IT.................................................. 58840.2.18 HAL_TIMEx_HallSensor_Start_DMA............................................. 58840.2.19 HAL_TIMEx_HallSensor_Stop_DMA............................................. 58840.2.20 HAL_TIMEx_OCN_Start................................................................. 58840.2.21 HAL_TIMEx_OCN_Stop................................................................. 58940.2.22 HAL_TIMEx_OCN_Start_IT ........................................................... 58940.2.23 HAL_TIMEx_OCN_Stop_IT ........................................................... 58940.2.24 HAL_TIMEx_OCN_Start_DMA ...................................................... 59040.2.25 HAL_TIMEx_OCN_Stop_DMA....................................................... 59040.2.26 HAL_TIMEx_PWMN_Start ............................................................. 59040.2.27 HAL_TIMEx_PWMN_Stop ............................................................. 59140.2.28 HAL_TIMEx_PWMN_Start_IT........................................................ 59140.2.29 HAL_TIMEx_PWMN_Stop_IT ........................................................ 59140.2.30 HAL_TIMEx_PWMN_Start_DMA................................................... 59240.2.31 HAL_TIMEx_PWMN_Stop_DMA ................................................... 59240.2.32 HAL_TIMEx_OnePulseN_Start ...................................................... 59240.2.33 HAL_TIMEx_OnePulseN_Stop ...................................................... 59340.2.34 HAL_TIMEx_OnePulseN_Start_IT................................................. 59340.2.35 HAL_TIMEx_OnePulseN_Stop_IT ................................................. 59340.2.36 HAL_TIMEx_ConfigCommutationEvent ......................................... 593UM1850 ContentsDOCID027328 Rev 1 31/65540.2.37 HAL_TIMEx_ConfigCommutationEvent_IT.................................... 59440.2.38 HAL_TIMEx_ConfigCommutationEvent_DMA............................... 59540.2.39 HAL_TIMEx_ConfigBreakDeadTime.............................................. 59540.2.40 HAL_TIMEx_MasterConfigSynchronization................................... 59640.2.41 HAL_TIMEx_CommutationCallback............................................... 59640.2.42 HAL_TIMEx_BreakCallback........................................................... 59640.2.43 TIMEx_DMACommutationCplt ....................................................... 59640.2.44 HAL_TIMEx_HallSensor_GetState ................................................ 59740.3 TIMEx Firmware driver defines .....................................................59740.3.1 TIMEx ............................................................................................. 59741 HAL UART Generic Driver........................................................... 59841.1 UART Firmware driver registers structures ...................................59841.1.1 UART_InitTypeDef ......................................................................... 59841.1.2 UART_HandleTypeDef................................................................... 59841.2 UART Firmware driver API description .........................................59941.2.1 How to use this driver..................................................................... 59941.2.2 Initialization and Configuration functions........................................ 60141.2.3 IO operation functions .................................................................... 60241.2.4 Peripheral Control functions ........................................................... 60341.2.5 Peripheral State and Errors functions ............................................ 60341.2.6 HAL_UART_Init .............................................................................. 60441.2.7 HAL_HalfDuplex_Init ...................................................................... 60441.2.8 HAL_LIN_Init .................................................................................. 60441.2.9 HAL_MultiProcessor_Init................................................................ 60541.2.10 HAL_UART_DeInit ......................................................................... 60541.2.11 HAL_UART_MspInit ....................................................................... 60541.2.12 HAL_UART_MspDeInit................................................................... 60541.2.13 HAL_UART_Transmit..................................................................... 60641.2.14 HAL_UART_Receive...................................................................... 60641.2.15 HAL_UART_Transmit_IT................................................................ 60641.2.16 HAL_UART_Receive_IT................................................................. 60741.2.17 HAL_UART_Transmit_DMA........................................................... 60741.2.18 HAL_UART_Receive_DMA............................................................ 60741.2.19 HAL_UART_DMAPause................................................................. 60741.2.20 HAL_UART_DMAResume ............................................................. 60841.2.21 HAL_UART_DMAStop ................................................................... 60841.2.22 HAL_UART_IRQHandler................................................................ 60841.2.23 HAL_UART_TxCpltCallback .......................................................... 608Contents UM185032/655 DOCID027328 Rev 141.2.24 HAL_UART_TxHalfCpltCallback .................................................... 60941.2.25 HAL_UART_RxCpltCallback .......................................................... 60941.2.26 HAL_UART_RxHalfCpltCallback.................................................... 60941.2.27 HAL_UART_ErrorCallback ............................................................. 60941.2.28 HAL_LIN_SendBreak ..................................................................... 61041.2.29 HAL_MultiProcessor_EnterMuteMode ........................................... 61041.2.30 HAL_MultiProcessor_ExitMuteMode.............................................. 61041.2.31 HAL_HalfDuplex_EnableTransmitter ............................................. 61041.2.32 HAL_HalfDuplex_EnableReceiver ................................................. 61141.2.33 HAL_UART_GetState..................................................................... 61141.2.34 HAL_UART_GetError..................................................................... 61141.3 UART Firmware driver defines ......................................................61141.3.1 UART.............................................................................................. 61142 HAL USART Generic Driver ........................................................ 62142.1 USART Firmware driver registers structures.................................62142.1.1 USART_InitTypeDef....................................................................... 62142.1.2 USART_HandleTypeDef ................................................................ 62142.2 USART Firmware driver API description .......................................62242.2.1 How to use this driver..................................................................... 62242.2.2 Initialization and Configuration functions........................................ 62442.2.3 IO operation functions .................................................................... 62542.2.4 Peripheral State and Errors functions ............................................ 62642.2.5 HAL_USART_Init............................................................................ 62642.2.6 HAL_USART_DeInit....................................................................... 62742.2.7 HAL_USART_MspInit..................................................................... 62742.2.8 HAL_USART_MspDeInit ................................................................ 62742.2.9 HAL_USART_Transmit .................................................................. 62742.2.10 HAL_USART_Receive ................................................................... 62842.2.11 HAL_USART_TransmitReceive ..................................................... 62842.2.12 HAL_USART_Transmit_IT ............................................................. 62842.2.13 HAL_USART_Receive_IT .............................................................. 62942.2.14 HAL_USART_TransmitReceive_IT ................................................ 62942.2.15 HAL_USART_Transmit_DMA ........................................................ 62942.2.16 HAL_USART_Receive_DMA ......................................................... 63042.2.17 HAL_USART_TransmitReceive_DMA ........................................... 63042.2.18 HAL_USART_DMAPause .............................................................. 63042.2.19 HAL_USART_DMAResume........................................................... 63142.2.20 HAL_USART_DMAStop................................................................. 631UM1850 ContentsDOCID027328 Rev 1 33/65542.2.21 HAL_USART_IRQHandler ............................................................. 63142.2.22 HAL_USART_TxCpltCallback ........................................................ 63142.2.23 HAL_USART_TxHalfCpltCallback.................................................. 63242.2.24 HAL_USART_RxCpltCallback........................................................ 63242.2.25 HAL_USART_RxHalfCpltCallback ................................................. 63242.2.26 HAL_USART_TxRxCpltCallback.................................................... 63242.2.27 HAL_USART_ErrorCallback .......................................................... 63242.2.28 HAL_USART_GetState .................................................................. 63342.2.29 HAL_USART_GetError................................................................... 63342.3 USART Firmware driver defines....................................................63342.3.1 USART............................................................................................ 63343 HAL WWDG Generic Driver ........................................................ 64143.1 WWDG Firmware driver registers structures.................................64143.1.1 WWDG_InitTypeDef....................................................................... 64143.1.2 WWDG_HandleTypeDef ................................................................ 64143.2 WWDG Firmware driver API description .......................................64143.2.1 WWDG specific features ................................................................ 64143.2.2 How to use this driver..................................................................... 64243.2.3 Initialization and de-initialization functions ..................................... 64243.2.4 IO operation functions .................................................................... 64343.2.5 Peripheral State functions .............................................................. 64343.2.6 HAL_WWDG_Init............................................................................ 64343.2.7 HAL_WWDG_DeInit....................................................................... 64343.2.8 HAL_WWDG_MspInit..................................................................... 64443.2.9 HAL_WWDG_MspDeInit ................................................................ 64443.2.10 HAL_WWDG_WakeupCallback ..................................................... 64443.2.11 HAL_WWDG_Start......................................................................... 64443.2.12 HAL_WWDG_Start_IT.................................................................... 64543.2.13 HAL_WWDG_Refresh.................................................................... 64543.2.14 HAL_WWDG_IRQHandler ............................................................. 64543.2.15 HAL_WWDG_WakeupCallback ..................................................... 64543.2.16 HAL_WWDG_GetState .................................................................. 64643.3 WWDG Firmware driver defines....................................................64643.3.1 WWDG............................................................................................ 64644 FAQs............................................................................................. 65045 Revision history .......................................................................... 654List of tables UM185034/655 DOCID027328 Rev 1List of tablesTable 1: Acronyms and definitions............................................................................................................36Table 2: HAL drivers files..........................................................................................................................38Table 3: User-application files ..................................................................................................................39Table 4: APis classification .......................................................................................................................44Table 5: List of devices supported by HAL drivers ...................................................................................45Table 7: HAL API naming rules ................................................................................................................51Table 8: Macros handling interrupts and specific clock configurations ....................................................52Table 9: Callback functions.......................................................................................................................53Table 10: HAL generic APIs .....................................................................................................................54Table 11: HAL extension APIs..................................................................................................................55Table 12: Define statements used for HAL configuration .........................................................................59Table 13: Description of GPIO_InitTypeDef structure ..............................................................................61Table 14: Description of EXTI configuration macros ................................................................................63Table 15: MSP functions...........................................................................................................................68Table 16: Timeout values .........................................................................................................................72Table 17: IRDA frame formats ................................................................................................................314Table 18: Number of wait states (WS) vs SYSCLK frequency ...............................................................395Table 19: Smartcard frame formats ........................................................................................................485Table 20: Maximum SPI frequency for 8-bit SPI data transfers .............................................................505Table 21: Maximum SPI frequency for 16-bit SPI data transfers ...........................................................505Table 22: UART frame formats...............................................................................................................602Table 23: USART frame formats ............................................................................................................625Table 24: Document revision history ......................................................................................................654
评论