Skip to main content
Skip table of contents

Light control

Lighting control is a key component for reliable image acquisition. Using evoVIU in combination with VISIONWEB, different lighting sources can be controlled depending on the configuration. Both internal modules, such as the integrated Loxi lighting systems, and external lighting units connected via digital I/O are available. This flexible control allows lighting intensity, flash behavior, and switching cycles to be optimally adapted to the respective application. This ensures the appropriate illumination regardless of the environment and object surface – the basis for precise and reproducible image processing.

External lighting

Different lighting variants can be controlled via PIN 2 and PIN 4 using the 5-pin M12-A coded connector. The respective outputs can be specifically activated and configured in VISIONWEB. The following section explains this in more detail using a Balluff lighting module as an example.

Example: Baluff ring light https://www.balluff.com/de-de/products/BAE00AN?pf=F05603
Assignment: Pin 1: 24VDC, 2: Boost, 3: GND, 4: Trigger

If the light's trigger is set to high, the light is activated; if set to low, it is turned off. The boost function generates a light pulse that is up to 1.7 times stronger. In the VISIONWEB workflow, the corresponding control is structured as follows:

image-20250930-093425.png

The output trigger controls the lighting's on and off. When the output is activated, the light turns on; after image acquisition, it is automatically deactivated again. For this purpose, the Digital Write components for PIN 4 (trigger) and PIN 2 (boost), as well as a camera, were created. For details, see Digital Input / Output If the boost is to be used, it can be set either before or after image acquisition.

image-20250930-093603.png

As with all examples, the following applies here too: You can flexibly adapt the boost, or the pin control in general, to your requirements. For example, it can be individually controlled via a communication interface by setting an appropriate Boolean value depending on the situation. There are virtually no limits to your wishes and application scenarios.

Congratulations – you can now control your external light source directly from the workflow.

Pulsed Lighting / Strobe

Pulsed light control is not yet available in the current version. This feature is expected to be implemented with the update in early January. However, please feel free to contact us if you need it—beta versions are usually released early.

Internal lighting

With the Loxi light modules 1, 2, and 3, evoVIU offers the possibility of operating internal lighting for both organic and metallic objects. These light sources can generally be configured and controlled directly via the image source. (https://evopro.atlassian.net/wiki/spaces/DVIU/pages/123800167)

Sometimes it's necessary to control the lighting directly via VISIONWEB, for example, if you want to specify a different lighting pattern for each variant. This can be done as follows:

  1. Under Components, you can create a light component called "Loxi Light." In our example, we'll create two light sources, each with a different configuration.

image-20250930-110004.png
  1. Each lighting component can be individually configured. The desired current values ​​are specified in the respective segments and activated as needed.

image-20250930-114735.png

The current values ​​are controlled in 25 mA increments due to the driver and can be set up to a maximum of 100 mA per light module. Please note, however, that the total current consumption must not exceed 800 mA.

Staring directly into the light for too long—especially with the Loxi 1—can cause glare. Therefore, always ensure the light source is correctly aligned and that uninvolved employees are not accidentally blinded.

The following current values ​​can be set per segment: 0, 25, 50, 75, 100, 125, or 150 mA. Different recommendations apply depending on the Loxi module:

  • Loxi 1: 0, 25, 50, 75 mA – distributed across one LED per segment

  • Loxi 2: 0, 25, 50, 75, 100 mA – distributed across three LEDs per segment

  • Loxi 3: 0, 25, 50, 75, 100, 125, 150 mA – distributed across five LEDs per segment

Segment distribution

Loxi 1

Loxi 2 & Loxi 3

Loxi 1 controls one LED per segment, which is arranged in a ring around the lens.

Loxi 3 has two more LEDs per segment than Loxi 2, but the segment layout remains identical.

  1. The light module can then be turned on or off using the "Turn On Lights" and "Turn Off Lights" nodes. To do this, search for "Turn On Lights" in the context menu and insert the node into the event graph.

image-20250930-120249.png

  1. Image capture occurs between the "Turn On Light" and "Turn Off Light" nodes. Use the Grab Image node with the desired camera configuration.

image-20250930-120654.png

Congratulations – you can now control your internal light source directly from the workflow.

Variant-dependent lighting control

Depending on the situation, one of the two created lighting modules can be used. A Select node can be used to define which instance is activated. The workflow decides which lighting module is used based on the input parameters.

image-20250930-122305.png

The example shows a TCP connection. Upon receiving a JSON telegram with the "UseLightA" parameter, the light pattern to be used is determined for each image. This allows for a high degree of flexibility in the workflow.

The control becomes even more flexible through the use of enums. In practice, however, the ShapeFromShading function is generally not controlled externally. The following example merely illustrates that four segments can be addressed sequentially – for example, to specifically test different variants.

image-20250930-123409.png

Congratulations – you can now control your internal light source variant-dependently.

Dynamic control of light

The lighting settings can now be dynamically adjusted at runtime. The nodes "Turn On Lights With Intensity" and "Turn On Loxi" can be used together with the component "Loxi Light" for this purpose.

Turn On Lights With Intensity

This node allows you to configure the light settings very quickly, as the attributes relate to the light in general.

Parameter set

Attribute

Type

Description

Light

I Light, I Loxi Light

The corresponding component in the workflow for mapping the installed light.

Intensity

Int32

Sets the intensity of the light for the entire light range to the corresponding percentage value between 0 and 100.

Turn On Loxi

This node allows you to individually configure the Loxi. The Loxi is divided into different segments based on the arrangement of the LEDs. The Turn On Loxi node enables users to fill the individual sections with different values ​​to achieve optimal illumination for the next processing steps.

Parameter set

Attribute

Type

Description

Loxi

I Loxi Light

The corresponding component in the workflow for mapping the installed Loxi.

Intensity (Segment 1.1)

Int32

Set the light intensity for the selected area of ​​the Loxi to a percentage value between 0 and 100.

Intensity (Segment 1.2)

Int32

Set the light intensity for the selected area of ​​the Loxi to a percentage value between 0 and 100.

Intensity (Segment 2.1)

Int32

Set the light intensity for the selected area of ​​the Loxi to a percentage value between 0 and 100.

Intensity (Segment 2.2)

Int32

Set the light intensity for the selected area of ​​the Loxi to a percentage value between 0 and 100.

Intensity (Segment 3.1)

Int32

Set the light intensity for the selected area of ​​the Loxi to a percentage value between 0 and 100.

Intensity (Segment 3.2)

Int32

Set the light intensity for the selected area of ​​the Loxi to a percentage value between 0 and 100.

Intensity (Segment 4.1)

Int32

Set the light intensity for the selected area of ​​the Loxi to a percentage value between 0 and 100.

Intensity (Segment 4.2)

Int32

Set the light intensity for the selected area of ​​the Loxi to a percentage value between 0 and 100.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.