vTESTstudio - VT System CAPL Functions - VT2004（续1）
成熟,就是某一个突如其来的时刻,把你的骄傲狠狠的踩到地上,任其开成花或者烂成泥。
vtsStartStimulation - 启动激励输出
功能：自动激励输出
注意：在启动激励输出之前，一定要设置好输出模式
Target：目标通道变量空间名称，例如：VTS::RPM_Sensor
返回值：
0：成功重置目标通道最大和最小值
-1：调用错误
-2: 调用命令的命名空间不存在、不是有效的VT系统命名空间或不支持此命令。
-4: 未在测试模块的主方法上下文中调用该函数，没有等到从VT系统接管设置。
Demo演示
参考vtsStopStimulation代码
vtsStopStimulation - 停止激励输出
功能：停止激励输出
注意：停止激励信号的输出是将激励模式重置，如果想要再次启动激励输出，不仅需要vtsStartStimulation来再次激动，并且需要在启动之前通过函数vtsSetStimulationMode重新设置激励模式，否则启动激励信号输出将会失败。停止激励输出是需要一小段时间来实现的，因此如果是用在处理函数过程中，这点需要注意，可能会影响预期的结果，最好是在脚本的结束使用，这样不会影响到程序的执行。
Target：目标通道变量空间名称，例如：VTS::RPM_Sensor
返回值：
0：成功重置目标通道最大和最小值
-1：调用错误
-2: 调用命令的命名空间不存在、不是有效的VT系统命名空间或不支持此命令。
-4: 未在测试模块的主方法上下文中调用该函数，没有等到从VT系统接管设置。
Demo演示
以下示例演示了如何使用VT2004通道的PWM输出来模拟基于PWM的传感器（例如RPM传感器）。本例中使用的通道称为RPM_Sensor。
SimulateSensorPWM ()
{// 频率设置 (100Hz)float currentFrequency = 100.0;// 选择电压刺激和PWM曲线类型vtsSetStimulationMode("VTS::RPM_Sensor", eVTSStimulationModeVoltage);vtsSetCurveType("VTS::RPM_Sensor", eVTSCurveTypePWM);// PWM信号将在0V和5V之间切换vtsSetPWMVoltageLow("VTS::RPM_Sensor", 0.0);vtsSetPWMVoltageHigh("VTS::RPM_Sensor", 5.0);// 将重复次数设置为无限vtsSetPWMRepeats("VTS::RPM_Sensor", 0);// 设置初始频率（100Hz）和占空比（50%）值@sysvar::VTS::RPM_Sensor::PWMFreq = currentFrequency;@sysvar::VTS::RPM_Sensor::PWMDC = 50.0;// 开始仿真vtsStartStimulation("VTS::RPM_Sensor");// To stimulate different sensor readings increase// frequency of the PWM signal over time//使用不同的激励传感器//PWM信号随时间的频率while(currentFrequency < 200){// 每100ms将频率增加1HzTestWaitForTimeOut(100);currentFrequency += 1;@sysvar::VTS::RPM_Sensor::PWMFreq = currentFrequency;}//停止仿真vtsStopStimulation("VTS::RPM_Sensor");
}
//同功能不同实现方法
sysvar::VTS::RPM_Sensor.StartStimulation();
sysvar::VTS::RPM_Sensor.StopStimulation();
vtsSetPWMResistanceLow - 设置PWM输出的低电阻值
功能：在特定输出的PWM模式下输出指定PWM信号的低电阻值
Target：目标通道变量空间名称，例如：VTS::Temp_Sensor
Resistance：电阻值，单位为欧姆。VT2004第四通道支持范围为1欧姆 - 25000欧姆；其他通道支持范围为10欧姆 - 15000欧姆；当电阻值设置为-1时，则代表阻值无穷大。如果使用过程中超出硬件的使用范围可能舍入到下一个最高值，也有可能设置为最低值。
返回值：
0：成功重置目标通道最大和最小值
-1：调用错误
-2: 调用命令的命名空间不存在、不是有效的VT系统命名空间或不支持此命令。
-4: 未在测试模块的主方法上下文中调用该函数，没有等到从VT系统接管设置。
Demo演示
参考vtsSetPWMResistanceHigh的demo
vtsSetPWMResistanceHigh - 设置PWM输出的高电阻值
功能：在特定输出的PWM模式下输出指定PWM信号的高电阻值
Target：目标通道变量空间名称，例如：VTS::Temp_Sensor
Resistance：电阻值，单位为欧姆。VT2004第四通道支持范围为1欧姆 - 25000欧姆；其他通道支持范围为10欧姆 - 15000欧姆；当电阻值设置为-1时，则代表阻值无穷大。如果使用过程中超出硬件的使用范围可能舍入到下一个最高值，也有可能设置为最低值。
返回值：
0：成功重置目标通道最大和最小值
-1：调用错误
-2: 调用命令的命名空间不存在、不是有效的VT系统命名空间或不支持此命令。
-4: 未在测试模块的主方法上下文中调用该函数，没有等到从VT系统接管设置。
Demo演示
下面示例展示了了如何使用VT2004通道的内部电阻十进制来模拟基于PWM的传感器。在通道Temp_Sensor上，电阻器在100欧姆和140欧姆之间切换，频率为20 Hz，占空比为50%。
SimulateSensorPWMResistance ()
{//选择电阻激励和PWM曲线类型vtsSetStimulationMode("VTS::Temp_Sensor", 3);vtsSetCurveType("VTS::Temp_Sensor", 1);//配置低电阻（100Ω）和高（140Ω）电阻值vtsSetPWMResistanceLow("VTS::Temp_Sensor", 100);vtsSetPWMResistanceHigh("VTS::Temp_Sensor", 140);//将重复次数设置为无限vtsSetPWMRepeats("VTS::Temp_Sensor", 0);//创建频率为20Hz、DC 50%的PWM信号@sysvar::VTS::Temp_Sensor::PWMFreq = 20.0;@sysvar::VTS::Temp_Sensor::PWMDC = 50.0;// 开始仿真vtsStartStimulation("VTS::Temp_Sensor");
}
//同功能不同实现方法
sysvar::VTS::Temp_Sensor.SetPWMResistanceHigh(140);
vtsSetPWMStartDelay - 设置PWM信号曲线输出的启动延迟
功能：指定曲线激励或PWM激励开始后的延迟。该函数仅在VT2004和VT2848模块支持此功能。
Target：目标通道变量空间名称，例如：VTS::Temp_Sensor
StartDelay：启动延迟时间，单位 秒。PWM波形或者曲线输出开始后延时的时间，该参数以纳秒分辨率传输至VT系统。
注意：该函数只能在VT系统模块的适当通道的系统变量命名空间上调用。
返回值：
0：成功重置目标通道最大和最小值
-1：调用错误
-2: 调用命令的命名空间不存在、不是有效的VT系统命名空间或不支持此命令。
-3: 指定的StartDelay无效
Demo演示
demo展示中，两个VT2004通道的PWM输出模拟两个具有PWM输出的传感器。SetPWMStartDelay命令确保通道Sensor2上的PWM输出在2ms后启动，以产生相应的相移。
//为传感器1设置PWM激励
//设置电压刺激模式
vtsSetStimulationMode( "VTS::Sensor1", 1);
//设置曲线型PWM
vtsSetCurveType("VTS::Sensor1", 1);
//将PWM信号的低电压设置为10V
vtsSetPWMVoltageLow("VTS::Sensor1", 10);
//将PWM信号的高电压设置为14V
vtsSetPWMVoltageHigh("VTS::Sensor1", 14);
//设置占空比为40%
@sysvar::VTS::Sensor1::PWMDC = 40;
//将频率设置为100Hz
@sysvar::VTS::Sensor1::PWMFreq = 100;
//为传感器2设置PWM激励
//设置电压激励模式
vtsSetStimulationMode("VTS::Sensor2", 1);
//设置曲线型PWM
vtsSetCurveType("VTS::Sensor2", 1);
//将PWM信号的低电压设置为10V
vtsSetPWMVoltageLow("VTS::Sensor2", 10);
//将PWM信号的高电压设置为14V
vtsSetPWMVoltageHigh("VTS::Sensor2", 14);
//设置占空比为40%
@sysvar::VTS::Sensor2::PWMDC = 40;
//将频率设置为100Hz
@sysvar::VTS::Sensor2::PWMFreq = 100;
/为传感器2设置2ms的启动延迟
//->PWM信号有轻微的相移
vtsSetPWMStartDelay("VTS::Sensor2", 0.002);
//启动激励
vtsStartStimulation("VTS::Sensor1");
vtsStartStimulation("VTS::Sensor2");