Copyright: 5.0


DIANA 5 Help

Recorder

Background

Trigger

Recording Details

Analyser

Background

Chart Wizard

Workspace

Smoothing Filter

Table Filter

BASPviewer

TED

Background

CAN Automation Editor

CAN Message Properties

CAN Transmit Message List

TestScript Editor

Test Center

Background

Program properties

Common

Directories

Record

PLC

Panel

Analyser

Signal properties

Global Signal Properties

Signal Format Properties

Data Selection

CAN Signal Properties

CAN MPM Signal Properties

ECU Variable Signal Properties

A/D Signal Properties

Signal Converter Properties

CAN-Control Signal Properties

Signal Analyser Properties

Alias Signal Properties

Meta Signal Properties

PLC Signal Properties

Tools

VarSpy

Explorer

 Copyright 1994-2008 Voith Turbo GmbH & Co. KG. Idea and development by Thomas Schoenhaar, G.Graf.


VarSpy

The VarSpy is a tool, allowing you to watch and edit variables of the ECU connected. A special variable file (*.d5v) is needed. This file must fit the transmission type and software version of the ECU.

Tree view

Here you can browse variables and structures. The selected variable or structure will be displayed in the list view. With the right mouse button, you can call a context menu. This menu contains functions for editing the variable list. The Sort by name function will sort the tree alphabetically.

With the Favorite function you can add a variable to your favorites list. When you activate the Show Favorites function, you will only see your favorites. The favorites list can be saved in the variable file.

With the function Search Variable you can search the tree view for variables. If you select Match Exact, the search string must be equal to the variable name.

List view

This view shows details about the variable or structure, which is selected in the tree view. If the function Request Data from ECU is activated, the current values of the variables are requested from the connected ECU and displayed in this view.

Use the Return key or double click a variable to change its value.

If the function Show Sub-Structures ist enabled, VarSpy will also display structures, which are included in the selected structure.

When the Create log file function is activated, the displayed data will be written to an ASCII file.

Scope View

The scope view visualizes up to 2 variables of the list view. You will also get some statistic information about these variables. The function will only work, if the Cyclic Request is activated. Use the Assign to Scope function to assign a variable to a scope. These assignments are deleted, when the list view is changed.

Extras

ECU Viewer

You will see the identification data of the connected ECU.

Read/Write/Fill

This functions can be used to read, write or reset a memory range in the connected ECU.

ECU Software Update

This function will start D5MemTool to load a new software to the current ECU.

Read Dataset from ECU

If you have connected an E200, you can download the dataset of the current ECU as a .cod and .txt file. The .txt file will be opened with the default text viewer of the DIANA5 setup.

Compare Dataset with ECU

If you have connected an E200, you can compare the dataset of the current ECU with an existing .cod file. The difference will be written to a .txt file and opened with the default text viewer of the DIANA5 setup.


Common properties

User name

Enter your user name here.

User email address

Enter your email address.

Registration key

You will get your registration key via email, when you press the Request button.

Send measurement to

This is the default email address, to where you can to send your measurements.

Prefered Language

Choose your own language here.

Play Sounds

You can let DIANA5 play special sound effects.

Play Music

On loading software to an ECU you can let DIANA5 play background music.

Selecting your own wave files

If you wish to use your own sounds, you can replace the wave files “loop.wav”, “failed.wav” and “success.wav” in the DIANA program directory.


Directories

Recordings

This is your default recording directory for saving new measurements.

Templates

This is your default template directory, where your own templates will be stored.

VarFiles

VarSpy will automatically search in this directory for the suitable VarFile.

Temporary Files

All report files, which are created by DIANA, will be stored in this directory.

Dataset

Points to the directory, where the dataset files are stored.

Fault memory help

Points to the directory, where the HTML help files for the E300 event memory are stored.

Dataset help

Points to the directory, where the E300 dataset HTML help files are stored.

Lock

When you save a recording to different recording directory, the new file path will be saved as the new recording directory. This can be avoided with this function.


Recording properties

ECU COM port

This is the COM port, where you have connected the ECU (transmission control unit). You can also choose a direct network connection or the Samtec USB-Interface HSLITE.

ECU Baudrate (KWP)

This is the communication baudrate for ECU’s which are using the Keyword Protocol KWP-2000.

GPS Receiver

This is the COM port is for receiving GPS data.

GPS Playback

This COM port is for playing back recorded GPS data.

MIDI controller device

You can select a MIDI input device to which you have connected a MIDI Controller Device. The controllers can be used to change the value of assigned signal.

Activate DIANA5 server

A client computer can connect to this computer and record data via network.

Ask for Recording Details

When starting a new record, DIANA will first open the Recording Details Window.

Calibrate A/D on Startup

If activated, National Instruments A/D Boards will be automatically calibrated on startup.

Auto Record

The recording will be started immediately, when a template is loaded.

IRMA COM port

This is the COM port, where the passenger counting system IRMA is connected. IRMA must be set to 9600 Baud.

Use VOITH K-Line-USB-Interface

If you want to communicate with the ECU E300 by the Voith USB-K-Line-Interface, you have to choose this option.

Minimize ECU data download

You can improve the startup time for recording by checking this item. In this case, extended ECU data (RIO, PDI, dataset) will not be requested and stored in your measurement file. If you are in doubt, leave this item unchecked.


PLC properties

Local IP address

Enter the IP address of the local network adapter, which is connected to the PLC.

PLC IP address

Enter the IP address of the PLC, you want to access.

Protocol

Choose between the Modbus/TCP or ADS/AMS TCP protocol to access the PLC. If you have installed the Berkhoff TwinCat software, you can also use ADS-DLL.

ADS Server Port

If you are using ADS-DLL, you have to select the ADS port number.


Panel properties

Background

Sets the background color or bitmap of the panel.

Alignment

Select an alignment for placing the selected bitmap on the panel.

Bitmap

You can choose your own bitmap for the background of the panels. “User Bitmap” must be selected as Background.

VI Title Size

You can change the size in pixels of the VI’s title name.

Title Color

The text color of the instrument title.

Title Back

The background color of the instrument title.

Value Color

The text color of the instrument measurement value.

Value Back Color

The background color of the measurement value.

Frame Color

The frame color of the instrument.

Reset

If you press this buttons, all panel settings will be changed to the standard settings.


Analyser properties
Analyzer properties

Editor

Some information of DIANA5 will be displayed with the selected editor.

Color brightness

With this setting you can change the brightness of the line colors in the graphic view. When printing bright colors on a white paper or making a beamer presentation, it is better to reduce the color brightness. 100 % is the default value. Bigger values increase the brightness.

Column Size

If table columns are generally too small and get truncated, this value helps you to increase the size of all columns in percent. This value is also used for VarSpy. 100 % is the default value. Bigger values increase the column size.

Line Width

You can change the overall line width of the signal lines in the graphic view. This can improve the quality of your print out or beamer presentation. Default value is 1 pixel.

Print extended information

Measurement data of the current cursor position will be printed below the graphic.

Keep initial file date

If this is checked and you save a measurement file, the file modification date will be set to the date, when the file was recorded.

White background

The graphic of the analyzer will be displayed with a white instead of a black background. This is useful, when copying the DIANA5 Analyzer window to the Windows clipboard.

Display Clock Time

If you want to see the clock time of the recorded data, you can use this function. Interrupted recordings may lead to invalid results.

Draw all dots in graphic

If measurement dots are displayed in the graphics, you can choose between showing each measurement point with a dot or automatically reducing the amount of dots.

Export Time in Seconds

Normally, DIANA exports the measurement times in hours:minutes:seconds.milliseconds. If you activate this option, DIANA will export seconds instead.

Reduce Y-Axis for printing

All Y-Axis with the same scaling and unit will be reduced to only one y-axis while printing.

Event Memory HTML Help

This function enables the VOITH Aladin HTML help pages for the E300 event memory. Before you can use this function, you have to select the directory of the HTML files on your hard disk.

Use alternate GPS format

If activated, GPS position are displayed as degrees, otherwise you get degrees, minutes and seconds.


Recording Details

ECU

If the recording was made with an ECU, you will see the ECU identification data here. With the DIANA5 File Explorer you can search for these items.

User

Here you can input additional recording information. Double click or use the space bar to change the data. With the DIANA5 File Explorer you can search for these items.

Comment

This input field is for your own comments.

Fault Memory

If there are any entries fault memory, this page will contain the error code. Active means, that the fault is currently detected. You can also erase the fault memory.

Adaptation

If adaptation data is available, it will be displayed here. You can also reset the adaptation.

Slip Memory

Contains information about the maximum detected slip in the gears.

Report

If you select this function, DIANA will create a report file about the measurement and open it with the selected editor.


Global Signal Properties

Name, shortcut, unit

This is the name and the unit of the signal. If you select a predefined name from the list, all three items are automatically translated to the selected language.

Color

Select a color for the signal. If you select brighter colors, you may change the overall brightness of the colors for printing.

CAN or Local Identifier - Adress

(Read only on this pane)

If the signal is a CAN Signal, this field shows the CAN Identiefier

If the signal is a part of a serial data readout, this field shows the Local Identiefier (LID)

If the signal is read or written directly, this field shows the Adress in RAM, FRAM or FLASH or  FRAM.

For some other signals it may not be of any relevance

Disable Signal on recording

If this is marked, the signal will not be recorded and appear in the resulting measurement file.


Signal Format Properties

Format

This determines the format, how the measurement data is represented.

Precision

This refers to the number of digits behind the decimal point.

Minimum

The lowest value, to be displayed graphically.

Maximum

The highest value, to be displayed graphically.

Scale

This function sets the Minimum and Maximum automatically according to the measured data.

Binary text symbols

If selected, the symbols in the symbol list are assigned to individual bits of the measured data.

Symbol list

You can assign text symbols to special numeric values. With the context menu (right mouse button) you can edit this list. The export/import function copies the symbols to and from the Windows clipboard. When Binary text symbols is activated; the Hide/Show symbol function can be used to select the displayed symbols.


Local Id signal properties
Data Selection Properties

Local Id

This is the Local Identifier (LID) of the data read from the ECU.

The different signals contained in a LID data stream depends on the ECU

The contents of this field is displayed as well in “CAN or Local Identifier – Adress” on pane “Global Properties”.

Data Type

The datatype of a signal out of the LID data stream.

Byte Offset

This refers to the position of the first databyte in the LID data stream. To be able to set the Byte Offset,

knowledge of the composition of the LID data stream, sent by the ECU, is necessary

Bit Number

Specifies the bit number within the selected databyte (0 = LSB, 7 = HSB)

Bit Count

If you have selected the data type Bit, you can choose the number of required bits.

Data format

By default, DIANA uses the Intel format (low byte before high byte). If you need to use the Motorola format (high byte before low byte) select this option.

msgPos, rxBfPos

The inputs done in the field “Byte Offset” are internally stored either in msgPos or rxBfPos. This field for control purposes only.


PLC Signal Properties

Data Type

Choose the datatype for the signal.

Byte offset

This refers to the position of the first databyte in the data part of the local identifier. The range depends on the local identifier.

Bit Number

Specifies the bit number within the selected databyte (0 = LSB, 7 = HSB)

Bit Count

If you have selected the data type Bit, you can choose the number of required bits.

MIDI Control Id

If you have connected a MIDI controller to the computer, you can modify the transmitted data manually. The number assigns the signal to a special slider of the controller.

Forward Signal

If you select a signal, the measurement data of this signal will be forwarded. Otherwise, you can use the following Edit function or the sliders to set the data.


Signal Converter Properties

Offset and factor

First, the offset will be added to the measured data and the result will be multiplied with the factor.

Bit shift and bit mask

First, the measured data will be shifted to the right and the result will be “AND” masked.

Show negative values as zero

All negative values are truncated to zero.

SAE J1939 mode

Special numbers are automatically converted to ”Err” or ”n.a.”

Neutral setting

offset = 0

factor = 1

shift = 0

mask = FFFFFFFFh


CAN control properties
CAN Control Signal Properties

DIANA can transmit CAN messages on the CAN bus to control or simulate external functions. You can control the assigned CAN signal automatically or manually.

Sample rate

This is the sample rate, with which the calculated value will be transmitted on the CAN bus.

MIDI Control Id

If you have connected a MIDI controller to the computer, you can modify the transmitted data manually. The number assigns the signal to a special slider of the controller.

Data length

This determines the length of the generated CAN message.

Default data bytes

If some data bytes of the CAN message are not covered by the generator signals of the measurement file, the default data bytes will be therefore transmitted.

Forward Signal

If you select a signal, the measurement data of this signal will be forwarded. Otherwise, you can use the following Edit function or the sliders to set the data.

Edit

With this function you can enter a time based curve, which will be transmitted automatically.


Analyzer properties
Analyzer Signal Properties

Column Width

This gives the width in pixels of the corresponding column in the table view.

Always display as Line

This function forces DIANA to display the signal in the graphic view always as line, even with binary data or symbols.

Show Curve as Single Dots

Instead of lines only dots are displayed.

Display Signal

Here you can assign the appearance of the signal in the different screen sets.

Line Drawing Method

This lets you define, how the lines are displayed in the graphic.

Mark Signal for Export

You can define, if the signal should be pre-selected when exporting or printing data.


Alias Signal Properties

Equation

You can combine two signals with a predefined equation to calculate a virtual signal. This signal is called an alias and has known measurement data.

Signal S1, S2

Select the signals, you like to use in the selected equation

Constant k1, k2

Enter any constant value. It will be used according to the selected equation.


Meta Signal Properties

Source Signal

Select the signal, you like to use for your calculations.

Operation

Choose the type of calculations you want apply on the source signal.


CAN Signal Properties

Identifier

This is the required CAN identifier.

Data Type

Choose the data type for the signal.

Byte offset

This is the position of the first databyte in the data part of the CAN message. The range is 0…7.

Bit Number

Specifies the bit number within the selected databyte (0 = LSB, 7 = HSB)

Bit Count

If you have selected the data type Bit, you can choose the number of required bits.

Data format

By default, DIANA uses the Intel format (low byte before high byte). If you wish to use the Motorola format (high byte before low byte) select this option.

Identifier type

Select between standard and extended identifier.

CAN bus

This is the CAN bus, where the CAN message will be received.

Transmit remote frame

If enabled, DIANA will transmit a remote frame each time before the CAN message is sampled.


CAN MPM signal properties
CAN Multi Package Message Properties

Source address

The source identifier of the multi package message.

PGN

The PGN of the multi package message.

Data Type

Choose the data type for the signal.

Byte offset

This is the position of the first data byte in the data part of the CAN message. The range is 0…7.

Bit Number

Specifies the bit number within the selected data byte (0 = LSB, 7 = HSB)

Bit Count

If you have selected the data type Bit, you can choose the number of required bits.

Data format

By default, DIANA uses the Intel format (low byte before high byte). If you wish to use the Motorola format (high byte before low byte) select this option.

CAN bus

The CAN bus, where the CAN message will be received.


A/D Signal Properties

Filter

Select a value in percent for filtering the measurement data. 0% is off. 100 % is maximum.

Voltage range

Select the required voltage range of the connected signals.

Counter mode

Choose between measuring the frequency or counting the pulses.

I/O Channel

Assigns a measurement channel of the A/D board to the selected signal.

Forward Signal

If you select a signal, the measurement data of this signal will be forwarded. Otherwise, you can use the sliders to set the data.


ECU Variable Signal Properties

Variable

This is the original name of the variable in the ECU.

Datatype

This is the original data type of the variable.

Address

This is the current address of the variable in the ECU and is dependent upon the software version of the ECU.

The following functions are only available, if the variable is a write variable :

Request Variable continued

If the value of the variable will be modified by the ECU itself, you should activate this function. In this case, the variable will be requested continued. If not, the variable will only be requested once at the beginning of the record.

Forward Signal

If you select a signal, the measurement data of this signal will be forwarded. Otherwise, you can use the sliders to set the data.

MIDI Control Id

You can assign any MIDI-Controller to a change the value of the variable manually.


Smoothing Filter

This function lets you smooth the recorded data of a signal. With Create Signal you can decide to create a new signal with the filtered data, which will leave the original signal unchanged, or overwrite the existing measurement data of the selected signal.

By using the slider you can set the desired degree of smoothing. You can also use a small degree of filtering and repeat this function as often as needed.  However, be aware, excessive filtering delays the signal.


Table Filter

You can use this function to reduce the number of displayed data in the table view. Only data, which apply to the selected conditions, will be displayed in the table. The graphic view is not affected by this function.

You can also use the workspace settings for further reduction of displayed data.

Only if the Filter setting is switched to On, the data will be filtered. When you select C1 and C2, all conditions must be fulfilled otherwise, only one condition must be fulfilled.


BASPviewer

BASPviewer may display different graphics. See overview below .

shift program	selectable by use of menu or toolbar. (1 to 5)

Fixed or acceleration dependent	data set shift lines may be shown only speed dependant (fixed) or speed and acceleration dependent.

shiftings nEng(y axis) over nOut (x axis)	select with toolbar button

acceleration (rpm/s) over nOut(rpm)	select with toolbar button [rpm km/h]

output speed or engine speed shown as x-axis	select with toolbar button [nOut nEng]

With or without acceleration reduction	With higher acceleration shift is done earlier.

Topographic  and standard shift program	select with toolbar button

grey out, black out display data set shift lines	double click to shift markers in upper left corner of  BASPview  graphic.

highlight topo-high,  topo-plain, topo-low dataset lines	by left clicking to the  appropriate shift marker.

toggle y-axis between vehicle acceleration and rotation acceleration	by double clicking to the y-axis.

When BASPviewer is called, There are 5 new signals created in the shift protocols:

nOutBASP	transmission output speed at a certain condition:

down shift:	nOutBASP shows the output speed at the lowest engine speed within 1s before shift was completed. This value is derived out of ECU signals.

The lowest engine speed is searched for in nEng and then nOutBASP is derived from nOut at this point of measurement.

up shift:	nOutBASP shows the output speed at end of shift. This value is derived from nEngE in shift protocols divided by transmissions ratio of the appropriate gear the

transmission is into after completing this shift. (in shift protocols nEngE shows engine speed at end of shift while nEng shows engine speed at start of shift.)

v	vehicle speed

ve	vehicle speed after gear shift (=follow up speed)

a	vehicle acceleration

In mouse mode Measure Point the results show the exact position of the mouse in the x-axis and y-axis particular scaling. This is different from the mouse mode Measure Point in the non BASPview, multi signal analysis. In latter mode, the x position of the mouse is exactly shown as the first value. This first value is the point of time the mouse was positioned. The following values are signal values and belong to a y-axis. These are measured values derived from the measurement list were the vertical mouse line intercepts the particular signal.


Workspace

The workspace is intended to reduce the number of displayed measurement data. You can select a time range and decide, if this range should be reflected by the table or graphic view.

If you press the Reset button, all settings will be cleared.

Depending on the Action setting, the excluded measurement data will be hidden or deleted, when you press the OK button.

You can also use the mouse mode Set Workspace in the graphic view to select a time range for the current workspace.


Chart Wizard

With this function you can create 2- or 3-dimensional charts. This can be selected in the Chart Type list field above the graphics. The signals will be accumulated according to the signal range. If the signal range is too large, it will be subdivided in 25 segments. You can reduce the number of segments by using the sliders below the graphic. Use the X and Y buttons below the graphics to select other signals.

Normally, all measurement data will be processed. With Use Workspace you can reduce the number of processed data.

The Copy button can be used to place the graphic in the Windows clipboard.


Trigger

If you only want to record or monitor special events, you can enter conditions, which define this event. In this case, the recording is only done, when the conditions are fulfilled.

Each trigger item can have one or more conditions, which all must be fulfilled.

There can be more than one trigger item. Each trigger item can have a different action.

You can also define a time to record data before (Pre Trigger) and after (Post Trigger) the trigger event.

Trigger Properties

Each trigger item can have its own behavior, and when all included conditions are fulfilled the following will occur:

•	Record will start the recording

•	Show Message will open the Event List Box and display the current trigger event.

•	Play Alert Sound will output a special sound.

•	Transmit SMS will send a SMS, if a modem connection is possible (only PocketDIANA)

•	Show Panel will display the selected panel.

Condition Properties

All conditions of a trigger item must be fulfilled at once. You can use the same signal in different conditions.


CAN transmit message list

You can add CAN messages to send during the recording. There are two different types available :

•	Messages in the oneshot list are transmitted at the selected time.

•	Messages in the function key list are transmitted by pressing the assigned function key.

You can edit the messages by double clicking or using the right mouse button.

Import

You have different possibilities, to import CAN messages. In the file open dialog box, you have to select the desired file type :

DIANA4 dcf files

Use this setting, to import CAN messages from a DIANA4 CAN message file.

Text files

The text files must have the following syntax :

Time [seconds]	CAN-Id Type (0=Std, 1=Xtd)	CAN-Id	Data Length Code	Data[0]	Data[1] …

Example :

1.821	1	CF00203	8	00 11 3A 6B 7A 11 00 98

DIANA5 measurement files

If a measurement file contains a CAN message table, you can load this data into your CAN transmit message list.

DIANA5 template files

It is also possible to load the complete CAN transmit message list of a different DIANA5 template into this template.

Export

In the context menu of the message list, you can also call the export function. This function will export the CAN messages to a text file. It will have the same format, which is required for importing it to DIANA5.

Loop Oneshot List

If enabled, the oneshot list will be repeated infinitely.


CAN message properties

Identifier

This is the CAN identifier.

Time/Key

Enter the time in milliseconds, when the message should be send or assign a function key number from 1 to 12 (F10 is not allowed here)

Data length

Select the number of databytes you want to send.

Default databytes

Enter the default databytes.

Identifier type

Select between standard and extended CAN identifier.

CAN bus

This is the CAN bus, where the CAN messages will be transmitted.

Transmit remote frame

If enabled, DIANA will transmit a remote frame instead of a data frame.


CAN Automation Editor

Graphic View

The graphic shows the automation data of the control signals. The scale of each signal in the graphic is taken from its signal properties. If you click in the graphic with the left mouse button, a new drag point is created. You can move the drag points to modify the curve. When you hold the shift key and click on a drag point, it will be deleted.

Selected Signal

This is the signal you are currently working on. Only the drag points of the selected signal are displayed.

Hide other Signals

Normally all control signals are displayed in the graphic. If you only want to see the selected signal, you can use this function.

Time Slider

With the slider, you can set the time base of the graphic.

Data List

The list beside the graphic shows all drag points of the selected control signal. You can also directly edit this list. The time has the unit milliseconds. Graphic and list are always synchronized automatically.

Interpolate Signal

Depending on the sample rate of this signal, the data is interpolated between the drag points.

Loop Signal

If you activate this function, the data between Loop Start and the last point of the data list will be repeated infinitely.


Recorder

With this program you can record new or continue existing measurements. Therefore, you must load a template or measurement file.

When no template is loaded, you can press the record button to automatically find a suitable measurement template.

When a template is opened, the recording standby mode will be activated automatically. If you want to make a record, you have to press the record button again.

Please check the reference manual for more information !


Analyzer

With this program you can open a measurement file and analyze the measured data. You will see a graphic and a table view. You can scroll through the graphic and table view. When you select a row of the table, the graphic will be adjusted to show the data of the selected row.

Please check the reference manual for more information !


File Exporer
File Explorer

This tool will help you to find special measurement files on your computer.

Search Path

Select the directory, where to search for measurement files. Tick Include Subdirectories if the search should extend to subdirectories further on in this folder.

Condition 1 / Condition 2

Enter up to 2 conditions, to reduce the resulting list of matching files. The selected conditions will also be displayed in the result list. The right most field of a condition line is the field to enter search words. If no search word is entered, then all measurement files incorporating the search data you chose in the left most field match the search condition and e.g. are listed. The search date with ECU : or User : to the left of the name are out of the identification data and need less time to search for than signals.

In the result field there are following columns listed:

name of the measurement file found.

path

date and time of the creation of the file

contents of search condition 1

contents of search condition 2

Non numeric search conditions for signals are treated as substrings to the expression found in the measurement file. Example: You select gear and as search condition “N”. With this, all files are listed containing a “N” somewhere in the gear signals measurement data. Actually these are: “N” and “Neutral”. In the gear signals properties you will find that “N” or “Neutral” is the substitute for 0. Thus, searing for 0 would lead to the same result in this case.

GPS Search Filter

You can enter or select predefined GPS coordinates to reduce the search result. The radius defines the valid circle around the selected position. If you enable this function, all measurement files without GPS data will be ignored.

Start

This will start the search. When you press the button again, it will stop the search.

Details

The recording details of the selected file will be displayed.

Analyzer

The selected file will be opened in the DIANA5 Analyzer.


TED

This program may be used to create or modify measurement templates. You may also open a measurement file and modify panels.

Here you can add, modify or delete tables and signals. These signals can be assigned to the virtual instruments and the instruments can be placed in the panel. You can have more than one panel in a template.

Please check the reference manual for more information !


Test Script Editor

Available Commands

// text	Starts a comment field within a line. A Comment field ends at line end.

:label	Jump target. Is needed for the goto( ) command

goto( :label )	Jumps to the label given between the braces. Label must be found in the present test step.

if( expression ) ….	The command after if( ) but in the same line,  will be executed when “if-expression” is true

if(expression )	Start of multi line if() - endif(); if() - else() - endif(),…. combinations. No command should be provided after (expression ).

All commands listed between if() - else(); if() - elseif() or if() - endif() are executed if (expression ) develops TRUE.

else( ) …	The command after else( ) will be executed if the previous if( ) expression failed

The braces after “else” must be provided !

An single else() without a previous if() is ignored.

else()	If no command is written to the right of else(), this very else() is a multi line else(). If the preceding multi line if() and all

preceding elseif() statements developed FALSE all the commands listed between else() and endif() are executed.

No elseif() should be written after an else().

elseif(expression )	If the preceding if(expression ) developed FALSE and elseif(expression ) develops TRUE all commands listed between

this elseif() and the next elseif() or this elseif() and else() or this elseif() and endif() are executed.

endif()	With endif() a multi line if() - elseif() - else() combination is terminated.

Please note: Nesting of if()-else()-…. combinations isn’t supported.

        Labels and goto() commands shouldn’t appear within if()-else()-…. combinations.

message( text )	Outputs a message

messagewait( text )	Outputs a message and waits til the user presses the [OK] button right to the message window.

error( text )	Outputs an error message

errorwait( text )	Outputs an error message and waits for pressing Accept

write( text )	Writes a text to the protocol file

writeln( text )	Writes a text to the protocol file. A new line will be added.

write2( text )	Writes a text to the 2nd protocol file

wait( time)	Wait an amount of time in milliseconds

ready( )	Shows that this test step passed. Continue with next step.

ready( text )	Shows that this test step passed together with the user text. Continue with next step.

The character “|” creates a newline in the dialog box.

cancel( )	Shows that this test step failed. Step should be repeated

cancel( text )	Shows that this test step failed together with the user text. Step should be repeated

The character “|” creates a newline in the dialog box.

skip()	Shows that this test step was skipped. Continue with next step.

skip( text )	Shows that this test step was skipped together with the user text. Continue with next step.

The character “|” creates a newline in the dialog box.

panel( number )	Switches to the selected panel

starttimer(  )	Starts the internal user timer

marker( text )	Adds a marker to the recording file

alert( signal )	Highlights the corresponding virtual instrument

alert( )	Highlight of all virtual instruments is ended

record( )	Continue recording measurement data to recording file

standby( )	Stop recording measurement data to recording file

captionlist(text1,..,textn)	Single commands are composed to a test step. Any test step has a name. While a

particular test step is active (=running) in Testcenter, this name appears in the upper

labeling field of the screen. With captionlist(text1,..,textn) these names, or captions

of the test steps are changeable. text1 in captionlist(..) replaces the caption of the first

test step textn replaces the caption of the nth test step. To skip a caption not to be changed,

place two consecutive commas. expl: (..,text4,,text6,text7,,,text10,…)

Captions of test steps are shown on screen and in protocol as well.

csegment($signal name; background color)

csegment($signal name; background color; valueC11; valueC12; segment color 1)

csegment($signal name; background color; valueC11; valueC12; segment color 1; valueC21; valueC22; segment color 2)

Of a Tacho Instrument  or a Thermo Instrument; the background color  and one or two colored segments,

starting with value C11(C21) and ending with value C12(C22) are definable.

If limit C11 (C21) is set to a value below ymin or limit C12(C22) is set to a value above ymax, than colored

background and all colored segments are turned off.

Setting limit C11 = C12  or limit C21 = C22, turns off the appropriate segment.

Intern defined variables may be used for all colors and limits.

csegment()	Erases all colored segments on screen created by various csegment($.....…) commands

loadpic(picture.bmp;frameNr)

loadpic(picture.bmp)	If the current template page has a picture frame; with this command another picture may be loaded into the existing frame.

picture.bmp in the command loadpic(picture.bmp) is the name of a file. Various formats are loadable  (.bmp, .jpg, gif,….)

If no frameNr is given, the first image frame found on a template page has its picture exchanged by the picture loaded.

If a frameNr is put to the command then the (frameNr) frame, found on the current template page has its picture exchanged by the picture loaded.

A frameNr less than 2 always refers to the first image frame found.

A frameNr greater than the number of image frames existing in the template, always refers to the last image frame found.

There is no way to address an image frame directly. Therefore don’t put to much image frames on a single page in a template.

If only a file name is provided in loadpic(…), this file must reside in the same folder as the template.

fcanid($variable)

fcanid($variable;lowId;highId)

fcanid($variable;lowId;highId;1)

There exists a buffer containing the last 256 Identifiers found on CAN. In this buffer fcanid(…) searches, starting from the newest

input to older inputs, for an Identifier between lowId and hightId. The Identifier found is put to $variable. If lowId and highId are missing

the Identifier put latest to the buffer is copied to $variable. If just lowId is missing, 0 is used instead. If no Identifier is in the range

between lowId and highId, 3,402823466385 10^38 is returned. If there are no CAN signals defined in the appropriate template $variable

is assigned to 3,402823263561 10^38.

If a “1” is provided as last parameter the ID buffer is cleared after the command was executed

getlcbuf($variable)	Puts the length of the Identifier buffer to $variable (value between 0 and 256)

chcan_id(CanIdtoFind; newId)

Changes all CAN signal Identifiers in a template with Id = CanIdtoFind to newId.

canmsgtrx(Id_onOff; onOff)

Depending on the value of onOff, the CAN Output message with Identifier = Id_onOff is turned OFF (onOff == 0) or turned ON (onOff != 0).

(Message turned off = isn’t sent on CAN anymore)

getcanmsg(Id;$backstep;$string)

With the allocation $var = $sig the last value of $sig, taken in by an interface (V24, CAN, ADC, …..) is transferred to $var. Sometimes it happens

that not just the last value is needed but a value some time quanta’s before the last value. This command reads a complete message,

received on CAN  into a string variable. To get this command working the CAN message monitor must be present in the particular

template.

The first parameter (Id) is the identifier of the CAN message wanted.

Test Center runs the Recorder automatically and the Recorder creates a measurement list for all messages.

If the value in parameter $backstep = 0, the first message with the identifier Id in the message list is transferred into $string.

A value of 1 in $backstep causes the command to skip the first message with the identifier Id and instead the data of the second occurring

message will be transferred to $string. And so on.

The data format of $string is as follows:	|byte 0 | byte 1 |..|  byte(DLC) | byte(DLC + 1) |

DLC = data length code  0 <= DLC <= 8	|  DLC |     DB1  -  DB(DLC)   |    “:”   or   “# “  |

If a “:” occurs at the end of $string there could be as many messages skipped in the message list as were given in parameter $backstep.

A “#” at the end of $string signals that the message list was too short to do all the skips provided in parameter $backstep and the oldest message

in the message list was transferred to $string.

A message with DLC = 0 returns “-:” or “-#” to $string

If no message with the identifier Id was found in the message list “--“ is returned to $string.

Id,  $backstep >= 0

getat($basestring, $var, pos)	With this command the character found on position pos in string $basestring is moved into $var as a binary value (0 to 255)

setat($basestring, $var, pos)	With this command the character found on position pos in string $basestring re placed by the contents of $var. $var should be in the range of 0 to 255.

leftstr($basestring, $leftstring, nrChr)

Out of $basestring, nrChr characters are moved to $leftstring starting at the beginning (left) of $basestring.

rightstr($basestring, $rightstring, nrChr)

Out of $basestring, nrChr characters are moved to $rightstring starting at the end (right) of $basestring.

getstrlng($string; $lng)	The length of $string is returned to variable $lng.

tplstext(txtString)	A template may have an area were text might be written to. This area is called a Static Text Window STWdw.

tplstext(txtString;Nr)	The command tplstext(txtString) writes txtString to the first STWdw it finds in the template used. With Nr presented in the command you

may write txtString to the second or third STWdw (E.g. with Nr = 2 txtString is placed in the second STWdw on the template used.)

Variables

$signal name	The shortcut of any signal name may be used (e.g. $nEng)

$[tabNr]signal name	The name of a signal within a special table. For the first table “tabNr” is one.

Mentioning the table where signals belong to, reduces search time.

$systimer	The elapsed time since starttimer( ) was called

$steptimer	The elapsed time since the step was started

$recordingtime	The elapsed time since recording started

$gearcount	The current number of gears

$ratioAnlgeDrive	The current ratio of the selected angle drive

$WorkingPressure	The DIWA oil pump produces an oil pressure depending on the motor connected

with. Therefore the oil pressure may be entered during the TestCenter Setup

dialog and is also available as a variable in the Test Script.

$TrDifferential	Differentials Ratio = 1.36 or 1.43 (-1 if not valid)

$TrPump	ASCII Identifier of converter pump diameter out of the transmissions identifier example:	3N T0R2

$TrTx	Identifier of turbine diameter out of the transmissions identifier; example:	3N T0R2

$TrRx	Identifier of turbine ratio out of the transmissions identifier; example:	3N T0R2

$StallSpeed	Stall speed measurements are possible

$Time	Current time (hh:mm:ss)

$Date	Current Date (yyyy-mm-dd)

$TestObject	Name of the test object

$OrderNumber	Order number for the test object

$SerialNumber	Serial number of the test object

$Operator	Customer or Username

$TestBench	Name of the test bench

$language	The current language

0 : English

1 : German

2 : Spanish

3 : Italian

$testobjectid	The id of the selected test object :

0 : user template        1 : DIWA.2         2 : DIWA.3        3 : DIWA.3E

4 : DIWA.5	        5 : CAN-Open    6 : VIAB             7 : Retarder

$RetarderType	The current retarder types :

0 : VR 115E

1 : VR 115HV

2 : VR 115V

3 : VR 119

4 : VR 120

5 : VR 123+

6 : VR 133

$CANopenIdent	Identifier entered by user in “Set CANopen Pressure Sensor”

$CANopenAvgTime	Average time entered by user in “Set CANopen Pressure Sensor”

$CANopenEvtTime	Event time entered by user in “Set CANopen Pressure Sensor” (See description of Baumer CANopen pressure sensor)

$CANopenBaudIdx	Index of the Baud Rate used on CAN. Parameter is entered by user in “Set CANopen Pressure Sensor”

0:   10 kBaud	1:   20 kBaud	2:   50 kBaud	3:   125 kBaud

4: 250 kBaud	5: 500 kBaud	6: 800 kBaud	7: 1000 kBaud

$...	Any other name, except the predefined names, may be used for user variables

Assign operator

=	Assigns a value or expression to a variable

= “…”	Assigns a string to a variable

Compare operators number variables

==	Equal

>=	Bigger or equal

<=	Smaller or equal

>	Bigger

<	Smaller

!=	Unequal

&	Logical and

|	Logical or

Compare operators string variables

==	Equal

>=	Bigger or equal

<=	Smaller or equal

>	Bigger

<	Smaller

!=	Unequal

Expression operators

&&	Both Condition must be true

||	One Condition must be true

Calculation operators

+, -, *, /,%

String concatenate

+	strRes = string1 + string2 +….+ stringn

Formatting a text line

If you want to print the value of a variable in a text line (message, write, marker, …), you can use the variable name with the leading “$” character. If a signal name is used, the corresponding signal name and unit will be added automatically. It is possible to use as many variables as you want in one line.

If you want to create a newline in a write( ) command, use the characters “\n”.

Examples :

command : write($nEngine is too high !)	result : “nEngine = xxx rpm is too high !”

command : write(This is line1\nThis is Line2)	result : “This is line1

This is line2”

command : $user = “$nEngine is too high !”

      write($user)	result : 	“nEngine = xxx rpm is too high !”

[Export] – [Import] Functions

If a Test Script is exported DIANA5 creates a file  c:\Tmp\testScript.txt.  In this file the created Test Script is

shown. The script starts with:	 	Test Step 1 : <name of Test Step 1>

Below all the commands of Test Step 1 are listed,	[01] $variable1 = $n……..

preceded by line numbers in square brackets. After Test Step 1 with it’s commands, Test Step 2 follows with

it’s commands. The DIANA5 Export- Function inserts some empty lines and a double dashed line as separator

between Test Steps.

If the Export of the Test Script is ready. Notepad is automatically called by DIANA5 and the exported Test Script

is loaded into Notepad.

The exported Test Script may now be edited within Notepad or with another editor.

If new lines are inserted there is no need to provide line numbers in square brackets. Just type in the commands

you want to enter or do the changes needed.

After the changes done, the Test Script may be imported by DIANA 5. Once the [Import] button was pressed, the

file to be imported has to be chosen first. If the import file is chosen a second question is asked. The import file

may override the existing Test Script or may append to it.

During importation the line numbers in square brackets and the separators between Test Steps are removed.

Subsequently to importation, DIANA5 shows how many lines and bytes were imported.

Now it is advisable to check the syntax of the imported Test Steps by pressing the [check] button in the DIANA5 Test Script Dialog.


Test Center

This program can be used to run automated or manual tests on any measurement device, connected to DIANA5. You need to have a special DIANA5 measurement template, which includes a test script. This test script can be developed with the Test Script Editor of TED. Therefore DIANA has included a special test script language (see HELP in the test script editor). You can have as many test steps as you want within one measurement template.

While running the test script, DIANA5 creates and stores a measurement file which gets a name automatically.

The file is stored in ….DIANA5\Records, and the file name consists of the following: DIANA5Test_Serial……dm5.

If serial number and order number are entered in the Test Center start dialog (shown after the [Start] button was pressed) the file name contains these numbers.