CANoe

From RadiWiki
Revision as of 13:04, 15 February 2019 by Joro (talk | contribs) (→‎CAPL)
Jump to navigation Jump to search
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

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 the CANoe software. The CANalyzer software of Vector Informatik cannot be used for this interface, as it is missing API calls to retrieve the correct signals. We have tested this interface with the Vector Informatik CANoe software version 9.0 SP5. It is also required that the CANoe software installed on the same PC as on which RadiMation is installed.

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 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 CANoe software.

This does include the following 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 file.
  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.

Information.png
Note: The CANoe Switch Matrix device driver is not able to determine if a specifically named CAPL function is existing in the running CANoe environment.

When one or more of the specifically named CAPL functions from the RadiMationInterface.can file, is not implemented, the function call is being forwarded to the CANoe software itself, and there will be no error message or return value. The CANoe Switch Matrix is thus not able to warn or raise an error when one or more of the specifically called CAPL functions is not implemented.

Events in the CAPL interface[edit]

The events given to the CAPL interface are event triggered. This means that the information is send the moment it becomes available.

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.

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 at all.

Which events are triggered, and how often they are triggered is completely dependent on the configuration of the TSF in RadiMation®.

When filtering of the events is required then this can be implemented in the CANoe software.