Software Configuration

You need to install GenICam™ 2.2.0 from the MATLAB installation. Do not use a later version – it must be version 2.2.0. Follow these steps.

Installing GenICam™ on Windows

Note that the installation process requires administrator privileges.

1. To install GenICam™, start MATLAB.

2. From within MATLAB, issue the following commands:

   cd([matlabroot '\toolbox\imaq\imaqextern']);
   installgenicam;

3. Restart MATLAB.

   This will install the GenICam software to the default directory, C:\Program Files\GenICam_v2_2. If you would like to specify a different directory, you can pass it as an argument to the installgenicam function. For example:

   installgenicam('C:\genicam');

4. On Windows, the environment variables should automatically be set as part of the installation. You can optionally check to ensure that the following environment variables point to the location where you installed GenICam. See the examples below.

Note   If you have a camera that requires a GenICam XML file on a local drive (most cameras do not), you should set MWIMAQ_GENICAM_XML_FILES environment variable to the directory of your choice, and then install the camera's XML file in that directory. However, most cameras do not require or use local XML files.

Windows Examples

GENICAM_CACHE_V2_2=C:\WINNT\Profiles\All Users\Application Data\GenICam\xml\cache

GENICAM_LOG_CONFIG_V2_2=C:\Program Files\GenICam_v2_2\log\config\DebugLogging.properties

GENICAM_ROOT_V2_2=C:\Program Files\GenICam_v2_2

PATH must contain:

C:\Program Files\GenICam_v2_2\bin\Win32_i86 or C:\Program Files\GenICam_v2_2\bin\Win64_x64 (depending on your architecture)

Ensure that the cache directory in your GENICAM_CACHE_V2_2 environment variable exists for GenICam to be able to use it.

You can test the installation by using the following command:

imaqhwinfo('gige')

and by looking at the relevant sections of the output when you run the imaqsupport function.

Installing GenICam™ on Linux

There is no automated installer for GenICam on Linux^®, but the files that need to be installed have been provided.

1. The files are located in:

   <matlabroot>/toolbox/imaq/imaqextern/drivers/<ARCH>/genicam

   These are tar files and you should extract them into a location of your choice.

2. After the files are extracted, configure environment variables.

   On Linux you need to set the environment variables manually. See the examples below.

   Also, you can configure them in your login files or on a system-wide basis so they persist.

Note   If you have a camera that requires a GenICam XML file on a local drive (most do not), you should set MWIMAQ_GENICAM_XML_FILES environment variable to the directory of your choice, and then install the camera's XML file in that directory.

Linux Examples

GENICAM_ROOT_V2_2=/opt/GenICam_2_2_0

GENICAM_CACHE_V2_2=~/.GenICam/xml/cache

GENICAM_LOG_CONFIG_V2_2=/opt/GenICam_2_2_0/log/config-unix/DebugLogging.properties

Note that you may need to create the .GenICam/xml/cache directory in your home directory. Also, this example assumes that you have un-tarred the files in the /opt/GenICam_2_2_0 directory.

LD_LIBRARY_PATH must contain:

/opt/GenICam_2_2_0/bin/Linux32_i86 or /opt/GenICam_2_2_0/bin/Linux64_x64 (depending on your architecture)

Ensure that the cache directory in your GENICAM_CACHE_V2_2 environment variable exists for GenICam to be able to use it.

You can test the installation by using the following command:

imaqhwinfo('gige')

and by looking at the relevant sections of the output when you run the imaqsupport function.

Installing GenICam™ on Mac^® OS X

There is no automated installer for GenICam on Mac OS X, but the files that need to be installed have been provided. They are located in:

<matlabroot>/toolbox/imaq/imaqextern/drivers/maci64/genicam/
     GenICam_Runtime_gcc42_Maci64_x64_v2_2_0.tgz

This is a compressed tar file and you should extract it into:

/Applications/GenICam/V2_2_0

After the files are extracted, configure environment variables. You can do this by creating and opening ~/.MacOSX/environment.plist as shown here:

Alternatively, you can do this by using a utility such as the one here:

http://www.apple.com/downloads/macosx/system_disk_utilities/
     environmentvariablepreferencepane.html

Set environment variables, as shown here.

Note   If you have a camera that requires a GenICam XML file on a local drive (most cameras do not), you should also set the MWIMAQ_GENICAM_XML_FILES environment variable to the directory of your choice, and then install the camera's XML file in that directory.

Mac Examples

GENICAM_ROOT_V2_2=/Applications/GenICam

GENICAM_CACHE_V2_2=/home/<USERNAME>/.GenICam/xml/cache

GENICAM_LOG_CONFIG_V2_2=/Applications/GenICam/log/config-unix/DefaultLogging.properties

Note that you may need to create the .GenICam/xml/cache directory in your home directory. Also, this example assumes that you have un-tarred the files in the /Applications/GenICam directory.

Ensure that the cache directory in your GENICAM_CACHE_V2_2 environment variable exists for GenICam to be able to use it.

Note   You will need to log out and log back in for the environment variable changes to take effect.

You can test the installation by using the following command:

imaqhwinfo('gige')

and by looking at the relevant sections of the output when you run the imaqsupport function.

Network Adaptor Configuration Notes

Setting Preferences

© 1984-2012- The MathWorks, Inc.    -   Site Help   -   Patents   -   Trademarks   -   Privacy Policy   -   Preventing Piracy   -   RSS