Raptor-Training

From NewEagleWiki
Jump to navigation Jump to search

New Eagle > Products Wiki > Raptor Platform > Raptor Training

noframe
noframe

Raptor Training, created by our team of experienced controls engineers, provides hands-on experience which enables the new practitioner to gain familiarity with the tool chain by building, deploying, calibrating, and refining a real world control application.

Buy Now

Product Part Number Webstore
Raptor Training - 3-day @ New Eagle RAP-TRAINING-01 Buy Now
Raptor Training - Onsite Training RAP-TRAINING-02 Buy Now

Training Curriculum

The Raptor Training course is designed to give an understanding of the Raptor Platform in an efficient, hands-on manner. We will start off in the MATLAB/Simulink environment, showing concepts of Raptor-Dev's integration and how to use model based design to your advantage. Once the project is built we will flash the compiled code to the module. Using Raptor-Cal, New Eagle's calibration tool, we will calibrate and test the system.

The topics covered in Raptor Training are listed below.

Getting Started
  • Software Installation
  • Licensing

MATLAB/Simulink Introduction
  • MATLAB Console / Workspace
  • Simulink Block Descriptions

Raptor-Dev
  • Project Directory Setup
  • Target Definition Block
  • Trigger Blocks
  • Measurement & Adjustment Blocks
  • I/O Blocks
  • Fault Management Blocks
  • Data Storage Blocks
  • CAN Blocks

Raptor-Cal
  • Flashing a Module
  • Online Displays
  • Calibrations

Raptor Hardware
  • Hardware Description
  • Kit Setup & Testing

Downloads

This section is for all documentation you may need for Raptor Training.

Software Downloads Training Kit Block Diagram Raptor-Cal User Manual Training Evaluation Form

All the latest Raptor software for training can by accessing: software.neweagle.net

Training Prerequisites

The following steps should be completed before the Raptor Training course!

Special topics

If you would like Raptor Training to cover any specific topics, please contact us at least 2 weeks prior to training so we can include additional information and examples.

Software Requirements

Follow the instructions below for necessary software installations. More details can be found in the Raptor Getting Started Guide.

Operating System

Windows 7 or later is required.

MATLAB and Simulink

MATLAB 2015a or later is preferred. The following tools from MathWorks are required:

  • MATLAB
  • Simulink
  • Embedded Coder
  • MATLAB Coder
  • Simulink Coder

If you don't have all these MathWorks products, we can help procure a temporary MathWorks trial license for you. If you would like one, please follow these instructions:

  1. Contact us at least 2 weeks prior to training indicating you would like a MathWorks trial license for training
  2. We will assign a trial license to you, and you will receive an email when it is available for download
  3. Click the link in the email to download the trial (if you don't have a MathWorks account, set one up at this time)
  4. Proceed through the installation

Raptor-Dev and Raptor-Cal

Raptor-Dev and Raptor-Cal can be downloaded from software.neweagle.net. If necessary, first create an account and wait for the confirmation email (requests may take up to 2 business days to fulfill).

Ensure compatibility between Raptor-Dev and MATLAB using the matrix below.

Raptor Compatibility

Once Raptor-Dev and Raptor-Cal are installed, navigate to the New Eagle License Viewer (Start > Programs > New Eagle > New Eagle License Viewer). If necessary, request a trial license by following the instructions below.

  1. Select the settings button
  2. Click 'New License'
  3. Fill out the information, and click submit (requests may take up to a week to fulfill)

Hardware Compiler

The appropriate compiler and associated license will be required.

  • The BCM48, CM0711, CM3626, and CM2115 use the CodeWarrior for MPC55xx/MPC56xx Microcontrollers V2.10 compiler. You can download an evaluation version or purchase the compiler here.
  • The CM3620 uses the IAR Embedded Workbench for ARM 4.42A compiler. To coordinate obtaining an evaluation version of the compiler please contact New Eagle Support.
  • The GCM196 and ECM196 use the Hightec Compiler for the Infineon TriCore architecture v3.4.5.11 compiler. For more information on the GCM196 compiler, and to ensure you get the correct version please contact New Eagle Support.

Kvaser CANKing

Kvaser CANKing is a free, basic CAN bus monitor. To download, go to the Kvaser downloads page at http://www.kvaser.com/support/downloads/. Click on the link to download Kvaser CANKing, and proceed through the installation.

Raptor-Dev Basics

Now that Raptor-Dev is installed and ready for use, we will start off with some basic function of Raptor Dev.

Creating a Project

The MATLAB window will look something like this

Creating a new project is done by navigating to the MATLAB command console and typing:

raptor_create_project('project_name')

Note: Make sure to have your project name in the parentheses and within single quotes.

Click below for more details on starting a Raptor project:


Kit Set Up

A large part of Raptor Training is the hands-on experience, which is delivered using an simulated workbench using a GCM 196.

Below is a diagram of how the training kit should be set up, this covers what should be configured and which pins should be connected.

Select Downloads to view the Training Kit Block Diagram, select More Details to see more information about this controller:

When this is complete, it is time to flash the module for the first time. Steps for this are provided in the next section!

Raptor-Cal Calibration Tool

New Eagle's Raptor-Cal is a powerful calibration tool that can be used to flash, calibrate and monitor modules. Using a simple, user friendly interface Raptor-Cal is the a great tool not only for this course, but for out in the field.

Raptor-Cal's flash module function is extremely useful and necessary during training, since this is how we will get the software created in the Raptor-Dev environment to the module being used. Once you have build your first model and the training kit is set up correctly, it is time to flash.

Below is a simple ECU flashing procedure:

  • Click 'Flash'
  • Select the training module
  • Select the Raptor Package (.rpg) that was created from the most recent build
  • Click 'Connect'

This will now commence the flashing procedure. Click below for more information on how to use Raptor-Cal:

Raptor Blocksets

The Raptor-Dev platform comes with a vast block library, packed and ready for development. Below there are a couple of descriptions for common blocks in the model:

Analog Input

This block reads the value of an analog input. An analog input is typically a voltage input on an input pin to the module. This block outputs the raw analog to digital converter counts. The scaling factor to convert from counts to engineering units may be different for different inputs, sensors or modules. The Full ADC Count indicated on the block represents a guideline for the maximum expected ADC count based on the underlying hardware - values above this threshold may not correspond linearly to those within the range.

PWM Output

This block sets the state of the selected PWM output. PWM (pulse width modulation) is typically used similar to an analog output.



Click below for more details on all other Raptor blocks:

Addition Raptor Features

The Raptor-Dev platform contains many different blocks with a variety of functions, below are some common blocks used with the Raptor Training course.

Override

The Raptor override block is used to be able to override the value on a wire from the calibration tool. The block will normally pass the value at the input port to the output port. However when the override state is set to Override the block will output the value input from the calibration tool.

Measurement

The Raptor™ measurement block is used to make values available within the calibration tool. A measurement is a value which typically read only within the calibration tool.

Adjustment

The Raptor™ adjustment block is used to make values available within the calibration tool. An adjustment is a value which typically written from the calibration tool.

Fault Management

The blocks in this subsystem are used to define, configure, and access application faults.

Data Storage

The blocks in this subsystem are used to define, configure, and access application data.