stm32 hal库spi

### STM32 HAL库 SPI 使用教程

#### 创建SPI句柄并初始化
为了使用STM32 HAL库中的SPI功能，首先需要定义一个`SPI_HandleTypeDef`类型的变量作为SPI外设的操作句柄。对于SPI5而言：

SPI_HandleTypeDef hspi5;

接着，在主函数或其他适当位置调用初始化函数来设置该句柄的具体参数[^1]。

#### 配置SPI参数
利用STM32CubeMX工具可以简化这一过程。在图形界面中选择对应的SPI模块，并将其配置为全双工模式(Full-Duplex)，同时调整其他必要的选项如时钟频率、数据宽度等。另外还需要启用中断服务(NVIC Settings)[^2]。

#### 初始化函数实现
下面是一段用于初始化SPI5的C语言代码片段：

void MX_SPI5_Init(void)
{
  /* USER CODE BEGIN SPI5_Init 0 */

  /* USER CODE END SPI5_Init 0 */
  
  /* SPI5 parameter configuration*/
  hspi5.Instance = SPI5;
  hspi5.Init.Mode = SPI_MODE_MASTER;
  hspi5.Init.Direction = SPI_DIRECTION_2LINES;
  hspi5.Init.DataSize = SPI_DATASIZE_8BIT;
  hspi5.Init.CLKPolarity = SPI_POLARITY_LOW;
  hspi5.Init.CLKPhase = SPI_PHASE_1EDGE;
  hspi5.Init.NSS = SPI_NSS_SOFT;
  hspi5.Init.BaudRatePrescaler = SPI_BAUDRATEPRESCALER_16;
  hspi5.Init.FirstBit = SPI_FIRSTBIT_MSB;
  hspi5.Init.TIMode = SPI_TIMODE_DISABLE;
  hspi5.Init.CRCCalculation = SPI_CRCCALCULATION_DISABLE;
  hspi5.Init.CRCPolynomial = 7;
  hspi5.Init.CRCLength = SPI_CRC_LENGTH_DATASIZE;
  hspi5.Init.NSSPMode = SPI_NSS_PULSE_ENABLE;

  if (HAL_SPI_Init(&hspi5) != HAL_OK)
  {
    Error_Handler();
  }
}

这段代码设置了SPI的工作方式为主设备(Master Mode), 数据传输方向为双向(Two Lines Full Duplex)，每帧的数据长度设定为8位(Bit Size)，并且指定了同步信号(SPI_NSS)由软件控制而非硬件自动管理。此外还启用了NSS脉冲模式以确保每次发送前都会产生有效的片选信号。

#### 发送接收操作
完成上述初始化之后就可以执行实际的数据交换了。这里给出一段简单的例子展示如何向外部FLASH(W25Q128)写入单个字节以及从中读取数据:

uint8_t txData = 'A'; // 要发送给W25Q128的一个字符'A'
uint8_t rxData;       // 存储从W25Q128接收到的数据缓冲区

// 向指定地址写入数据
if(HAL_SPI_Transmit(&hspi5, &txData, 1, HAL_MAX_DELAY)!= HAL_OK){
    // 错误处理...
}

// 从指定地址读取数据
if(HAL_SPI_Receive(&hspi5, &rxData, 1, HAL_MAX_DELAY)!= HAL_OK){
    // 错误处理...
}

需要注意的是当与特定型号的外部器件比如这里的W25Q128进行交互时，应该遵循其命令集规范来进行相应的指令序列构建和解析工作[^3]。