OrangeApps.UserLogonIO User Manual
Contents
1. Groups Safety Maintenance Administrator Table 5 2 Available user group As of Feb 04 2014 Version 0 1 UserLogonlO V1 0 User Manual Description of the function User ID Passing a user ID as INT value is optional The user ID is saved in the logbook Language ID Passing a language ID as INT value is optional If a language ID is specified the language of the SmartHMI is changed accordingly the following table Value of the Value of the language ID Czech 12 Romanian Language Language language ID 1 pe fp e oo pom e pe o pe p p Table 5 3 Available languages Peculiarities of language change during user logon If no language switching is used used FALSE then even with a given integer value gt 0 on the IO interface no change of the currently selected language is performed If language switching is used use TRUE the language will be switched to English by default when an Integer value 0 on the IO interface is given As of Feb 04 2014 Version 0 1 UserLogonlO V1 0 User Manual Description of the function Entry in the logbook Each user login is stored specifying the user ID and the language in the logbook of the robot 2014 02 04 UserLogonIO Configuration Interface Logon 14 41 27 362 Type INT Control Bit IN 1 User ID Starting 654 683 3014 02 04 User 3 is logged on as Programmer Language 14 41 07 934 en User 3 is logged on as2. the recognition of a user registration is disabled Using a time limited license the number of days remaining before the user login is disabled is displayed Security To protect against manipulation of the user login the access of the configuration plugin is allowed only for the user group Administrator Any change in the configuration is saved in the logbook of the robot The entered values are stored in the file under UserlogonlO xml generating a security code This security code is checked for plausibility If the plausibility test fails the function of the user login is disabled until a positive test is performed Thus manually changing of the configuration file is prevented A generated XML file can be copied from robot to robot The programming of the user login on to the higher level control must be only be performed by the plant operator authorized personnel Additionally this documentation must be observed The correct function of the IO interface must be checked regularly and documented An incorrect configuration of the interface can have a false unauthorized user notification As of Feb 04 2014 Version 0 1 UserLogonlO V1 0 User Manual Configuration Configuration Examples Example 1 User Switching via INT value Control bit is on input 65 User Group start bit is on input 66 bit width is 8 bits User ID used YES start bit is input to 74 bit width is
3. User The file UserLogonlO xml The UserLogonlO xml file appears to cannot be loaded Copy the be corrupted and cannot be loaded correct file to the directory Check the file and restart the uve me C KRC User and then SmartHmi restart the SmartHMI logon type incorrectly The value of the element logo type in configured must be INT or the UserLogonlO xml file has an BIT Value set to INT incorrect value and has been Info 103 automatically automatically set to INT Verify the configuration logon bit incorrectly The value of the element Logonbit in configured must be type of the UserLogonlO xml file has an integer Value set to 0 incorrect value and has been Info 104 automatically automatically set to 0 Verify the configuration Start bit for user group The value of the attribute Start of the incorrectly configured must element user level in the file Info 105 be type of integer Value UserLogonlO xml has an incorrect automatically set to 0 value and has been automatically set As of Feb 04 2014 Version 0 1 UserLogonlO V1 0 User Manual Messages to 0 Verify the configuration no of bits for user group incorrectly configured must be type of integer Value automatically set to 0 Flag user group used incorrectly configured must be TRUE or FALSE Value automatically set to FALSE Start bit for user id incorrectly configured must be type of integer Value automatically set to 0 no of bits for user id
4. incorrectly configured must be type of integer Value automatically set to 0 language switching used incorrectlyly configured must be TRUE or FALSE Value automatically set to FALSE start bit for language switching incorrectly configured must be type of integer Value automatically set to 0 no of bits for language switching incorrectly configured must be type of integer Value automatically set to 0 Check sum error impossible to read value Check sum error check sum is invalid no of bits user group has incorrect value min 5 and max 8 allowed no of bits user group has The value of the attribute LENGTH of 190 The value of the attribute length of the element user level in the file UserLogonlO xml has an incorrect value and has been automatically set to 0 Verify the configuration The value of the attribute USED of the element UserID in file UserLogonlO xml has an incorrect Info 107 value and has been automatically set to FALSE Verify the configuration The value of the attribute START of the element UserID in file UserLogonlO xml has an incorrect Info 108 value and has been automatically set to 0 Verify the configuration l The value of the attribute USED of the element languagelD in file UserLogonlO xml has an incorrect Info 110 value and has been automatically set to FALSE Verify the configuration The value of the attribute START of the element LanguagelD in file UserLogonlO xm
5. 16 bits Language ID used YES start bit is input to 90 bit width is 8 bits Configuration Plugin OrangeApps UserLogonl0 Configuration Control Bit IN 65 Logon Type INT Startbit IN Mo of Bits License 7 Reset Apply OrangeApps unlimited WA Storing the values in the XML file COn oe aon lt LogonType gt INT lt LogonType gt heqombpae os hegeome dsc Weerlhevel Stare 656 Mengen 38 7 gt lt UserID Enable True Start 74 Length 16 gt lt LanguageID Enable True Start 90 Length 8 gt lt Security gt 501BRAA5FC646CDAF42D51C04874EF856 lt Security gt lt 7 Commurcuircneanom As of Feb 04 2014 Version 0 1 UserLogonlO V1 0 User Manual Configuration Example 2 Bit coded User Switching Control bit is on input 128 User Group start bit on input 255 bit width 5 bits User ID used Yes start bit at input 513 bit width of 16 bits Language ID used No Configuration Plugin OrangeApps UserLogonl0 Configuration Control Bit IN 126 Logon Type BIT Startbit IN Mo of Bits License by Reset OrangeApps unlimited 7 Storing the values in the XML file E E E LOI T a e E Te Togon it leo TOGON EE Userleve lE rar man Ten h on UseciD Enabile frue ea e ETa en a lt LanguageID Enable False Start 530 Length 8 gt C r Sh OGohmo0Cefahy Soa 242 DEG ta Job oO lt 7 Seen dey 9 Commroiiacne tear As of Feb 04 2014 Version 0 1 UserLogonlO V1 0
6. Orange Apps UserLogonloO V1 0 KUKA KRC4 User logon using IO interface User Manual As of Feb 04 2014 Version 0 1 Introduction Copyright 2014 OrangeApps GmbH Arnikaweg 1 87471 Durach Germany www orangeapps de This documentation may even partially be copied and reposted In the excerpts reproduction a reference to the copyright owner and to this document must be noted The contents of this document have been tested with the described software Since deviations cannot be excluded no guarantee for full compliance can be taken As of Feb 04 2014 Version 0 1 UserLogonlO V1 0 User Manual Introduction History of document versions Version Date Author Change Reason Comment 0 1 Feb 04 2014 Christian Mayer First release Content 1 WAU OGU GUGM eene E E A 4 Tr Tarde rg oun e E nee en emer cttw eine wma ete 4 1 2 Representation Of information cccccceeeeeeeceeeceeeeeeseeeeeenseenseenseenseonseoaseonseonseonseonseoaes 4 1o Terminology SC occ ose cs ete mci e eeeeeem ecto emer ceen eect ane deh cuneneaneneeessueteees 4 ee MI ACCA AS e se rence en sews seuceerewseyeeasnsesieussicudeeenseviewsexsdsawaserecusteesavessrcessseuncceeewucesexes 4 2 PPFOGUIGT GOS CHEOULON sorse tween eecne a sneeweeesweneneserecneneebucee 5 3 Installation uninstallation cccceceeeececeeeeeeceeeneeceeeeeeceeueeececnenanennenas 6 3 1 Installation removal to from the robot Controller c
7. Safety Maintenance Language en Time 2014 02 04 14 41 28 629 Module UserLogonIO Message number 1 685 Entries Log Filter As of Feb 04 2014 Version 0 1 UserLogonlO V1 0 User Manual Configuration 6 Configuration The configuration of the IO interface is stored in the XML file OrangeApps UserLogonlO xml and is available as a plugin available Requirement to display the Setup Plugins User Administrator group Calling the configuration plugin The call of the Configuration Plugin takes place in the main menu under Configuration gt UserLogonlo The following configuration options are available Number of control bits Way users log on BIT or INT Start bit and BIT width of the user group minimum of 5 bits a maximum of 8 bits Using a user ID Start bit and BIT width of the user ID up to 32 bit Use of a language ID Start bit and BIT width of the language ID up to 8 bit Configuration Plugin OrangeApps UserLogonl0 Configuration Control Bit IN Logon Type Startbit IN Wo of Bits User group ely User ID As of Feb 04 2014 Version 0 1 UserLogonlO V1 0 User Manual Configuration Controls Element Attribute Description Possible values Control Bit IN Configures which input indicates the 1 4096 user login to the robot system Logon Type Configures whether the selection of the INT BIT user group is given bit coded or as an integer va
8. User Manual Starting the software 7 Starting the software The software runs as a background service and is started automatically when booting the robot controller As of Feb 04 2014 Version 0 1 UserLogonlO V1 0 User Manual Messages 8 Messages The following messages can be displayed in the message window Message Description Error type Number Data entered in the configuration plugin are incorrect Correct the Status values UserLogonlO xml file has The specified file was deleted Copy been deleted UserLogonlO the correct file to directory c Status 2 is temporarily disabled KRC User Plugin OrangeApps UserLogonlO The plugin was successfully loaded at Info 54 successfully loaded startup of the control l Represents under which user group User ID is logged on as the user with the id is logged into the Info user group system The default user operator is ii default user operator is logged into logged on The folder c KRC User could not be nf Path CAKRC User not found found G The specified file could not be found and was created automatically using IO configuration values are invalid file UserLogonlO xml not default values all 0 or FALSE available Automatically Additional messages will follow creation performed Check stating the result of the verification ig a the configuration check Perform a new Configuration or copy a correct file in the directory c KRC
9. cccsssessseeesseeeeeeeeeseeeeeeeeeeeees 6 3 1 1 System requirements for running cccceccceeeeceeeeceeecseeeceeeeceueeseeeeseeeseeeseueeseeeeseeesaeeees 6 A LICENSINO oea E a svar esneswacecenececneeewenecs 8 4 1 Licenses for robots Office Lite office computer and ccesseeeseeneeeeseeneeeeeeeeeeees 8 4 1 1 RODOL ICONS G eee ee em EEEE ENEA EEEE 8 4 1 2 License for KUKA OfficePC OfficeLite cc cccccccseccceeeeseeeeeeeeeaeeeseeeeseeeesaeeeeeeeseneesaees 8 BA WISEAMING GLICO NSC scr Ee 8 4 1 1 UserLogonlO is not installed yet cecccccccececseeeeeeeeseeeeseeeeseeeceeeeseueeseueeseesseeessneesaass 8 4 1 2 UserLogonlO is already installed ccccccccseccceeeeeeeeceeeeseeeeseeeeeeeeseuseseueeseeesseeesaneesaues 8 5 Description of the function ccccseeeeeeceeeeeneeeenscneesensenensenseseneenens 9 O Co nng ratlio N sss 12 7 Starting the software s sssssnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn nnn 18 OCS SACS agree E EEr E EEA EENEN 19 9 APPNO oe E E E EET 22 SI S OTIDE S a eee eee 22 As of Feb 04 2014 Version 0 1 UserLogonlO V1 0 User Manual Introduction 1 Introduction 1 1 Target group This documentation is intended for users with the following skills Usage of KUKA KRC4 robots 1 2 Representation of information These notes indicate that damage may occur if precautions are not taken This manual contains useful tips or special infor
10. l has an incorrect Info 111 value and has been automatically set i B i to 0 Verify the configuration Info 180 Info 106 The value of the attribute LENGTH of the element USER LEVEL in file UserLogonlO xml has an incorrect value and has been automatically set to 0 Verify the configuration The value of the attribute LENGTH of the element LanguagelD in file UserLogonlO xml has an incorrect value and has been automatically set to 0 Verify the configuration The value of the element SECURITY in file UserLogon xml can not be read Check the correctness of the file The value of the element SECURITY in file UserLogon xml does not match with the calculated value Check the correctness of the file The value of the attribute LENGTH of the element user level in file UserLogonlO xml is outside the limits When logon type BIT is used at least 5 bits are required As of Feb 04 2014 Version 0 1 UserLogonlO V1 0 User Manual incorrect value min 6 and max 8 allowed Element has incorrect value must be higher than 0 must be greater than or equal to 1 Value exceeds maximum number of inputs Range overlap Configuration successfully saved there s no user group for value value The configuration has been changed Would you like to save No license for robot serial number UserLogonlO is inactive No license file for OFFICE available UserLogonlO is inactive License for robot serial
11. lue on the IO interface Start bit IN First bit of the user group 1 4096 ee No of Bits Bit width of the user group 5 8 User ID Used Using the user ID for entry in the TRUE FALSE logbook Start bit SIN First bit of the user ID 1 4096 No of Bits Bit width of the user ID 1 32 Language Used Use the language ID for switching TRUE FALSE switch over languages m Start bit First bit of the language ID 1 4096 a No of Bits Bit width of the language ID Table 6 1 Controls in the configuration plugin As of Feb 04 2014 Version 0 1 UserLogonlO V1 0 User Manual Configuration Error Checking Simultaneously to an input of a value a plausibility check is performed If an error occurs a state message appears in the message window the entry is marked in red and the Apply button is deactivated A 3 24 07 PM 2 5 2014 UserLogonI0 1 10 Configuration Values are invalid OrangeApps UserLogonl0 Configuration Control Bit IN ia Logon Type INT E Startbit IN Mo of Bits License yy i Reset Appi OrangeApps Hi 7 OAW As of Feb 04 2014 Version 0 1 UserLogonlO V1 0 User Manual Configuration Buttons Button Description Return resets the displayed values to the actually saved values Apply Saves the displayed values Table 6 2 Buttons in the configuration plugin License verification The presence of a valid license will be periodically checked and displayed in the plugin If no license is available
12. mation for the current topic 1 3 Terminology used Notion Description SmartPad Handheld unit KUKA Control Panel Table 1 1 Used Terms 1 4 Trademarks NET Framework is a trademark of Microsoft Corporation Windows is a trademark of Microsoft Corporation As of Feb 04 2014 Version 0 1 UserLogonlO V1 0 User Manual Product description 2 Product description The software tool UserLogonlO provides a personalized logon to the robot system by means of input signals on the robots IO interface from an external system Features and characteristics Automatic change of the user group by means of input signals Optionally automatic change of the robots language at every change of the user group The registration of the user group to the robot system can be done either bit or integer coded The user logon is independent of the robot mode Optionally the transfer of a maximum 32 bit wide user ID is possible Optionally the transfer of a maximum 8 bit wide language ID is possible The IO interface and the way users logon is configurable by a fully implemented plugin and is stored in an XML file Each user logon with the given user group and optionally with user ID and the date and time is stored in the logbook Each change of the O configuration is saved in the logbook No KRL files or KUKA system files are manipulated A User Documentation German English is included Security The pl
13. ms Real Robot Office Lite and Office PC follow these steps Method 1 Extract the Zip file 2 Copy the installation folder OrangeApps UserLogonlO containing the setup files to a USB stick or directly to a drive on the target system for example d 3 Ifyou are already in possession of a valid license file copy it to the files in the installation folder The license file is automatically detected and installed during setup Alternatively you can manually install the license file after installation When installing from a USB stick connect this to the controlling PC or the SmartPad Choose commissioning gt Additional software from the main menu Click the button New software oe E You ll get a list of available software for installation If there s no entry OrangeApps UserLogonloO in the list click Refresh If now the entry appears go to step 10 8 Ifthe entry does not appear the drive from where to install must be configured first To do this choose Configuration In the new window you now have the option to select the path where to find the folder OrangeApps UserLogonlO 9 Select an empty cell in the installation paths for options and click path selection The available drives are displayed Select the drive on which the folder OrangeApps UserLogonlO is located and save your selection with The window closes OrangeApps UserLogonlO should now appear as an entry in the list If this is not the case press refresh and o
14. n the control PC has to be restarted To perform the final installation the control PC has to be restarted This can immediately be executed by clicking Reboot Control PC now or later by clicking ater 3 If you select later the window is closed In order finalize the uninstallation proceed with step 4 If you select Reboot Control PC now a restart of the control PC will be performed Step 5 is then executed Perform a shutdown of the control PC by clicking shutdown in the main menu During reboot of the control PC UserLogonlO will completely be uninstalled from the computer As of Feb 04 2014 Version 0 1 UserLogonlO V1 0 User Manual EEE Licensing 4 Licensing UserLogonlO is generally subject to licensing Licensing is a license file For testing purposes are free trial licenses under www orangeapps de available Without a license the software is indeed run but the recognition of a user application via the configured IO interface is disabled Reference A license for each robot is necessary Per robot once a trial license can be obtained Trial licenses limited in time For environments Office Lite and OfficePC trial licenses can be requested unlimited Date manipulations on the system are detected UserLogonlO automatically disables the license 4 1 Licenses for robots Office Lite office computer and Trial licenses can be obtained directly at www orangeapps de Runtime licenses are delivered on receipt of
15. number is invalid or expired UserLogonloO is inactive x Days left until license expires Table 8 1 Messages There is no user group for the value of the user group on the IO interface Messages the element user level in file UserLogonlO xml is outside the limits When logon type INT is used at least 6 bits are required The value of an element in the file UserLogonlO xml is less than 1 but Info 200 maximum available number of inputs me ot 4096 At a value of an element in the UserLogonlO xml file there is a range Info 220 overlap with the value of another element The entered values in the Info 400 configuration plugin were saved Dialogue successfully i i 7 Number of days UserLogonloO can still Status 103 be used The value of an element in the file UserLogonlO xml exceeds the The configuration plugin was closed without saving the changed values Yes button saves and closes the form No button closes the form without saving Cancel button cancels the closing of the form The license file to operate the software in a production environment is missing for this robot serial number UserLogonlO is inactive The license file for the operation of the software on the office computer systems and Office Lite is missing UserLogonlO is inactive The license to operate the software in a production environment for these robot serial number expired or is invalid UserLogonlO is inactive As
16. of Feb 04 2014 Version 0 1 UserLogonlO V1 0 User Manual Appendix 9 Appendix 9 1 List of Tables Table 1 1 Used Terms Table 5 1 Input ranges of IO interface Table 5 2 Available user group Table 5 3 Available languages Table 6 1 Controls in the configuration plugin Table 6 2 Buttons in the configuration plugin Table 8 1 Messages As of Feb 04 2014 Version 0 1 UserLogonlO V1 0 User Manual
17. r repeat steps 7 to 8 10 Highlight the entry OrangeApps UserLogonlO and press Install Confirm the security prompt with Yes As of Feb 04 2014 Version 0 1 UserLogonlO V1 0 User Manual Installation uninstallation 11 Read the license agreement carefully Explain your agreement to the license terms by clicking I Accept and continue the installation by clicking Continue If you do not agree with the license terms please cancel the installation by clicking Cancel 12 The installation will be prepared now To perform the final installation the control PC has to be restarted This can immediately be executed by clicking Reboot Control PC now or later by clicking later 13 If you select later the window is closed In order finalize the installation proceed with step 14 If you select Reboot Control PC now a restart of the control PC will be performed Step 15 is then executed 14 Perform a shutdown of the control PC by clicking shutdown in the main menu 15 During reboot of the control PC UserLogonloO will be installed on the computer 16 Remove the USB stick from the PC 3 3 Uninstall UserLogonlO Requirement User group Expert Method 1 Choose commissioning Additional software from the main menu 2 Highlight the OrangeApps UserLogonlO and click Uninstall Answer the security prompt with Yes The uninstallation is prepared After completion of the preparatory work a message box appears To perform the final installatio
18. the lO interface to be read Thereafter the user registration is performed accordingly If the control bit falls back to FALSE the user is logged out and the lowest user mode operator and the previously selected language are selected Each user login is stored in the logbook of the robot The selection of the user group can be done bit coded or integer coded Input ranges of IO interface Input Description Range of values Width Control bit Input which indicates the user login to the TRUE FALSE 1 bit robot system Area of inputs which indicates the user INT BIT group User ID Areas of inputs to indicate a user ID This INT 1 32bit user ID will be stored in the logbook Whether a user ID is used can be configured Language ID Areas of inputs to indicate a language ID INT 1 8bit The language of the SmartHMI is switched accordingly Whether language switching is used can be configured Table 5 1 Input ranges of IO interface Bit coded registration The user group selection on the robot system is done by bitwise assignment to the available user groups If multiple bits are set the lowest user group out of the bits is selected Integer coded registration The user group selection on the robot system is done by passing an integer value to the robot system corresponding to the user groups available Integer values outside the table below will be ignored Available User Groups Type of Application Integer coded 21101010 210
19. the license fee 4 1 1 Robot license In order to obtain a valid license you need the serial number of the robot These can be found on the rating plate of the robot or in the robot software in the Help menu Help gt Info gt Robot gt Serial number 4 1 2 License for KUKA OfficePC OfficeLite The product ID is OFFICE You need this ID in order obtain a valid license on www orangeapps de 4 1 Installing a License 4 1 1 UserLogonlO is not installed yet Copy before the installation of UserLogonlO the license file into the installation folder as below 3 2 described 4 1 2 UserLogonlO is already installed Method 1 Plug in a USB stick containing the license file to a USB port of the controller or sSmartPad Alternatively copy the license file to the robots d drive At startup of the software the license will be copied automatically into the license folder and then be enabled Note A run time license in the license folder will not be overwritten by a trial license Remove the USB stick Method 2 Copy the obtained license in the folder c KRC TP UserLogonlO Lic As of Feb 04 2014 Version 0 1 UserLogonlO V1 0 User Manual Description of the function OR 5 Description of the function A single control bit on the I O interface indicates a user login to the robot system Depending on the configuration of the IO area a toggle of the control bit from FALSE to TRUE causes the user group the user ID and language ID on
20. ugin to configure the IO interface is restricted to the user group Administrator The configuration is saved in an XML file and is provided with a checksum to detect manual changes in the configuration file In case of a changed configuration file the functionality of the user login is disabled until detection of a correct configuration file Hint The KUKA standard user registration will continue to remain functional To protect against abuse the passwords of the KUKA standard user login should be changed As of Feb 04 2014 Version 0 1 UserLogonlO V1 0 User Manual EE installation uninstallation 3 Installation uninstallation 3 1 Installation removal to from the robot controller The installation uninstallation is done via the additional software option These can be found in the main menu under start up The further procedure is analogous to install uninstall KUKA technology software This method is documented in the KUKA Exert documentation 3 1 1 System requirements for running Minimum Requirements Hardware Software KUKA system software 8 2 8 3 i gt If the software KUKA CPC is used on the robot a software PT certificate is needed to install the plugin In this case please get into contact with our customer service email to info orangeapps de before purchasing this product 3 2 Install UserLogonlO or upgrade to new version Requirement User group Expert For installation on the three syste
Download Pdf Manuals
Related Search