MES Model Examiner® (MXAM)
MXAM新手?
系统要求
使用MXAM须符合以下系统要求：
- Windows 10（64位版本）、Windows 11或
- Linux（64位版本），经测试兼容Ubuntu 20.04.1和Ubuntu 22.04。
- 您的系统上需要安装Java 11到21（64位版本）中的版本（经过测试，可以与MXAM一起使用的版本是“Adoptium OpenJDK 11”，“Adoptium OpenJDK 17”，和“Adoptium OpenJDK 21”）。
- 满足MXAM和MATLAB®/Simulink®/Stateflow®应用的系统要求：
- MATLAB®版本请查看下面的表格
- 使用TargetLink®时的附加系统要求：TargetLink®（基本套件）版本请查看下面的表格
- 应用MXAM与ASCET的系统要求：ASCET版本6.1至6.4.7
| MXAM版本 | MATLAB版本 | TargetLink版本 | 兼容Java版本 |
|---|---|---|---|
| MXAM版本: 10.4 | MATLAB版本: R2019b - R2024b | TargetLink版本: TL 5.0 - TL 2024-B | 兼容Java版本: 11 - 21 (64bit) |
| MXAM版本: 10.3 | MATLAB版本: R2019b - R2024a | TargetLink版本: TL 5.0 - TL 2023b | 兼容Java版本: 11 - 21 (64bit) |
| MXAM版本: 10.2 | MATLAB版本: R2019b - R2024a | TargetLink版本: TL 5.0 - TL 2023b | 兼容Java版本: 11 - 21 (64bit) |
| MXAM版本: 10.1 | MATLAB版本: R2019b - R2023b | TargetLink版本: TL 5.0 - TL 2023b | 兼容Java版本: 11 - 21 (64bit) |
| MXAM版本: 10.0 | MATLAB版本: R2019b - R2023b | TargetLink版本: TL 5.0 - TL 2023b | 兼容Java版本: 11 - 21 (64bit) |
| MXAM版本: 9.3 | MATLAB版本: R2015b - R2022b | TargetLink版本: TL 4.1 - TL 2022b | 兼容Java版本: 8 - 15 (64bit) |
| MXAM版本: 9.2 | MATLAB版本: R2015b - R2022b | TargetLink版本: TL 4.1 - TL 2022b | 兼容Java版本: 8 - 15 (64bit) |
| MXAM版本: 9.1 | MATLAB版本: R2015b - R2022b | TargetLink版本: TL 4.1 - TL 2022b | 兼容Java版本: 8 - 15 (64bit) |
| MXAM版本: 9.0 | MATLAB版本: R2015b - R2022b | TargetLink版本: TL 4.1 - TL 2022b | 兼容Java版本: 8 - 15 (64bit) |
| MXAM版本: 8.2 | MATLAB版本: R2015b - R2022a | TargetLink版本: TL 4.1 - TL 5.2 | 兼容Java版本: 8 - 15 (64bit) |
| MXAM版本: 8.1 | MATLAB版本: R2015b - R2021b | TargetLink版本: TL 4.1 - TL 5.2 | 兼容Java版本: 8 - 15 (64bit) |
| MXAM版本: 8.0 | MATLAB版本: R2015b - R2021b | TargetLink版本: TL 4.1 - TL 5.2 | 兼容Java版本: 8 - 15 (64bit) |
| MXAM版本: 7.3 | MATLAB版本: R2013b - R2021b | TargetLink版本: TL 3.5 - TL 5.2 | 兼容Java版本: 8 - 12 (64bit) |
| MXAM版本: 7.2 | MATLAB版本: R2013b - R2020b | TargetLink版本: TL 3.5 - TL 5.1 | 兼容Java版本: 8 - 12 (64bit) |
| MXAM版本: 7.1 | MATLAB版本: R2013b - R2020b | TargetLink版本: TL 3.5 - TL 5.1 | 兼容Java版本: 8 - 12 (64bit) |
| MXAM版本: 7.0 | MATLAB版本: R2013b - R2020b | TargetLink版本: TL 3.5 - TL 5.1 | 兼容Java版本: 8 - 12 (64bit) |
| MXAM版本: 6.5 | MATLAB版本: R2011b - R2020b | TargetLink版本: TL 3.3 - TL 5.0 | 兼容Java版本: 8 - 12 (64bit) |
| MXAM版本: 6.4 | MATLAB版本: R2011b - R2019b | TargetLink版本: TL 3.3 - TL 5.0 | 兼容Java版本: 8 - 12 (64bit) |
| MXAM版本: 6.3 | MATLAB版本: R2011b - R2019b | TargetLink版本: TL 3.3 - TL 5.0 | 兼容Java版本: 8 - 12 (64bit) |
| MXAM版本: 6.2 | MATLAB版本: R2011b - R2019b | TargetLink版本: TL 3.3 - TL 5.0 | 兼容Java版本: 8 - 12 (64bit) |
| MXAM版本: 6.1 | MATLAB版本: R2011b - R2019a | TargetLink版本: TL 3.3 - TL 4.4 | 兼容Java版本: 8 - 12 (64bit) |
| MXAM版本: 6.0 | MATLAB版本: R2011b - R2019a | TargetLink版本: TL 3.3 - TL 4.4 | 兼容Java版本: 8 - 12 (64bit) |
| MXAM版本 | Flexera版本（最低） | Dongledriver版本 |
|---|---|---|
| MXAM版本: 9.0.0及更高 | Flexera版本（最低）: 11.19.1 | Dongledriver版本: 6.60及更高 |
| MXAM版本: 自8.1.0至8.2.0 | Flexera版本（最低）: 11.16 | Dongledriver版本: 6.40 - 6.60 |
| MXAM版本: 自3.9.1至8.0.0 | Flexera版本（最低）: 11.14 | Dongledriver版本: 6.32 - 6.40 |
| MXAM版本: 3.9.0及更低 | Flexera版本（最低）: 11.13 | Dongledriver版本: 6.30 |
安装
如何安装MXAM？
- 安装程序：执行安装文件（.exe文件）并按照安装说明进行MXAM的安装。
- 安装启动过程的等待时间取决于客户端计算机的安全设置。
- 安装到写保护目录中：右键以管理员身份执行安装。
- Zip压缩文档：解压文档到任何目录中。
- 请避免在MXAM路径中包含以下特殊符号（#, %, ;.），否则MXAM将无法启动。此外，请避免将MXAM安装在您的桌面上。
- MXAM安装程序有以下标志可以在命令行中设置： /D、/S、/lang、/lic和/conf。这些标志均可选。只有在使用/S标志指定静默安装时，我们强烈建议您同时使用/D标志指定安装目录。
- /D：指定安装目录。请注意，此标志必须设置在cmd使用的最后。不将其放置在最后会导致错误。
- /S：指定静默安装，例如：
mxam-installer.exe /S /D=D:\path\to\mxam
/lang：您可以选择以哪种语言打开安装程序。安装程序默认使用系统语言，但如果您希望安装程序使用特定语言，可以指定3种语言的快捷方式之一。可用的快捷方式有 DE（德语）、EN（英语）和 ZH（简体中文）。传递给/lang参数的任何其他值都将默认为英语。例如：
mxam-installer.exe /lang=EN- /lic：用于为您的MXAM安装设置默认许可证文件。您指定的文件将会被复制到MXAM安装的许可证文件夹中，例如：
mxam-installer.exe /S /lic=D:\path\to\license.lic /D=D:\path\to\mxam /conf：用于为您的安装设置自定义配置。此标志需要一个具有以下特定结构的文件夹:my-config
您可以在MXAM安装文件夹中的
|-- com.modelengineers.mxam.core.prefs
|-- com.modelengineers.mxam.ui.common.prefs
|-- com.modelengineers.mxam.ui.jiraSupport.prefs
|-- lismo.config
|-- adapters
| |-- com.modelengineers.mxam.tooladapter.ascet6.ini
| |-- com.modelengineers.mxam.tooladapter.file.ini
| |-- com.modelengineers.mxam.tooladapter.matlab.ini
| |-- com.modelengineers.mxam.tooladapter.mxamreport.inidoc/MXAM_X_Y_Z_config_template.zip找到配置模板文件夹。您只需复制模板文件夹，即可开始编辑与您相关的首选项和配置。关于每个配置属性的具体说明，您可参阅MXAM帮助内容（在MXAM中：Help > Help Contents），例如：
mxam-installer.exe /S /conf=D:\path\to\config\folder /D=D:\path\to\mxam
- 在一台设备上运行一次MXAM安装程序，并将您在完成面板上的自动安装数据保存为auto-install.xml。
有了这些数据，您就可以在另一台相似的设备上运行相同的安装程序。 - 配置auto-install.xml
- 运行自动安装程序: >>[installer-name].exe [ABSOLUTE-PATH/auto-install.xml]
MATLAB路径
如果您已将MXAM文件夹永久添加到MATLAB路径中，请将其更改为新版本。
MXAM钩子函数
如果您使用了MXAM钩子函数，请确保将它们转移到新版本/环境中。
自定义元素
如果您有任何自定义的规范文档、建模规范或检查项，请确保将它们转移到新版本中，或存储在工具之外 （推荐）。
MXAM库
如果在Settings -> Preferences -> MXAM -> Libraries中配置了MXAM库，则必须在新版本中重新配置这些库。为了简化操作，您可以在相应的项目中配置这些库。
过时的建模规范
从之前版本打开项目，并在“项目规范”视图中检查文档。请使用Tree Menu -> Expand all。如果有任何规范或检查项标记为红色，则这些项未加载到库中。这些项没有正确加载到MXAM库中，或是该项在新版本中已不可用。更多信息，您可以参考发行说明以查看已删除的规范。
注意：项目、注释等向后兼容，但不一定向前兼容。
许可证购置方案
从小型本地团队到大型全球组织，我们都能根据您的需求提供灵活的许可证选择。对于基于用户的用例，我们提供加密狗和浮动网络许可证，您可以选择订阅年度许可证或购置永久许可证。对于企业内部及云端部署的流程自动化，您需要使用我们的自动化许可证，这种许可证主要以年度订阅的形式提供。
有任何疑问吗？请通过sales@model-engineers.com联系我们。
许可证配置
我们的许可证技术基于业界领先Revenera FlexNetOperation技术平台。
在安装过程中，双击MES工具目录中的“LicenseManager.jar”，即可启动MES许可证管理器，为所有MES工具配置许可证。
如果您需要将工具升级到新的主版本，例如从9.x升级到10.x，则需要新的主版本许可证。如果您只想在主版本内进行升级，例如从9.1升级到9.2，则可以继续使用原有许可证。许可证向后兼容，例如，您可以使用4.x版本许可证运行4.x以下的版本工具。
通常，如果需要更新许可证文件，您将收到以下错误信息：
FlexErrorNo: -21
许可证文件不支持此版本。
请联系license@model-engineers.com申请更新许可证。如果您的支持与升级服务处于有效期内，我们将尽快向您发送新的许可证。
如您有一台新电脑，如何将Node锁定的许可证从一台计算机转移到另一台计算机？也请联系license@model-engineers.com。
通过MES许可证管理器，您可以点击“Test Server（测试服务器）”按钮来测试许可证服务器。服务器的响应将会被记录在“Output（输出）”窗口中。可用许可证将在输出中列出。
以下几种方法可以帮您解决这个问题。首先请打开MES许可证管理器，查看可用的主机或加密狗ID（如图所示）。
您可以查看到哪一个Revenera FlexNetOperations正在被使用，并与您的MAC ID进行比较。如果您需要联系我们的支持人员，请将列出的ID截图发送给我们。
或者，请检查您是否有一个名为“LM_LICENSE_FILE”的系统变量指向另一个许可证。如有，请声明一个命名为“MES_LICENSE_FILE”的新系统变量，并使该变量指向MES许可证管理器。MES许可证管理器将优先处理此供应商特定变量。
您可以为所有使用的MES工具设置中央许可证配置。请在MES许可证管理器中点击“Advanced >>>>”。在出现的下拉菜单中，您可在不同工具中进行选择。您还可以选择中央配置，即所有MES工具的通用配置。
快速启动
如何启动MXAM？
对于MATLAB平台，您可以在命令窗键入>>mxam轻松启动MXAM。前提条件是MXAM的安装目录使MATLAB或当前工作目录的一部分。
双击MXAM图标或mxam.exe启动MXAM。通过Settings -> Preferences -> Tools -> MATLAB来配置您的MATLAB版本。您可以从项目视图启动分析。默认项目已打开，只需点击“Analyze”即可。
您可从”Project“视角启动分析。
一个默认项目已经打开。
请点击“Analyze”链接。
通过MES许可证管理器，您可点击按钮“Test Server”来测试许可证服务器。服务器的响应将输出在“Output”窗口中。可用的许可证将在输出中列出。
报告视图有不同的导览方式选择，并相互影响。在MXAM左侧有两个导航选项卡，供您进一步浏览分析结果。
规范文档导览（Document Navigation）
使用“规范文档导览“，从项目建模规范文档的角度查看分析结果，您可查看每个章节、建模规范和检查的结果。
模型工件导览（Artificial Navigation）
使用“模型工件导览“，从模型层次结构的角度查看分析结果，您可查看每个子系统或图标的结果。
常规导览（General Navigation）
如果在 “规范文档导览 ”的树形结构中选择一个元素，该元素和所有子元素的所有结果都会列在导览左侧名为“结果视图”的表格中。在 “模型工件导览”中，会列出所选层次结构中包含的所有结果。在此，您可以点击特定的结果，查看详细信息，并链接到左下方“结果详情”中的模型。在右下角的“详细信息 ”选项卡中，你可以看到所选元素的详细信息。在左下角的另一个选项卡中，您可以看到导览选项卡中选定元素的汇总结果摘要。如果您想查看模型指标，可以选择左上角的MXRAY指标选项卡。该报告为您提供了一个表格，用于查看每个子系统或图表的所有指标。每个指标的列可按结果排序。选择左上角的 “指标摘要 ”选项卡，可快速浏览所有指标。
要保存报告，请选择报告并在右键菜单中点击“Save Report“。报告将以MXMR格式保存。这种格式可在用户界面中使用 (file > Open Report，或将.mxmr文件拖放至MXAM应用程序窗口中）。
加载报告最快捷的方法是使用拖放功能。
您还可以将报告导出为HTML、PDF或Excel格式。
自定义MXAM
您对如何将MXAM集成到您的软件开发环境中有疑问吗？我们准备了一系列常见问题和说明，帮助您顺利上手MXAM ：
在本视频中，Model Engineering Solutions （MES模赛思）将演示如何将MXAM项目设置为mxmp-文件。您将学习如何创建和配置MXAM项目以及如何保存和加载项目。建议您在观看此视频前了解MXAM工作流程的基本知识，此视频侧重于MXAM工作流程的第一步。
MXAM内自带一系列建模规范文档，您可以在“Library Browser”透视图的”Guideline Documents“视图中找到。
要想创建一个自定义文档，选择视图工具栏中的”New... “创建新文档，或者选择一个现有文档，点击”Save as...“另存，然后根据自己的需要修改文档。
在文档编辑器中，编辑章节结构和添加建模规范。
MXAM为自动化分析提供了不同的批处理接口。无头windows接口、MATLAB API、JAVA API或Web服务接口（根据客户要求）可以用来从另一个应用程序或持续集成服务器控制MXAM。请参阅用户指南以获取详细说明。（见图）
MXAM提供了钩子/回调函数，可用于自定义启动、关闭或分析程序。
这些钩子函数位于MXAM的doc目录中。要使用钩子函数，请将该函数复制到另一个目录中，对其进行自定义，并确保其在启动或分析期间位于MATLAB路径中。
大多数检查都提供可用于配置自定义检查步骤的默认参数。在工具菜单中，选择”Settings > Check Parameters“或在”Details“视图中双击一个参数打开”Customize Check Parameters Wizard“。使用搜索和筛选功能找到想要的参数，并在表中选择它。在”Parameter Settings“部分，覆盖项目配置的默认值。（如图）
要实现自定义检查，请参阅开发人员指南。
MXAM工具使用
您是否有关于建模规范和静态模型分析方面的问题？我们准备了一系列MXAM的常见问题和说明，帮助您顺利上手MXAM ：
如想使用自动修复功能，请单击”Document Navigation“视图中的Tree Menu，选择”show repairable checks only“。右键单击Tree Menu中的检查结果，选择“Repair”。选择完成后，所有检测结果会显示在一个对话框中，您可以选择查看，进行修复，或跳过操作。
您也可以手动修复模型中的违规条目。手动修复完成后，右键单击该检查结果，选择“Rerun”，查看违规问题是否已解决。
您可以使用软件注释功能对违规结果进行偏差注释。选择违规条目，点击”Add Annotation“。在comment处写下注释，如有需要也可以更改检查结果的类型。在向导的第二页将您的注释保存在工件旁边的”annotation definition（文件）“中，或保存在库中。该注释将反映在后续的每次检查运行中。注释详细信息和原始结果类型显示在“Finding Details”视图中。所有报告导出格式中都包含注释。
请检查相应的检查项是否需要可编译的模型。查看“编译模型要求”属性或查看错误信息。
请联系支持团队：mxam@model-engineers.com。
想要忽略分析某（些）元素，有两种方法：
您可以设置全局MATLAB®参数来排除Simulink®库、模块类型或掩码类型。 这些元件在分析过程中会被筛除，并且不会在报告中出现。
此外，您也可以使用忽略列表来排除元素，例如子系统，模块类型或掩码类型，用于所有检查或特定检查。
最后的报告中将包含忽略列表元件的检查结果，并标记为”ignored“。
在MXAM中启动MoRe有两种方法，以下视频中有详细介绍。一种方法是从Simulink工具栏启动MoRe。另一种方法是右键单击模型。使用MoRe能够帮助用户改进模型，同时简化并加速日常工作。通过MoRe的自动布局功能，Simulink建模变得更加轻松。
保密性 & 安全性
我需要对MXAM进行鉴定吗？
根据ISO 26262等安全标准对工具进行鉴定需要对工具进行分类和鉴定。这种分类取决于您所处的环境。如果分类结果为TCL 2或3，则需要在工具链中对MXAM进行鉴定。
工具鉴定工具包
我们可为您提供ISO 26262鉴定工具包。本工具包为您提供了一个框架：
- 确定软件工具需要的可信域，并
- 对软件工具进行鉴定，以证明该工具适用于定制ISO 26262所要求的活动或任务。
有任何问题，请联系sales@model-engineers.com。
MXAM是经TÜV SÜD（南德意志技术监督协会）认证的T2离线支持工具，可用于安全相关的嵌入式软件开发，并完全符合ISO 26262、IEC 61508和ISO 25119标准。MXAM专为功能安全开发人员，测试人员和质量经理在MATLAB®/Simulink®、Embedded Coder®和 TargetLink®平台上进行基于模型的开发（MBD）而设计。
快速联系MXAM开发和支持团队
您可以在此向我们咨询有关MES Model Examiner® (MXAM)的任何问题。您还可以通过此表格了解MES工具的最新更新和发行说明（季度工具更新快讯）。您还可以向我们发送详细的支持请求。
