Specifying Device Driver Identification Information Test Procedure

As part of the Image Acquisition Toolbox Adaptor Kit, we now offer a test procedure and automated tests for third-party adaptor developers and camera vendors to test adaptors and hardware against the toolbox. This test procedure is part of that suite. For more information, see Testing Adaptors or Hardware.

After specifying device driver identification information per instructions in “Specifying Device Driver Identification Information” in this Adaptor Kit documentation, follow these steps to verify the device driver identification information.

Test Procedures Expected Results

Test Procedures	Expected Results
Run the following command: vidObj = videoinput ('AdaptorName'); imaqhwinfo(vid)	The details of the device and device driver should be displayed. It will be similar to: AdaptorName: 'AdaptorName' DeviceName: 'MyDevice' MaxHeight: 280 MaxWidth: 120 TotalSources: 1 VendorDriverDescription: 'MyDevice_Driver' VendorDriverVersion: '1.0.0' where `'MyDevice'` is the name of the device and `VendorDriverDescription` and `VendorDriverVersion` are as defined in your adaptor class’ `getDriverDescription` and `getDriverVersion` methods. To clean up after this step, delete and clear the object.
Run the following command: vidObj = videoinput ('AdaptorName'); src = getselectedsource(vid); get(src)	The device-specific properties like `Brightness`, `Exposure`, etc. will be displayed along with their values. It will be similar to: General Settings: Parent = [1x1 videoinput] Selected = on SourceName = input1 Tag = Type = videosource Device-specific Properties: Brightness = -10 Contrast = 266 Exposure = 1024 ExposureMode = auto Hue = 0 Saturation = 340 Sharpness = 40 The actual property names will be based on the information provided by the adaptor. To clean up after this step, delete and clear the object.
Run the following command: vidObj = videoinput ('AdaptorName'); preview(vidObj); src = getselectedsource(vidObj); src.PropName = Value; where `PropertyName` is the name of a property that has visible effect on the acquired video (e.g., `Brightness`) and `newValue` is a value different from the existing value (e.g., specific integer values like `10` for `Brightness`).	The change in the property value should be observable in the video running in the preview window. Try different property values. For example, if there is a set of properties that have dependencies with each other, change one of them to make sure that it gets reflected in the dependent properties. To close the preview window, press the (x) button or type `closepreview` at the command prompt. To clean up after this step, delete and clear the object.

Run the following command:

vidObj = videoinput
   ('AdaptorName');
imaqhwinfo(vid)

The details of the device and device driver should be displayed. It will be similar to:

AdaptorName: 'AdaptorName'
DeviceName: 'MyDevice'
MaxHeight: 280
MaxWidth: 120
TotalSources: 1
VendorDriverDescription: 
   'MyDevice_Driver'
VendorDriverVersion: '1.0.0'

where 'MyDevice' is the name of the device and VendorDriverDescription and VendorDriverVersion are as defined in your adaptor class’ getDriverDescription and getDriverVersion methods.

To clean up after this step, delete and clear the object.

Run the following command:

vidObj = videoinput
   ('AdaptorName');
src = getselectedsource(vid);
get(src)

The device-specific properties like Brightness, Exposure, etc. will be displayed along with their values. It will be similar to:

General Settings:

Parent = [1x1 videoinput]
Selected = on
SourceName = input1
Tag =
Type = videosource

Device-specific Properties:

Brightness = -10
Contrast = 266
Exposure = 1024
ExposureMode = auto
Hue = 0
Saturation = 340
Sharpness = 40

The actual property names will be based on the information provided by the adaptor.

To clean up after this step, delete and clear the object.

Run the following command:

vidObj = videoinput
   ('AdaptorName');
preview(vidObj);
src = getselectedsource(vidObj);
src.PropName = Value;

where PropertyName is the name of a property that has visible effect on the acquired video (e.g., Brightness) and newValue is a value different from the existing value (e.g., specific integer values like 10 for Brightness).

The change in the property value should be observable in the video running in the preview window. Try different property values. For example, if there is a set of properties that have dependencies with each other, change one of them to make sure that it gets reflected in the dependent properties. To close the preview window, press the (x) button or type closepreview at the command prompt.

To clean up after this step, delete and clear the object.