DEWESoft® RoaDyn 2000 LAN Plugin€¦ · DEWESoft® RoaDyn 2000 LAN Plugin About this document 1.6...

DEWESoft® RoaDyn 2000 LANPlugin

Document-Version: 1.0.0Plugin-Version: 4.5

www.dewesoft.com

DEWESoft® DEWESoft® DEWESoft® DEWESoft® DEWESoft® DEWESoft® DEWESoft® DEWESoft® DEWESoft® DEWESoft® DEWESoft® DEWESoft®

measurement innovation measurement innovation measurement innovation measurement innovation measurement innovation measurement innovation measurement innovation

http://www.dewesoft.com/

DEWESoft® RoaDyn 2000 LAN Plugin Table Of Contents

Table of Contents1About this document...........................................................................................................................................................1

1.1Legend........................................................................................................................................................................11.2Links...........................................................................................................................................................................21.3Compatibility.............................................................................................................................................................21.4Files and Directories..................................................................................................................................................2

1.4.1Important DEWESoft® 7 Directories...............................................................................................................21.4.1.1DEWESoft® Measurement Unit [recommended]....................................................................................21.4.1.2Windows Standard....................................................................................................................................2

1.5Licensing....................................................................................................................................................................31.5.1Requesting an Evaluation license......................................................................................................................31.5.2Activating the Evaluation license......................................................................................................................3

1.6Plug-in Installation.....................................................................................................................................................41.6.1Registering the Plug-In......................................................................................................................................4

2Sensor connection...............................................................................................................................................................62.1.1Sync Connector.................................................................................................................................................6

3Ethernet Configuration.......................................................................................................................................................7Configuration of the sensors Ethernet interface:............................................................................................7

4Hardware Setup..................................................................................................................................................................84.1Standalone Mode........................................................................................................................................................84.2Master Mode..............................................................................................................................................................94.3Slave Mode................................................................................................................................................................94.4Demo mode................................................................................................................................................................9

5Channel Setup...................................................................................................................................................................106Additional Settings...........................................................................................................................................................11

6.1Settings in the RoaDyn2000_LAN.ini file...............................................................................................................116.2Changing the default names:....................................................................................................................................11

6.2.1Changing the units...........................................................................................................................................127Version History.................................................................................................................................................................13

7.1Plugin Version..........................................................................................................................................................137.2Documentation Version............................................................................................................................................13

www.dewesoft.com Page I




DEWESoft® RoaDyn 2000 LAN Plugin About this document

1 About this documentThis is the user documentation for DEWESoft® RoaDyn 2000 LAN Plugin Version 4.5.

The DEWESoft® RoaDyn 2000 LAN Plugin enables DEWESoft® to acquire data from the Kistler RoaDyn2000 measurement system via LAN. There are three operation modes:

No AD card: The RoaDyn2000 is running as stand-alone

Master-Mode: The RoaDyn2000 acts as clock provider for the AD card of the measurement system

Demo-Mode: When no RoaDyn system is connected, DEWESoft® will create a virtual one

1.1 LegendThe following symbols and formats will be used throughout the document.

IMPORTANTGives you an important information about a subject.Please read carefully!

HINT

Gives you a hint or provides additional information about a subject.

EXAMPLE

Gives you an example of a specific subject.

Example Meaning Description

Cancel Button a button that you can click

File Menu Item a menu item, will open a sub menu or a dialogue

Times New Roman List Item an item in a list (or tree) that you can select

Events Tab Sheet a tab sheet that you can select

C:\Program Files\OpenOffice.org 3\readme.txt

File Path and Name a file name or path

Windows Key a term any kind of term (maybe also compound)

Table 1: Layout formats used in the documentation

Page 1/13 www.dewesoft.com Document-Version: 1.0.0





1.2 Links

DEWESoft® homepagehttp://www.dewesoft.comyou can download DEWESoft® plugins when you go to: Support - Downloads – Plugins

1.3 CompatibilityThe plugin is compatible with DEWESoft® X.

1.4 Files and DirectoriesThe actual location of the directories on your computer may vary dependant on your computer's locale settings and the settings you chose when installing DEWESoft®.

1.4.1 Important DEWESoft® 7 Directories

1.4.1.1 DEWESoft® Measurement Unit [recommended]

Directoryname

Explanation Default path

Bin contains DEWSoft.exe D:\DEWESoft7\Bin\X2

Addons .dll files for plugins must be copied into this directory D:\DEWESoft7\Bin\X2\Addons

Data this is where DEWESoft® will store your measurement data D:\DEWESoft7\Data

Setups this is where your DEWESoft® setup files will be stored D:\DEWESoft7\Setups

System this is where DEWESoft® project files are stored D:\DEWESoft7\System\X2

Log this is where DEWESoft® will store log files D:\DEWESoft7\System\X2\Logs

The paths may be different depending on your DEWESoft® version.

1.4.1.2 Windows Standard

Directory name Default path

Bin language dependant directory:C:\Programme\DEWESoft7\Bin\X2

Addons language dependant directory:C:\Programme\DEWESoft7\Bin\X2\Addons

Data user/language dependant directory:C:\Dokumente und Einstellungen\All Users\Dokumente\DEWESoft7\Data

Setups user/language dependant directory:C:\Dokumente und Einstellungen\All Users\Dokumente\DEWESoft7\Setups

System user/language dependant directory:C:\Dokumente und Einstellungen\All Users\Dokumente\DEWESoft7\System\X2

Log user/language dependant directory:C:\Dokumente und Einstellungen\All Users\Dokumente\DEWESoft7\System\X2\Logs

The paths may be different depending on your DEWESoft® version and the language of your operating system.

Document-Version: 1.0.0 www.dewesoft.com Page 2/13






1.5 LicensingThe plugin requires a valid DEWESoft® license.To test the plugin you can use an Evaluation license.

1.5.1 Requesting an Evaluation license

You can request an Evaluation license from our homepage: http://www.dewesoft.com/registration

(1) Click on Evaluation license

(2) Fill out all the required fields

(3) Click the Request license button

Illustration 1: Request Evaluation License

1.5.2 Activating the Evaluation licenseWhen you have received your trial licence key, open DEWESoft®, go to Settings - Settings…, select Licensing and expand the Create new license section).

Now enter the license code and click the Register online button.

Then your new license key will show up in the list and should have the Status Valid.

Illustration 2: Enter license key Illustration 3: Valid trial license




http://www.dewesoft.com/registration



1.6 Plug-in InstallationSimply extract the file RoaDyn2000_LAN.zip 1 archive into the Addons folder of your DEWESoft® installation. (e.g. D:\DEWESoft7\Bin\X2\Addons\). Now your Addons folder should look like this:

Illustration 4: Addons Folder with RoaDyn files

File description:

RoaDyn2000_LAN.dll: the plugin itself

RoaDyn2000_LAN.ini: OPTIONAL stores the RoaDyn2000 configuration

RoaDynNames_English.ini: stores the English default channel names)

RoaDynNames_Deutsch.ini: OPTIONAL stores the German default channel names

RoaDynWheelTypes.ini: stores the RoaDyn wheel types

Then you can start DEWESoft® and register the plugin (aka. Extension). Click Settings - Settings…, select Extensions and click the plus sign. Then find the Kistler RoaDyn plugin in the list and activate it (i.e. click the check-box inIllustration 5) - when the plugin does not show up in the list, you may need to register it first (see 1.6.1 Registering the Plug-In on page 4)

Illustration 5: Enable Plug-In

1.6.1 Registering the Plug-InBefore you can use Plugins in DEWESoft®, the plugins must be registered once.

When DEWESoft® is started it will try to register all plugins (dll files) that it finds in the AddOns folder. But in order todo that, DEWESoft® requires administrator permissions (because it must write to the Windows® registry). When DEWESoft® is not with administrator permissions, the registration cannot be done automatically.

1 The name may be slightly different (i.e. it may include the version number: RoaDyn2000_LAN_v4.5.zip)






When the plugin does not show up in the Extensions list, you must press the Refresh button (see in Illustration 6).Note: you may need to start DEWESoft® as administrator (depending on the UAC settings of your Windows user/installation).

When you have pressed the Refresh button, then youwill see the registration Window in Illustration 7 for a short time. After that, you must restart DEWESoft®.

Illustration 6: Extensions: Refresh button Illustration 7: Registration Window





DEWESoft® RoaDyn 2000 LAN Plugin Sensor connection

2 Sensor connectionThe sensors are connected to the measurement PC (e.g. S-BOX) via the LAN port (TCP/IP for data transfer). The clock and trigger lines of the sensor are connected to the corresponding clock and trigger pins of the sync connector on the DEWE-43 or SIRIUS measurement slice.

If more than one RoaDyn2000 system is connected it is recommended to use an Ethernet-Switch. Clock and trigger are daisy-chained between the RoaDyn systems.

Illustration 8: Sensor connection

HINT Dewesoft offers a suitable sync cable:Article Number: L00B4m-2xBNC-2m-ROADYNE-SYNCCable length 2.0 meterFits to SIRIUS, DEWE-43, MINITAUR

2.1.1 Sync ConnectorThe RoaDyn2000 synchronisation wires (clock and trigger) must be connected to Sync connector of the DEWESoft® measurement device (i.e. SIRIUS, DEWE-43):

The clock output of the RoaDyn2000 is connected to CLK (Pin 1) on the DEWESoft® Sync connector.

The trigger output of the RoaDyn2000 is connected to Trigger (Pin 2) on the DEWESoft® Sync connector .

Ground is connected to GND (Pin 4) of the DEWESoft® Sync connector

Illustration 9: DEWESoft® Sync connector 4pin

DEWESoft® Sync-Mating connector: FGG.00.302.CLAD27Z





DEWESoft® RoaDyn 2000 LAN Plugin Ethernet Configuration

3 Ethernet ConfigurationThe sensors are connected to the measurement unit via Ethernet cable for the data exchange. To establish a communication between the sensors and the measurement system, the Ethernet interface on the PC and the Ethernet interface/s on the sensor/s must be configured to use the same IP address range (i.e. the Subnet mask must match).

EXAMPLE 1 Configuration of the measurement units Ethernet interface:

Define the IP address (here 192.168.160.1)

Define the Subnet mask (here 255.255.255.0)

Click OK to confirm the settings

Configuration of the sensors Ethernet interface:

To configure the Ethernet interface of the sensors use the Kistler RabbitConfig tool provided with the sensors. With this tool you can also check if the communication to the sensors is working. When clicking the Hello? button you should geta response from the network interface (MAC and IP address).

Illustration 10: Ethernet Interface Configuration RoaDyn

If you do not know the IP address of the RoaDyn2000 you can find it out by using the external control display: In the setup screen, click on Diagnostics then on Interface where you will find the currently set IP address and subnet mask.





DEWESoft® RoaDyn 2000 LAN Plugin Hardware Setup

4 Hardware SetupAfter you have installed and enabled the plugin (see 1.6 Plug-in Installation), start DEWESoft® and go to the Hardware Setup:

Illustration 11: Hardware setup

The plugin only supports Master mode: i.e. do NOT select Slave Mode.

4.1 Standalone ModeWhen the RoaDyn2000 is connected to a DEWESoft® system without any AD card, the RoaDyn2000 will be configured as stand-alone system. Since no hardware synchronization is needed in this mode, you cannot (do not need to) connect the clock and trigger to the measurement system.





DEWESoft® RoaDyn 2000 LAN Plugin Hardware Setup

4.2 Master ModeIn Master mode, the RoaDyn2000 system acts as the clock master, providing clock and trigger for the DEWESoft® measurement slices.

In Master Mode it is important to set the DEWESoft® synchronization settings to External – Clock/Trigger:

Illustration 12: DEWESoft® Synchronization settings

4.3 Slave Mode

IMPORTANT

Slave Mode is NOT supported.

4.4 Demo modeWhen no RoaDyn2000 system is found, DEWESoft® will create a virtual system denoted as “Demo device”. This is only to show the basic plugin functionality. No data is being simulated however.





DEWESoft® RoaDyn 2000 LAN Plugin Channel Setup

5 Channel SetupIn the channel setup of the Kistler RoaDyn plugin, you can activate/deactivate channels of the connected sensors.

Illustration 13: Channel Setup Overview

Dynamic acquisition rate: This is the sample rate and can be chosen between 80 Hz and 1250 Hz. Please note that the set sample rate will be valid after switching to Measurement mode (e.g. Overview).

Rescan external clock: When the system is set to Slave mode, this button will measure the currently set sample rate. Note: Slave Mode is NOT supported!

Delay: Due to the internal hardware of the RoaDyn2000 system, there is a delay between analogue data from the AD card and data from the RoaDyn2000 system. This delay is constant over time but depends on the set sample rate and the synchronization mode (Master or Slave mode). DEWESoft® will automatically set the correct delay, based on the selected sample rate and the synchronization mode. For more information, please refer to 6 Additional Settings on page 11.

IP:192.168.xxx.xxx: If more than one RoaDyn2000 system is connected you can switch between the channel lists of each system.

Channel list: The channel list of each system is divided into sub-groups (Wheel channels, Hub channels and Analog input) for easier navigation. A click on the Setup button next to each channel lets you alter each channels name, colour, unit and scaling. To change these permanently you can edit the default settings (see6 Additional Settings on page 11 for more information).

System Setup: The tab System setup let’s you choose the connected measurement wheel type and optionally assign the default channel names. It is also possible to change the default channel names and their units by editing the corresponding *.ini file. Please refer to 6 Additional Settings on page 11 for more information.





DEWESoft® RoaDyn 2000 LAN Plugin Additional Settings

6 Additional Settings

6.1 Settings in the RoaDyn2000_LAN.ini fileThe hardware configuration of the RoaDyn2000 system is stored in the file:e.g.: D:\DEWESoft7\Bin\X2\Addons\RoaDyn2000_LAN.ini

Usually it is not necessary to change any of these parameters because DEWESoft® handles the configuration automatically.

This file consists of the following parameters:

Parameter Comment

Settings

SampleRate=xxxx Sample rate in Hz

MasterMode=x 0=Slave mode , 1=Master mode

UseManualDelay=x 0=Delay is set automatically ,1=Delay can be entered manually

Debug

CreateLogFile=x 0=Create no log1=Create log file in DEWESoft® root folder

PutDataInLog=x 0=No data in log file1=Data are included in log file

ForceWheelCount=x Force number of wheels

6.2 Changing the default names:The files RoaDynNames_Deutsch.ini and RoaDynNames_English.ini are located in the DEWESoft® Addons folder:e.g.: D:\DEWESoft7\Bin\X2\Addons\ store the

They store the default channel names for the system. You can change the default names in this file according to the syntax shown in the following picture. The default channel names can be loaded under the System Setup tab in channel setup.

Illustration 14: Default Channel Names





DEWESoft® RoaDyn 2000 LAN Plugin Additional Settings

6.2.1 Changing the unitsYou can change the units and ranges of the channels by editing the RoaDynWheelTypes.ini file. This will affect all wheel types however.

Illustration 15: Units





DEWESoft® RoaDyn 2000 LAN Plugin Version History

7 Version History

7.1 Plugin VersionPlugin-Version Date

[dd.mm.yyyy]Notes

4.5 12.02.2015 Current version

7.2 Documentation VersionRevision number: 57Last modified: Thu 12 Feb 2015, 10:02

Doc-Version Date[dd.mm.yyyy]

Notes

1.0.0 12.02.2015 initial revision





DEWESoft® RoaDyn 2000 LAN Plugin€¦ · DEWESoft® RoaDyn 2000 LAN Plugin About this document 1.6...

Documents

Transcript of DEWESoft® RoaDyn 2000 LAN Plugin€¦ · DEWESoft® RoaDyn 2000 LAN Plugin About this document 1.6...