Impact Software Settings Reference Guide eng Rev 11_1_1

Impact Software Settings Reference Guide eng Rev 11_1_1
Settings
Reference Guide
Publication # 843-0137 (Rev 11.1.1)
Disclaimer
Datalogic Automation Inc. makes no representations or warranties for merchantability or fitness for any particular purpose, regarding Datalogic’s software or hardware. Datalogic Automation Inc. shall not be liable
for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance, or use of this publication or its contents.
Datalogic Automation Inc. reserves the right to revise this publication from time to time and to make
changes in the content hereof without obligation to notify any person of such revision or changes.
Under the copyright laws, neither this publication nor the software may be copied, photocopied, reproduced,
or reduced to any electronic medium or machine-readable form, in whole or in part, without the prior written
consent of Datalogic Automation Inc.
Telephone:
Facsimile:
Web site:
E-Mail:
952-996-9500
952-996-9501
http://www.datalogic.com
mvsupport@datalogic.com
Impact, Vision Program Manager, VPM, Control Panel Manager, CPM, Digital Serial Link, Pinpoint Pattern
Find, and DSL are trademarks of Datalogic Automation Inc. Microsoft Windows is a trademark of Microsoft
Corporation. Java is a trademark of Sun Microsystems, Inc. Allen-Bradley and Rockwell Automation are
trademarks of Rockwell Automation.
Datalogic and the Datalogic logo are registered trademarks of Datalogic S.p.A. in many countries, including
the U.S.A. and the E.U.
Copyright © 2002-2013 Datalogic Automation Inc. All Rights Reserved
Technical Support
If you have technical questions about the operation of any Datalogic product, contact your distributor or
Datalogic. Please have the following information available before you call:
• The model and serial number of the device, located on the bottom of the unit. The version number of the
Impact software you are running, found in the title bar of the software.
• The type and version number of the operating system software you are running on the client computer.
Impact Settings Reference Guide
T A B L E
Table of Contents
O F
C O N T E N T S
Introduction ...................................................................................... 1
Help ................................................................................................. 1
Starting Settings .............................................................................. 1
Select Camera and Add Device ............................................... 1
Main Toolbar.................................................................................... 2
Design Tab ...................................................................................... 3
Connect to a device, camera, or Emulator ...................................... 3
Settings Tab .................................................................................... 5
General..................................................................................... 5
Properties Tab.................................................................. 5
Setup Tab......................................................................... 6
Device Security Overview ............................................. 16
Camera................................................................................... 19
Camera Properties Tab .................................................. 20
Camera Setup Tab ......................................................... 21
File Camera ............................................................................ 38
File Camera Properties Tab ........................................... 38
File Camera Setup Tab .................................................. 38
System Log ............................................................................ 39
System Log Properties Tab............................................ 40
System Log Setup Tab................................................... 40
File Manager .......................................................................... 40
File Manager Properties Tab.......................................... 41
File Manager Setup Tab................................................. 41
Modbus TCP/IP Server .......................................................... 43
Modbus Server Properties Tab ...................................... 43
AB PCCC Server .................................................................... 44
AB PCCC Server Properties Tab ................................... 44
OPC Data Access .................................................................. 45
OPC Data Access Properties Tab.................................. 45
Index ............................................................................................. 47
TOC-1
Datalogic Automation Inc.
Table of Contents
Datalogic Automation Inc.
Impact Settings Reference Guide
TOC-2
Settings
Introduction
The Settings module is used to configure the Datalogic vision device, including the device’s Internet Protocol (IP) Address, inputs, and outputs. This chapter explains the Settings module and reviews the cameras
you can use with Impact Software, including details of proper setup and calibration on the client computer,
and lighting adjustments.
Help
If you need help while using the Impact software, you can refer to this manual or the online help.
To access online Help, click the Help icon in the toolbar, then click the desired topic in the Table of Contents
in the left pane of the Help window.
Starting Settings
NOTE: Access to some Settings functions is limited based on the security access level.
To start Settings:
1. Double-click the Settings shortcut on the desktop.
2. When Settings starts, it automatically scans for Datalogic devices on the client’s network and displays
the Device Selection list. If the desired device doesn’t appear in the list, click Refresh. If it still doesn’t
appear, check the devices power and Ethernet connections.
Select Camera and Add Device
You can connect to multiple devices or cameras with Settings. Click one of the tabs to display the desired
device or camera. Editing a vision programs on one device or camera while another camera is online and
triggering may cause unexpected results.
Select or Add Device
Add Device tab
You can connect to multiple cameras or devices with Settings. If you are already connected to one or more,
click the Add Camera tab to add another connection. When you click the tab, a dialog is displayed where
you can select the desired device. See “Connect to a device, camera, or Emulator” on page 3.
TIP: If the Add Device tab is not visible, click the VPM Preferences button and clear the "Hide Camera
Tabs" check box.
Page 1
Datalogic Automation Inc.
Main Toolbar
Impact Settings Reference Guide
Main Toolbar
The Settings toolbar is a row of buttons at the top of the Settings window. Some buttons are disabled
depending on the current function selected.
Connect to Device
Click the Connect button to connect Settings to a Datalogic device or Emulator. (See“Connect to a device,
camera, or Emulator” on page 3 for more details.) When you are connected to a device, the button changes
to the Disconnect button. If you close Settings while you are connected to a device or camera, you will see
the following prompt. If you want to automatically reconnect to the device or camera the next time Settings
starts, click Yes.
Device online/offline
This button indicates whether the Datalogic device is online or offline. When the device is online (the switch
is labeled "1"), the device accepts hardware or software triggers. Any tasks that are loaded are executed
when they are triggered by their selected trigger events.
When the device is offline (the switch is labeled "0"), tasks that are loaded remain loaded, but the device
does not accept hardware or software triggers.
Print Options
• Print
This prints a formatted, expanded list of all properties and values in the currently selected system
object. This button is disabled if the file is password protected.
• Print preview
This prints a preview of a formatted, expanded list of all properties and values in the currently selected
system object. This button is disabled if the file is password protected.
• Print to text file
This prints an expanded list of all properties and values in the currently selected system object to a
text file. This button is disabled if the file is password protected.
VPM Preferences
• Use small icons: Small system object icons and toolbar buttons are displayed.
• Hide Camera Tabs - The Select Camera and Add Device tabs are hidden. You can choose this option
to save screen space if you are only working with one camera.
• Font Size: If default is selected, Settings uses Window’s default font size for all displayed text. If Custom is selected, you can enter the font size you want Settings to use. If you are using Settings with a
non-English translation file, we recommend that you use the default size (11).
Datalogic Automation Inc.
Page 2
Impact Settings Reference Guide
Design Tab
Camera Preferences
• Display Refresh Rate: The rate at which the Summary Table and Display tab values are refreshed
while the device is in Trigger Continuously mode or online. If the system is online, this setting affects
only the refresh rate, not the trigger rate.
• Display Refresh Timeout: Occasionally communication timeouts can cause Settings to stop refreshing the Summary Table and Display tab values. The timeout value can be too short for the amount of
information being gathered for display and/or the Datalogic device is being triggered at a rate that
does not allow it to return information to Settings. If a timeout occurs after three consecutive attempts,
a warning is displayed indicating that you should increase this setting.
The timeout can be adjusted from one to thirty seconds; each mark on the scale represents approximately three seconds. You should adjust this timeout value only when necessary.
Help
Click Help to display the Impact Reference Guide, then click the desired topic in the Table of Contents in the
left pane of the Help window.
About Settings
This displays version and build information about Settings.
Design Tab
File Camera/Camera
Click this toggle button to switch between File Camera and Camera mode. See “File Camera” on page 38 for
details about the File Camera. See “Camera” on page 19 for details about Camera setup.
Live Images
When this button is clicked, images are displayed as rapidly as possible. If Camera is selected, and a camera
is connected to the Datalogic device, camera images are acquired and displayed. If File Camera is selected,
all the images in the file camera are displayed, one at a time. No tasks or tools are run in this mode.
Connect to a device, camera, or Emulator
When you connect to a Local Emulator, if it is not already running it is started automatically on the client
computer (or the M-Series processor) and Settings connects to it. The Emulator is intended for creating
vision programs without a Datalogic device or camera since you must have previously captured images to
use it. Programs created in the Emulator are stored on the client computer (or the M-Series processor).
When you connect to a Datalogic device or camera, you can work with either live or previously captured
images (File Camera). Programs you create are stored on the Datalogic device or camera.
IMPORTANT: Any program that controls outputs on a device or camera that are connected to and control
external mechanical equipment can cause that equipment to operate when the program runs.
There are three ways you can initiate a connection to a Datalogic device, camera, or Emulator:
• when Settings first starts
• when Settings is not currently connected
Page 3
Datalogic Automation Inc.
Connect to a device, camera, or Emulator
Impact Settings Reference Guide
• when Settings is already connected to one or more devices, cameras, or Emulators
When Settings first starts
When Settings first starts, a dialog is displayed so you can choose what connection you want to make. See
“To choose a device, camera, or Emulator connection:” on page 4.
When Settings is not currently connected
If Settings is not currently connected to a device, camera, or Emulator, click the Connect button in the Settings toolbar to initiate a connection. A dialog is displayed so you can choose what connection you want to
make. See “To choose a device, camera, or Emulator connection:” on page 4.
When Settings is already connected to one or more devices, cameras, or
Emulators
To disconnect from a device, camera, or Emulator so you can connect to a different device, click the Connect
button in the Settings toolbar. After the disconnection is complete, click the Connect button again to connect
to make another connection. See “To choose a device, camera, or Emulator connection:” on page 4.
To maintain current connections and connect to an additional device, click the Add device tab. If the Add
Device tab is not visible, click the VPM Preferences button and clear the "Hide Camera Tabs" check box.
Add device
Another tab will be added to the row.
To choose a device, camera, or Emulator connection:
TIP: Details about a
device selected in
the list are displayed
at the bottom of the
dialog.
1. Select one or more items from the list (press CTL while you click to select multiple items). An Emulator appears in the list with Local Emulator as part of its name.
2. Click Connect to Impact.
If security is enabled on the device, the User Logon dialog is displayed. When a valid User ID and
password have been entered, Settings will connect with the device, camera, or Emulator.
Datalogic Automation Inc.
Page 4
Impact Settings Reference Guide
Settings Tab
• Devices found
This list displays the names, IP addresses, and other information about the Datalogic devices and
Emulators connected to the network.
• Connect to Device
Click this to connect to the devices selected in the list.
• Edit IP Address...
To change the IP address of the selected device, click this button. See “Camera” on page 19 for more
details.
3. When the connection has been made, you may see a message that Settings is reading from the newly
connected device or camera.
Settings Tab
You must be connected to a Datalogic device or camera to access the Settings tab. See “Connect to a device,
camera, or Emulator” on page 3.
You can access parts of the Datalogic device or camera through the system objects on the Settings Tab
shown in the Design view. Every object has the general properties of Name, Description, and type. Some
system objects have other inputs and outputs. Most system objects have both a Setup and a Properties tab.
NOTE: Some tabs, panels, and fields may be disabled when the device or camera is online. Access to some
Settings functions is limited based on the security access level. See “Device Security Overview” on page 16
for details.
General
The General system object allows access to system parameters on the Datalogic device or camera. The General system object’s Properties tab shows some of the parameters. The Setup tab lets you set additional system parameters.
P r o p e r t i e s Ta b
Page 5
Input Name
What it is
Device Name
The device or camera name. For example, Bearing Diameter Inspection.
This name appears in the Device Connection dialog.
Device Comment
A comment about the device or camera. For example, Inspects Bearing
Diameter. This comment appears in the Device Connection dialog.
Task Timeout
See “Enable Timeout” on page 10.
Output Name
What it is
System Time
The current time on the device (the number of seconds elapsed since
January 1, 1970).
CPU Temperature
The temperature on the processor board (in degrees Celsius)
Datalogic Automation Inc.
General
Impact Settings Reference Guide
Output Name
What it is
Available RAM
The amount of RAM (in bytes). This number remains static while the system is online.
Model
The model number
Serial Number
The serial number. M-Series cameras include the camera number.
Software Version
The Impact software version (Major version.minor version.sub-minor
version Build number)
Kernel Version
The operating system software version (Major version.minor version.sub-minor version Build number)
Firmware Version
The firmware version
Board ID
The identification number
HTTP Port
The system port the Datalogic device or camera is using for HTTP commands
S e t u p Ta b
NOTE: Access to functions on this tab may be limited based on a user’s access level and while the device is
online.
General Panel
Device Name
The device name can contain any combination of letters or numbers up to 25 characters in length. There may
be multiple Datalogic devices on the network with the same name, although this may cause confusion.
IP Address, IP Gateway, and IP Mask
Note: Usually you will not need to use the IP Gateway address. Just leave it blank.
The IP Mask and Address on the client or M-Series processer and Datalogic device or camera work together
so data can be exchanged. The IP Mask is network dependent, but it is the same for each Datalogic device or
camera on a particular network. The IP Address must be unique to each device if there is more than one on a
network.
Note: Do not attempt to change the IP Address or Mask without the authorization of your network administrator; doing so could disrupt your network connection.
To be able to communicate with the Datalogic device, a client computer’s IP Mask and Address must be
configured correctly. During address configuration, we recommend that the client computer and the device
be connected directly to each other and not through a network server (A, T, or C-Series only).
Changing the IP Address through the Device Setup tab.
Changing the IP Address through the Device Setup tab applies only to the A, T, and C-Series.
Datalogic Automation Inc.
Page 6
Impact Settings Reference Guide
General
You may need to change the client computer’s mask and address to match the desired device or camera IP
Address. Use one of the following procedures.
Changing the client computer’s addresses: Windows 7 (A, T, and C-Series)
1. In the Start Menu, select Computer, Network, then click Network and Sharing Center.
2. Under "View Your Active Networks," click Local Area Connection.
3. Click Internet Protocol Version 4 in the list, then click Properties.
4. On the Alternate Configuration tab, select User Configured.
5. Enter the desired IP address and Subnet Mask. Remember, to be able to communicate with the device
or camera, a client computer’s Subnet mask must correspond correctly to the device or camera’s IP
mask, and the address must match the device or camera’s address in the first three sets of numbers.
6. Click OK, then close all the open dialog windows.
Changing the client’s mask and address: Windows XP (A, T, and C-Series)
1. In the Start menu, right click on My Network Places and select Properties.
2. Right click on Local Area Connections and select Properties.
3. On the General tab, select Internet Protocol (TCP/IP) and click Properties.
4. On the Alternate Configuration tab, select User Configured.
5. Enter the IP Address 192.168.0.1 and the Subnet Mask 255.255.255.0, then click OK to close all the
dialog windows.
Changing the M-Series Processor’s IP Address (Windows XP)
IMPORTANT NOTE: Change only the Local Area Connection named LAN1 or LAN2. These correspond to
Ethernet Ports 1 and 2 on the front of the processor.
DO NOT change any of the other Local Area Connections. Changing any other connection can cause the MSeries cameras to stop functioning.
1. In the Start menu, right click on My Network Places and select Properties.
2. Right click Local Area Connection LAN1 or LAN2 and select Properties.
3. On the General tab, select Internet Protocol (TCP/IP) and click Properties.
4. On the General tab, select Use the following IP address.
5. Enter the desired IP address.
6. Click OK to close all the open dialog windows.
Page 7
Datalogic Automation Inc.
General
Impact Settings Reference Guide
Changing the M-Series Processor’s IP Address (Windows 7)
IMPORTANT NOTE: Change only the Local Area Connection named LAN1 or LAN2. These correspond to
Ethernet Ports 1 and 2 on the front of the processor.
DO NOT change any of the other connections. Changing any other connection can cause the M-Series cameras to stop functioning.
1. In the Start menu, click on Control Panel.
2. Under Network and Internet, click on View Network Status and Tasks.
3. On the left side of the screen, click Change Adapter Settings.
4. Right click LAN1 or LAN 2 and select Properties.
Datalogic Automation Inc.
Page 8
Impact Settings Reference Guide
General
5. In the list of items, select Internet Protocol Version 4 (TCP/IPv4), then click Properties.
6. Select Use the following IP address.
7. Enter the desired IP address.
8. Click OK to close all the open dialog windows.
Changing the device or camera’s Mask and Address (A, T, and C-Series)
To change the device or camera’s IP Mask and Address, you must know the current IP Address and Mask so
you can configure the client correctly. The Datalogic Impact device or camera is shipped with a default IP
Address of 192.168.0.128 and a default Mask of 255.255.255.0.
IMPORTANT: If you change a device or camera’s Mask or Address, be sure to record the new values.
IMPORTANT: Do NOT include a leading zero in an IP Address group (for example 192.168.108.065)
1. Be sure that the client computer’s IP Address and Mask are set correctly. Connect the client computer
and device or camera’s Ethernet ports directly using an Ethernet cable (A, T, and C-Series only) and
turn on power to the device.
2. Connect to the desired device or camera. See “Connect to a device, camera, or Emulator” on page 3.
IMPORTANT NOTE: If you intend to change both the IP Address and the IP Mask, do not Reboot
until you have changed them both. After you change the IP Address, you will see a message that states
you must reboot for the changes to take effect. Do not reboot until after you have changed both the
Mask and the Address.
Page 9
Datalogic Automation Inc.
General
Impact Settings Reference Guide
3. When the connection has been made, click the General System Object, click the Setup tab, then click
the General radio button. Enter the new IP Mask and/or IP Address in the appropriate field(s). Record
the new value (along with the serial number) and store it where you can find it again.
4. Click the Diagnostics radio button, then click the Reboot device button. You must reboot to make the
changes take effect in the device or camera.
IP Gateway
The IP Gateway address is used when you want to access an IP Address through a router. You will ordinarily
leave this field blank.
Device Comment
The comment can contain notes about the device or camera such as its function, the physical location, what
it is inspecting, or when it was put into service. This comment is displayed on the Device Selection tab.
Go Online When Device Starts
Check this box if you want the device to go Online when it starts. Any tasks that are loaded are executed,
based on their trigger parameters. To mark which tasks get loaded when the device starts, see “File Manager
Setup Tab” on page 41.
Connections
• Maximum
The maximum number of users at each level (1 to 100) that can be connected to this device at one
time. When multiple users connect to one device, they should be aware that the final data changes
saved to the device will overwrite any changes previously made by other users. Also, data cannot be
changed on a device that is locked.
• Current
The number of users at each level currently connected to the device.
Device Date/Time
This displays the current date and time stored on the device. To set the device date and time to match the client computer’s, click Synchronize to PC.
NOTE: The Datalogic device does not automatically adjust for daylight savings time changes. You will need
to manually synchronize it.
Enable Timeout
Here you can define the maximum length of time a task may take to execute, and the maximum length of
time the Data Transfer tool will wait for a response from a control panel.
NOTE: Task Timeout applies only to tasks with the Trigger Event set to Image In Event and is effective only
while the device is online and triggering.
Datalogic Automation Inc.
Page 10
Impact Settings Reference Guide
General
• Task - When this property is enabled, the Task Timeout value determines how much time the task has
to complete execution before it aborts.
If the task’s Trigger Event type is set to "Image In Event," the time starts when the camera trigger is
complete, not at the beginning of task execution. For all other Trigger Event settings, the time starts
when task execution begins. The timing accuracy depends on the tools in the task, but it is generally
accurate to within a few milliseconds.
For example, if Task Timeout is enabled, and the Timeout value is set for 10,000 milliseconds, a task
will run until it completes or 10,000 milliseconds has elapsed, whichever comes first. If the Task
Timeout occurs first, and Abort On Error is True, the Abort Task runs, if one is defined. If Abort On
Error is False, then the task keeps running and any remaining tools abort and fail.
• Data Transfer Tool - When if this property is enabled, the Timeout value indicates the maximum
length of time a Data Transfer tool will wait for a control panel response before it stops trying to send
data to it. For example, if the timeout is enabled, and the Timeout value is set for 10,000 milliseconds,
if the control panel does not respond to the Data Transfer tool’s command within 10,000 milliseconds,
the data transfer is terminated.
Settings Files
This section lets you select what device settings are saved and printed. Both is selected by default. To copy
settings files from one device to another, see “To copy settings files from one device to another” on page 12.
IMPORTANT NOTE: Settings files contain information about which vision programs should be loaded
when the device starts. Since vision program files are not copied to the Datalogic device when you backup
and restore the settings file, some vision programs may not get loaded when the device starts. It is the system
programmers responsibility to insure that the proper vision program files are copied to the device.
• Camera Calibration Only: When you click Backup, the settings displayed on the Camera System
Object - Setup Tab - Calibration panel are saved to the client. Restore sends the camera calibrations
from the client’s file to the device. Calibration settings are also saved whenever the calibration is
changed.
Device Settings Only: When you click Backup, the settings displayed on the General System Object
are saved to the client. Restore sends the device settings from the client’s file to the device.
Both: Both the Camera Calibration and Device Settings are backed up or restored.
• OPC Data Access: When you click Backup, the OPC data settings displayed on the OPC Data Access
System Object are saved to the client. Restore sends the device settings from the client’s file to the
device.
IMPORTANT NOTE: Restore will overwrite any existing settings on the device with those currently on
the client computer. If more than one client computer is connected to the device, the most recently restored
settings are kept on the device.
• Restore: The Restore button sends device settings currently saved on the client computer to the
device. Vision program files are not copied to the device. See “Folder List” on page 41 for image file
copying details.
IMPORTANT NOTE: The client computer will backup the settings for only one Datalogic device at a
time. Only the currently connected device’s settings are backed up. Any previously saved settings are overwritten.
Page 11
Datalogic Automation Inc.
General
Impact Settings Reference Guide
• Backup: The Backup button saves the selected settings from the device to the client computer. Vision
program files are not copied from the device. See “File List” on page 42 for image and vision program
file copying details.
To copy settings files from one device to another
1. Connect to the source device (where you are copying from).
2. Click the Settings Tab - General - Setup - General panel
3. In the Settings Files group, select the Device Settings Only radio button.
4. Click Backup.
5. Disconnect from the source device.
6. Connect to the destination device (where you are copying to).
7. Click the Settings Tab - General - Setup - General panel
8. In the Settings Files group, select the Device Settings Only radio button.
9. Click Restore.
10. Disconnect from the destination device.
11. Repeat steps 6 through 9 to copy the files to other destination devices.
Camera Type
This selection is enabled only when you have a camera connected to a C-Series device.
• DSL: Click this radio button when you are using a Digital Serial Link (DSL) camera. The camera type
is automatically detected and displayed in the Camera system object’s Setup - Calibration screen.
• CameraLink: Click this radio button when you are using a Camera Link camera. Select the camera
type from the dropdown list.
Communication Panel
Shift Source
This setting determines how the device responds to the hardware signal as an active input on the shift trigger
input.
• Camera Triggers - This indicates that the device should use the trigger input as the shift input. (The
shift event will occur simultaneously with the camera trigger.) This allows you to synchronize camera
triggers and shift events in inspection tasks.
• Rising Edge - An active shift input is indicated by a voltage increase on the shift input.
• Falling Edge - An active shift input is indicated by a voltage decrease on the shift input.
• Both Edges - An active shift input is indicated by a voltage increase and decrease (two triggers per
input cycle) on the shift input. (Not available on M-Series processors)
Input Debounce
Here you can define the debounce time for two types of device trigger signals (shift, and event). Debounce
determines the maximum trigger rate the system will allow (basically like a governor on an engine) to help
prevent negative effects from noise and high frequency bursts. The debounce setting must be able to filter
out noise while not introducing any unnecessary delays. You may need to try several different Delay and
Holdoff settings to find the optimum combination.
Datalogic Automation Inc.
Page 12
Impact Settings Reference Guide
General
NOTE: The M-Series Cameras support Delay Debounce on the Trigger input (Frame Trigger on Line Scan
camera).
The M-Series Cameras do not support Holdoff Debounce on the Trigger or Frame Trigger, only Delay
Debounce.
The M-Series Line Scan Camera does not support any Debounce setting on the Line Trigger.
The M-Series Processor does not support any Debounce setting on Event Inputs.
Third-party cameras have varying Delay and Holdoff Input Debounce settings. Refer to the M-Series Camera and Processor Guide (843-0138) for details.
• Delay: The debounce timer starts when the hardware signal’s rising edge is detected, and stops when
the trailing edge is detected. The input must remain high for the delay amount of time for the camera
or event to be triggered.
Delay is good for filtering random noise on the input, but delay makes the time between the input signal’s edge and the system triggering speed-dependent, especially on high-speed inspections. Use a
Delay time that is long enough to filter out the worst expected noise, but short enough to accommodate your fastest inspection times.
Delay Timing Diagram
• Holdoff: The shift, or event is triggered when the hardware signal’s rising edge is detected, but
another rising edge will not trigger the input until the Holdoff time has elapsed.
Holdoff is good for noise on the signal’s leading edge and it is not speed-dependent, but it is susceptible to random noise on the input signal. Use a Holdoff time long enough to reject leading edge noise,
but not so long that the inspection rate is limited.
Holdoff Timing Diagram
Enable OPC/ActiveX Server
If this check box is checked, the OPC/ActiveX Server on the device will be started each time the device
starts. This server must be running if you are using OPC Data Access (refer to the OPC Server Reference
Guide 843-0136) or the Impact ActiveX Interface (refer to the Impact ActiveX Reference Guide 843-0119).
TCP/IP
This is the device’s Ethernet input port number where the device "listens" for a TCP/IP message. When a
message is received on this port, the device triggers the TCP/IP event and tasks that have the Task Trigger
event set to TCP/IP are queued to run.
Page 13
Datalogic Automation Inc.
General
Impact Settings Reference Guide
You can use VPM’s TCP/IP Out tool in a task in another device to send messages to this port. The port number used in that TCP/IP Out tool should be the same as this port number. However, as the communication is
one-way, the input port number cannot be the same on both devices.
Click the Edit button to change or delete the hex-value delimiter characters that indicate the end of a data
string. In the Create Delimiter Sequence dialog, select a character from the list, then click Append, or click
Clear to delete the delimiter. Click OK when the sequence is defined.
Serial Port
This section defines the parameters for the device’s serial port that will be used by VPM’s Serial Port Out
and Serial Port In tools. Consult the documentation for the requirements of the device you are connecting to
the Datalogic device’s serial port, then set these values accordingly. The serial port does not support hardware (CTS/RTS) or software (Xon/Xoff) data flow control. Datalogic devices support only RS-232 communication protocol. RS-485 is not supported. The Emulator has no serial port.
• Speed: The device or camera’s data transmission rate. Settings defaults to 115,200 when it is installed.
• Parity: The number of parity bits used.
• Data Bits: The number of data bits used.
• Stop Bits: The number of stop bits used.
• Delimiter: (This Delimiter character is used only by the Serial Port In tool.). The delimiter is placed
at the end of the input string when it is transmitted. The receiving device’s Serial Port Delimiter must
match this setting.
When the Datalogic device detects a delimiter in the data string, it creates a Serial Input task trigger
event. If no delimiter is defined, an event is created after every character in the data. To create the
Delimiter, in the Create Delimiter Sequence dialog, select a character from the list, then click Append.
Click OK when the sequence is defined.
NOTES for M-Series processors:
The M-Series processor will only accept one delimiter character in the data string.
The M-Series processor has two serial ports. Serial port 1 is controlled by Camera 1 (CAM1) and Serial port
2 is controlled by Camera 2 (CAM2).
Diagnostics Panel
NOTE: Access to functions on this tab may be limited based on a user’s access level and while the device is
online.
The Diagnostics tab lets you run diagnostic tests on various functions of the Datalogic device.
Outputs
Click these buttons turn individual outputs on and off. The indicator beside the button will turn green when
the input is on. If you connect a "loopback" connection between an output and an input, you should see the
state change in the Inputs section of this tab.
Strobes
Use this function to test your strobe outputs. When you click a strobe button, the corresponding output will
pulse for 30 microseconds.
Options
Datalogic Automation Inc.
Page 14
Impact Settings Reference Guide
General
I/O Polling Rate
Enter a number from 50 to 10,000 milliseconds. Settings polls the Datalogic device at this rate and updates
all the indicators on the Diagnostics tab.
NOTE: Enable System Log Trace only when you need to trace all system events. For instance, if you are
having trouble tracking down an intermittent problem with a vision program. The system log can quickly
become filled with entries and system performance can be affected, depending on the program’s complexity.
Enable System Log Trace
When this is checked, all system events that occur on the device are entered in the system log. This includes
events, task and tool run completion, and many other occurrences that would not ordinarily get logged.
Inputs
This section shows the current state of each of the device’s inputs. (Settings polls the device at the I/O Polling Rate shown.) A green colored indicator means the input is On. If the input change rate is too fast, the
indicator may not switch quickly enough to indicate the true current state.
Events
This section shows the hardware signal frequency on the device’s trigger, shift, or event inputs (in Hz).
These values are inactive if the device is not online and receiving hardware trigger signals. The appropriate
Trigger Event property must also be set.
Trigger Rate: The signal on the Trigger Input. A task that has the Trigger Event property set to one of the
types of Image Trigger Event must be loaded.
Shift Rate: The signal on the Shift Input. A task must be loaded that has the Trigger Event property set to
one of the types of Shift Event must be loaded.
Event Rate: The signal on the Event Input. A task must be loaded that has the Trigger Event property set to
one of the types of Input Event must be loaded.
Reboot Device
Click this button to restart the Datalogic device. All tasks stop executing and all vision programs are
unloaded. (This has the same effect as pressing the Reset button on the device.)
When the device restart has completed, any vision programs set to load on startup are loaded and tasks in
those vision programs are queued to execute when they are triggered. See “File Manager Setup Tab” on page
41 for setting vision programs to load on startup.
IMPORTANT NOTE: The device must completely reboot (the Stat indicator light is off) before you can
connect to it.
Advanced
This button presents a menu of advanced functions.
• Calibration Editor - When you save images in Settings, the lens calibration information is stored
with them. You can edit the calibration values, or copy that information to other image files.
• Memory Meter - This utility displays the current memory usage for a device. The amount of available memory shown is not updated while the device is online.
• TCP Tester - This utility emulates a device to test Ethernet data transfer between the client and Datalogic devices.
• Modbus TCP/IP Client - Send commands to and read information directly from the device Modbus
TCP/IP Server using Modbus TCP/IP protocol. (Datalogic does not support serial Modbus protocol.)
Page 15
Datalogic Automation Inc.
General
Impact Settings Reference Guide
Save Image Buffers
NOTE: This button is disabled for T4x-Series, M-Series, and A30 cameras.
This advanced troubleshooting function is intended to be used to find an image that causes the Datalogic
device to stop responding. If a Device crashes, and you suspect it may be caused by processing a specific
image, follow the steps below. This button is disabled if Settings is connected to an Emulator.
To Save the Image Buffers
1. Do NOT cycle power! This will alter the pixels in the image buffers.
2. If the Datalogic Device is set to go online on start up, disconnect all trigger sources before proceeding.
Triggering will overwrite the image buffers.
3. Push the reset button on the device. It is located near the power connector on the C-Series and T-Series
Devices, and on the back panel of the A-Series device.
4. Wait for the device to restart. The restart is complete when the status light turns off.
5. Start Settings and connect to the device.
6. Go to the Settings tab, General icon, Diagnostics panel.
7. Press the “Save Image Buffers” button. The saving process will take about 20 seconds as it is saving
~20 MB of images
8. Go to the File Camera icon, Setup tab. You will see available images named “DiagnosticBuffer000”,
“DiagnosticBuffer001”, etc. The number of buffers will vary with the camera type and partial scan settings.
9. Select the diagnostic buffer images and activate them.
10. Load the vision program files that were running when the device crashed.
11. Go to the ImageIn task and cycle through the images using the “Trigger Once” button.
12. You are trying to find one of the images that caused the Datalogic device to crash. You can tell that the
device has crashed when the Trigger Once button fails to come back within a few seconds, the Device's
status light stays on and, eventually, Settings reports a “Connection Problem.”
13. The image that crashed the device is the next one after the one currently displayed in the Settings
image window. For example, if DiagnosticBuffer010.png is displayed in the image window, then
DiagnosticBuffer011.png is the one you want.
14. Push the reset button on the Datalogic device and wait for the device to restart.
15. Go to the Settings tab, File Manager icon, select the suspect image file in the Images directory, and
copy it to your PC.
16. Send the image file and your vision program files to Datalogic for diagnosis.
Administration Panel
NOTE: Access to this tab is limited to users with an Administrator access level. Some options are unavailable while the device is online.
Device Security Overview
Datalogic device security resides in each device. (Control panel applications and vision programs can be
password protected separately. You must connect and log on to a device to modify security for that device.
When you attempt to connect to a device that has security enabled, you will have to enter a valid User ID
and password. The User ID will determine your security level. Some functions are limited based on the
Datalogic Automation Inc.
Page 16
Impact Settings Reference Guide
General
user’s security level. Control Panel designers can check for the user’s security level and allow access to specific functions based on that level.
Enable Security
Security for each Datalogic device resides in the device. If the Enable Security check box is checked security is enabled, and whenever the device starts, the logon screen is displayed. The user cannot gain access to
the device until a valid User ID and password have been entered. For more details, see “Device Security
Overview” on page 16. There must be at least one Administration level user defined to enable security.
Users
• User ID and Level: All currently defined users and their access levels are displayed in this list.
Access to a device is determined by the access level assigned to each User ID. Access to functions on
Control Panels is assigned by the Control Panel creator. The following access levels can be assigned,
with Administrator level having full access to all functions.
• Administrator: modify images, adjust inspection settings, put the device online and offline, modify
vision program parameters, create and edit vision programs, make device and camera settings, and
modify system security.
Note: Before you can enable security on the device, there must be at least one Administration level
user defined. (See “Enable Security” on page 17.)
• Programmer: modify images, adjust inspection settings, put the device online and offline, modify
vision program parameters, create and edit vision programs, and change device and camera settings.
Programmer level cannot change security settings or passwords.
• Controller: view images; adjust some inspection settings, and put the device online and offline; and
modify some vision program parameters. Controller level cannot change security settings or passwords.
• Operator: view images, adjust some inspection settings, and put the device online and offline.
• Monitor: View inspection fields and values as allowed by Control Panel security; view vision program parameters, and control functions; modify values as allowed by Control Panel security; and view
all fields on the Device Information tab. Monitor level cannot change passwords.
To add a User
1. Click the Add User button.
2. Enter a User ID. It may be contain any letter or number. For example, this may be a name, a shift designation, or some other unique identifier. The User ID is case sensitive.
3. Select the access level from the drop-down list.
4. Enter a password in the Password field. See page 1-18 for more about passwords. Asterisks are displayed for the password. The password is case sensitive.
5. Enter the same password again in the Confirm Password field. Asterisks are displayed for the password.
6. If you want the user’s password to expire after a fixed time period, check the Number of days before
password expires check box and enter the number of days. Administrator level passwords never expire.
7. If you want anyone (including Administrators) to be able to change this password, check the Can
Change Password check box.
8. Click the OK button.
To modify a User
1. Select the User ID you want to modify.
Page 17
Datalogic Automation Inc.
General
Impact Settings Reference Guide
2. Click the Modify User button.
3. Change the desired field. If you change the password, you will have to enter the new password again in
the Confirm Password field.
4. Click the OK button.
To delete a User
1. Select the User ID you want to delete.
2. Click the Delete User button.
3. Click the Yes button to confirm the deletion.
Install Users on Multiple Devices
You can copy the User IDs and passwords from the connected device to another device.
To install Users on multiple devices
1. Click Install, then select the target devices for the User IDs and passwords.
NOTE: Any existing User IDs and passwords on the selected devices are overwritten.
2. Click OK.
Passwords
Passwords are case sensitive, can contain any ASCII character (except CR or LF), and must be at least as
long as the Minimum Character Length defined in the Passwords group. They are displayed as asterisks in
entry fields. The Minimum Character Length and Password Reuse values apply to all passwords.
• Minimum Character Length: Specifies the minimum number of characters all newly defined system
passwords must contain. Existing passwords are not be affected.
• Password Reuse
Number of Passwords: If Password Expires is enabled, this is the minimum number of new passwords that must be used before an old password can be used again. A zero indicates passwords can be
reused immediately.
Minimum Days: If Password Expires is enabled, this is the minimum number of days that must pass
before a password that has already been used can be used again. A zero indicates passwords can be
reused immediately.
You can also modify a password during logon.
To modify a password during logon
A user cannot change their password unless the "Can Change Password" check box is checked. (See “To add
a User” on page 17.)
1. Click the Connect button, select a device from the Device Selection list, then click OK.
2. When the User Logon dialog is displayed, click Change Password.
3. Enter the User ID and the Old Password for that User ID.
4. Enter the New Password and type the same password in the Confirm Password field.
5. Click Log On.
Client Directory
The Client directory contains all of the files used by the Impact software. It is stored in the default directory
on the client computer during installation, but it may be stored in a folder of your choice.
Datalogic Automation Inc.
Page 18
Impact Settings Reference Guide
Camera
To change the Client directory
1. Type in a directory path and name, or click Browse to locate the desired directory. If the directory is
located on a network, be sure all clients have access to it.
Tool Activation
Some VPM tools require a Software License Key to be activated before you can use them. The Tool Activation dialog displays the current status of activated tools, and lets you enter the Software License Key for new
tools.
• Software License Key: Enter the number provided by Datalogic.
• License States: This area lists all the currently active tools and their license numbers.
About Panel
NOTE: All users have access to this tab regardless of their access level.
When you click the Connect button, Impact software automatically scans for Datalogic devices on the network and displays their names, IP addresses, and other device information in the device selection list. When
the client connects to the device, it determines the device’s hardware configuration and current status and
displays it on this panel. None of the information on this tab can be modified.
Storage
Storage is the device memory used to store the device’s operating system software and firmware and userdefined vision programs.
Memory
Memory is the device memory that stores dynamic vision program data. The amount of available memory
shown is not updated while the device is online.
Vision Device Information
This device system information is for display only. Technical support personnel may ask you for this information if you call for assistance.
Camera Information
This camera information is for display only. Technical support personnel may ask you for this information if
you call for assistance.
Camera
The Camera system object accesses and sets some of the device’s camera parameters.
NOTES: The range of acceptable values for each input is determined by the camera type.
Changing any of these properties while the camera is being triggered and acquiring images can cause the
images to be corrupted. The camera should be offline or triggers should be stopped while these properties
are being changed.
Page 19
Datalogic Automation Inc.
Camera
Impact Settings Reference Guide
C a m e r a P r o p e r t i e s Ta b
Input Name
What it is
Digital Shift
Digital shift provides digital gain for the image.
Gain
Gain adjusts the actual signal intensity from the camera.Gain adjusts the
actual signal intensity from the camera.
NOTE: The gain setting for M-Series cameras is the “raw” gain setting,
not a percentage gain. The range of values will vary from camera to
camera. In all cases the recommended value is the minimum gain, which
corresponds to 0dB.
Offset
Offset adjusts the zero grey-level setting for the camera. Adjusting the
offset causes the entire image to brighten or darken. Images become
darker as the offset is increased.
Shutter Speed
Shutter Speed (Open Time) indicates the amount of time the shutter is
open. The higher the number, the longer the shutter is open and the
brighter the image.
Next Image Number
This number is appended to the image name which is displayed at the
top of the image display window. The number is incremented by one for
each subsequent image snapped.
Image Scan Left
Edge
This value sets the left edge where the camera’s horizontal scan starts.
The default value is determined by the camera type. (See *Note below
this table)
Image Scan Right
Edge
This value sets the right edge where the camera’s horizontal scan stops.
The default value is determined by the camera type. (See *Note below
this table)
Image Scan Top
Edge
This value sets the top edge where the camera’s vertical scan starts.
The default value is determined by the camera type. (See *Note below
this table)
Image Scan Bottom Edge
This value sets the bottom edge where the camera’s vertical scan stops.
The default value is determined by the camera type. (See *Note below
this table)
Line Trigger PreDivider
See “Frequency Converter” on page 28.
Line Trigger Multiplier
See “Frequency Converter” on page 28.
Line Trigger Divider
See “Frequency Converter” on page 28.
Units Per Pixel
Units per Pixel is the scale factor for converting measurements in the
image to "real world" units. See “Calibrate Manually” on page 33 for
details.
Camera Trigger
Edge Type
This value sets the Camera Trigger type as follows:
0 = Rising Edge
1 = Falling Edge
2 = Both Edges (See “Trigger Tab” on page 23)
Datalogic Automation Inc.
Page 20
Impact Settings Reference Guide
Camera
Input Name
What it is
Strobe 1 Duration
Strobe 1 pulse length in microseconds
Strobe 2 Duration
Strobe 2 pulse length in microseconds
Strobe 3 Duration
Strobe 3 pulse length in microseconds
*NOTE: If the Impact device is Online when any Image Scan value is changed, the device stays Online but
camera triggers are temporarily disabled and the image buffer is reallocated based on the new value. The
image currently in the image buffer may be overwritten when a new image is acquired based on the new
Image Scan value.
Output Name
What it is
Acquisition Time
The amount of time taken to acquire the current image
Number of Buffered Images
The number of images in the device’s image buffer
Model
The device’s model
Lens Distortion Calibration Enabled
If True, distortion calibration is enabled
Real World Origin
This is the X and Y coordinate location (in pixels), and the rotation angle
(in degrees) of the image’s upper left corner relative to the upper left corner of the image display.
Serial Number
The device’s serial number
C a m e r a S e t u p Ta b
NOTE: Access to functions on this panel may be limited based on a user’s access level and while the device
is online.
Datalogic’s digital cameras contain no hardware switches so all operating parameters must be set from here.
This section provides details about each of the Camera System Object Setup tab options. (Available options
are dependent on camera type.)
Setup Panel
Snap
Click the Snap button to acquire and display an image in the image window. You can use this to see how
camera settings affect the image, or to position objects within the camera’s field of view. The acquired image
is also displayed in the image display area of the Design and Display tabs.
Live
Click the Live button to continuously acquire images and display images in the image window until you
click the Snap or Live buttons. You can use this to see how camera settings affect the image, or to position
objects within the camera’s field of view. The acquired image is also displayed in the image display area of
the Design and Display tabs.
Page 21
Datalogic Automation Inc.
Camera
Impact Settings Reference Guide
Image Source
The type of camera currently acquiring images.
Frames per Second
This field indicates the number of frames the Datalogic device can capture and process per second. It is calculated based on the current Shutter Open Time, Partial Scan line and Half Resolution Mode settings.
General Tab
Shutter
Shutter Open Time indicates the amount of time the shutter will be open. The longer the shutter is open (a
higher number), the brighter the image. A shutter open time that is too low can cause the inspected image to
be too dark. Higher shutter open times will decrease the number of frames per second acquired and may blur
the image. You can enter the value in the field or use the slider. The range of acceptable values is determined
by the camera type.
Dalsa Shutter / Exposure
The Dalsa camera is automatically configured for timed shutter mode. The shutter time, which can be
adjusted in VPM in Settings - Camera - General tab, is the exposure time PER LINE, just like the M5xx
cameras.
When the system is Online, the Line Trigger starts the exposure for each line, so it is very important that the
line trigger period be longer than the shutter time. If the line trigger rate is too fast, then some triggers will be
ignored.
When the system is Offline and you are using the Snap, Live, or Trigger buttons, the line triggers are internally generated by the camera at the rate of the shutter time. This allows you to acquire images without wiring any inputs, although the images will be distorted because the line trigger rate is different. You can only
see accurate images when the system is Online.
Strobe Pulse Length (microseconds)
Enter the number of microseconds (from 0 to 500) that you want each strobe to be on. The strobe pulse
length must be coordinated with the shutter open time to provide optimum image capture and eliminate
image blur. (A zero value will turn the strobe off.)
NOTE: Some third-party cameras do not have a Strobe Pulse Length setting. The strobe trigger pulse width
coincides with the camera shutter speed open time setting so that it turns on when the exposure starts (shutter
opens) and turns off when the exposure ends (shutter closes). Line scan cameras do not have a strobe output.
Advanced Button
Strobe Trigger
Select the type of trigger that the strobe you are using requires.
Rising - The output is normally off and a positive going signal is generated for the camera’s strobe.
Falling - The output is normally on and a negative going signal is generated for the camera’s strobe.
Gain
Gain adjusts the actual signal intensity from the camera. Doubling the gain value has the same effect as
opening the camera lens aperture approximately one f-stop. The range of acceptable values is determined by
the camera type.
Datalogic Automation Inc.
Page 22
Impact Settings Reference Guide
Camera
NOTE: The gain setting for M-Series cameras is the “raw” gain setting. The range of values will vary from
camera to camera. In all cases the recommended value is the minimum gain, which corresponds to 0dB. For
example, the minimum gain setting for the M200 camera is 320 which corresponds to a gain of 0 dB.
Offset
Offset adjusts the zero grey-level setting for the camera. Adjusting the offset causes the entire image to
brighten or darken. Images become darker as the offset is increased.
Trigger Tab
Trigger On
This setting determines how the Datalogic device responds to the hardware signal as an active input on the
camera trigger input or how it is triggered automatically. Refer to the device’s hardware guide for appropriate trigger voltage levels. The device must be Online to respond to a hardware trigger input signal or to automatic triggers.
NOTE: When it is triggered while in File Camera mode, the device will always acquire the next File Camera
image, not a live camera image.
• Rising Edge - An input signal is indicated by a trigger input voltage increase.
• Falling Edge - An input signal is indicated by a trigger input voltage decrease.
• Both Edges - An input signal is indicated by a trigger input voltage increase and decrease (two triggers per input cycle). (Not available on M-Series processors)
NOTE: While either Auto-trigger or Periodic Auto-trigger mode is active, the device will ignore any hardware trigger signals. Select one of the above modes if you want to use hardware triggers.
Self-Paced Auto-trigger - This is a self-paced Auto-trigger mode. The camera is automatically
triggered at the fastest rate possible without overrunning image buffers. The trigger interval is the
sum of either the camera’s acquire time or the ImageIn task’s execution time (whichever is greater),
and the Delay time. Each time the camera starts processing an image, it triggers the next image, so
that the acquisition and processing happen in parallel. This means that the acquire rate adapts to the
processing rate so the device cannot overrun the image buffers.
How to activate Auto-Trigger mode
a) If the Auto-trigger When Online check box is checked, automatic triggers will start when the
device goes Online and stop when it goes Offline. The Start/Stop Auto-trigger button is
disabled. No other Start/Stop control is available.
b) If the Auto-trigger When Online check box is NOT checked, the device must be Online to
enable the Start/Stop Auto-trigger button. Automatic triggers will start when the Start/Stop
Auto-trigger button is clicked on and stop when it is clicked off.
How Auto-trigger mode works
After an image is acquired and the ImageIn task begins, the next image acquisition is started. When
the task is complete, processing is delayed the number of milliseconds entered in the Delay field,
then the task begins processing the next image and another image acquisition begins. This is a software-generated trigger and does not require a hardware trigger connection.
This mode is especially useful in applications that use a fast tool to sense part presence then branch
to a full inspection when the part is present. The camera triggers quickly when it is just running the
fast tool. When part is present, the camera will not trigger again until the inspection task is done, so
Page 23
Datalogic Automation Inc.
Camera
Impact Settings Reference Guide
the inspection is self-pacing. Also, if the task execution time changes, the trigger rate does not need
to be changed.
• Delay (milliseconds): (for Auto-trigger mode) This is the delay time between the end of processing
one image in the ImageIn task and beginning to process the next image. The value can be between 1
and 100 milliseconds. Without the delay, the camera may stay too busy to send data to VPM or CPM.
If VPM or CPM is updating very slowly, especially with large images, it might help to increase this
delay, although this will slow the trigger rate.
• Periodic Auto-trigger - This is a fixed-pace auto-trigger mode. The camera is automatically triggered
and ImageIn task execution begins after the image is acquired. After the Delay period expires, the
camera is triggered and the next image acquisition begins even if the previous image’s processing is
incomplete. If the image acquire time plus the delay value is less than the ImageIn task execution
time, triggering is too fast and the image buffers will be overrun.This is a software-generated trigger
and does not require a hardware trigger connection.
How to activate Periodic Auto-Trigger mode
This mode is activated using the same methods as the Auto-Trigger mode.
• Delay (milliseconds): (for Periodic Auto-trigger mode) This is the delay time between camera triggers. This value should be larger than the longest ImageIn task execution time so there is time for all
images to be processed.
• Auto-trigger When Online: If this is checked, triggers will start when the device goes Online and
stop when it goes Offline. No other Start/Stop control is available.
Trigger Input Debounce
Here you can define the debounce time for the Datalogic device camera trigger signal. Debounce determines
the maximum trigger rate the system will allow (basically like a governor on an engine) to help prevent negative effects from noise and high frequency bursts. The debounce setting must be able to filter out noise
while not introducing any unnecessary delays.
For more details on debounce settings, see “Input Debounce” on page 12.
Partial Scan Tab
Enter values for the left, right, top, and bottom line numbers which control the vertical and horizontal edges
scanned by the camera. You can use this option to decrease the image area scanned and increase the inspection speed. The range of acceptable values is determined by the camera type. If you want to use partial scanning on an image, you should calibrate the entire image first and then set the partial scan parameters.
For partial scan images, the image coordinates of 0,0 correspond to the sensor pixel coordinates 0,0. This
means that, when the image is partially scanned from the left or top, the upper left image pixel coordinate
becomes the top left partial scan setting. The image above and to the left of the partial scan setting will not
be displayed in the image window.
• Scan Lines to Overlap: This property indicates the number of scan lines to copy from the bottom of
the previous image and add to the top of the current image. As a result of the overlap, the resultant
image is this number of lines taller than the Partial Scan setting used by the camera.
For example, if a camera with 480 lines has an Overlap value of 100, the resultant image delivered to
the vision program will be 580 lines, with the top 100 lines copied from the previous image and the
remaining 480 lines from the camera sensor.
The feature is primarily intended for use with line scan cameras, however it works with any camera. It
works best with line scan cameras because the bottom line of the previous image will be placed
Datalogic Automation Inc.
Page 24
Impact Settings Reference Guide
Camera
directly adjacent to the top line of the current image. One primary application is inspection of a moving part, such as a web, that requires multiple images. If an interesting object, such as a defect, falls in
the area where one image ends and the next image begins, the object can not be fully seen in either
image. By setting the overlap setting to the maximum height of the object of interest, the entire object
at the top of the second image will be visible.
This is a property of the Camera Object, so it can be linked into your vision program and used when
analyzing results. For example, smaller objects may get duplicated at the bottom of the previous
image and the top of the current image, so you can recognize that the position of the object is in the
overlap and avoid counting it twice.
The maximum value for this property is equal to the height of the camera image.
The overlap area is expressed in scan lines, not calibrated units.
The overlap feature only works for vertical overlap, not horizontal overlap.
The overlap feature is not currently compatible with lens distortion calibration. It is compatible with
pixel size calibration.
Some third-party cameras do not allow partial scanning.
Color Tab
This tab is enabled only when a color camera is being used. Impact software uses a 3x3 bilinear interpolation
to convert the incomplete color imager output to a usable color image.
White Balance
If you are using a color camera, you can apply automatic white balance correction which calculates the
proper red and blue pixel gains needed to provide an accurate color image, or you can manually enter values
for the red and blue pixel gains.
To automatically adjust the white balance:
1. Point the camera at a uniformly white or grey object or image. Be sure the image is well-lit and not too
bright. Errors are returned if any of the color channels are saturated (the gain is greater than 100%).
2. Adjust the purple rectangular ROI so that it covers only a white or grey area of the image.
3. Click "Auto." The device automatically calculates the proper red and blue gain values to bring all three
colors into balance.
How White Balance Works
Datalogic’s color cameras have two stages of gain, the overall gain (set with the Gain slider on the General
tab), and a gain for the red and blue pixels.
When you click the Auto button, the average value is calculated for the red, green, and blue pixels. The red
gain is computed as the average green pixel value divided by the average red pixel value. The blue gain is
computed as the average green pixel value divided by the average blue pixel value. Errors are returned if any
of the color channels are saturated (the gain is greater than 100%) or if the computed red or blue gain is outside of the range supported by the camera.
After the red and blue gain values are calculated by clicking the Auto button, or entered manually, they are
applied to the camera.
First, the overall gain is applied to all pixels, then the red gain is applied to the red pixels and, finally, the
blue gain is applied to the blue pixels. This means that only the overall gain is applied to the green pixels.
Red pixel gain is overall gain times the red gain and blue pixels gain is overall gain times the blue gain. In all
cases 100% gain equals unity gain.
Line Scan Tab
Page 25
Datalogic Automation Inc.
Camera
Impact Settings Reference Guide
This tab is enabled only when a line scan camera is being used. Refer to the M-Series Processor and Camera
Guide for more details about operating the M5xx Line Scan camera.
Line scan cameras have a sensor with only one row of pixels and so they acquire one line at a time. The
image is formed by moving the part in front of the camera, acquiring multiple lines and stacking them
together to form the image. The Acquisition Mode determines when the camera needs to be triggered, e.g.
for each line, for a frame, continuously, etc. Line triggers typically come from an encoder that ensures that
the lines are evenly spaced.
Acquisition Mode
M5xx Camera
Line scan cameras can operate in several acquisition modes. The continuous modes allow the camera to
acquire multiple images without requiring multiple frame triggers. This eliminates any concern about “missing lines” between images when long parts are scanned.
In all the acquisition modes, the number of scan lines needed to create an image is set in the Partial Scan tab
(see “Partial Scan Tab” on page 24). Offline operation, using Snap button or Trigger Once button, does not
require line triggers since the lines are self-triggered based on shutter time.
Single Frame, Edge Triggered
In this mode, the camera captures a single image beginning with the edge of the frame trigger. To select the
frame trigger edge type, see “Trigger Event Types” on page 35. This is the default mode for most Datalogic
cameras.
Continuous while Frame Trigger High
While the frame trigger is held high, the camera will accept line triggers and create images. When the frame
trigger goes high, the first line trigger starts the first line in a new image. When the current image is filled
with scan lines, image acquisition is complete and the next image starts with the next line trigger. The camera will wait as long as necessary to get enough scan lines to fill each image.
When the frame trigger goes low, the camera will continue taking line triggers until the current image is
complete, then the camera will stop acquiring images until the frame trigger goes high again. All images will
be the same height.
Continuous while Frame Trigger Low
This mode’s operation is the same as Continuous while Frame Trigger High mode, except that the frame
trigger polarity is reversed.
Continuous while Online
In this mode, the frame trigger signal is not used. Scan Lines are acquired as long as the camera is online.
Hardware line triggers must be provided on the camera’s Line Trigger input. When the current image fills
with scan lines, image acquisition is complete and the next image starts with the next line trigger.
The camera will wait as long as necessary to get enough scan lines to fill each image. Since there is nothing
to indicate the end of the scan, the last image can wait forever to fill. To flush a partial last image out of the
camera and start a new one, the camera must be put Offline. If the camera is not put Offline, when a new
image is started the first lines of the new image will contain the left over lines from the end of the previous
image.
Dalsa Acquisition Modes
Dalsa cameras support four frame trigger modes: Single Frame Edge Triggered, Continuous While Frame
Trigger High, Continuous While Frame Trigger Low, and Continuous While Online.
Datalogic Automation Inc.
Page 26
Impact Settings Reference Guide
Camera
In the Continuous While Frame Trigger High and Continuous While Frame Trigger Low modes, the Dalsa
camera acquires images of the normal image height while the frame trigger is active. These cameras have a
maximum image height of 16,383 lines.
The Top Edge value is always 1 and the Bottom Edge is the number of lines to acquire. You can adjust the
maximum image height and width in VPM in Settings - Camera - Partial Scan tab.
When the frame trigger goes inactive, the camera immediately sends the current image to the vision program
with the number of lines that have been acquired. It is up to the vision program to discard or attempt to process the partial height image. The height of the current image can be accessed programmatically in the
image’s Height property in VPM.
The M5xx cameras do not work this way. The M5xx cameras pause acquisition when the frame trigger is
inactive and then continue acquisition when the frame trigger goes active again, so that all images are the
full height. The top of the image does not necessarily correspond to the beginning of the frame trigger.
Line Trigger Type
M5XX Camera
Single Phase
The trigger signal is connected to Input 2 and the line start is triggered on the rising edge of the signal only.
There are no debounce settings for Input 2.
Quadrature Forward Only
Use this setting with a quadrature encoder. Phase A is connected to Input 2 and Phase B is connected to
Input 3. The line start is triggered on the rising and falling edge of each input as long as Phase A leads Phase
B (forward direction). There are no debounce settings for Input 2 and 3.
The camera does not start a line in the backward direction. It counts the trigger pulses until the encoder goes
forward again, then it counts the forward pulses until all the backward pulses have been retraced, then it
starts triggering. This setting allows the line start to ignore backward jitters.
Quadrature Forward and Back
Use this setting with a quadrature encoder.Phase A is connected to Input 2 and Phase B is connected to Input
3. Line starts are triggered on the rising and falling edge of each input in either direction.
Dalsa Scan Direction
It is important to understand the scan direction of the Dalsa line scan camera. The camera has a two-line sensor capable of TDI (Time Delay Integration). An image row is exposed with one line of the sensor, then
shifted and exposed again with the other line of the sensor, while the next row of the image is being exposed
in the first sensor line. This doubles the net exposure time without slowing the line rate. In order to operate
in this mode, the camera must know which of the two lines of the sensor is exposed first. This is determined
by the scan direction input (Input 2). If this setting is wrong, the image will be blurred in the vertical direction.
In Single Phase line trigger mode, Input 2 controls the scan direction. When input 2 is high, the sensor lines
are shifted in the “forward” direction. When input 2 is low, the sensor lines are shifted in the “reverse” direction. If the scan direction never changes, you can hard wire Input 2 high or low, depending on how the camera is mounted.
In Quadrature Phase line trigger mode, Input 2 triggers Phase B and Input 0 triggers Phase A. The sensor
lines are shifted in the “forward” direction when Phase A leads Phase Band shifted in the reverse direction
when Phase A trails Phase B.
Page 27
Datalogic Automation Inc.
Camera
Impact Settings Reference Guide
Physically, the forward direction for the 1K and 2K Dalsa line scan cameras runs from the top of the camera
towards the bottom of the camera (from the I/O connector towards the power connector). In the 4K line scan
camera, the forward direction is from the power connector towards the Ethernet connector.
If the part is moving from the bottom of the camera towards the top of the camera, Input 2 should be high (or
encoder Phase A should lead Phase B).
Line Trigger Input Termination
M5xx Camera
CAUTION: Maximum Input Voltage is +6 VDC when the termination resistor is in the circuit.
This setting only affects Inputs 2 and 3. Input 1 is not terminated. There are no debounce settings for Inputs
2 and 3. The ability to configure the termination resistor is necessary because Inputs 2 and 3 can accept TTL,
RS-422, or RS-644 signal types. If this check box is checked, a termination resistor is present on camera
Inputs 2 and 3.
The check box is cleared automatically when the Line Trigger type is set to Single Phase. It is checked automatically when the Line Trigger type is set to either of the Quadrature Line Trigger Types.
You should also check or clear the check box based on the following signal input configurations.
• RS-422
• (camera is end device on the bus): check box must be checked
• (camera is not end device on the bus): check box must be cleared
• RS-644: check box must be checked
• TTL: check box must be cleared
Dalsa Camera
This setting only affects Inputs 0 and 2. Input 1 is not terminated. There are no debounce settings for Inputs
0 and 2. The ability to configure the termination resistor is necessary because Inputs 0 and 2 can accept TTL
(Transistor/Transistor Logic) or LVDS (Low Voltage Differential Signal) mode. To select TTL mode, clear
the Input Termination check box. To select LVDS mode, check the check box.
Frequency Converter
Because the maximum trigger input rate of the Line Scan camera is 20 MHz, which is faster than the camera’s number of lines per second acquisition rate, an internal frequency converter can be configured that will
scale the line trigger input rate up or down to create fractional scale factors. This way you can match the x
and y resolutions without modifying the encoder frequency. The Frequency Convertor setting can be used
with any of the three Line Trigger types.
Refer to the M-Series Processor and Camera Guide (843-0138) for each Line Scan camera’s maximum lines
per second acquisition rate.
The Line Trigger Multiplier and Line Trigger Dividers are integer scale factors. They can be combined to
create a fractional scale factor. For example, if the trigger input rate is 3000 and the desired lines per second
is 2000, then the Multiplier value would be 2 and the Post-Divider would be 3.
3000 * (2/3) = 2000
Pre-Divider
Datalogic Automation Inc.
Page 28
Impact Settings Reference Guide
Camera
This setting is used to the scale the frequency down to less than 30 KHz, the maximum value for the Multiplier field. For example, if the trigger input rate is 30 KHZ, the pre-divider value would be 10. Using the
example above:
30000/10 * (2/3) = 2000
Example
Here is an example using the M550 line scan camera to acquire an image of a cylindrical-shaped object.
The M550 camera has a resolution of 2048 lines. The Field of View (FOV) is 41 mm and the object has a
circumference of 73 mm. The encoder produces 2500 pulses per revolution.
The horizontal resolution is
FOV/ camera resolution or 41 mm/2048 = 0.020 mm/pixel
The vertical resolution is
circumference / encoder frequency or 73 mm/2500 = 0.029 mm/pixel
Because the horizontal and vertical resolutions are different, the resultant image would appear stretched or
compressed. To correct for this we set the Pre-Divider, Multiplier, and Divider to create a fractional scale
factor.
Pre-Divider = 0, Multiplier = 29, and Post-Divider = 20
Use these values to adjust the number of lines to acquire:
Circumference * Multiplier / Post-Divider: 2500 * 29/20 = 3625 (If this result is greater than 4095 the
resolution must be changed, since the maximum number of lines is 4095.)
Recalculating the vertical resolution using the new number of lines:
73/3625 = 0.020mm/pixel
Dalsa Frequency Converter
The Dalsa camera has a frequency converter for the Line Trigger input. It has a multiplier and a divider, but
not a pre-divider. The multiplier value is fixed at 256. The divider value can be adjusted to any value
between 1 and 65535, so it allows for 0.25% accuracy in setting the pixel height.
Advanced Tab
Testing
When Test Image mode is enabled, and you click the snap button, the test image selected in the Test Images
drop down is displayed in the image window. Test images are stored in the camera.
Internal Correction
If Enable Correction box is checked, the camera’s internal correction for gain and offset is used. You select
the desired correction set from the drop-down. This field is disabled for some camera types.
Modes
• Half Resolution: If the Half Resolution check box is checked, the camera scans every other line so
it acquires the image twice as fast with half the vertical resolution (and twice the gain). This setting
can be used for high speed applications.
• Digital Shift: Digital shift provides digital gain for the image. The digital value from the camera is
multiplied by the multiplication factor selected from the drop down.This will brighten darker
images by boosting the brighter parts and eliminating the darker parts. If the image is already
Page 29
Datalogic Automation Inc.
Camera
Impact Settings Reference Guide
bright, increasing the digital shift can saturate it. Increasing the digital shift can also increase signal
noise present in the image. This field is disabled for some camera types.
• Vertical Binning Mode: If vertical binning is enabled, every other line of the scanned image is discarded, then adjacent lines are added together. This produces an image that is half the original size,
but the averaging can brighten a dark image somewhat. Some of the signal noise present in the
image can be reduced. (This is similar to Half Resolution Mode, except the image size is reduced.)
This field is disabled for some camera types.
Set to Defaults Button
Clicking this button restores all camera settings to their factory defaults. Default settings are determined by
the camera type.
Save Image
Click this button to save the displayed image to a file.The image is saved in Portable Networks Graphics
(PNG) format.
Calibration Panel
NOTE: Access to functions on this tab may be limited based on the user’s access level and while the device
is online.
A camera will require calibration the very first time you use the Datalogic device, when the camera-to-subject distance is changed, when a new camera is connected, or if the lens is changed. Calibration insures that
the measurements indicated in VPM’s tools accurately relate to the inspected object’s measurements. You
may calibrate a camera using a calibrated target or enter the camera’s units-per-pixel factor manually.
If you want to use partial scanning on an image, you must calibrate the entire image first and then set the
partial scan parameters.
Camera Calibration Technical Details
The dot centers in the image are matched to their known locations on the dot target. Any discrepancies due
to lens distortion or perspective distortion are compensated for by computing a best fit 2nd-order polynomial
mapping between the image dot centers and the known dot pattern of the target. Four mappings are computed, one for each quadrant of the image. The mappings are of the form:
x' = a*x*x + b*y*y + c*x*y + d*x + e*y + f
y' = g*x*x + h*y*y + i*x*y + j*x + k*y + l
Because there are six coefficients to be computed in each equation, a minimum of six dots must be present in
each quadrant of the image to successfully compute the mapping. If more than six dots are present, they are
all used to compute a best fit mapping. Larger dots provide a more accurate calibration because the dot centers can be more accurately located.
It is known that a circular dot center in an image can be found with a three sigma repeatability of 0.6/sqrt
(diameter) pixels. (Haralick and Shapiro, Computer and Robot Vision, 1992) It is also important to fill the
field of view with the dot pattern. Areas within the field of view that are outside the dot pattern are handled
by extrapolating the calibration found within the dot pattern, so any calibration errors become magnified in
those areas.
Datalogic Automation Inc.
Page 30
Impact Settings Reference Guide
Camera
Once the calibration is done, any feature found in an image, such as a edge point or centroid, is passed
through the polynomial mappings to find its location in the "perfect" image represented by the known dot
target pattern.
A color camera has half the measurement accuracy (twice the error) of a greyscale camera with the same
number of pixels. The resolution rules-of-thumb for greyscale and color cameras are as follows:
Greyscale
Color
Smallest Detectable Defect
2x2 pixels
3x3 pixels
Gauging resolution
1/4 pixel
1/2 pixel
The Bayer filter mosaic halves the effective resolution of the color cameras because each pixel detects either
red, green, or blue. The smallest detectable defect corresponds to the smallest size defect that always fills at
least one pixel. This is a theoretical lower limit. In most applications the defect will need to be larger.
Note that some tools provide sub-pixel options, which can improve the resolution and measurement accuracy of the image.
The four options for camera calibration are: From Target, Manually, From Points, and Pixel Size Only.
Snap
Click the Snap button to acquire and display an image in the image window. You can use this to see how
camera settings affect the image, or to position objects within the camera’s field of view. The acquired image
is also displayed in the image display area of the Design and Display tabs.
• NOTE: Clicking the Trigger Once button in the Summary Table buttons toolbar will not acquire a
new image for this image display.
Live
Click the Live button to continuously acquire images and display images in the image window until you
click the Snap or Live buttons. You can use this to see how camera settings affect the image, or to position
objects within the camera’s field of view. The acquired image is also displayed in the image display area of
the Design and Display tabs.
• NOTE: Clicking the Trigger Continuously button in the Summary Table buttons toolbar will not
acquire a new image for this image display.
Image Source
The type of camera currently acquiring images.
Frames per Second
This field indicates the number of frames the Datalogic device can capture and process per second. It is calculated based on the current Shutter Open Time, Partial Scan line and Half Resolution Mode settings.
Calibrate
Click this button to calibrate the camera when the desired image is displayed in the image window.
Load Image
Click this button to load a file image into the image display window.
Page 31
Datalogic Automation Inc.
Camera
Impact Settings Reference Guide
Set To Defaults
Click this button to restore all camera settings to their factory defaults.
Calibrate From Target
Use this option when you have a calibration target with a hexagonal or grid dot pattern and a known dot
pitch. This procedure assumes you are using a standard Datalogic calibration target and a live camera.
The calibration algorithm works best when the target’s dot pattern fills the camera’s field of view (FOV).
Any areas outside of the dot target are extrapolated. Lens distortion is a radial phenomenon (a function of the
distance from the center of the lens), so the extrapolation will not be as accurate as the calibration. It is best
practice to have the dot target cover all parts of the FOV where any inspection measurements will be made.
Larger dots provide a more accurate calibration because the dot centers can be more accurately located. The
dots must be a minimum of twenty pixels in diameter spaced twenty pixels apart. The minimum blob size is
nine pixels.
It is not critical to center the calibration target in the FOV. It is important, however, that the center of the
image you use corresponds to the center of the lens (optical axis). The calibration algorithm assumes that the
center of the calibration image is the center of the lens. It accounts for partial scanning of the run-time
image, and cropped and sampled images from the Image Sampling tool. It does not account for the case
where the calibration image is offset from the optical axis due to partial scanning.
It is important for accurate measurement during inspection that the inspected part does not move outside the
area covered by the dot target during calibration.
To Calibrate from a target
1. Select From Target from the Calibrate drop-down.
2. Be sure that the camera is mounted securely. Place a standard Datalogic calibration target (Part # 3810985-xx) in front of the camera. (The final digits of the part number indicate the target’s dot pitch in
millimeters.) The dot pitch is the center-to-center measurement between dots. The dots must be a minimum of twenty pixels in diameter spaced twenty pixels apart.
3. Click the Live button. Be sure that the target is well lit but not saturated. Place the target in the camera’s field of view (FOV) where the inspected part will appear. Calibration is more accurate if the target’s dot pattern fills the FOV.
Datalogic Automation Inc.
Page 32
Impact Settings Reference Guide
Camera
4. Move the target that the center of the image you use corresponds to the center of the lens (optical axis)
as much as possible. (The yellow crosshairs indicate the center of the FOV.) When the target is placed
correctly, focus the camera so that the target dots are clear and sharp.
Sample Calibration
Image
5. Click the Snap button.
6. Type the dot pitch measurement into the Target Pitch (units) field. The dot pitch is the distance from
the center of one dot to the center of an adjoining dot. This measurement is indicated on the last two
digits of the target part number. (In this sample image, the dot pitch is 16.0 units.)
7. Select the Target Dot Pattern type, hexagon or grid.
8. Click the Calibrate button. The Scale Factor (in Units per Pixel) is displayed when the calibration is
complete. Scale Factor is the number of pixels in the image window per "real world" unit on the target.
This value is used to automatically calibrate measurements in VPM tools with the physical dimensions
of the image.
Target Settings
• Target Pitch (units)
This is the distance between dots on the calibration target. It is independent of the units (e.g. millimeters, inches, centimeters). The sample target image on page 2-10 has a 2.0 target pitch.
• Target Dot Pattern
You can use a target that is laid out in a hexagonal or a grid pattern. The two small sample images
show the difference.
Calibrate Manually
Use this option when you know the unit to pixel conversion value for the image. Units per Pixel is the number of pixels in the image window per "real world" units on the image.
To Calibrate manually
1. Select Manually from the Calibrate drop-down.
Page 33
Datalogic Automation Inc.
Camera
Impact Settings Reference Guide
2. Enter the Units per Pixel value in the Manual Settings group. Units per Pixel is the scale factor for converting measurements in the image to "real world" units. For example, if an object measures 100 millimeters and the image resolution of that object is 640 pixels, the Units per Pixel value is 100 divided by
640 = 0.156 (or 0.156 mm per pixel).
3. Choose either Disable Lens Distortion Calibration or Keep Current Lens Distortion Calibration. This
selection determines whether the distortion information is stored with the image or not.
4. Click the Calibrate button.
Manual Settings
• Units per Pixel
This is the factor that VPM tools use to convert image measurements to "real-life" measurements. For
example, if you want to measure a part that is 100 mm wide and the image window resolution is 640
pixels wide, each pixel is equivalent to 0.156 mm:
100 mm / 640 pixels = 0.156 mm per pixel
• Disable/Keep Lens Distortion Calibration
Most lenses introduce some distortion in images. When a camera is calibrated, the calibration process
can account for most of the natural pixel size and perspective distortion (not radial distortion) present
in the lens. You can choose whether to disable or preserve that lens distortion in each image taken by
the camera.
Calibrate From Polygon Points
Use this option when it is difficult to calibrate with a target or when the inspected image contains perspective distortion and you can align the provided polygon over points on the image. This option will correct for
pixel size and perspective distortion, but not radial distortion. To calibrate for radial distortion you must use
a calibration target.
The polygon points and real-world points must correspond one-to-one, meaning that there must be the same
number and they must be in the same order. The polygon points are ordered clockwise. To see a tooltip
showing the point order and X/Y coordinates, hold the cursor over the desired point. Once you know the
order of the polygon points, you can enter the real-world points in the correct order.
To calibrate for real-world origin and pixel size calibration, the points you select should represent at least
three distinct X and Y locations on the part. For acceptable distortion correction, select at least four distinct
X and Y locations on the part. For example, if you only use points along the top and bottom edges, the distortion correction in the vertical direction is ill-defined and will likely be unacceptable because only two distinct Y locations are represented. You should try to space the points into at least four distinct X and Y
locations.
The calibration algorithm will automatically determine whether to calibrate for distortion or not. If there is
not detectable distortion, or if there are too few points, it will calibrate for real-world origin and pixel size. If
there is detectable distortion and enough points, it will also calibrate for distortion. The current setting is displayed after the Lens Distortion label in the “Current Calibration” box below the image window.
It is possible to “confuse” the distortion calibration algorithm by defining certain point positions. If you get
“odd” calibration results, you should first check that you entered the correct real-world coordinates in the
correct order. If these are correct, use more points to better define the distortion.
NOTE: Since the image origin (0,0) is in the upper-left corner of the image, the X and Y real-world coordinate values use a "left-handed" coordinate system. This means that the X coordinate value increases to the
right and the Y coordinate value increases downward. See “Point Settings” below.
Datalogic Automation Inc.
Page 34
Impact Settings Reference Guide
Camera
To calibrate from polygon points
1. Select From Polygon Points from the Calibrate drop-down.
2. A polygon ROI is placed on the image in the image window. Select the polygon and move it so Point 1
is centered over one of the calibration points.
3. Select and move each of the other polygon vertices to align them with the desired calibration points.
The Polygon Points values are automatically updated in the Point Settings table.
Add Edit
Point
Note: To add a polygon point, move the cursor to the desired point over the line. When the cursor
changes to the Add Edit point shape, click and drag the new point. To delete a polygon point, click and
drag the desired point to another polygon point. The polygon must have at least six points, each with a
corresponding Real World point. The dots must be a minimum of twenty pixels in diameter spaced
twenty pixels apart. To reset all the polygon points to their default position and clear the Real World
point values, click the Reset Polygon button.
4. When all the polygon points are placed, enter the "real-world" measured locations that correspond to
each Polygon Point.The measurement units are not necessary.
For example, in the image below, Real World Point 1 (0,0) corresponds to Polygon Point 1
(38.545,200.206); Point 2, in real-world units, is 2, -2 (+2X and -2Y from Point 1); Point 3 is 6, -2
(+6X and -2Y); Point 4 is 8, 0; Point 5 is 6, 2; and Point 6 is 2, 2.
5. Click the Calibrate button.
Image
Window
X value
increases
Y value
increases
Polygon
Point 2
Polygon
Point 3
Polygon
Point 1
Polygon
Point 4
Polygon
Point 5
Polygon
Point 6
Calibrate From Polygon Points Image
Point Settings
• Polygon Points: The X and Y coordinates of each Polygon Point is indicated. To reset the polygon to
its default position, and the Real World Points values to zero, click the Reset Polygon button.
Page 35
Datalogic Automation Inc.
Camera
Impact Settings Reference Guide
• Real World Points: The "real-world" location (in X and Y coordinates) corresponding to each Polygon
Point should be entered. Double-click on a field to edit it. Click the appropriate button to Append,
Insert, or Delete a Real World point.
Calibrate From Entered Points
Use this option when it is difficult to calibrate with a target or when the inspected image contains perspective distortion and you need to manually enter the pixel grid points for the calibration. This option will correct for pixel size and perspective distortion, but not radial distortion. To calibrate for radial distortion you
must use a calibration target.
The entered points and real-world points must correspond one-to-one, meaning that there must be the same
number of points and they must be in the same order.
To calibrate for real-world origin and pixel size calibration the points you select should represent at least
three distinct X and Y locations on the part. For acceptable distortion correction, select at least four distinct
X and Y locations on the part. For example, if you only use points along the top and bottom edges, the distortion correction in the vertical direction is ill-defined and will likely be unacceptable because only two distinct Y locations are represented. You should try to space the points into at least four distinct X and Y
locations.
The calibration algorithm will automatically determine whether to calibrate for distortion or not. If there is
not detectable distortion, or if there are too few points, it will calibrate for real-world origin and pixel size. If
there is detectable distortion and enough points, it will also calibrate for distortion. The current setting is displayed after the Lens Distortion label in the “Current Calibration” box below the image window.
It is possible to “confuse” the distortion calibration algorithm by defining certain point positions. If you get
“odd” calibration results, you should first check that you entered the correct real-world coordinates in the
correct order. If these are correct, use more points to better define the distortion.
NOTE: Since the image origin (0,0) is in the upper-left corner of the image, the X and Y coordinate values
use a "left-handed" coordinate system. This means that the X coordinate value increases to the right and the
Y coordinate value increases downward. See “Point Settings” below.
To calibrate from entered points
1. From the Calibrate drop-down, select From Entered Points.
2. In the Entered Points table, enter the X and Y coordinates of each point on the image that you want to
use for calibration. To append, insert, and delete points, use the buttons next to the fields. The points
are NOT marked on the image.
3. When all the Entered Points have been entered, enter the "real-world" measured locations that correspond to each Entered Point. The measurement units are not necessary.
For example, in the image below, Real World Point 1 (0,0) corresponds to Entered Point 1 (39,200);
Point 2, in real-world units, is 2, -2 (+2X and -2Y from Point 1); Point 3 is 6, -2 (+6X and -2Y); Point
4 is 8, 0; Point 5 is 6, 2; and Point 6 is 2, 2. To append, insert, and delete Real World Points, use the buttons next to the fields.
Datalogic Automation Inc.
Page 36
Impact Settings Reference Guide
Camera
4. Click the Calibrate button.
Entered
Point 2
Entered
Point 3
X value
increases
Entered
Point 1
Entered
Point 4
Y value
increases
Entered
Point 6
Image
Window
Entered
Point 5
Calibrate From Entered Points Image
(Points marked for illustration only)
Point Settings
• Entered Points: The X and Y coordinates of each Entered Point. The points are NOT marked on the
image.
• Real World Points: The "real-world" location (in X and Y coordinates) of each Entered Point. Doubleclick on a field to edit it. Click the appropriate button to Append, Insert, or Delete a Real World point.
Calibrate Pixel Size Only
Use this option for a quick calibration when you know the distance between two points on the image and you
want to calibrate the camera to those dimensions.
To calibrate pixel size only
1. Select Pixel Size Only from the Calibrate drop-down.
2. A line ROI is placed on the image in the image window. Move and size the line until it stretches
between two points with a known distance between them.
3. Enter the distance between the points into the Real World Length field.
4. Click the Calibrate button.
Pixel Size Settings
Pixel size settings are used when you calibrate from Pixel Size Only.
Page 37
Datalogic Automation Inc.
File Camera
Impact Settings Reference Guide
• Line Points: The X and Y beginning and ending coordinates of the measurement line are indicated.
• Real World Length: The length of the calibration line in real units.
Common Calibration Settings
Backup and Restore Calibration
If Backup With Time Stamp is selected when you click the Backup Calibration button, the current calibration data is saved to a calibration file on the Datalogic device and the client PC, and also copied to a file on
the client PC with a filename that includes the current date and time. The date and time format is based on
the current client PC settings in the format:
CameraCalibration_date_time.xml
If Backup With Time Stamp is selected when you click the Restore Calibration button, you are able to select
from time stamped files.
If Backup With Time Stamp is not selected, the calibration data file is saved without the date and time
included in the filename.
Current Calibration
This section indicates the calibrated values for the image displayed.
• Lens Distortion: When a camera is calibrated, the calibration process can account for the natural distortion present in the camera lens. When an image is saved, the distortion information can be stored
with it.
• Units per Pixel: This is the number of units represented by one pixel in the displayed image.
• Real World Origin: This is the X and Y coordinates (in pixels), and the rotation angle (in degrees) of
the images upper left corner relative to the upper left corner of the image display.
File Camera
The File Camera system object accesses the device’s system memory where file images are stored.
F i l e C a m e r a P r o p e r t i e s Ta b
Output Name
What it is
Number of Active
Images
The number of images currently in the device’s RAM
F i l e C a m e r a S e t u p Ta b
NOTE: Access to functions on this tab may be limited based on a user’s access level and while the device is
online.
This tab lets you configure a device to work without a camera. Previously captured images in PNG format
can be selected in the File Camera tab, then the Active selected images are displayed in the image window
when the device is triggered. The following section describes each of the tab parameters in detail.
Datalogic Automation Inc.
Page 38
Impact Settings Reference Guide
System Log
When File Camera mode is enabled, the device will not acquire images with a camera, but it will use the
images in the RAM Images Active list as though they were acquired live. To enable File Camera mode, click
the File Camera/Camera toggle button. See “File Camera/Camera” on page 3.
Available File Images
The images listed in the Available list are stored in the Datalogic device’s compact flash and are available to
be copied to the Active Images list. When you select an image in the list, it is displayed in the Image Window.
To add an image to the Available list:
1. Click Add.
2. In the Locate Image dialog, navigate to the directory that contains the image you want to use and select
it. Images with a name greater than 44 characters cannot be added to the list.
Tip: If you select an image format other than .png, it is automatically converted to png format when it is
added to the list.
3. Click Add. (Images are saved, by default, in the Root/Images folder in the default installation location.)
The image is also automatically added to the Active list in RAM Images.
To remove an image from the Available list:
1. Select the desired image.
2. Click Remove.
Tip: To save images from the device to the client, click the File Manager system object, open the Impact
Root folder, open the Images folder, then copy the desired images to a client folder. To save a displayed
image, click the Save Image button in VPM’s image display area.
Active Images
Images listed in the Active list are in the Datalogic device’s RAM and available for processing. These
images are displayed in a repeating list in order from top to bottom when the device is triggered or when the
Snap or Live button is pressed anywhere in Settings-Camera system object. When you select an image in the
list, it is displayed in the Image Window.
To add an image to the Active list
1. Select the desired image in the Compact Flash Images Available list.
2. Click the Activate arrow in the space between the lists.
3. To change the order of the image in the list, if necessary, click the Reorder arrows below the list.
To remove an image from the list
1. Select the desired image in the list.
2. Click the Deactivate arrow in the space between the lists.
System Log
The System Log system object is used to view and save the System Log. Events in the System log are time
and date stamped and stored on the device. If the device loses power for an extended period of time, system
Page 39
Datalogic Automation Inc.
File Manager
Impact Settings Reference Guide
log events are lost. This object has an additional General property named Log Entries that is a String List
containing all the system log events.
S y s t e m L o g P r o p e r t i e s Ta b
Input Name
What it is
Log Entry
The most recent log event
S y s t e m L o g S e t u p Ta b
NOTE: Access to functions on this tab may be limited based on a user’s access level and while the device is
online.
Archive Log
Events in the System log are stored on the device. If the device loses power for an extended period of time,
system log events are lost. You can save the existing log events to a text file.
To Save System Log Events:
1. To save System Log Events to the default file displayed in the File field, click Archive Log. An existing file with the same name can be overwritten.
2. To save System Log Events to a different file and folder, click Browse, navigate to the desired folder,
enter a new file name, then click Open.
3. Click Archive Log.
Event
The events are sorted in ascending time order and contain information about the device and tasks such as
online and offline events, system restarts, device and image acquisition errors, trigger overruns, tool failures,
and other types of system events and failures.
Clear
Click Clear to clear all the events in the system log.
Refresh
Click Refresh to update the list of events.
File Manager
The File Manager tab lists and manipulates files that are in the Datalogic device’s flash memory. You can
use this tab to copy files between the device and other network devices, including client computers.
Datalogic Automation Inc.
Page 40
Impact Settings Reference Guide
File Manager
F i l e M a n a g e r P r o p e r t i e s Ta b
Input Name
What it is
Display Tab Program Filter
Programs that contain this name appear on the Display tab’s File Load
dropdown list.
Output Name
What it is
Available Flash
The amount of flash memory on the device (in bytes)
F i l e M a n a g e r S e t u p Ta b
NOTE: Access to functions on this tab may be limited based on a user’s access level and while the device is
online.
Display Tab Program Filter
Programs that contain this name appear on the Display tab’s File Load dropdown list.
Refresh
Click to refresh the list of files.
Select All
Click to select all the files listed.
Folder List
The left pane of the tab shows the folders on the client computer and the device.
WARNING: The files in the Impact Root folder are important system files. The Datalogic device may fail to
operate correctly if these files are modified or deleted.
• Impact Root: The device’s operating system and firmware files. Do not put more than thirty two files
in the root directory or the install may fail.
• Composite Tools: Composite Tools are created by combining existing tools into new configurations.
• Images folder: images stored on the device. To backup images, copy them from this folder to a folder
on the client PC. Images can only be placed into this folder using the File Manager. Images with a
name greater than 44 characters cannot be used by the file camera.
• VisionPrograms: Datalogic and user-created vision programs
• Web folder: U-defined files that can be accessed with a web browser.
Page 41
Datalogic Automation Inc.
File Manager
Impact Settings Reference Guide
To access the files in the Web folder with a browser
1. Open a web browser.
2. In the Address field, type http://123.123.123.123/file/
where 123.123.123.123 is the IP address of the device.
3. Press Enter. If there is a file in the folder named index.htm or default.htm, the browser will automatically display it. If not, the directory is displayed. To display a different file, enter the file name after the
directory name.
For example: http://123.123.123.123/file/index_help.htm
File List
To select a file from the list, click on the file name in the list. To select multiple files, hold down the Ctrl key
and click each file. If a file that is pasted into the Vision Programs folder is already loaded on the device, the
new file is automatically loaded in place of it.
To Cut or Delete a File: Select the desired file(s), then use the Cut or Delete button on the main Settings toolbar.
To Copy and Paste a File: Select the desired file(s), then use the Copy and Paste buttons on the main Settings
toolbar. You can also click the file and drag it to the desired folder.
The right pane of the tab shows the files in the folder that is selected in the left pane. Click on the respective
header to sort the files by name, size, or date modified. The small arrow on the header indicates the sort
order. Not all headers are displayed for all folders.
• File Name: Vision program files have a .vp extension. Each vision program file must have a unique
name.
• Vision Program Name: This column is displayed only when the Vision Programs folder is selected.
It shows the name of the vision program within the vision program file. Vision Programs are created
with Vision Program Manager. Multiple vision programs can have the same name. Links are made
from control panels to a vision program. IMPORTANT: Program names are case sensitive.
• Size, Modified: Shows the size in kilobytes and the date the file was modified.
• Load/Unload: This column is displayed only when the Vision Programs folder is selected. When this
box is checked, the indicated vision program is immediately loaded in the Datalogic device. When the
box is unchecked, the file is unloaded. Loaded programs can be edited in Vision Program Manager
and are queued to run if a trigger is received when the device is online.
• Load On Startup: This column is displayed only when the Vision Programs folder is selected. When
this box is checked, the indicated vision program is loaded into the device when it restarts. Loaded
programs can be edited in Vision Program Manager and are queued to run if a trigger is received when
the device is online.
Restoring vision program files
To restore vision program files from the client to the Datalogic device:
1. Connect to the desired device.
2. Click Settings Tab - File Manager - Setup.
Datalogic Automation Inc.
Page 42
Impact Settings Reference Guide
Modbus TCP/IP Server
3. Open the folder on the client drive that contains the file to be restored.
4. Click the file to be restored to select it.
5. Click the Copy button.
6. Click the plus sign to the left of the Impact Root folder to open it.
7. Click the VisionPrograms folder.
8. Click the Paste button.
9. The file is pasted into the VisionPrograms folder.
10. If you want the file to be loaded on the device, check the Load/Unload check box.
Modbus TCP/IP Server
The Modbus TCP/IP Server interfaces with other Datalogic devices that use Modbus TCP/IP protocol.
There are brief details of the server’s operation after the following table. (Datalogic does not support serial
Modbus protocol.)
All Modbus registers are 16 bit integers. The Settings Modbus server registers (the number in brackets) are
used as described here.
NOTE: This System Object is not available while the device is online. Settings cannot edit the property values.
M o d b u s S e r v e r P r o p e r t i e s Ta b
Page 43
Input Name
What it is
Online [0]
If this value is set to one, the camera goes online. If it is set to zero, the
camera goes offline.
Trigger [1]
If this value is set to non-zero, the camera is triggered if it is Online. This
value is also written to the Trigger Ack register as a trigger acknowledgement.
Gain [2]
The camera’s current gain setting
Shutter Speed (x
10us) [3]
The camera’s current shutter speed setting in microseconds (divided by
ten)
Strobe 1 Duration
(ms) [4]
Strobe 1 current duration setting in milliseconds
Strobe 2 Duration
(ms) [5]
Strobe 2 current duration setting in milliseconds
Strobe 3 Duration
(ms) [6]
Strobe 3 current duration setting in milliseconds
Reserved [7] - [32]
These registers are reserved for future use
Trigger Ack [33]
If the Trigger register value is set to non-zero, the camera is triggered
and that value is also written to this register as a trigger acknowledgement.
Reserved [34] - [63]
These registers are reserved for future use
Datalogic Automation Inc.
AB PCCC Server
Impact Settings Reference Guide
Input Name
What it is
Register [64] - [127]
The Modbus client can write to these registers.
How VPM Works With Modbus TCP/IP
The Modbus server runs continuously on the Datalogic device, listening on the standard Modbus port 502. It
does not initiate any communications, but waits for other Modbus devices on the network.
The server supports only Conformance Class 0 functions — Read Multiple Registers (Function Code 0x03) and Write Multiple Registers (Function Code - 0x10). There is one register address space starting at
address 0. All Modbus registers are 16 bit integers and the most-significant bit (at the lowest address) is sent
first (known as Big Endian).
AB PCCC Server
The AB PCCC Server allows Allen-Bradley®, Rockwell Automation®, and compatible PLC devices to
exchange data with Datalogic devices using the Programmable Controller Communication Commands
(PCCC) protocol encapsulated inside EtherNet/IP commands. The PCCC format is compatible with the
Allen-Bradley standard PLC-5 which is supported by a wide variety of their PLCs including the SLC™-5,
PLC-5®, and later products. There are brief details of the server’s operation after the following table.
No values for the PCCC Server properties are saved in the Vision Program (*.vp) files. If you require initial
values, they must be set using explicit Data Set operations in the program when it loads. The VPM PCCC
server properties (the number in brackets) are described here.
NOTE: This System Object is not available while the device is online. Settings cannot edit the property values.
A B P C C C S e r v e r P r o p e r t i e s Ta b
Input Name
What it is
N7-Integer [0]
through N7-Integer
[63]
64 indexed integer values
F8-Float [0] through
F8-Float [63]
64 indexed float values
A9-ASCII [0]
through A9-ASCII
[63]
64 indexed 1-byte characters
ST10-String [0]
through ST10String [31]
32 indexed string values
How VPM Works With AB PCCC
The AB PCCC server runs continuously on the Datalogic device. It does not initiate any communications,
but waits for other PCCC devices on the network.
Datalogic Automation Inc.
Page 44
Impact Settings Reference Guide
OPC Data Access
The server supports Typed Read and Typed Write commands. These are standard PCCC commands using
command code 0F and functions 0x68 and 0x67 respectively. The PCCC command is placed inside an EtherNet/IP command that targets the EiP object 0x67 and service 0x4B on the device.
There are four files of data that can be read or written. These are statically-allocated arrays of data analogous
to Modbus registers.
File Type
File Name
PCCC Data Type
Depth
Port Names
Integer 16-bit
N7
INT
64
INT [*]
Float 4-byte
F8
REAL
64
REAL [*]
Character 1-byte
A9
SINT
64
SINT [*]
String n-chars
ST10
SINT
32
String SINT [*]
The Integer file is limited to sixteen bits which is the standard for PLC-5 devices and the protocol.
Reals conform to the IEEE 754 standard for representing a real number in four bytes.
The Character file has signed characters. These may be used for characters of other signed one-byte data as
well as Boolean values.
The String file entries each contain a variable-length string. The data is passed as the SINT format. Only one
string at a time may be read or written as it is already passing an array of data. The other three data types
may pass one to n data elements at a time.
To access Impact data from a PLC, use Read/Write Message commands with PLC5 as the target device.
There are variations in PCCC command implementations across PLC5 product generations. The files must
be accessed using the right combination of File Type, File Name, and File Name index as shown in the two
tables above. Refer to your PLC documentation for command details.
OPC Data Access
The OPC Data Access system object interfaces with the Datalogic OPC Server. The Server provides OPC
capable clients on the network with access to the Datalogic device through the OPC Data Access system
object. The Server can read and write data to the OPC Data Access properties which are described here.
For more details about the OPC Server, refer to the OPC Server Reference (Publication 843-0136.)
NOTE: This System Object is not available while the device is online. Settings cannot edit the property values.
O P C D a ta A c c e s s P r o p e r t i e s Ta b
Page 45
Input Name
What it is
Online
When true, places the device online.
Trigger
When true, a camera trigger event is created in the device
Gain
The camera gain value
Shutter Speed (x 10
microseconds)
The camera shutter speed
Strobe 1 Duration
(ms)
The duration for strobe 1
Datalogic Automation Inc.
OPC Data Access
Impact Settings Reference Guide
Input Name
What it is
Strobe 2 Duration
(ms)
The duration for strobe 2
Strobe 3 Duration
(ms)
The duration for strobe 3
Datalogic Automation Inc.
Page 46
S E T T I N G S
Index
A
AB PCCC
server 44
Abort on error 10
About
settings 3
Access
administrator level 17
control panel 17
controller level 17
level 17
monitor level 17
operator level 17
programmer level 17
ActiveX server 13
Administration
security 16
setup 16
Administrator access 17
Archive system log 40
Auto
trigger 23
B
Backup
settings 11
Button
camera 3
connect 2
file camera 3
live 3, 21, 31
online 2
settings 2
snap 21, 31
C
Calibration
backup and restore 38
camera 30
editor 15
from entered points 36
from polygon points 34
from target 32
manual 33
pixel size only 37
technical details 30
Camera
button 3
calibration 30
calibration technical details 30
digital shift 29
Page 47
R E F E R E N C E
gain 22
live 21, 31
offset 23
preferences 2, 3
select, tab 1
setup 21
shutter open time 22
snap 21, 31
system object properties 20
tabs, hide 2
trigger 23
vertical binning 30
Clear system log 40
Client computer
default directory 18
Device backup/restore 11
Color
bilinear interpolation 25
white balance 25
Comment
device 10
Composite tools 41
Connect
device 2
Impact device 3
Connection
maximum 10
Control panel
security 17
Controller access 17
D
Data bits, serial port 14
Data transfer
timeout 10
Date 10
Debounce
input 12
Delay
holdoff 12
Device
Also see Impact Device
backup/restore settings 11
comment 10
date/time 10
events 15
inputs 15
IP address 6
IP gateway 6
IP mask 6
memory 19
name 6
outputs 14
restart 15
security 16, 17
Datalogic Automation Inc.
Index
storage 19
strobes 14
system information 19
Digital shift 29
Disable
security 17
Display
refresh rate 3
refresh timeout 3
Distortion 30, 32
Dot pitch 32
E
Emulator
connect 3
Enable
security 17
Event
rate 15
Events
diagnostics 15
Extrapolation 30, 32
F
Field of view 32
File
list 42
load vision program 42
restore to client 42
File camera
button 3
system object setup 38
File manager
file list 42
folder list 41
images folder 41
root directory 41
system object setup 41
web folder 41
Folder list 41
Font size 2
Format
png image 39
Frames per second 22, 31
G
Gain, camera 22
Gateway 6
Gateway, IP 10
General
system object 5
system object about 19
system object administration 16
system object diagnostics 14
system object properties 5
system object setup 6
system object, communication 12
Datalogic Automation Inc.
Impact Settings Reference Guide
Grid 33
H
Half resolution 29
Help, online 1
Hexagon 33
Hide camera tabs 2
Holdoff 12
I
I/O
polling rate 14
Icons
small 2
Image
buffers 16
distortion 30, 32
format 39
save 30
save buffers 16
Impact Device
connect 3
Input
debounce 12
diagnostics 15
event port 13
IP address 6
change 9
IP gateway 10
IP mask 6
change 9
L
Level, user 17
License
key 19
Line scan 25
acquisition mode 26
input termination 28
line trigger type 27
Live button 3, 21, 31
Load vision program
file 42
Log
system 14
M
Mask
IP 6
Memory 19
meter 15
Modbus TCP/IP
how it works 44
server 43
Modify user id 17
Monitor access 17
Page 48
Impact Settings Reference Guide
O
Offset, camera 23
Online
button 2
OPC
backup data 11
data access 45
server 45
OPC server 13
Operator access 17
Output
diagnostics 14
P
Parity, serial port 14
Partial scan 24
Password 18
Periodic auto-trigger 23
Pitch, calibration 32
Polling rate 14
Port
serial 14
Preferences
Camera 2, 3
Print
options 2
Programmer access 17
Pulse
length 22
R
Reboot 10, 15
Reconnect
device 2
Refresh
system log 40
Resolution 29
camera 31
Restart 15
Restore
settings 11
Root directory 41
RS-232 14
RS-485 14
S
Save
image 30
Scale factor 33
Scan, partial 24
Security
Device 16
disable 17
enable 17
Serial port
settings 14
Page 49
Index
Server
ActiveX 13
DPWS 13
enable/disable 13
OPC 13
Settings 5
about 3
administration 16
buttons 2
camera calibration 30
starting 1
Setup
camera 21
Shift
on both edges 12
on camera trigger 12
on falling edge 12
on rising edge 12
rate 15
source 12
Shutter open time 22
Simultaneous connections 10
Snap, camera 21, 31
Source
shift 12
Speed, serial port 14
Starting
Settings 1
Stop bits, serial port 14
Storage 19
Strobe
diagnostics 14
pulse length 22
Summary
table update 3
System
information, Device 19
information, device 19
log trace 14
System log
system object setup 40
System object
camera properties 20
file camera setup 38
file manager 41
general 5
general about 19
general administration 16
general communication 12
general diagnostics 14
general properties 5
general setup 6
system log setup 40
T
Tab
camera select 1
Target
Datalogic Automation Inc.
Index
calibration 32
Task
timeout 10
TCP/IP
input event port 13
tester 15
Time 10
Timeout
data transfer 10
task 10
Tool
activation 19
Trace
system log 14
Trigger
auto 23
camera 23
edge 23
periodic 23
rate 15
U
Units per pixel 34
Datalogic Automation Inc.
Impact Settings Reference Guide
Unload vision program
file 42
Update
summary table 3
User
add 17
delete 18
ID 17
level 17
modify 17
multiple devices 18
password 18
V
Vertical binning 30
Vision System
See Impact Device
W
Web folder
access 42
White balance 25
Page 50
Was this manual useful for you? yes no
Thank you for your participation!

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project

Download PDF

advertising