嵌入式软件需求规格说明书(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编写必须遵循以下国际/国家/行业标准,避免“闭门造车”式文档:
曾为SRS撰写提供经典11项模板:
1. 引言(目的、范围、定义、参考文献、概述)
2. 总体描述(产品定位、用户特征、系统约束、假设与依赖)
3. 具体需求(功能性需求、外部接口需求、性能需求、设计约束、属性需求)
4. 其他需求(法规、安全、保密、用户文档等)
⚠️ 注意:2021年起IEEE已废止该标准,建议转向ISO/IEC/IEEE 29148
整合了IEEE 830与ISO/IEC 15288,强调:
• 需求分类分层:业务需求→用户需求→系统需求→软件需求
• 需求属性标准化:ID、名称、优先级、状态、来源、验证方法
• 可验证性强制要求:每条需求必须可测试(如“响应时间≤100ms”而非“快速响应”)
• 自然语言+形式化表达混合:关键逻辑可采用UML序列图或状态机描述
明确要求:
• 软件需求必须源自用户需求与系统需求的可追踪分解
• 每个软件单元需有对应的需求基线
• 需求变更必须记录影响分析报告
• 需求验证覆盖率需达到100%(ASIL-D级)
对SRS的特殊要求:
• 必须定义ASIL等级(A/B/C/D)并标注风险类别
• 安全需求需独立编号(如SR-SW-0017-ASIL-C)
• 需包含故障模式与影响分析(FMEA)的衍生需求
• 需求完整性检查表(Checklist)必须归档
等效采用IEEE 830,规定SRS应包含:
• 软件生存周期各阶段需求管理策略
• 需求版本控制流程
• 需求评审记录模板
• 需求可追溯性矩阵(RTM)结构
• 多标准并行场景(如汽车ECU开发需同时满足ISO 26262+IEC 62304)
• 优先采用最新版标准(2024年应使用ISO/IEC/IEEE 29148:2022)
• 行业特定标准具有强制力(如医疗设备必须符合YY/T 0287)
• 需求文档需随标准更新进行版本迁移
• 功能性需求必须用“应”(shall)而非“可以”(may)
• 避免模糊词:“快速响应”→“≤50ms”;“足够精度”→“误差≤±0.5%”
• 每条需求需有唯一ID(如REQ-SW-0003-ANALOG)
• 优先级标注:必须(Must)、应该(Should)、可以(Could)
• 所有需求必须可测试——无验证方法的需求等于无需求
描述软件“做什么”,需满足SMART原则:
正确示例:
REQ-SW-0027:当主控芯片温度传感器读数≥85℃时,应在≤15ms内关闭PWM输出,并通过GPIO_B3置高电平触发散热风扇全速运行,持续至温度≤70℃。
错误示例:
“系统应具备过热保护功能” → 未定义温度阈值、响应时间、执行动作
硬件接口:
• GPIO配置表(示例):
| 引脚 | 方向 | 默认电平 | 功能 | 电气特性 |
|---|---|---|---|---|
| PA0 | 输入 | 浮空 | 按键S1(复位) | 上拉电阻4.7kΩ |
| PA1 | 输出 | 低 | LED指示灯(系统运行) | 限流电阻220Ω |
| PB5 | 输出 | 高 | 电机驱动使能 | TTL兼容,灌电流≥15mA |
通信接口:
• CAN总线配置:
- 波特率:500kbps
- 采样点:75%(TSEG1=12,TSEG2=3)
- 接收过滤:标准帧ID 0x100~0x1FF
- 错误处理:错误被动状态持续512位时间后自动重启
必须量化指标,避免主观描述:
典型错误:
“系统响应要快” → 未定义基准(相对什么?)
“占用资源少” → 未指定资源类型与上限
故障处理机制:
• 看门狗超时:若WWDG_CNT在1024个周期内未刷新,则自动复位
• RAM校验:启用硬件ECC,单比特错误自动修复,双比特错误触发报警
• 通信异常:CAN总线错误计数器≥96时自动关闭发送功能
环境适应性:
• 工作温度:−40℃~+70℃(结温≤125℃)
• 存储温度:−55℃~+150℃
• 抗干扰:电快速瞬变脉冲群(EFT)4kV(IEC 61000-4-4)
可维护性:
• 代码模块化:按功能划分模块,接口定义清晰
• 调试支持:预留SWD调试接口,支持在线断点设置
• 日志系统:关键事件记录至非易失存储(如EEPROM)
可测试性:
• 测试点:所有关键信号引出测试焊盘
• 自检接口:提供命令行自检指令(如“SYS_CHECK”)
可移植性:
• 硬件抽象层(HAL)隔离:外设驱动与业务逻辑分离
• 编译配置:通过宏定义切换不同MCU型号支持
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抓包分析
❌ “采用FreeRTOS调度,任务优先级设为5”
✅ 应改为:“系统应支持多任务并发执行,关键任务响应延迟 ≤ 10ms”
→ SRS定义“做什么”,设计文档说明“怎么做”
❌ “存储所有历史数据(10年)”
✅ 应补充:“受限于Flash容量(128KB),仅保留最近72小时数据,采用循环覆盖策略”
→ 所有需求必须基于实际硬件规格
❌ “界面友好”、“运行稳定”
✅ 应量化:“错误提示在3秒内消失,用户操作错误率 ≤ 0.5%”
→ 无测试方法的需求不具备工程意义
❌ “支持CAN通信”
✅ 应拆分为:
REQ-SW-0012:CAN控制器初始化配置
REQ-SW-0013:标准帧接收过滤
REQ-SW-0014:错误处理机制
→ 每条需求应独立可追踪
未建立版本控制:v1.0与v1.1需求变更无记录
→ 必须包含需求变更日志表(含变更原因、影响分析、责任人)
• 需求是“契约”,不是“建议”
• 模糊需求 = 未来Bug的种子
• 每条需求必须有唯一ID与验证方法
• 安全相关需求需单独编号与评审
• 需求变更必须走正式流程(CCB评审)
| 工具名称 | 优势 | 嵌入式适配性 | 成本 |
|---|---|---|---|
| DOORS Next Gen | IBM全生命周期管理,强追踪能力 | ★★★★☆ 需定制硬件接口模块 | 企业版>¥20万/年 |
| Jama Connect | 可视化需求追踪矩阵 | ★★★★★ 支持ISO 26262模板库 | ¥15万/年起 |
| Polarion ALM | 代码-需求双向追溯 | ★★★★★ 原生支持Git集成 | 免费社区版 |
| TestRail + Excel | 轻量级组合方案 | ★★★☆☆ 需手动维护RTM | 免费(Excel)+ ¥1万/年 |
| Confluence + Jira | 敏捷开发友好 | ★★★☆☆ 需插件增强需求管理 | ¥0.8万/年 |
# 需求ID生成规范 格式:REQ-[模块]-[序号]-[优先级] 示例:REQ-CAN-0017-MUST # 版本管理 v1.0 - 需求基线(冻结) v1.1 - 添加安全需求(ASIL-B) v1.2 - 优化性能指标(响应时间≤5ms) # 变更流程 1. 提交变更请求(CR)至Jira 2. CCB评审(含影响分析) 3. 更新需求文档(版本号递增) 4. 同步修改测试用例 5. 归档旧版文档
某工业PLC数字量输出模块(8通道,24VDC),要求满足IEC 61131-2标准。原SRS存在严重问题:
导致量产时出现:感性负载关断时电压尖峰击穿MOSFET,返修率高达15%。
修订后SRS实施效果:
结论:量化需求直接提升产品可靠性
方法:5W1H分解法
用户原始需求:“想让机器更智能”
→ 分解为:
• What:自动识别故障类型(温度/振动/电流异常)
• When:实时(延迟≤100ms)
• Where:边缘侧(MCU端)
• How:基于特征阈值+简单机器学习(决策树)
• Who:系统自动处理,无需人工干预
• How much:准确率≥95%(测试集验证)
最终需求:
REQ-AI-0001:系统应在 ≤100ms 内完成故障类型识别,采用预训练决策树模型(特征:温度斜率、振动频谱主频、电流谐波含量),识别准确率 ≥95%(基于10,000条历史数据测试集)。
解决方案:联合需求工作坊(JRD)
步骤:
1. 提前提供硬件规格书(含电气特性、时序图)
2. 软件团队提出初步需求
3. 现场验证可行性(示波器测时序、电源分析仪看功耗)
4. 共同签署需求确认表(含硬件约束备注)
案例:某电机控制项目中,硬件声明“PWM频率最高20kHz”,但软件需求写“30kHz”,经JRD发现后修正,避免设计返工。
关键动作:
检查表示例:
□ 每条需求有唯一ID
□ 无模糊词汇(快速/稳定/足够)
□ 所有性能需求有量化指标
□ 安全需求标注ASIL等级
□ 可追溯至上游需求
□ 验证方法明确(测试/仿真/检查)
案例:某项目要求“功耗≤100mW”与“采样率≥100kHz”冲突
解决流程:
1. 标识冲突需求(REQ-PWR-001 vs REQ-ADC-005)
2. 召集客户、硬件、软件三方会议
3. 提出替代方案:
- 方案A:降低采样率至50kHz(功耗95mW)
- 方案B:增加电池容量(功耗110mW)
4. 客户决策并签署变更单
最终输出:
REQ-ADC-005-REV:采样率 ≥50kHz(因功耗约束降级)
四步变更控制法:
CR单模板:
• CR编号:CR-20240512-001
• 变更类型:功能增强/缺陷修复/性能调整
• 影响模块:CAN通信、故障处理
• 工作量:3人日
• 风险:新增代码可能引入新Bug
• 批准:□ 通过 □ 驳回 □ 延期
建立双向追溯链:
示例矩阵:
| 需求ID | 来源 | 设计模块 | 代码文件 | 测试用例 |
|---|---|---|---|---|
| REQ-SW-0107 | UR-0023 | adc_driver.c | adc.c, adc.h | TC-ADC-0015 |
工具支持:
• DOORS/Jama:自动建立链接
• Excel:用VLOOKUP关联不同表格
• Markdown:用超链接关联不同.md文件