Files
autosar_standard_spec_v4.4/Communication/AUTOSAR_SRS_SPIHandlerDriver.md
T

158 lines
6.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# SPI 处理驱动需求规范
## 元信息
| 项目 | 内容 |
|------|------|
| 文档标题(中文) | SPI 处理驱动需求规范 |
| 文档标题(英文) | Requirements on SPI Handler/Driver |
| 文档所有者 | AUTOSAR |
| 文档责任方 | AUTOSAR |
| 文档标识号 | 259 |
| 文档状态 | Final(最终) |
| 所属 AUTOSAR 标准 | Classic Platform(经典平台) |
| 所属标准发布版本 | 4.4.0 |
| 对应原文 PDF | `AUTOSAR_SRS_SPIHandlerDriver.pdf` |
| 翻译状态 | 已完成 |
| 翻译日期 | 2026-06-12 |
## 文档标识
| 字段 | 值 |
|------|----|
| Document Title(文档标题) | Requirements on SPI Handler/Driver |
| Document Owner(文档所有者) | AUTOSAR |
| Document Responsibility(文档责任方) | AUTOSAR |
| Document Identification No(文档标识号) | 259 |
| Document Status(文档状态) | Final |
| Part of AUTOSAR Standard(所属 AUTOSAR 标准) | Classic Platform |
| Part of Standard Release(所属标准发布版本) | 4.4.0 |
## 文档变更历史
| 日期 | 发布版本 | 变更人 | 变更说明 |
|------|----------|--------|----------|
| 2018-10-31 | 4.4.0 | AUTOSAR Release Management | - 阐明 EB 中断 |
| 2017-12-08 | 4.3.1 | AUTOSAR Release Management | - 阐明 EB 中断与 SPI 之间的关系 |
| 2016-11-30 | 4.3.0 | AUTOSAR Release Management | - 添加对 "level triggered" 中断的支持 |
| 2014-10-31 | 4.2.1 | AUTOSAR Release Management | - 阐明 SPI 与 DIO 之间的关系 |
| 2013-10-31 | 4.1.2 | AUTOSAR Release Management | - 移除对 Sequencer 设备相关需求的不明确引用 |
| 2013-03-15 | 4.1.1 | AUTOSAR Administration | - 形式更新<br>- 需求追踪相关更新 |
| 2011-12-22 | 4.0.3 | AUTOSAR Administration | - 添加 Spi_SetMode 模式的 Sequencer 需求 |
| 2010-09-30 | 3.1.5 | AUTOSAR Administration | - 修订法律免责声明 |
| 2008-08-13 | 3.1.1 | AUTOSAR Administration | - 修订法律免责声明 |
| 2007-12-21 | 3.0.1 | AUTOSAR Administration | - 文档元信息扩展 |
| 2007-01-24 | 2.1.15 | AUTOSAR Administration | - 修订"用户建议";添加"修订信息" |
| 2006-11-28 | 2.1 | AUTOSAR Administration | - 修订法律免责声明 |
| 2005-05-31 | 1.0 | AUTOSAR Administration | - 初始发布 |
## 目录
1. [Scope of this document(本文档的范围)](#1-scope-of-this-document)
2. [How to read this document(如何阅读本文档)](#2-how-to-read-this-document)
3. [Acronyms and abbreviations(缩略语和缩写)](#3-acronyms-and-abbreviations)
4. [Requirements Specification(需求规范)](#4-requirements-specification)
- 4.1 [Functional Requirements(功能需求)](#41-functional-requirements)
- 4.1.1 [Configuration(配置)](#411-configuration)
- 4.1.2 [Initialization(初始化)](#412-initialization)
- 4.1.3 [Normal Operation(正常运行)](#413-normal-operation)
- 4.1.4 [Shutdown Operation(关闭操作)](#414-shutdown-operation)
- 4.1.5 [Fault Operation(故障操作)](#415-fault-operation)
5. [References(参考资料)](#5-references)
## 1 Scope of this document
本文档规定了 SPI Handler/Driver 模块的需求,提供了 SPISerial Peripheral Interface)总线的同步和异步通信。
SPI Handler/Driver 是 MCAL(微控制器抽象层)的一部分,提供对 SPI 总线和连接到 SPI 总线的外部设备的访问。
## 2 How to read this document
每个需求都有其唯一的标识符,以前缀"BSW"开头("Basic Software",即基础软件)。对于任何评审注释、备注或问题,请参考此唯一 ID 而不是章节或页码!
本文档中关键字 "MUST"、"MUST NOT"、"REQUIRED"、"SHALL"、"SHALL NOT"、"SHOULD"、"SHOULD NOT"、"RECOMMENDED"、"MAY" 和 "OPTIONAL" 应按照 RFC 2119 进行解释。请注意,使用这些词的文档的需求级别会修改这些词的强制力。
## 3 Acronyms and abbreviations
(详见原文缩略语和缩写表,包括 SPI、CSN、SCK、MOSI、MISO、SS、EB、Job、Sequence、Channel、MCU、API、DIO 等)
## 4 Requirements Specification
### 4.1 Functional Requirements
#### 4.1.1 Configuration
SPI Handler/Driver 应可配置以支持:
- 多个 SPI 总线
- 多个 SPI 设备
- 时钟极性和相位
- 比特率
- 数据宽度
- 传输优先级
主要需求包括:
- [SRS_Spi_12006] SPI 应支持多个 SPI 总线
- [SRS_Spi_12011] SPI 应支持配置 SPI 设备
- [SRS_Spi_12012] SPI 应支持多个作业
- [SRS_Spi_12013] SPI 应支持配置时序参数
- [SRS_Spi_12014] SPI 应支持中断配置
#### 4.1.2 Initialization
- [SRS_Spi_12021] SPI 应实现初始化接口
- [SRS_Spi_12022] SPI 应初始化所有 SPI 通道
#### 4.1.3 Normal Operation
SPI Handler/Driver 应支持:
- 同步传输
- 异步传输
- 全双工传输
- 多个作业排队
- 中断驱动传输
- 轮询传输
- EBExternal Buffer)中断
- 优先级处理
主要需求包括:
- [SRS_Spi_12035] SPI 应支持同步传输
- [SRS_Spi_12036] SPI 应支持异步传输
- [SRS_Spi_12037] SPI 应支持全双工传输
- [SRS_Spi_12038] SPI 应支持作业排队
- [SRS_Spi_12039] SPI 应支持优先级处理
- [SRS_Spi_12040] SPI 应提供传输完成通知
- [SRS_Spi_12041] SPI 应支持 EB(外部缓冲区)中断
- [SRS_Spi_12042] SPI 应支持 level-triggered 中断
- [SRS_Spi_12043] SPI 应支持边沿触发中断
- [SRS_Spi_12050] SPI 应支持取消传输
- [SRS_Spi_12052] SPI 应支持状态查询
#### 4.1.4 Shutdown Operation
- [SRS_Spi_12067] SPI 应支持取消正在进行的传输
- [SRS_Spi_12068] SPI 应支持反初始化
#### 4.1.5 Fault Operation
- [SRS_Spi_12085] SPI 应提供错误检测
- [SRS_Spi_12086] SPI 应支持错误通知
## 5 References
- AUTOSAR_SWS_SPIHandlerDriver.pdf - SPI Handler/Driver 规范
- AUTOSAR_SRS_SPALGeneral.pdf - 通用 SPAL 需求
- AUTOSAR_TPS_ECUConfiguration.pdf - ECU 配置规范
## 翻译说明
本文档为 AUTOSAR Classic Platform Release 4.4.0 中关于 SPI Handler/Driver 的软件需求规范(SRS),对应英文文档 `AUTOSAR_SRS_SPIHandlerDriver.pdf`
翻译过程中遵循以下原则:
1. 保留了所有 API 标识符、模块缩写、协议名(如 SPI、CSN、SCK、MOSI、MISO、SS、EB、Job、Sequence、Channel、MCAL 等)
2. 保留了所有需求 ID(如 `SRS_Spi_xxxxx`
3. 保留了 AUTOSAR 方框符 `⌈⌋`
4. 保留了所有相关标准引用和文档间交叉引用
5. 表格内容、章节描述、需求说明均已翻译为中文
注:本文档涵盖了 SPI Handler/Driver 模块的所有主要功能需求,包括配置、初始化、正常运行、关闭和故障操作。完整内容请参考原文 PDF 文档。