CPAL脚本自动化测试 ———— Signal Wait系列函数及使用

等待指示类（Wait Instruction Functions）主要运用于为用户提供动作设置、等待测试等功能。

1. TestValidateForTesterConfirmation 函数
   使用格式如下。主要运用于创建一个弹出窗口，将给定的字符串提供给测试人员。 测试人员可以通过“是”，“否”或“不清楚”来确认该窗口。该窗口包含用于输入注释的字段，该注释将自动应用于测试报告中。
   
2. TestWaitForEnvVar 函数
   使用格式如下。等待指定环境变量的出现。 如果事件在规定时间到期之前未发生，则等待条件仍然可以解决。
   
   用例：

// waiting point is discontinued immediately
long result;
putValue (evMyEnvVar, 1);
result = TestWaitForEnvVar (evMyEnvVar, 1000); // Does not wait, is immediately discontinued by an environment variable change!

3. TestWaitForSignalInRange 函数
   使用格式如下。主要运用于检测某个信号是否在指定的时间内，处于指定的范围。例如在自动泊车的台架测试过程中，针对于我们想泊入的位置来说，这个函数就帮了大忙。
   
   用例：

// waits for a specified value range of signal ‘Velocity’
long result;
result = TestWaitForSignalInRange(Velocity, 80, 100, 2000);

4. TestWaitForSignalOutsideRange 函数
   使用格式如下。主要运用于检测某个信号是否在指定的时间内，不处于指定的范围。该函数TestWaitForSignalInRange 函数属于逻辑非的关系。
   
   用例：

// waits for a specified value range of signal ‘Velocity’
long result;
result = TestWaitForSignalOutsideRange(Velocity, 80, 100, 2000);

5. TestWaitForSignalMatch 函数
   使用格式如下。主要运用于检测某个信号是否在指定时间内变化成了指定的值。针对我们需要达到某种状态之后，在进行某些操作的情景，我们可以通过这个函数实现。
   
   用例：

// waits for a specified value of signal ‘Velocity’
long result;
result = TestWaitForSignalMatch(Node_SUT::Velocity, 80, 1000);

6. TestWaitForSysVar 函数
   使用格式如下。等待指定系统变量的出现。 如果事件在规定时间到期之前未发生，则等待条件仍然可以解决。
   
   用例：

// waits for the occurrence of SysVar ‚MySysVar’
long result;
result = TestWaitForSysVar(sysvar::Test::MySysVar, 2000);

7. TestWaitForTimeout 函数
   使用格式如下。主要运用于等待指定的时间。
   
   用例：

// waits for 3000 ms
long result;
result = TestWaitForTimeout(3000);

8. TestWaitForTesterConfirmation 函数
   使用格式如下。主要用来创建一个弹出窗口等待测试人员的确认。
   
   用例：

// waits for the answer of the user
long result;
result = TestWaitForTesterConfirmation("Any text or question", 10000);

9. TestWaitForMessage 函数
   使用格式如下。主要运用于等待指定Message的出现。该函数对于需要实现整合多个网络之间的通信有着很大的帮助。
   
   用例：

// waits for the occurrence of message ‚VehicleMotion’
long result;
result = TestWaitForMessage(VehicleMotion, 2000);

10. TestWaitForSignalAvailable 函数
    使用格式如下。主要运用于测试特定信号的可用性，并在必要时等待直到其可用性。关于如何定义signal的状态为Available？CAPL的指导文档中定义如下：在测量开始之后至少从总线接收一次的信号被分类为“Available”。
    
    用例：

// waits for the occurrence of signal ‚EngineRunning’
long result;
result = TestWaitForSignalAvailable(EngineRunning, 2000);

11. TestWaitForSignalsAvailable 函数
    使用格式如下。主要运用于测试指定节点的所有信号的可用性。
    
    用例：

// waits for the availability of all tx signals of node ‘SUT’
long result;
result = TestWaitForSignalsAvailable(SUT, 2000);