Device Control
Device Control provides you with device information and allows you to control some device parameters.
General Information
Use Device User ID to enter a unique device name. This information is retained over power cycles.
Use Device Indicator Mode to control the status LED. The LED can be active, inactive, or in error mode.
Bandwidth
Information about the bandwidth usage and link speed is provided.
Use Device Link Throughput Limit to specify what bandwidth is used for the streaming of data. This affects the maximum frame rate. This must be less that the Device Max Throughput.
Timestamp
Use Timestamp Latch to capture the current timestamp of the device.
Power Supply
Use the Device Power Supply Selector to choose a power supply, either External or Sensor (Internal). External power is either through the device interface or through GPIO.
Board-level USB3 models can only be powered via the USB3 interface. The ideal input voltage is nominal 5 V DC. For the USB3 connector to provide power, the host controller must be connected to the computer's power supply.
Device Reset
Use Device Reset to soft reboot the camera. Use Factory Reset to clear any user tables loaded and perform a soft reboot of the camera.
Summary Table
| Name | Interface | Access | Visibility | Description |
|---|---|---|---|---|
| Device Scan Type | IEnumeration | RO | Expert | Scan type of the sensor of the device. |
| Device Vendor Name | IStringReg | Beginner | Name of the manufacturer of the device. | |
| Device Model Name | IStringReg | Beginner | Model name of the device. | |
| Sensor Description | IStringReg | Guru | Returns Sensor Description | |
| Device Firmware Version | IStringReg | Beginner | Firmware version of the device. | |
| Device Serial Number | IStringReg | Expert | Device serial number. This string is a unique identifier of the device. | |
| Device User ID | IStringReg | Beginner | User Defined Name. This can be used to enter a unique device name. This information is retained over power cycles. | |
| Device TL Type | IEnumeration | RO | Beginner | Transport Layer type of the device. |
| Device Gen CP Version Major | IInteger | RO | Beginner | Major version of the GenCP protocol supported by the device. |
| Device Gen CP Version Minor | IInteger | RO | Beginner | Minor version of the GenCP protocol supported by the device. |
| Device Max Throughput | IInteger | RO | Expert | Maximum bandwidth of the data that can be streamed out of the device. This can be used to estimate if the physical connection(s) can sustain transfer of free-running images from the camera at its maximum speed. |
| Device Link Speed | IInteger | RO | Guru | Link Speed |
| Device Link Throughput Limit | IInteger | RW | Expert | Limits the maximum bandwidth of the data that will be streamed out by the device on the selected Link. If necessary, delays will be uniformly inserted between transport layer packets in order to control the peak bandwidth. |
| Device Link Bandwidth Reserve | IFloat | RW | Expert | Percentage of streamed data bandwidth reserved for packet resend. |
| Device Link Current Throughput | IInteger | RO | Expert | Current bandwidth of streamed data. |
| Device Reset | ICommand | WO | Guru | This is a command that immediately resets and reboots the device. |
| Device Indicator Mode | IEnumeration | Expert | Controls the LED behaviour: Inactive (off), Active (current status), or Error Status (off unless an error occurs). | |
| Device Temperature Selector | IEnumeration | Expert | Selects the location within the device, where the temperature will be measured. | |
| Device Temperature [Device Temperature Selector] | IFloat | RO | Expert | Device temperature in degrees Celsius (C). |
| Timestamp Latch | ICommand | WO | Expert | Latches the current timestamp counter into TimestampLatchValue. |
| Timestamp Latch Value | IInteger | RO | Expert | Returns the latched value of the timestamp counter. |
| Timestamp Increment | IInteger | RO | Expert | Indicates the timestamp increment in ns/tick. |
| Device Power Supply Selector | IEnumeration | Expert | Selects the power supply source to control or read. | |
| Power Supply Voltage [Device Power Supply Selector] | IFloat | RO | Expert | Indicates the current voltage of the selected power supply (V). |
| Power Supply Current [Device Power Supply Selector] | IFloat | RO | Expert | Indicates the output current of the selected power supply (A). |
| Device Uptime | IInteger | RO | Expert | Total time since the device was powered up in seconds. |
| Link Uptime | IInteger | RO | Expert | Time since the last phy negotiation (enumeration). |
| Enumeration Count | IInteger | RO | Expert | Number of enumerations since uptime. |
| Factory Reset | ICommand | WO | Guru | Returns all user tables to factory default |
| Max Device Reset Time | IInteger | RO | Expert | Time to wait until device reset complete (ms). |
Device Control Features
Device Scan Type
Scan type of the sensor of the device.
| Property | Value |
|---|---|
| Name | DeviceScanType |
| Interface | IEnumeration |
| Access | RO |
| Visibility | Expert |
| Enumeration Values |
|---|
| Areascan |
Device Vendor Name
Name of the manufacturer of the device.
| Property | Value |
|---|---|
| Name | DeviceVendorName |
| Interface | IStringReg |
| Access | |
| Visibility | Beginner |
Device Model Name
Model name of the device.
| Property | Value |
|---|---|
| Name | DeviceModelName |
| Interface | IStringReg |
| Access | |
| Visibility | Beginner |
Sensor Description
Returns Sensor Description
| Property | Value |
|---|---|
| Name | SensorDescription |
| Interface | IStringReg |
| Access | |
| Visibility | Guru |
Device Firmware Version
Firmware version of the device.
| Property | Value |
|---|---|
| Name | DeviceFirmwareVersion |
| Interface | IStringReg |
| Access | |
| Visibility | Beginner |
Device Serial Number
Device serial number. This string is a unique identifier of the device.
| Property | Value |
|---|---|
| Name | DeviceSerialNumber |
| Interface | IStringReg |
| Access | |
| Visibility | Expert |
Device User ID
User Defined Name. This can be used to enter a unique device name. This information is retained over power cycles.
| Property | Value |
|---|---|
| Name | DeviceUserID |
| Interface | IStringReg |
| Access | |
| Visibility | Beginner |
Device TL Type
Transport Layer type of the device.
| Property | Value |
|---|---|
| Name | DeviceTLType |
| Interface | IEnumeration |
| Access | RO |
| Visibility | Beginner |
| Enumeration Values |
|---|
| GigEVision |
| CameraLink |
| CameraLinkHS |
| CoaXPress |
| USB3Vision |
| Custom |
Device Gen CP Version Major
Major version of the GenCP protocol supported by the device.
| Property | Value |
|---|---|
| Name | DeviceGenCPVersionMajor |
| Interface | IInteger |
| Access | RO |
| Unit | |
| Visibility | Beginner |
Device Gen CP Version Minor
Minor version of the GenCP protocol supported by the device.
| Property | Value |
|---|---|
| Name | DeviceGenCPVersionMinor |
| Interface | IInteger |
| Access | RO |
| Unit | |
| Visibility | Beginner |
Device Max Throughput
Maximum bandwidth of the data that can be streamed out of the device. This can be used to estimate if the physical connection(s) can sustain transfer of free-running images from the camera at its maximum speed.
| Property | Value |
|---|---|
| Name | DeviceMaxThroughput |
| Interface | IInteger |
| Access | RO |
| Unit | Bps |
| Visibility | Expert |
Device Link Speed
Link Speed
| Property | Value |
|---|---|
| Name | DeviceLinkSpeed |
| Interface | IInteger |
| Access | RO |
| Unit | |
| Visibility | Guru |
Device Link Throughput Limit
Limits the maximum bandwidth of the data that will be streamed out by the device on the selected Link. If necessary, delays will be uniformly inserted between transport layer packets in order to control the peak bandwidth.
| Property | Value |
|---|---|
| Name | DeviceLinkThroughputLimit |
| Interface | IInteger |
| Access | RW |
| Unit | Bps |
| Visibility | Expert |
Device Link Bandwidth Reserve
Percentage of streamed data bandwidth reserved for packet resend.
| Property | Value |
|---|---|
| Name | DeviceLinkBandwidthReserve |
| Interface | IFloat |
| Access | RW |
| Unit | % |
| Visibility | Expert |
Device Link Current Throughput
Current bandwidth of streamed data.
| Property | Value |
|---|---|
| Name | DeviceLinkCurrentThroughput |
| Interface | IInteger |
| Access | RO |
| Unit | Bps |
| Visibility | Expert |
Device Reset
This is a command that immediately resets and reboots the device.
| Property | Value |
|---|---|
| Name | DeviceReset |
| Interface | ICommand |
| Access | WO |
| Visibility | Guru |
Device Indicator Mode
Controls the LED behaviour: Inactive (off), Active (current status), or Error Status (off unless an error occurs).
| Property | Value |
|---|---|
| Name | DeviceIndicatorMode |
| Interface | IEnumeration |
| Access | |
| Visibility | Expert |
| Enumeration Values |
|---|
| Inactive |
| Active |
| ErrorStatus |
Device Temperature Selector
Selects the location within the device, where the temperature will be measured.
| Property | Value |
|---|---|
| Name | DeviceTemperatureSelector |
| Interface | IEnumeration |
| Access | |
| Visibility | Expert |
| Enumeration Values |
|---|
| Sensor |
| Mainboard |
Device Temperature
Device temperature in degrees Celsius (C).
| Property | Value |
|---|---|
| Name | DeviceTemperature [Device Temperature Selector] |
| Interface | IFloat |
| Access | RO |
| Unit | C |
| Visibility | Expert |
Timestamp Latch
Latches the current timestamp counter into TimestampLatchValue.
| Property | Value |
|---|---|
| Name | TimestampLatch |
| Interface | ICommand |
| Access | WO |
| Visibility | Expert |
Timestamp Latch Value
Returns the latched value of the timestamp counter.
| Property | Value |
|---|---|
| Name | TimestampLatchValue |
| Interface | IInteger |
| Access | RO |
| Unit | |
| Visibility | Expert |
Timestamp Increment
Indicates the timestamp increment in ns/tick.
| Property | Value |
|---|---|
| Name | TimestampIncrement |
| Interface | IInteger |
| Access | RO |
| Unit | |
| Visibility | Expert |
Device Power Supply Selector
Selects the power supply source to control or read.
| Property | Value |
|---|---|
| Name | DevicePowerSupplySelector |
| Interface | IEnumeration |
| Access | |
| Visibility | Expert |
| Enumeration Values |
|---|
| External |
Power Supply Voltage
Indicates the current voltage of the selected power supply (V).
| Property | Value |
|---|---|
| Name | PowerSupplyVoltage [Device Power Supply Selector] |
| Interface | IFloat |
| Access | RO |
| Unit | V |
| Visibility | Expert |
Power Supply Current
Indicates the output current of the selected power supply (A).
| Property | Value |
|---|---|
| Name | PowerSupplyCurrent [Device Power Supply Selector] |
| Interface | IFloat |
| Access | RO |
| Unit | A |
| Visibility | Expert |
Device Uptime
Total time since the device was powered up in seconds.
| Property | Value |
|---|---|
| Name | DeviceUptime |
| Interface | IInteger |
| Access | RO |
| Unit | s |
| Visibility | Expert |
Link Uptime
Time since the last phy negotiation (enumeration).
| Property | Value |
|---|---|
| Name | LinkUptime |
| Interface | IInteger |
| Access | RO |
| Unit | s |
| Visibility | Expert |
Enumeration Count
Number of enumerations since uptime.
| Property | Value |
|---|---|
| Name | EnumerationCount |
| Interface | IInteger |
| Access | RO |
| Unit | |
| Visibility | Expert |
Factory Reset
Returns all user tables to factory default
| Property | Value |
|---|---|
| Name | FactoryReset |
| Interface | ICommand |
| Access | WO |
| Visibility | Guru |
Max Device Reset Time
Time to wait until device reset complete (ms).
| Property | Value |
|---|---|
| Name | MaxDeviceResetTime |
| Interface | IInteger |
| Access | RO |
| Unit | ms |
| Visibility | Expert |
_242x41.jpg)