How-tos

impulse How-To
H001 Beginners - How to open the viewer

There are multiple ways to view signal data with impulse. You might :

  • Use eclipse file resources :
    1. If no project exists existing, create a new project of any type (File->New->Project->??? );
    2. Import your record files (wave files, logs, traces,..) or drag and drop them into the project;
    3. Double-click the record file to open (or use the context menu of the file).
  • Use the File->Open File ... menu:
    1. Open the menu File->Open File ... ;
    2. Select the file to open;
    3. Press OK.
H002 Beginners - How to import example wave files

impulse come with a set a example wave files.

  1. If no project exists existing, create a new project of any type (File->New->Project->??? );
  2. Open the "Import..." menu (from "File"" menu or from the navigator context menu)
  3. Select "impulse";
  4. Select "Import example wave files";
  5. Select a project/folder as target.
H003 Beginners - How to save my changes

After receviing new signal data from a port or adding annotations, you may want to save your signal data changes.

  1. Open the "File" menu  and select "Save As..".
  2. Enter name, target folder and the file format.
  3. Press "OK"
H004 Beginners - How to install tutorial examples

All tutorials come with a preference wallet that contains preferences and resources (e.g. recording files).

  1. Press "Download Tutorial Examples" on the tutorial page; this downloads the  file "Uxxx.walMZ". Copy the file into any eclipse project.
  2. Double-click the file to open the Preference Wallet editor
  3. Press the "Install" button
    • A folder (named "Uxxx Resources") containing the tutorial content (record files, launcher,..) will be created.
    • All preference elements (views, serializer configurations, ports,..)  from the tutorial will be added.
  4. After using the tutorial content, you might press the "Un-install" button to remove content and preferences.
H100 Attach - How to read my record file (wave file, log, trace,..)
  • impulse supports a lot of different file formats. To get an overview of your installed readers, open the Preferences view and navigate to impulse->Serializers.
  • To open a Workspace resource, double-click the record file (or use the context menu of the file).
  • Some readers require a configuration (e.g. CSV, PatternLog,..).
  • To add a configuration,
    1. Open the Preferences view and navigate to impulse->Serializers (or use the "Reload" button menu);
    2. Double-click the reader to open the readers preferences page;
    3. Press the "Add" button to add and configure the configuration.
  • To re-load a file with a different configuration,
    1. Enter the "Reload" button menu in the viewers toolbar;
    2. Select the configuration to re-load the file.
H101 Attach - What to do if my file type is not supported
  • If your file is not loaded (not identified as an impulse record file), first check our website if you need to install another extension (Products) to get the file supported.
  • If the file type is supported but not identified, please check if your file has the correct extension. See H102 to change the file extension.
  • If the file type is not supported, there are 4 options:
    1. If your file is a text log file with multiple text pattern, try the Pattern Log Reader (defines the content, using regular expressions).
    2. You can implement a reader in Java language (check the extension documentation) 
    3. Contact us to get a reader implemented.
    4. In case of reading signal data from a signal port (e.g. TCP, Memory, Serial Interface,..), you can use the Scripted Reader.
H102 Attach - How to change the file extension for a supported record type

impulse identifies a resource file by its extension and its content data. To change the file extension for a support record type:

  1. Open the Preferences view and enter General->Content Types;
  2. Open Element->Record and select the impulse content type (e.g. VCD Record)
  3. Press "Add" beside the field "File Associations";
  4. Enter the extension and press "OK".
H103 Attach - How to reload my file
To re-load a file:
  1. Click the "Reload" button in the viewers toolbar;
To re-load a file with a different configuration,
  1. Enter the "Reload" button menu in the viewers toolbar;
  2. Select the configuration to re-load the file.
H110 Attach - How to read a CSV file

impulse can read CSV files (Log&Trace extension). To parse your files correctly, you need to select/define a CSV configuration.

  1. If you open a CSV file, impulse will pop up a dialogue to select/manage configurations. Click on "Open Preferences" to manage configurations.
  2. Click "Add" to add a new CSV configuration.
  3. Edit your configuration (name, delimiter, column types, time unit) and press OK.
  4. Use this configuration in the "Select Serializer Configuration" dialogue, the "Re-load" toolbar menu or a port configuration.
H130 Attach - How to add a port

A Signals Port can be opened by the impulse Viewer like a normal file. Instead of extracting the signal data from the file, it is read from an external source (e.g. TCP, a debug adapter or a bus interface).

  1. To add a port you need to have the Signals Ports view visible (Window > Show View > impulse > Signal Ports).;
  2. Click the "Add new Port" toolbar button of the "Signal Ports" view and select the port type. ;
  3. Configure the port settings and press ok.
H131 Attach - How to configure existing ports

Ports can be managed most easily with the "Signal Ports" view: (Window > Show View > impulse > Signal Ports). Alternatively you can also use the preferences (Preferences ->impulse > Ports).

  • Press the "Edit Port" button of the "Signal Ports" view or use the context menu of the port/adapter element.
  • If you have already opened the port in a viewer, press the "Edit Port" button in the viewers toolbar.
H132 Attach - How to open and start a port

The port may read the signal data in one go or spread over a period of time (on-line). impulse allows the analysis of signal data while new data is still arriving.

  • To open a port you need to have the Signals Ports view visible (Window > Show View > impulse > Signal Ports).
  • Opening a port means opening the viewer with the signal content of the port. Press the "Open Port" button of the "Signal Ports" view or double-click the port item.
  • To start the port, press the "Run/Stop" in the tool-bar.
H400 Annotation - How to add a bookmark

The marker concept is a known feature of eclipse. impulse allows users to add markers (bookmarks, tasks and annotation) to any signal at any domain position.

  1. Use a cursor to select a plot at a given position;
  2. Select "Insert->Bookmark" in the context menu of the plot;
  3. Configure the bookmark;
  4. Press OK.
H200 View - How to create a new view

A view combines a set of plots organized in rows. You may switch between multiple views using the the combo box in the top right corner.

  1. Use the "Add new view" toolbar button.
  2. Select if the new view shall be empty or populated.
  3. Press ok to create the view.
  4. Use the signal area to drag&drop signal into the new view.
H201 View - How to switch between views

You can use an unlimited number of views for a record file. The upper-right button in the toolbar is used to switch between multiple views.

  1. Use the combo box in the right top corner to switch between views.
  2. You may select the "Filter" fields to limit the views in the combo box to those that 'fit' to your signals.
  3. Use the preferences page "impulse/views" to manage your views.
H202 View - How to add signals to a view

The signal area is used to find signals in the record (wave, trace, log,..) file and convert them into a plot that can be shown in the Plot Area.

  1. Use the signal area to drag&drop signals or scopes into the view.
  2. You may use the filter to find your signals.
  3. Or you may select the context menu of the view tree to add a new plots.
H203 View - How to resize a plot

  1. When you select a plot in the view, there will be a small resize grip left-hand of the name.
  2. Select the grip and move the cursor to resize.
  3. Release the grip to keep the size.
H204 View - How to re-organize views

Inside of a view you find Plots to display the signal data and Folders to organize the presentation in a hierarchical structure. This enables the user to hide/show parts of the presentation.

  • You can add single elements (folders, plots of multiple types) to the hierarchical structure by opening the context menu of the configuration with a right mouse click.
  • You can reorder all elements by selecting and moving them with the mouse.
  • To remove elements you open the context menu, click delete or mark the elements that you want to remove and press the delete key.
  • You can edit an existing plot (or multiple plots) by opening the edit dialogue with the context menu or by double-clicking the element whose configuration you want to change.
H210 View - How to add a cursor

Initially, one cursor is part of a new view.

  • To add more, press the "Add new Cursor" button in the toolbar or use the context menu of the Axis or Cursor Details.
  • Change color and/or name in the opened dialogue.
  • To get rid of a cursor, use the context menu of the cursor (right click on the grip), or the context menu of the axis to delete all cursors.
H211 View - How to switch between cursors

If you have more than one cursor, you may need to switch between them. You can activate a cursor or simply make the cursor visible (by changing the axis position).

  • In the context menu of a cursor, you find the commands:Activate previous/next/Cursor 0--3 to activate another cursor and make it visible (go to its location)
  • and Show active/Cursor 0--3 to only make a cursor visible (go to its location).
  • Single-click the cursors in Cursor Details to activate the cursor;
  • Double-click the cursors in Cursor Details to aktivate and make the cursor visible (go to its location).
  • It is even easier to use the keyboard shortcuts (see 18 Keyboard Shortcuts).
H212 View - How to move in time (or other domain)

You can move the the axis and cursor by:

  • Use the horizontal scrollbar.
  • Left click on the axis and move.
  • Use the mouse wheel plus the SHIFT key.
  • Left click on the wave area and move (this moves the active cursor).
H213 View - How to make a domain range visible

You can make a given range in time (or frequency,..) visible by:

  • To zoom in/out relative to the active cursor, use the buttons in the toolbar or use the keyboard (+,-).
  • To zoom in/out relative to the mouse, use the mouse wheel plus the CONTROL key.
  • To zoom fit, use the Zoom fit command in the toolbar.
  • Left click on the wave area (with the CONTROL key) and select the area that you want to zoom in or out. Release the mouse to zoom in/out.
H220 View - How to show signals on different axes

If you have signals from the same domain but, nevertheless, want to show them on a different axis (e.g., to see the total and a snippet, side by side), then you have to create a new folder for the chosen signals.

  • To create a folder, you right click the view, choose "Add" and then "Folder";
  • In the dialogue that now opens, you click "Dedicated Axis";
  • Add signals by dragging and dropping them to the new folder.
H221 View - How to switch to log10 axis

There are two types of axis. One is the linear, which is the normal case and the other is log10. When you choose log10, the value appears in the same intervals but increases tenfold.

  • To change the axis type of all domain axes, double-click the view (the view dialogue opens) and select log10.
  • To change the axis type of some domain axes, double-click the folder (the folder dialogue opens) and select log10.
  • To change the axis type of a value axis, double-click the plot (the plot dialogue opens) and select log10.
H222 View - How to change the value axis

Some diagram types can show a value axis (line and area diagram).To change the value axis of a plot:

  • double-click the plot (the plot dialogue opens). You may enable/disable the axis, set a value range or change the axis type .
  • use the context menu of the plot. You may set an automatic or predefined range.
H240 View - How to create a new chart

Charts can be used to visualize signals and signal-related information. Charts can be extended and configured in many ways. You can define your own charts or integrate existing chart tools. To add a new chart:

  1. Enter the chart preference page (Preferences > impulse > chart);
  2. Pess the 'Add' button and select a chart type;
  3. Configure the visualisation options and the standard plot parameters;
  4. Press ok.
H241 View - How to show a chart plot

To visualize a signal with impulse, users usually define a plot with a source signal and a diagram type (e.g. a line diagram) and some additional parameters (e.g. the 'annotate' flag). If you select "Chart" as diagram type, you will need to state which chart to use.

  1. Create a plot in one of you views and select the Chart type;
  2. Select a compatible signal or production;
  3. Select one of the configured charts from the chart combo box;
  4. Enter values for the chart specific parameters;
  5. Press ok.
H242 View - How to configure a chart

The chart preferences page shows all defined charts. Each chart is based on a specific type (chart provider). You can add multiple charts of the same type, but with different presentation options.In the plot, the chart is assigned the signal data. In addition, chart specific plot parameters can be adjusted.

  1. Enter the chart preference page (Preferences > impulse > chart) to configure the chart;
  2. Enter the Plot dialogue to assign the signal data and additional settings under "Chart style".
H243 View - How to re-fresh a chart
To refresh a chart you may:
  1. Re-load the input resource.
  2. Enter the main menu and select "Re-fresh".

Manuals

impulse Manual

01 The impulse viewer at a glance

impulse is a powerful visualization and analysis workbench which helps engineers to comfortably understand and debug complex semiconductor and multi-core software systems.

02 Reading Records

In the simplest case, the signals to be analysed are read from a log, wave or trace file. Instead of creating a file, signal ports can read the data directly from streams such as TCP, pipes, applications, interfaces or debug adapters...

03 Views and Plots

Every development is different, and every developer works differently. With impulse, users can define their views exactly the way they need them. Simple and powerful user interfaces allow you to focus on signal data instead of the tool...

04 Plots and Cursors

The plot area contains three elements: an axis, the configured plots and cursors. Cursors are part of a view, like plots and folders, but they are not visible in the view configuration hierarchy. So, if you change the view, you also change to a different set of cursors...

05 Domains and Axes

impulse can display waveforms using multiple domains (e.g., time and frequency) in one view. If your signals are using the same domain, it allows you to display them on multiple axes...

06 Signal Ports

Instead of creating a file, signal ports can read the data directly from streams such as TCP, pipes, applications, interfaces or debug adapters. If more than one signal source is present (e.g., log data from a serial interface and trace over TCP), these signals can be merged and synchronized...

07 Complementary Views

In addition to the viewer and editor, there is a set of additional tabular presentation UIs in impulse. These complementary views allow to output the signal content using different forms. Custom complementary views can be implemented using open Interfaces...

08 Marker

The eclipse platform supports different markers such as bookmarks, tasks, problems and errors. Based on these mechanisms, impulse allows the user to add annotations, bookmarks and tasks to any signal at a given position...

09 Preferences

impulse’s preferences are stored within the eclipse preference store. If you open the preferences dialogue, you can manage all the relevant settings. There are preferences pages for views, serializers, ports, templates, .... Settings can be easily imported or exported using the Wallet Editor...

10 Signal Script

Scripts allow the user to customize impulses in many ways. These include, among others, the evaluation of signals, the parsing of signal sources, the search for signal positions and the definition or extension of charts.

11 Synchronisation

impulse can handle signal data from multiple inputs. When inputs don't have a common domain base, synchronization may be required.

12 Searching

The Find dialogue helps you to find signal patterns. It behaves like the standard find dialogue of the text editors. You type in a find expression, select if you want to search forwards or reverse, with or without wrapping and then click find...

13 Working with Charts

Charts can be used to visualize signals and signal-related information. Charts can be extended and configured in many ways. You can define your own charts or integrate existing chart tools...

14 Templates

Templates simplify the re-use of configuration elements. A template may contain simple defaults, such that all float signals shall be painted red, but they can also contain a rich set of elements containing multiple scripts and folders...

15 Comparing signals and records

You may be required to compare a single or multiple signals or complete records (wave files). Both can be done easily without any additional tools...

16 Launcher Integration

An eclipse launch configuration is a description of how to launch a program. The program itself may be a Java program, another Eclipse instance in the form of a runtime workbench, a C program, or something else...

17 Native Extensions

Native extension are application and libraries natively compiled for your platform. This article explains how to manage, configure and build those extensions.

18 Keyboard Shortcuts

19 Signal Content

This chapter describes some basic principles of how signals are represented in impulse. These are not necessary for the use of impulse, but convey a better understanding....
flux Manual

F001 FluxConcept

flux trace format is an open waveform/trace format targeting semiconductor and multi-core embedded system use-cases. The trace data is packed into a binary format and allows scalable compression...

F002 Hello flux

The first example creates the simple uncompressed trace with an integer and a float signal and writes it into a file. The example will show you the basic steps to create a trace...

F003 To be handled ...

Buffers may have handlers. In the first examples, we are using the flxWriteToFile handler (c language) and the SimpleFileOutputBuffer class (Object oriented languages)...

F004 Scopes and numerical data

A Scope is an organisational element (like a folder, module, subsystem, processes,..) to group signals...

F005 Text, enums and binary data

While the handling of text (flux uses UTF-8) and binary data is simple, the handling of enumeration data additionally requires to send the text representation...

F006 Structured data

Signals of type structure can transport a set of values (members) with each change. This member set may vary from sample to sample...

F007 Arrays

Array are similar to structures with the difference that all members have the same type. Supported types are integer, float, text (no c-language support) and event...

F008 Logic data

You can use the flxAddSignal/addSignal methods together with the TYPE_LOGIC signal type and a signal descriptor defining the no of bits (e.g. "default"). If the no of bits is not defined, 1 bit is assumed...

F009 Relations and labels

Relations and labels allow you to highlight relations between trace signals or add additional information to samples. Below example defines a set of event signals using enumeration values...

Reference

impulse Core Elements
impulse Log/Trace Extension
impulse Embedded Extension
impulse CANBus extension
impulse VP Extension
impulse HDL Extension
impulse SPICE Extension
impulse BIRT Extension
impulse NEBULA Extension
impulse OPC/UA Extension
impulse YAKINDU Extension
impulse SCOPE Extension

.

toem

technical software and tooling

Company

Contact Us

This email address is being protected from spambots. You need JavaScript enabled to view it.