嵌入式软件需求规格说明书

① 什么是嵌入式软件需求规格说明书?

嵌入式软件需求规格说明书(Software Requirements Specification,简称SRS)是嵌入式系统开发过程中用于精确描述目标软件系统应具备的功能性与非功能性需求的核心技术文档。它作为开发、测试、验收、维护的统一依据,是连接客户/系统工程师与软件开发团队的“技术契约”。

与通用软件不同,嵌入式系统具有资源受限(如内存≤64KB)、实时性(响应延迟≤5ms)、高可靠性(MTBF≥10万小时)、硬件强耦合(如ARM Cortex-M0+与外设寄存器交互)等特征,因此其SRS需额外关注:
• 硬件接口约束(如SPI时钟频率≥1MHz、ADC采样率≥100ksps)
• 运行环境限定(工作温度−40℃~+85℃、供电电压3.3V±5%)
• 故障处理策略(看门狗超时重置、关键数据备份冗余机制)
• 功耗管理要求(休眠电流≤10μA、唤醒时间≤2ms)

一份合格的嵌入式SRS不仅是一份“功能清单”,更是系统安全性的第一道防线。例如在汽车电子领域,若制动系统控制软件的SRS未明确定义“紧急制动信号丢失时的降级策略”,将直接导致ISO 26262 ASIL-C级功能失效,引发重大安全事故。

核心价值定位:
✓ 作为需求评审的唯一基准
✓ 作为测试用例设计的输入依据
✓ 作为变更控制的法律凭证
✓ 作为知识传承的结构化载体
✓ 作为合规认证(如IEC 62304、ISO 25119)的关键证据

② 主流标准与规范体系

嵌入式SRS编写必须遵循以下国际/国家/行业标准,避免“闭门造车”式文档:

① IEEE 830-1998(已废止但影响深远)

曾为SRS撰写提供经典11项模板:
1. 引言(目的、范围、定义、参考文献、概述)
2. 总体描述(产品定位、用户特征、系统约束、假设与依赖)
3. 具体需求(功能性需求、外部接口需求、性能需求、设计约束、属性需求)
4. 其他需求(法规、安全、保密、用户文档等)
⚠️ 注意:2021年起IEEE已废止该标准,建议转向ISO/IEC/IEEE 29148

② ISO/IEC/IEEE 29148:2022(当前黄金标准)

整合了IEEE 830与ISO/IEC 15288,强调:
• 需求分类分层:业务需求→用户需求→系统需求→软件需求
• 需求属性标准化:ID、名称、优先级、状态、来源、验证方法
• 可验证性强制要求:每条需求必须可测试(如“响应时间≤100ms”而非“快速响应”)
• 自然语言+形式化表达混合:关键逻辑可采用UML序列图或状态机描述

③ IEC 62304:2006(医疗设备软件)

明确要求:
• 软件需求必须源自用户需求与系统需求的可追踪分解
• 每个软件单元需有对应的需求基线
• 需求变更必须记录影响分析报告
• 需求验证覆盖率需达到100%(ASIL-D级)

④ ISO 26262:2018(道路车辆功能安全)

对SRS的特殊要求:
• 必须定义ASIL等级(A/B/C/D)并标注风险类别
• 安全需求需独立编号(如SR-SW-0017-ASIL-C)
• 需包含故障模式与影响分析(FMEA)的衍生需求
• 需求完整性检查表(Checklist)必须归档

⑤ GB/T 11457-2006(中国国家标准)

等效采用IEEE 830,规定SRS应包含:
• 软件生存周期各阶段需求管理策略
• 需求版本控制流程
• 需求评审记录模板
• 需求可追溯性矩阵(RTM)结构

⚠️ 标准使用要点

• 多标准并行场景(如汽车ECU开发需同时满足ISO 26262+IEC 62304)
• 优先采用最新版标准(2024年应使用ISO/IEC/IEEE 29148:2022)
• 行业特定标准具有强制力(如医疗设备必须符合YY/T 0287)
• 需求文档需随标准更新进行版本迁移

③ 高可用嵌入式SRS模板(可直接套用)

标准模板
汽车电子模板
医疗设备模板

嵌入式SRS标准框架(ISO/IEC/IEEE 29148:2022兼容版)

  1. 1 引言
     1.1 目的(说明SRS编写目标与受众)
     1.2 范围(定义软件功能边界与非功能约束)
     1.3 定义、缩略语与缩写(如CAN、PWM、RTC)
     1.4 参考文献(列出所有标准文档编号)
     1.5 概述(文档结构说明)
  2. 2 总体描述
     2.1 产品定位(嵌入式系统层级:MCU/MPU/SoC)
     2.2 用户特征(工程师技能要求:如熟悉FreeRTOS)
     2.3 系统约束(硬件平台:STM32F407VGT6;开发环境:Keil MDK v5.37)
     2.4 假设与依赖(如“依赖外部晶振精度±10ppm”)
  3. 3 具体需求
     3.1 功能性需求(按模块拆分,每条含ID、描述、输入/输出、前置条件)
     3.2 外部接口需求
      - 用户接口(串口调试命令格式)
      - 硬件接口(GPIO配置表、I2C地址分配)
      - 软件接口(API函数清单、参数约定)
      - 通信接口(CAN帧格式、UART波特率)
     3.3 性能需求
      - 响应时间(中断延迟≤2μs)
      - 吞吐量(数据采样率≥10kHz)
      - 资源占用(RAM峰值≤48KB,Flash≤128KB)
     3.4 设计约束(编程语言:C99;内存模型:small;任务优先级≤10)
     3.5 属性需求
      - 安全性(故障树分析覆盖100%)
      - 可靠性(MTBF≥50,000小时)
      - 可维护性(代码可测试性覆盖率≥90%)
      - 可用性(自检失败后恢复时间≤500ms)
  4. 4 其他需求
     4.1 法规需求(EMC标准:CISPR 25 Class 3)
     4.2 安全需求(看门狗超时阈值、电压监测阈值)
     4.3 保密需求(固件加密存储要求)
     4.4 用户文档需求(操作手册、API参考)
  5. 5 需求追踪矩阵(RTM)
     表头:需求ID | 来源 | 描述 | 验证方法 | 验证ID | 状态 | 版本
     示例:REQ-SW-0017 | 用户需求UR-005 | 电池电压低于3.0V时自动关机 | 功能测试+示波器监测 | TEST-0089 | 已验证 | v1.2
  6. 6 附录
     - 术语表
     - 符号说明
     - 修改历史记录表

汽车电子SRS专项模板(ISO 26262:2018适配)

  1. 3 具体需求(扩展项)
     3.6 安全需求(按ASIL分级)
      - ASIL-B:CAN通信超时重试≥3次
      - ASIL-C:制动信号冗余校验(双通道CRC)
      - ASIL-D:双CPU锁步运行+交叉自检
     3.7 环境需求
      - 温度范围:−40℃~+125℃(结温)
      - 湿度:95% RH(非冷凝)
      - 振动:符合ISO 16750-3机械环境测试
     3.8 可靠性需求
      - ESD防护:接触放电±8kV(IEC 61000-4-2)
      - 电磁兼容:辐射发射限值Class 3
      - 寿命要求:15年或24万公里
  2. 4 安全需求追踪表
     | 安全目标 | 安全需求ID | 功能需求ID | 技术安全需求ID | 验证方法 |
     | G1-001 防止意外制动 | SR-SW-0042 | FR-SW-0017 | TSR-0031 | HIL测试+故障注入 |

医疗设备SRS专项模板(IEC 62304:2006适配)

  1. 3 具体需求(扩展项)
     3.9 软件生存周期过程需求
      - 需求变更需经配置控制委员会(CCB)审批
      - 关键需求(如剂量计算)需双人复核
     3.10 验证与确认需求
      - 单元测试覆盖率≥85%(分支覆盖率≥75%)
      - 需求覆盖率100%(所有需求必须可追溯至测试用例)
     3.11 维护需求
      - 固件更新需保留旧版校验和
      - 回滚机制:断电后10秒内恢复至上一版本
  2. 4 软件安全计划
     • 风险分析:FMEA覆盖所有需求
     • 变更控制:所有修改需记录根本原因
     • 验证策略:自动化测试占比≥70%

📌 模板使用提示

• 功能性需求必须用“应”(shall)而非“可以”(may)
• 避免模糊词:“快速响应”→“≤50ms”;“足够精度”→“误差≤±0.5%”
• 每条需求需有唯一ID(如REQ-SW-0003-ANALOG)
• 优先级标注:必须(Must)、应该(Should)、可以(Could)
• 所有需求必须可测试——无验证方法的需求等于无需求

④ 核心需求类型详解(附真实案例)

4.1 功能性需求(Functional Requirements)

描述软件“做什么”,需满足SMART原则:

正确示例:
REQ-SW-0027:当主控芯片温度传感器读数≥85℃时,应在≤15ms内关闭PWM输出,并通过GPIO_B3置高电平触发散热风扇全速运行,持续至温度≤70℃。

错误示例:
“系统应具备过热保护功能” → 未定义温度阈值、响应时间、执行动作

4.2 外部接口需求(External Interface Requirements)

硬件接口:
• GPIO配置表(示例):

引脚方向默认电平功能电气特性
PA0输入浮空按键S1(复位)上拉电阻4.7kΩ
PA1输出低LED指示灯(系统运行)限流电阻220Ω
PB5输出高电机驱动使能TTL兼容,灌电流≥15mA

通信接口:
• CAN总线配置:
 - 波特率:500kbps
 - 采样点:75%(TSEG1=12,TSEG2=3)
 - 接收过滤:标准帧ID 0x100~0x1FF
 - 错误处理:错误被动状态持续512位时间后自动重启

4.3 性能需求(Performance Requirements)

必须量化指标,避免主观描述:

典型错误:
“系统响应要快” → 未定义基准(相对什么?)
“占用资源少” → 未指定资源类型与上限

4.4 安全与可靠性需求(Safety & Reliability)

故障处理机制:
• 看门狗超时:若WWDG_CNT在1024个周期内未刷新,则自动复位
• RAM校验:启用硬件ECC,单比特错误自动修复,双比特错误触发报警
• 通信异常:CAN总线错误计数器≥96时自动关闭发送功能

环境适应性:
• 工作温度:−40℃~+70℃(结温≤125℃)
• 存储温度:−55℃~+150℃
• 抗干扰:电快速瞬变脉冲群(EFT)4kV(IEC 61000-4-4)

4.5 属性需求(Attribute Requirements)

可维护性:
• 代码模块化:按功能划分模块,接口定义清晰
• 调试支持:预留SWD调试接口,支持在线断点设置
• 日志系统:关键事件记录至非易失存储(如EEPROM)

可测试性:
• 测试点:所有关键信号引出测试焊盘
• 自检接口:提供命令行自检指令(如“SYS_CHECK”)

可移植性:
• 硬件抽象层(HAL)隔离:外设驱动与业务逻辑分离
• 编译配置:通过宏定义切换不同MCU型号支持

⚡ 典型需求片段(汽车ECU油门控制)
REQ-SW-0045 [ASIL-C]:
当油门踏板传感器1电压 > 4.8V 且 传感器2电压 < 0.2V 时,
应在 ≤ 8ms 内执行以下操作:
1. 触发故障标志位(FAULT_BIT_THROTTLE)
2. 通过CAN帧 0x18F 数据字节0 置1(故障状态)
3. 限制电机扭矩输出 ≤ 10% 额定值(软降级)
4. 记录故障码 U0123 至非易失存储器
验证方法:故障注入测试(电压模拟器)+ CANoe抓包分析

⑤ 嵌入式SRS常见误区与避坑指南

误区1:混入设计细节

❌ “采用FreeRTOS调度,任务优先级设为5”
✅ 应改为:“系统应支持多任务并发执行,关键任务响应延迟 ≤ 10ms”
→ SRS定义“做什么”,设计文档说明“怎么做”

误区2:忽略硬件约束

❌ “存储所有历史数据(10年)”
✅ 应补充:“受限于Flash容量(128KB),仅保留最近72小时数据,采用循环覆盖策略”
→ 所有需求必须基于实际硬件规格

误区3:需求不可验证

❌ “界面友好”、“运行稳定”
✅ 应量化:“错误提示在3秒内消失,用户操作错误率 ≤ 0.5%”
→ 无测试方法的需求不具备工程意义

误区4:需求粒度过粗

❌ “支持CAN通信”
✅ 应拆分为:
REQ-SW-0012:CAN控制器初始化配置
REQ-SW-0013:标准帧接收过滤
REQ-SW-0014:错误处理机制
→ 每条需求应独立可追踪

误区5:忽略需求演化

未建立版本控制:v1.0与v1.1需求变更无记录
→ 必须包含需求变更日志表(含变更原因、影响分析、责任人)

⚠️ 关键原则重申

• 需求是“契约”,不是“建议”
• 模糊需求 = 未来Bug的种子
• 每条需求必须有唯一ID与验证方法
• 安全相关需求需单独编号与评审
• 需求变更必须走正式流程(CCB评审)

⑥ 需求管理工具推荐(嵌入式专项)

6.1 专业工具对比

工具名称优势嵌入式适配性成本
DOORS Next GenIBM全生命周期管理,强追踪能力★★★★☆
需定制硬件接口模块
企业版>¥20万/年
Jama Connect可视化需求追踪矩阵★★★★★
支持ISO 26262模板库
¥15万/年起
Polarion ALM代码-需求双向追溯★★★★★
原生支持Git集成
免费社区版
TestRail + Excel轻量级组合方案★★★☆☆
需手动维护RTM
免费(Excel)+ ¥1万/年
Confluence + Jira敏捷开发友好★★★☆☆
需插件增强需求管理
¥0.8万/年

6.2 开源方案推荐

⚙️ 嵌入式需求管理最佳实践
# 需求ID生成规范
格式:REQ-[模块]-[序号]-[优先级]
示例:REQ-CAN-0017-MUST
# 版本管理
v1.0 - 需求基线(冻结)
v1.1 - 添加安全需求(ASIL-B)
v1.2 - 优化性能指标(响应时间≤5ms)
# 变更流程
1. 提交变更请求(CR)至Jira
2. CCB评审(含影响分析)
3. 更新需求文档(版本号递增)
4. 同步修改测试用例
5. 归档旧版文档

⑦ 真实项目案例解析(工业PLC模块)

7.1 项目背景

某工业PLC数字量输出模块(8通道,24VDC),要求满足IEC 61131-2标准。原SRS存在严重问题:

导致量产时出现:感性负载关断时电压尖峰击穿MOSFET,返修率高达15%。

7.2 修订后关键需求

  1. REQ-OUT-001:单通道输出电流 ≤ 2.0A(持续),瞬态峰值电流 ≤ 3.5A(≤10ms),超限时应在 ≤1ms 内关闭输出并置位故障标志。
  2. REQ-OUT-002:感性负载关断时,输出引脚电压尖峰 ≤ 60V(24V系统),通过TVS管钳位实现。
  3. REQ-CAN-003:CAN总线在500kbps下,连续1000帧无错误传输成功率 ≥ 99.999%。
  4. REQ-DIAG-004:自检功能应在上电后 ≤ 200ms 内完成,结果通过LED指示(绿灯=正常,红灯=故障)。

7.3 验证结果

修订后SRS实施效果:

结论:量化需求直接提升产品可靠性

⑧ 网友最关心的10个问题深度解答

需求获取
需求评审
需求变更

Q1:如何从模糊的用户需求提取出可执行的SRS?

方法:5W1H分解法

用户原始需求:“想让机器更智能”
→ 分解为:
• What:自动识别故障类型(温度/振动/电流异常)
• When:实时(延迟≤100ms)
• Where:边缘侧(MCU端)
• How:基于特征阈值+简单机器学习(决策树)
• Who:系统自动处理,无需人工干预
• How much:准确率≥95%(测试集验证)

最终需求:
REQ-AI-0001:系统应在 ≤100ms 内完成故障类型识别,采用预训练决策树模型(特征:温度斜率、振动频谱主频、电流谐波含量),识别准确率 ≥95%(基于10,000条历史数据测试集)。

Q2:硬件工程师与软件工程师对需求理解不一致怎么办?

解决方案:联合需求工作坊(JRD)

步骤:
1. 提前提供硬件规格书(含电气特性、时序图)
2. 软件团队提出初步需求
3. 现场验证可行性(示波器测时序、电源分析仪看功耗)
4. 共同签署需求确认表(含硬件约束备注)

案例:某电机控制项目中,硬件声明“PWM频率最高20kHz”,但软件需求写“30kHz”,经JRD发现后修正,避免设计返工。

Q3:SRS评审时如何避免“走过场”?

关键动作:

  • 评审前48小时发送文档+问题清单
  • 采用“问题导向”模式:每人至少提出3个质疑点
  • 重点检查:可测试性、约束条件、边界值
  • 使用检查表(Checklist)逐项核对

检查表示例:
□ 每条需求有唯一ID
□ 无模糊词汇(快速/稳定/足够)
□ 所有性能需求有量化指标
□ 安全需求标注ASIL等级
□ 可追溯至上游需求
□ 验证方法明确(测试/仿真/检查)

Q4:如何处理相互矛盾的需求?

案例:某项目要求“功耗≤100mW”与“采样率≥100kHz”冲突

解决流程:
1. 标识冲突需求(REQ-PWR-001 vs REQ-ADC-005)
2. 召集客户、硬件、软件三方会议
3. 提出替代方案:
 - 方案A:降低采样率至50kHz(功耗95mW)
 - 方案B:增加电池容量(功耗110mW)
4. 客户决策并签署变更单

最终输出:
REQ-ADC-005-REV:采样率 ≥50kHz(因功耗约束降级)

Q5:需求变更流程如何设计才有效?

四步变更控制法:

  1. 提交:填写CR单(含变更原因、影响范围)
  2. 评估:分析对设计、测试、进度的影响
  3. 决策:CCB(配置控制委员会)投票决定
  4. 实施:更新文档、同步测试、归档记录

CR单模板:
• CR编号:CR-20240512-001
• 变更类型:功能增强/缺陷修复/性能调整
• 影响模块:CAN通信、故障处理
• 工作量:3人日
• 风险:新增代码可能引入新Bug
• 批准:□ 通过 □ 驳回 □ 延期

Q6:如何确保需求可追溯?

建立双向追溯链:

  • 上游:用户需求 → 系统需求 → 软件需求
  • 下游:软件需求 → 设计文档 → 代码 → 测试用例

示例矩阵:

需求ID来源设计模块代码文件测试用例
REQ-SW-0107UR-0023adc_driver.cadc.c, adc.hTC-ADC-0015

工具支持:
• DOORS/Jama:自动建立链接
• Excel:用VLOOKUP关联不同表格
• Markdown:用超链接关联不同.md文件