Asyril SmartSight Operating instructions

SmartSight
Programming Guide
Document
SMARTSIGHT_Programming_Guide_EN
000.100.531
Version
C2
Date
25.07.2019
Version SW
From
4.0.2
To

SmartSight
Programming Guide
Table of Contents
Version: C2
000.100.531 2/64
Table of Contents
TABLE OF CONTENTS................................................................................................................................2
1. INTRODUCTION....................................................................................................................................4
1.1. GENERAL INFORMATION.......................................................................................................................... 4
2. GENERAL INTRODUCTION ................................................................................................................ 5
3. CONTROL UNIT ....................................................................................................................................7
3.1. OPERATING SYSTEM ............................................................................................................................... 7
3.1.1. Locking the C partition................................................................................................................. 8
3.1.2. Unlocking the C partition ............................................................................................................. 8
3.2. ASYRIL LICENCE...................................................................................................................................... 8
3.2.1. General Information ..................................................................................................................... 8
3.2.2. Control of the number of cameras ............................................................................................. 8
3.2.3. Updating the licence..................................................................................................................... 9
3.3. STARTING THE ASYVIEW....................................................................................................................... 10
3.3.1. General Information ................................................................................................................... 10
3.3.2. Checking C partition lock status................................................................................................ 11
3.3.3. Checking Asyril licence.............................................................................................................. 12
3.3.4. Checking Cognex licence.......................................................................................................... 13
3.4. ASYRIL DATA BACKUP FROM DPARTITION............................................................................................ 14
4. ASYVIEW INTERFACE....................................................................................................................... 15
4.1. USER ACCESS LEVEL ............................................................................................................................ 17
4.2. ARCHITECTURE..................................................................................................................................... 17
4.3. LOGS (COM LOGGER AND LOGFILE)................................................................................................... 17
4.4. TESTCLIENT.......................................................................................................................................... 19
4.5. SIMULATOR ........................................................................................................................................... 20
5. ASYVIEW COMMUNICATION PROTOCOL..................................................................................... 21
5.1. TCP/IP PARAMETERS........................................................................................................................... 21
5.2. PROTOCOL............................................................................................................................................ 21
5.2.1. MessageType.............................................................................................................................. 21
5.2.2. Command .................................................................................................................................... 22
5.2.3. Standard Parameters................................................................................................................. 26
5.2.4. Parameters.................................................................................................................................. 27
5.2.5. Termination.................................................................................................................................. 27
6. ASYVIEW METHODS.......................................................................................................................... 28

SmartSight
Programming Guide
Table of Contents
Version: C2
000.100.531 3/64
6.1. MODES .................................................................................................................................................. 28
6.2. WORKING MODE................................................................................................................................... 28
6.2.1. Active Working Mode................................................................................................................. 29
6.2.2. Passive Working Mode.............................................................................................................. 34
6.3. RECIPE.................................................................................................................................................. 35
7. ASYVIEW INSTRUCTIONS................................................................................................................ 36
7.1. TABLE OF INSTRUCTIONS...................................................................................................................... 37
7.2. RECIPES................................................................................................................................................ 39
7.3. CALIBRATION......................................................................................................................................... 43
7.4. PRODUCTION......................................................................................................................................... 50
7.5. UTILITIES............................................................................................................................................... 58
8. TECHNICAL SUPPORT...................................................................................................................... 62
8.1. TO HELP US PROVIDE THE BEST SERVICE …........................................................................................ 62
8.2. CONTACT............................................................................................................................................... 62
REVISION TABLE....................................................................................................................................... 63

SmartSight
Programming Guide
Introduction
Version: C2
000.100.531 4/64
1. Introduction
1.1. General information
This document is the property of Asyril SA; it may not be reproduced, modified or
communicated, in whole or in part, without our prior written authorization. Asyril SA reserves
the right to modify any information contained in this document for reasons related to product
improvements without prior notice. Before using the product, please read this entire
document to ensure that the product is used correctly. However, if you encounter difficulties
when using the product, do not hesitate to contact our customer service department.
In this manual, the safety information that must be respected is split into three types:
"Danger", "Important" and "Note". These messages are identified as follows:
DANGER!
Failure to respect this instruction may result in serious physical injury.
DANGER!
This instruction identifies an electrical hazard. Failure to respect this instruction may
result in electrocution or serious physical injury due to an electric shock.
IMPORTANT!
Failure to respect this instruction may result in severe damage to equipment.
NOTE:
The reader's attention is drawn to this point to ensure that the product is used correctly.
However, failure to respect this instruction does not pose a danger.
Reference …
For more information on a specific topic, the reader is invited to refer to another manual or
another page of the current manual.
IMPORTANT!
Asyril cannot be held responsible for damage to property or persons caused by the failure to
respect the instructions contained in the manual for your machine.
NOTE:
All dimensions and values in this manual are expressed in millimetres (mm)

SmartSight
Programming Guide
General introduction
Version: C2
000.100.531 5/64
2. General introduction
SmartSight describes Asyril’s intelligent visual part detection system, ensuring straightforward
integration of any Asycube flexible feeder with any industrial robot brand.
Figure 2-1: SmartSight for the automated and efficient handling of feeding and vision
system.
SmartSight comprises Asyril’s powerful visual part detection and feeder management
software (Asyview), an industrial PC (Control Unit) as well as an optimally configured
Asycube and vision kit including camera, objective and all necessary cabling. It makes the
implementation of high performance flexible feeding system as simple as setting up
conventional feeders.
Capable of controlling up to 7 cameras and feeders, SmartSight is able to control the part
movements, ensuring their optimal separation and distribution on the platform. The location of
the parts to be picked is then provided to the robot or industrial controller. The feeding
recipes can be easily programmed thanks to Asyril’s intuitive user interface (HMI).
Alternative configurations for functionalities such as control part presence, position in gripper,
placing position are available on demand.
This document describes the function and operation of the SmartSight and its software
interfaces and the various functions involved in its use and integration.
For information about the hardware configuration and setup, please refer to SmartSight
Operating Manual.

SmartSight
Programming Guide
General introduction
Version: C2
000.100.531 6/64
The SmartSight software is called Asyview. It has an interface dedicated to the integrator
tasks as well as some log functionalities available for the end-user. The configuration of any
recipes and calibration tasks is operated through the Asyril HMI. Asyview, Asyview Interface
and HMI are installed on the SmartSight control unit.
Figure 2-2: SmartSight Control Unit
Role
More information in:
Asyview core
Visual part detection and feeder
management
Ch. 5 Asyview Communication
protocol
Ch. 6 Asyview Methods
Ch. 7 Asyview Instructions
Asyview interface
Monitoring and support to the
integration
Ch. 4 Asyview interface
HMI
Interface for monitoring, configuring
and teaching new recipes and as
well as defining image configuration
and calibration
See SmartSight User Guide
Control Unit
Starting procedure
License information
Backup and protection
Ch. 3 Control Unit
Table 2-1: role of Asyview and interfaces

SmartSight
Programming Guide
Control Unit
Version: C2
000.100.531 7/64
3. Control Unit
The control unit is factory configured and ready to use out of the box.
IMPORTANT!
This control unit is configured exclusively for the use of Asyril’s Asyview and HMI software;
NOT anything else. Failure to comply with this directive will void your warranty.
NOTE:
The control unit uses industrial-grade PC that were validated, tested and certified by Asyril as
suitable for the use of our software. As no guaranties can be given as to the suitability of any
other hardware, it is not possible to get the software as a standalone and install them on the
customer’s own system.
3.1. Operating system
The SmartSight control unit runs on Windows 7 Embedded Edition with the Enhanced Write
Filter enabled (EWF).
The idea behind this feature is to create an image of the C partition and lock it. Then, at each
start up, this image is run instead, and every changes made to it will be temporarily written in
system RAM, leaving the original C partition unchanged This implies that any change made
while the filter is enabled will be lost when power is lost (PC restart, power outage…)
The pros are as follows:
- Faster operation (not bottlenecked by the SSD’s read and write speeds).
- Virus protection (since a restart of the PC lets you start from a healthy image), so no
need to use any anti-virus software (usually resource-intensive programs).
The only con is:
- Having to unlock the partition to be able to perform any kind of permanent modification
on it (in the case of the C partition, this includes any OS configuration changes, port
changes….) .
NOTE:
To keep the system running within the optimal operating conditions such as defined by Asyril,
the customer may freely change the configuration of the Process and Remote ports, but NOT
change the OS default language (doing so may prevent the Asyview from functioning properly
if the number separator of the new language happens not to be a dot but a coma instead).

SmartSight
Programming Guide
Control Unit
Version: C2
000.100.531 8/64
3.1.1. Locking the C partition
To enable the EWF and lock the C partition and allow the use of the SmartSight system, a
batch file is included while the system is being configured at the factory. You can find this file
under:
C:\ Program Files \ Asyril\ EWF\ Lock.bat
Make sure all your other programs are closed and double click on this file to run it. After a few
seconds, the computer will restart and the C partition will be locked.
3.1.2. Unlocking the C partition
To disable the EWF and unlock the C partition and allow the configuration SmartSight system
(within the limits allowed by Asyril), a batch file is included while the system is being
configured at the factory. You can find this file under:
C:\ Program Files \ Asyril\ EWF\ Unlock.bat
Make sure all your other programs are closed and double click on this file to run it. After a few
seconds, the computer will restart and the C partition will be unlocked.
NOTE:
While the C partition is unlocked, the Asyview will not be able to be started and an error
message will appear on its starting window, stating that the EWF check has failed. When the
C partition is locked again, the Asyview will be able to be started.
3.2. Asyril licence
3.2.1. General Information
The Asyview software implements a licencing system that allows you to pay only for what the
customer really need i.e. the number of cameras you will be using with your control unit. In practice,
you will receive with your control unit a licence dongle that allows you to use the number of cameras
you have selected in your order. That licence can be upgraded if you need it, just get in touch with our
sales department.
3.2.2. Control of the number of cameras
Whenever you start the Asyview, a licence check will be performed to make sure the licence
you are using is authorizing at least as many cameras as you have configured for the
Asyview.

SmartSight
Programming Guide
Control Unit
Version: C2
000.100.531 9/64
3.2.3. Updating the licence
It may happen that you want to add more cameras to your control unit in the future. In this
case, you may ask for an update to our sales department.
The control unit comes with a little program to help you in this regard. Once you have gotten
in touch with our customer support department so they can make you an offer for the
upgrade, you can find the program by typing “LicenceUpdaterTool” in the Windows search
bar or by following this link:
C:\Program Files\Asyril\AsyView\LicenceUpdaterTool.exe
Once it’s started, you may click on “Create Update Request File”. This will generate a file on
your desktop that you may then send to Asyril. We then will send back an updated file that
you will need to copy to your desktop and restart the “LicenceUpdaterTool”. Finally, click on
“Import Update to Protection Dongle”. A confirmation message will inform you that the
procedure has been successfully completed.
Shows whether the provided
licence has the correct
parameters for the number of
cameras in the configuration file
(here a maximum of 3 cameras
can be used)

SmartSight
Programming Guide
Control Unit
Version: C2
000.100.531 10/64
3.3. Starting the Asyview
3.3.1. General Information
When the control unit is powered on, the Asyview will auto start with Windows, run a few
checks (EWF, licences…) and initialise the various components that are in the Asyview.arc
configuration file. When everything has been run successfully (or if a non-critical error
occurred such as a camera that was not found), it will trigger the HMI to start.
On this screen, you can get information on the progress of the various steps the Asyview is
taking when starting up such as checking the licences, loading the calibration files and
connecting to the various components. If a red cross appears, it means something went
wrong at a particular step. In this case, the starting up may be interrupted and the user has
no other choice but to close the window using the dedicated button (in that case, please
check the Log file at D:\Asyril\Logs\AsyView.log), or as stated before if the error is non-
critical, the starting up will proceed and the error will be displayed in the Log tab on the
Asyview user interface.(further information about logs is available at a later point in the
manual)

SmartSight
Programming Guide
Control Unit
Version: C2
000.100.531 11/64
3.3.2. Checking C partition lock status
At start-up, the Asyview performs a check to see whether the C partition is indeed locked. If it
is, start-up can proceed, otherwise it will be aborted.
Shows that the EWF is enabled
and start-up can proceed
Shows that the EWF is disabled
and start-up will be aborted

SmartSight
Programming Guide
Control Unit
Version: C2
000.100.531 12/64
3.3.3. Checking Asyril licence
The next check being performed is for the Asyril licence. If one is found, you will see 3 more
lines appear in the start-up window. The first confirms that the licence dongle has been
found. The next shows you whether the licence you have allows you to have as many
cameras as you have defined in the configuration file. The last checks the number of
Asycubes connected. In the current version of the Asyview, this number is not restricted, and
it will always be “Unlimited”.
Confirms the licence dongle for
the SmartSight system has been
found.

SmartSight
Programming Guide
Control Unit
Version: C2
000.100.531 13/64
3.3.4. Checking Cognex licence
The last check performed at start-up is the presence of the Cognex licence dongle. Again,
should it not be found, start-up will be aborted.
Shows that a Cognex licence
dongle has been found
Shows that no Cognex licence
dongle was found

SmartSight
Programming Guide
Control Unit
Version: C2
000.100.531 14/64
3.4. Asyril data backup from D partition
The SmartSight control unit also comes bundled with a tool allowing you to back up the
“Asyril” and “AsyrilData” folders found on D:\.
This tool can be accessed either by typing “SmartSight_Backup_Tool” in Windows search, or
at the following link:
C:\Program Files\Asyril\AsyView
When you start the program, it will scan the D: partition for both the “Asyril” and “AsyrilData”
folders. If either one is not found, backing up will not be possible (they both must be located
at the root of the D: partition). After the folders have been successfully located, you will be
asked to confirm the folder through a dialog window; pressing the Ok button is all you need to
do as the tool is only capable of backing up the aforementioned folders. Once the operation is
complete, the tool will save the backup file as a zip file at the root of the D: partition.
NOTE:
This procedure is not automated, and it is the responsibility of the integrator and the client to
perform it if they desire.

SmartSight
Programming Guide
Asyview interface
Version: C2
000.100.531 15/64
4. Asyview interface
NOTE:
Asyview interface can be launched by right clicking on the logo on the icon bar
At starting the Asyview interface is automatically logged with the end-user access level
(Figure 4-1). It allows showing the last entries of the Log File and informs also about the
installed release and configured architecture.
Figure 4-1: Asyview interface
NOTE:
To optimize the process speed, make sure to hide the Asyview interface window. A factor of
10x could be gained by closing this window.
Once logged on, you will have access to different tags function as shown in Figure 4-2 and
Table 4-1.

SmartSight
Programming Guide
Asyview interface
Version: C2
000.100.531 16/64
Figure 4-2: structure of the Asyview interface
Asyview interface
Contents
1
Login & SW information
(§4.1)
Login, project description and software release information
2
Architecture (§4.2)
Architecture of the SmartSight
Allow accessing to each of the different levels
3
Tabs
COM Logger
(§4.3)
when checked, show all sent/received commands
LogFile (§4.3)
monitor and save all messages
TestClient (§4.4)
description and structure of all commands
Simulator (§4.5)
simulates the whole process with vision detection, feeding
management and pick&place
4
Tabs content
Content will depends on the selected tabs
with export/clear/execute action buttons
Table 4-1: Asyview interface content

SmartSight
Programming Guide
Asyview interface
Version: C2
000.100.531 17/64
4.1. User access level
There are 4 access levels for the Asyview software. By default, after a startup you will not be
logged in at all and have only access to the log file.
You then have 3 user-accessible levels to choose from: “Standard”, “Advanced” and
“Expert”. The first two have no password to log in whereas “Expert” does.
Each level has its own set of instructions allowed to be run, with “Standard” being the most
restrictive
The last one is reserved for Asyril as it offers no restrictions to what you can do with the
software.
Figure 4-3: Connection and project information on Asyview interface
4.2. Architecture
By selecting a level in the architecture section (Figure 4-4), the information showed in the tab
content will be filtered to show only the corresponding message or commands.
Figure 4-4: Architecture of the SmartSight with access to the different levels
NOTE:
Asyril is responsible for the SmartSight architecture configuration, which serves as a specific
encryption based on the customer's requirements.
4.3. Logs (COM Logger and LogFile)
The Asyview has two different logging options: LogFile and COMLogger.

SmartSight
Programming Guide
Asyview interface
Version: C2
000.100.531 18/64
The former is a log of everything related to the state of the system (connection to sub-
components, user log-ins…etc). This is where you will see if something went wrong during
start up, or if another error would happen at execution time. Everything that appears on the
interface is being read from the files located at D:\Asyril\Logs.
The latter log file is a copy of all the TCP-IP requests that are being sent to and from the
Asyview. That way, you can make sure that your connection to the Asyview is working
properly and that your PLC is sending the proper instructions to the Asyview, and/or that you
get a proper answer. Everything that appears on the interface is being read from the files
located at D:\Asyril\Logs
Should you need support from Asyril about a technical issue that may have occurred, it would
be best if you linked the latest version of both these files to your request.
NOTE:
The COM Logger tab gives you the option of always enabling logging. This option is meant to
be used for a short sequence/ amount of time and only for testing purposes, as it may incur
slowdowns.

SmartSight
Programming Guide
Asyview interface
Version: C2
000.100.531 19/64
4.4. TestClient
Depending on the selected architecture level, the TestClient tab will list all corresponding
and available commands (Chapter 7 “Asyview Instructions”). It can help then to build a
command by selecting and informing the keywords and parameters. By clicking on
- the Insert button: the complete command will be written on the console
- the Execute button: the complete command is written on the console and sent to the
system
- a message line: the command is displayed in a more intuitive and readable format to
extract all parameters.
Figure 4-5: TestClient tab

SmartSight
Programming Guide
Asyview interface
Version: C2
000.100.531 20/64
4.5. Simulator
In the Simulator tab one can launch a cycle with the simulated pick requested. It allows
testing and seeing how to implement the process and the synchronization between the
(robot) controller and the SmartSight controller. The different parameters allow to set some
timer and to follow the results. Please note that a vision configuration must be done before
starting the simulation.
Figure 4-6 : Simulator tab