Raptor-Dev-Vector-CANape-Support: Difference between revisions

From NewEagleWiki
Jump to navigation Jump to search
(Move instructions for generating A2L files to a separate page, so it won't be duplicated between Vector CANoe & INCA support pages.)
 
(6 intermediate revisions by one other user not shown)
Line 9: Line 9:
==Steps to build A2L files for Vector CANape==
==Steps to build A2L files for Vector CANape==


* From the top level of the model, double click on the '''‘ECU Definition’ block''', and check '''‘Output HEX/A2L Files (Third-Party Tool Support)’'''.
Please see the A2L File Generation support page: [https://wiki.neweagle.net//index.php?title=Raptor-Dev-A2L-File-Generation Raptor-Dev-A2L-File-Generation]
[[file:vCANape1.png|400px]]
* From the top level of the model, double click on the '''‘XCP Protocol Definition’''', and check '''‘Generate A2L for CANape’'''.
[[file:vCANape2.png|400px]]
* Once these options are configured, a Vector CANape a2l file will be created automatically during the build process and placed at C:\ECU\a2l. The a2l file contains information about the built application such as details about measurements and adjustments. Using this file, you can connect to the programmed ECU to view live data and make calibration adjustments.
[[file:vCANape3.png|400px]]
* In the image above you will notice that there are 3 extra files created labeled “…_CANAPE”. This is because the model that caused these files to be generated contained parameters with access level 1 and 4. The file for access level 1 ends with ‘_A1’ and contains only those parameters for access level 1. The file for access level 4 ends with ‘_A4’ and contains parameters defined with access level 4 or lower (e.g. all parameters.)


==Initial Setup with Vector CANape 14.0==
==Initial Setup with Vector CANape 16.0==


* Open CANape, then select “<Create new project>”
{| class="wikitable"
* Name the project
|-
* Choose the destination for the project
| scope="col" style="width: 65%;"| Open CANape, then select “<Create new project>”
* Once a project is created right Click on "Devices"
| scope="col" style="width: 50%;" rowspan="6"| [[file:vCANape4.png|600px|frameless|border|vCANape1|center]]
* Click on New Device from > 'Click Database'
|-
* Select the a2l file with “projectName_A4” type from C:\ECU\a2l
| Name the project
[[file:vCANape4.png|400px]]
|-
*Check the "Activate dataset management" true > click "Next"
| Choose the destination for the project
* Select the corresponding CAN channel from the drop down menu under "Channel:"
|-
* Click "Next", no changes needed yet for the Map File Settings, click "Next" again
| Once a project is created right Click on "Devices"
[[file:vCANape5.png|400px]]
|-
* Click on browse, and select the .hex file found C:\ECU\project_name
| Click on New Device from > 'Click Database'
** Note: This files was created during the Raptor build
|-
[[file:vCANape6.png|400px]]
| Select the a2l file with “projectName_A4” type from C:\ECU\a2l
* Once selected, click OK. A window for settings will pop up automatically. Click on “protocol” from the menu on left and click on “Test connection”. This will verify if the project is connected with the ECU in order to run necessary tests.  
|-
** Note: If there is an error, please check if Baud rate is correct.  
| Check the "Activate dataset management" true > click "Next"
[[file:vCANape7.png|400px]]
| rowspan="3" | [[file:vCANape5.png|600px]]
* Press “OK” once communication is established. Now from the explorer on the left, click on the “device name” > Datasets\.. > “project name” > “parameter of interest”. Drag and drop the parameter onto the right.  
|-
[[file:vCANape8.png|400px]]
| Select the corresponding CAN channel from the drop down menu under "Channel:"
* Click on the “Flash” icon highlighted above. It will take CANape online with the ECU connected. The selected parameters will be updated with real-time.
|-
[[file:vCANape9.png|400px]]
| Click "Next", no changes needed yet for the Map File Settings, click "Next" again
|-
| Click on browse, and select the .hex file found C:\ECU\project_name
| rowspan="2" | [[file:vCANape6.png|600px]]
|-
| ''Note: This file was created during the Raptor build''
|-
| Once selected, click OK. A window for settings will pop up automatically. Select “protocol” from the menu on the left and click “Test connection”. This will verify that the project is connected to the ECU in order to run necessary tests.
| rowspan="2" | [[file:vCANape7.png|600px]]
|-
| ''Note: If there is an error, please check if Baud rate is correct.''
|-
| Press “OK” once communication is established. Now from the explorer on the left, click on the “device name” > Datasets\.. > “project name” > “parameter of interest”. Drag and drop the parameter onto the right.
| [[file:vCANape8.png|600px]]
|-
| Click on the start icon highlighted in the step above. It will take CANape online with the connected ECU. The selected parameters will be updated in real-time.
| [[file:vCANape9.png|600px]]
|}


==Merging Offline Calibration Changes==
==Merging Offline Calibration Changes==


* Once you have made offline changes or opened your calibration file, explore in the 'Device_Name > Datasets' directory
{| class="wikitable"
[[file:vCANape10.png|400px]]
|-
* Right click on the dataset of interest, then click "Save dataset as"
| scope="col" style="width: 105%;" colspan="2" | If you have made offline calibration changes, or received a calibration set from a colleague you may want to merge those changes into the executable to create a new programming file for the ECU. This can be accomplished by using Vector CANape and the Raptor-CAL Tool.
* Choose destination and click "Save"
|-
* Open New Eagle's 'Raptor-Cal'
| Once you have made offline changes or opened your calibration file, explore in the ''''Device_Name > Datasets' directory'''.
** See [[Raptor-Cal]] for more information
| scope="col" style="width: 50%;" rowspan="3"|[[file:vCANape10.png|600px]]
* Click 'Program' > 'Create Raptor Package'
|-
[[file:RaptorProgram.png|400px]]
| Right click on the dataset of interest then click '''“Export reference set…”'''
 
|-
* Click on 'Program File (.Hex) and navigate to your new .hex file with offline calibration
| Choose destination and click '''“Save”'''. This will create a hex file with the application and calibration settings (including any changes you made). In order to program this into the ECU, you need to create a RPG file for us with Raptor-Cal.
* Click on “Signals File (.a2l)” and navigate to the corresponding .a2l file under C:\ECU\a2l.
|-
** Click 'start'
| '''"Raptor-Cal Tool"'''.
[[file:RaptorPackager6.png|400px]]
| rowspan="2" | [[file:RaptorProgram.png|600px]]
 
|-
* Save the .rpg file created
| Click on '''"Program" -> "Create Raptor Package"'''
** Close the Raptor Package program
|-
* Navigate to the 'Raptor-Cal' homepage and click 'Flash'
| Click on '''"Program File (.Hex)"''' and navigate to your '''new .hex file''' with offline calibration
[[file:RaptorFlash11.png|400px]]
| rowspan="4" | [[file:RaptorPackager6.png|600px]]
 
|-
* Once the module (ECU) has been detected, click 'Select'
| Click on '''“Signals File (.a2l)”''' and navigate to the corresponding '''.a2l''' file under '''C:\ECU\a2l'''.
* Navigate to C:\ECU\RPG and open the .rpg file saved from using the Raptor Package program
|-
[[file:RaptorECU13.png|400px]]
| Click '''"Start"'''
 
|-
* Once the file is opened, it will automatically flash the ECU with offline calibrated changes
| '''Save''' the '''.rpg''' file that was created and '''close''' the Raptor Package program.
|-
| From the '''"Raptor-Cal Tool"''', click '''"Flash"'''.
| rowspan="2" | [[file:RaptorFlash11.png|600px]]
|-
| Once the module (ECU) has been detected, click '''"Select"'''
|-
| Navigate to '''C:\ECU\RPG''' and open the '''.rpg file''' saved from using the Raptor Package program.
| rowspan="2" | [[file:RaptorECU13.png|600px]]
|-
| Once the file is opened, it will '''automatically flash the ECU''' with offline calibrated changes
|}


===Steps to verify the offline calibration changes===
===Steps to verify the offline calibration changes===


* Go to the 'Vector CANape' program and click the Flash' button to go online
{| class="wikitable"
[[file:vCANape11.png|400px]]
|-
* Click 'GO Online'
| scope="col" style="width: 105%;"| Go to the '''"Vector CANape"''' program and click the '''"Flash" button'''.
* Choose "Upload dad segments and create a new dataset"
| scope="col" style="width: 50%;" rowspan="2"|[[file:vCANape11.png|600px]]
[[file:vCANape12.png|400px]]
|-
* This will allow for the new calibrations flashed on the ECU to be synchronized with dataset that is on the hard drive.
| Click '''"Go Online"'''
* Click 'OK'
|-
[[file:vCANape13.png|400px]]
| Choose '''"Upload data segments and create a new dataset"'''. This will allow for the new calibrations flashed on the ECU to by synchronized with the dataset on the hard drive.
* Click 'OK' again
| rowspan="2" | [[file:vCANape12.png|600px]]
* Now once again click the 'Flash button' to be online
|-
| Click '''"OK"'''
|-
| Click '''"OK"''' again.
| rowspan="2" | [[file:vCANape13.png|600px]]
|-
| Once again click the '''"Flash button"''' to go online.
|}

Latest revision as of 20:24, 11 March 2021


Vector CANape

The following information is also contained in PDF format: Using Vector CANape with Raptor (PDF)

This information is also included in the 'Documentation' folder of the installation directory for Raptor-Dev.

Steps to build A2L files for Vector CANape

Please see the A2L File Generation support page: Raptor-Dev-A2L-File-Generation

Initial Setup with Vector CANape 16.0

Open CANape, then select “<Create new project>”
vCANape1
vCANape1
Name the project
Choose the destination for the project
Once a project is created right Click on "Devices"
Click on New Device from > 'Click Database'
Select the a2l file with “projectName_A4” type from C:\ECU\a2l
Check the "Activate dataset management" true > click "Next"
Select the corresponding CAN channel from the drop down menu under "Channel:"
Click "Next", no changes needed yet for the Map File Settings, click "Next" again
Click on browse, and select the .hex file found C:\ECU\project_name
Note: This file was created during the Raptor build
Once selected, click OK. A window for settings will pop up automatically. Select “protocol” from the menu on the left and click “Test connection”. This will verify that the project is connected to the ECU in order to run necessary tests.
Note: If there is an error, please check if Baud rate is correct.
Press “OK” once communication is established. Now from the explorer on the left, click on the “device name” > Datasets\.. > “project name” > “parameter of interest”. Drag and drop the parameter onto the right.
Click on the start icon highlighted in the step above. It will take CANape online with the connected ECU. The selected parameters will be updated in real-time.

Merging Offline Calibration Changes

If you have made offline calibration changes, or received a calibration set from a colleague you may want to merge those changes into the executable to create a new programming file for the ECU. This can be accomplished by using Vector CANape and the Raptor-CAL Tool.
Once you have made offline changes or opened your calibration file, explore in the 'Device_Name > Datasets' directory.
Right click on the dataset of interest then click “Export reference set…”
Choose destination and click “Save”. This will create a hex file with the application and calibration settings (including any changes you made). In order to program this into the ECU, you need to create a RPG file for us with Raptor-Cal.
"Raptor-Cal Tool".
Click on "Program" -> "Create Raptor Package"
Click on "Program File (.Hex)" and navigate to your new .hex file with offline calibration
Click on “Signals File (.a2l)” and navigate to the corresponding .a2l file under C:\ECU\a2l.
Click "Start"
Save the .rpg file that was created and close the Raptor Package program.
From the "Raptor-Cal Tool", click "Flash".
Once the module (ECU) has been detected, click "Select"
Navigate to C:\ECU\RPG and open the .rpg file saved from using the Raptor Package program.
Once the file is opened, it will automatically flash the ECU with offline calibrated changes

Steps to verify the offline calibration changes

Go to the "Vector CANape" program and click the "Flash" button.
Click "Go Online"
Choose "Upload data segments and create a new dataset". This will allow for the new calibrations flashed on the ECU to by synchronized with the dataset on the hard drive.
Click "OK"
Click "OK" again.
Once again click the "Flash button" to go online.