G32S10 SPI Slave LL 接口

1. 资源模型与公开类型

1.1 寄存器块

struct spi_slv_regs {
    __IO uint32_t sslvctrl;
    __IO uint32_t sslvrxc;
    __IO uint32_t sslvtxc;
    __I  uint32_t sslvrxd;
    __O  uint32_t sslvtxd;
    __IO uint32_t sslvrxn;
    __IO uint32_t sslvtxn;
    __I  uint32_t sslvflr;
};

寄存器结构体成员使用小写原寄存器名，寄存器规格名称仍为 SSLVCTRL、SSLVRXC、SSLVTXC、SSLVRXD、SSLVTXD、SSLVRXN、SSLVTXN 和 SSLVFLR。

2. LL 接口规范

2.1 LL 通用约定

所有 LL 接口均为 static inline，不返回 SDK error_code_t，并遵循以下约定：

• spi_slvx 必须是有效且已具备模块时钟访问条件的 SPI_SLV0 或 SPI_SLV1。

• LL 不校验空指针、实例、枚举、位宽、阈值或计数时序。

• setter 直接写寄存器或执行 read-modify-write，调用方负责和 IRQ/其他执行上下文同步。

• 字段 setter 的 value 必须满足文档范围；不能依赖寄存器 mask 自动截断来接受非法值。

• LL 不管理 CPM 模块时钟、BSP 引脚、SoC IRQ 控制器或 HAL 句柄状态。

2.2 选择与环回控制

SEL 是 write-1 toggle 位，不是普通的“选择值”字段。每次有意切换只写 1 一次；随后 必须通过 ll_spi_slv_keep_select() 保持其为 0，避免其他 SSLVCTRL read-modify-write 再次切换。

非环回初始化流程需要在复位初始化阶段临时置 LOOP=1，结束后再清零。即使保持环回， 从机也不能自行产生 SCLK 和 CS，仍需主机提供相应信号。

2.3 原始状态读取

这些接口读取 SSLVCTRL 只读状态，不执行清除。TX_WRFLAG 还用于 TX DMA request，RX_RDFLAG 还用于 RX DMA request。

2.4 复位、时钟、聚合 IRQ 与总线模式

复位时间近似为：

reset_time = reset_count / internal_module_clock_hz

例如内部模块时钟为 100 MHz、reset_count=10 时，复位时间约为 100 ns。CKG_MASK 控制模块内部时钟门控，不代表从机能产生串行 SCLK。

2.5 RX 中断 mask

以下 LL 接口直接操作 SSLVRXC[31:26]。所有 mask 位均为 active-high：1 表示屏蔽， 0 表示放开。

单 bit setter 的 value 只能为 0 或 1；getter 返回 0 或 1。

2.6 RX 格式与阈值

RX_RDFLAG 的主要条件为 RX_FILL > RX_RDTHR，因此 RX_RDTHR=0 表示 FIFO 中大于 0 个 entry 时置位，RX_RDTHR=127 表示大于 127 个 entry 时置位。FIFO 深度为 128， HAL 将四个阈值统一限制为 0 至 127；LL 虽可写完整 8 bit 字段，调用方仍应根据 FIFO 深度和规格定义选择有效值。

2.7 TX 中断 mask

以下 LL 接口直接操作 SSLVTXC[31:26]，mask 语义同样为 1 屏蔽、0 放开。

单 bit setter 的 value 只能为 0 或 1；getter 返回 0 或 1。

2.8 TX 格式与阈值

TX_WRFLAG 的主要条件为 TX_UNFILL > TX_WRTHR，该标志同时可触发 TX DMA request。规格中 TX_RDTHR 的编码语义从“大于 1 个数据”开始，即编码 0 对应大于 1 个数据、编码 1 对应大于 2 个数据；不能把它解释为编码 0 对应大于 0。HAL 统一只 接受 0 至 127 的阈值，LL 调用方需要按具体阈值字段的规格语义使用原始值。

2.9 FIFO 数据、传输计数与水位

LL 的 RX/TX 计数 setter 分别只约束对应方向；HAL 的 拒绝同时写两个寄存器。

3. 寄存器位域与接口映射

3.1 SSLVCTRL

3.2 SSLVRXC 与 SSLVTXC

3.3 SSLVFLR