MAAB_MathWorks Automotive Advisory Board_Version3.0.docx

MAAB（Mathworks Automotive AdvisoryBoard）是制定Matlab,Simulink,Stateflow以及Emmbedded Coder使用规范的组织。MAAB控制算法建模规范正式这个组织的重要的输出物，主要适用于汽车行业的基于模型的控制策略开发。 ### MAAB控制算法建模规范概述 #### 一、历史与背景 MAAB（MathWorks Automotive Advisory Board）作为制定Matlab、Simulink、Stateflow以及Embedded Coder使用规范的重要组织，在汽车行业扮演着举足轻重的角色。其发布的《控制算法建模指南》(CONTROL ALGORITHM MODELING GUIDELINES USING MATLAB®, Simulink®, and Stateflow®) 版本3.0为汽车行业基于模型的设计提供了详细的指导原则。 #### 二、简介 **2.1 动机** 随着汽车行业的快速发展，特别是智能网联汽车、自动驾驶等领域的兴起，对于控制算法的设计提出了更高的要求。MAAB旨在通过该指南，帮助工程师们更加高效、规范地进行控制算法的设计和实现，从而提高产品的质量和安全性。 **2.2 关于版本3.0** 版本3.0是在前几个版本的基础上进行了大量的改进和完善。它涵盖了最新的技术进展，并根据当前行业需求进行了调整，使得指南更符合现代汽车工业的需求。 **2.3 指南模板** - **2.3.1 Guideline ID:** 每一条准则都有一个唯一的ID，以便于引用和追踪。 - **2.3.2 Guideline Title:** 明确指出该准则的主题或目的。 - **2.3.3 Priority:** 表示该准则的重要性级别，分为高、中、低三个等级。 - **2.3.4 Scope:** 描述该准则适用的范围。 - **2.3.5 MATLAB® Versions:** 适用的Matlab版本。 - **2.3.6 Prerequisites:** 使用该准则前需要满足的前提条件。 - **2.3.7 Description:** 对准则的具体描述。 - **2.3.8 Rationale:** 解释为什么制定该准则。 - **2.3.9 Last change:** 最近一次修改的时间。 **2.4 文档使用** - **2.4.1 Guideline Interaction Semantics:** 规定了不同准则之间的交互规则。 - **2.4.2 Masked Subsystems and Readability Rules:** 关于子系统掩码和可读性的规定。 #### 三、软件环境 在这一章节中，MAAB提供了关于软件环境的一般性指导方针： - **3.1 General Guidelines** - **na_0026: Consistent software environment:** 强调使用一致的软件环境对于项目管理的重要性。 - **na_0027: Use of only standard library blocks:** 建议只使用标准库中的块，以确保代码的可移植性和兼容性。 #### 四、命名约定 **4.1 General Guidelines** - **ar_0001: Filenames:** 文件名应遵循特定的格式，便于识别和分类。 - **ar_0002: Directory names:** 目录名也应遵循统一的标准。 - **na_0035: Adoption of naming conventions:** 鼓励采用标准化的命名惯例，以提高项目的可维护性。 **4.2 Model Content Guidelines** - **jc_0201: Usable characters for Subsystem name:** 子系统的名称可以使用的字符集。 - **jc_0211: Usable characters for Inport block and Outport block:** 输入/输出端口块可以使用的字符集。 - **jc_0221: Usable characters for signal line name:** 信号线名称可以使用的字符集。 - **na_0030: Usable characters for Simulink Bus names:** Simulink总线名称可以使用的字符集。 - **jc_0231: Usable characters for block names:** 块名称可以使用的字符集。 - **na_0014: Use of local language in Simulink and Stateflow:** 对于是否允许使用本地语言的规定。 #### 五、模型架构 **5.1 Simulink® and Stateflow® Partitioning** - **na_0006: Guidelines for mixed use of Simulink and Stateflow:** 提供了混合使用Simulink和Stateflow的指导原则。 - **na_0007: Guidelines for use of Flow Charts, Truth Tables and State Machines:** 关于流程图、真值表和状态机使用的指导原则。 **5.2 Subsystem Hierarchies** - **db_0143: Similar block types on the model levels:** 对于模型层次上相似块类型的使用建议。 - **db_0144: Use of Subsystems:** 关于子系统使用的指导原则。 - **db_0040: Model hierarchy:** 关于模型层次结构的建议。 - **na_0037: Use of single variable variant conditionals:** 关于单变量变体条件的使用建议。 - **na_0020: Number of inputs to variant subsystems:** 变体子系统的输入数量限制。 - **na_0036: Default Variant:** 关于默认变体的选择建议。 **5.3 J-MAAB Model Architecture Decomposition** - **jc_0301: Controller model:** 控制器模型的分解指南。 - **jc_0311: Top layer/root level:** 关于顶层/根级别的定义。 - **jc_0321: Trigger layer:** 触发层的相关指导。 - **jc_0331: Structure layer:** 结构层的定义和使用建议。 - **jc_0341: Dataflow layer:** 数据流层的分解指南。 #### 六、模型配置选项 在模型配置选项部分，MAAB给出了关于模型配置的一些建议： - **6.1.1 jc_0011: Optimization parameters for Boolean data:** 对布尔数据的优化参数设置建议。 MAAB控制算法建模规范不仅提供了一套完整的基于模型设计的方法论，还对具体的工具使用提供了详细的指导，这对于从事汽车行业控制算法开发的工程师来说是非常宝贵的资源。通过遵循这些规范，不仅可以提高设计效率，还能确保设计出的系统具有良好的可靠性和可维护性。