|
VisionCam XM Linux
2023-11-13
|
|
|
VisionCam XM Linux
2023-11-13
|
|
IMAGO also offers the following accessories for the VisionCam XM:
A 24 V power supply must be connected to the 17-pin power and I/O connector. The device will boot automatically into Linux after applying power.
The following table shows the pin assignemnt of the connector:
IO connector |
|
The following Linux login methods are available:
Two user accounts are pre-installed in the Linux system:
| User | Password | Description |
|---|---|---|
| root | vision | Superuser account |
| visioncam | vision | Regular user account |
The network interface of the VisionCam 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.
IMAGO's VIBFinder tool for Windows can be used to discover the device on the local network by using the SNMP protocol (IPv4 only):
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:
Example: VCXM2209000711.local
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:
When using a static IP address, the file /etc/resolv.conf.tail can be created to configure a DNS server, for example:
The service dhcpcd copies the file contents to the generated file /etc/resolv.conf.
For SSH login, the user name and the associated password are required. Defaults are shown in section VisionCam login.
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:
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.
The ViewIT software provides access to the VisionCam XM / LM 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:
In this example, ViewIT is installed but not running yet. It can be started manually by running the command 'systemctl start viewit'.
After entering the device's IP address into the address field of a web browser, the main screen appears:
The software documentation can be downloaded from the device by selecting About and then clicking the following symbol:
The VisionCam EB is deliverd with the pre-installed Event-Based System (EBS) Web Interface software by default. EBS Web Interface provides access to the camera by using a web browser. The framework gives access to the sensor's live view, acquisition parameters, allows to record data, view data and visualize data.
EBS Web Interface gets installed as Linux service named EBWebGUI. Depending on the configuration, the service may be enabled or disabled after booting the system. The following systemctl commands can be used to control the service:
systemctl status EBWebGUI: show status information about the servicesystemctl enable EBWebGUI: enable automatic startsystemctl disable EBWebGUI: disable automatic startsystemctl start EBWebGUI: start the service manuallysystemctl stop EBWebGUI: stop the service manuallyAfter entering the device's IP address into the address field of a web browser, the main screen appears:
The installed Metavision Open Modules packages include examples for using the event based sensor. See Code Samples & Applications for an overview.
The following example shows how to build and run the metavision_hal_viewer example:
The x-y-t Event Viewer is a web page which can be used to load and display recorded events in a web browser (requires WebGL 2.0). Also take a look at recoded examples
The VisionCam EB comes with the Linux service metavision_imago_proxy for streaming sensor events to a Windows or Linux host. IMAGO provides HAL Plugins for Metavision to receive the event stream from the VisionCam. This enables easy evaluation and development of algorithms on a PC by using Prophesee's Metavision SDK.
The HAL Plugins are available at the IMAGO Download Portal: Metavision HAL Plugins
For Linux hosts, the plugins are provided as Debian packages which will install the required libraries into the default plugin search path (/usr/lib/metavision/hal/plugins/).
To make the camera visible for Metavision on Windows, the environment variable MV_HAL_PLUGIN_PATH must be created and point to the directory containing the DLL files for the HAL plugins.
Example for setting the environment variable in the Windows console:
See also: Prophesee - Camera Plugins Installation
The Metavision Studio software should detect the camera automatically.
Windows example:
For other tools like metavision_viewer, the user has to specify the Serial ID of the camera. The Serial ID can be discovered by using the metavision_platform_info tool.
Example using metavision_platform_info for device discovery on Windows:
Example for starting streaming with metavision_viewer using the Serial ID:
1.8.18