CANoe: Difference between revisions

From RadiWiki
Jump to navigation Jump to search
 
(65 intermediate revisions by 5 users not shown)
Line 1: Line 1:
CANoe from [http://www.vector-informatik.com Vector] is used for reading out the CAN or LIN bus.
__NOTOC__
CANoe and CANalyzer are software packages from [[wikipedia:Vector Informatik|Vector Informatik]] which can be used to control and monitor the [[wikipedia:CAN bus|CAN bus]] or [[wikipedia:Local Interconnect Network|LIN bus]].


There are 2 ways of using the software, and there for 2 ways of controlling. This is because RadiMation is modular build, and is has no idea that it is talking to a software package instead of hardware.
It is possible to retrieve measurement values from the CAN bus into RadiMation. And it is also possible to transfer measurement values from RadiMation to the CANoe software, which allows to put the RadiMation measurement values on the CAN bus.
Each of these data transfer directions can be used in a RadiMation immunity test, and it is even possible to use both data transfer directions in the same immunity test.


= Getting information from CANoe =
This interface is only working with both CANalyzer and CANoe. We have tested this interface with the Vector Informatik CANoe software and the CANalyzer software version 11 SP2. It is required that the CANoe software or CANalyzer software is installed on the same PC as on which RadiMation is installed.
Use the AD converter [[CANoe Interface]] to read out the information from the CANoe Software.


= Getting information to CANoe =
If you are unfamiliar to CANoe/CANalyzer or would like to know more we advise to read this quickstart guide from Vector: https://assets.vector.com/cms/content/products/VectorCAST/Events/TechNights/CANalyzer_QuickStart.pdf
Use the CAPL interface to communicate with the software.


=CAPL=  
= Retrieving information from CANoe into RadiMation =
Use the {{ScreenElement|[[CANoe Interface]]}} AD Convertor device driver to read out measurement values from the CANoe Software into RadiMation.


CANoe supports CAPL, a programming interface. Through this interface RadiMation can send information back the Canoe software.  
To connect with RadiMation you need to configure the following things:
For Example:
<ol>
*Frequency
<li>Start the CANoe software, and load the desired configuration. This can for example be the 'EASY.CFG' example that is included with the CANoe software in the 'CANoe Sample Configurations\CAN\' folder. <BR />[[File:CANoeExample.png]]</li>
*Field Strength
<li>Start the RadiMation software.</li>
*Power
<li>Go to the AD device driver configuration window. <BR />{{Menu|Configuration|Configuration|Device Drivers|AD Convertors}}</li>
<li>Create the [[CANoe Interface]] device driver (as an AD Convertor) in RadiMation.</li>
<li>Open the 'Advanced' settings window of the {{ScreenElement|CANoe Interface}} device driver. <BR />[[File:CANoe AD Convertor.png]]<BR>Use the {{ScreenElement|Set up}} buttons to select up to 8 measurement values from the CAN bus, that should be transferred to RadiMation. When the {{ScreenElement|Set up}} button is pressed (for example for {{ScreenElement|Channel 1}}), a CANoe signal selection dialog is shown.<BR />[[File:CANoe AD Convertor signal selector.png]]<BR />This dialog allows to select the desired signal, for example the '''Signals::easy::EngineState::EngineSpeed''' signal.</li>
<li>Close all dialogs by pressing {{ScreenElement|Select}}, {{ScreenElement|Ok}} and {{ScreenElement|Close}}.
<li>In the EUT window in RadiMation, specify an EUT monitoring input channel for the channel 1. <BR />[[File:CANoe EUT Monitoring Input Setup.png]]<BR />
By selecting the correct {{ScreenElement|Device}} and {{ScreenElement|Channel}}, a link to the already configured [[CANoe Interface]] device driver will be created.
No re-calculation of the value is needed, so it is sufficient to select {{ScreenElement|None}} as the {{ScreenElement|Calculation}} method.
 
For each additional configured channel that is selected in the '''CANoe Interface''' device driver, a matching EUT Monitoring input should also be configured.</li>
</ol>
 
When an immunity test is started, all the activated EUT Monitoring inputs will be measured on each tested frequency, and thus the data from the CAN bus (through the CANoe software) will also be included in RadiMation, and will be shown in the graphs.
 
== Retrieving CANoe system variables ==
The CANoe signal selection dialog also allows to select CANoe system variables. The values of those CANoe system variables, can thus also be retrieved and shown in RadiMation during an immunity test. However, be aware that when monitoring CANoe system variables, only the following types are supported:  
* Integer (32 Bit signed)
* Integer (64 Bit signed)
* Double  (64 Bit)
* String
 
[[File:CANoeSystemVariables.png]]
 
= Supplying RadiMation values to CANoe =
It is possible to supply RadiMation values to the CAN bus through the CANoe software. The exact details on how this should be done is however completely depending on the implementation of the units on the CAN bus itself. To allow the flexibility to adjust and adapt to the messages on the CAN bus, RadiMation is calling specific CAPL functions, which can be customized to perform the desired and applicable action. Using this CAPL interface allows for full flexibility on the implementation and details, or how the measurement information should be transmitted on the CAN bus.


RadiMation connects through COM to this application
== CAPL interface ==
CANoe supports CAPL, a programming interface designed by [[wikipedia:Vector Informatik|Vector Informatik]]. Through this interface, RadiMation can send updated measurement values to the running CANoe environment.


To connect with RadiMation you need to configure the following things:
This does include the following measurement values:
# Setting up the [[CANoe Switch Matrix]] device.
* Frequency
# inserting the RadiMationInterface.can file inside your CANoe/CANalyser project.
* Field Strength
* Signal power
* Forward power
* Current
* Turntable angle
* Antenna height
* Antenna polarization
* ... (and more)
 
RadiMation is calling specifically named CAPL functions. Those CAPL functions are specified in the [[RadiMationInterface.can]] file.
 
To include the [[RadiMationInterface.can]] file in your CANoe project, you should take the following steps:
# Download the ZIP file from the [[RadiMationInterface.can]] page.
# Extract the [[RadiMationInterface.can]] file from the ZIP file, and store it on a suitable location
# Start the CANoe software and load the desired configuration. That can for example be the 'EASY.CFG' example that is included with the CANoe software in the 'CANoe Sample Configuration\CAN\' folder.
# Switch to the Simulation Setup view within CANoe.<BR />[[File:CANoe Simulation setup.png]]
# Add a new Node to the simulation setup. This can for example be done by right-clicking on the horizontal red lines, and then select the '''Insert ...''' menu entry. It will allow to select the correct *.CAN file, which could for example be the [[RadiMationInterface.can]] file.
 
To configure RadiMation to call the CAPL functions, the following steps should be performed:
<ol>
<li>Go to the Switch matrix device driver driver configuration window. {{Menu|Configuration|Configuration|Device drivers|Switch matrixes}}.</li>
<li>Create the [[CANoe Switch Matrix]] device driver in RadiMation. No further configuration of this device driver is needed.</li>
<li>Select the created [[CANoe Switch Matrix]] device driver in the testsite that is used during the immunity test.</li>
</ol>
 
When now an immunity test is started, the [[CANoe Switch Matrix]] device driver will call the functions in the [[RadiMationInterface.can]] file that is included in the running CANoe environment.
 
[[File:CANoe CAPL messages.png]]
 
The functions that are included in the [[RadiMationInterface.can]] file only provide a very simple implementation where the received updates of the measurement values are written to the console in CANoe (see the screenshot above). Depending on the requirements of the connected CAN bus, those functions can however be extended to perform other actions, like transmitting a message on the CAN bus.  
 
Note that the functions in the [[RadiMationInterface.can]] file do not support a callback to the RadiMation application. So this CAPL interface can only be used to send updates of measurement values during a test from [[RadiMation]] to CANoe.
 
= Using CANalyzer with CAPL/CANoe Switch matrix =
 
 
Instead of CANoe one can also use CANalyzer to display the values transmitted from RadiMation.
 
One can use the CANoe Switchmatrix to do this. It will recognize if CANalyzer is installed and will start the software if CANoe is not available.
 
To configure RadiMation to call the CAPL functions, the following steps should be performed:
<ol>
<li>Go to the Switch matrix device driver driver configuration window. {{Menu|Configuration|Configuration|Device drivers|Switch matrixes}}.</li>
<li>Create the [[CANoe Switch Matrix]] device driver in RadiMation. No further configuration of this device driver is needed.</li>
<li>Select the created [[CANoe Switch Matrix]] device driver in the testsite that is used during the immunity test.</li>
</ol>


The functions inside the [[RadiMationInterface.can]] can be extended to your needs
Note that the function do not support a call back to the RadiMation application. So the CAPL interface can only be used to insert information from [[RadiMation]] to CANoe or CANalyser.


'''Note:''' You can't find out if a CAPL function exist with CANoe/CANalyzer COM server.  
Now add the [[RadiMationInterface.can]] to CANalyzer. This is the script defining the parameters that need to be sent.
When the function not exist the call will go in CANoe but there will come up no error message or return value.
<ol>


=Events in the CAPL interface=
# Download the zip file from the [[RadiMationInterface.can]] file.
The events given to the CAPL interface are event triggered. This means that the information is send the moment it becomes available.
# Open up CANalyzer
# Go to “Analysis & Stimulation”/”Measurement Setup”<BR /> [[File:MeasurementSetup.png]]
# Go to configuration:<BR /> [[File:configuration.png]]
# "Right click" on a node<BR /> [[File:InsterNodeCircle.png]]
# Select “Insert Program Node, the node should now be inserted.<BR /> [[File:InsertNode.png]]
# Right click on the node and click "Configuration"
# Click "Select"
# Load the file: [[RadiMationInterface.can]] and when loaded correctly the screen should look like this:<BR /> [[File:Inderface.can.png]]
# Now press compile to make sure that the script is properly initiated.


For example, when the Forward power has been measured the forward power information is send through the interface. The same goes for a frequency change.
==Test the CAPL coupling between Radimation and CANalyzer==


This also means that when information is not available, for example the test is done only on signal generator level then the forward power will not be send.
Setup a CAPL switch matrix. Add this to a radiated immunity test-site. Now start a single-band RI test.
During initialization CANalyzer is launched and you should see the data coming in CANalyzer, see above for the exact procedure.


== Explanation of the functions ==
In the example below a RI substitution single band test is used to verify.<BR /> [[File:RiSubstitution.png]]<BR />
When running the test CANalyzer will start automatically and will start to receive the data from Radimation.<BR /> [[File:Canalyzer.png]]<BR />


===Test_Frequency===
==Summary==
===Test_Carrier_Level===
CANalyzer and RadiMation are now properly set-up. Every time a test is started with a test-site that includes a CANoe switch matrix, CANalyzer or CANoe is automatically started.
===Test_Forward_Power===
===Test_Reflected_Power===
===Test_Average_Field===
===Test_Calculated_Field===
===Test_Measured_Current===
===Test_Sensor_Power===
===Test_Amplitude_Modulation_Internal===
===Test_Amplitude_Modulation_External===
===Test_Frequency_Modulation_Internal===
===Test_Frequency_Modulation_External===
===Test_Pulse_Modulation_Internal===
===Test_Pulse_Modulation_External===
===Test_Modulation_On===
===Test_Modulation_Off===
===Antenna_Movement_Started===
===Antenna_Movement_Stopped===
===Antenna_Movement_Percentage===
===Antenna_Movement_Changing_Polarisation===
===TurnTable_Movement_Started===
===TurnTable_Movement_Stopped===
===TurnTable_Movement_Turning_Percentage===

Latest revision as of 14:47, 3 October 2024

CANoe and CANalyzer are software packages from Vector Informatik which can be used to control and monitor the CAN bus or LIN bus.

It is possible to retrieve measurement values from the CAN bus into RadiMation. And it is also possible to transfer measurement values from RadiMation to the CANoe software, which allows to put the RadiMation measurement values on the CAN bus. Each of these data transfer directions can be used in a RadiMation immunity test, and it is even possible to use both data transfer directions in the same immunity test.

This interface is only working with both CANalyzer and CANoe. We have tested this interface with the Vector Informatik CANoe software and the CANalyzer software version 11 SP2. It is required that the CANoe software or CANalyzer software is installed on the same PC as on which RadiMation is installed.

If you are unfamiliar to CANoe/CANalyzer or would like to know more we advise to read this quickstart guide from Vector: https://assets.vector.com/cms/content/products/VectorCAST/Events/TechNights/CANalyzer_QuickStart.pdf

Retrieving information from CANoe into RadiMation[edit]

Use the CANoe Interface AD Convertor device driver to read out measurement values from the CANoe Software into RadiMation.

To connect with RadiMation you need to configure the following things:

  1. Start the CANoe software, and load the desired configuration. This can for example be the 'EASY.CFG' example that is included with the CANoe software in the 'CANoe Sample Configurations\CAN\' folder.
    CANoeExample.png
  2. Start the RadiMation software.
  3. Go to the AD device driver configuration window.
       Menu.svg Configuration
          Menu.svg Configuration
             Menu.svg Device Drivers
                Menu.svg AD Convertors
  4. Create the CANoe Interface device driver (as an AD Convertor) in RadiMation.
  5. Open the 'Advanced' settings window of the CANoe Interface device driver.
    CANoe AD Convertor.png
    Use the Set up buttons to select up to 8 measurement values from the CAN bus, that should be transferred to RadiMation. When the Set up button is pressed (for example for Channel 1), a CANoe signal selection dialog is shown.
    CANoe AD Convertor signal selector.png
    This dialog allows to select the desired signal, for example the Signals::easy::EngineState::EngineSpeed signal.
  6. Close all dialogs by pressing Select, Ok and Close.
  7. In the EUT window in RadiMation, specify an EUT monitoring input channel for the channel 1.
    CANoe EUT Monitoring Input Setup.png
    By selecting the correct Device and Channel, a link to the already configured CANoe Interface device driver will be created. No re-calculation of the value is needed, so it is sufficient to select None as the Calculation method. For each additional configured channel that is selected in the CANoe Interface device driver, a matching EUT Monitoring input should also be configured.

When an immunity test is started, all the activated EUT Monitoring inputs will be measured on each tested frequency, and thus the data from the CAN bus (through the CANoe software) will also be included in RadiMation, and will be shown in the graphs.

Retrieving CANoe system variables[edit]

The CANoe signal selection dialog also allows to select CANoe system variables. The values of those CANoe system variables, can thus also be retrieved and shown in RadiMation during an immunity test. However, be aware that when monitoring CANoe system variables, only the following types are supported:

  • Integer (32 Bit signed)
  • Integer (64 Bit signed)
  • Double (64 Bit)
  • String

CANoeSystemVariables.png

Supplying RadiMation values to CANoe[edit]

It is possible to supply RadiMation values to the CAN bus through the CANoe software. The exact details on how this should be done is however completely depending on the implementation of the units on the CAN bus itself. To allow the flexibility to adjust and adapt to the messages on the CAN bus, RadiMation is calling specific CAPL functions, which can be customized to perform the desired and applicable action. Using this CAPL interface allows for full flexibility on the implementation and details, or how the measurement information should be transmitted on the CAN bus.

CAPL interface[edit]

CANoe supports CAPL, a programming interface designed by Vector Informatik. Through this interface, RadiMation can send updated measurement values to the running CANoe environment.

This does include the following measurement values:

  • Frequency
  • Field Strength
  • Signal power
  • Forward power
  • Current
  • Turntable angle
  • Antenna height
  • Antenna polarization
  • ... (and more)

RadiMation is calling specifically named CAPL functions. Those CAPL functions are specified in the RadiMationInterface.can file.

To include the RadiMationInterface.can file in your CANoe project, you should take the following steps:

  1. Download the ZIP file from the RadiMationInterface.can page.
  2. Extract the RadiMationInterface.can file from the ZIP file, and store it on a suitable location
  3. Start the CANoe software and load the desired configuration. That can for example be the 'EASY.CFG' example that is included with the CANoe software in the 'CANoe Sample Configuration\CAN\' folder.
  4. Switch to the Simulation Setup view within CANoe.
    CANoe Simulation setup.png
  5. Add a new Node to the simulation setup. This can for example be done by right-clicking on the horizontal red lines, and then select the Insert ... menu entry. It will allow to select the correct *.CAN file, which could for example be the RadiMationInterface.can file.

To configure RadiMation to call the CAPL functions, the following steps should be performed:

  1. Go to the Switch matrix device driver driver configuration window.
       Menu.svg Configuration
          Menu.svg Configuration
             Menu.svg Device drivers
                Menu.svg Switch matrixes .
  2. Create the CANoe Switch Matrix device driver in RadiMation. No further configuration of this device driver is needed.
  3. Select the created CANoe Switch Matrix device driver in the testsite that is used during the immunity test.

When now an immunity test is started, the CANoe Switch Matrix device driver will call the functions in the RadiMationInterface.can file that is included in the running CANoe environment.

CANoe CAPL messages.png

The functions that are included in the RadiMationInterface.can file only provide a very simple implementation where the received updates of the measurement values are written to the console in CANoe (see the screenshot above). Depending on the requirements of the connected CAN bus, those functions can however be extended to perform other actions, like transmitting a message on the CAN bus.

Note that the functions in the RadiMationInterface.can file do not support a callback to the RadiMation application. So this CAPL interface can only be used to send updates of measurement values during a test from RadiMation to CANoe.

Using CANalyzer with CAPL/CANoe Switch matrix[edit]

Instead of CANoe one can also use CANalyzer to display the values transmitted from RadiMation.

One can use the CANoe Switchmatrix to do this. It will recognize if CANalyzer is installed and will start the software if CANoe is not available.

To configure RadiMation to call the CAPL functions, the following steps should be performed:

  1. Go to the Switch matrix device driver driver configuration window.
       Menu.svg Configuration
          Menu.svg Configuration
             Menu.svg Device drivers
                Menu.svg Switch matrixes .
  2. Create the CANoe Switch Matrix device driver in RadiMation. No further configuration of this device driver is needed.
  3. Select the created CANoe Switch Matrix device driver in the testsite that is used during the immunity test.


Now add the RadiMationInterface.can to CANalyzer. This is the script defining the parameters that need to be sent.

    1. Download the zip file from the RadiMationInterface.can file.
    2. Open up CANalyzer
    3. Go to “Analysis & Stimulation”/”Measurement Setup”
      MeasurementSetup.png
    4. Go to configuration:
      Configuration.png
    5. "Right click" on a node
      InsterNodeCircle.png
    6. Select “Insert Program Node, the node should now be inserted.
      InsertNode.png
    7. Right click on the node and click "Configuration"
    8. Click "Select"
    9. Load the file: RadiMationInterface.can and when loaded correctly the screen should look like this:
      Inderface.can.png
    10. Now press compile to make sure that the script is properly initiated.

    Test the CAPL coupling between Radimation and CANalyzer[edit]

    Setup a CAPL switch matrix. Add this to a radiated immunity test-site. Now start a single-band RI test. During initialization CANalyzer is launched and you should see the data coming in CANalyzer, see above for the exact procedure.

    In the example below a RI substitution single band test is used to verify.
    RiSubstitution.png
    When running the test CANalyzer will start automatically and will start to receive the data from Radimation.
    Canalyzer.png

    Summary[edit]

    CANalyzer and RadiMation are now properly set-up. Every time a test is started with a test-site that includes a CANoe switch matrix, CANalyzer or CANoe is automatically started.