stm32cubeide qspi

### 如何在 STM32CubeIDE 中配置和使用 QSPI

#### 配置QSPI外设

为了使STM32能够通过QSPI接口访问外部Flash，在STM32CubeMX中需先完成硬件抽象层(HAL)库初始化设置。启动STM32CubeMX软件并创建新项目，选择目标微控制器型号后进入Pinout&Configuration界面。

对于QSPI功能的支持，需要确保所选MCU支持此特性，并且正确连接到板上的物理引脚上[^1]。接着转至Connectivity标签页找到QUADSPI项激活它，调整参数使之匹配实际使用的外部存储设备规格，比如时钟频率、数据线宽度等选项。

#### 初始化函数生成

当上述配置完成后保存并生成代码，则会自动生成必要的初始化函数来配置QSPI接口。这些函数位于`stm32xxxx_it.c`(其中xxxx代表具体系列)文件中的`MX_QUADSPI_Init()`方法里：

static void MX_QUADSPI_Init(void)
{
  /* USER CODE BEGIN QUADSPI_Init 0 */

  /* USER CODE END QUADSPI_Init 0 */

  /* USER CODE BEGIN QUADSPI_Init 1 */

  /* USER CODE END QUADSPI_Init 1 */
  hqspi.Instance = QUADSPI;
  hqspi.Init.ClockPrescaler = 1;
  hqspi.Init.FifoThreshold = 4;
  hqspi.Init.SampleShifting = QSPI_SAMPLE_SHIFTING_HALFCYCLE;
  hqspi.Init.FlashSize = 24;
  hqspi.Init.ChipSelectHighTime = QSPI_CS_HIGH_TIME_6_CYCLE;
  hqspi.Init.ClockMode = QSPI_CLOCK_MODE_0;
  if (HAL_QSPI_Init(&hqspi) != HAL_OK)
  {
    Error_Handler();
  }
  /* USER CODE BEGIN QUADSPI_Init 2 */

  /* USER CODE END QUADSPI_Init 2 */
}

这段代码实现了对QSPI模块的基本设定，包括但不限于工作模式的选择、传输速率的定义等方面的内容。

#### 编写读写操作函数

除了调用标准API实现简单的擦除、编程及读取命令之外，还可以根据应用需求编写更复杂的存取逻辑。例如下面展示了一个向指定地址写入一定长度字节序列的例子：

void QSPI_Write(uint8_t* pData, uint32_t WriteAddr, uint32_t Size)
{
  QSPI_CommandTypeDef sCommand;

  /* Initialize the program command */
  sCommand.InstructionMode   = QSPI_INSTRUCTION_1_LINE;
  sCommand.AddressMode       = QSPI_ADDRESS_1_LINE;
  sCommand.DataMode          = QSPI_DATA_1_LINE;
  sCommand.DummyCycles       = 0;
  sCommand.NbData            = Size;
  
  // ...其他必要字段赋值...

  /* Configure the command */
  sCommand.Instruction      = WRITE_ENABLE_CMD;     // 发送写允许指令
  
  if (HAL_QSPI_Command(&hqspi, &sCommand, HAL_QPSI_TIMEOUT_DEFAULT_VALUE) != HAL_OK){
      // 错误处理...
  }

  sCommand.Instruction      = PAGE_PROG_CMD;        // 执行页面编程
  
  if (HAL_QSPI_Transmit(&hqspi, &sCommand, pData, HAL_QPSI_TIMEOUT_DEFAULT_VALUE) != HAL_OK){
      // 错误处理...
  } 

  while(__HAL_QSPI_GET_FLAG(&hqspi, QSPI_FLAG_BUSY)){};
}

以上过程展示了如何利用STM32CubeIDE配合官方提供的驱动库来进行QSPI Flash的操作，从而扩展系统的可用存储空间[^4]。