IFM Electronic O3D303 User manual

Seite 1 von 72
Operations Manual
3D camera
O3D303

Seite 2 von 72
1PRELIMINARY NOTE ................................................................5
2SAFETY INSTRUCTIONS ...........................................................5
3FUNCTIONS AND FEATURES ......................................................5
4INSTALLATION.......................................................................6
4.1Object distance................................................................................ 6
4.2Camera surroundings....................................................................... 6
4.3Heat dissipation............................................................................... 7
5LED DISPLAY........................................................................8
6ELECTRICAL CONNECTION........................................................9
6.1Wiring.............................................................................................. 10
7XML-RPC INTERFACE ............................................................11
7.1Sample XML-RPC command .............................................................. 11
7.2XML-RPC Objects ............................................................................. 12
7.2.1Main-Object: ........................................................................... 14
7.2.2SessionObject ......................................................................... 14
7.2.3EditMode-Object...................................................................... 14
7.2.4DeviceConfig-Object ................................................................ 14
7.2.5Device/NetworkConfig-Object.................................................... 14
7.2.6ApplicationConfig-Object (editable application)........................... 14
7.2.7App./ImagerConfig-Object (O3D3xx) .......................................... 15
7.2.8Image-Settings Filter-Parameter................................................ 15
8PROCESS INTERFACE..............................................................16
8.1Sending commands .......................................................................... 16
8.2Receiving images............................................................................. 18
8.3Image data....................................................................................... 20
8.4Additional information for image data............................................... 25
8.5Configuration of PCIC output............................................................ 27
8.6Sample C++ Code for setting up a socket.......................................... 32
9XML-RPC COMMAND REFERENCES............................................33

Seite 3 von 72
9.1"setParameter" must be implemented on all RPC-objects which offer parameter
33
9.2Main-Object ..................................................................................... 33
9.2.1"getParameter”........................................................................ 33
9.2.2"getAllParameters" .................................................................. 33
9.2.3"getSWVersion" ....................................................................... 34
9.2.4"getHWInfo" ............................................................................ 35
9.2.5"getApplicationList”.................................................................. 35
9.2.6"requestSession" ..................................................................... 36
9.2.7"reboot" .................................................................................. 36
9.2.8"systemCommand” ................................................................... 36
9.3Session-Object................................................................................. 37
9.3.1"heartbeat" ............................................................................. 37
9.3.2"cancelSession”....................................................................... 37
9.3.3"exportConfig” ......................................................................... 37
9.3.4"importConfig” ......................................................................... 38
9.3.5"exportApplication” .................................................................. 38
9.3.6"importApplication” .................................................................. 38
9.3.7"setOperatingMode" ................................................................. 39
9.4EditMode-Object............................................................................... 40
9.4.1"factoryReset" ......................................................................... 40
9.4.2"editApplication"...................................................................... 40
9.4.3"stopEditingApplication" ........................................................... 40
9.4.4"createApplication" .................................................................. 41
9.4.5"copyApplication" .................................................................... 41
9.4.6"deleteApplication" .................................................................. 41
9.4.7"moveApplications" .................................................................. 42
9.5DeviceConfig-Object ........................................................................ 43
9.5.1"activatePassword" .................................................................. 43
9.5.2"disablePassword" ................................................................... 43
9.5.3"save" .................................................................................... 43
9.5.4Parameters ............................................................................. 44
9.6Device/NetworkConfig-Object ........................................................... 49

Seite 4 von 72
9.6.1"saveAndActivateConfig" .......................................................... 49
9.7ApplicationConfig-Object ................................................................. 49
9.7.1"save" .................................................................................... 49
9.7.2"forceTrigger".......................................................................... 49
9.7.3"validate"................................................................................ 50
9.7.4Parameters ............................................................................. 51
9.8App./ImgagerConfig-Object .............................................................. 53
9.8.1"changeType".......................................................................... 53
9.8.2"availableTypes"...................................................................... 53
9.8.3Parameters ............................................................................. 54
9.9Image-Settings Filter-Parameter ....................................................... 61
9.9.1Parameters ............................................................................. 61
10PROCESS INTERFACE COMMAND REFERENCE ...............................63
10.1t command ....................................................................................... 63
10.2T? command .................................................................................... 63
10.3I? command ..................................................................................... 64
10.4p command ...................................................................................... 65
10.5a command ...................................................................................... 65
10.6A? command .................................................................................... 66
10.7v command ...................................................................................... 67
10.8V? command .................................................................................... 67
10.9c command ...................................................................................... 68
10.10C? command .................................................................................... 68
10.11S? command .................................................................................... 69
10.12L? command .................................................................................... 70
10.13G? command.................................................................................... 71
10.14H? command .................................................................................... 72

Seite 5 von 72
1 PRELIMINARY NOTE
This document is intended for specialists. These specialists are people who are qualified
by their appropriate training and their experience to see risks and to avoid possible haz-
ards that may be caused during operation or maintenance of the device. The document con-
tains information about the correct handling of the device.
Read this document before use to familiarise yourself with operating conditions and instal-
lation. Keep this document during the entire duration of use of the device.
2 SAFETY INSTRUCTIONS
This instruction is part of the device. It contain texts and figures concerning the correct
handling of the device and must be read before installation or use.
Note the safety instructions. Use the device in accordance with its designated use.
The installation and connection must comply with the applicable national and international
standards. Responsibility lies with the person installing the device.
Only the signals indicated in the technical data or on the device label may be supplied to
the connections or wires.
The unit may only be opened by the manufacturer or by a person authorised by the manu-
facturer.
3 FUNCTIONS AND FEATURES
The O3D303 3D camera is an optical camera equipped with an internal illumination unit
measuring the distance between the camera and the nearest surface point by point.
The data is used to describe the captured scene three-dimensionally.
The data is issued and the device parameters are set via Ethernet.
The unit may only be used under the environmental conditions specified in the data sheet.
The device safety is rated for use under the following environmental conditions:
• Indoor use
• Altitudes up to 2000 m
• Relative air humidity up to max.90%, non condensing
• Pollution degree 3

Seite 6 von 72
4 INSTALLATION
►Use cables with strain relief.
4.1 Object distance
►Choose the mounting position of the camera so that the object of interest is completely
located within the field of view of the camera. Make allowances for positioning tolerances.
The field of view may be found in the product data sheet. The lateral dimensions of the
camera image increase linearly with the distance from the camera, i.e. the field of view in-
creases with increasing distance.
►The distance between camera and object must not exceed the maximum measuring
range and should be within the operating distance stated in the product data sheet.
►The distance between the camera and the object of interest should be chosen as small
as possible in order to measure the object with maximum resolution.
4.2 Camera surroundings
►For best measurement accuracy the object of interest (C) should be the object closest
to the camera within the field of view (B).
►Objects which are located close to the field of view (area A) may lead to measurement
errors and should be avoided. This also includes mounting posts, clamps, etc.

Seite 7 von 72
►Bright extraneous light such as e.g. sun light incident on the surface of the object of
interest or on the camera lens should be avoided. Only the infrared portion of the light be-
tween 800nm and 900nm is critical and should not exceed the sunlight-equivalent of 8klux.
►The camera optics must be kept clean. Avoid installation in heavy polluting areas of a
machine. Mounting the camera facing down may help to reduce collection of dust on the
front window.
►Do not install the camera behind windows. Direct reflection from the camera illumination
back into the camera lens may lead to measurement errors. Such reflections are present
even at very clean glass surfaces.
4.3 Heat dissipation
ATTENTION
Depending on the operating mode, the unit may heat up.
The difference between the unit's surface temperature and the ambient temperature may
not exceed 25 degrees. Take one or several of the following measures:
►Preferably mount camera to large metal parts which are good heat conductors such as
e.g. aluminium. A good thermal contact between camera and camera mounting increases
the dissipation of excess heat. A heat conducting plate is available as separate accessory.
►Allow the circulation of air around the camera to allow thermal convection. Mounting
positions directly under a roof or in cramped areas may lead to heat accumulation.
►Thermal convection may be further improved by using one or two heat dissipators which
are available as separate accessories.
►The camera temperature may also be reduced by reducing the following operation pa-
rameters of the camera:
- frame rate
- exposure time
- maximum measurement distance (number of used frequencies)
►Use a contact protection.

Seite 8 von 72
5 LED DISPLAY
LED behaviour, device status
LED 1
Power
(green)
ON: supply voltage available, device ready for operation
flashing (0,5 Hz)
:
No parametrisation available.
flashing (0,5 Hz)
setup mode
LED 2
Out1
(yellow)
ON: switching output 1 is on
flashing (8Hz): short circuit switching output 1
LED 3
Out2
(yellow)
ON: switching output 1 is on
flashing (8Hz): short circuit switching output 2
LED 4
Ethernet
(green)
OFF: no ethernet connection
ON: ethernet connection
flashing: ethernet communication
Other status displayed by LEDs:
- LED 2 and 3 (both yellow) flash simultaneously (8 Hz) internal error
- LED 2 and 3 flash simultaneously (2 Hz) repairable error, please note ethernet error
message
- Sequence flashing LED 1, 2 und 3 device is booting
- Sequence flashing LED 3, 2 und 1 firmware update

Seite 9 von 72
6 ELECTRICAL CONNECTION
ATTENTION
The unit must be connected by a qualified electrician.
Device of protection class III (PC III)
Electric supply via PELV circuits only.
Electric supply must comply with UL61010-1, chap. 9.4 - Limited Energy.
The separation of external circuits must comply with UL61010-2-201, fig. 102.
►Disconnect power before connecting the unit.

Seite 10 von 72
6.1 Wiring