User Guide.md

Overview

The Engine Simulation Toolkit custom device provides a configuration-based experience for validating engine control units (ECUs) in VeriStand. The custom device can be combined with an engine physics model to create a complete ECU hardware-in-the-loop system.

Usage

The Engine Simulation Toolkit custom device requires a bitfile that includes the Engine Simulation Toolkit FPGA IP. Measurement and generation options are conifgurable from the custom device once the bitfile has been loaded.

The Engine Simulation Toolkit FPGA IP library includes examples for creating bitfiles. These examples can be used as starting points for building custom bitfiles.

The FPGA bitfile is responsible for generating sensor simulations and responding to events provided by the ECU. These generations and event measurements are all based on the Angle Processing Unit (APU).

Configuration

Components contained in the bitfile are added to the system definition by clicking the section in the System Explorer tree, selecting the name of the item and clicking the Add button. A new section and corresponding channels are added to the system definition.

An example of an added Analog Replay component configuration is shown below.

Custom Device Components

There are several possible components that can be configured for the Engine Simulation Toolkit. Depending on the items included in the bitfile, the following features are available for configuration.

Component	Features
Angle Processing Unit	Simulates rotational position and speed Optional simulated acceleration Forward and reverse rotation Configurable cycle length up to 1440 degrees
Analog Replay	Typical crank and cam variable reluctance sensor simulation Replays any data file over a crank or cycle rotation Scale voltage by engine speed or manually Rotationally phase playback position at run time
Digital Pattern Generation	Typical crank and cam Hall effect sensor simulation Generates arbitrary digital pulses based on engine position Intuitive, powerful GUI for pattern design Rotationally phase playback position at run time Fault playback at run time by removing or adding teeth
Directional Speed Sensor Simulation	Enables ECUs to track engine position during start/stop Timed pulses generated at tooth centers with configurable forward and reverse widths
Knock Sensor Simulation	Generates base- and high-frequency analog signals Base frequency optionally scaled from engine speed Pseudorandom probability Arbitrary number of cylinders Fully configurable frequencies and amplitudes
ECU Event Timing Capture	Validate ECU injection and ignition events Start and end position plus duration measurement Position measurement correction by reference angle Window expected events by engine position Event error detection (stuck on, orphan edges, all active window) Arbitrary number of events per cycle per window Active high or low

Detailed Specifications

The following table lists the specifications for each of the components in the Engine Simulation Toolkit.

Component	Specification
Angle Processing Unit	0.0055 degree crank resolution 0.011 degree cycle resolution ± 72,342 rpm 0.0175 rpm/sec maximum acceleration 5.33 rpm/sec acceleration resolution 25 ns update rate
Analog Replay	65,536 data points per cycle maximum Resamples data file to memory size
Digital Pattern Generation	1,024 pulses per cycle maximum
Directional Speed Sensor Simulation	1,024 pulses per cycle maximum
Knock Sensor Simulation	0.0015% probability resolution Output frequencies limited only by AO speed
ECU Event Timing Capture	0.8 µs duration resolution 209.7 ms event duration maximum Number of pulses per cycle per window limited only by FPGA space

References

Engine Simulation Toolkit FPGA IP

Using Simulation Models With VeriStand

Legacy Release Notes

Legacy Support Forum