Requirements
- Power cable with 4-pin connector
- 24 V power supply
- Internet connection if software updates are desired
- For SSH login:
- 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
Power connector
4-pin power connector
|
| Pin | Function |
| +24V | 24 V power supply |
| RST | Reset input, low active |
| GND | Ground |
| PE | Earth / housing connection |
|
A 24 V power supply must be connected to the 4-pin power connector. The device will boot automatically into Linux after applying power.
The RST terminal can be pulled to GND to reset the VisionBox during operation. A falling edge will trigger the reset. Leaving the signal floating is the default mode for normal operation.
VisionBox Login
The following Linux login methods are available:
- DisplayPort monitor + USB keyboard
- Secure Shell - SSH (see section Network configuration)
- RS-232 UART: 115200 bps, 8-N-1
Two user accounts are pre-installed in the Linux system:
| User | Default password | Description |
| root | vision | Superuser account |
| visionbox | vision | Regular user account |
- Note
- We recommend changing the password for both accounts by using the shell command passwd.
- The DisplayPort interface doesn't support hot-plug, the monitor should be connected before power-on.
- Dual-mode DisplayPort (DP++) is not supported. Connecting a DVI or HDMI monitor requires active adapters.
Network configuration
The network interfaces are managed by the NetworkManager service. All interfaces (eth0...eth3) are 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 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 Image 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 VBAI2302000001.local
PING VBAI2302000001.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
The NetworkManager command line tools nmcli and nmtui can be used to configure the IP address.
It's also possible to assign a static IP address by modifying the file /etc/network/interfaces. NetworkManager does not manage interfaces defined in this file.
The following lines show an example for setting a static IP address for eth0:
# 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 can be modified to configure a DNS server manually, for example:
echo "nameserver 8.8.8.8" > /etc/resolv.conf
SSH login
For SSH login, the user name and the associated password are required. Defaults are shown in section VisionBox Login.
Linux host
The ssh program is typically used to login to a remote machine, for example:
The scp program (Secure Copy) can be used to copy files between machines, for example:
scp test.txt visionbox@192.168.115.203:/home/visionbox/
scp visionbox@192.168.115.203:/home/visionbox/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.