OrangeApps.SmartInputBox.User.en_V1.1
Contents
1. Insert a lt Mod gt kxr file in the c KRC DATA directory with the following content The parameter lt Mod gt corresponds to the string in the function call parameter lt Mod gt of the input box E O a ee OEE O a a to 1 lt resources xmlns http www kuka com schemas kxr 2009 gt lt Module name lt MOD gt gt lt Message key lt Text gt gt Sexe aie dee DE Ge iamlaM meee Irae mmercem lt 7 wine ae cece xii 2 eine Saba gt crane llersioein sing lisin sexic7 lt e e a Sauls lainga eS Dav sjoeiqi sla cieeinsleciom Cee a cexce gt Sera il Laine 4 Swain gt SiweckL Gla eiceinc ILeis om cee lt lt ee lt Message gt Module Re oU ee Replace the parameters lt MOD gt in the line lt module name gt with the file name you selected The lt Text gt parameter in the line lt message key gt corresponds to the parameter in the function call lt Text gt the input box In lines lt text xml lang gt the translation text is specified Example Function call IS liLMoutenedilu Geschwamaureakemt 2 My leehPack o 590 Oy ihe gt Kxr file MyTechPack kxr As of 25 04 2013 SmartiInputBox 1 0 User documentation Version 1 1 Programming Content of MytechPack kxr file lt 7 versione nO encoding sek SS lt resources xmlns http www kuka com schemas kxr 2009 gt lt module name MyTechPack gt lt message key Geschwindigkeit gt Please enter lt text xml l2. If you specify a translation file of the AIER specified text to be translated according to nar the selected language lt Mod gt Text that is displayed In nE window title or Char SmartinputBox specify a translation file Kxr Table 5 3 Passing parameters to the function call Input Real The program pointer of the KRL program remains at the code line of the function call unless the entry box is closed by clicking the Return key Not given parameters will be filled with default values see Table 5 2 As of 25 04 2013 SmartinputBox 1 0 User documentation Version 1 1 Programming 5 3 1 Example of an input box for Real values with given function parameters Function call i Inout oneal Enter teal valucia real inout I DOr j o5 570 PO EOT shown input box 5 01 59 PM 2 1 2013 Eingabebox REAL Realwert eingeben Wertebereich 10 bis 10 Been ner oer Figure 5 3 Real input box input function with the passed parameters 5 4 Close an open window in the input box krl program By default the command window is closed by pressing the Return key However there is also the option of a function call to close the window e g using a Submit program Function call in the KRL program InputBoxReset Return Value Value of the given parameter lt Value gt Example InputBoxReset Function parameters As of 25 04 2013 SmartInputBox 1 0 User documentation Ver
3. A LICENSING ereere EEE E EEES 9 Al Ge nerate ic nse UD SL aooniseiinanainninn naaa a 9 4 1 1 PRODOU IC CNS ccncasotansadustsdncannsenttadecaiicesnchnnsoaniaiads aE RE RAA 9 4 1 2 License for KUKA OfficePC OfficeLite ccc ceccceeeceeeteeeteeeeeeeeeeeeaeeeeueeaueeeueeseeeseeesaes 9 A2 MSAN AIG CIS 6 aiin a a a 9 4 2 1 Smartlnputbox is not installed yet eccceccsscesseeeeeeseeeseeseeeceeeseeeteeseeeseeeteesueeseees 9 4 2 2 Smartlnputbox is already installed 00nn0nnnannnnnnannnannnnnonnnnnnnnnnnnnnnnronnrsnrrnrrnnrrnnrenrrnnene 9 o Programming o eee ccs eects wed etevee sea td ereseeeneceees 10 5 1 Characters and fonts waiseeicectvccowencourcntnconnnnesnosseusvcuisamecusepinevneneaneguawnentumnbinwonrenanerouamodenors 10 95 2 Generate INPUT TOF INGE GOES scironiuosonnsiaviinnopan aeaa 10 5 2 1 Example of an input box for Integer values without given function parameters 11 5 2 2 Example of an input box for Integer values with given function parameters 12 5 3 Generate an input for floating point numbers cccceeseseeseeseeeseeeesesenseeeeeseneeseneens 13 9 3 1 Example of an input box for Real values with given function parameters 0 0 14 5 4 Close an open window in the input box krl program c sccesseeeseenseeeeenseeneeeeneees 14 99 The OE WO WY saia NEE a a 15 5 5 1 Steering the input window by function ParaMetEPS cccecceecceeeeeeeeeeeeaneesueeseeeseeeeees 15
4. call Inputint As of 25 04 2013 SmartinputBox 1 0 User documentation Version 1 1 Programming Not given parameters will be filled with default values see Table 5 2 5 2 1 Example of an input box for Integer values without given function parameters Function call ihe e lige 91 shown input box 4 40 08 PM 2 1 2013 SmartinputBox Figure 5 1 Input box without given function parameters As of 25 04 2013 SmartiInputBox 1 0 User documentation Version 1 1 Programming 5 2 2 Example of an input box for Integer values with given function parameters Function call i npt ligne NY Enter annee e r vale aaen UT o IN or ROPI shown input box 4 37 28 PM 2 1 2013 Eingabebox INT Integerwert eingeben Wertebereich 5 bis 10 1 Figure 5 2 Inputint input box with given function parameters As of 25 04 2013 SmartInputBox 1 0 User documentation Version 1 1 Programming 5 3 Generate an input for floating point numbers Function call in the KRL program iliac Weal lt Wexcl gt M gt lt valite gt lt Milia gt Wes lt Sitcio gt Return Value REAL Example DECL REAL r ET rea npt E Bmiwer rea va lee yen n E OOx REACTS aT Seo pe AOP AO Optional function parameters Optionally you can pass parameters to the function call These affect the appearance and behavior of the input box Parameters Description Type Default value Description text that appears in the window
5. 7 2 List of Tables Table 1 1 terms USC cccccccecccscccseeeseeeeeeseeceeseeesaeecaeecseeseeesaeesaeeseeceecseeseesaeeteeseeeeeeeaeees 5 Table 5 1 Letters and Fonts cccccccceeccseeceeeceeeceneceueeeeeceeceeeeaecegeeseesaeesgeesaeeseeeseeeseeeses 10 Table 5 2 Optional transfer parameter in the function call Inputlnt nnoannonnoennennnnnnnnnnnnnn 10 Table 5 3 Passing parameters to the function call Input Real cccceeeeeeeeeeeeeeeeeeeeeees 13 Table 5 4 Function parameters to control the Window display c sccccseeeeeeeeseeeeaeeeeaeeees 15 Table 5 5 Description of the input window ccccecceecceeeeeeeeeeeseeeeeeeseeeeeeecaeeseeeseeeseesaeeses 16 Table 5 6 Displayed input box in German language ccceeccceeeeceeeeseeeeaeeeseeeeseeeeseeesseees 19 Table 5 7 Displayed input box in English cccceecccsecceeeeceeeeceeeecaeeecseeceeeesaueeseeeseaeeseeeess 19 Table 5 8 Displayed input box IN Spanish c cece cece eeceeeeeeeeeeeeeeeeceeeeeeeseeeeeseeeseeeseeeseeeses 20 aI O 1 MCSSAGCS wr eutcharrteet netfee craic lena deren ead a eaten We Aes al 21 As of 25 04 2013 SmartiInputBox 1 0 User documentation Version 1 1
6. 99 2 OS EEEE ee E E E ese E E E E TE EE E E E 16 293 Check the INpUt WANG oo csic sche ence hees sec daestoncuenactedeegsdnncd a Ee a Eira E RAEES 17 5 6 Use of translation files to display the description text in the input window 18 5 6 1 Example of using a translation file ccccccccccceeeeceeeeceeeeseeceeeeseueesaeeeseeesseeeseeeeseeeeaes 18 6 M SSag S esncinissinrennn antanan hasnain 21 T PAO orina AAR 22 TT LIS O RIOUS ioen A EEE R EE 22 2 MSU ANOS uaii eneenedewsene doce new ana deemed ataaaee eee 22 As of 25 04 2013 SmartInputBox 1 0 User documentation Version 1 1 Introduction As of 25 04 2013 SmartinputBox 1 0 User documentation Version 1 1 Introduction 1 Introduction 1 1 Target group This documentation is intended for users with the following skills Knowledge of robot programming Knowledge in the robot programming language KRL 1 2 Representation of information These notes indicate that damage may occur if precautions are not taken This manual contains useful tips or special information for the current topic 1 3 Terminology used Notion Description KUKA Robot Language KUKA XML resource Table 1 1 terms used As of 25 04 2013 SmartiInputBox 1 0 User documentation Version 1 1 WS Product Description 2 Product Description The software tool SmartinputBox provides an input box for numeric values INT REAL directly th
7. Orange Apps SmartinputBox 1 0 KUKA KRC4 User documentation As of 25 04 2013 Document Version 1 1 Introduction Copyright 2013 Orange Apps 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 25 04 2013 SmartiInputBox 1 0 User documentation Version 1 1 Introduction History of document versions Version Date Author Change Reason Comment 1 0 06 02 2013 Christian Mayer First position Content 1 NToduUCHON orr E 5 i Ps I gt Ug ie oup eee ee erence cee en E ee eens mere sen re 5 1 2 Representation Of information cccccceeeeeeeeeeeeeeeeeeeeneeeessenseenssenseonseoaseonseonseonseoneeoaes 5 13 TEMNO SC aoc cece a S 5 2 PROGUGE WES CHD TOI sieren rE a aara 6 WAS CAIN NOUN ee A AE NEEE EEE T 3 1 System requirements FOr FUNNING cccceecceeseeeeseeeseeeeseeenseeenseeenseoeseeoeseeonseneaseoeaeeoenseons 7 3 2 Install Smartinputbox or upgrade to new version cseeeeeseeeeeeeeeceeeeeneeenssenesenesenees 7 3 3 Uninstall SmartlnputboXx iaescacenasasesisassumesindswunesitasisesonanianaicansuavsndennattacusasiandauasnustonansaetenuetenes 8
8. USB port of the controller or SmartPad Alternatively copy the license file to the d drive control 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 SmartilnputBox Lic As of 25 04 2013 SmartinputBox 1 0 User documentation Version 1 1 Programming 5 Programming 5 1 Characters and fonts In the descriptions of KRL instructions and functions following print types are used Element Representation Example Courier New font gray Ting ows Tae KRL code Upper lower case Elements that will Courier New font lt value gt be replaced by program specific content Angle brackets Italic Table 5 1 Letters and Fonts 5 2 Generate input for integers Function call in the KRL program Tapa liaic qc ieoic a lt wiecd S lt value lt Nialns lt Wex gt lt Sitejo gt Return Value INT Example DE CET A Le O TE Optional function parameters Optionally you can pass parameters to the function call These affect the appearance and behavior of the input box Parameters Description Type Default value Description text that appears in the window S ican a he ep selected language a tc ln i Gl ck a pe peme o i Table 5 2 Optional transfer parameter in the function
9. ang de DEV gt Speed lt text gt lt text xml lang en DEV gt Please enter velocity lt text gt SS ill a eS Day Eor weno ligcizoctiwzes lla wellociclee lt text gt lt text xmil lang sv Dihv gt in hastigher lt text lt Message gt lt Module gt lt Resources gt Display the entry box in german language 14 20 29 04 02 2013 MyTechPack Bitte Geschwindigkeit eingeben Wertebereich 10 bis 10 7 rn 1 i z z a a m 1 D n z a a n 1 n z a a a Table 5 6 Displayed input box in German language Display the entry box in english language 2 22 44 PM 2 4 2013 MyTechPack Please enter velocity Value range 10 to 10 PEPERIT Table 5 7 Displayed input box in English As of 25 04 2013 SmartiInputBox 1 0 User documentation Version 1 1 Programming Display the entry box in Spanish language 14 26 37 04 02 2013 MyTechPack Por favor introduzca la velocidad Value range 10 to 10 Table 5 8 Displayed input box in Spanish As of 25 04 2013 SmartInputBox 1 0 User documentation Version 1 1 Messages 6 Messages The following messages can be displayed in the message window Notification Description Error type Invalid value assignment within the Invalid value i function call InputBox is not completely installed Module The krl SmartinputBox module was not Quit ee found SmartinputBox is missing When you call the real function input InputInt or a greater
10. e SmartPad via KRL commands After the operator s entry via on screen keypad the value can be used by the robot program Using various function parameters the input box meets specific user requirements Features Call from the KRL program Input of integer or real values Specifying and verifying a range of values Specifying a text for the user Specify a window title Using translation files for language dependent display of the window text As of 25 04 2013 SmartiInputBox 1 0 User documentation Version 1 1 Installation 3 Installation The installation is done via the additional software option These can be found in the main menu under start up 3 1 System requirements for running Minimum Hardware Requirements KUKA System Software 8 2 3 2 Install Smartlnputbox or upgrade to new version Requirement User group Expert For installation on the three systems real Robot Office Lite and Office PC follow these steps Method 1 Extract the Zip file 2 Copy the installation folder OrangeApps SmartinputBox 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
11. sion 1 1 5 5 The input window 5 5 1 Steering the input window by function parameters 2 13 01 PM 6 7 2013 OrangeApps 2 Please enter a real value D Value range 15 5 to 20 8 SS a 4 E l La a L a n ry r 1 L a a a a i ee ot 1 a a a a i bolo i B 6 Figure 5 4 Function keys of the input window Parameters Number Parameters 1 lt Text gt e Table 5 4 Function parameters to control the window display Programming As of 25 04 2013 SmartiInputBox 1 0 User documentation Version 1 1 Programming 5 5 2 Keys 2 13 01 PM 6 7 2013 OrangeApps Please enter a real value Value range 15 5 to 20 8 4 5 Figure 5 5 Function keys of the input window Function keys of the input window Number Description Parameters CO Resor wow new Table 5 5 Description of the input window As of 25 04 2013 SmartInputBox 1 0 User documentation Version 1 1 Programming 5 5 3 Check the input value By the optional parameters lt Min gt lt Max gt a range of values can be defined The entered value may not exceed this range in order to be able to close the box If the entered value is outside the range the input area is outlined in red In addition the return key is switched inactive Representation of the input box at a value out of range 2 13 01 PM 6 7 2013 OrangeApps Please enter a real value Value range 15 5 to 20 8 Figure 5 6 Check of the input val
12. t Control PC now or later by clicking ater 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 As of 25 04 2013 SmartInputBox 1 0 User documentation Version 1 1 EEE instalation 15 During reboot of the control PC Smartinputbox will be installed on the computer 16 Remove the USB stick from the PC 3 3 Uninstall Smartinputbox Requirement User group Expert Method 1 Choose commissioning gt Additional software from the main menu 2 Highlight the OrangeApps SmartinputBox 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 installation 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 Smartilnpu
13. tbox will be uninstalled from the computer As of 25 04 2013 SmartiInputBox 1 0 User documentation Version 1 1 Licensing M 4 Licensing Smartinputbox is subject to licensing Licensing is done by a license file or a USB dongle Visit our website www orangeapps de for more information on licensing Reference A license for each robot office computer or Office Lite is required Trial licenses can be obtained once for each evaluation system Trial licenses are free of charge and limited in time Date manipulations of the system are detected Smartinputbox automatically disables the License 4 1 Generate license number Trial licenses can be obtained directly at www orangeapps de Runtime licenses are given after receipt of the license fee 4 1 1 Robot License To obtain a valid license you will need the serial number of the robot These can be found on the rating plate of the robot or in the control software in the Help menu gt Info gt Robot gt Serial number 4 1 2 License for KUKA OfficePC OfficeLite After installing and starting the software a product ID is displayed These ID you will need to obtain a valid license 4 2 Installing a License 4 2 1 Smartinputbox is not installed yet Copy before the installation of SmartinputBox the license file into the installation folder as below 3 2 described 4 2 2 Smartinputbox is already installed Method 1 Plug in a USB stick containing the license file to a
14. this to the controlling PC or the SmartPad Choose Start up gt Additional software from the main menu Click the button New software To 7 gt You ll get a list of available software for installation If there s no entry OrangeApps SmartinputBox 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 SmartinputBox 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 SmartinputBox is located and save your selection with Save The window closes OrangeApps SmartinputBox should now appear as an entry in the list If this is not the case press Refresh and or repeat steps 7 to 8 10 Highlight the entry OrangeApps SmartinputBox and press Install Confirm the security prompt with Yes 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 Reboo
15. ue Note f none of the parameters lt Min gt and lt Max gt specified no value checking of the input value If you specify only one of the parameters of the other parameters will be set to the default 0 The values of the parameters and lt Min gt lt Max gt be checked for plausibility If the value is less than the lt Max gt lt Min gt value an error message see Chapter 6 Messages As of 25 04 2013 SmartinputBox 1 0 User documentation Version 1 1 Programming 5 6 Use of translation files to display the description text in the input window SmartinputBox offers the possibility to display the description text in the input window language dependent You just need to specify a translation database kxr file in the parameter lt MOD gt If in the specified translation database an entry for the lt Text J gt parameter exists it is translated according to the selected language Reference Is there s not entry in the database for the actual language English will be used as the default 5 6 1 Example of using a translation file Target The description text lt Text gt shall be displayed in the languages German English Spanish and Swedish Method To edit a kxr file always use an editor which is able to use the character encoding UTF 8 eg Notepad Do not use the editors Notepad or WordPad Due to incorrect character encoding a malfunction of the kxr file can happen j 2
16. value was specified mn vane ERE as the parameter for the lt Max gt lt Min gt value Adjust parameters Quit l parameters The program can be to continue the program continued only if the parameters have been corrected The license file to operate the software in No license file available l S l a production environment is missing for Status for robot serial number this robot serial number License not valid or The license to operate the software in a expired for robot serial production environment for this robot Status number serial number is expired or invalid Test License x days left X number days until the license me fm expires Table 6 1 Messages As of 25 04 2013 SmartinputBox 1 0 User documentation Version 1 1 Appendix 7 Appendix 7 1 List of Figures Figure 5 1 Input box without given function parameters ccccccceeeeeceeeeeeeeeeeaeeeesseeeesaeeeens 11 Figure 5 2 Inputint input box with given function parameters ccceeceseeeceeeeeeeeeseeeeseeeeees 12 Figure 5 3 Real input box input function with the passed paramete ls cscccceeeeseeeeees 14 Figure 5 4 Function keys of the input WINGOW ccccceeccceeeeeeeeseeeeceeeeseeeeeeeseeeeseueeseeeenes 15 Figure 5 5 Function keys of the input Window ccccceeceseeeceeeeceeeeseeeeseeeeseeseeeeseueeseeeeaes 16 Figure 5 6 Check Of the INDUC VAlUC sisisihin ann anaia an aa a 17
Download Pdf Manuals
Related Search
OrangeApps.SmartInputBox.User.en_V1.1