Raptor:Getting Started

New Eagle > Products Wiki > Raptor Platform > Raptor-Dev > Getting Started with Raptor-Dev

Getting Started

Installation

New Eagle License Viewer

Raptor Configuration Editor

Prerequisites

• MATLAB/Simulink
  • Raptor™ requires a compatible installation of MATLAB/Simulink in order to create models for code generation. MATLAB/Simulink release 2012a 32/64 bit and newer are supported. The following tools from Mathworks are required:
    • MATLAB
    • Simulink
    • Embedded Coder
    • MATLAB Coder
    • Simulink Coder
    • Stateflow (Optional)

• Compiler
  • To compile the generated code properly for your embedded platform, the appropriate compile and associated license will be required. For instance, Raptor targets with a Freescale 55xx Microprocessor will require the CodeWarrior 55xx compiler.
• .NET Framework
  • Raptor requires the .NET framework from Microsoft that comes preinstalled on most current version of the Windows platform. If this is not installed prior to running the Raptor installation program, it will be downloaded (internet access required) during the installation process.
  • If necessary, the .NET framework can be downloaded manually at: www.microsoft.com

MATLAB Version support

Raptor currently requires Windows 7 (32 or 64 bit versions) and MATLAB 2012a+

Installation

1. Download and run the latest Raptor installer program
   1. Follow the instructions and change the options to your liking
2. When the installer finishes, run the 'Raptor Configuration Editor'
   1. This shows which versions of MATLAB and Raptor are compatible
   2. Set the configuration settings for your version of MATLAB
3. Verify your Raptor License
   1. Open the Start menu and go to "New Eagle -> New Eagle License Viewer"
   2. From the MATLAB command prompt, type >>raptor_check_license
4. Verify MATLAB/Simulink Integration
   1. When Raptor has been properly integrated, you will see the following message upon starting MATLAB:

Software/Code-Generation

Creating a Sample Raptor Project

The easiest way to create a new Raptor project is to use the 'raptor_create_project' script from the command prompt. This script will create a new project with the appropriate code-generation settings for Raptor. The new project will have a few useful folders where you may want to store project files in the future (CAN, Images, Libraries). These folders are automatically added/removed from the path when the model is opened/closed via the model_open/model_close scripts that are generated alongside the model (mdl) file.

• Open MATLAB and in the command prompt type >> raptor_create_project
  • This will create a new project with the appropriate settings for Raptor

• Select the proper target with the ECU definition block
• Build the project by pressing 'CTRL + B' or select 'Tools->Code Generation->Build Model'
  • If successful, a message indicating so will appear in the command window
  • The output files will be created and placed (by default) in C:\ECU

• Add an XCP block to allow communication with ECU using a calibration tool

• Build a second time and note that an A2L file is generated
  • If ATI Vision is installed, a Vision Strategy File will be generated
• Open the proper tool to load software on to the module and load the new VSF file
  • For the CM2115 and CM3626, use the Vansco Flashloader, found in the Raptor installation directory

Programming Setup for Raptor Modules

Basic Programming Procedure

1. Install Raptor-Cal

During the Raptor-Cal installation, an ECU folder is created on the C: drive of the computer, with the following folders:

• RPG for Raptor Package (.rpg) files
• RDIS for display (.rdis) files
• RCAL for calibration (.rcal) files

Please read the Raptor-Cal/Raptor-Service User Guide for detailed instructions on downloading and installing Raptor-Cal.

2. SmartCraft Hub Setup

Connect the following components to the SmartCraft hub

• Battery/power supply (+12V or +24V)
• Key switch
• CAN termination resistor (120 ohms) on CAN1
• Kvaser USB-to-CAN device (connect to the laptop/PC) to CAN1
• ECU harness

Ensure that your setup includes the following:

• Make sure that battery power goes across pins A (+) and B (-)
• Check for continuity between pins A and F with key switch turned ON
• Check resistance across pins J and K (should be 120 Ohms if termination is connected)
• Ensure that the ECU harness has pins A, B, F, J, and K populated to account for power, ground, key switch, and CAN1.

3. Raptor-Cal Programming Procedure

You will need to have a program file compiled to program. This is the .rpg file that is generated after a successful build. The file is located in the RPG folder.

• Open Raptor-Cal

• Make sure that the port setting is set to the correct baud rate and XCP settings that was last flashed/programmed onto the module. Please note that the port should be set to XCP Access Level = 4, XCP Broadcast ID (hex) = 100, and 250kbaud for a module brand new out of the package. To check the port settings in Raptor-Cal, go to Edit -> Settings.

• If all of the settings and setup are correct, turn on the ECU and click "Reprogram over CAN"
• Select your module, then select the program you wish to flash onto the module

• Raptor-Cal will begin reprogramming the module