10. Valve Plugin

10.1. Introduction to Valve Plugin

The valve plugin is used to control QmixV valve modules or valves that are part of other devices (e.g. valves of Nemesys syringe pumps).

  1. CETONI QmixV valve modules

  2. valve devices that are part of other devices (i.e. valves mounted on Nemesys syringe pumps)

  3. supported valves from other manufacturers (e.g. VICI valves)

10.2. Valve Device List

The plugin mainly consists of the valve device list, which is displayed as a separate view in the graphical user interface.

Figure 1: QmixV valve device list

You can move the window to another position in the graphic interface at any time by dragging and dropping the title bar, or you can move it out of the interface to become a separate window.

The valve device list shows you all the available Qmix valve devices in tabular form. The name of the module and the actual valve position status icon is shown in the left-hand table column, and the right-hand column shows the name of the current position of the valve.

10.2.1. Editing valve names

You can change the name of a valve at any time and, for example, assign a name suitable for your particular application. You change a name by the following steps:

Figure 2: change valve name

  1. Double-click the table cell containing the name you want to change.

  2. Enter the new name in the Editing window which now appears (see Figure above)

  3. Complete your changes by pressing the Return key.

10.2.2. Switching valve position

You can also switch the valve position in the module list. For this purpose proceed as follows:

  1. Double-click in the table cell showing the valve position.

  2. Select the desired valve position in the selection box that now appears (see Figure below).

  3. Confirm the selection by pressing Return key or click on another table cell to close the selection box.

Figure 3: Switch valve position

The valve is now switched into the new valve position.

10.2.3. Naming valve positions

You can give each valve position an individual name in the software, and so configure the names of the valve positions to suit your application. Perform the following steps to change the names of the valve positions.

  1. Make a right mouse click in the line of the table of the valve for which you want to rename the positions.

    Figure 4: Open valve configuration

  2. Select the Configure valve positions… menu item in the context menu, that is being displayed.

  3. A configuration dialog opens (Figure below), which consists of a valve selection box and the list of valve positions .

    Figure 5: Open valve configuration

  4. Double click the line in the table containing the valve position you want to name.

  5. An Editing window opens in the table cell, in which you can enter the new name of the valve position.

  6. Confirm your entry by pressing the Return key.

  7. You can close the configuration dialog when you have named all the valve positions.

From now on, the valve positions will always be shown with the new names in all areas of the software.

10.3. Creating Valves

You can control CETONI valves via one or more digital outputs. If you have connected your valve to the corresponding digital outputs, you must configure it in the software.

The first step is to open the I/O channels window and manually switch the digital outputs to check that the valve is correctly connected and switching.

Figure 6: List of I/O channels - Test by manual switching of the digital outputs

Click on the LED in the column On at the corresponding channel to switch the digital channels off and on again. Check whether the valve is switched when switching the digital output. If the valve is not switched, it is either connected incorrectly or you are switching the wrong output. If the valve switches, you can continue creating the valve in the software.

To do this, right-click in the list of valves and then select Create Valve from the context menu.

FFfFigure 7: Open dialog for valve creation

The dialog for creating and configuring a valve is now displayed.

Figure 8: Dialog for valve creation and configuration

In the window, first select the type of valve you have connected in the field Valve Type . Then you must configure the digital outputs for the valve in the Dig-Out Channels table. Depending on the valve type, these can be one or more outputs. To configure an output, double-click in the table cell for this channel and then select the corresponding digital output from the list. The OK button is only activated when the corresponding digital output channel has been configured for each switching input of the valve. You can then complete the configuration by clicking OK.

The newly created valve now appears in the list of valves. Valves created with the Create Valve function get the prefix DO_ to indicate that they are valves controlled by digital outputs.


Valves created with the Create Valve function can be identified by the prefix DO_ in the valve list.

10.4. Deleting Valves

Valves that you have created dynamically in the software, e.g. with the Create Valve function (see previous section), can be deleted from the valve list via the context menu. To do this, right-click on the line of the valve you want to delete and then select the Delete Valve menu item.



Valves created and configured with the Device Configurator, or that are part of other devices, cannot be deleted with Delete Valve menu item.

10.5. Valve Script Functions

Figure 10: Qmix valve script functions

The Qmix valve plugin contains a script function for switching the Qmix valves from a script.

10.5.1. Switch Valve


You use this function to switch the valve position. In the configuration area of this function, you can select the valve device , and the target position to which the valve is to be switched. The preview image visualizes the selected target position .


Both selection boxes support the use of variables. That means, in the device selection box you can use a variable that contains a valve device reference. In the target position selection box you can use a script variable that contains a target position index.

The following example shows a script, that creates two variables . The $ProcessValve variable stores the device reference to valve device Valve_0. The $RefillPosition variable stores the valve target position for syringe refill.


These variables are then used in the Switch Valve script for the Valve and Target Position definition.

10.6. Supported VICI Valves

The Valve Plugin supports VICI valves that use a universal actuator with a USB or RS-232 interface.


If you are using a valve with the RS-232 interface you might experience problems with the communication if you connect the valve directly to a physical RS-232 port on your PC.

Use a USB-to-serial adapter instead to connect the valve via USB to you PC!


The following list shows all types of VICI valves that are supported by the software:


10 Position dead-end selector (SD) valve (e.g. low pressure, high pressure)


6 Position dead-end selector (SD) valve (e.g. low pressure, high pressure)


6 Port injector valve (e.g. GC injectors, HPLC injectors)