mvIMPACT Acquire SDK GUI Applications
mvIPConfigure

mvIPConfigure is meant to allow the configuration of the network behaviour of GigE Vision™ compliant devices. With mvIPConfigure it is possible

  • to assign a user defined name to a GigE Vision™ compliant device
  • to change its IP address behaviour
  • to find and fix incorrectly configured (e.g. wrong IP address) GigE Vision™ compliant devices
Note
Windows: Given that during the start mvIPConfigure searches the network for GigE Vision™ devices, it could be possible that - depending on the Windows firewall settings - a Windows security alert appears. Please click on "Unblock" or "Allow Access" depending on the version of Windows you are working with so that the program works properly.
Windows security alert

A GigE Vision™ compliant device can be configured to

  • use a persistent IP address (if supported by the device) or
  • use DHCP to obtain an IP address

Since the GigE Vision™ standard requires LLA to be enabled at all times the "Use LLA" control will never become modifiable.

Every GigE Vision™ compliant device must use the following IP protocol selection algorithm:

GigE Vision™ - IP protocol selection sequence
Note
Pressing F1 will display a little dialog containing some usage hints as well as a list of available command-line parameters.

Configure A GigE Vision™ Device

A GigE Vision™ device can be configured using this application as follows.

mvIPConfigure - Start window
  1. Start mvIPConfigure by clicking the program in the start menu.
  2. When started select the device you want to configure from the list on left side of the tool.
  3. Click on the "Configure" button.
    Now every feature that is supported by the device and that can be modified will become enabled.

    mvIPConfigure - Device Properties

  4. When the device shall use a persistent IP address not only check the check box "Use Persistent IP" but also enter all the required data into the text controls in the group box "Persistent IP address".
    Note
    In order for the device being correctly detected in the network with the new IP address, please power-cycle the device after applying the changes in the next step.
  5. To write the changes to the device click on "Apply Changes" button. To discard the changes made in the GUI controls either close the application, select another device or click anywhere in the device list.
Attention
If you use multiple GigE Vision™ devices connected to separate network adapters in a single host system, make sure to use different subnets.

Assign A Temporary IPv4 Address

It is also possible to assign a temporary IP address to a certain device with a known MAC address via the "Action" menu item.

Note
This even works if the device currently is NOT detected by the application due to incorrect network configuration! It makes use of the FORCE_IP command specified by the GigE Vision™ standard.
  1. Select the "Action" menu item and click on "Manually Assign Temporary IPv4 Address".

    mvIPConfigure - Action menu

    A dialog opens, where the desired network details can be entered.

    mvIPConfigure - Temporary IP dialog

  2. Click on "Execute" button.
    The device will now use this data until power-cycled or until it is assigned a different IP address.

Recover An Incorrectly Configured GigE Vision™ Device

Because of the activated setting "Use Advanced Device Discovery", by default incorrectly configured GigE Vision™ compliant devices will be listed within mvIPConfigure even if the IP address does not match the local network.

mvIPConfigure - Incorrectly configured device

Just select the device and configure it as described in Configure A GigE Vision™ Device.

View Potential Performance Issues

Right-clicking on any device will allow to view potential performance issues as well as a suggestion on how to resolve them:

mvIPConfigure - Potential Performance Issues

Various Auto-Configuration Options

mvIPConfigure provides various ways to automatically assign a matching IPv4 address to a device currently not configured correctly for the NIC(network interface card) it is connected to:

mvIPConfigure - Incorrectly configured device

Detecting Devices Residing In A Different Subnet

By default devices residing in different subnets will not be discovered as the standard discovery mechanism uses broadcasts into the local subnet. Therefore devices residing in different subnets will not show up without additional configuration since broadcasts don't cross routers thus are not forwarded into different subnets.

Note
To discover devices residing in different subnets the IPv4 address of these devices must be known upfront.

Using mvIPConfigure's "Setup Unicast Device Discovery Destinations" dialog allows to specify the known IPv4 address of each device which shall be discovered in a different subnet.

  1. Select the "Action" menu item and click on "Set Up Unicast Device Discovery".

    mvIPConfigure - Action menu

    A dialog will open, where the destination IP addresses of the devices to be discovered can be entered.

  2. Select the interface through which the devices in the different subnet will be reachable by using the "Interfaces" drop-down menu. This interface must be able to reach the target subnet of course so has to be connected to the corresponding router and/or switch.

  3. Enter the IPv4 addresses of devices which shall be discovered.

    Note
    Once the desired IPv4 addresses have been entered the "Discover" button can be used to detect those devices. If a device is found the corresponding row in the grid will be marked in green and the serial number of the discovered device will show up in the discovered column. If a device is NOT showing up make sure the IPv4 address you have entered is correct and the interface selected for detection is actually capable of reaching the desired subnet.
    mvIPConfigure - Setup Unicast Device Discovery Destinations

  4. Click on "Apply" button.
    The dialog will be closed and mvIPConfigure as well as every other application using the mvIMPACT Acquire driver stack will be able to discover and use devices at the previously entered IP addresses.
mvIPConfigure - Device discovered in a different subnet

To modify the settings the dialog can be used. To disable the device discovery in different subnets just select the correct interface and clear the table using the "Clear" button.

Note
The settings for detecting devices in different subnets will be permanent for every application using mvIMPACT Acquire on the given system. There is also a set of API properties that can be used to implement the same behaviour. In fact mvIPConfigure uses this API internally. To implement this in your own application have a look at the InterfaceModule class. The properties starting with mvUnicastDeviceDiscovery will provide the required features.

Command-line Interface

mvIPConfigure supports various command-line parameters to allow various IP setup related configurations without the need of user interaction.

The following table lists the available command-line parameters:

Parameter Description
device or d Selects a serial number of a device for configuration.
forceAutoConfigureDHCP or facd Configures devices using misconfigured IP addresses connected to the adapter specified by a wildcard to use DHCP mode. If no wildcard is specified every detected misconfigured device will be configured to use DHCP mode. (syntax: <Adapter IP address wildcard>).
forceAutoConfigurePersistent or facp Assigns automatically a persistent IP address to devices connected to the adapter specified by a wildcard. If no wildcard is specified every misconfigured device will set up for a persistent IP address. (syntax: <Adapter IP address wildcard>).
hidden Will start the application without showing the splash screen or the application window. This might be useful when doing a silent configuration in combination with the 'quit' parameter.
log_file='file_name' or lf='file_name' Specifies a log file storing the content of this text control upon application shutdown.
persistentIPAddress Defines a persistent IP address for the device currently selected(value syntax: <interface index>;<value>).
persistentSubnetMask Defines a persistent subnet mask for the device currently selected(value syntax: <interface index>;<value>).
persistentDefaultGateway Defines a persistent default gateway for the device currently selected(value syntax: <interface index>;<value>).
quit or q Terminates the application automatically after all the configuration has been applied.
useDHCP Enables/disables the usage of DHCP for the device currently selected(value syntax: <interface index>;<value>).
userDefinedName or udn Sets a user defined name for the device currently selected.
usePersistentIP Enables/disables the usage of a persistent IP address for the device currently selected(value syntax: <interface index>;<value>).

Examples

mvIPConfigure device=GX000066 usePersistentIP=0;1 persistentIPAddress=0;172.111.2.1 persistentSubnetMask=0;255.255.255.0 persistentDefaultGateway=0;172.111.2.2 quit

Will configure interface 0 of the specified device to use a certain persistent IP configuration.

mvIPConfigure forceAutoConfigurePersistent=192.168.* quit

Will automatically enable persistent IPv4 address acquisition for all devices with an incorrect network setup on Ethernet adapters with an IP address matching the value after the '=' character and will terminate the application automatically afterwards.

mvIPConfigure facd=192.168.1.* quit

Will automatically enable DHCP address acquisition for all devices with an incorrect network setup on Ethernet adapters with an IP address matching the value after the '=' character Both 'force*' parameters will only apply to misconfigured devices utilizing a persistent IP address and the 'Auto-fix Invalid Network Configurations' option from 'Settings' menu is active.

mvIPConfigure facd=192.168.1.* hidden quit

Will do the same but without displaying any GUI.

Note
Pressing F1 after the application is running will also display a detailed list of available command line options as well as keyboard shortcuts and some other helping text!