OXYGEN setup

The OXYGEN Setup menu contains all settings which affect software settings and will be stored in the registry. These settings are saved per default and do not have to be saved in a setup file.

The content of the individual submenus will be explained in the following sections in detail.

General settings

Storing and File name

System Settings – Overview

Fig. 122 System settings - overview

  • Data storing: The folder to which data shall be stored, a prefix for data-filename and a folder to which data shall be exported can be specified here.

  • Recording Filename: The user can use the file name pattern to set an individual file name. Different placeholders are available. Additionally, text can be entered to individually set a name for the datafile. The 3 different placeholders are the following:

    • Time

    • Date

    • Number

Time

  • Time, Local: the local time is used.

  • Time, UTC: the UTC time is used.

  • Time, hh-mm-ss: the time can be used in different formats.

  • Hours [h], minutes [m], seconds [s] and milliseconds [z] can be arranged individually. As separator [- . _] can be used, e.g. ss-mm-hh”, “mm_hh”, “ssmmhh”.

Note

The text File Start can be added, in order to guarantee the individual recording start for multi-file recordings. Example: #{Time, File Start, “hh-mm-ss”}.

Date

  • Date, Local: the local date is used.

  • Date, UTC: the UTC date is used.

  • Date, dd-MM-yy: the date can be used in different formats. Day, month and year can be arranged individually. As separator “-“ or none must be used, e.g. “yy-MM-dd”, “dd-MM”, “ddMMyy”.

Note

The placeholder letter for month (M) is written in capitals, to distinguish it from the placeholder for minutes (m).

Note

The text File Start can be added, in order to guarantee the individual date of recording start for multi-file recordings. Example: #{Date, File Start, “dd-MM-yy”}.

To specify a file name before recording start enable the button Ask for file name before recording start.

Ask for file name before recording start button

Fig. 123 Ask for file name before recording start button

If this button is enabled, a pop-up window (see Fig. 124) will appear where the file name can be entered.

Note

The recording only starts by clicking on the Record button (marked red in Fig. 124) in the pop-up window after entering the file name.

Pop-up window to enter the file name before recording start

Fig. 124 Pop-up window to enter the file name before recording start

To open a file right after recording stop in the OXYGEN Viewer, activate the button Open recorded file in OXYGEN Viewer. Therefore, the last recorded measurement file will automatically be opened right after recording stop in the OXYGEN Viewer. OXYGEN can then be used for the next measurement, while the last recording can be analyzed.

Button, to open the recorded file right after recording stop

Fig. 125 Button, to open the recorded file right after recording stop

Number

  • Counter, Local: this counter is persistent, meaning it will continue to increase also after OXYGEN or the whole system will be restarted. This counter can be reset by entering a desired number (e.g. 0) in the field for the Local Session Counter, see Fig. 122.

  • Counter, Session: this counter is dependent on the OXYGEN session and will increase every time a new measurement is started. It will be reset if OXYGEN is closed and started again.

  • Counter, Custom: this counter is a custom counter and must be adjusted manually to increase.

It is also possible to enter individual text in the text field. With these options it is possible to configure an individual name for standard or advanced use.

The filename preview shows the result of the configured file name.

Startup Settings

Startup Behaviour settings

Fig. 126 Startup Behaviour settings

The user can select if the default setup file, an empty setup file, the last setup file or a user defined setup file shall be opened when OXYGEN is started (see Fig. 126).

Advanced settings

Advanced settings

Fig. 127 Advanced settings

  • Instruments: In the Instruments section, DejaViewTM can be enabled/disabled. By default, DejaViewTM is always enabled. For a detailed description of DejaViewTM refer to DejaView™.

  • Freeze Buffer: The minimum and maximum duration of the freeze buffer can be changed manually here by entering a duration of 0-100 s. By default, the length of the buffer depends on the set sample rate and varies between 1-20 s. WARNING: A manual increase of the freeze buffer leads to a higher load of the main memory. Change with caution! If decreasing the memory consumption is necessary, lower the maximum duration of the freeze buffer.

  • System Time Synchronization: If an IRIG or GPS signal is received via a TRION-BASE (IRIG only), TRION-TIMING or TRION-VGPS module and if this signal is used for synchronization, the system time of the PC OXYGEN is running on can be set to this timing signal. For synchronization with an external timing source, refer to Applying an external synchronization signal to the DEWE2/3 system. The synchronization interval can be selected below and the minimum time interval is 10 seconds.

Note

OXYGEN must be started with Administrator rights to use this function as this functionality changes the system settings of the PC. If OXYGEN is started without Administrator rights but this functionality is activated, the error message System time synchronization not allowed (see Fig. 128) will be displayed in the lower right corner of the software. note that this setting is not stored to a dms-setup file but only to the registry.

Error message *System time synchronization not allowed*

Fig. 128 Error message System time synchronization not allowed

Hardware

DAQ Hardware

DAQ Hardware settings

Fig. 129 DAQ Hardware settings

In the DAQ Hardware setup, the user can enable and disable the usability of different hardware series. For the detailed installing procedure of measurement hardware, refer to Hardware setup.

Amplifier / RS232 / RS485

Amplifier / RS232 / RS485

Fig. 130 Amplifier / RS232 / RS485

For more information, refer to Using EPAD2 with OXYGEN for EPADs and Using DAQP/HSI Modules with OXYGEN for DAQP/HSI modules.

Sensors

OXYGEN offers the possibility of a sensor database to hold all relevant information about the user’s sensors.

Sensor Database

Fig. 131 Sensor Database

The sensor database can be found in the System Settings and provides a comfortable user interface with familiar sub-menus.

To add a new sensor, click on the Add sensor button in the lower left corner (marked red in Fig. 131). The properties of the sensor are the same which are also available in the channel settings (for detailed explanation see Changing the channel settings). By clicking on the properties, a small pop-up window will appear as seen in Fig. 132 where the following parameters can be edited:

  • Name: name of the sensor

  • Serial No.: add the serial number of the sensor

  • Scaling: add channel scaling or sensitivity; also 2-point, table or polynomial scaling is available

  • Measurement Input Properties (required by the sensor)

    • Input mode: define the input mode which is required by the sensor; choose between Voltage, Current, Bridge, Resistance, Potentiometer, Temperature and IEPE

    • Input Type: define the input type (depending on the input mode the input type varies)

    • Input range: define the input range (depending on the input mode the input range varies)

    • Excitation: choose excitation (off, Voltage, Current) and corresponding value

    • LP Filter: add optional lowpass filter, define the frequency, order (2, 4, 6, 8) and type (Bessel or Butterworth)

    • Coupling: choose coupling mode

    • And Bridge-Input Specific Settings

    Sensor database – pop-up window to change channel scaling

    Fig. 132 Sensor database – pop-up window to change channel scaling

To duplicate or remove a sensor simply click on the respective sensor and on the Duplicate or Remove button as marked red in Fig. 131.

By clicking on + Advanced (see Fig. 133) in the parameter bar the advanced menu will open, and more properties can be added:

  • Bridge resistance

  • Bridge Sensor Offset

  • Bridge Shunt Target

  • Shunt Resistance

  • RTD Sensor Type

    Sensor database – open advanced menu

    Fig. 133 Sensor database – open advanced menu

To apply a sensor to a channel, proceed with the following steps:

  • Enter the channel settings by clicking on the little gear of the individual channel in the channel list (pushbutton ⑪ in Fig. 152 or Table 7, for details see Changing the channel settings in the channel setup).

  • Click on the Choose sensor button in the upper right corner, seen in Fig. 134.

    Applying a sensor to a channel in the channel settings

    Fig. 134 Applying a sensor to a channel in the channel settings

  • A pop-up window will appear with a list of all defined sensors seen in Fig. 135.

  • Choose the desired sensor and click OK. The search field might ease the search for a specific sensor in the list.

    Pop-up window to apply a sensor for a channel in the channel settings

    Fig. 135 Pop-up window to apply a sensor for a channel in the channel settings

  • The parameters of the sensor will be applied on the channel. This can be recognized by the name of the sensor, which will be displayed in the channel settings and in the channel, list seen in Fig. 136.

  • To remove an applied sensor from a channel simply click on the X button next to the sensor name in the channel settings (see Fig. 136).

    Name of chosen sensor for the channel seen in the channel list and channel settings

    Fig. 136 Name of chosen sensor for the channel seen in the channel list and channel settings

Note

  • Only analog sensors are supported in the database (no encoder).

  • Whenever the database is changed, the sensors on the assigned channels do not update automatically and must be assigned again.

  • An .xml file will be created with the sensor information, which can also be edited externally in a third-party software.

    The name of the xml-file is sensor_db.xml and can be found in the following directory: %PUBLIC%DocumentsDewetronOXYGEN.

Remote control

If remote control is enabled, the Lock Screen button will change to a Remote Control indicator and marks if OXYGEN is controlled by remote (see Fig. 137).

*Remote Control* indicator

Fig. 137 Remote Control indicator

SCPI over Ethernet

Remote Control – SCPI over Ethernet menu

Fig. 138 Remote Control – SCPI over Ethernet menu

OXYGEN can be controlled by remote via SCPI. To do so, the Enable remote control button (see Fig. 138) must be switched on and SCPI over Ethernet must be enabled.

For detailed instructions and programming examples, refer to the manual OXYGEN Remote Control-SCPI Version Vx.x which is available on the DEWETRON CCC portal (https://ccc.dewetron.com/).

For additional information about typical performance and other basic points, refer to Table 6.

XCP over Ethernet

Note

This is an optional feature and requires a license.

OXYGEN can be controlled via XCP over Ethernet. To do so, the Enable remote control button must be switched on and XCP over Ethernet must be enabled (see Fig. 139).

Remote Control – XCP over Ethernet menu

Fig. 139 Remote Control – XCP over Ethernet menu

Within OXYGEN, the following XCP settings can be edited:

Configuration for XCP over Ethernet

Fig. 140 Configuration for XCP over Ethernet

  • Communication Type: TCP server or UDP server

  • IP address of the OXYGEN device

  • Port Number

  • Output format: Double (64bit) or Float (32bit)

  • A2L File Path: The path the a2l-file is stored to. An a2l-file is automatically generated when XCP remote control is enabled and when OXYGEN is started

  • XML File Path: The path the xml-file is stored to. A xml-file is automatically generated when XCP remote control is enabled and when OXYGEN is started

Note

Be aware that the directory C:/Temp the a2l-file and the xml-file is stored to is not created automatically. Create the directory C:/Temp manually or change the path to an existing directory.

A user instruction to setup a remote control via CANape can be found in the document DEWETRON_OXYGEN_XCP_User_Instructions_Vx.x which is available on the DEWETRON CCC portal (https://ccc.dewetron.com/).

For additional information about typical performance and other basic points, refer to Table 6.

Usage SCPI and XCP simultaneously

It is possible to use the SCPI and the XCP plugin both simultaneously. Just enable both plugins and follow the instructions for SCPI from SCPI over Ethernet and the instructions for XCP in XCP over Ethernet.

As stated above, detailed and latest user manuals for both plugins are available on the DEWETRON CCC portal:

For detailed SPCI instructions and programming examples, refer to the manual OXYGEN Remote Control-SCPI Version Vx.x which is available on the DEWETRON CCC portal (https://ccc.dewetron.com/).

A user instruction to setup a remote control via CANape can be found in the document DEWETRON_OXYGEN_XCP_User_Instructions_Vx.x which is available on the DEWETRON CCC portal (https://ccc.dewetron.com/).

Streaming interfaces

EtherCAT slave

Note

This is an optional feature and requires a license.

Using the EtherCAT slave subsystem, an OXYGEN system is able to provide timestamped periodic measurement values to an EtherCAT master. The most important control features as well as some status information are provided as well.

OXYGEN EtherCAT functionality currently only supports TRION-ETHERCAT boards.

For detailed instructions, refer to the manual OXYGEN EtherCAT Slave Vx.x. which is available on the DEWETRON CCC portal (https://ccc.dewetron.com/).

For additional information about typical performance and other basic points, refer to Table 6.

Data stream plugin

Note

This is an optional feature and requires a license.

The OXYGEN Data Stream plugin provides the following features:

  • High Speed data access

  • Efficient raw data transfer

  • Multi data stream support

  • Multi network port support

  • Configurable via SCPI

Data stream plugin – overview

Fig. 141 Data stream plugin – overview

For detailed instructions and programming examples, refer to the manual OXYGEN DataStream Plugin Vx.x which is available on the DEWETRON CCC portal (https://ccc.dewetron.com/).

For additional information about typical performance and other basic points, refer to Table 6.

Ethernet sender plugin

Note

This is an optional feature and requires a license.

Pop-up window to create an Ethernet sender

Fig. 142 Pop-up window to create an Ethernet sender

An Ethernet sender can be created and configured by pressing the Add button in the lower left corner of the Data Channels menu (marked red in Fig. 273).

For details about the Ethernet Sender plugin refer to the DEWETRON_OXYGEN_Ethernet_Sender_Vx.x Manual which is available on the DEWETRON CCC portal (https://ccc.dewetron.com/).

Remote control and streaming interfaces

The following Table 6 provides an overview and comparison about the licensing, typical performance and other additional information of the different remote control and streaming interfaces.

Table 6 Remote control and streaming interfaces - overview

Interface option

Included in OXYGEN

Interface

Typ. application

Typ. performance

SCPI

Yes

Standard Ethernet

Fetching of actual values loading setup, application control, application

~50 S/s with 50 channels; up to 10 kS/s with 10 channels (buffered reading “ELOG”)

XCP Slave

License required

Standard Ethernet

Stream of measurement values, basic recording control; only compatible with CANape yet; INCA compatibility is in progress

~10 kS/s with 8 channels

EtherCAT

License required

TRION EtherCAT

EtherCAT testbed environment; Provide measurement values on the EtherCAT bus with PDO mechanism

~400 S/s with 100 channels

Data Stream

License required

Standard Ethernet

Live processing of raw and full speed data in 3rd party application; uses native TCP/IP sockets for data transfer; multiple streams can be created

~100 kS/s with 350 channels or ~2 MS/s with 12 channels

Ethernet Sender

Plugin required

Standard Ethernet

Send actual and synchronized data with timestamps

1-100 Hz

Typical I/O delay is 100-200 ms within all interface options

User Interface

Localization

Localization – settings

Fig. 143 Localization – settings

In the Localization menu, the user can change the software language, set the software time to UTC time as well as change the time format and switch between the temperature units Celsius and Fahrenheit.

UI Options

UI Options – settings

Fig. 144 UI Options – settings

In the UI Options, the user can change different settings of the UI appearance:

  • UI mode will change the size of the icons and adjust it for different PC types

  • Style will change the menu style

  • Color Scheme will change the color scheme of the software. A light and a dark mode are available.

  • Show touch keyboard regulates the appearance of a touch keyboard

  • Text size changes the text size in OXYGEN

  • Sidebar position: If Left side is selected, the sidebars will swap and the Reset button will set the menu order to the default order if changes have been made. For customizing the menu order, refer to Custom ordering of menu locations.

  • Channel setup: Edit highlighted row only: When this option is selected and the user selects a channel in the Channel Setup, the selected channel will only be highlighted when the user clicks on the channel name and a second click for changing the channel name is necessary. When this option is NOT selected, the user will be able to change the channel name by a single click on the channel name.

Advanced Graphics

Advanced graphics – settings

Fig. 145 Advanced graphics – settings

In this section the user can change the graphic framework, if there any problems with the graphic occurred. Contact us for more information or any help.

System Information

Component Version

Component Versions – overview

Fig. 146 Component Versions – overview

In this section the versions of all components and 3rd party licenses are displayed.

Errors and Warnings

Errors and warnings

Fig. 147 Errors and warnings

This menu displays all raised errors and warnings as a list with time stamps.

Plugin Overview

Plugin overview

Fig. 148 Plugin overview

This menu displays an overview of all active plugins. These cannot be deactived.

License

License overview

Fig. 149 License overview

Here you can find some information about the license and the active features. Additionally, the license can be updated by clicking on the Update… button and selecting the new license file. OXYGEN must be restarted. To remove the current license, click on Remove…, OXYGEN will switch into the Evaluation mode.

Note

A license file for OXYGEN 5.x is not valid for OXYGEN 6.x

Shutdown

System settings *Shutdown* – overview

Fig. 150 System settings Shutdown – overview

In the Shutdown menu, the user can terminate OXYGEN and return to the operating system or shut down the whole system.