VisionSensor Linux  2025-09-19
Getting started

Requirements

  • 8-pin power and I/O cable
  • 24 V power supply
  • Ethernet connection between host and device (through Ethernet switch or directly attached)
  • A Windows or Linux host with a terminal program like ssh, MobaXterm or PuTTY
  • Internet connection if software updates are desired

IMAGO also offers the following accessories for the VisionSensor PV:

  • I/O cable with terminal block (break-out adapter for easy installation and testing)
  • M12 Ethernet cable with RJ-45 plug
  • Plug-in power supply

Power and I/O connector

A 24 V power supply must be connected to the 8-pin power and I/O connector. The device will boot automatically into Linux after applying power.

The following table shows the pin assignment of the connector:

I/O connector
PinFunctionWire color
1Power supply (+24V)white
2Power supply GNDbrown
3Digital IN0green
4Digital IN1yellow
5Digital OUT3gray
6Digital OUT0pink
7Digital OUT1blue
8Digital OUT2red

VisionSensor I/O Expansion module

The VisionSensor I/O Expansion is a DIN rail module which can be connected to the 8-pin Power and I/O cable of the VisionSensor PV3. It provides additional I/Os and implements IMAGO's Real-Time Communication Controller.

The I/O Expansion module provides power to the VisionSensor. The digital I/O signals between both devices are used for internal communication and for transmission of trigger signals.

A standard M12-8 A-coded extension cable up to 20 meters can be used to allow long distance between the Vision Sensor and the I/Os.

A 4-pin 3.5 mm terminal header is used to provide power to both devices:

I/O Expansion: 4-pin power connector

VisionSensor login

The following Linux login methods are available:

Two user accounts are pre-installed in the Linux system:

UserPasswordDescription
root vision Superuser account
visionsensor vision Regular user account
Note
We recommend changing the password of both accounts by using the shell command passwd.

Network configuration

The network interface of the VisionSensor is configured for DHCP by default.

If no DHCP server is present, the device will fall back assigning a link-local IPv4 address after some time. The link-local address for IPv4 is in the range 169.254.0.0/16.

Note
  • In order to access a device with a IPv4 link-local address, the host must also be configured to use a link-local IPv4 address.
  • Windows will automatically fall back to a link-local IPv4 address if no DHCP server is answering the request. So a device can be connected directly to the Windows host if both have DHCP enabled.
  • A link-local address is always assigned for the IPv6 protocol (fe80::/10) and can always be used if IPv6 is enabled for the host (see Device access via mDNS name).

VIBFinder tool

IMAGO's VIBFinder tool for Windows can be used to discover the device on the local network by using the SNMP protocol:

VIBFinder tool
VIBFinder tool

VIBFinder 2 supports the following additional features:

  • Support for discovery using the GigE Vision Control Protocol (GVCP)
    (requires installed package gige-discovery-reply on the device)
    • Finds devices in different subnets
    • Support for updating the IPv4 configuration
  • Support for Linux Backup and Recovery

Please visit the IMAGO Download Portal for the latest version.

Device access via mDNS name

Instead of using the device's IPv4 address, it's also possible to establish a connection by using the mDNS host name. The name consists of the device's serial number in the domain .local.

Example:

~# ping VSPV2209103853.local
PING VSPV2209103853.local (192.168.115.203) 56(84) bytes of data.
64 bytes from 192.168.115.203: icmp_seq=1 ttl=64 time=0.020 ms
64 bytes from 192.168.115.203: icmp_seq=2 ttl=64 time=0.045 ms
64 bytes from 192.168.115.203: icmp_seq=3 ttl=64 time=0.047 ms
Note
  • mDNS is supported since Windows 10. Linux hosts require the libnss-mdns package.
  • mDNS may resolve the name to a IPv4 or IPv6 address.

Static IPv4 address configuration

A static IP address can be assigned by modifying the file /etc/network/interfaces. This can also be accomblished by using the RS-232 Linux console login.

The file shows some commented lines for setting a static IP address:

# DHCP configuration
# ------------------
auto eth0
iface eth0 inet dhcp
# Static IP configuration
# -----------------------
#auto eth0
#iface eth0 inet static
#address 192.168.1.2
#netmask 255.255.255.0
#gateway 192.168.1.1

When using a static IP address, the file /etc/resolv.conf.tail can be created to configure a DNS server, for example:

echo "nameserver 8.8.8.8" > /etc/resolv.conf.tail

SSH login

For SSH login, the user name and the associated password are required. Defaults are shown in section VisionSensor login.

Linux host

The ssh program is typically used to login to a remote machine, for example:

ssh root@192.168.115.203

The scp program (Secure Copy) can be used to copy files between machines, for example:

scp test.txt visionsensor@192.168.115.203:/home/visionsensor/
scp visionsensor@192.168.115.203:/home/visionsensor/test.txt .

Windows host

There are many programs implementing the SSH protocol. We recommend MobaXterm, which also supports copying files and a X11 server for running remote applications with display output.

Recent Windows versions also provide the optional feature OpenSSH-Client. It contains the command line tools ssh and scp, similar to Linux.

ViewIT Web GUI

The ViewIT software provides access to the VisionSensor by using a web browser. The framework gives access to the sensor's live view, acquisition parameters, digital I/Os and allows using self-designed image processing algorithms.

ViewIT is not part of the basic Linux image, but is normally pre-installed on delivery of new devices.

ViewIT gets installed as Linux service named viewit. Depending on the configuration, the service may be enabled or disabled after booting the system. If the ViewIT package is installed, the state will be shown during console login:

Linux VSPV22031GA583 4.19.35-visionsensor-pv3-1.2.2.0 #124 SMP PREEMPT Mon Feb 12 15:10:28 CET 2024 aarch64
The programs included with the Debian GNU/Linux system are free software;
the exact distribution terms for each program are described in the
individual files in /usr/share/doc/*/copyright.
Debian GNU/Linux comes with ABSOLUTELY NO WARRANTY, to the extent
permitted by applicable law.
Last login: Tue Feb 13 11:20:39 2024 from 192.168.115.52
Note: The ViewIT web application is running.
Use 'systemctl stop viewit' to stop it temporarily.
Use 'systemctl enable/disable viewit' to control automatic start.
root@VSPV2209103853:~#

In this example, ViewIT is installed and running. It can be stopped manually by running the command 'systemctl stop viewit'.

Note
If the viewit service is running, other processes are not able to use the VisionSensor interfaces with the VIBInterface and the FGCamera libraries.

After entering the device's IP address into the address field of a web browser, the main screen appears:

ViewIT main page
ViewIT main page

Note
Using the mDNS host name in a browser for accessing ViewIT may cause problems because of delays during the name resolution process.

The software documentation can be downloaded from the device by selecting the Help menu.