##############################################
Demonstration of the CANoe Test Service Library (TSL)
##############################################

Intention:
=======
This demo is intended to show you the easy usage of TSL checks 
and stimulus functions  in CAPL. Therefore it contains a very 
simple test configuration for the test of one single node.

Architecture of the configuration:
========================

This demonstration configuration is splitted into two desktops:
- Desktop "Check Functions"
  shows the usage of checks with an example for 
  cycle time violation, signal value violation and response time violation.
  You may switch between the different panels by the main panel.
  
- Desktop "Stimulus Functions"
  shows the usage of stimulus functions with an example for 
  generating a ramp curve, toggled values or using other sources like
  environment variables or csv files.
   
Description of the CAPL nodes:
---------------------------------------------
a) SUT (System Under Test):
This is the node to be tested. 
It has the following tasks to do:
  a1. Generate a cyclic message
  a2. Consume the request message, and send a derived response 
       message
  a3. Generate a messsage with an associated signal in an allowed 
       value range.
The demo allows to manipulate the (correct) behavior of the SUT
using the SUT-Panel.

b) TestNode:
This node has the job to test the SUT by using the check functions. 
Therefore 3 different TSL-checks can be set up:
  b1. Check Cycle Time Violation
  b2. Check Message Distance Violation
  b3. Check Signal Value Violation
You can focus to each check by opening the appropriate check panel 
using the buttons of the main panel.
Each check has check parameters (validity ranges) that can be 
configured.

c) Interactive Generator IG:
This node sends a message cyclically. This message is intended to be 
processed by the SUT for the test a2.

d) StmNode (Stimulus Node):
This node has the job to generate the stimulus functions. With the panel
"Stimulus Control" you can  swith on/off the different stimulus functions.
At the graphic window you may see than the generated signal curves.


Use cases of the check functions:
=========================

u1) 
- Open the Signal Value check panel
- Activate the check (press the switch on)
- send a valid value (insert in the SUT-panel, and press "send")  
  --> no reaction
- Send an invalid value --> The problem is reported into the check 
  panel and into the write window of CANoe

u2) 
- Open the message distance check panel
- Activate the check
- Affect the SUT's processing time using the SUT-panel.
  --> If the allowed range of the timely distance between the request 
  and the response exceeds one of the limits, then the check reports 
  a failure.

u3) 
- Open the cycle time violation check panel
- Activate the check
- Have a look onto the data window and the graph window. Here you 
  can see the current cycle time's and the maximum and minimum 
  values.
- Increase the SUT's jitter using the SUT's panel, then the check will 
  report failures.
- Have a look onto the statistical values in the check's panel. 
  They allow you to specify the quality of the SUT.
    
*********************************************************************
A detailed description can be found in the online help (see example configurations
in the table of contents).
*********************************************************************

------------------------------------------------------------------------------------------------------
Copyright (c) by Vector Informatik GmbH Dep. Tools Automotive  2005
------------------------------------------------------------------------------------------------------