GARDASOFT CL190 User manual

CL190/CL191
Lens Controller
Issue 002
User manual
www.gardasoft.com

CL190/CL191 Lens Controller - User Manual
Copyright and disclaimer notice
Except as prohibited by law:
All hardware, software and documentation is provided on an ‘as is’ basis. This
information is for guidance only. Installers must perform their own risk assessment
specific to each installation.
It is essential that the users ensure that the operation of the product is suitable for
their application.
The users must ensure that incorrect functioning of this equipment cannot cause any
dangerous situation or significant financial loss to occur.
Deliberate acts of endangerment and vandalism are not covered by this document and
must be considered by the installer.
While care has been taken in the preparation of this document Gardasoft Vision Ltd will
not accept any liability for consequential loss of any kind except those required by law.
All trademarks acknowledged. This document is Copyright 2018 - Gardasoft Vision Ltd.
Issue status of this document: Issue 002 (June 2018)

CL190/CL191 Lens Controller - User Manual
Contents
1 Getting started 5
1.1 C190/CL191 features - a summary 5
2 Safety 6
2.1 Electrical 6
2.2 General 6
3 Sicherheit 7
3.1 Elektrik 7
3.2 Allgemeines 7
4 Sécurité 8
4.1 Électricité 8
4.2 Général 8
5 Mounting the CL191 9
5.1 Environmental considerations 9
6 Connecting the CL191 10
7 General description 12
7.1 Triggering 12
7.1.1 Trigger input options 13
7.2 Flags 13
7.3 Factory settings 14
8 I2C communication 15
8.1 I2Ccommand structure 15
9 Configuration commands 18
9.1 I2C configuration 18
9.2 UART configuration 18
9.3 Command structure 18
9.4 General commands 19
9.5 Analog mode commands 22
9.6 Waveform commands 24
9.7 Programmable step commands 29
9.8 Command summary 31
10 CL191 reference information 32
10.1 Specifications and ratings 32
10.2 Restrictions 33
10.3 Error codes 34

CL190/CL191 Lens Controller - User Manual
—4—

CL190/CL191 Lens Controller - User Manual
1 Getting started
Before you use this product, make sure that you have read and
understood Section 2 , Safety (or Section 3 , Sicherheit, or Section 4 ,
Sécurité) and Section 10.1 , Specifications and ratings, and that you have
checked the CL190/CL191 fulfils your requirements.
Mount the CL191 (see Section 5 , Mounting the CL191) and connect it up
(see Section 6 , Connecting the CL191), as required.
Set up the CL190/CL191 for the desired operation as described in
Section 9 , Configuration commands.
We recommend that you visit www.gardasoft.com for application notes on
this product.
For any trouble-shooting problems, contact Gardasoft for support.
1.1 C190/CL191 features - a summary
The CL190/CL191 product is a single channel lens controller for use in
machine vision applications. It works with the following ranges of Optotune
lenses:
EL-10-30
EL-16-40
EL-3-10
The CL190 is a hardware pack enabling OEMs to integrate the controller
into their products at PCBlevel. The CL191 is a board-only controller that
consists of 3 sections; power, control, and output as shown below. The
term 'CL191' is used throughout this document to describe both products
except when necessary to identify any difference.
—5—

CL190/CL191 Lens Controller - User Manual
2 Safety
Read this before using the CL191. Always observe the following safety
precautions. If in doubt, contact your distributor or Gardasoft Vision. The
following symbols mean:
Warning: Read instructions to understand possible hazard
Warning: Possible hazardous voltage.
Where these symbols appear in the manual, refer to the text for
precautions to be taken.
2.1 Electrical
The user must ensure that the potential difference between any
combination of applied signals does not exceed the supply voltage.
The CL191 does not have complete tracking isolation of inputs and
outputs.
Transients caused by inductive loads must be suppressed externally to
the CL191.
2.2 General
The CL191 must not be used in an application where its failure could
cause a danger to personal health or damage to other equipment.
If the equipment is used in a manner not specified by the manufacturer,
the protection provided by the equipment may be impaired.
—6—

CL190/CL191 Lens Controller - User Manual
3 Sicherheit
Bitte lesen Sie dieses Dokument, bevor Sie die CL191 verwenden.
Beachten Sie immer die folgenden Sicherheitshinweise. Bei Fragen
wenden Sie sich an Ihren Händler oder an Gardasoft Vision. Die folgenden
Symbole bedeuten:
Warnung: Lesen Sie die Anleitung, um die mögliche
Gefahrenquelle zu verstehen.
Warnung: Mögliche gefährliche Spannung.
Wenn diese Symbole in der Anleitung erscheinen, finden Sie im
beistehenden Text die zu ergreifenden Vorsichtsmaßnahmen.
3.1 Elektrik
Der Benutzer muss sicherstellen, dass der Potenzialunterschied zwischen
jeder beliebigen Kombination an angelegten Signalen die
Versorgungsspannung nicht überschreitet.
Die CL191 verfügt über keine vollständige Nachlauf-Isolierung der Ein-
und Ausgänge.
Spannungsspitzen am CL191 aufgrund von induktiven Ladungen müssen
extern unterdrückt werden.
3.2 Allgemeines
Die CL191 darf nicht in Bereichen verwendet werden, in denen bei Ausfall
eine Gefahr von Personen- oder Sachschäden besteht.
Wenn das Gerät nicht entsprechend den Herstellerangaben eingesetzt
wird, kann der durch das Gerät bereitgestellte Schutz beeinträchtigt
werden.
—7—

CL190/CL191 Lens Controller - User Manual
4 Sécurité
Veuillez lire la notice avant d’utiliser le CL191 . Respectez toujours les
mesures de sécurité qui suivent. En cas de doute, contactez votre
distributeur ou Gardasoft Vision. Les symboles suivants signifient:
Attention: Lisez les consignes afin de bien comprendre les dan-
gers encourus.
Attention: Risque d’électrocution.
Veuillez vous référer aux consignes du manuel pour connaître les
précautions à suivre au regard de ces symboles.
4.1 Électricité
L’utilisateur doit s’assurer que la différence de potentiel entre toute
combinaison des signaux appliqués ne dépasse pas la tension de
fourniture.
LeCL191 ne dispose pas de système complet d’isolation des entrées et
sorties.
Les transitoires causés par les charges inductives doivent être supprimés
à l’extérieur du CL191 .
4.2 Général
Le CL191 ne doit pas être utilisé dans une situation où toute panne de
celui-ci mettrait en danger la santé des personnes ou risquerait
d’endommager d’autres équipements.
Si l’appareil est utilisé d’une manière différente de celle recommandée
par le fabricant, la protection offerte par l’appareil pourra en être altérée.
—8—

CL190/CL191 Lens Controller - User Manual
5 Mounting the CL191
The CL191 is mounted using a single M2 screw as shown in the illustration
below:
5.1 Environmental considerations
The CL191 is a bare PCBand has no ingress rating. It should be sited
away from water or dirt.
—9—

CL190/CL191 Lens Controller - User Manual
6 Connecting the CL191
Refer to Section 10.1 , Specifications and ratings for the ratings of the
connections. The CL191's connections are shown below:
The CL191's UART and manufacturing test connections are on the
underside of the PCBas shown below:
The I2C connections to the CL191 are shown below:
Power supplied to the CL191 must be in the range 4.5VDCto 5.5VDC.
—10 —

CL190/CL191 Lens Controller - User Manual
The connections to the lens are normally made through the lens
connector, although A1 Out and A2 Out are available from the PCB. The
lens connector terminations are as follows:
Connector pin Description
1 GND
2 A1 Out
3 A2 Out
4 SDA
5 SCL
6 3.3VDC
For matching puposes, the header fitted to the CL191 is a Molex™
503480-0600.
—11 —

CL190/CL191 Lens Controller - User Manual
7 General description
Three modes of operation are provided for the lens output:
Continuous – the output is constant, and can be set to any value
between the minimum and maximum optical power of the lens.
Switch – the trigger input can be used to switch the output between an
active optical power value and an idle optical power value.
Analog - the output is controlled by an analogue signal on the trigger input
which can vary the optical power between the minimum and maximum
power of the lens.
Additionally, using configuration commands, you can select a range of
waveforms to output (see Section 9.6 , Waveform commands), and
program a timed sequence of optical power settings (see Section 9.7 ,
Programmable step commands).
Note: The time to reach stable focus depends on various conditions,
including how much the focus is changing by and the acceptable
tolerance. Depending on conditions the focus time is around 6ms to 10ms.
The set-up is non-volatile, so the CL191 resumes the same operation after
a power cycle.
7.1 Triggering
Trigger pulses should have a minimum pulse width of 2µs and be between
10V and 24V. You can set the sense of the CL191 trigger input. Do this by
setting the P flag using the RE command (see Section 9 , Configuration
commands). The effect of setting the P flag is summarised below:
Mode P Flag Output
Continuous Unused Focus is set to the Active focus.
Switched P Flag = 1 Focus is Idle when trigger is off,
Focus is Active when trigger is on.
P Flag = 0 Focus is Active when trigger is off,
Focus is Idle when trigger is on.
Analog Unused Focus is controlled by varying the
analog input voltage (see Section 7.1.1 ,
Trigger input options).
Note: The P flag inverts the sense of the trigger.
—12 —

CL190/CL191 Lens Controller - User Manual
7.1.1 Trigger input options
You can connect the following types of trigger to the trigger input:
10V to 24V voltage source
Any voltage between 0V and 0.9V
is taken as logic 0.
Any voltage between 10V and
24V is taken as logic 1.
PNP signal
You can connect a PNP open
collector drive to the CL191's
input. Use the connections shown
opposite. The PNP transistor
should not pull up to more than
24V.
If the P flag is set to ‘1’ the CL191
trigger is on when the driving
transistor turns on. To reverse
this, set the P flag to ‘0’ (see
Section 7.1 , Triggering).
Analog signal
A 0Vto 10Vanalog signal is input
to control the lens optical power
when the controller is in Analog
mode. This can be linear or non-
linear (see Section 9.5 , Analog
mode commands).
7.2 Flags
You can set flags on the CL191 controller to alter its operation. They can
be set from the unit’s front panel, the webpage or through the RE
command (see Section 9 , Configuration commands). The following
configuration flags are available:
E Flag – Enables or disables fault detection. Error checking is enabled as
the default setting.
P Flag – Sets the trigger input active high or active low. The default setting
is active high. Refer to Section 7.1.1 , Trigger input options for a detailed
description of the settings.
—13 —

CL190/CL191 Lens Controller - User Manual
7.3 Factory settings
You can clear the CL191 configuration to return it to its factory settings.
Clear the configuration by using the CL command (see Section 9 ,
Configuration commands).
—14 —

CL190/CL191 Lens Controller - User Manual
8 I2C communication
The CL191 contains a master/slave protocol with a maximum frequency of
400khz. The address is 0x20 for writing and 0x21 for reading.
8.1 I2Ccommand structure
The I2C protocol allows you to send command strings to the CL191 and to
retrieve the results. The maximum length of any command to, or reply
from the CL191 is 20 bytes. See Section 9 , Configuration commands for
the range of commands you can send with I2C.
To write to the device, the master generates a start condition (S) and then
transmits the slave address with the read/write (R/W) bit set to zero. This
should be followed by each individual byte of the command string and a
terminating CR (0x0D). The slave acknowledges (A) each byte sent. On
completion, the master sends a stop condition (P).
The following example shows the VR command being sent to the CL191:
To retrieve the result from the command string, the CL191 requires a
100ms period between the sending of a command and retrieval of the
result.
To read from the slave device, the master generates a start condition (S)
and then transmits the slave address with the R/W bit set to one. The
CL191 then sends a byte containing the number of bytes in the result
string. The master acknowledges (A) each byte until the final byte when
the master sends a not acknowledged condition (NA) and stops
transmission.
The example overleaf shows the reading of the VR response:
—15 —

CL190/CL191 Lens Controller - User Manual
—16 —

CL190/CL191 Lens Controller - User Manual
After sending an I2C message, it is necessary to wait before reading the
reply; I2Cmessages typically take 100ms for the reply to be ready. Some
commands, including the RLcommands, take 150ms before a reply is
ready.
—17 —

CL190/CL191 Lens Controller - User Manual
9 Configuration commands
You can configure the CL191 using its RS232 or I2C connections. Both of
these methods are described in this section.
9.1 I2C configuration
The I2Ccommunication protocol is described in Section 8 , I2C
communication.
9.2 UART configuration
When using the UART to configure the CL191, the COM port should be set
to 115200baud, 8 data bits, no parity, 1 stop bit, no handshaking.
A carriage return (ASCII 13) character should be sent to terminate the
command line.
9.3 Command structure
Commands are sent by the host (a PC connected to the network). The
command is returned by the CL191, together with any reply generated by
that command, in UDP or TCP/IP packets followed by <LF> <CR>. The
last character sent is the >prompt. Once this has been received, the host
knows the command has been completed.
For example, sending the VR command might get this reply:
If there is an error, a typical reply might be:
It is recommend the host waits for the >prompt before sending the next
command; UDP communications are not guaranteed to arrive, so the host
software must be able to deal with lost messages.
When an error occurs, the host may request a reply message to be sent to
it by using the GT command.
Multiple commands can be entered on one line by separating them with a
semi-colon (;). The CL190 replies to the commands individually,
—18 —

CL190/CL191 Lens Controller - User Manual
separating them with <LF><CR> and adding the >prompt after the final
command reply.
All commands comprise a code of two letters followed by any parameter
necessary. All spaces in the command are ignored.
Numeric parameters are separated by a comma (,). Time periods are
specified in milliseconds by default, but you can add ‘s’, ‘ms’, or ‘us’ to the
parameter to specify seconds, milliseconds, or microseconds. Current is
specified in amps by default, but you can add ‘A’ or ‘mA’ to the parameter
to specify amps or milliamps.
Note: All parameters are specified in the ‘USA/UK’ format, where a half is
written as ‘0.5’ and not ‘0,5
9.4 General commands
Any changes you make using Ethernet commands are not saved
permanently until you send the AW command.
Report the CL190 firmware version
This command returns the firmware version running on the TR-
CL180. For example, typing:
VR returns
CL190 (HW01) V001
Set continuous mode
This command sets the output to continuous mode and allows the
brightness to be set:
RS1,s
Where:
s= optical power within the range of the lens
Set switched mode
This command sets the output to switched mode and allows the
optical power to be set:
RU1,a,i
Where:
a= the Active optical power within the range of the
connected lens.
i= the Idle optical power within the range of the
connected lens.
Set the trigger sense option flag
This command sets the flag for trigger sense:
RE1,m
—19 —

CL190/CL191 Lens Controller - User Manual
Where:
m= 0 to trigger on a positive-going source
m= 4 to trigger on a negative-going source
Save the settings to memory
AW
This command saves the settings to non-volatile memory. If you
power cycle the CL190 before sending the AW command, all
changes are lost and the unit returns to the values set before the last
AW command.
Clear configuration
CL
This command clears the configuration and lighting ratings, and
turns the output off. The results of any RS,RU,RA,RE, and AW
commands are cleared.
This command shows the configuration of the CL190. Type in:
ST
A typical reply to this command might be:
CH1,MD0,AF 3.95, IF 0.00,
IP1,FL0,Mn0.0,Mx0.
Where :
CH Channel number; this is always 1.
MD Mode: 0 = continuous, 1 = switched, 2 = analog.
AF Active optical power in the range of the connected
lens.
IF Idle optical power in the range of the connected lens.
IP Always returns IP1
RT Retrigger delay.
IP Always returns IP1.
FL Flags set using the RE1 command.
Mn In Analog mode, the voltage corresponding to
minimum focus.
Mx In Analog mode, the voltage corresponding to
maximum focus.
—20 —