Raptor-Training: Difference between revisions

From NewEagleWiki
Jump to navigation Jump to search
No edit summary
Line 88: Line 88:
The following steps should be completed '''before''' the Raptor Training course!
The following steps should be completed '''before''' the Raptor Training course!


'''''Special topics''''': If you or your company would like to cover some specific topics in Raptor Training, please '''[https://www.neweagle.net/contact/ contact us]''' prior to your training so we can include additional information and examples.
===Special topics===  
 
If you would like Raptor Training to cover any specific topics, please '''[https://www.neweagle.net/contact/ contact us]''' at least 2 weeks prior to training so we can include additional information and examples.


===Software Requirements===
===Software Requirements===
Below is a short software checklist for Raptor Training:


* Windows 7
====Operating System====
* MATLAB and Simulink
Windows is required.
* Raptor-Dev
 
* Raptor-Cal
====MATLAB and Simulink====
* Compiler
MATLAB 2015a or later is preferred.
 
The following tools from Mathworks are required:
* MATLAB
* Simulink
* Embedded Coder
* MATLAB Coder
* Simulink Coder
 
If a temporary Mathworks trial license is required, please '''[https://www.neweagle.net/contact/ contact us]''' at least 2 weeks prior to training.
 
====Raptor-Dev and Raptor-Cal====
Raptor-Dev and Raptor-Cal can be downloaded from '''[http://software.neweagle.net software.neweagle.net]'''. If necessary, first create an account and wait for the confirmation email (requests may to up to 2 business days to fulfill).
 
Ensure compatibility between Raptor-Dev and MATLAB using the matrix below.
 
[[File:Raptor Compatibility Matrix.PNG|Raptor Compatibility]]


'''''Please note:''' If a Mathworks demo is required, please contact New Eagle Support prior to training
====Hardware Compiler====


For a full list on how to get started use the '''Click Below''':


[[File:click_here.png|100px |link=Raptor:Getting_Started]] [[File:downloads.png|100px |link=Raptor-Training#Downloads]]


===Software Downloads===
===Software Downloads===

Revision as of 17:28, 10 August 2016

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

Operating System

Windows 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 a temporary Mathworks trial license is required, please contact us at least 2 weeks prior to training.

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 to up to 2 business days to fulfill).

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

Raptor Compatibility

Hardware Compiler

Software Downloads

To download the Raptor suite you must create an account at software.neweagle.net

To create an account simply follow these steps:

  • Signup for a new account
  • Enter a valid email
  • Create a username
  • Fill in the security code
  • Click sign up

After this process you must wait for a confirmation email. Note: Requests may to up to 48 hours to fulfill. Not processed on weekends.

Licensing

Once Raptor is installed you will need to navigate to the New Eagle License Viewer.

By default located here:

C:\Program Files (x86)\NewEagle\Raptor\YOUR_RAPTOR_VERSION

Below are the basic steps on how to request a new license:

  • Select the settings button
  • Click 'New License'
  • Fill out the information, and click submit

For more information on how use the License Viewer Click Below:

Raptor Version

The final step of setting up the Raptor-Dev envirment is linking it to MATLAB. This is easily done by opening the Raptor Configuration Editor.

By Default located here:

C:\Program Files (x86)\NewEagle\Raptor\

This is also detailed in the getting started section, click below to view this section:

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 GCM 196 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.