1. Manuals
  2. Brands
  3. Asyril Manuals
  4. Security Sensors
  5. SmartSight
  6. Programming manual

Asyril SmartSight Programming Manual

Hide thumbs Also See for SmartSight:
Table of Contents

Advertisement

Quick Links

See also: Operating Manual , User Manual
SmartSight
Programming Guide
SMARTSIGHT_Programming_Guide_EN
Document
000.100.531
Version
C2
Version SW
From
Date
25.07.2019
4.0.2
To

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the SmartSight and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Related Manuals for Asyril SmartSight

Summary of Contents for Asyril SmartSight

  • Page 1 SmartSight Programming Guide SMARTSIGHT_Programming_Guide_EN Document 000.100.531 Version Date 25.07.2019 Version SW From 4.0.2...

  • Page 2: Table Of Contents

    ........................10 TARTING THE SYVIEW 3.3.1. General Information ........................10 Checking C partition lock status ....................11 3.3.2. Checking Asyril licence ......................12 3.3.3. Checking Cognex licence ......................13 3.3.4..................... 14 3.4. SYRIL DATA BACKUP FROM PARTITION ASYVIEW INTERFACE ........................15 4.1.
  • Page 3 SmartSight Programming Guide Table of Contents Version: C2 ..............................28 6.1. ODES ........................... 28 6.2. ORKING Active Working Mode ......................... 29 6.2.1. Passive Working Mode ......................34 6.2.2..............................35 6.3. ECIPE ASYVIEW INSTRUCTIONS ........................ 36 ........................37 7.1. ABLE OF NSTRUCTIONS ..............................

  • Page 4: Introduction

    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) 000.100.531...

  • Page 5: General Introduction

    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.
  • Page 6 General introduction Version: C2 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.

  • Page 7: 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.

  • Page 8: Locking The C Partition

    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...

  • Page 9: Updating The Licence

    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”.

  • Page 10: Starting The Asyview

    (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...

  • Page 11: Checking C Partition Lock Status

    SmartSight Programming Guide Control Unit Version: C2 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.

  • Page 12: Checking Asyril Licence

    Version: C2 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.

  • Page 13: Checking Cognex Licence

    SmartSight Programming Guide Control Unit Version: C2 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...

  • Page 14: Asyril Data Backup From Dpartition

    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...

  • Page 15: Asyview Interface

    SmartSight Programming Guide Asyview interface Version: C2 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.
  • Page 16 Asyview interface Contents Login & SW information Login, project description and software release information (§4.1) Architecture (§4.2) Architecture of the SmartSight Allow accessing to each of the different levels Tabs COM Logger when checked, show all sent/received commands (§4.3) LogFile (§4.3) monitor and save all messages TestClient (§4.4)

  • Page 17: User Access Level

    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.
  • Page 18 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.

  • Page 19: Testclient

    SmartSight Programming Guide Asyview interface Version: C2 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...

  • Page 20: Simulator

    (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.

  • Page 21: Asyview Communication Protocol

    SmartSight Programming Guide Version: C2 Asyview Communication protocol 5.1. TCP/IP parameters The Asyview is implemented as a TCP/IP server operating as a slave to the machine. You will therefore need to implement a TCP Client to connect to the Asyview.

  • Page 22: Command

    SmartSight Programming Guide Asyview Communication protocol Version: C2 5.2.2. Command The command is subdivided in three blocks: Address indicates to which device the instruction is addressed Keyword indicates the action which should be executed on the addressed device CallType indicates how the system should answer to the request is the character “:”...
  • Page 23 SmartSight Programming Guide Asyview Communication protocol Version: C2 Figure 5-2: Architecture level of the Asyview Also, you can find the indexes assigned to the elements in your system by looking at the tree structure of the Asyview in its interface: 000.100.531...
  • Page 24 SmartSight Programming Guide Asyview Communication protocol Version: C2 5.2.2.2. Command / Keyword Keyword indicates which action should be executed by the addressed element: Keyword for the standard process are for example - Start - Stop - SetParameter (WorkingMode / FieldOfView)
  • Page 25 SmartSight Programming Guide Asyview Communication protocol Version: C2 5.2.2.3.1. Command / CallType / Synchronous With the Synchronous CallType the asyview will respond to each request with one single answer once the action is finished or if an error occurred. The request does not block other requests.

  • Page 26: Standard Parameters

    SmartSight Programming Guide Asyview Communication protocol Version: C2 5.2.2.3.2. Command / CallType / Asynchronous Call With the Asynchronous CallType the asyview will respond to each request at least with one answer. The first answer will be sent directly after the reception of the command to confirm the validation of its parameters and the execution state.

  • Page 27: Parameters

    SmartSight Programming Guide Asyview Communication protocol Version: C2 In a request: • CID: Caller Identifier can be freely defined by the caller or used to differentiate the caller (integer). In an answer: • CID: Repeat the CID (if added in the request).

  • Page 28: Asyview Methods

    SmartSight Programming Guide Version: C2 Asyview Methods 6.1. Modes The Asyview controller has two modes: Configuration and Process. Their functions are as follows: Configuration: Default mode Allows recipes to be created and modified  Adjusting image and lighting acquisition sequences ...

  • Page 29: Active Working Mode

    Asycube management 6.2.1. Active Working Mode Figure 6-1 shows the standard interaction between a SmartSight module and the machine to synchronize the two cycles and transfer the position information. Reminder: in the Active type, the Asyview manages the Asycube feeding system automatically.
  • Page 30 SmartSight Programming Guide Asyview Methods Version: C2 6.2.1.1. With only one model Working mode has to be Set Working Mode to Active defined once for each module Asyview switches from Start Vision Device Configuration to Process mode Robot is out of the...
  • Page 31 SmartSight Programming Guide Asyview Methods Version: C2 6.2.1.2. With Multi-models, without choosing the part to take This mode of production is for example when you have 2 parts on the same surface and you want to take all the parts independently of the order.
  • Page 32 SmartSight Programming Guide Asyview Methods Version: C2 6.2.1.3. With Multi-models, with choosing the part to take This mode of production is for example when you have 2 parts on the same surface and you want to take the parts in a specified order.
  • Page 33 SmartSight Programming Guide Asyview Methods Version: C2 IMPORTANT! When the Asyview has multi-models using various image configurations, be careful to block all the fields of views that are impacted by the arrival of the robot. Otherwise, the new acquisition can take place when the robot is in the field of view and the parts will not be detected.

  • Page 34: Passive Working Mode

    SmartSight Programming Guide Asyview Methods Version: C2 6.2.2. Passive Working Mode With the passive process, the vision system simply responds to requests and does not manage the Asycube at all. Its operating diagram is described in Figure 6-4. Figure 6-4: Schematic of the Passive mode (in red: Asyview/machine interactions) 000.100.531...

  • Page 35: Recipe

    SmartSight Programming Guide Asyview Methods Version: C2 6.3. Recipe Different recipes can be created, saved and loaded corresponding to the different level in the architecture and with the extension as following: Level Extension Content Machine *.vrec The complete machine recipe Cell *.cavaf...

  • Page 36: Asyview Instructions

    SmartSight Programming Guide Asyview Instructions Version: C2 Asyview Instructions Here below are listed all instructions implemented in the Asyview. The TestClient tab in the Asyview interface can be used to create the instructions and test them. The instructions are categorized by domain.

  • Page 37: Table Of Instructions

    SmartSight Programming Guide Asyview Instructions Version: C2 7.1. Table of Instructions 7.2. RECIPES LEAR EACHING ) 39 ODULE EEDER ODEL ) 41 ODULE EEDER ODEL CALIBRATION 43 7.3. OINT ALIBRATE ] (M ARAMETER ALIBRATION ODULE EEDER ) 44 ] (V...
  • Page 38 SmartSight Programming Guide Asyview Instructions Version: C2 TART 7.5. UTILITIES XECUTE ARAMETER MAGES TATE ARAMETER ERSION ESET ATEST MAGES TART MAGES MAGES 000.100.531 38/64...

  • Page 39: Recipes

    SmartSight Programming Guide Asyview Instructions Version: C2 7.2. Recipes ClearTeaching ClearTeaching [ModelName=<string ModelName>] Syntax: Module Architecture level: Deletes the teaching for the specified model name. Function: Parameters: ModelName Name of the model that will be cleared. Feedback ImageAcquisitionManagerName Name of the ImageAcquisitionManager linked to parameters: the model.
  • Page 40 SmartSight Programming Guide Asyview Instructions Version: C2 or a remote server accessible from the AsyView controller. The : in D:\Folder must be replaced by &#58 (see example) ProcessFilePath same command ConfigurationFilePath Full path to the process configuration (.fproc). The recipe must be located on the AsyView controller or a remote server accessible from the AsyView controller.
  • Page 41 SmartSight Programming Guide Asyview Instructions Version: C2  cmd/? asyview/cell/module:loadmodelfile Example: filepath=d&#58\asyril\recipes\model1.iamod:newmodelname=model1:ne wimageconfigurationname=default  ?/cmd asyview/cell/module:loadmodelfile @pid=697:@status=200 See also: ClearTeaching / GetParameter [ModelNames] / SaveModelFile SaveFile (AsyView / Cell / Module) SaveFile [FilePath=<string FilePath>] Syntax: AsyView, Cell, Module Architecture level: Saves a recipe at the element level (see 6.3 Recipe) in the specified folder.
  • Page 42 SmartSight Programming Guide Asyview Instructions Version: C2 Feedback ConfigurationFilePath Path to the file, same as sent. parameters: ProcessFilePath Path to the file, same as sent.  Example: cmd/? asyview/cell/module/asycube:savefile @pid=119:@status=200 configurationfilepath=d&#58\asyrildata\recipes\feeder1.fconf  ?/cmd asyview/cell/module/asycube:savefile @pid=119:@status=200 configurationfilepath=d&#58\asyrildata\recipes\feeder1.fconf See also: LoadFile (Feeder) SaveModelFile SaveModelFile [FilePath=<string FilePath>]:[ModelName=<string ModelName>]...

  • Page 43: Calibration

    SmartSight Programming Guide Asyview Instructions Version: C2 7.3. Calibration AddPointPair AddPointPair [PositionX=<float PositionX>]:[PositionY=<float Syntax: PositionY>]:[VisionPositionX=<float VisionPositionX>]:[VisionPositionY=<float VisionPositionY>]:[ImageConfigurationName=<string ImageConfigurationName>] Module, Feeder Architecture level: Associates a pair of vision point to a pair of other points. Function: Parameters: PositionX X coordinate of the position...
  • Page 44 SmartSight Programming Guide Asyview Instructions Version: C2  cmd/? asyview/cell/module:calibrate Example: imageconfigurationname=default  ?/cmd asyview/cell/module:calibrate @pid=385:@status=200 calibrated=true:rmserror=0:imageconfigurationname=default See also: Uncalibrate GetParameter [Calibration] (Module / Feeder) GetParameter [Name=Calibration]:[ImageConfigurationName=<string Syntax: ImageConfigurationName>] Module, Feeder Architecture level: Returns the state of the current calibration and the calibration parameters...
  • Page 45 SmartSight Programming Guide Asyview Instructions Version: C2 configurations are not needed. Feedback Name CalibrationPointPairNumber parameters: ImageConfigurationName Name of the ImageConfiguration, same as sent parameter. Calibrated Boolean, indicates if the element is currently calibrated. ComputationMode Mode to compute the calibration. Usual value: Linear...
  • Page 46 SmartSight Programming Guide Asyview Instructions Version: C2 ImageConfiguration that can be used if multiple configurations are not needed. Index Index of the calibration point. Starts at 0. Usually between 0 and 3. Feedback Name CalibrationPointPair parameters: ImageConfigurationName Name of the ImageConfiguration, same as sent parameter.
  • Page 47 SmartSight Programming Guide Asyview Instructions Version: C2  cmd/? asyview/cell/module:getparameter Example: name=calibrationpointpairnumber:imageconfigurationname=default  ?/cmd asyview/cell/module:getparameter @pid=351:@status=200 name=calibrationpointpairnumber:imageconfigurationname=default:nu mber=0 See also: GetParameter [CalibrationPointPair] LoadCalibration LoadCalibration [ImageConfigurationName=<string Syntax: ImageConfigurationName>]:[FilePath=<string FilePath>] Module, Feeder, ImageAcquisition Architecture level: Loads manually a saved calibration for a specific element.
  • Page 48 SmartSight Programming Guide Asyview Instructions Version: C2 loaded automatically (or manually) on next system boot. Parameters: ImageConfigurationName Name of the ImageConfiguration (Module Level only) system always “default” ImageConfiguration that can be used if multiple configurations are not needed. FilePath Optional...
  • Page 49 SmartSight Programming Guide Asyview Instructions Version: C2 @pid=354:@status=200 name=calibration:imageconfigurationname=default See also: GetParameter [Calibration] (Module / Feeder) SetParameter [Calibration] (Vision) SetParameter [Name=Calibration]:[ImageConfigurationName=<string Syntax: ImageConfigurationName>]:[TileSizeX=<float TileSizeX>]:[TileSizeY=<float TileSizeY>]:[FiducialMark=<DotGridAxes/None/StandardRectangles>]:[FeatureFinder= <Checkerboard/CheckerboardExhaustive/DotGrid>]:[ComputationMode=<Linear/Line scan2DWarp/LinescanWarp/PerspectiveAndRadialWarp>]:[ExposureTime=<int ExposureTime>]:[Output01=<True/False>]:[Output02=<True/False>]:[Output03=<True/F alse>]:[Output04=<True/False>] ImageAcquisition Architecture level: Sets the calibration parameters for the specific ImageConfiguration...

  • Page 50: Production

    SmartSight Programming Guide Asyview Instructions Version: C2 Uncalibrate Uncalibrate [ImageConfigurationName=<string ImageConfigurationName>] Syntax: Module, Feeder, ImageAcquisition Architecture level: Removes the calibration for the selected ImageConfiguration on the targeted element. Function: Parameters: ImageConfigurationName Name of the ImageConfiguration system always “default” ImageConfiguration that can be used if multiple configurations are not needed.
  • Page 51 SmartSight Programming Guide Asyview Instructions Version: C2 Depending on when the command is sent, it is possible that the system will refuse it and send back a status=409. Then, the command must be sent again until the system accepts it.
  • Page 52 SmartSight Programming Guide Asyview Instructions Version: C2 ImageConfiguration that can be used if multiple configurations are not needed. Feedback Name FieldOfView parameters: <ImageConfigurationName01> State field view each <ImageConfigurationName02> ImageConfiguration. Locked or Unlocked <…>  cmd/? asyview/cell/module/vision:getparameter Example: name=fieldofview:imageconfigurationname=default  ?/cmd asyview/cell/module/vision:getparameter @pid=500:@status=200 name=fieldofview:default=unlocked ...
  • Page 53 SmartSight Programming Guide Asyview Instructions Version: C2 parameters: Model01 Returned only if existing. Name of the 1 model. Model02 Returned only if existing. Name of the 2 model.  cmd/? asyview/cell/module:getparameter name=modelnames Example:  ?/cmd asyview/cell/module:getparameter @pid=446:@status=200 name=modelnames:modelname01=model1:modelname02=model2 See also: GetParameter [PartsOnFeeder] GetParameter [Name=PartsOnFeeder]:[ModelName=<string ModelName>]...
  • Page 54 SmartSight Programming Guide Asyview Instructions Version: C2 parameters: ProcessManagerState State of the ProcessManager. IDLE or Running. ImageAcquisitionManagerName Name of the ImageAcquisitionManager linked to this ProcessManager. ModelName Name of the model, same as request.  Example: cmd/? asyview/cell/module:getparameter name=processmanagerstate:modelname=model1  ?/cmd asyview/cell/module:getparameter @pid=414:@status=200...
  • Page 55 SmartSight Programming Guide Asyview Instructions Version: C2  cmd/? asyview/cell/module:getparameter name=workingmode Example:  ?/cmd asyview/cell/module:getparameter @pid=420:@status=200 name=workingmode:workingmode=active See also: SetParameter [WorkingMode] GetResult GetResult [ModelName=<string ModelName>] Syntax: Module Architecture level: Sends the result of the next good part to be picked. Each result will only be sent once.
  • Page 56 SmartSight Programming Guide Asyview Instructions Version: C2 Indicates to the Asyview that the result of the given ID can be removed from the pending Function: results list, because the part was picked. This function has to be sent after the part has been removed from the platform of the Asycube.
  • Page 57 SmartSight Programming Guide Asyview Instructions Version: C2 SetParameter [WorkingMode] SetParameter [Name=WorkingMode]:[WorkingMode=<Active/Passive>] Syntax: Module Architecture level: Defines the working mode of the module. Function: See 6.2 Working Mode Parameters: Name WorkingMode WorkingMode WorkingMode of the module. Active or Passive. Feedback Name...

  • Page 58: Utilities

    SmartSight Programming Guide Asyview Instructions Version: C2  cmd/? asyview:stop Example:  ?/cmd asyview:stop @pid=170:@status=200 See also: Start / GetParameter [Mode] 7.5. Utilities ExecuteCmd ExecuteCmd [Cmd=<string Cmd>] Syntax: Feeder Architecture level: Sends a command directly to the Asycube. The list of available commands can be found Function: in the Asycube Programming Guide.
  • Page 59 SmartSight Programming Guide Asyview Instructions Version: C2 Parameters: Name Version Feedback Name Version parameters: Version Version of the AsyView Software  cmd/? asyview:getparameter name=version Example:  ?/cmd asyview:getparameter @pid=168:@status=200 name=version:version=4.2.0.15144 See also: Reset Reset Syntax: AsyView, Cell, Module, Feeder, ImageAcquisition...
  • Page 60 SmartSight Programming Guide Asyview Instructions Version: C2  cmd/? asyview:savelatestimages Example: folderpath=d&#58\asyril\imagedatabase:format=bmp  ?/cmd asyview:getparameter @pid=211:@status=200 See also: StartSaveImages/ StopSaveImages StartSaveImages StartSaveImages [FolderPath=<string FolderPath>]:[Format=<string Syntax: Format>]:[Number=<int Number>] AsyView, Cell, Module Architecture level: Saves the images for the next <Number> analysis.
  • Page 61 SmartSight Programming Guide Asyview Instructions Version: C2  cmd/? asyview:stopsaveimages Example:  ?/cmd asyview:stopsaveimages @pid=216:@status=200 See also: GetParameter [SaveImagesState] / StartSaveImages / SaveLatestImages 000.100.531 61/64...

  • Page 62: Technical Support

    - Serial number and product key for your equipment - Software version(s) used - Error message, alarm, or visual signals displayed by the interface. 8.2. Contact You can find extensive information on our website: www.asyril.com You can also contact our Customer Service department: support@asyril.com 000.100.531 62/64...

  • Page 63: Revision Table

    Minor corrections (architecture, product and documentation name) 12.06.2017 Minor modification (Chapter 4.2) 16.01.2018 Modifications for new version AsyView 4 29.03.2018 Modifications for new computer model 29.07.2019 CoG/ Added instruction descriptions and changes linked to Asyview 4.2.0 (Asyril licencing system) 000.100.531 63/64...
  • Page 64 Revision table Version: C2 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 authorisation. Asyril SA. reserves the right to modify any information contained in this document for reasons related to product improvements without prior...

Table of Contents