GigE MotionBLITZ EoSens mini1 User manual

MotionBLITZ® EoSens® mini1
Reference Guide
CAMMC1370/71-RG
Document version 2.0
Instrumentation Devices Srl
Via Acquanera 29 - 22100 COMO (Italy)
ph [phone]- fax [phone]
[e-mail] - www.instrumentation.it

Contents
Before you start 4
1.1 About this manual 5
1.1.1 Tips, remarks, and notes 5
1.1.2 Registered trademarks 5
1.1.3 Conformity and use 5
1.1.4 Supplements 6
1.2 Warranty and non-warranty clause 7
1.3 Support 8
Introduction to GenICam 9
2.1 Overview 10
2.2 Interface type 11
Feature description 12
3.1 Overview 13
3.2 Device information 13
3.2.1 Overview 13
3.2.2 Controls 14
3.3 Image size control 17
3.3.1 Overview 17
3.3.2 Controls 17
3.4 Acquisition and trigger controls 23
3.4.1 Overview 23
3.4.2 Controls 23
3.5 Analog controls 27
3.5.1 Overview 27
3.5.2 Controls 28
3.6 UserSets 29
3.6.1 Overview 29
3.6.2 Controls 29
3.7 Custom features 31
3.7.1 Overview 31
MikrotronGmbH / mini1 / CAMMC1370/71-RG / 2021 2 - 67

3.7.2 Controls 31
3.8 Recording 34
3.8.1 Overview 34
3.8.2 Controls 35
3.9 Streaming 41
3.9.1 Overview 41
3.9.2 Controls 42
3.10 CustomData 45
3.10.1 Overview 45
3.10.2 Controls 46
3.11 ImageBlitz 46
3.11.1 Overview 46
3.11.2 Controls 47
3.12 Synchronization 50
3.12.1 Overview 50
3.12.2 Controls 50
3.13 ExtTrigger 52
3.13.1 Overview 52
3.13.2 Controls 53
3.14 Multiple slope 53
3.14.1 Overview 53
3.14.2 Controls 54
Programming 56
4.1 Camera states 57
4.2 State transformations 58
4.3 Record programming 59
4.3.1 Overview 59
4.3.2 Continuous recording – single sequence 59
4.3.3 Continuous recording - multiple sequences 61
4.3.4 Single recording 62
4.3.5 RecordStandby (UserSets) 63
4.4 Streaming programming 64
4.4.1 Overview 64
4.4.2 Single frame mode 64
4.4.3 Frame burst mode 65
4.5 ImageBLITZ programming 66
MikrotronGmbH / mini1 / CAMMC1370/71-RG / 2021 3 - 67

Before you start
This chapter provides the following information:
1.1 About this manual
1.2 Warranty and non-warranty clause
1.3 Support
1

1.1 About this manual
This manual contains helpful information to install and operate the here
described camera. It has been produced with care. Nevertheless, information
might be erroneous or incomplete. Mikrotron GmbH cannot be held respons-
ible for any problems resulting from incomplete or erroneous information.
In case you detect errors or need further information, please inform us via
mail:
[email protected] or
Call [phone]
We highly recommend to read this manual carefully.
NOTE This manual is subject to change without notice.
1.1.1 Tips, remarks, and notes
This manual contains tips and notes that help to avoid data loss or camera
damage. They are emphasized as follows:
INFO Provides information that may help to improve camera handling or avoid data
loss.
NOTE Provides information to avoid damage to the system.
1.1.2 Registered trademarks
In this manual the following registered trademarks may be used:
nMotionBLITZ®
nImageBLITZ®
nEoSens®
nGenICam®
nMicrosoft® and Windows®
nIntel®
Throughout the manual, these trademarks are not specifically marked as
registered trademarks. This in no way implies that these trademarks can be
used in another context without the trademark sign.
1.1.3 Conformity and use
This equipment has been tested and found to comply with the limits for a
Class A digital device, pursuant to Part 15 of the FCC Rules. These require-
Before you start
MikrotronGmbH / mini1 / CAMMC1370/71-RG / 2021 5 - 67

ments are designed to provide reasonable protection against harmful inter-
ference when the equipment is operated in a commercial environment.
This equipment generates, uses, and can radiate radio frequency energy and, if
not installed and used in accordance with the instructions given in this guide,
may cause harmful interference to radio communications. Operation of this
equipment in a residential area is likely to cause harmful interference in which
case the user will have to correct the interference at its own expense.
NOTE You are herewith cautioned that any changes or modifications not expressly
approved in this description could void your authority to operate this equip-
ment.
制造说明：
此设备的生产与测试依照FCC条例第15条条例，符合A类电子设备标准。产品提
供在商用使用环境中的合理保护，以防止使用过程中可能涉及到的损害。
此设备会产生、使用并可发射出无线电波，如果未按照本手册中所述安装和使
用，可能会对无线通信设备产生干扰。如本设备在居民区操作出现干扰等情
况，用户需要自费处理。
备注：请注意，如未按照此使用说明操作而自行更改设备，那么您将无权使用
本设备。
規制適合宣言とご使用について(米国FCC)
この機器は、FCC規則 のパート15に定められたクラスAデジタル装置に関する規制
要件に基づいて所定の試験が実施され、その適合が認証されています。 これらの
規制要件は、商業 環 境 において機器を使用する際、有害な干渉に対する妥当
な保護を提供するために設けられています。 この機器 は、無線周波数エネルギー
を生成かつ利用 するとともに、放射することもあります。 このリファレンスガイドの指
示に従って設置および使用が行われない場合 は、無線通信に有害な干渉を引き
起こす恐れがあります。 この機 器 を住 宅 地 で利用すると有害な干渉を起こすこと
もあり、その場合、使用者は自己負担において適 切 な対 策 を講 じる必要がありま
す。
注意事項：このリファレンスガイドに明 示 的 に承 認 していない変更や修 正 を行 った
場合には、本製品を使用する権利が無効となることがあります。
1.1.4 Supplements
For customers in Canada
This apparatus complies with the Class A limits for radio noise emissions set
out in Radio Interference Regulations.
Before you start
MikrotronGmbH / mini1 / CAMMC1370/71-RG / 2021 6 - 67

Pour les utilisateurs au Canada
Cet appareil est conforme aux normes Classe A pour bruits radioélectriques,
spécifiées dans le Règlement sur le brouillage radioélectrique.
Life support applications
The products described in this manual are not designed for use in life support
appliances or devices and systems where malfunction of these products can
reasonably be expected to result in personal injury.
NOTE Mikrotron customers using or selling these products for use in such applic-
ations do so at their own risk and agree to fully indemnify Mikrotron for any
damages resulting from such improper use or sale.
1.2 Warranty and non-warranty clause
Warranty is described in §8 of our General Terms and Conditions which can be
downloaded on the Mikrotron web page (www.mikrotron.de/en/terms.html).
In addition, take the following non-warranty clauses into account.
NOTE The camera does not contain serviceable parts. Do not open the body of the
camera. If the camera has been opened, the warranty will be void.
NOTE The camera has to be used with a supply voltage according to the camera’s
specification. Connecting a lower or higher supply voltage, AC voltage,
reversal polarity or using wrong pins of the power connector may damage
the camera. Doing so will void warranty.
Our warranty does not protect against accidental damage, loss, or acts of
nature.
INFO Mikrotron cannot be held responsible for the loss of data. We recommend a
backup plan.
Before you start
MikrotronGmbH / mini1 / CAMMC1370/71-RG / 2021 7 - 67

1.3 Support
1. In case of support or a warranty claim, make a note of the camera type
and its serial number (S/N). You find all necessary information on the iden-
tification plate of the camera.
2. Contact us in one of the following ways:
oContact us via email: [email protected]. Our support team will
guide you through the process.
oOr visit our support website
www.mikrotron.de/en/services/support.html
and fill out the form. You will receive an automatic reply from our
ticket system.
Before you start
MikrotronGmbH / mini1 / CAMMC1370/71-RG / 2021 8 - 67

Introduction to GenICam
This chapter provides the following information:
2.1 Overview
2.2 Interface type
2

2.1 Overview
Today's digital cameras not only deliver images but offer much more func-
tionality. Processing the image, appending the results to the image data
stream, controlling external hardware, and doing the real-time part of the
application are common features of machine vision cameras.
The intention of Gen<i>Cam is to provide a generic programming interface for
all cameras. No matter what interface technology (GigE Vision, Camera Link,
1394 DCAM, USB) is used or what features are implemented the application
programming interface (API) remains the same.
Mikrotron EoSens mini1 & mini2 cameras are GigE Vision compliant. The GigE
Vision standard uses Ethernet as the hardware interface to connect a camera
to its host. GigE Vision is based on GEN<i>CAM and thus ensures compatibility
to a wide range of programming interfaces and applications.
The configuration, status and control capabilities of the cameras are access-
ible via camera features. This manual provides an overview of the features for
mini1 and mini2 cameras.
There are a number of standard features similar to all GigE Vision compliant
cameras, e.g. the features used to configure communication via Ethernet. Not
all of these features are described in this manual. A detailed and complete
description provides the document GEN<i>CAM Standard Features Naming
Convention. It can be downloaded from the GEN<i>CAM homepage
http://www.genicam.org/.
This document provides the most important standard features and the defin-
itions of all camera related features. It is explained in detail how to use them
for programming.
INFO Use a GEV-Viewer to show all available features of the camera (e.g. GEVPlayer
from Pleora).
GEN<i>CAM specification
This manual is based on the GEN<i>CAM Standard Features Naming Con-
vention, Version 1.2.1, 2008-08-19 from the GEN<i>CAM Organisation at www.-
genicam.org
Introduction to GenICam
MikrotronGmbH / mini1 / CAMMC1370/71-RG / 2021 10 - 67

2.2 Interface type
Each feature is accessible via a specific interface and has a number of attrib-
utes describing the current value / state and capabilities (e.g. value range) of a
feature. The following interfaces are defined in the GenICam standard (each
one is given with the typical widget used to map it on a graphical user inter-
face).
Interface Type Widget
IInteger maps to a slider with value, min, max, and increment
IFloat maps to a slider with value, min, and max plus a physical
unit
IString maps to an edit box showing a string
IEnumeration maps to a drop down box
ICommand maps to a command button
IBoolean maps to a check box
IRegister maps to an edit box showing a hex string
ICategory maps to an entry in a tree structuring the camera's fea-
tures
IPort maps to the camera port and is typically not shown
graphically
Introduction to GenICam
MikrotronGmbH / mini1 / CAMMC1370/71-RG / 2021 11 - 67

Feature description
This chapter provides the following information:
3.1 Overview
3.2 Device information
3.3 Image size control
3.4 Acquisition and trigger controls
3.5 Analog controls
3.6 UserSets
3.7 Custom features
3.8 Recording
3.9 Streaming
3.10 CustomData
3.11 ImageBlitz
3.12 Synchronization
3.13 ExtTrigger
3.14 Multiple slope
3

3.1 Overview
This section describes the camera features in detail. The method of reading
and writing the features depends on the functions provided by the API of the
GigE Vision SDK. Because the GigE Vision interface is standardized there are a
number of different SDKs from different vendors able to communicate with the
camera.
The format of the values of the functions of the API may differ from this
description. Refer to the documentation of the selected SDK to learn how to
handle read or write commands from or to the camera.
INFO Most camera feature settings will be preserved after switching the camera ON
and OFF.
3.2 Device information
3.2.1 Overview
Name Type Access
DeviceVendorName String RO
DeviceModelName String RO
DeviceManufacturerInfo String RO
DeviceVersion String RO
DeviceID String RO
DeviceUserID String R/W
DeviceScanType Enum RO
DeviceReset Command WO
Feature description
MikrotronGmbH / mini1 / CAMMC1370/71-RG / 2021 13 - 67

3.2.2 Controls
DeviceVendorName
This feature provides the name of the manufacturer of the device.
Access Read only
Interface IString
Unit --
Range --
Invalidation --
Precondition --
Note the string is limited by a trailing „\0“
DeviceModelName
This feature provides the model of the device.
Access Read only
Interface IString
Unit --
Range --
Invalidation --
Precondition --
Note the string is limited by a trailing „\0“
DeviceManufacturerInfo
This feature provides extended manufacturer information.
Access Read only
Interface IString
Unit --
Range --
Invalidation --
Precondition --
Note the string is limited by a trailing „\0“
Feature description
MikrotronGmbH / mini1 / CAMMC1370/71-RG / 2021 14 - 67

DeviceVersion
This feature provides the version of the device.
Access Read only
Interface IString
Unit --
Range --
Invalidation --
Precondition --
Note the string is limited by a trailing „\0“
DeviceID
This feature stores a camera identifier.
Access Read only
Interface IString
Unit --
Range --
Invalidation --
Precondition --
Note the string is limited by a trailing „\0“
DeviceUserID
This feature stores a user-programmable identifier.
Access Read / write
Interface IString
Unit --
Range --
Invalidation --
Precondition --
Note the string is limited by a trailing „\0“
Feature description
MikrotronGmbH / mini1 / CAMMC1370/71-RG / 2021 15 - 67

DeviceScanType
This feature specifies the scan type of the sensor.
Access Read only
Interface IEnumeration
Unit --
Range Area Scan
Invalidation --
Precondition --
Note --
DeviceReset
When supported by the camera, this command resets the camera's circuitry.
Access Write only
Interface ICommand
Unit --
Range --
Invalidation --
Precondition --
Note After a DeviceReset the camera has to be recon-
nected before using it again.
Feature description
MikrotronGmbH / mini1 / CAMMC1370/71-RG / 2021 16 - 67

3.3 Image size control
3.3.1 Overview
Name Type Access
SensorWidth Integer RO
SensorHeight Integer RO
SensorDigitizationTaps Enum R/W
WidthMax Integer RO
HeightMax Integer RO
Width Integer R/W
Height Integer R/W
PixelFormat Enum RO
PixelCoding Enum RO
PixelSize Enum RO
PixelColorFilter Enum RO
TestImageSelector Enum R/W
OffsetX Integer R/W
OffsetY Integer R/W
3.3.2 Controls
SensorWidth
This feature indicates the effective width of the sensor in pixels.
Access Read only
Interface IInteger
Unit pixel
Range 1696
Invalidation --
Precondition --
Note --
Feature description
MikrotronGmbH / mini1 / CAMMC1370/71-RG / 2021 17 - 67

SensorHeight
This feature indicates the effective height of the sensor in pixels.
Access Read only
Interface IInteger
Unit pixel
Range 1710
Invalidation --
Precondition --
SensorDigitizationTaps
This feature represents the number of digitized samples outputted sim-
ultaneously by the camera A/D conversion stage.
Access Read / write
Interface IEnum
Unit --
Range Two
Invalidation --
Precondition --
WidthMax
This feature represents the maximum width (in pixels) of the image after hori-
zontal binning, decimation or any other function changing the horizontal dimen-
sions of the image.
Access Read only
Interface IInteger
Unit pixel
Range 1696
Invalidation --
Precondition --
HeightMax
This feature represents the maximum height (in pixels) of the image after ver-
tical binning, decimation or any other function changing the vertical dimen-
sions of the image.
Feature description
MikrotronGmbH / mini1 / CAMMC1370/71-RG / 2021 18 - 67

Access Read only
Interface IInteger
Unit pixel
Range 1710
Invalidation --
Precondition --
Note --
Width
This feature represents the actual image width expelled by the camera (in
pixels).
Access Read / write
Interface IInteger
Unit pixel
Range 128...WidthMax - OffsetX, Inc. 16
Invalidates nAcquisitionFrameRateMax
nExposureTimeMax
nRecordMaxFrames
nRecordMaxFramesPerSequence
nAcquisitionFrameRateRaw
Precondition CameraState = Idle
Height
This feature represents the actual image height expelled by the camera (in
pixels).
Access Read / write
Interface IInteger
Unit pixel
Range 2...HeightMax – OffsetY, Inc. 2
Invalidation nAcquisitionFrameRateMax
nExposureTimeMax
nRecordMaxFrames
nRecordMaxFramesPerSequence
nAcquisitionFrameRateRaw
Precondition CameraState = Idle
Feature description
MikrotronGmbH / mini1 / CAMMC1370/71-RG / 2021 19 - 67

PixelFormat
This feature indicates the format of the pixel to use during the acquisition.
Access Read only
Interface IEnumeration
Unit --
Range Mono8, BayerGR8
Invalidation --
Precondition --
Note Mono8: monochrome
BayerGR8: color – Bayer Pattern coded
PixelCoding
This feature indicates the coding of the pixels in the image. The camera
returns frame data in RAW format which is the native format of the sensor.
The color version of the camera uses a Bayer Filter in front of the sensor. The
data returned by this camera type includes the color information in coded
form, so the user has to convert the image to RGB by himself.
Access Read only
Interface IEnumeration
Unit --
Range Mono, Raw
Invalidation --
Precondition --
Note Mono: monochrome
Raw: color
PixelSize
This feature indicates the total size in bits of a pixel of the image.
Access Read only
Interface IEnumeration
Unit --
Range Bpp8
Invalidation --
Precondition --
Feature description
MikrotronGmbH / mini1 / CAMMC1370/71-RG / 2021 20 - 67