CANoe操作介绍系列 ———— 系统变量与环境变量

姊妹篇： CANoe操作介绍系列 ———— 创建数据库（.dbc）

系统变量

创建

1. 创建路径。
   
2. 创建系统变量需要注意的参数。
   2.1 Namespace：定义了系统变量组的名称。如果需要在大的系统变量组里新建次级的系统变量组，则需要使用到Name1::Name2格式。具体情况如下。
   

2.2 Name：系统变量的具体名称。后续的使用会直接引用该名称。
2.3 Data type：选择需要的类型。下拉菜单中支持的所有类型均在截图中可以看到。

2.4 Location：该系统变量组存放的路径、名称和格式。我所在的项目中使用到了XML/vsysvar两种格式。在进行系统变量的移植过程中，需要注意这些信息。
2.5 Values：初始值、最小值、最大值、单位、值表。因为跟环境变量不一样，如果系统变量的取值较多，在这里需要value table中进行枚举。

使用

在系统变量被定义好了之后，相当于我们定义了一个全局变量。具体如何来使用，我们可以通过CAPL内自带的函数来完成使用。

方法1：on sysvar
对CANoe中系统变量的值更改做出反应。Measurement Setup中的CAPL节点不会阻止系统变量。 因此，当有两个CAPL节点串联时，两个节点都将通过sysVar上的事件过程对同一系统变量做出反应。
例子：

on sysvar IO::DI_0
{
$Gateway::IOValue = @this;
}

方法2：SysGetVariableInt/SysGetVariableFloat/SysSetVariableInt/SysSetVariableFloat
对系统变量的值进行获取或设置。也可以通过特殊字符 @ / $ 来对变量进行复制和取值。
例子：

intValue = @Namespace1::Parameter2;
@Debug::MotorValues::EngineSpeed = $EngineSpeed;

on key 'b'
{
  double value;
  value = SysGetVariableFloat(sysvar::MyNamespace::FloatVar);
  write("Value of FloatVar is %g", value);
}

其他关于系统变量的使用，请在help文档中搜索System Variables CAPL Functions，就可以获取到最全面的解析与介绍。

注意事项

1. 系统变量的初始值需要定义明确。如果在使用过程中没有定义初始值，如果涉及到系统变量的reset，那么将无法完成reset功能。
2. 引用的时候，系统变量的使用过程中注意格式正确。脚本中的使用情况如下。
   
3. 如果需要自定义系统变量的真值表，选择custom来完成真值表的创建。
   
4. 在同样的情况下，推荐使用系统变量

环境变量

创建

1. 打开一个已经存在的DBC文件，选择新建一个DBC。
2. 选择合适的模板。保存好路径和名称。
   
3. 此时开始在Environment Variables目录下开始新建环境变量。
   
4. 参数的设置。
   4.1 Name：环境变量的名称
   4.2 Value Type：数据类型。相比于系统变量，环境变量所支持的数据类型要少一些。
   
   4.3 Value Table：真值表。请参考姊妹篇中的相关介绍完成真值表的建立。
   4.4 初始值、最小值、最大值：依据需求完成设定

使用

在环境变量被定义好了之后，相当于我们定义了一个局部变量。具体如何来使用，我们可以通过CAPL内自带的函数来完成使用。

**方法1：on envVar **
对CANoe的网络节点模型中环境变量的值更改做出反应。 Measurement Setup中的CAPL节点不会阻止环境变量。因此，当串联有两个CAPL节点时，两个节点都使用envVar上的事件过程对同一环境变量做出反应。
例子：

on envvar Switch {
// Declare a CAN message to be transmitteed
message Controller msg;

// Read out the value of the switch
// Assign to the signal Stop
msg.Stop = getvalue(this);
// Output the message on the bus
output(msg);
}

**方法2：putValue/getValue **
对环境变量的值进行获取或设置。
例子：

// Copy 64 bytes of the data buffer into the environment variable DiagData
putValue(DiagData, dataBuf, 64);

// Read the value of environment variable NodeName
copiedBytes = getValue(NodeName, cBuf);

其他的操作我这边用的少，就不做过多的展开。

注意事项

1. 环境变量的使用必须要以DBC的格式来使用，并且需要将DBC添加到CAN 网络中。
2. 环境变量在CANoe 12.0 版本之后不适用。详情见链接