STM32hal 硬件SPI配置

### 使用 STM32 HAL 库进行硬件 SPI 配置

#### 初始化结构体定义
为了初始化 SPI 接口，需先创建 `SPI_HandleTypeDef` 类型的句柄变量。该句柄用于保存 SPI 外设的状态和其他参数。

SPI_HandleTypeDef hspi1;

#### 参数设置
通过调用 `MX_SPI1_Init()` 函数来完成外设的具体配置工作。此函数内部会填充 `hspi1.Init` 结构体成员，并最终调用 `HAL_SPI_Init(&hspi1)` 完成实际初始化操作[^1]。

具体来说，在 `MX_SPI1_Init()` 中可以设定如下属性：

- **Mode**: 设置为主模式 (`SPI_MODE_MASTER`) 或者从模式 (`SPI_MODE_SLAVE`)
- **Direction**: 数据传输方向可以选择单向发送 (`SPI_DIRECTION_2LINES_TXONLY`)、双向收发(`SPI_DIRECTION_2LINES`) 或仅接收 (`SPI_DIRECTION_1LINE`)
- **Data Size**: 每次交换的数据位宽支持 8bit 和 16bit
- **CLK Polarity & Phase**: 时钟极性和相位决定了通信双方同步信号的关系
- **NSS Management**: 片选线管理方式有软件控制和硬件自动处理两种选项
- **BaudRate Prescaler**: 波特率分频系数影响着 SCK 引脚上的频率高低
- **First Bit Transmission**: MSB-first 还是 LSB-first 发送顺序
- **TIM Mode**: 是否启用 TI 协议兼容模式
- **CRC Calculation State and Polynomial Value**: 循环冗余校验开启状态及其多项式值

这些参数的选择取决于外部设备的要求以及应用需求[^2]。

#### 实际代码示例
下面给出一段简单的初始化例子，假设目标是以主模式运行 SPI1 并连接到一个 NOR Flash 芯片上：

static void MX_SPI1_Init(void)
{
    /* USER CODE BEGIN SPI1_Init 0 */
    
    /* USER CODE END SPI1_Init 0 */

    /* USER CODE BEGIN SPI1_Init 1 */
  
    /* USER CODE END SPI1_Init 1 */
    hspi1.Instance = SPI1;
    hspi1.Init.Mode = SPI_MODE_MASTER;
    hspi1.Init.Direction = SPI_DIRECTION_2LINES;
    hspi1.Init.DataSize = SPI_DATASIZE_8BIT;
    hspi1.Init.CLKPolarity = SPI_POLARITY_LOW;
    hspi1.Init.CLKPhase = SPI_PHASE_1EDGE;
    hspi1.Init.NSS = SPI_NSS_SOFT;
    hspi1.Init.BaudRatePrescaler = SPI_BAUDRATEPRESCALER_16;
    hspi1.Init.FirstBit = SPI_FIRSTBIT_MSB;
    hspi1.Init.TIMode = SPI_TIMODE_DISABLE;
    hspi1.Init.CRCCalculation = SPI_CRCCALCULATION_DISABLE;
    hspi1.Init.CRCPolynomial = 7;
    hspi1.Init.CRCLength = SPI_CRC_LENGTH_DATASIZE;
    hspi1.Init.NSSPMode = SPI_NSS_PULSE_ENABLE;
    if (HAL_SPI_Init(&hspi1) != HAL_OK)
    {
        Error_Handler();
    }
}