智能驾驶技术飞速发展,汽车电子电气系统(E/E系统)的复杂性与日俱增,功能安全已成为智能驾驶系统开发中不可或缺的关键环节。然而,在功能安全开发过程中,复杂系统的安全分析及安全需求导出工作繁杂,开发人员在Medini Analyze(简称MA)中完成开发后,需将内容导出并编写报告,且报告编写与评审需同步迭代,这无疑带来了巨大的重复工作量。为此,Medini Analyze基于M2Doc推出了定制化功能安全报告方案,实现了报告的自动化生成,有效解决了上述痛点。

一、M2Doc方案核心:自动化与定制化结合
M2Doc是一款用于自动生成定制文档的工具,它以Eclipse建模框架(EMF)中的模型为输入,能够灵活且强大地创建报告、规范、用户手册等各类文档。将其与Medini Analyze结合,用户可轻松定义输出报告的外观和内容,实现高度定制化的功能安全报告生成,从而避免复杂繁琐的文档整理工作。该方案支持插入图片、生成表格、创建目录等多种功能,完全满足功能安全报告的格式与内容需求。
二、以功能安全概念(FSC)开发文档为例
下面以功能安全概念(FSC)开发文档的生成为例,详细介绍M2Doc定制文档自动化生成的具体流程,FSC开发主要涵盖故障树(FTA)分析、功能安全需求(FSR)提出、报警降级策略以及功能安全架构开发等内容,这些工作均可通过MA工具完成,再结合定制模板输出最终文档。
Step1:制作MA模板
在MA工具的BestPractice模板中的Item Definition文件夹下新建Checklist,并导入制作好的FSC定制文档模板。在新建的 Checklist里,填写对应输出的模型、图片、文档等信息。例如,明确Word模板文件、Word生成报告的名称,以及itemname、function、company等变量所对应的内容,如将myRequirementsModel与 Safety Goals and Functional Safety Requirements相关联。
Step2:在MA工具中完成FSC的开发
借助MA工具开展FSC开发的各项工作,包括进行故障树分析、提出功能安全需求、制定报警降级策略以及设计功能安全架构等。在开发过程中,工具会记录下各项数据,如安全目标的ID、名称、ASIL等级、相关故障事件、安全状态、应急操作策略等,这些数据将作为后续报告生成的基础。
Step3:制作定制化模板(FSC)
在Word文档中编辑FSC模板,确定标题、正文等格式。对于需要动态输出的内容,通过按下Ctrl F9新增M2Doc的解释字段,编辑这些字段可实现图片输出(包括设置图片格式和大小),以及对同一属性的内容进行循环输出等操作。例如,在描述功能架构时,可通过字段设置将初始架构以图片形式输出;在列出安全目标列表时,通过循环字段将所有安全目标的相关信息(编号、名称、ASIL等级等)依次呈现。
Step4:进行文档输出
首先,检查preferences→report,勾选Enable M2Doc reporting features以启用相关功能。然后,右键浏览树中的Report,点击Report→Generate M2Doc Report,选择导入的FSC定制文档模板,指定输出位置等参数后,点击生成。生成成功后,可自动打开输出文档,文档中对应位置会准确呈现MA工具中开发的内容。
三、方案优势
Medini Analyze基于M2Doc输出的定制化功能安全报告方案,以“删繁就简”为核心目标,结合功能安全开发工具Medini Analyze,实现了定制报告的自动化生成,具有诸多显著优势:
文档生成功能强大:能够自动插入图片、填写表格、生成目录、编写页眉页码等,满足功能安全报告的各种格式要求。
节约开发时间:使用M2Doc定制文档模板后,功能安全工程师无需花费大量时间进行文档整理,所有功能安全开发工作在MA 工具中完成后,直接输出文档即可,大幅提升了工作效率。
避免版本混淆:当开发内容需要迭代时,仅需在工程文件中进行迭代,迭代后可对开发内容进行多次输出,有效避免了多个版本报告混淆的问题。
简化评审过程:对于开发产物的评审,只需针对Medini Analyze中的开发内容进行,无需在报告文本上耗费过多精力,使评审更加聚焦和高效。
需要注意的是,该方案仅支持2023R1及以上版本的Medini Analyze功能安全开发工具,2023R1以下版本则需要额外安装 M2Doc插件才能使用。
综上所述,Medini Analyze基于M2Doc的定制化功能安全报告方案,为功能安全开发工作提供了高效、便捷的文档生成方式,有效减轻了开发人员的负担,提升了功能安全开发的整体效率与质量。