HAL库源文件stm32h4xx_hal_qspi.c学习笔记
作者：互联网
说明：
QSPI的内存映射模式，自动查询模式和间接模式。
间接模式就是相对于内存映射时，可以是总线直接访问来说的。
==============================================================================
##### 驱动如何使用 #####
==============================================================================
1、底层初始化HAL_QSPI_MspInit。
（1）__HAL_RCC_QSPI_CLK_ENABLE
（2）函数__HAL_RCC_QSPI_FORCE_RESET() 配合 __HAL_RCC_QSPI_RELEASE_RESET()可复位QSPI（3）__HAL_RCC_GPIOx_CLK_ENABLE
（3）HAL_GPIO_Init配置复用模式
（4）如果使用中断模式，调用函数HAL_NVIC_SetPriority() 和 HAL_NVIC_EnableIRQ()设置
（5）使用DMA传输时，用的是MDMA，
a、__HAL_RCC_MDMA_CLK_ENABLE
b、HAL_MDMA_Init
c、__HAL_LINKDMA
如果需要中断处理，需要配置NVIC
a、HAL_NVIC_SetPriority
b、HAL_NVIC_EnableIRQ
c、SDMMC的中断使能和禁止函数__HAL_SD_ENABLE_IT，__HAL_SD_DISABLE_IT
d、中断标志位处理__HAL_SD_GET_IT和__HAL_SD_CLEAR_IT
e、SDMCC不需要通用的DMA，因为内部自带一个DMA。
（7）函数HAL_QSPI_Init配置flash大小，时钟分频，fifo阀值，时钟模式，采样偏移，CS高电平时间。
2、间接模式
（1）函数HAL_QSPI_Command或者HAL_QSPI_Command_IT配置命令时序
a、这几个阶段都是可以配置是否使用的。
b、指令阶段。
c、地址阶段。
d、可选字节阶段。
e、空周期阶段。
f、数据阶段。
DDR模式配置，时钟的上升沿和下降沿均可做数据收发。
Sending Instruction Only Once (SIOO)模式配置，这种模式发送一次指令后，就可以方便的做读写操作，不过需要外部Flash支持这种模式才行。
（2）如果命令不需要数据，则将其直接发送到内存：
在轮询模式下，输出功能在传输完成时完成。
在中断模式下，传输完成后将调用HAL_QSPI_CmdCpltCallback。
（3）间接模式写操作可以调用use HAL_QSPI_Transmit(), HAL_QSPI_Transmit_DMA() 或者 HAL_QSPI_Transmit_IT()
a、在轮询模式下，写操作在传输完成时完成。
b、在中断模式，达到FIFO阀值的时调用回调函数HAL_QSPI_FifoThresholdCallback，传输完成的时候调用回调函数HAL_QSPI_TxCpltCallback。
c、在DMA模式，半传输完成的时候调用回调函数HAL_QSPI_TxHalfCpltCallback，而全部传输完成的时候调用回调函数HAL_QSPI_TxCpltCallback
（4）间接模式读操作可以调用HAL_QSPI_Receive(), HAL_QSPI_Receive_DMA() 或者 HAL_QSPI_Receive_IT()
a、在轮询模式下，读操作在传输完成时完成。
b、在中断模式，达到FIFO阀值的时调用回调函数HAL_QSPI_FifoThresholdCallback，传输完成的时候调用回调函数HAL_QSPI_RxCpltCallback。
c、在DMA模式，半传输完成的时候调用回调函数HAL_QSPI_RxHalfCpltCallback，而全部传输完成的时候调用回调函数HAL_QSPI_RxCpltCallback。
3、自动查询模式
（1）函数HAL_QSPI_AutoPolling() 或者 HAL_QSPI_AutoPolling_IT()配置时序
a、这几个阶段都是可以配置是否使用的。
b、指令阶段。
c、地址阶段。
d、可选字节阶段。
e、空周期阶段。
f、数据阶段。
g、Sending Instruction Only Once (SIOO)模式配置，这种模式发送一次指令后，就可以方便的做读写操作，不过需要外部Flash支持这种模式才行。
h、状态字节的大小，匹配值，使用的掩码，匹配模式（OR / AND），轮询间隔和激活自动停止。
（2）配置完成后：
a、在轮询模式下，写操作在达到状态匹配时完成，同时激活自动停止以避免无限循环。
b、在中断模式下，每次状态匹配时都会调用HAL_QSPI_StatusMatchCallback（）。
4、内存映射模式
（1）函数HAL_QSPI_MemoryMapped配置命令时序和内存映射
a、这几个阶段都是可以配置是否使用的。
b、指令阶段。
c、地址阶段。
d、可选字节阶段。
e、空周期阶段。
f、数据阶段。
g、DR模式配置，时钟的上升沿和下降沿均可做数据收发。
h、Sending Instruction Only Once (SIOO)模式配置，这种模式发送一次指令后，就可以方便的做读写操作，不过需要外部Flash支持这种模式才行。
i、超时激活和超时时间。
（2）配置完成后，只要地址范围内的AHB总线访问完成，就会使用QuadSPI。超时到期时将调用HAL_QSPI_TimeOutCallback（）。
5、错误管理和终止功能
（1）HAL_QSPI_GetError（）函数给出上一次操作期间引发的错误。
（2）HAL_QSPI_Abort（）和HAL_QSPI_AbortIT（）函数中止任何正在进行的操作并刷新fifo：
a、在轮询模式下，当传输完成位被置位，忙位清零时，写操作完成。
b、在中断模式下，当传输完成位被置位时，回调函数HAL_QSPI_AbortCpltCallback（）将被调用。
6、控制和状态获取功能
（1）HAL_QSPI_GetState() 用于获取当前的驱动状态f。
（2）HAL_QSPI_SetTimeout() 配置溢出时间。
（3）HAL_QSPI_SetFifoThreshold() 配置FIFO的阀值。
（4）HAL_QSPI_GetFifoThreshold() 给出当前的FIFO阀值。
7、QSPI的一个勘误处理：
在读传输结束时写入FIFO的额外数据
/* 初始化和复位初始化 */
HAL_StatusTypeDef HAL_QSPI_Init (QSPI_HandleTypeDef *hqspi);
HAL_StatusTypeDef HAL_QSPI_DeInit (QSPI_HandleTypeDef *hqspi);
void HAL_QSPI_MspInit (QSPI_HandleTypeDef *hqspi);
void HAL_QSPI_MspDeInit(QSPI_HandleTypeDef *hqspi);
/* QSPI IRQ */
void HAL_QSPI_IRQHandler(QSPI_HandleTypeDef *hqspi);
/* QSPI 间接模式 */
HAL_StatusTypeDef HAL_QSPI_Command (QSPI_HandleTypeDef *hqspi, QSPI_CommandTypeDef *cmd, uint32_t Timeout);
HAL_StatusTypeDef HAL_QSPI_Transmit (QSPI_HandleTypeDef *hqspi, uint8_t *pData, uint32_t Timeout);
HAL_StatusTypeDef HAL_QSPI_Receive (QSPI_HandleTypeDef *hqspi, uint8_t *pData, uint32_t Timeout);
HAL_StatusTypeDef HAL_QSPI_Command_IT (QSPI_HandleTypeDef *hqspi, QSPI_CommandTypeDef *cmd);
HAL_StatusTypeDef HAL_QSPI_Transmit_IT (QSPI_HandleTypeDef *hqspi, uint8_t *pData);
HAL_StatusTypeDef HAL_QSPI_Receive_IT (QSPI_HandleTypeDef *hqspi, uint8_t *pData);
HAL_StatusTypeDef HAL_QSPI_Transmit_DMA (QSPI_HandleTypeDef *hqspi, uint8_t *pData);
HAL_StatusTypeDef HAL_QSPI_Receive_DMA (QSPI_HandleTypeDef *hqspi, uint8_t *pData);
/* QSPI 状态标志查询模式 */
HAL_StatusTypeDef HAL_QSPI_AutoPolling (QSPI_HandleTypeDef *hqspi, QSPI_CommandTypeDef *cmd, QSPI_AutoPollingTypeDef *cfg, uint32_t Timeout);
HAL_StatusTypeDef HAL_QSPI_AutoPolling_IT(QSPI_HandleTypeDef *hqspi, QSPI_CommandTypeDef *cmd, QSPI_AutoPollingTypeDef *cfg);
/* QSPI 内存映射模式 */
HAL_StatusTypeDef HAL_QSPI_MemoryMapped(QSPI_HandleTypeDef *hqspi, QSPI_CommandTypeDef *cmd, QSPI_MemoryMappedTypeDef *cfg);
/* 非阻塞回调函数 */
void HAL_QSPI_ErrorCallback (QSPI_HandleTypeDef *hqspi);
void HAL_QSPI_AbortCpltCallback (QSPI_HandleTypeDef *hqspi);
void HAL_QSPI_FifoThresholdCallback(QSPI_HandleTypeDef *hqspi);
/* QSPI 间接模式 */
void HAL_QSPI_CmdCpltCallback (QSPI_HandleTypeDef *hqspi);
void HAL_QSPI_RxCpltCallback (QSPI_HandleTypeDef *hqspi);
void HAL_QSPI_TxCpltCallback (QSPI_HandleTypeDef *hqspi);
void HAL_QSPI_RxHalfCpltCallback (QSPI_HandleTypeDef *hqspi);
void HAL_QSPI_TxHalfCpltCallback (QSPI_HandleTypeDef *hqspi);
/* QSPI 状态标志查询模式 */
void HAL_QSPI_StatusMatchCallback (QSPI_HandleTypeDef *hqspi);
/* QSPI 内存映射模式 */
void HAL_QSPI_TimeOutCallback (QSPI_HandleTypeDef *hqspi);
/* 外设控制和状态函数 */
HAL_QSPI_StateTypeDef HAL_QSPI_GetState (QSPI_HandleTypeDef *hqspi);
uint32_t HAL_QSPI_GetError (QSPI_HandleTypeDef *hqspi);
HAL_StatusTypeDef HAL_QSPI_Abort (QSPI_HandleTypeDef *hqspi);
HAL_StatusTypeDef HAL_QSPI_Abort_IT (QSPI_HandleTypeDef *hqspi);
void HAL_QSPI_SetTimeout (QSPI_HandleTypeDef *hqspi, uint32_t Timeout);
HAL_StatusTypeDef HAL_QSPI_SetFifoThreshold(QSPI_HandleTypeDef *hqspi, uint32_t Threshold);
uint32_t
标签：stm32h4xx,HAL,模式,源文件,HandleTypeDef,hqspi,StatusTypeDef,QSPI 来源： https://www.cnblogs.com/rongjiangwei/p/15686253.html