Home

JMobile Suite User Manual

1. File Name EventBuffer Set the schedule ri Figure 143 NOTE For each of the different Alarm Buffers a specific Event Widget must be configured for the project the current version of the Event List Widget does not allow you to switch between buffers 8 7 Managing Alarms at Runtime When an Alarm is triggered the Alarm will be displayed in the Active Alarms Widget The Widget allows you to acknowledge and reset the Alarm The Alarm display can be filtered by Hide Not Triggered Show All and other custom filters Please note that the visualization of the Alarm Widget is not automatic If the Widget has been placed on a certain page when an alarm is active you must add a dedicated action that will go to the page showing the Alarm widget 8 8 Enable Disable Alarms at Runtime You can enable or disable the alarms at runtime If you want to disable an alarm just uncheck the alarm from the Enable column in the Alarm Widget and execute the Save command This way the alarm will not get triggered and the disabled alarm will not be displayed at Runtime Select Id Source Value State Date Time Enable Alarm 23 Not Triggered Not Acked 25 01 2011 16 59 31 E E Aarma 23 Not Triggered Not Acked 25 01 2011 16 59 31 E E Aarma 23 Not Triggered Not Acked 25 01 2011 16 59 31 Alarm 23 Not Trig
2. Tag System Widget Recipe CurrentRecipe CurrentSelectedSet Elementi Value 4 CurrentRecipe 4 CurrentSelectedSet Elementl Name Value bo Element gt Elements Name Value gt LastDownloadedSet Name Status 4 Recipel gt CurrentSelectedSet act loweninarcerdd se Read Only Read Write Write Only Tagindex Figure 152 The Attach to Dialog allows you to attach to the numeric field all the different Recipe variables such as Current Recipe Current selected Recipe set gt Element gt value or name Selected Recipe gt Selected Seto gt Element gt Value or Name Selected Recipe list Currently selected Recipe list Recipe Status Among others When the numeric fields are defined as Read Write the default Recipe data can be edited on Runtime As explained in the introduction these new values are stored in a separate file as modified Recipe data 9 4 Recipe Status After every Recipe Upload or Download or Recipe set modification the Recipe Status parameters contain a value with the result of the operation The following are the values and conditions for the Recipe Status system variable Code rumcion metpton Set modified Current selected set changed Download ee e triggered Triggered a download San O 2 Download Done Done Download action Download action completed Error occurred when doing download errors like unknown Dow
3. Figure 45 Designer will show a dialog where you are asked to specify the Target type what to update in this example we are transferring a project so only the first check box has to be checked the path where to store the result of the operation it can be directly to the root folder of a USB drive plugged to a USB port on the PC and the encryption option Encryption option when marked creates a zip file protected by a password only known to Designer and runtime This password makes sure the zip file is not opened by un authorized person and its contents not changed for any reason The password cannot be changed after the file is created Once ready click the Create button to generate the update package Update Package Itis recommended to indude runtime files when IV Project updating project to older runtime versions E HMI Runtime E Encrypted Location Ez Cancel Figure 46 Assuming you have stored the package on the root folder of a USB drive remove the drive from the PC plug it into the panel activate the context menu by holding your finger for a few seconds on the screen see also Basic Unit Settings and select Update as shown in the following figure oom In zoom Out foom 100 Pan mode Settings Project Manager Update Backup Restore Logging Show Log at Boot Show system settings About Figure 47 The system will automa
4. Loo Figure 169 11 2 2 Multi Language for Message Widget Designer allows you to use Multi language in the message widget After you drag and drop a message widget select the language from the Language combo box and enter the message description for the selected language Again you can also use the export and import features as described in the chapter Export and Import of Multilanguage Strings Zero one two Figure 170 11 2 3 Multi Language for Alarm Messages Designer allows you to use Multi language for Alarm messages To add a Multi language string for an Alarm message open the alarm editor select the language list from the tool bar Language combo and add the alarm messages You can also use the export and import features as described in the chapter Export and Import of Multilanguage Strings Alarm 1 AlamButterl bitMaskAlam 0 Tagil mh This is atest Er Alarm AlamButter bitMaskAlam 1 Tagi This is a test 13 Alarm3 AlamButter bitMaskAlam 2 Tagi This is a test Figure 171 11 2 4 Multi Language for Pop up Messages For the popup message macro you can define the Multi languages To do this you first need to select the language from language list combo and then enter the message in the Show Message macro as shown in the figure below Action List a i stad Action List eP A W W ShowMessagel Show Dialog Mac
5. ccecccsecccsesccssccensccensceensceeesceeesceescss 159 11 2 1 Multi Language for Static Text Widget ccccseccsesceesceesceesceees 159 11 2 2 Multi Language for Message Widget ccccecceseccsesccesccesceesceees 159 11 2 3 Multi Language for Alarm Messages cseccceseccesssccesesceessceeeess 160 11 2 4 Multi Language for Pop up Messages sccccesecceessccesesceenecceeees 160 11 3 Export and Import of Multi language Strings ccccssescceeeeeees 161 11 4 Change Languages at RUNTIME ceccessccesscceesccesceeesceeesceeeess 164 WORKING withthe Scheduler sinioro 165 12 1 Configuring the Scheduler Engine eeseesssescseseeeseesseeseeeseessceseesseesse 165 122 FIVSMRES OLUTION errn n eb aeaeaee ees 166 129 Recurrence Schedule ecra T vies 166 12 4 Configuring Location in Designer Studio sesssssssessessseseceseesssesse 168 12 5 Configuring the Schedule Interface for Runtime Interaction 170 13 14 15 16 17 12 6 Schedule the Events During Runtime sseesenseeseossossossossssseeseeseo 171 User Management and PaSSWOrd scccsescsesccesccsscesscesssccesccesceesceesceecs 173 13 1 Configuring Security OPTIONS sssri resistenti siii ke 174 13 2 Configuring Groups and AuthorizationS esseessssseeeseesseeseceseesseesse 174 13 3 Modifying the Access Permission Of GroupS esessssessseesseessseesseesseess 174 13 3 1 Widget Permissions
6. Display video and animation on a webpage that does not use Disable Pi Ernshle J ul F Takes effect after you restart Internet Explorer Reset custom settings resets idm fal Download signed ActiveX controls 5 Disable Enable Prompt Download unsigned ActiveX controls Disable Enable Prompt Initialize and script ActiveX controls not marked as safe for s Disable Enable Prompt Only allow approved domains to use ActiveX without prompt Disable E Enable 4 Dun AeHweY ean eele ond mh inime wT Takes effect after you restart Internet Explorer Reset custom settings fa Internet Options Select a zone to view or change security settings Internet Local intranet Trusted sites Restricted _ amp sites W Run ActiveX controls and plug ins Administrator approved f k Trusted sites f This zone contains websites that you Enabl trust not to damage your computer or i your files n Prompt You have websites in this zone 8 Script ActiveX controls marked safe for scripting A me i F k Security level for this zone Custom ee Downloads Custom settings ef Automatic prompting for file downloads To change the settings dick Custom level a a air adii To use the recommended settings dick Default level Zoo Enable wat Fila Amanas 4 tl C Enable Protected Mode requires restarting Internet Explorer
7. 13 3 2 Action Permissions admin authonzations Action Permission Page Right Trend Allowed Refresh Widget Allowed UpLoad Recipe Wiowed Data Transfer Not Allowed a Write Tag ka Step Tag Launch Application Foomin Trend Allowed Launch Browser Allowed Enter Configuration Mode Allowed Restart Idal Allowed Write Current RecippeSet Allowed DownLoad CurrrentRecpe Allowed DownLoad Recipe Allowed Allowed Figure 190 With this dialog it is possible to assign the authorizations for the actions with respect to a project The access is either Allowed or Not Allowed As for the widgets the authorizations can be assigned globally but also for each single page and the widget programmed into the project Later in the chapter we will explain how to modify permissions for a specific action directly from the page view rather than locating the action from the tree view shown in the authorization dialog 13 3 3 FTP Authorizations For each group you can set specific authorizations related to the use of the FTP server as shown in the following picture FTP permissions can be enabled or disabled If enabled you can specify from the Permissions combo box the access level selecting between All Write Read Browse and None The IP Address list access allows you to specify from which IP an incoming FTP connection should be accepted NOTE IP access list configuration is common to all groups admin authonzations Permission
8. for any information related to the very first use of a brand new unit just out of production Panel Runtime can be updated directly from the Designeror using a USB pen drive 21 3 3 Updating Runtime from Studio From the Run menu select the Manage Target option then click on Update Runtime as shown in the following image Load Project Unload Project Upload Project Delete Project ote Target N 197 168 2 29 Notes for Update Runtime An update is available for your target Version available is 1 70 00 build 31 version detected on target is 01 60 01 Build 00 Note It may take few minutes Do you want to proceed Figure 264 A confirmation message will inform you about the current version installed and the version available in Studio When using the Download facility of Studio to simply transfer a project to the panel Studio is always checking in the background if the existing runtime on the target is compatible with the Studio version in use In case the runtime on the panel is found not to be compatible with the actual version of Studio you will automatically be asked to proceed with an update of the HMI runtime on the device In case the runtime version of the panel is found not compatible Studio will display a warning message as shown in the following figure You need to use the Manage Target tool to update the runtime as described in the previous chapter Please update the Runtime usin
9. Figure 71 Protocol Communication Status The variable is read only Int 82 bit and can have 3 values 0 No protocol running it may occur if the protocol driver has not be properly downloaded to the target system 1 Protocol has been properly loaded and started no communication errors 2 At least one communication protocol is reporting an error Protocol Error Message This variable returns an ASCII string containing a description of the actual communication error The communication protocol acronym is reported between square brackets to recognize the source of the error in case of multiple protocol configurations The variable is a read only string If no errors are present the string will be blank Protocol Error Count This variable returns the number of communication errors that occurred since the last time it was reset The variable is a read only integer The reset of this variable is only possible using the dedicated Action Reset Protocol Error Count 6 3 Daylight Saving Time The variables in this category return information about the system clock and allow adjusting it from the application They contain information on the local time All the variables are read only this means that you cannot change them to update the system RTC All the variables are bytes 8 bit except for the DLS and Standard Offset that are shorts 16 bit Standard time is the solar time and other is Daylight Savings Time Standard offset
10. The ScrollRightTrend macro is used to scroll the Trend window to the right side by one tenth 1 10 of the page duration NOTE With the Real Time trend it is recommended to pause the trend using the macro PauseTrend otherwise the window Is continuously shifted to the current value 7 5 4 ScrollTrendtoTime The ScrollTrendtoTime is used to scroll the Trend Window to a particular point in time When you execute this macro the Trend Window will move to the time specified in the Macro Properties Action List Action List Aa Vv W ScrollTrendT of imel Macro i RefreshTrend Macro Properties SorollLeft Trend E ScrolitrendToTime PageLeft Trend Trend Name PageRight Trend Page Duration Trend 2 Foomin Trend qi Pa a E ZoomOut Trend Select Tag Zoom Reset Trend Pause Trend Resume Trend Soroll TrendCursor Scroll Trend To Time Scroll Trend to Time Alarm Actions Scroll Trend To time He Select AllAlanms Figure 103 This Action may be very useful when you need to scroll at a specific position in a trend window based on the time at which a certain event occurs This can be achieved by configuring an action for that alarm event that executes a Data Transfer of the system time into a Tag when selecting that tag as ScrollTrendtoTime parameter see above figure the trend windows will be centered at the time in which the event has been triggered 7 5 5 Pa
11. The memory use is the percentage of this number As in the Figure above suppose the total number of samples used in the project is 80000 Then the total memory used will be shown as 3 This is calculated by the formula Total Memory Space 2ta Number of Samples used in the Project_ 4a Max Number of Samples allowed for a Project As we Increase the number of samples the percentage of usage also increases and this will be shown in the bar NOTE The maximum number of trend buffers per project is 30 with a total number of 1200000 samples The maximum number of samples configurable for a single trend buffer is limited to 200000 The following are the properties of each trend buffer in the Trend Editor Trend Name This defines the trend buffer name which will appear when you define the buffer to a trend window property pane A default name is assigned by the system the name can be modified by the user Active Specifies if the trend runs by default when the system starts up NOTE The trend buffers cannot be activated during Runtime SourceThis combo list allows selecting the Tag which is sampled by the Trend manager system Sampling Time Samples are collected and stored in the disk data file on a cyclical basis Default sampling condition is the time the sampling time specifies the Sampling period in seconds Trigger When the Trigger tag is specified the source tag is not sampled ona cyclical basis but on the Trigger tag v
12. factory for proper reconditioning When the System Settings menu is protected by a password for each critical function you try to execute that may compromise the proper system operation the HMI will prompt you to enter the password If correct the operation will proceed if wrong the operation will be aborted BSP intofsettings Version Timers Buzzer Battery LED Password System settings menu access Info Old password Name UNZ0 New password i Date 255 255 255 Confirm password fo input Panel mens 2121 LL fre el ef ad ef BSP Settings gt af2 3 4 5 8 7 9 0 6s n _ c ierc tlylulilol pit i Ae Urn Gogounnn Network ret Up Back Figure 258 The System Settings tool is accessible from the Designer context menu by selecting the item Show system settings When activated this way the System Settings tool always starts in User Mode The Designer context menu can be activated by pressing and holding down a Screen area without buttons or other touch sensitive elements until the menu is displayed The HMI products also support a special procedure for accessing the System Settings tool the special procedure is required to start the System Settings in System Mode or when the standard access procedure is not accessible for some reason When activated by this special procedure the System Settings tool always starts in System Mode The special acce
13. 3 1 9 Project Object This object defines the project widget The project widget is used to retrieve data about the project such as tags alarms recipes schedules tags and so on There is only one widget for the project and it can be referenced through the project variable 20 3 1 10 Properties startPage String startPage The page shown when the application is started var startPage project startPage project startPage Page2 jmx 20 3 1 11 Methods nextPage void nextPage The script executes the next page macro project nextPage prevPage void prevPage The script executes the Previous page macro project prevPage homepage void homePage The script executes the Home page macro project homePage loadPage void loadPage pageName The script executes to load the set page defined in the script project loadPage Page5 jmx showDialog void showDialog pageName The script executes to show the dialog page project showDialog Dialog jmx closeDialog void closeDialogQ The script executes to close the currently opened dialog page project closeDialog showMessage void showMessage message The script executes to display the message popup project showMessage Hi This is test message getGroup number getGroup groupName groupInstance callback Fast read method which gets the values of all tags in a group Parameters groupName A string containing the name of the grou
14. 7 2 1 SendKey The SendKey macro is used to enter the predefined character to the Read Write Widget Define the predefined key code and Shift key code to the Macro actions property In runtime first click the R W numeric Widget then execute the Macro to send the predefined keys to the Numeric Widget The action works on the field currently being edited NOTE To use the SendKey macro you must define the keypad type as Macro in the Numeric Widget properties as shown in Figure 49 Action List A wY W Sendkeyt ok canca Figure 86 w Properties Figure 87 7 2 2 SendKeyWidget The SendKeyWidget macro is used to enter the predefined character or function fora specific Widget To use the macro define the Widget ID and the key code in the Macro Properties The Control List Widget available in the advanced category of the Widgets Gallery is a good example of how this macro command can be used Here Up and Down buttons have been implemented using the SendKeyWidget macro See the figure below for reference Properties a x EJA amp ClckType a Value Fill Color eee ini nics OnMousePress Action OnMouseRelease Acti 1 Action dgl i E HH i A BZ e 4 Ma os OnDataUpdate Actio Configure Styles General Position Action List Action List A WY SendKepwidget Figure 88 NOTE
15. Comma Separated Values csv Unicode Text tt Figure 175 The Unicode Text file format must be used every time you import a file modified by Microsoft Excel You can save your Excel sheet in this format choosing File gt Save As and choose the option Unicode Text txt from the Save as type combo 11 4 Change Languages at Runtime After the project download Runtime will start using the Default Language However you can change the language on Runtime using the SetLanguage macro LanglD is the language index corresponding to the language ID as it can be read from the Language Configuration Editor NOTE After languages are changed at runtime with the macro execution the current language is saved and retained for the next run 12 Working with the Scheduler Designer provides a scheduler engine that can be easily configured to program the execution of specific actions at repeated intervals or on a time basis Depending on your application creating a schedule is typically performed with a 2 step process The first step is to define the parameters of the schedule to run on the panel This includes selecting the actions to perform when the scheduled event is activated The first step is performed using the Scheduler Editor The second step is to create a Runtime user interface that allows the end user to change settings per each defined scheduler For example the Runtime user interface will allow the user to turn on
16. Designer Studio icon can be added to the desktop Designer ie ee ee h P Setup will create the program s shortcuts in the following Start Menu folder To continue dick Next If you would like to select a different folder dick Browse termer i G A e a pg Tt Ia O e T Ia Figure 3 Figure 4 After installing the Designer Studio you can run the Studio application by using the desktop icon or from Start gt All programs Designer Studio 1 3 Having multiple versions of Designer Studio on same computer This feature enables users to install different instances of Designer on the same computer Each installation will have its own settings will work independently and can be uninstalled individually 1 3 1 Installing Multiple Studio Instances During the installation process three scenarios may arise and are described below 1 3 1 1 System without an installation of Studio already installed The installation procedure asks for the destination folder and installs in the folder that has been specified 1 3 1 2 System with only one instance of Studio already installed The installer detects that one version is already available and it will ask if you want to replace the current version with the new one or if you want to install another instance 1 3 1 3 System with multiple instances of Studio already installed The installer detects that one or more installations of Designer are available and it will ask if you want to repl
17. E LabelsWot reverseScale Display Category Description reverseScale jreverseScale E dataType labelNames dataFormat dataFormat onDataUpdate mle a r 1 E Supports Tags E Advanced Tags A Y Figure 244 Enter the name of the custom widget This is the name that will appear in the Property view The next step is to select the properties that will be displayed in the Property view Click on the button above the Properties list box and a Property Select dialog will be displayed NOTE The ConvertToWidget dialog shows standard custom widget types These types are defined in the gallery The dialog however does not show types that are specifically created for a project Display Name Name that will be shown in the Property view You can change it to set the information for each custom widget property Attribute Name The name exposed by Designer to JavaScript functions and Attach Tag dialog The default property name has the form WidgetType name WidgetType is the type of widget and name is the attribute name If you have more than one widget of the same type the widget type name will be WidgetType01 WidgetType02 etc Display Category The category or group of the property in the Property view All properties in the same category are shown together in the Property view This allows you to organize the properties in the vie
18. Eaa 256 21 3 3 Updating Runtime from Studid cccsssecccessscccesecceeeesccseeesceeees 256 21 3 4 Updating Runtime from USB Drive ccesecceessccessscceescceeescceeess 257 21 4 License Activation of HMI Panel Software Modules eecceee 259 PcG ACIN ALG PANIC oeie aaaces cue thoseacebeneceuestas saeco 259 DV 1D SAV LICENSE cen stecedus vetsecash sities versstuwiesedusvenieeitereees amotvin suse 261 213A SIMD ORE ICONS Cx seuss seaside bentcauscateadis a 262 21 GA CODESYS Demo MOU Esain n TE NO AENT 263 Designer Functional Specifications and Compatibility eeeeessseesseesseensee 265 22 1 Table of Functions and Limits sec ceescceesceeesceseccesceeesceenscees 265 222 COMMIS UO MY aicteticntactanie T teas satan a T aA 265 1 Getting Started with Designer Studio Software The Designer Studio is a software application used to create graphical HMI pages The Designer Studio has a drag and drop interface that makes it easy to create complex display pages The same features found in many popular Windows applications are also available in the Designer Studio This document describes how to use the Designer Studio application and is divided into chapters that represent the key operations of the Designer Studio Each chapter is presented in a standalone manner allowing you to jump from chapter to chapter depending on the task you wish to perform 1 1 Assumptions We assume that those reading this
19. MultiState Image widget The setProperty method returns a boolean value true or false to indicate if the property was set or not function buttonStd1_onMouseRelease me eventlinfo var setting result shape setProperty y 128 if Setting result alert Shape returned to start position function buttonStd2_onMouseRelease me eventinfo var image page getWidget multistate1 var result image setProperty imageList Fract004 png 2 Lies 20 3 1 4 Page Object This object references the current HMI page The page is the top level object of the screen 20 3 1 5 Properties backgroundColor string backgroundColor in format rgb xxx xxx xxx where xxx range from 0 to 255 The page background color function btnStd11_onMouseRelease me page backgroundColor rgb 128 0 0 width number width The Page width in pixels function btnStd05_onMouseRelease me var middle_x page width 2 height number height The Page height in pixels function btnStd05_onMouseRelease me var middle_y page height 2 userValue string userValue It gets or sets a user defined value for the Widget This field can be used by JavaScript functions to store additional data with the page function btnStd9_onMouseRelease me page userValue Here can store custom data 20 3 1 6 Methods getWidget object getWidget wgtName It returns the Widget with the given name Parameters wetName A str
20. NOTE Project manager is supported starting from runtime version 1 60 and above For older versions please refer to the Manage Target chapter in this document for how to switch projects on the device from the Studio software Project Manager 2 E4 workspace Project1 UnLoad Project Load Project Delete project Figure 11 Update When activated the panel verifies first the presence of an external USB pen drive inserted in the panel USB port and later for the presence on its root folder of the update package See the Updating Runtime from USB Pen Drive chapter in this document for further information Logging Enables you to display a trace of the system operation log may be very useful in case there is a need to debug a problem of any nature The following figure shows a case in which the system reports a communication error the decoding of the reported information may not be immediate but you can always use the option Log to file to save the dialog context to a file that can be later provided to Technical Support for investigation The log file is called logger txt and it saved to the folder var log on the panel flash disk The file can be retrieved from the panel using an FTP client NOTE The Log TO FILE Option is saved and retained after power cycles when not needed any more it must be manually deactivated HMI Logger CProtocol updateTags 3 ABEN readBlock failed ABEN re
21. RootFolder Common to all user groups IPAdress Figure 191 13 3 4 HTTP Authorizations The HTTP authorization dialog allows you to configure the IP access list which is common to all groups Additionally the user can define specific access permissions to a specific URL path within the Designer web server admin authonzations Common to all user groups IP list F Allow all Access limits Figure 192 Access limits Figure 193 13 3 5 Miscellaneous The Miscellaneous tab contains different settings related to several options as indicated in the following picture Please note that as indicated in the picture some settings are related to the group but some Settings are global to all groups admin authonzations Miscellaneous Can enter config mode Can Zoom Can mange other users Can see log Can load factory settings Can change own group Common to all groups Number of users allowed to login Figure 194 13 3 6 Access Priority If the Access control is applied to a Widget page and or even the Global Access then the top priority goes to the Widget access Top Priority Control from Widget Medium Priority Page Access or its Parent Access Low Priority Global Access This means that exceptions configured for an action or a Widget directly from the page view has priority over the base settings 13 4 Configuring Users To configure users double click on Users from the Project
22. TRUE Figure 134 Actions Define the action s to be executed for the specific Alarm Actions are executed by default when the specified trigger condition becomes true Additional conditions can be specified in the Events configuration in the last column of the Alarm editor as explained in the chapter Action Enable Action List Action List A W W ShowMessagel Macro Properties ShowMessage Data Transfer senna ToggleBit message Alarm Triggered Figure 135 Description This is the description of the alarm The Alarm description is normally text this text supports the multiple language features The text can be a combination between static and dynamic parts where the dynamic portion includes one or more tag values Please see the chapter Live Data in Alarm Description for further information about this feature FG Color BG Color You can modify the Foreground FG and Background BG colors of the alarm which will both apply to the Alarm Widget Severity A user can indicate the Severity of each alarm If multiple Alarms are triggered simultaneously the actions will be executed based on Severity settings Events These options allow you to specify conditions relating to following matters when the Alarms events are to be logged when the Alarms Widget View is to be refreshed or updated by the system and some particular options for action execution Setting Events is de
23. Users S ca tenes Pan i Recipel Pan IE Recipes Pan B T _ 148 Double click on the Recipes to open the Recipe Editor as shown in the figure below Add the recipe elements by clicking the button and then link the tags to the recipe element By clicking on the button Storage Type you can select where to store recipe data See the figure below A V Ei STORAGE TYPE Figure 149 A dialog in which the selection can be made will open See the figure below For USB and SD card you must provide the folder location Storage Type storage Type storage Location Figure 150 NOTE An external USB pen drive is referenced by the operating system as USBMemory an SD card as Storage Card 9 2 Configuring Recipe Sets on the Page The number of parameter sets can be changed in the Number of sets field in the property pane From there you can also change the name of each Recipe set Recipe values for all the parameter sets can be entered into the Recipe Editor window Recipe Recipe Name Test Recipesi Number of set 5 Set 0 Set Set 1 Seti Set 2 Set Set 3 Set Set 4 Set4 Figure 151 9 3 Defining Recipe Fields The user can define the Recipe field on the page by using the numeric field Widget from the gallery and attach the Tags from the Recipe data source The figure below shows an example of a Tag attached to a Recipe field field4 value
24. Verona Condition Calculated System Times GMT 1 SunRIse Time 04 3 2 55 Sunset Time 20 06 06 Figure 181 Condition The Condition combo allows you to select a Boolean Tag Yes No to be evaluated before activating the specified actions at the moment the timer is triggered If Tag True actions will be executed and if Tag False the actions will not be executed By default there is none gt the actions are executed when the timer is triggered NOTE The condition combo will list only the Tag attached to the Boolean data type Actions From the Action List dialog you can add as many Actions as desired The Actions will automatically be executed when the Schedule time occurs Action List Action Lit P A W W ToggleBit Project_TagMar Page Actions LoadPage PrewPage Figure 182 Macro Froperties ToggleBit Taghame BitIndex Tagi NOTE The Actions should be programmed in the Studio Actions cannot be modified at Runtime all other scheduler parameters can be modified in Runtime such as type mode location etc 12 5 Configuring the Schedule Interface for Runtime Interaction The User Interface for Runtime is the Widget called Scheduler To add this to the project just drag and drop it from the advanced section of the Widget Gallery Once the object is on the page in order to select the Scheduler items to be displayed in the Widget click on the button of the Name property t
25. View and then click on the sign to add a new user A user named admin is already present by default and this user cannot be deleted ProjectView 2X Y 1 Pagel Users x sers ESEN Lt v E e Projecti MName Default User Group Password Change Intial Password Comments Logoff Time In minutes Password Minimum Length Must contain Special characters i t poer jadmin O admin admin false admin user 0 false Eg Pages jusert oO admin user true 0 A false Ei 1 Pagel Puser admin user2 false 0 4 false Config 2 Protocols Tags pad Tr E AuditTrail E AuditTrail e Reapes e Dictionaries Figure 195 Name User Name Default User Identifies the user which is automatically logged in by the system when Starting re starting or after a logout only one default user is allowed Group Select user groups for the user Password Enter the initial password for the user Change Initial Password If True the user is forced to change his password on first logon Comments Comments for the user Logoff time In Min The user will be automatically logged off after the specified time with no actions on the panel After Log off the Designer Server goes to the default user Minimum Length In Numbers is the minimum length of the password It should be equal or greater than the set value Must Contain Special Characters If True the password should contain at least one special character Must Contain N
26. a clear overview of the supported functions and related limitations for both programming software and HMI runtime system What is listed below in this document is a safe limitation above which proper operation and state of the art performance of the system is not guaranteed 22 1 Table of Functions and Limits Function Feature Max allowed a Number of Recipes 2 Number of concurrent clients 4 Number of schedulers 030 Number of templates pages _ s_ is Number of actions programmable per 2o button state Number of Trend Buffer Samples for a 1200000 Project Number of languages Gd Number of event buffers 4 22 2 Compatibility Starting from the first official release of Designer V1 00 00 we have applied the following policy for compatibility Designer Studio version MUST always be aligned with Designer Runtime on the panel the user has the responsibility to update Runtime components on the Target device together with any Studio update a Runtime update can be done directly from Studio using the Update Target command available in the Run Manage Target dialog Any version of Studio newer than V1 00 00 is able to open and properly handle projects created on an older version but no older than V1 00 00 Projects created with older versions of Studio but not older than V1 00 00 opened with later versions and deployed to compatible Runtime are ensured to maintain the performance and functionality just as b
27. applied to the property Transformations can be simple linear relationships or generic transformations Linear scaling can be configured when selecting the Scale radio button and they can be Specified in terms of a formula or By range In case the range mode is selected you just need to specify the input and output range and the system will automatically calculate the factors for the formula IREE TE Scale Transform Scale By Formula 1 00 Figure 66 Special transformations are available when you click on the Transform radio button Currently supported transformations are color conversion and bit byte index Color conversion Allows you to define a map between numeric values of the tag and colors to be assigned to the property This feature is used to change the color of a button for example based on the value of a tag If the tag is an integer you can have many different colors based on the tag value Bit and Byte index Allows extracting a single bit or byte content from a word depending on the specified bit or byte number Scale Transform Forms 4 Color Conversion ColorPaletteCustom 4 Math Brilndex Figure 67 5 2 Events In a Designer system Events are the way to attach actions in the applications There are three types of Events e events related to buttons e events related to data changes e other events Events are generated under the following conditions e when a button
28. be supported by all platforms and all versions NOTE Settings selected and confirmed with the OK button in the upper right corner of the dialog are automatically saved to the registry System setings Info Name g mie Network am i No aux module detected Calibrate Touch Figure 9 3 1 Other Context menu options The context menu has several other options as follows Zoom In Out 100 Allow to zoom the view at runtime Pan Mode _ Enables Disables the pan mode works only when you have first activated a zoom in Settings Provides options to set the Context menu activation delay to enable disable the visualization of the mouse pointer to show the busy cursor hourglass when the system is busy with a long operation to enable disable the use of an external physical keyboard The figure below shows how the Settings dialog looks on the unit Context Menu Delays E 4 Show Mouse Pointer w Show Busy Cursor Use external keyboard Cancel Figure 10 Project Manager When activated a dialog box will appear See figure below providing options to unload de activate the current project load activate another project present on the panel memory or delete a project Please note that projects can be deleted only after they are unloaded If you click ona project name other than the active one the option Load project will first unload the running application and then automatically activate the new one
29. binary Binary represents arbitrary binary data Bran emessa time NOTE String coding in UTF 8 format is supported from runtime version V1 80 4 5 Designing a Page When a project is created a page is automatically added to the project and shown in the Page Editor To add objects to a page simply drag and drop the objects from the Widget Gallery to the page To add a new page right click on the Page node from the project tree and select Insert new page A dialog box will appear asking for the name of the new page Figure 25 4 5 1 Importing a Page A page can also be imported from another project By right clicking on the page folder in the Project View you will see an option named Import Page Please refer to the Figure below Insert New Page Create Group Events Buffer ed Scheduler gl MultiLanguage aia Security Tn lra ria Friii Figure 26 After selecting a page to be imported from the desired project when you click OK you get a warning message in the editor as shown in the figure below HMIStudio Imported Page has some MacroActions and DataLinks Import page does not have the support for importing MacroActions and DataLinks Do you want to remove those links from page Figure 27 Page Import can support only import of the page and the widgets in it but not the Macro actions and datalinks attached to the widget By selecting Yes all the datalinks and the
30. column by the actual value of the Tag The Widget automatically refreshes and shows the current values of the Tags in the Widget In History Alarm Widget it will show the value of the Tag at the moment the alarm was triggered Into the CSV file resulting from the Dump of the alarms events list the Tag values can be seen in the description column Result will be displayed as shown in the figure below Select c Source Value State Description Date Alarmi 123 Triggered Not Acked Alarm 1 Tag value is 123 25 01 2011 Alarm 234 Triggered Not Acked Alarm 2 Tag value is 1234 25 01 2011 Alarm3 4 Triggered Not Ackec Alarm 3 Tag value is 456 25 01 2011 Alarm Triggered Not Acked Alarm 4 Tag value is 987 25 01 2011 Alarm5 55 Triggered Not Acked 25 01 2011 Alarm 1234 Triggered Not Ackec 25 01 2011 Alarm 234 Triggered Not Acke 25 01 2011 t Ack Reset Save Check UncheckAll Filter Hide Not Triggered Figure 146 NOTE The ability to store the alarm description with tag values in the event buffer is a feature supported starting from version 1 80 8 10 Exporting Alarm Buffers as CSV file The historical alarm list the event buffer can be exported using the action called DumpEventArchive NOTE The tag values included in the Alarms description are also included in the event log stored in the event buffer The tags are sampled at the moment the alarm is triggered and that is the value re
31. define a numeric field and attach to the Widget Tag as shown in the figure below O Tag System Widget Recipe Tag TrendWindow gt cursor timestamp Cursor Cursor Timestamp Curve 1 Curve 2 Curve 3 gt Curved Curve 5 gt Curve General Grid Page Duration Position Title Figure 165 The Widget tag shown in the figure above represents the X axis cursor value for the trend window 10 6 Exporting Trend Buffer Data to CSV file The trend buffers stored in the selected media can be exported to CSV file using dedicated actions Please refer to Dump Trend for further information 11 Working with Multi Language A true Multi language feature has been implemented in Designer through code pages support from the Microsoft Windows systems The Multi language feature handles different code pages for the different languages A code page or a script file is a collection of letter shapes used inside each language The Multi language feature can be used for a project by defining languages and character sets Designer also extends the TrueType Fonts in short TTF provided by Windows systems to provide different font faces associated with different character sets Designer has features that allow users to provide strings for each of the languages When in edit mode Designer Studio provides support to change the display language from a language combo box This helps users see the page look and feel
32. either static or dynamic via DHCP server Please see the chapter Unit Basic Settings for further information on how to assign an IP address to the panel The Download to Target dialog is shown in the figure below Once the panel has a valid IP address assigned it will become discoverable on the local network Click on the discovery button as indicated in the figure below and click on the desired IP address Click on the Download button to start the process The system will switch the Target to Configuration mode and transfer the files When the download operation is completed the Target is automatically switched to Operation mode and the downloaded project is Started Download to Target Ready to download 192 168 7 LS Download HMI 192 168 4 210 HMI 192 168 7 129 Advanced Figure 40 Any time a project is changed the modified files needs to be transferred to the Target device When updating a Target Designer provides the option Download only changes to transfer only the modified files to the device The figure below shows the Advanced options expanded Download to Target Ready to download 192 163 7 129 v Download Advanced Download only changes T Delete Dynamic Files Recipe Security Users Schedulers Multilanguage Figure 41 The other option is about deleting dynamic files There are files that can be modified from the panel at runtime for example you can create n
33. manual are using the Designer Studio software to design control panel applications that run on CPDX panels We also assume that you have a basic understanding of PCs Microsoft Windows and the type of network environment in which you will run the application 1 2 Installing Designer Studio on a PC 1 2 1 System Requirements Designer Studio has the following system requirements Windows XP SP3 Windows Vista SP1 or SP2 Windows 7 100 MB of disk space Minimum of 512 MB RAM Ethernet interface 1 2 2 Installation Run the Designer Studio setup application Designer Studio vxxxxxxx exe and follow the instructions on the screen Fg eg aA ey Tr a a I accept the agreement I do not accept the agreement Figure 1 1 Read the Designer Studio Software License and accept the agreement 2 Follow the instructions on the screen The default location for the Designer Studio software is C Program Files Festo Software Designer Studio Default installation path can be changed depending on needs ee eed ee eh T aa Setup will install Designer Studio into the following folder To continue dick Next If you would like to select a different folder cick Browse Program Files Festo Designer Studio Figure 2 6 Ifthe Select Components step is available select the components you want to install 7 The installation procedure will create a program group called Designer Studio in the Start menu A
34. of the scale Widget and Bargraph Widget click on the NeedleWet min property and click on the BargraphWest min property from the Property Select dialog Click the OK button Both attributes will be shown in the Tags list box as shown in the figure below Properties List 4s Name Bargraph Property Values Display Name Min Attribute Name Bargraphigt min Display Category BargraphiVot reverseScale BargraphWgt onDataLpdate Description ScaleWot visibility2 Min value of the scale ScaleWgt alarmMax F Z ScaleWat stroke width AEE ae Gy Ticks Wgt stroke Ticks Wat stroke opacity Ticks Wot labelFreg Ticks Wat tickSize Ticks Wat tickFreg Ticks Wat tickSize Figure 245 You can arrange the order of the properties by clicking on the up or down button in the Property List To remove a property select the property name and click on the delete button When a property is selected in the Property List the property information is shown in the dialog box 18 3 Editing Custom Properties If you want to change the properties of a Custom Widget after it has been created you can simply right click on the Widget in the Page editor and select the Custom Properties menu item from the context menu The Custom Properties dialog will be displayed and you can change the properties 19 Sending E mail SendMail is an action that can be programmed and be triggered from an alarm or a timed sch
35. outside the limits defined for it Note that in this case the Limits field indicates which limit has been exceeded but the value can move farther out of this range The value is a constant and cannot move 7 7 4 DeleteTrend The DeleteTrend macro allows you to delete saved Trend data from the file In Macro Properties define the Trend name from which you want to delete the trend logs 7 7 5 DumpEventArchive The DumpEventArchive macro is used to export the Historical Alarm log and Audit Trail data to external drives such as a USB memory or SD card If you use a USB drive the path will be USBMemory or if you use an SD Card the path will be Storage Card followed by the specified folder in the memory NOTE The external drives plugged on the USB port of the panel must have format FAT or FAT32 NTFS format is not supported In the Macro Properties you need to configure the Event buffer name that you want to dump and the destination folder path The DumpConfigFile property must be set to true when you plan to convert the dumped files to CSV DumpAsCSV If this option is set to true the buffer will be directly dumped to the specified location as a CSV file If it is set as false then the dump of the trend file will be in binary format an external tool is then required to convert it to a CSV format DateTimePrefixFileName When this option is enabled the dumped file will have the Date and Time as prefix to the name of the f
36. present at the next start the panel will behave as a brand new unit This command does not reset settings like IP brightness or RTC and the command may not be present in all platforms and versions The second option Clear System settings allows you to reset the system parameters Resize Image Area resizes the Flash portion reserved to store the splash screen image that is displayed at power up Default settings are normally ok for all units Download Configuration OS checks the actual version and upgrades the back up operating system see relevant chapter for additional details Download Main OS checks actual version and upgrades the main operating system see relevant chapter for additional details Download Splash Image loads a new file for the splash screen image displayed by the unit at power up the image must be supplied in a specific format We suggest that you update the splash screen image directly from the Designer programming software Download Bootloader checks the actual version of the system boot loader and upgrades the system boot loader Download Main FPGA checks the actual version and upgrades the main FPGA file this command may not be available in all platforms and versions Download Safe FPGAchecks the actual version and upgrades the back up safe copy of the FPGA file this command may not be available in all platforms and versions Download System Supervisor checks the actual version and upgrades the system
37. protocol address dialog When Tags are initially added these Tags are named Tag1 Tag2 etc by default The user can rename the Tag with the appropriate name by clicking once on the Tag name The Tag Editor in Designer provides a Tag Import feature which is available based on the protocol selected Not all protocols support Tag Import If the protocol does support this feature see specific Protocol documentation first select the Protocol from the filter button and then click on the Import button as shown in the figure below Av s BE Modbus TCP prot Name Gop O iver O OOO Address Comment Select Controller Modbus TCP Select Import Type CSV Figure 21 You will see the dialog that corresponds to the protocol selected which prompts you to browse for the symbol file The symbol file is exported from the controller programming software 4 4 1 Designer Tag Editor The tool in Designer used to create and manage tags is called the Tag Editor For each tag the Tag Editor allows you to specify several properties Name This is the unique name at the project level of the tag This is the primary key used to identify the information in the internal runtime tag database Note that you cannot use the same tag name even if you are referring to different communication protocols Group After the tags have been defined in the Tag Editor they are used in the project by attaching them to the widgets properties S
38. represents the offset in minutes when standard time is set with respect to GMT with respect to the picture it is 8 60 480 minutes Standard week the week in which the Standard time starts w r t the picture it is First 1 Standard Month the month in which the standard time starts range of the variable is O 11 so w r t the picture it is November 10 Standard Day day of week in which the standard time starts w r t the picture it is Sunday Standard hour hour in which the standard time starts w r t the picture in Time field it is 02 2 Standard minute minute in which the standard time starts w r t the picture in Time field it is 00 0 Dst offset represents the offset in minutes when DLS time is set with respect to GMT w r t the picture it is 7 60 420 minutes Dst week week in which the DLS time starts w r t the picture it is Second 2 Dst Month month in which the DLS time starts range of the variable is 0 11 so w r t the picture it is March 2 Dst Day day of week in which the DLS time starts w r t the picture it is Sunday 0 Dst hour hour in which the DLS time starts w r t the picture in Time field it is 02 2 Dst minute minute in which the DLS time starts w r t the picture in Time field it is 00 0 Parameters for Day Light Saving Settings STANDARD TIME START IN UTC Offset Veek Day Month Daylight Saving Time Summer Time STANDARD TIME START IN UTC Offset Wee
39. schedule in the project but disable it by unchecking the box Each Scheduler can be configured to run once at Startup when the On Startup check box in marked Additionally you can specify the scheduler to be enabled only at the first start up run by using the Execute only at startup check box Type The Type combo allows you to select the type of Schedulers as shown in the figure below However you can change the type of scheduler at anytime during the Runtime as described in the chapter Schedule the Events During Run time Type Monthly By Date Mode Custom Daily Every vr Condition Weekly Yearly Figure 180 Options available for Type are the following By Date By Date scheduler allows you to define the schedule for the specific date and time when the actions shall be executed To define the schedule by date scheduler select By Date from the type combo and set the date and time Custom The Custom mode allows to specify a one shot scheduled action s Daily Daily schedules define the execution of a set of actions ona Every Hourly Monthly Weekly Yearly daily basis by specifying the time of day in which the actions are to be executed To configure the Daily schedule select Daily from the Type combo and set the time For some of the Schedule types you can further control them through different modes of Sunrise Sunrise Random etc The Every Scheduler is much like the Hig
40. siinon aoni na E 175 1323 2 ACHON PEIMISSION S aenar E E 177 13 De PUUNON IZ AO WS crne aT AOA 177 1325 4 GTP AUN ORIZ ALON S cenena 178 13 35 Miscellanea ees theresa eee ieeteeeaa wed sores 179 1D 9 6 ACCESS POr orir a E N 180 134 COMMUTING US CLS serred e e NS 180 Do BEU U Ci n A 181 13 6 Assigning Widget Permissions from Page ViIEW sssccsescssesceeeees 182 13527 Operation RU MUNG cerasana ecco aA 183 AEE Sahaeetare totais i coawache ante ava caest eset os oaesuesseianrneste sass yea a Ousaveneians 185 14 1 Enable or Disable the Audit Trail ccc cesesccessccesesccesesceesscceeess 185 14 2 Conis are AUCIE EVC MUS vssscc cert ceiconatioGimvisst ai ra 186 14 3 Configure Tags in the Audit Trail ccc ceeccessccesscceesceeesceeesceeeecs 186 14 4 Configure Alarms in the Audit Trail ce cecccesecceessccesecceesecceeees 187 14 5 Configure Login or Logout Details in Audit Trail eecceeeecee ones 188 14 6 Viewing Audit Trails in RUNTIMG cccceseccesscccesceeescceesceesceeeess 189 14 7 Exporting Audit Trail aS CSV File eccceseccceseccessccesecceenecceeees 189 Configuring printouts IN DESIQNEL cccessccessccsesceseccessccessccesseseeseeeeseees 190 15 Addin a TED ON onres a a 190 15AT ALAM CDOS oiera a E E T 190 12 TRIOS sasics nares eicatinaseutiaienieseesiecvncs seach N teases 192 15 31D PASS DO dV arn E a r eerie 193 15A Headerand FOO E eaaa aa aa 194 15 2 The context
41. specific path has to be provided NOTE An external USB drive is referenced by the operating system as USBMemory an SD card as Storage Card ProjectView a ote a deTest021 AuditTrail ig dcTest021_AuditTrail AlamBuffer True Pages 2 AuditTral True PE He 1 Pagel a Tags RD MultiLanquage Heig scheduler Figure 201 The system provides a save to file on the disk every 5 minutes NOTE Ifthe application requires fast saving of events we suggest using an external storage device with adequate support for frequent write operations It is strongly recommended to avoid fast writing to an internal flash disk 14 3 Configure Tags in the Audit Trail For most cases all the tags specified in the project do not necessarily need to be monitored You can customize the tags to be monitored by the Audit Trail AuditTrail PA Tags protocols Speed v AuditTrail Torque 7 AuditTrail Temperature W AuditTrail Viscocity AuditTrail Tag5 AuditTrail Tag6 E AuditTrail Tag E AuditTrail Tag8 IE AuditTrail Tag9 IE AuditTrail Tag10 v AuditTrail Tag11 AuditTrail Tagl2 AuditTrail Tagl3 E AuditTrail Tagl4 i AuditTrail Tagl5 i AuditTrail Tagl6 E AuditTrail Tagl7 AuditTrail Tag18 E AuditTrail Tagl9 E AuditTrail Figure 202 In the Audit Trail editor all the Tags are available for selection You can select only the Tags to be monitored by the Audit Trail For each se
42. started following specific events For Alarms reports the configuration of the event can be done directly in the alarm editor from the Events dialog by clicking on the Print tab as shown in the following figure Set here for which transitions of Alarm s status the programmed printing s has to be executed When entering the not triggered status Both when entering the triggered and not triggered status E When the alarm is acknowledged E When the alarm is reset When the alarm is disabled When the alarm is enabled Figure 213 Graphic reports printout can be started using the decicated action as shown in the following figure Action List Action List A W W PrntGraphicRepont Report Graphics 1 Figure 214 The Silent option true by default allows when set to false a dialog to popup at runtime which asks the user to adjust printer properties as shown in the following figure a HMIStudio Top Bottom 0 00 E O o E Left Right E 0 00 L 0 00 Portrait Landscape NOTE Ifthe printer is set to PDF the resulting file is saved in the unit folder Workspace PROJECTNAME reportspool where PROJECTNAME is a placeholder for the real name of your project You can retrieve the PDF reports accessing the unit with an FTP client as described in chapter Us ng the ntegrated FTP Server 15 4 Printer configuration Printer can be configured at project level using
43. that moment a new scroll is automatically done and the process repeats NOTE Automatic refresh is an option available starting from version 1 80 History Trend 100 80 60 Current Time 40 _ 16 19 46 20 16 19 00 16 20 40 16 22 20 16 24 00 Start Apop Time Time Figure 158 Trend Editor Historical trends require a proper configuration of trend data buffer Trends buffers are configured using the Trend Editor The trend buffers are stored in the format of a data file There is an option to store these data files on the Flash Disk USB Memory or SD card You can select where to store the data file for each trend buffer NOTE An external USB drive is referenced by the operating system as USBMemory an SD card as Storage Card Total memory Space ape Add Delete 3 ource Sampling Time Sec Tagi 60 Trigger Number of Samples None _ 0000 storage Device Flash us sD Buffer Boundaries Cyclic Create new file VO V1 lt 090 G V2 V2 gt 0 90 Figure 159 In the Project View pane double click Trends to open the Trend Editor Then add the trend buffer by selecting the Add button on the editor By clicking near each trend buffer the corresponding buffer configuration is expanded The Total Memory Space bar shows how much memory has been used by the trend buffers currently configured The max number of samples allowed for a project is 1200000
44. the Run Stop Simulator menu item You can also exit the simulator using close button of HM S mulator and by using the Exit option from the contextual menu oom In Zoom Out Zoom 100 Pan mode Full Screen Open Settings About Exit Figure 35 4 8 3 Simulator Settings The HM Simulator has the option to use actual or simulator protocols using the Simulator Settings button in the toolbar E HMISimulator Figure 36 When we invoke the Simulator Settings button a dialog will popup which displays the protocols used in the project User can select to use actual or simulator protocols by using the Use Simulation checkbox By default the M Simulator uses simulator protocol defined in the 7ag Editor Simulator column see Figure 37 NOTE Some protocols for example the Variable protocol don t have actual protocol Win32 and for these protocols this option remains disabled EF Simulator Settings PLC Settings ProtocollD ProtocolName 1 proti 2 prot Variables J Use Simulation 3 prots Variables J Use Simulation Figure 37 When defining Tag values the 7ag Ed toralso includes a field to select a method for simulating the data as shown in the figure below Tag values can be simulated in the following ways ala FY W a gt Vanables Tag Vanables prot Tag unsignedShort RW false None Simulator Details Data Simulator MATS Variables Counter Sine Wave Triangle Wave S
45. the actions Dump Recipe Data and Restore Recipe Data for further information 10 Working with Trends Trending indicates a method of sampling and recording values of a specified Tag according to sampling conditions normally the time Trending is divided into two main parts Trend acquisition and Trend viewing Trend acquisition programmed with the Trend Editor collects the data into a database The Trend viewer Trend Widget displays the data from this database in a graphical format 10 1 Real Time Trend In real time Trend the data will be presented directly in the Trend window and the changes to the live data can be seen directly in the format of a curve on the Trend window Users can manage the process by seeing the Trend on the HMI The real time Trend Widget is just a viewer for a Tag and it does not refer to any saved data in any buffer Any curve plotted is lost when the page containing the Widget is changed To configure the RealTime Trend just drag and drop the RealTime Trend Widget from the gallery my iy A ey H 27 ABs e Num Curves 1 eco ae gaa m rentie ae ETE i E E ia A a A hecath corsa ees aeaieesain mands Title mE saw ooo X Scale 60 Data Formal hh mm ss fo je eal o O E E oenen re ll FontColor 139 0 o1 2 eal ee Curve 1 BE 5 amei OO 05 30 00 05 30 00 05 30 00 05 30 00 DataLink Tag1 _TagMgr al i Se so ee ee aie Lian aaa a
46. the dedicated tool as shown in the following figure DHe cahe __ _ H ae o SO OSOS Figure 215 Each report can be eventually configured to use default printer settings or specific ones Per each report un mark the Use Default Printer Settings check box to get access to the printer settings as shown in the following figure 1 Pagel E Cc Report Graphics 1 EO Use Default Printer Settings Port a File Orientation Unit Portrait E Landscape Milimeters Inds Figure 216 15 5 Supported printers List of print languages tested Adobe PDF File HP PLC3 HP PLC5e Epson LX 9 pin List of Printer tested HP Laserjet 1320 HP Laserjet 4350 HP Laserjet 4700DN HP Laserjet 2015DN HP Deskjet D5560 Epson M2310 Epson LX 300 l E jE 5 08mm Width Height inl Left Printer Color Paper Margins Aas Top ef Sp tre Bottom a im 2 54mm Right Si 210 01mm H 297 00mm H ial 254mm Report Page 1 Available language printing languages NOT tested ial 2 54mm HP PCL Epson ESC P 2 Epson Stylus COLOR PocketjJet Il PocketJet 200 Canon BJ 300 dpi Canon BJ 360 dpi Amtech Epson LX 9 pin Adobe PDF file MTE W40 Canon IP90 Partner M1POS SP T8 Canon IP100 Zebra MP 300 O Neil 4 inch O Neil 3 inch 15 6 Minimum requirements Report printing from panel is supported starting from Designer a
47. the panel FTP server The FTP server responds to the standard port 21 when using the IP address assigned to the panel as host NOTE The server supports only ONE connection at a time if you are using an FTP client which is configured to multiply the connections to the server in order to speed up the transfer operation you will need to disable this feature in the client program or set the maximum number of connections per session to 1 The FTP server is configured by default to accept incoming connection from the following accounts User name admin Password admin FTP permissions and account information can be changed from the UserGroups under the Security item of the project folder as shown in the following figure ProjectView Lx af Authorization Settings e Pages e Config Protocols gA Trends x Events Buffer PF Scheduler gt MultiLanguage Eby Securi Users AuditTrail aE AuditTrail ques gquestAuth unauthorized false unauthonzedAuth Permission RootFolder l Common to all user groups Allow All F Page Templates Figure 55 Additional information can be found later in this document in the chapter titled FTP Authorizations 4 11 Using ActiveX Client for Internet Explorer In the standard distribution of Designer Studio a Windows Client Client and Designer ActiveX Client is provided ActiveX components are NOT installed by default to th
48. under the File menu File Edit Run Format View Wi J New Ctrl N Open Ctrl O close Save New Project Save Project Ctrl Save Project As Close Project 1 OUsers AuditTrailol 2 G Users Projectl Project Reset and Restart Exit Figure 17 4 3 Select Communication Protocols Device Communication drivers are configured in the Protocol Editor which is accessible from the project tree as shown in the figure below Double click on the Protocols icon in the Project Tree view to open the Protocol Editor To add a driver click on the Icon and select the driver from the list in the controller field Project View HAAY a Project b Pages o hE 1 Pagel Bg Trends Figure 18 4 3 1 Configuring a Communication Driver The combo box shows the list of available communication drivers Once a driver is selected configure the driver by clicking on the browse button in the Configuration field A configuration dialog will be displayed allowing you to set the parameters of the driver as shown in the figure below As an example to create a project for Modbus TCP you would select the Modbus TCP driver and then configure the communication parameters by selecting the browse button in the Configuration column Configuration Tag Dictionary HModbus TCF prot 1 port 502 timeout 2000 modbus UnitID Modbus TCP T PLC Network Alias IP address Port
49. 2 Config Protocols Tags Trends b Alarms Scheduler gt MultiLanguage Figure 137 When the events buffers are stored in the internal flash disk the system saves the file on disk every 5 minutes Max Samples in memory 0 FLASH 0 FLASH This parameter allows a certain degree of freedom in the control of the number of events retained in RAM before saving them to the file on disk With this parameter it is possible in fact to decide exactly after how many events the data will be written to disk This parameter is used ONLY when an external disk storage is selected When the internal Flash disk is used the parameter is automatically forced to 0 not used NOTE If the application requires fast saving of events we suggest that you use an external storage device with adequate support for frequent write operations It is strongly recommended to avoid fast writing to internal flash disk 8 3 2 Notify The user can choose the conditions under which the Alarms should be posted in the Alarm Widget This specifically refers to the default Alarm Widget available in the Widget gallery The user can decide when the Widget will be updated with a change of an Alarm Status We recommend leaving the default settings here and changing only those necessary for Specific application requirements Set here the alarm status transitions that has to be notified to the When entering the triggered status _ When entering the n
50. 3 5 LastVisitedPage The LastVisited page macro allows you to load the page previously displayed on HMI runtime 7 3 6 ShowDialog The ShowDialog macro allows you to display the Dialog Pages defined in the project After the execution of this macro the HMI runtime displays the specified Dialog Page Action List A Y W ShowDialogl a Macro Properties ShowDialog a rs LoadPage m i ShowDiioAction fileName Figure 92 7 3 7 CloseDialog The CloseDialog macro is applicable only to Dialog pages The Close Dialog macro allows you to close the dialog page currently displayed 7 3 8 ShowMessage The ShowMessage macro allows you to display warning message popups when the macro is executed Type the message that you wish to have displayed while executing the macro as shown in the figure below Action List A W A ShowMessagel Macro Script s Show Dialog Close Dialog i LaunchApplication Launch Browser Tag Actions Data Transfer ToggleBit Get Bit Write Tag Step Tag SubscibeGroup T WM r Figure 93 7 3 9 LaunchApplication The LaunchApplication macro allows the user to launch an external application when the macro is executed To configure the following information must be provided in order to execute the requested application App Name name of the executable file complete with extension For examp
51. 5 BrowseMedia The BrowseMedia macro allows you to browse the HMI panel and select a video to be loaded in the Media Player widget You have to specify the Media Player Widget in the macro properties 7 12 Print Actions Acton List Action List A Se ResetPassword Macro Properties Add ser Delete Llser Edit Users Print Actions PrintGraphic Report Empty Print ueue PausePrnting ResumePrinting Figure 132 7 12 1 PrintGraphicReport The PrintGraphicReport macro allows you to print a graphic report You have to specify the report name in the combo box reportName The option silent default value is true if set to fa se allows you to open a dialog at runtime which asks the user to adjust printer properties 7 12 2 PrintText The PrintText macro allows you to print the string written in the field text The option silent default value is true allows if set to false you to open a dialog at runtime which asks the user to adjust printer properties 7 12 3 EmptyPrintQueue The EmptyPrintQueue macro allows you to empty the current printing queue If the macro is executed in the middle of the execution of a job then the queue will be cleared at the end of the job 7 12 4 PausePrinting The PausePrinting macro allows you to put on hold the current printing queue If the macro is executed in the middle of the execution of a job then the queue is paused at the end of the job 7 12 5 ResumePrinting T
52. 80 in case an older version of the runtime has to be used on a unit with the Runtime loader please contact technical support for additional information 4 10 Using Windows Client Client The Windows Client Client provides remote access to the Designer Server and is included in the Designer Studio installation The Windows Client Client consists of a simple standalone application although it uses the same graphic rendering system as the server it relies on a specified Designer Server for live data Windows Client Client for Windows is available in the Runtime folder of the Designer Studio root folder Execute the Windows Client Client application from the Runtime folder or from the start up menu Designer Studio Windows Client The client will open in a browser like style window Type the server IP address the panel s IP address in the address bar for example http 192 168 1 12 The Client will connect to the server and the same graphical application running on the Server panel will be loaded in the client window Windows Client Client acts as a remote client and communicates to the server sharing the local visualization with those Tag values that are maintained or updated by the communication protocol Time Zone Options for Client Starting from version V1 60 the Windows remote client provides an additional option to handle the visualization of the timestamp information of a project From the Settings dialog you now have
53. ACGINS the PIO De thle Seesar nni E EENET RS 220 193 Edine CUSTOM Propere S nsien E TA 223 SONGS Ea aa a EREA 224 19 1 SendMal SCAD essnee 224 192 Conieure E mail SOny Cr cisrenan 224 193 Configure E mail ACCOUNTS serino naia a 225 19 4 Sending Live Tag Data through E mail nsenseeseossossossosssssseseesse 226 Workine WIiUriava SCID san E E A 228 ZO EXECU OM Anra A E 228 202 EVEN oeu E R E E ET EN 228 ZOD We NVIG SOU EVENTS setero rae E TR 229 DODD PAS EV CMS oranan a a N NONA AN A NOAN 230 202 VS eM EVON Saen aE E 231 20 3 Language RefELENCE ccccesccecccecesccesccsceesccesceceesccesseeceesceeseees 232 20 31 OD CCl S orrae suninsiete rave a euenwaeeniaaeee ee 233 20 32 REV WONG S cocesecetiensscessedenssitcheactecepsedescaweiaaisetenneiiussavercemeetensuoeiataiadees 244 203 3 GlO Da LFON CUON Seiger a aaaenaeeeeee 244 204 DEDUSSING Of JAVASCIIDE ciistscautthicercssteumieesedivewssadeanes ENS 244 QOS MM AUOS orna E E T sone Resasxeads oeaereeon es 246 Updating System Components in CPDX HM1 cssccesssccsecccesseceessceees 247 21k SYSTOM SUING S Tool aaron a e 247 21 1 1 List of Upgradable Components ccccsssccessscccsssccenscceeescceaess 251 21 2 Update of System Components from Designer Studio 08 252 21 3 Update of the System Components via USB Flash Drive 254 AD AD OA SECS cinin E a R 255 21 3 2 Updating Panel RUMUIMC lt ccxsiscsesiscossesa sna
54. Archive The DeleteEventArchive macro allows you to delete saved Event buffers log data from the file In the macro properties define the Event buffer name that you want to delete from the Event logs 7 7 8 SafelyRemoveMedia If you unplug an SD Card or a USB drive from HMI while it s transferring or saving information you might risk losing some information This macro provides a way to help you safely remove such devices Action List Action List P A W W S afeluRlemoveM edial i SerollEventsForwand Macro Properties a SafelyRemoveMedia Restart OTEO E tenor ver aeran ControlUserLED Type o USB Dump Trend pease cee USBMemory Delete Trend a Dump EventArchive 2 DeleteEvent rchive z Reset Proto ErCount Recipe Actions DownLoad Recipe Up Load Recipe Figure 112 7 8 Multi Language MultiLang Actions The Multi Language MultiLang macros are used to select and modify the languages used in the application 7 8 1 SetLanguage The SetLanguage macro allows you to set the current display language In Macro Properties enter in the Language At runtime while executing the macro the selected language will be applied to all applicable Widgets Action List Action List A W we SetLanguagel Macro Show Message Macro Properties LaunchApplication Launch Browser MultiLang Actions Language g English i SetLangu
55. BDIO FORLS HR67G 5BI5T and proceed Type your HMI MAC ID in field HostID Value as Custom MAC_ID e g Custom 0030D801DE27 Click Activate to generate the license Click Download to save the license file to your PC Open Designer Studio and select Run gt Manage Target gt License property page Select the panel if it is connected or enter the MAC ID if you are generating the license offline 8 Click the Import license button and select the license obtained via step 5 above Add more license files if more than one activation key was purchased 9 You can press the Activate Panel button to activate licenses on the HMI Panel or you can press Save License for offline license file generation W N M a ars NOTE After the activation is complete to enable license in the panel you must restart it 21 4 4 CoDeSys Demo Mode You can enable CoDeSys demo mode following these steps 10 Type the keyword CODESYS_ DEMO in an empty Activation key section e Activate panel Once you have completed entering the activation key you can press the Activate Panel button to activate licenses on the HMI Panel License folder Panel Info Activate Panel Select Panel 192 168 5 6 O Save License PanelID 0030080106854 Activation Keys Figure 271 NOTE After the activation is complete to enable license in the panel you must restart it 22 Designer Functional Specifications and Compatibility The scope of this chapter is to provide
56. Config o Protocols Figure 208 The following figure shows how the report configuration looks This part of the editor is used to set the number of pages and their order Use the icon with the symbol to add a page to the report layout When the mouse goes over any page already configured two icons appear to allow change of order and page delete O rmmaae vawe aH Use Default Printer Settings Add new page to the report Delete a page Report Page 1 Report Page 2 Figure 209 Double click on a page to edit the page report content using the page editor Each page is divided in three sections the header the footer and the page body In the page editor the area under editing is shown in white the others are grayed out To edit a different section just double click over the grayed out area 15 1 3 Page body The page body is the central part of the page as shown in the following figure Footer Height 9g Rl Scheduler oe S MultiLanquac E Security A UserGroups e 1 AuditT rail fE AuditTrail Figure 210 The widget gallery accessible from the right side sliding tab is contextual and includes only the widgets available for the area under editing 15 1 4 Header and Footer The header and footer are the top and bottom parts of the page as shown in the following figure QQ AQ KM romnort X T rl BOR e peoe jem Dictionaries p DialogPages Figure 211 T
57. Data Transfer x Figure 84 Widget The Widget to slide Direction Sliding Direction Speed The transition speed of the sliding Widget X Distance The travel distance of the X coordinate of Pixel Y Distance The travel distance of the Y coordinate of Pixel Slide Limit Enable Disable limiting the movement with Respect to the Coordinates X and Y of the Widget X Limit When specified automatically stops the slide action when the widget reaches the specified position Y Limit When specified automatically stops the slide action when the widget reaches the specified position Toggle Visibility Toggle the Visibility of the Widget at the end of each Slide action Image WidgetAllows an image to show during the movement the specified image will be shown during the Slide Operation between the start and end point of the movement 7 1 4 RefreshEvent The RefreshEvent macro allows you to refresh the selected Event Widget The Event Widget is a component of the Alarm History Widget See paragraph Configure Alarms History Widget Action List Action List P A W W RefreshE venti Widget Actions Macro Properties e RefreshEvent TiggerlPCamera Slide Widget Event Name EventBufferwgt1 Keyboard Actions Page Actions LoadPage HomePage Z FrevPage NetPage a Last VisitedPage Event Name Set the Widget name Figure 85 7 2 Keyboard Macro Actions The Keyboard macro actions include Send Key and Send Key Widget
58. Designer Studio 1 90 8004847 20130404NH This document contains information for Designer Studio on line help accessible from Designer Studio Help command CANopen CoDeSys and MODBUS are registered trademarks of the respective trademark owners in certain countries Manual Designer Studio 1 90 8004847 Version 20130404NH Origin PTn412 Ver 1 05 Contents Getting Started with Designer Studio Software ccecccescesccsscceesceesceeses 9 LE FASS UTM OMS sos cadecuexcetoanws6eaeiwasadeaaesicoss vase toaates Ga seawessenvanee eae trae ese 9 1 2 Installing Designer Studio ON a PC eecceeeeceseccensccensceensceeesceeeess 9 L221 Sylen REGUINETINCINS aneren e 9 LRZ IS NO ea O ies trose aus ones 9 1 3 Having multiple versions of Designer Studio on same computer 11 1 3 1 Installing Multiple Studio Instances seeesseesseesseesseeesseesseesssesseeeses 11 1 3 2 Opening Project file created with older version of Studio 12 WA Desizher PACK ASO naen T AE E 13 TASC RMEOUNIN E ana henner tit Serene ier Me reer eran eterna rer 14 Ba SIG UME SOUS S seven ce tatatactaemecai nie R saat ccceuuta cae pesneoence needa euedces 15 3 1 Other Context menu OPTIONS sccesscsscccssiccendciecdinesaccsinessedssedibseveussaeessas 16 S22 UNI SINE SCV CE aamen e r a A 18 MY FITSECDESISNCEPrOJE esnia a a 19 41 Creatme a NEW Project merenn N 19 HD WOK D IC Oae a a R inde lakaaeaebenanenssaceteds 21 4 3 Select Co
59. HS0 10026 File Name gize Date Figure 261 In the component list locate the one you need to update check the box and browse for the file from the Source file box as shown in the figure below al C Bootloader Property Value Destination Folder E Config OS E Main FPGA EC Safe FPGA eae rm 2 upaa connoee Figure 262 Then click download and check the progress from the Status box below NOTE In the component selection you can mark more than one check box and provide the related file to be downloaded The system will then execute the transfer of the all the elements one after the other and at the end you will need to cycle the power of the system Manage target also allows you to replace the default splash screen image shown by the devices during the power up phase Image for the splash screen must be provided in bitmap format saved in RGB 565 format NOTE Splash screen images must NOT be bigger than 500 KB and they must have a black background to ensure the best optical results 21 3 Update of the System Components via USB Flash Drive The upgradable components in a unit are listed in the chapter List of upgradable components For each component a specific file or set of files is provided Checksum file with an md5 extension is required to be present in the same location as the system file to be upgraded The system components files are available on demand please conta
60. Ifa Tag is selected as a condition then the scheduler will trigger only when the condition Tag value is 1 otherwise the scheduler will not trigger Enable The Enable check box allows you to enable or disable the schedule The scheduler will trigger when the enable check box is set If you want to disable the scheduler temporarily then uncheck the Enable check box 13 User Management and Passwords This chapter describes the user management system The main purpose is to restrict access to various objects and or operations by configuring user groups and their authorization level Users user groups and authorizations are the 3 entities defined for user management handling The basic entity is the user representing an individual that has the need to work with the system Each user must be a member of a group Users can be a member of just one group Each group will have different types of authorizations and permissions assigned to them Authorizations and permissions for the groups are divided in two basic categories Widget permissions hide read only full access Action permissions allowed or not allowed The proper combination of these groups and permissions will implement the required level of security options for the application Administrator Group sss Ail Permission HTTP Authorization FTP access Can Acknowledge Alarms es Can Acknowledge Alarms a g d User Group nMax Figure 185 13 1 Configuring Security Op
61. Logout Details eet 14 6 Viewing Audit Trails in Runtime The Audit Trail data cannot be displayed in Runtime They are only available in the exported data file 14 7 Exporting Audit Trail as CSV File You can convert the audit data to a csv file For a detailed description look at the explanation provided for the DumpArchive macro action 15 Configuring printouts in Designer A report printout is a collection of information to be printed when a specific event is triggered The Designer programming software provides a dedicated editor to configure reports their content the printer and when they have to be printed The report comes as a Special collection of pages with header footer and body including options for cover page When configuring reports Designer provides access to a dedicated gallery featuring only the widgets available for printouts When the programmed event is triggered the report printout is started and the entire printing activity is carried in the background with no significant influence on the general behavior of the interface in terms of reactivity and performance 15 1 Adding a report In the Project Workspace double click on Reports to open the Editor Then add the report by clicking the buttons There are two types of reports available Alarms report Graphics report The Alarms reports are used to configure the line by line printout of alarms printout is executed at the moment the alarm is tr
62. Macro actions attached to the widgets will be removed Only the Widgets will remain By selecting No the macro actions and the datalinks will remain attached to the widgets but may not function properly during runtime unless the tags associated with the Macros and datalinks are present or created in the new project NOTE The page import can be done between projects made in the same version of the software If the versions are different then a warning message will pop up to save the project in the new version then try again to import the page 4 6 The Designer Widget Gallery The Gallery is adjacent to the Property View panel and can be opened by clicking on the Widget Gallery tab as shown in the figure below Widget Gallery a x Basic Text Numeric Tabel 99999 7FFF Message Buttons Meters Switches Lights Media Advanced Icons Factory Automation Figure 28 Select the desired object from the Widget Gallery then drag and drop it on the page To change the appearance of the object select the desired property from the property pane and change the property settings All the HMI objects required to build an application are available in the Widget Gallery The Widget Gallery is accessible as a slide in pane from the right side of the workspace as explained in the previous chapter The gallery is divided into several categories each with collections of different types of objects Click on a category to displ
63. OHSO160MO719 Date 01 06 10 Download Board Parameters Figure 256 System Settings tool has two operating modes e User Mode e System Mode The difference between them is the number of available options User mode is the simple interface where generic users can get access to the basic settings of the HMI panel Calibrate Touch calibration of the touch screen interface Plugin List provides a list of the plug in modules installed and recognized by the system this option may not be supported by all platforms and all versions Network allows you to change the device IP address and other options of the network interface Time allows you to change the panel RTC options including time zone and DST Display settings screen saver and brightness adjustment BSP settings allows you to check the BSP Board Support Package version check the operating hours timers for both the unit and the backlight enable or disable the buzzer and enable or disable the use of the low battery front LED indicator System Mode is the interface of the System Settings tool with all the options In addition to the options available in User Mode you have the following important features Format Flash to format the internal panel flash disk All projects and the runtime will be erased returning the panel to a factory new condition Restore Factory Settings has two options are available the first Uninstall HMI removes the HMI runtime from the unit if
64. Pagel jmx Pagel jmx Pagel jmx Pagel jrmx Pagel rmx labelS text label4 text labelS text labelO text label text Label Label Ack Label Label Reset Ack Label Label Reset Ack Pagel jmx table tableCol Select Select Select Pagel jmx table tableCol Name Name Name Pagel jmx table tableCol State State State Figure 173 The strings are imported matching the widget ID and the page number of each widget To change the separator used in the exported file please have the regional settings of your work PC changed Upon importing the separator information is retrieved from the file if not found the default character is used Immediately after the Import the modified strings will be displayed in the text tab Once the user hits the button to Save the changes the changes are saved to the internal widgets Page Widgetid Project1 jpr _AlarmsMar Al Project jpr _AlarmsMagr Al Project1 jpr _AlarmsMagr Al TemplatePagel labell text TemplatePagel label text labell text label4 text Widgetid Projectljpr _AlarmsMoar Al Projectl jpr _AlarmsMagr Al Project _AlarmsMgr A TemplatePagel labell text TemplatePagel el2 text Pagel jmx Figure 174 The feature Import supports two formats Figure 175 e Comma Separated Values csv e Unicode Text txt Open File New folder No tems match your search Y
65. Recipe _ WriteCurentRecipe Set RecipeName Recipel 2 DownLoadCurRecipe RecipeSet curset UpLoadCurRecipe i Reset Recipe User Management Actions LogOut RlesetPassword RecipeSet AddUser Set the set index Delete ser z Edit Users Cancel Figure 154 9 7 Upload or Download Recipes During Runtime 9 7 1 Recipe Download Through Recipe Widget in Runtime Drag and drop the Recipe Widget as described in the Chapter Configuring Recipe Widget for Runtime Execution into the project to execute the Recipe transfer in Runtime Select the Recipe from the drop down box and select the Recipe set from the set dropdown list Then press the Download button to download the current selected Recipe set or press the Upload button to upload the current selected Recipe set 9 7 2 Recipe Download or Upload Through Recipe Transfer Macro in Runtime The Recipes can be Downloaded or Uploaded through the Recipe transfer macro At runtime execute the macro if the macro is programmed with a push button then press the button The Recipes data will then be transferred to the controller or uploaded from the controller depending on the action programmed The figure below shows a simple example of a project using Recipes at Runtime Testset0 Figure 155 9 7 3 Backup and Restore of Recipes Data The Recipe data stored in the HMI device can be exported for backup purposes and later restored Please refer to
66. Reset custom settings Reset all zones to default level Reset to Medium default Takes effect after you restart Internet Explorer Figure 59 4 11 4 Install Active X on Internet Explorer In Internet Explorer allow the installation of the ActiveX component when the question pops up in your browser ip Favorites S http 192 168 5 12 HMIClient AX htm J iti cF ih LL CAED Install This Add on for All Users on This Computer What s the Risk Information Bar Help wf Trusted sites Protected Mode Off Figure 60 In case you are using a Vista or Windows 7 operating system you need to click on Yes on User Account Control as shown in the following picture Program name Unknow Program Publisher Unknown File origin Download from the Internet Y Show details Figure 61 4 11 5 Uninstalling Active X To remove the ActiveX component from your system you must delete it from the computer By default the component is installed in the following folder C Program Files Festo HMIClientAX 4 11 6 ActiveX information The ActiveX is able to show projects at a maximum pixel resolution of 1200 x 800 5 Basic Programming Concepts in Designer The programming guidelines for Designer are based on a few basic concepts which are common in many parts of the system 5 1 Attach to In Designer the basic programming techniques are used to configure the properties of an object placed on a page Ob
67. Runtime ensures that modified Recipe values are retained throughout different project updates In other words a subsequent project update does not influence the Recipe data modified by the user on Runtime NOTE To reset the recipe data to the default values there is a dedicated action called Reset recipes see below in this chapter for further information The User can also select where the Recipe needs to be stored There are three options for this FLASH USB and SD Card The user can select any one You can configure Recipes by adding the required controller data items to a page from the Recipe Widget A Recipe can be associated with a particular page and is composed of all the Recipe data items on that page Recipe data items contain all the information associated with normal controller data items but rather than the data being read and written directly to the controller during the course of normal operation the data is instead read from and written to the panel memory that is reserved for the data item This chapter describes how to configure and use the Recipes in the Designer application 9 1 Recipe Configuration Editor In the Project View pane select Recipes and right click Then choose Insert Recipe if you want to create a new Recipe The newly added Recipe item will be added in the project workspace eae Scheduler x MultiLanquage ot pij Insert Recipe Export Recipe Import Recipe Figure 147 ae aa
68. Save License button e It verifies the activation key e lt creates a license file and stores it in the folder L CENSEFOLDER HM Licenses PANELID Once the activation is completed the enabled features or status of the activation keys will be displayed in the Feature status list box that can be seen on the right side of the Activation keys boxes NOTE After the activation is complete to enable license in the panel you must restart it 21 4 3 Import license If for some reasons it s not possible to have a working Internet connection on the PC running Designer Studio then you cannot use the previous two methods You must download the license from a PC with an Internet connection and then import the license using the Import License button License Manager Activate Your Product Now Step 1 Click here or goto https icense x formation com using a standard web browser Step 2 Type your activation key ex SBDIO FORLS HR675 5Bi57 and proceed Step 3 Type your hmi MAC ID in Host ID Value as Custom MAC ID Host ID value Custom 0030D801DE27 Step Click on Activate to generate the license file Step 5 Click on Download to save license file into PC Step 6 Click Import License to import license file Step 7 Click Activate Panel in manage target dialog to activate panel Figure 270 1 Go to https license x formation com using a standard web browser Type your activation key e g 5
69. Std04_onMouseRelease me var wet page getWidget rect1 var name wet objectName project object project It references the project Widget var group new Group project getGroup GroupName group var value group getCount Tag1 20 3 3 Global Functions print void print message It prints a message to the HMI Logger window Parameters message A string containing the message to display print Test message alert void alert message It displays a popup dialog with the given message The user must press the OK button in the dialog to continue with the execution of the script Parameters message A string containing the message to display NOTE The alert function is often used for debugging JavaScript routines alert Test message 20 4 Debugging of JavaScript You can enable or disable the debugging mode to find to solve the script errors or to inspect the properties and methods of elements To enable the debugging mode in the Advanced Properties Page set JavaScript Debug to True as shown in the below figure Properties apma K Naljes Precache Events Figure 254 Then in Runtime when the events are called the script debugger will show the debug information as shown in the figure below In the box Locals you can inspect all available variables and elements NOTE The JavaScript Debugger is disabled on MIPS based HMI Debug Search View rim fii th Loaded Scripts ly D JMob
70. T Require server verification https for all sites in this zone Figure 56 4 11 3 Security Setting for Trusted Site Zone Set your Internet Explorer Browser as seen in the following images Select a zone to view or change security settings Internet Localintranet Trustedsites Restricted sites Trusted sites This zone contains websites that you trust not to damage your computer or your files You have websites in this zone Security level for this zone Custom Custom settings To change the settings dick Custom level To use the recommended settings dick Default level C Enable Protected Mode requires restarting Internet Explorer Reset all zones to default level Select a zone to view or change security settings Internet Local intranet Trusted sites Restricted sites Trusted sites This zone contains websites that you trust not to damage your computer or your files You have websites in this zone Security level for this zone Custom Custom settings To change the settings dick Custom level To use the recommended settings dick Default level E Enable Protected Mode requires restarting Internet Explorer Figure 58 Security Settings Trusted Sites Zon B Disable Enable j Allow Scriptlets Disable Enable Prompt Automatic prompting for ActiveX controls Disable Enable Binary and script behaviors Administrator approved Disable Enable
71. The path of the folder where the usermgnt_user xml file is located must be specified in the Macro Properties If using a USB drive plugged into the USB port the path will be USBMemory followed by the specified folder in the memory or left empty for root folder NOTE The external drives plugged in the USB port of the panel must have format FAT or FAT32 NTFS format is not supported Action List A Y W ImmportUsers Figure 130 7 11 Media Actions The Media Actions macros have been created to interact with the Media Player widget at Runtime Media Actions PlayMedia stopMedia ReloadMedia Pause Media Macro Properties Page Actions LoadPage Figure 131 7 11 1 PlayMedia The PlayMedia macro allows you to start playing the videos when the Media Player widget is paused or stopped You have to specify the Media Player Widget in the macro properties 7 11 2 StopMedia The StopMedia macro allows you to stop the video running in the Media Player widget You have to specify the Media Player Widget in the macro properties 7 11 3 ReloadMedia The ReloadMedia macro allows you to stop the video running in the Media Player widget and play it from the beginning You have to specify the Media Player Widget in the macro properties 7 11 4 PauseMedia The PauseMedia macro allows you to pause the video running in the Media Player widget You have to specify the Media Player Widget in the macro properties 7 11
72. Timeout ms Modbus ID Max read block Preset function PLC Models Modicon modbus Generic modbus Figure 19 Designer supports multiple protocol configurations By repeating the steps previously outlined you can add up to four protocols in the protocol editor Note that while it is possible to run different Ethernet protocols over the same physical Ethernet port you cannot run different serial protocols over a single serial port Some serial protocols support access to multiple PLCs but this is an option that has to be configured within the protocol and still counts as one protocol The last column in the Protocol Editor is dedicated to Tag Dictionary This shows the tags that have been imported for a particular protocol NOTE The Alias works only for tags that are imported The tags which are manually added will not have the Alias prefix in the tag name 4 4 Adding Tags Designer uses Tag names to access all device data All fields and reference locations in the device need to be assigned a Tag name to be used in the HMI To assign Tags double click on the Tags icon in the Project View and the Tag Editor will be displayed as shown in the figure below ProjectView nx i EHE Projecti nn cee ie Projecti m Pages Poo i Ei 1 Fagel i S TE Scheduler a D MultiLanguage 7 aE Security es Usergroups A p Figure 20 To add a new Tag click on the icon and select the Address from the Communication
73. To use the SendKey macro you must define the keypad type as Macro in the Numeric Widget properties Action List A WY ok Cancel Figure 89 7 3 Page Actions The Page Actions macros are used for page navigation and to load specific pages Please note that the Page Actions are programmable ONLY in the released state The Page Actions macros are available for Alarms Schedulers and Mouse Release Events 7 3 1 LoadPage The LoadPage macro allows you to load the selected page of the project file when the macro is executed Figure 90 7 3 2 HomePage The HomePage macro allows you to specify the home page By default the home page is the first page of the project However you can change the home page in the project configuration properties To change the home page double click on the project name item in Project View Once in Properties choose the home page as shown in the figure below File Edit Run Format View Window Help Be NE A a i ER CA aL Langl a ProjectView AX 1 Projectl x v Properties l a Project F NariablesWgt b Fages _PageMgr hall 1 Pagel ee Config Leal Protocols oe Events Buffer od Scheduler E So MultiLanguag i Ai Securit Display Mode Landscape Figure 91 7 3 3 PreviousPage The PreviousPage macro allows you to navigate the HMI runtime to the previous page 7 3 4 NextPage The NextPage macro allows you to navigate the HMI runtime to the next page 7
74. UBI vesvisarvsesicnsdecrashincanivedeawues Se ciabenddeainabncesdeckinwwac da cacionscavianeias 92 Pe WGC AS siccssacemenaceincestacree danas bsatagae sharaieaieacticssta E 93 PAO SVCD ae orena aE E naan se acetate ae ae eee aware cone 94 Pap ROM GGL ONS a a a a 95 Poe RENE ATEN d en 95 Fa SCHOWECTE FONG neten EA 95 ZD SCHOURISAL NENG aeie TEE E e 95 PaA Orena toT Een sensei runenecsediesaieeseeonsetoateah aeons 96 Poa Pace Len eNd ariii E oR 96 he SO eA Se IO NEA a a a a ee 96 EEF PageDUraUoni rendens a a e a 97 O LOOMINE orrai E AE 97 72529 ZOOMO UU ENa a a E EE 97 7510 ZOOMRESECL TENdo E ANO eas 97 Faaa LE PaUSe ICING onn e A E E 97 DA RESUME TEMG eesin aa 98 7 5213 SMOW Tend CUSO ste3eiecasc aca acel aac bie a a eda eaea 98 751A SCIOWIMENGGUIS Of ieee a EEEE E EE TOE TTE 98 PO AACO e Oe enree A Se erie aes meen ec 99 FiO SCIOCUAMATATING wicsenscetueasteeeetatecsiac soho a a aA 100 TOD FACKAGMIM ousia E T Ta 100 03 RECA era E O TR 100 P EE ENT eee E NT E 100 Taf SNSIEMACUONS arrra T E A N cutee 101 Cel RO LAM an S 101 l2 COnTolUserl EDs A oie 101 Flo DUMDITENA osei i E 102 FLA Delete nNend oreson adn eaceiea eeeed eae ences 106 77 gt UTM EV EMU CII Ce ivecc si coes tucactsdashessberainessaceddssedieaus aceeaeearaensoacee 106 Zel IRESCIPIOLOERCOUNLE aiara i e E E 108 lald DeleteEvVeEntTACHV E icreo a E 108 hle SAlelVREMOVEMEC d oin a eee 108 7 8 Multi Language MultiLang ACtiOnS ssseesessseeeesssseess
75. WriteCurentR ecipe DumpEventArchive a Macro Properties DeleteEventArchive i SafidlyFlemaveMedka Recipe Actions User Management Actions LogQut Figure 116 7 9 4 DownloadCurRecipe The DownloadCurRecipe macro allows you to transfer the current set of Recipe data to the controller No parameter is required in the Macro Properties This will download the currently selected Recipe and Recipe set to the controller Action List A W W DownLoadCurRecip DumpEventArchive Macro Properties DeleteEventArchive i SafidlyFlemaveMedka Recipe Actions Figa aai Actions LogQut Figure 117 7 9 5 UploadCurRecipe The UploadCurRecipe macro allows you to transfer the set of controller data values to a Recipes set No parameter is required in the Macro Properties This will upload the currently selected Recipe from the controller Action List W W UpLoadCurRecipel Dump EventArchive Macro Properties DeleteEventArchive UpLoadCurRecipe User Management Actions LogQut a Figure 118 7 9 6 ResetRecipe The ResetRecipe macro allows you to restore the factory settings for the Recipe data The uploaded Recipes will be replaced with the original Recipe data In the macro property select the Recipe that you want to reset to factory settings Action List A Y W ResetRecipel Dump EventArchive a Macro Properties l Delete EventArchive User Management Actio
76. a device at 5 00 pm and turn the device off at 10 00 pm every day This can be done by dragging and dropping a predefined Scheduler widget from the Gallery and placing it on the page Once on the page you can set the properties of the individual GUI elements to create the desired interface to be presented to the end user 12 1 Configuring the Scheduler Engine The configuration of the Scheduler Engine is done using the Scheduler Editor The Scheduler Editor is accessible from the ProjectView pane as shown in the figure below ProjectView i x 1 Pagel protocols AY eee BID Name Type Schedule Events Buffer lt Scheduler x T E Projectl Schedule Daily Time 04 19 PM I Pages H i Schedule Recurring Daily Time 04 19 PM ohe E 1 Pagel im Contig oD Protocols Tags baie Alarms f Events Buffer mA Pa Scheduler ng Muil anguage Ta D mnde a Figure 176 a lI Click on the symbol to add a schedule item Schedule items can be of two different types as eea below and shown in the figure below Recurring Scheduler High Resolution Scheduler j l Pagel lt Scheduler x Daily ma 19 PM Daily Time 04 15 PM HighResolution Figure 177 Name Allows you to define the name of the Scheduler Type Allows you to select the type of Scheduler Schedule Allows you to select different Scheduler options which are described in chapters Recurrenc
77. access to a set of new options shown in the next figure Protocols Update Rate 1000 Time Out 5 Force Target IP Target IP 127 0 0 1 Time Settings Use Widget Defaults Local Time Global Time d Server Time Cancel Figure 54 The Time settings information is used by the client to adapt the widget timestamp information according to the desired behavior Widget Defaults Allows you to display the time information per each widget according to the widget settings provided at the time of programming in the Designer Local Time Translates all the timestamp information of the several widgets used in the project into the PC local time where the client is installed Global Time Provides all the timestamp information with reference to the UTC time Coordinated Universal Time Server Time Translates all the timestamp information of the widgets used in the project in order to show the time as it is at the panel side NOTE To be properly used this feature requires you to set the panel RCT with the correct zone and DST Daylight Savings Time options Using the Integrated FTP Server The HMI runtime system features an integrated FTP server that can be used to get access to the internal flash disk data NOTE Folders present on the Flash disk external to the runtime directory are not accessible via FTP external USB drive and SD Storage Card are not accessible via FTP You can use any standard FTP client program to connect to
78. ace the last installed instance with the new one or if you want to install another instance Figure 5 i i Setup has detected a prewious installation Would you like to REPLACE P current version with new one Yes It will replace current version No Tt will leave current version unchanged Figure 5 When the user tries to install a second instance of the same version of Designer Setup will detect it and will show a warning message that the same version is already available in the computer Setup will also provide the user with the reinstall option Figure 6 i The wersion you are going to install is already awailable in your system q a Would you like to reinstall it Figure 6 Each installation goes to a sub folder which has the version number as part of its name for instance C Program Files Festo Software Designer Studio 1 90 Each installed version provides its ID in the Control Panel Add remove program facility is provided in order to remove it individually from the computer Each installation identifies itself in the Start Menu with a program group name NOTE Multiple Studio installations provide a common workspace folder for all instances of the Designer that have been installed 1 3 2 Opening Project file created with older version of Studio When a Designer project file with jor extension is opened Designer checks for the match between the version ID stored in the jpr file and its version ID if the
79. actions The Yearly schedule allows you to execute a Set of actions once a year specifying the date and time in which the actions have to be executed To configure the Yearly Schedule select Yearly from the Type combo and select the date and time for the macro execution For example for daylight savings time to be set on a Specific date every year set the date and time of the starting date for the daylight savings and define the macros to set the new time 12 4 Configuring Location in Designer Studio In Designer Studio there is a unique scheduler feature based on sunrise and sunset Before you Start the sunrise or sunset scheduler you need to define the location Based on the UTC location the Designer system automatically calculates the sunrise and sunset time In the installation only a few locations are set by default If your location does not show up in the list you can add your location by entering the latitude longitude and UTC information in the Target_Location xml file located in the Designer Studio studio config folder For example the information for the city of Verona is shown below lt file aty Verona latitude 45 44 longitude 10 99 utc 1 gt After entering the location information the software displays the city name in the Location combo list and you can see the sunrise and sunset time on the dialog as in the figure below Schedulel Properties Type Custom Mode Sunset Offset 00 00 Location
80. adBlock failed ABEN reacdBlock failed SBEN reacdBlock failed ABEN readBlock failed ABEN reacdBlock failed ABEN reacdBlock failed ABEN readBlock failed ABEN reacdBlock failed ABEN reacdBlock failed BEN readBlock failed Error Timeout a Error Timeout Error Timeout Error Timeout Error Timeout Error Timeout Error Timeout Error Timeout Error Timeout Error Timeout Error Timeout ABEN readBlock failed Error Timeout r Log to File Figure 12 CProtocol updateT ans 3 Show log at boot Enables the logger at start up if the Log to file option has been enabled the files are saved in this case from the startup phase About Shows information about the runtime version 3 2 Built in SNTP Service The CPDX Panels Operating System features an integrated SNTP Simple Network Time Protocol that synchronizes the internal RTC panel whenever the predefined server is available The server addresses are hard coded and cannot be changed by the user The system searches for the following servers e time windows com e tock usno navy mil SNTP servers are checked at power up or once per week if the panel is not powered off 4 My First Designer Project This section describes the steps to create a simple Designer project 4 1 Creating a New Project 1 To create a new project click on the File gt New Project menu item Project Wizard FESTO Designer Studio Proje
81. age Tag Actions Data Transfer T Tog gle Bit Set Bit J Reset Bit Language Wiite Tag Set language StepTag fe ActivateGroup E SetLanguage Figure 113 7 9 Recipe Actions The Recipe Actions macros are used in programming the recipe management 7 9 1 DownloadRecipe The DownloadRecipe macro allows you to transfer a set of Recipe data to the controller In macro properties select the Recipe in the Recipe Name field and select the Recipe set you want to download To download the currently selected Recipe set select curSet in RecipeSet Action List A Y W DownLoadRecipel Dump EventArchive a Macro Properties l Delete EventArchive User Mana a Figure 114 7 9 2 UploadRecipe The UploadRecipe macro allows you to transfer the controller data to the Recipe set data In the macro properties select the Recipe in the Recipe Name and select the Recipe set that you want to upload To upload to the currently selected Recipe set select curSet in RecipeSet Action List A Y W UpLoadRecipel a Macro Properties UpLoadRecipe i SeidyFlemoveMerka Recipe Actions User Management Actions LogQut a Figure 115 7 9 3 WriteCurrentRecipeSet The WriteCurrentRecipeSet macro allows you to set the selected Recipe as current Recipe Set In Macro Properties select the Recipe and Recipe Set you want to set as the Current Recipe in runtime Action List A Y W
82. alue change In any case the samples are plotted with respect to the time The Trigger tag and source tag can be the same Number of Samples This represents the buffer size expressed in samples Storage Device This is an option to select where the trend buffer data file will be stored Here three options are provided Flash USBMemory and SD card For Storing in USBMemory or SD card the correct path must be specified in the field Path provided for this purpose NOTE Please make sure that the USB drive or SD card has been properly inserted in the HMI Panel before starting the Dump action NOTE An external USB pen drive is referenced by the operating system as USBMemory an SD card as Storage Card Buffer This is an option to select how the buffer sampling has to be executed and how the data files have to be created Two options are available Cyclic and Create a new file If Cyclic is selected then the trend data is organized in the form first in first out FIFO Once the buffer gets full the oldest values will be erased to create space for storing the new values If Create a new file is selected when the buffer gets full it stops storing the data and it will create a new file where the new trend buffer values will get stored The older values will not get erased The buffer values will be stored in different files Boundaries This specifies the boundaries When the triggering condition is the time a new sample is c
83. ansfer ToggleBit ST Figure 96 7 4 Tag Actions The Tag Actions macros are used to interact with the application Tags 7 4 1 DataTransfer DataTransfer macros allow you to exchange data between two controllers between registers within a controller or from system variables to controllers and vice versa SrcTag refers to the source Tag and DestTag refers to Destination Tag The various Tag types include a Controller Tag a System Tag a Recipe Tag and Widget Property Action List A W W DataTransfer Type Tag System Recipe Widget Tags Tagl Tag Tag3 Tag4 Alarm Motor MotorFront MotorBack Figure 97 7 4 2 ToggleBit Toggle Bit macros allow you to toggle meaning set or reset a bit of a tag The BitIndex allows you to select the bit to be inverted this requires a read modify write operation the read value is inverted and then written back to the controller tag Action List P A W Figure 98 7 4 3 SetBit The SetBit macro allows you to set the selected bit When the macro is executed the value of the selected bit is set to 1 The BitIndex property allows you to select the bit position inside the Tag Action List P A W we SetBit Project_ Tag Figure 99 7 4 4 ResetBit The ResetBit macro allows you to reset the selected bit When the macro is executed the value of the selected bit value is set to O The BitIndex pr
84. as follows false to hide and true to show widget Macro Properties ShowWidget SlideWidget Widget p J _ RefreshEvent Sh Select Widget Keyboard Actions Page Actions z LoadFage HomePage PrevPage Next Page LastVisitedPade Widget Show WidgetAction widgetname Figure 82 7 1 2 TriggerlPCamera The TriggerlPCamera macro allows you to start the image capture from an IP Camera Select the IP Camera Widget in the Macro Properties to trigger the capture from the IP Camera B TriggerlPCamera Macro Properties Slide Widget TriggerIPCamera Refresh Event E se Keyboard Actions a wgtName ipcameral SendKeyWidget MutiLang Actions Set Language Tag Actions Data Transfer wotName ToggleBit Set the Widget name Set Bit Figure 83 7 1 3 SlideWidget The SlideWidget macro allows you to show the sliding effect of a Widget or of a Widget group in HMI Runtime NOTE The widget or grouped widget can actually be outside of the page in the project and slide in and out of view Macro Script Widget Actions Macro Properties TriggerlPCamera ae ENET J Wiet RefreshEvent Direction Horizontal Keyboard Actions Speed fast Page Actions Y Distance 0 LoadPage Image Widget HomePage aaa epee es RaP Toggle Visibility true LastVisitedPage X Limit 0 H Show Dialog erate CloseDialog Y Limit o ShowMessage LaunchApplication Launch Browser Tag Actions
85. at Alarm If both bits are on the alarm is set to true When the Bitmask Alarm is selected you can specify one or more Bit positions inside the Tag When one of the Bits is set the alarm is triggered The Bit position must be given in decimal format if more Bits are specified each position must c6 Il be separated by a NOTE Bitmask is a position so it starts from zero 0 Deviation Alarm For the Deviation Alarm a predefined set point as well as a value for deviation will be given If the percentage of deviation of the Tag value from the set point exceeds this deviation then the trigger condition becomes true deviation Valu oe SetPoint gt 100 x SetPoint 8 2 Alarms State Machine The HMI system implements an alarm State Machine which is described by the following figure The graph includes states and transitions between them according to the selected options and desired behavior is Triggered j FALSE riggered j TRUE is Triggered FALSE is Triqgered FALSE TRUE requireACK TRUE a Hebpmoupae a S 7 E 5 T D Il enable an hi I alarm isTriggered FALSE amp amp 5g means put it reqReset FALSE ac in this state N isTriggered FALSE 2 al i sTriggered TRUE amp amp ie L requireACK FALSE E D multiTrigger TRUE amp amp S newTrigger a TRIGGERED isTriggered j
86. at design time NOTE In Windows XP operating systems for the proper operation of the Multi language editor in the Studio you will need to install the support for complex script and East Asian languages as shown in the figure below Regional and Language Options Regional Options Languages Advanced Test services and input languages To view or change the languages and methods you can use to enter test click Details Supplemental language support Most languages are installed by default To install additional languages select the appropriate check box below nstall files for complex script and right to left languages including Figure 166 Designer is actually supporting a restricted set of fonts for the Chinese languages For Simplified Chinese Designer supports the following fonts 1 Fangsong simfang ttf 2 Arial unicode MS ARIALUNI TTF 3 Kaiti simkai ttf 4 Microsoft Yahei msyh ttf 5 NSIlmsun simsun ttc 6 SimHei simhei ttf 7 Simsun simsun ttc For the Traditional Chinese language Designer supports the following fonts 1 DFKai SB kaiu ttf 2 Microsoft Sheng Hai msjh ttf 3 Arial unicode MS ARIALUNI TTF 4 MingLiU mingliu ttc 5 PMingLiU mingliu ttc 6 MingLiU_HKSCS mingliu ttc 11 1 Add a Language to Project To add a language to a project launch Multi language from the Project View pane Click the Add button to add the language then select the Writing system a
87. ate 2 State 2 Sonate eis Ctatea 2 State 3 State 3 List Display Figure 233 17 3 1 State States are added by selecting Add Remove List Items from the List Data option in the property pane Any value can be assigned to a State activating the State will result in a write operation to the Tag which has been linked to the Value property of the Control List Widget KeypadType NOF Figure 234 OES SER TS f HR IQA T w x Be Oe Brey H S ly 1 Pag wm P a x iy _ ist2 state _TagMgr 2 4 ANNANN State 0 State 1 State 2 State 3 Stal List Data Control ist Nata Figure 235 state 1 state 2 state 3 State 4 Figure 236 17 3 2 Selection Selection shows which status is currently selected and will appear as a highlight cursor moving up and down according to the use of the defined keys The Selection property can be attached as well to a Tag The small triangle on the left side of the list tells you what the current status is There are two write modes for the control list Write on Select and Write on Enter 17 3 3 Write on Select On Write on Select the value will automatically be written when one of the states is selected 17 3 4 Write on Enter On Write on Enter you need first to select the state and then press the enter key to write the status value to the Tag 17 3 5 Read Only The Read only property of the widget can be attached to a tag and will control whe
88. ates more memory space hence making it possible to download the current project By pressing Cancel the dialog will close and the download operation is aborted NOTE The automatic check for available space for project download is a feature available from Designer and runtime version 1 80 4 9 2 The Runtime Loader The explanations provided in the previous chapters are valid when using a panel with the runtime system already installed The HMI devices are delivered from the factory without the runtime When you power up the unit for the first time it starts with the Runtime Loader screen as shown below G System settings al Transfer from disk No HMI found Waiting for transfer Figure 50 NOTE The Runtime Loader is a feature dependent from the device Operating System and may not be available on all the units The description provided in this chapter assumes that you are using Designer V1 80 On MIPS based units the Runtime Loader is available from version V2 65 on ARM based units the Runtime Loader is supported from BSP version V1 52 When you click on System settings you can activate the System menu in User mode where you can set the IP address of the panel See the chapter for additional information on this tool Once the IP address is assigned and the panel is connected to a valid network the easiest way to install the runtime is to download a project from the Designer See the chapter for ad
89. aving the page Parameters me The object that triggers the event eventinfo It is reserved for future enhancements function Page1_onDeactivate me eventlinfo do something 20 2 3 System Events There are two types of system events one is related to the scheduler the other one related to the alarms Scheduler Event The event occurs when triggered by the proper action available in the scheduler system as shown in the figure below A Y pee e d pe o i Ro H Schedule 1 Recuning Daily Time 18 31 Action List Action List A W W JavaS cript S chedul MutiLang Actions Figure 251 Alarm Event The event occurs when triggered by a specific alarm condition and programmed in the proper action as shown in the figure below i me 7 Action List Action List A wY W JavaScriptedlarm1_ Figure 252 Once the system events are configured the custom code for them can be edited from the global JavaScript editor interface which is available from the Project view double click on the project name icon as shown in the figure below ProjectView i r i trendhistor 1 Pagel a function Alarm1_OnAction me eventinfo function Schedule 1_OnAction me eventinfo Li fj E 1 Pagel lila 2 Page ae Contig co j Oh on Protocols B Trends A Alarms if Events Buffer RE Scheduler Sa MultiLanguage id Pagel Figure 253 20 3 Language Re
90. ay its sub categories For each sub category the gallery offers the option of applying different styles to the objects within that category when possible The figure below shows the Widget style button for round gauges Widget Gallery Basic Buttons Meters Gauges Round rE re Figure 29 Clicking on the style button will display the available styles for the current object Select one of the available styles to apply it to the gallery objects This is done using the Page Toolbar shown in the figure below NOTE Style change may not be available for all widgets Widget Gallery a X att Meters Gauges Round X i mW Figure 30 Once on the page the object can still be subject to additional style changes This is done using the Page Toolbar shown in the figure below Depending on the object selected you can have options for the style frame fill color along with the font type and size and other standard object properties 4 7 Attach To and Dynamic Properties Designer allows for simple binding between Tags and Widget Properties Many different Widget Properties can be attached to a Tag which allows you to control the device and animate objects based on live data To attach a Tag to a property click on the property in Property view A 4 button will be displayed on the right side of the property Click on this button and select the item Attach To from the menu as shown in the figure bel
91. azardous operating and process status a stipulation can be made requiring the plant operator to acknowledge the Alarm The Alarms are configured in the alarm manager and thus are a component of all screens of a project More than one Alarm can be displayed simultaneously in the alarm widget depending on its configured size An Event can trigger the closing and reopening of the Alarm window Please note that in Designer working with Alarms is similar to working with Events In general there is no absolute need to have a pop up dialog when an Alarm is triggered Any background action from the list of available actions can be associated with this Event 8 1 Alarm Configuration Editor In the Project Workspace double click on Alarms to open the Editor Then add the Alarms by clicking the button ProjectView A xX as EEE ume sie 2 tere Bte dL oe fee do Lo Bfe ooo Tg __ Ac pe fg Projectl i Alanm1 Tag Namel bitMask Alara Ta Pages J 2 Alarm Tag Alam Buffert bitMaskAlanm 3 im Hy 1 Pagel H 4 Alarm Tag3 Alan Buffer limitAlarm 0 300 7 T E 2 Page eM Config Protocols he Tags AB Trend Figure 133 Name Specifies the name of the Alarm EnableA user can enable or disable the triggering of particular alarms Alarms can be enabled or disabled on Runtime as well for more information please see Chapter Enable Disable Alarms in Run time Acknowledgement For an alarm that needs to be acknowledged by th
92. before the change newValue The new value that is the value which will be updated to the widget attrName The attribute on which the event is generated index An integer attribute index if any default 0 mode W when user is writing to the widget R otherwise This event is triggered by the system before the value is passed to the Widget this means the code programmed here can modify or alter the value before it is actually passed to the Widget The code can terminate with a return true or return false After terminating the code with return false the control is returned to the calling Widget that may launch other actions After terminating the code with true the control is NOT returned to the Widget and this makes sure that no additional actions are executed following the calling event This method is always called the first time you enter a page function buttonStd1_onDataUpdate me eventinfo if eventInfo oldValue lt 0 do something return false i 20 2 2 Page Events 4 onActivate void onActivate me eventlnfo This event occurs each time the page is shown Parameters me The object that triggers the event eventinfo It is reserved for future enhancements This JavaScript will execute when the page is Active It means that when the page is loaded the script will execute function Page1_onActivate me eventinfo do something 5 onDeactivate void onDeactivate me eventInfo This occurs when le
93. ble at this time for reasons such as the value may have not been provided by the data source A device failure has been detected Timeout occurred before device responded Communications have failed There are no data found to provide upper or lower bound value trend interface specific flag No data have been collected i e archiving not active Trend interface specific flag There is no specific reason why the value is uncertain There is no specific reason why the value is uncertain The value has pegged at some lower limit There is no specific reason why the value is uncertain The value has pegged at some high limit There is no specific reason why the value is uncertain The value is a constant and cannot move The returned value is outside the limits defined for it Note that in this case the Limits field indicates which limit has been exceeded but the value can move farther out of this range The returned value is outside the limits defined for it Note that in this case the Limits field indicates which limit has been exceeded but the value can move farther out of this range The value has pegged at some lower limit The returned value is outside the limits defined for it Note that in this case the Limits field indicates which limit has been exceeded but the value can move farther out of this range The value has pegged at some high limit The returned value is
94. corded and included in the description In the Alarm description displayed by the Alarm widget the value may change because it is constantly updated but no additional values are recorded This feature is supported starting from version V1 80 9 Working with Recipes Recipes are a solution for organizing data storage in the HMI device and include services for exchanging data with connected controller devices This data can be written to the controller and conversely the data can be read from the controller and saved back on the HMI panel storage media This concept offers you a powerful way to extend the capabilities of the controller This is especially true for controllers that have a limited amount of memory The Recipe memory is the physical storage for the Recipes The Recipe Tag block basically identifies the current Recipe From the Recipe memory you select one Recipe data record or Recipe set and designate it current active Recipe Then you can transfer this recipe data to or from the controller Recipe tags can be displayed and edited ona page Currently the Recipe data is configured in the Designer workspace and the user can specify default values for each element of the data records On Runtime the data can be edited this new data is saved to a new and separate data file different from the original one containing the default values Any change to recipe data is stored on disk The use of a separate data file on
95. cript acts based on a Slider position which can be different for the different clients 20 2 Events You can add the JavaScript in the following events e Widget Events e Page Events e System Events Properties ah x Sd aH ag Button Value 0 Click Type momentary Label Fill Color E 120 120 120 Show Frame true Events OnMousePress Action OnMouseRelease Action OnDataUpdate Actio Acid Acton Add JavaScript OnMouseRelease Action Action for Mouse Release Event Figure 250 20 2 1 Widget Events 1 onMousePress void onMousePress me eventinfo This event is available only for buttons and it occurs when the button is pressed Parameters me The object that triggers the event eventinfo It is reserved for future enhancements function buttonStd1_onMousePress me eventlnfo do something 2 onMouseRelease void onMouseRelease me eventInfo This event is available only for buttons and it occurs when the button is released Parameters me The object that triggers the event eventinfo It is reserved for future enhancements function buttonStd1_onMouseRelease me eventinfo do something 3 onDataUpdate boolean onDataUpdate me eventinfo This occurs when the data attached to the Widget changes Parameters me The object that triggers the event eventinfo An object with these fields you can refer fields using dot notation oldValue The old value that is the widget value
96. ct Name Projecti Location C Program Files Festo Designer Studio workspace aa Saat E Figure 13 The Project Wizard dialog will appear asking for a project name and a path where the corresponding project folder will be stored Designer projects are stored in a folder that has the same name as the project This folder contains all the project files To move copy or backup a project you can simply move or copy the project folder and all its contents to the desired location NOTE DO NOT rename the Designer Project folders manually If you need to rename a project use the File gt Save Project As function Depending on the size of the project this could take some time Please wait until the newly named project opens and all pages are visible in the project tree before closing or taking any actions Click Next to go to the panel selection dialog Project Wizard Panels M cPpx x A 5 10 Panel size 300 X 600 E CPDX X A W 13 Panel type UN30_WCE6 ARMV41 E CPDX X A W 4 E CPDX X A W 7 Figure 14 The panel selection is shown in the figure above Here you can scroll through a list of available HMI models to select the model you are working with For each model two radio buttons are available to select the orientation landscape default or portrait In portrait mode the device is rotated 90 clockwise NOTE Portrait mode operation has some limitations All the System Settings dialogs do not support the por
97. ct technical support for any specific needs 21 3 1 Upgrade Steps Copy all the files you need to upgrade to a USB Memory and plug this into the USB port of the panel Start the System Settings tool with the special procedure for getting this in System Mode and then locate the desired item in the rotating menu Click directly on the item the blue button with white label and browse to locate the proper file stored on the pen drive USBMemory The figure below shows an example of the Main OS components Select File Di File info I a Seely Not available E configos_UNZ0HS El hid xafo1toa bin Figure 263 NOTE Select the Download command to transfer files to the panel Select the Upload command to get files from the panel Then follow the instructions on the screen to proceed with the update A progress bar on the screen will inform you about the status of the operation Please make sure to NOT turn off power to the panel while a system component is being upgraded Some of the components will require some time for the upgrade to complete NOTE Upgrade procedure may change depending on the hardware revision or operating system version from which you start please contact technical support offices for any detail about the exact sequence 21 3 2 Updating Panel Runtime This chapter assumes the panel is up and running with the runtime components installed Please see the chapter Transferring the Project to Target
98. dates UsBMemary Auto select best match Components that will be updated Project Files Font files System Files Figure 269 Press on Close at the end of the operation 21 4 License Activation of HMI Panel Software Modules Designer Studio provides the interface for activating software modules in the HMI Panel You can access the UI from Run gt Manage Target License The interface provides two operations Activate Panel and Save License which needs a working Internet connection or Import License which can be done offline 21 4 1 Activate Panel Activate panel operation is used to activate the license on its corresponding panel The panel must be connected to the network IMPORTANT You must install the Runtime in the HMI Panel to activate the licenses Manage Target Runtime License 1 License folder G WsersWUsername Documents workspace Panel Info 2 Activate Panel Select Panel 192 168 4 3 r 3 9 Save License Panel ID 0030D80210E7 Activation Keys OSC 3E 44445 473554 86B00C CODESYS B1C31 05E38 F 4966 9FA93 PDF VNC 4 Add Another key Import License 1 Select the location used to backup license files From this point on the path selected will be called LICENSEFOLDER in the document 2 Select the Activate Panel option using the radio button 3 Select Panel Press the Select IP button and it will show all of the panels connected to the network T
99. dget rect1 wet userValue Here can store custom data Every widget has some specific properties that you can access using dot notation For an up to date and detailed list of properties you can use the Qt Script Debugger inspecting the widget methods and properties 20 3 1 3 Methods getProperty object getProperty propertyName index Returns a property Parameters propertyName A string containing the name of property to get index The index of the element to get from the array Default is 0 Almost all properties that is shown in the Designer Property view can be retrieved from the getProperty method The index value is optional and only used for Widgets that Support arrays function buttonStd1_onMouseRelease me eventinfo var shape page getWidget rect2 var y_position shape getProperty y function buttonStd2_onMouseRelease me eventinfo var image page getWidget multistate1 var image3 image getProperty imageList 2 ie setProperty boolean setProperty propertyName value index Sets a property for the Widget Parameters propertyName A string containing the name of property to set value A string containing the value to set the property index The index of the element to set in the array Default is O Almost all properties that are shown in the Designer Property view can be set by this method The index value is optional and only used for Widgets that support arrays for example a
100. ditional information The normal download procedure in Studio is able to recognize the need for transferring the runtime and the process is automatically started As soon as the panel IP is selected from the list of available units in the network Studio will recognize the need for transferring the runtime providing the information as shown in the following figure Download to Target i Target device does not hawe Runtime Do you want to install Runtime Ready to download 192 168 7 0 Advanced Figure 51 Just click on the Install runtime button to proceed The process will automatically go through the required steps ending with the project download On an off the shelf unit the runtime can be installed also using an USB pen drive Prepare the Update Package according to the instructions provided in the chapter Transferring the Project to Target and make sure to mark all the check boxes for the HMI Runtime as shown in the following figure Update Package Project HMI Runtime Encryption is not support for updating runtime versions 1 60 and older Location Figure 52 Then plug the USB drive in the panel and click on the Transfer from disk button as below System settings Transfer from disk Figure 53 Then follow then the instructions on the screen NOTE The Runtime Loader on the panel does not support the automatic installation of the runtime with versions prior to 1
101. e Write Only TagIndex o Figure 80 No Of Remote Clients Alive Number of remote clients connected to the server This is a read only short 16 bit This Client Group Name Name of the group to which the current logged user belongs to This is a read only string This Client ID The variable is valid with reference to the Client scope Local and remote clients connected to the same server same runtime get a unique ID returned by this variable This is a read only short 16 bit This Client User Name Name of the user logged to the Client where the system variable is displayed This is a read only string 7 Working with Actions Actions are the function used to interact with the system they are normally executed when events are triggered When considering events generated by buttons pressed or released not all the actions are available for both states In case the selected action is not supported for the actual state the software will report a warning message as shown in the following figure This action is not allowed OnMousePress event please configure OnMlouseRelease event Figure 81 7 1 Widget Actions The following chapters will include the description of a set of actions dedicated to handling widget visibility and control 7 1 1 ShowWidget The ShowWidget macro allows you to show or hide the page widgets In the macro properties select the widget you want to show or hide then set the show properties
102. e Allows you to define the way the video in the playlist is played The available values are NoLoop LoopOne LoopAll and Random NoLoop allows you to play all the videos in the playlist then it stops LoopOne allows you to loop on the first video in the playlist LoopAll allows you to loop on the playlist following the list of videos Random allows you to play the videos in a random order NOTE The Media Player Widget works only with some HMI panels It doesn t work with the Simulator the Windows Client or ActiveX You can have only one Media Player widget in a page It supports videos encoded with the following codecs e DSP based video codecs o H264 using AVI MP4 container suggested o MPEG2 using AVI container o MPEG4 using AVI container e Software video codec o Microsoft MPEG4 v3 using an AVI container DSP Video Codecs The first three codecs use the processor DPS video hardware acceleration and you need a BSP 1 55 to play them These videos can have a maximum resolution of 720 576 pixels and a bit rate of 4200 kb s 720p and 1080p are not supported Audio is not supported Software Video Codec The videos encoded with Microsoft MPEG4 v3 are not using the hardware acceleration and have more limitations To prevent the videos from running jerky a maximum resolution of 640x512 pixels and a bit rate of 1300kb s are suggested In addition the size of the Media Player widget used on the page should have the same size as the v
103. e Conieura lom Edito essasi EE dace urease 141 9 2 Configuring Recipe Sets on the Page sccccssscccsssccesecccesscceeesees 143 2 Denne RECIDE Feld annen a N E NTE E eae 143 DA RECIPE Stal Seeria A RET 145 9 5 Configuring Recipe Widget for Runtime Execution sesssssesesseeseesee 145 9 6 Configure Recipe Transfer MacroOS cccccsssscccsssscccessscceessscceaeees 146 9 7 Upload or Download Recipes During Runtime cccceeseeceeeees 146 9 7 1 Recipe Download Through Recipe Widget in Runtime 006 146 9 7 2 Recipe Download or Upload Through Recipe Transfer Macro in Runtime 146 9 7 3 Backup and Restore of Recipes Data cccessccsssscceseeceesecceeeses 147 Workin WAT ROMS 2ssces cides tris TE E Ta 148 VOM GREAT IMC Menderen A 148 19 MAISON eM a acasesd cuss ssid AE 150 10 3 Configuring Trend Window for History Trends cccceesceeesceeeees 152 10 4 Trend Window Properties Advanced View cccessseeeeeeeeeeeees 154 10 5 Trend CUTS OF wncaercc ace tusensteenssientausacagen TaD 154 10 6 Exporting Trend Buffer Data to CSV file 00 0 eecccesseccceeeeeeeeeeeeees 156 Working with Multi Language cccsccssesccsscccssccenscccescceesceesceescceesceenss 157 IEI AdG aslanetaSe LO Proe sccrcsiecsncsecenstiesiocennsszenasieteasesemeeeetiesiacaeess 158 11 1 1 Language Display COMDO ccccssecccsssccesescccssccessccesescceescceeess 158 11 2 Multi Language WidGet
104. e Ge ahi 127 V1 Ved Read MEd daraanan a a 127 RILO PAUSE MEU a snien A 127 PAo BOWS eMedia EE E ET TER A nate 127 PAZ PUI PCO Sse5 is anassdiasteate E N N 128 fF AZ A Print GrapMiCRep OM ces iccsuctnesesiehonseseaiasserce sieussataesseesaeccecsiaioeee sours 128 fal ZPA oA Renn ea IO a e a TTS ae ee Se er Te 128 PAZ D gt EMPULV PHN QUCUC sessie e 128 7 ADZA PAUSePHMUMS ograni R ATAS 129 Z125 RESUIMEP HINES erener e E A 129 T ALAO ADOLPINTI ee a E E E E 129 10 11 12 WOrKne WINALL encina banana tbe teieritb ticles a 130 8 1 Alar CONMZUPAllON ECICON cccoxssivucasssiveceucadeaccuxsviavetvessedeuevewecenntens 130 82 Alarms State Ma CHING erou ARA 131 S DENNE EVEI S aonnannna a e 133 S L LOS EVENTS crisare E Gosmiatsuancnastcnt tenet 133 o NOUE E E E E EET 134 o n ACON aa a T N ENE NENN 135 8 4 Configure Alarms WIdGEet cccecccescccsecccescccescceesceeesceeescesceeass 136 8 5 Enable Disable Column Sorting eesseensseeesssesssesessssessssessseessseee 136 8 6 Configure Alarms History Widget ccccseccssssccesssccesscceesecceeesees 137 8 7 Managing Alarms at RUNTIME cccccccseccsescesccesccesceesceeceeesees 138 8 8 Enable Disable Alarms at Runtime cee cecceeccesceeccesccesceeceeecs 138 8 9 Live Data in Alarms WdE onesie e a ETN 139 8 10 Exporting Alarm Buffers as CSV file cessccccsssscccesescceeesceneeees 140 Workina WITS RECIDES saccra ana Aimee 141 OT Recip
105. e Scheduler and Type Action Allows you to define macros which have to be executed at the scheduled time Priority Allows you to set a priority level for the event This is used in case two distinct schedules occur at the same time The event with the higher priority will be executed before those of lower priority 12 2 HighResolution The HighResolution scheduler can be programmed to perform an action or sequence of actions repeatedly at a specific duration The High Resolution scheduler can be set in milliseconds To configure the HighResolution scheduler select HighResolution from the Type column and set the desired duration from the schedule column HMI Scheduler Mili Sec 100 r A Cancel Figure 178 NOTE The HighResolution scheduler cannot be changed during Runtime If the user needs to change the schedule Runtime then the Recurrence scheduler should be used by selecting Every which is described in the following chapters The minimum time resolution when using a Recurrence scheduler in Every mode is one second 12 3 Recurrence Scheduler The Recurrence Schedulers can be programmed to perform an action or Sequence of actions and the schedule can be modified during Runtime Schedulel Properties Type Daily Mode Time Condition F On startup Enable schedule Figure 179 By default when a schedule is added the Enable schedule checkbox is marked You have the option to keep a
106. e Target devices in order to save Space in the flash memory NOTE This ActiveX requires Microsoft Visual C 2008 Redistributable Package x86 installed on your system You may need to download the Download Microsoft Visual C 2008 Redistributable Package x86 from the Microsoft web site 4 11 1 Copy ActiveX into the Target Device The ActiveX component is distributed with the Designer Studio installation package The related files are located in the Runtime folder of the Designer Studio installation directory The files HMIAX cab and HMIClientAX html should be copied into the workspace folder of the Target device where the Runtime is installed The file copy can be done using the panel FTP server as described in the dedicated chapter 4 11 2 Internet Explorer Settings Internet Explorer settings must be changed adding the panel s IP to the list of the trusted sites In Tools Internet Option Security tab choose Trusted sites Then click on the Sites button Type in the IP address of the Target device the location where the ActiveX component has been installed and it will be loaded to the browser Internet Options Y 28 Jj sa Trusted sites This zone contains websites that you trust not to damage your computer or You can add and remove websites from this zone All websites in this zone will use the zone s security settings Add this website to the zone http 192 168 5 12 Remove
107. e operator when the alarm is triggered select the check box to enable the Acknowledgment If checked an operator is required to acknowledge this alarm any time it is triggered before it will be cleared from the Active alarm widget Reset This check box specific to each alarm works in conjunction with the acknowledge check box After an alarm requiring acknowledgment has been acknowledged it will be cleared from the alarm list If the Reset check box is checked the alarm will continue to be listed in the alarm list as Not Triggered Acked until the Reset button present in the alarm widget is pressed Tag Attach the Tag for which the Alarm shall periodically check the Tag value so that the respective alarm s is triggered when this deviates from its limits The Alarm function will refer to the value of this Tag or to the state of a Bit in the case of Bitmask to determine when to trigger the Alarm Buffer Specifies the Buffer file to which the Alarm history will be saved Trigger This selection determines the triggering condition for an alarm Three Alarm types are available Limit Alarm A Limit Alarm is triggered when the monitored Tag value goes OUTSIDE of its given boundaries low limit and high limit NOTE When the Tag value is equal to its low or high limit the alarm is not triggered Bitmask Alarm To get a valid trigger the bitwise AND operator compares each bit of the bitmask with the Tag value corresponding to th
108. e saved in the project folder together will all other project files Figure 225 Once the custom keypad has been created it may be used for any specific field where the Keyboard Type property has been properly set by selecting the corresponding keypad from the property Keypad Type in the property pane as shown below es al Properties 1x Figure 226 The Up Down keypad is mainly used for moving cursors in Widgets that are requiring this function An example is the Control List as shown in the following picture State 1 State 2 state 3 state 4 state 5 state 6 2 Figure 227 16 2 Deleting or Renaming Custom Keypads In the Project View pane right click on the keypad you need to delete or rename A context menu will be displayed as shown in the figure below Remove KeyPad Page Rename KeyPad Page Figure 228 The user can choose the options e Remove KeyPad Page to remove the keypad page from the project e Rename Keypad Page to rename the keypad NOTE By default any numeric widget read write numeric field will be assigned the numeric keypad If you decide to modify the default numeric keypad that will be used throughout the project the following procedure is recommended so you won t need to assign that new keypad to all numeric entry widgets First create a new keypad using the numeric keypad as the keypad type and Save it with a different name This will be a backup
109. earndcsedsGaus seanoseosbevoasaesarsdeisedacaes sesessme sveuaauovea niet 76 Fa led SMO W VIG E aan stars ansacuc cos ucmtencssiasuatiosbataeneuaces S 76 fole TMS SSUPCAMel dea e iS 77 Filed WO WIGS OL aeann anit sedansashsd acauseeeaaesssa tae aaiaeseca nse 77 Plt REMESMEVENI orrae na E E E TAE EE ETN 79 h2 Keypoard Maro ACTIONS asserere NT AO aakiens 79 AE A EE 2 8 oN A E SEE E E A ESIE A EE E T SIEA EEN 79 F22 SONGKCY WIGSOL esiin A E T O OE 80 7 3 Pao eA ON a i E E E ese 82 Poel LOJdPAC Cinu a eE A 82 FD HOMO AOC opara AA AAR 83 Feo PREVIOUSP a Se ain a E A dsweeaeiads 84 TDi INCU AS Cvsarecciiesnawesedsaccnesdaeiwiveatacuresdaduaveasaedensdetwiveataeunesdualuaveouaees 84 Fido WAStVISILECiP a Se rrenen pS ccatenseesad ounces T O saskeonevenoessaeeees 84 TiS SOW AOS rates veteran ion esy ie oan anes eae aaa oe as eS 84 Laosk OSC IAO S rarai sisi ca stew siabaasd satan tauacausstdevrasoenseaeasedeouts 85 P30 SNOW MESS AS Eessen an ctitahns cece a cts ataien cuca antes 85 F239 WAUNCMAPDINCATION seievzcostenessasctact TEE NE 86 LALO AUC BROWS EN arr aan a re T N Rare we easy nk 88 FB Tae AGUOMS eren cas iecceaw tate recat os caeastinsduasasincsceusnetvacebascaeaeuaeseece erases 89 7 gees Va Bre We A EAE ee ere eee ated eed TE eee net aed CR eter 89 TAD NOS SCI Cas scscvasaaniansaaeeden sieautonaceisenwssen oi avsta aise aioe ubaneee ues tas ieee 90 FD SOUD IW Siew cocedeceniayin E igs auescuseadestaee ete sateaes 91 FULD RESC
110. eduled action You can include tags in the e mail body upon executing the action the tags value will be read by the system and included in the message body 19 1 SendMail Script SendMail action is available under the script tab of the Action List for alarms and scheduler actions Action List Action List A W W SendMaill Macro Properties SendMail EmailConfig l r A s Emailinfo Email config EmailConfig eMail Info Figure 246 19 2 Configure E mail Server To configure the e mail server you need to provide the following information SMTP Server Address SMTP Server Name optional it can be used for information purposes Server Port and if authentication is required UserName and Password EmailConfig Serverld ot h Wy A emailServero setings SMTP server Name server Port 25 E RequireAuth UserName Fassword Figure 247 NOTE You can add more E mail servers by clicking the button on the left hand side When you are writing the system does not yet support any security login mechanism such as SSL 19 3 Configure E mail Accounts In the e mail info set recipient e mail addresses If you want to send the email to more than one recipient separate the e mail addresses with a semi colon Email info email Info e A W Email nfo eMail1 Name Description From To Subject Tag 1 Tag 2 Tag 3 Message Fig
111. ee chapter Attach To for a complete explanation For each screen the system is able to identify which tags are used in the specific page and identifies them as part of the page group This allows easy handling at run time of the requests made by the communication protocol to the connected controller s only the tags included in the displayed page are queued for polling from the controller memory This mechanism is fully automatic and there is no intervention required by the user The tag editor allows you to define groups of tags not belonging to a specific page but for instance grouped according to their logical meaning We can call these groups Users groups Users groups have no meaning for the local visualization but they are very useful when external software communicates with the local Designer runtime requesting sets of data that must be independent from the currently displayed screen The Designer web server publishes a set of communication interfaces that can be used from a 3 party application to interface with the local tag database and read the tags according to their grouping The group column allows you to define the users groups and assign tags to them Driver Specifies the communication protocol for which the tag is defined Address This shows the PLC controller memory address To edit it click on the right side of the column to get the dialog box where you can enter the address information Comment Allows yo
112. efore Compatibility between newer versions of Runtime and those projects created and deployed with older versions of Studio is not ensured
113. em files and by the application project The server operating mode is independent of the client side operating mode you may have a visualization running but server activity stopped 3 Basic Unit Settings The device basic settings are available from the Show System Settings Menu which is accessible through the runtime s Context Menu if the panel has the runtime already installed or by using the dedicated button on the unit when in loader mode see for this the chapter The Runtime Loader below in this document Press and hold your finger on an empty area of the screen for few seconds until the context menu appears as shown in the figure below zoom In zoom Out foom 100 Pan mode Settings Project Manager Update Logging Show Log at Boot Show system settings About Figure 8 Touch on Show system settings to access the system settings tools The System settings tool is a rotating menu through which you can scroll using the Next and Back buttons It includes the following entries Calibrate Touch To calibrate the touch screen if needed Display settings Backlight and Brightness control Time Internal RTC settings BSP Settings Operating system version Unit operating timers power up and activated backlight timers Buzzer control Battery LED control Network IP address settings Plugin List Provides a list of the plug in modules installed and recognized by the system this option may not
114. equired to convert it to a CSV format These two files are both required by the utility to operate the conversion DateTimePrefixFileName When this Option is enabled the dumped File will have the Date and Time as Prefix to the name of the File For example if we are making a Dump at 10 10AM on 1 1 2012 then the file name will look like D2012_01_01_T10_10_Trend1 csv DYear_Month_day_THour_Minute_Filename This helps to know the Time at which the Dump was executed and also to identify which one is the latest timeSpec This option defines the time format used when dumping the trend to file e Local the time values exported are the time of the HMI device e Global the time values exported are in the Coordinated Universal Time UTC format Example Local 2012 10 111T05 13 43 724 07 00 Global 2012 10 117T12 13 43 724Z NOTE The software tool required to convert the dump files to CSV are available in the Designer folder called Utils under the directory where the software is installed The tool needed to convert trend buffers is called TrendBufferReader exe The TrendBufferReader exe tool can be invoked using a batch file with the following syntax TrendBufferReader r Trend1 Trend1 csv 1 where Trend1 is the name of the trend buffer without extension resulting from the dump original file name is trend1 dat and Trend1 csv is the name desired for the output file The resulting CSV file has 5 columns with the following meanin
115. er is specified within the project the system will provide automatic login of that user without prompting for a user login If no default user is configured the system will ask for a User name and Password and based on the user the Runtime will allow only the configured permissions for that logged user Please note that there are specific actions for user logout edit user add user remove user and switch user In particular please note that users can be edited added or removed on Runtime using the specifications provided in the Action List as shown in the figure below and explained in the chapter User Management Actions All the users information modified at Runtime is stored in a separate file thereby preventing loss of the users configurations in case of a new project download The proper action DeleteUMDynamicFile must be used if the modified user settings have to be deleted and you want to revert back to the initial settings User name Password Figure 198 Action List eP A wW ry Figure 199 14 Audit Trails Designer supports Audit Trail functionality which provides basic process tracking and user identification linked to events with a time and date stamp The logged users and events allow for a review and or report of your production processes The Audit Trail function provides flexible tailor made and easy to review event logs The Audit Trail or audit log is a chronological sequence of audit
116. et can be either the recipe set name or O based set index project uploadRecipe recipeName Set 20 3 1 12 State Class for holding state of a variable acquired from the controlled environment Beside value itself it contains the timestamp indicating when the value is collected together with flags marking quality of the value 20 3 1 13 Methods getQualityBits number getQualityBits Returns an integer a combination of bits indicating tag value quality Return value A number containing the quality bits var state new State var value project getTag Tag1 state 0 var qbits state getQualityBits getTimestamp number getTimestamp Returns time the value was sampled Return value A number containing the timestamp for example 1315570524492 Remarks Date is a native JavaScript data type var state new State var value project getTag Tag1 state 0 var ts state getTimestamp isQualityGood boolean isQualityGood It returns whether value contained within this State object is reliable Return value A Boolean true if quality is good false otherwise var state new State var value project getTag Tag1 state 0 if state isQualityGood do something 20 3 2 Keywords Global objects are predefined and always available objects that can be referenced by the names listed below page object page It references the page object for the current page function btn
117. etc In the Curve x category there is one property called Request Samples as shown in the figure below Curve 1 Curve 1 Value DataLink Trend1 Pan Visible true Min Max Color StrokeWidth 2 ry IPS Se 4 ral om Figure 162 This property represents the maximum numbers of samples read by the widget at one time from the buffer data file this block size can be adjusted to fine tune performances in trend viewer refresh especially when working with remote clients The default value is normally a good compromise for most cases 10 5 Trend Cursor The Trend Cursor allows you to see the trend value at a point Use Show Trend Cursor macro and Scroll Trend Cursor macro to enable the Trend cursor and move it to the required point to get the value of the Curve at particular instant in time m Trend Title a0 60 40 20 E gt 11 35 03 36 43 11 38 23 11 40 03 Cursor Figure 163 To display the value of the Trend Cursor on the page define a numeric field and attach the Cursor Value Widget Tag as shown in the figure below This is the Y axis Value of the Cursor System Widget Recipe TrendCurveWotL cursor value Y Labels Title Grid Cursor X Scale Y Scale 4 Curvel Curve 1 Value Visible Mini Max Cursor Value Draw Type Curve 2 a ene Read Only Read Write Write Only TagIndex O Figure 164 To get the Time at the Particular Point where the Cursor is placed
118. ew users at runtime or you can upload new value in the recipes If the option to delete the files is selected the edited configuration of the recipes or users or the schedulers will be deleted and overwritten by the project configuration IMPORTANT Please make sure to check carefully before selecting this option as some data can be lost When transferring a project the Studio uses a combination of HTTP and FTP connection The HTTP connection is used to issue commands to the target device like switch to transfer mode or unload running project the FTP session is instead used to transfer the files to the panel flash memory The Default port for HTTP connections on the Target is set to 80 However the user can change the port number to a different value To set the port number from Designer click on the Run gt Manage Target then click on Target Setup on the dialog The HTTP FTP port or HTTPS FTPS port can be set for the target The Host Name can be defined by the user in the appropriate box in the Target Port pop up This will allow each panel to be easily identified on a network with multiple panels The drop down box will no longer show HMI 10 2 0 6 but will show for example Machine1 10 2 0 6 After renaming the host it is necessary to download the system files to the target Retrieve Projects Load Project Unload Project a Upload Project De
119. ference The following sections describe the JavaScript functions and properties that are unique to the Designer environment 20 3 1 Objects Designer uses JavaScript objects to access the elements of the page Each object is composed of properties and methods that are used to define the operation and appearance of the page element The following objects are used to interact with elements of the HMI page 20 3 1 1 Widget The Widget class is the base class for all elements on the page including the page element Note that Widget is not a specific element but a JavaScript class 20 3 1 2 Properties The following properties are common among all widgets IMPORTANT When you change the properties of widgets with JavaScript you have to set set the widget Static Optimization to Dynamic otherwise changes to properties will be ignored You can find the option Static Optimization in the Advance Properties objectName string objectName It gets the name of the Widget The name is a unique id for the Widget function btnStd04_onMouseRelease me var wet page getWidget rect1 var name wet objectName X number x It gets or sets the Widget x position in pixels function btnStd1_onMouseRelease me var wet page getWidget rect1 wet x 10 y number y It gets or sets the Widget y position in pixels function btnStd1_onMouseRelease me var wet page getWidget rect1 wet y 10 width number w
120. file name configos_UN20HS0160C0237 bin 21 2 Update of System Components from Designer Studio Designer Studio provides a tool to update system components by downloading them to the target device using the Ethernet communication interface The tool is called Manage Target and it is available from the Run menu Manage Target Info Device Name Property E Main OS Source File Date a Destination Folder eal ain rr E Safe FPGA il om Bootloader System firmware that handles device boot up Target 192 168 8 24 Figure 259 The Manage Target dialog has two tabs The first step is to use the Target discovery function to locate the panel IP from the local network Click on the little arrow symbol and identify the HMI panel from the list of units recognized in the network In case the panel is not listed you can try a second time or type the IP directly in the box Then click out of the box to accept the inserted IP See the figure below Target status 192 168 8 24 HMI 192 168 5 134 HMI 192 168 2 33 HMI 192 168 5 253 HMI 192 168 5 233 HMI 192 168 5 211 HMI 192 168 2 188 E e Taen i eei E th i e Figure 260 When the device is recognized the Info box shows the target details as shown as an example in the figure below Info Device Name UN2O Serial Oxffff03 Date 231 121 332 HW 01 01 0 Panel Unknown Bootloader Type Redboot Date 19 01 11 Version UN2ZO0
121. g DataType Value Timestamp UTC SamplingTime ms Quality Where DataType code that gives information about the data type of the sampled Tag according to the following codes m 3 O rt lt Boolean Byte Short Int Unsigned Byte Unsigned Short Unsigned Int Float Double OC ONDWMRBWNHE Value value of the sample Timestamp UTC timestamp in UTC format SamplingTime ms sampling interval time in milliseconds Quality gives information on the tag value quality The information is coded according the OPC DA standard the information is stored in a byte data 8 bits currently defined in the form of three bit fields Quality Substatus and Limit status The 8 Quality bits are arranged as follows QQSSSSLL For a complete and detailed description of all the single fields please refer to the OPC DA official documentation Shown below are the most commonly used quality values returned by the HMI acquisition engine Quality Code BAD The value is bad but no specific reason is known WW NO NO m me CO A ON N ON OO OO OO 4 ON 5 ON 192 BAD BAD BAD BAD BAD BAD BAD UNCERTAIN UNCERTAIN UNCERTAIN UNCERTAIN UNCERTAIN UNCERTAIN UNCERTAIN UNCERTAIN GOOD There is some server specific problem with the configuration For example the tag in question has been deleted from the configuration file tags xml This quality may reflect that no value is availa
122. g Manage Target prior to downloading the project Figure 265 21 3 4 Updating Runtime from USB Drive From the Run menu select Update package to start the update package creation process 2 Update Package Project T HMI Runtime Encrypted Location F Update UpdatePackage Figure 266 21 3 4 1 Package Creation Select the Target from the Target drop down list Select the components you need to update and specify the output directory Then click on Create Update Package a a PAI Project E HMI Runtime 2 Encrypted Location 3 F WWodate UpdatePackage Figure 267 21 3 4 2 Encrypted Package The Package can be encrypted If the check is enabled then a hard coded password is used to encrypt the package 21 3 4 3 Transferring the Update Package on the Target Device Copy the package created to a USB drive or create the package directly on the USB drive then plug the USB drive into the HMI Press and hold your finger on the screen for few seconds until the context menu is shown Click on Update to activate the procedure zoom In zoom Out zoom LOO Pan mode Settings Project Manager Update Backup Restore Logging Show Log at Boot Show system settings About Figure 268 The wizard utility will start Check Auto select best match and then click Next HMI Update Wizard 1 2 OK Please wait examining system 4vailable up
123. g with the previously logged in user until the next user logs in This means after executing the SwitchUser macro runtime will display the User Login template Internally however the server runs with the previously logged in user This action is useful for ensuring that there is always one user logged onto the system Action List A Y W Switch serf a tae Figure 123 Click on the Back button to go back to the previously logged in user Username Password Figure 124 7 10 3 ResetPassword The ResetPassword macro allows the current user to restore his or her original password this macro will restore settings specified in the project file for the current user password No parameter is required to set this macro Action List Action List e A W W ResetPassword Macro Properties Restore Recipe Data User Management Actions Figure 125 7 10 4 AddUser The AddUser macro is used to add users at runtime When this macro is executed a template page pops up where parameters for the user can be set These parameters include Username Password Group Comments flags like password must contain numbers password must contain special character user must change his initial password enable logoff time and Inactivity Logoff Time The User Log is shown in the figure below User name user Password useri Group Comments Password must co
124. geLeftTrend The PageLeftTrend macro allows you to scroll the Trend window by one page duration For example if the page duration is 10 minutes then with the PageLeftTrend macro you can scroll the trend left for 10 minutes 7 5 6 PageRightTrend The PageRightTrend allows you to scroll the Trend window by one page duration For example if the page duration is 10 minutes then with the PageRightTrend macro you can scroll the trend right for 10 minutes 7 5 7 PageDurationTrend The PageDuration macro is used to set the page duration of the Trend window In Macro Properties you must define the Trend Name and Page Duration Action List F Action List A W a PageD uration rend Macro z ScrallLeft Trend a Macro Properties seroll Right Trend PageDurationTrend PageLeftTrend ie FT EE AEA ENA ce Se AA RAT Page Right Trend Trend Name TrendWindow2 PageDuration Trend Page Duration Zoomin Trend B None n ZoomOut Trend E 1 min ZoomResetTrend L Pause Trend 10 min Resume Trend Page Duration 30 min Alam Actions Page Duration sho 1 Ca 2 hours SelectlAlarms ou hea AckAlam z 8 hours 12 hours 1 day 2 days 5 days bes 1s week Tj rarm alee Figure 104 NOTE You can also use a combo box Widget to select the page duration at Runtime 7 5 8 ZoominTrend ZoomInTrend macro allows you to reduce the page duration 7 5 9 ZoomOutTrend ZoomOutTrend
125. gered Not Acked 25 01 2011 16 59 31 El Alarm5 23 Not Triggered Not Acked 25 01 2011 16 59 31 E Alarm6 23 Not Triggered Not Acked 25 01 2011 16 59 31 El Alarm 23 Not Triggered Not Acked 25 01 2011 16 59 32 El Alarms 23 Not Triggered Not Acked 25 01 2011 16 59 32 El Aarma 23 Not Triggered Not Acked 25 01 2011 16 59 32 Check Uncheck All Filter Show All Ack Reset Save Figure 144 Later if you want to enable again the Alarm select the Alarm and check the Enable check box Then execute the Save command The Alarm will now be subscribed and subject to being triggered 8 9 Live Data in Alarms Widget This feature is used to view the live Tag data value inside the alarm description It is applicable for both Active Alarms and History Alarms widget To configure the live data visualization in the Alarm Widget follow a simple syntax rule The Tags to be included must be specified in the alarm description string including the Tag names in square brackets Tag name An example is shown below id Enable Ack Reset Tag Buffer Trigger_ Action Description 1 Alarm Tag Alarm Buffer btMask am Show Dialog Alam 1 Tag Value is Tag1 2 Alarm Tagi AlarmBuffert bitMask Alan 1 Show Dialog Alam 2 Tag Value is Tag2 Aam3 Tag1 AanmButfert bitMaskAlanm 1 Show Dialog Alarm 3 Tag Value is Tag3 Figure 145 During Runtime in the Alarm Widget the markers and Tag name will be replaced in the description
126. h Resolution scheduler with the ability to change it in Runtime The Every Scheduler allows you to execute macros witha specific time interval The time interval can be set from 1 sec to 1 day For example data transfer from one protocol to another with an interval of every 5 minutes The Hourly Schedules allow you to execute a set of actions on an Hourly basis by specifying the minute in which the actions have to be executed To configure the Hour schedule select hourly from the Type combo and set the time of the macro execution For example values to be written to the controller on the 5 Minute of every hour The Monthly Schedules allow you to execute a set of actions ona Monthly basis by specifying the day in which the actions have to be executed To configure the Month schedule select Monthly from the Type combo and set the day and time of the macro execution For example for values to be written to the controller at 4 35 on 5 of every month a monthly scheduler can be programmed to perform the actions Weekly schedules allow you to execute a set of actions ona Weekly basis by specifying the time and day s in which the actions have to be executed To configure the Week s schedule select Weekly from the Type combo and select the days of the week and the time for the macro execution For example for an Alarm to be triggered at 6 00 AM on weekdays Monday to Friday the Weekly scheduler can be programmed to perform the same
127. hat is part of the Scheduler object A Dialog page will open as shown in the figure below where you can add the schedule from the list at Runtime D iPagei x scheduler Properti NE 10 x w e e H a e 3 EER oa Tl e e Scheduler z fa lt ial lio ea ee oe lil Name Schedule1 Schedulaa Columns 4 4 Show Header true Text Display Time Name Type Mode Occurence Condition Enable Schedule Daily Time 04 19 PM None M fi Schedule List Name Select schedule name Figure 183 In the Properties pane you can customize the scheduler Widget to adjust row colors column width and show or hide column etc 12 6 Schedule the Events During Runtime If you defined the scheduler GUI on a page as described in the chapter Configuring the Schedule Interface for Run time Interaction then you can schedule the event and modify this schedule during Runtime on the server In Runtime the user has the flexibility to change all possible types and change the possibility to modes as described in the dedicated chapter Name Type Mode Occurence Condition Enable w sem ue ime oot oori foe w tn Days Of The Week Figure 184 Occurrence The Occurrence column specifies the date selected by the type of column as shown in the figure Condition The Condition column lists the available Boolean Tags from the project
128. he ResumePrinting macro allows you to start the queue if previously it was put on hold 7 12 6 AbortPrinting The AbortPrinting macro allows you stop the execution of the current job and remove it from the queue If the queue has another job then after aborting the next one starts immediately 8 Working with Alarms The Alarm handling has been designed to provide alerts through pop up messages typically to issue warnings to indicate any abnormal conditions or any malfunctions in the system under control Whenever a Bit goes high or the value of a Tag crosses the limit of deviation defined in the Alarm configuration the respective Alarm message s will be displayed in a special dialog Or alternatively you can program certain macro actions to be executed when the Alarm is triggered Please note that in Designer there is no default action associated with a triggered Alarm The visualization of a specific page containing the Alarm Widget is optional and the specific action executed when the trigger condition is verified can be any one of the actions found on the Action list The configuration of an Alarm determines whether or not the alarm requires user acknowledgement It can also be used to determine how the Alarm appears when displayed on the HMI device like background and foreground color Alarm Configuration also determines whether and when the corresponding alarm is logged to the Event list For Alarms displaying critical or h
129. he widget gallery accessible from the right side sliding tab is contextual and includes only the widgets available for the area under editing 15 2 The contextual Widget Gallery The widget gallery which can be normally recalled from the right side sliding pane is always adapting itself to the context File Edit Run Format View Window Help pa te Hij langi ProjectView report Graphics 1 x LOR Report Graphics 1 Header Footer Widget Gallen S i a A A g Zoom To Fit X Fpi at t ae ig deTest019_Printe l G st Font Agency FE E Pe Pages Page 1 of Page n My 1 Pagel j i 7 ae Contig Q Protocals E Trends b Reports fe Report Gr ei Report 2 2 Alarms Screenshot Ewents Buffer PE Scheduler a S MultiLanguac a i Security A UserGroups ey i AuditTrail E AuditTrail a id Report Graphics 1 Header F Type ReportTemplateFa at Figure 212 The available widgets are Page Number Widget automatic page numbering Screenshot Widget used to take a print screen of the current page HMI is showing When you drag amp drop the widget in page it will get automatically the page dimension of the HMI Alarm widget it is used to print the entire contents of the event buffer the Default buffer is Alarm Buffer1 The Text category collects the typical widgets used to compose reports with labels and numeric fields 15 3 Print Events The configured reports can be
130. hen select the panel on which the license is to be activated Once you select the IP e The PANELID number will be shown in the Panel ID box e If you have the backup files of previously activated or created license files in the LICENSEFOLDER the activation key and enabled features will be displayed in the Activation keys section e One empty edit box in the Activation keys section will be enabled for you to enter a new activation key The Activate Panel button will be enabled 4 Enter activation key If you have a new activation key to be activated enter it in the empty edit box in the Activation keys section Once you enter a new activation key e The Add Another Key button will be enabled so that you can add a new edit box and enter another activation key 5 Activate panel Once you have completed entering the activation key you can press the Activate Panel button to activate licenses on the HMI Panel Once you press the Activate Panel button e It verifies the activation key e lt creates a license file and stores it in the folder L CENSEFOLDER HM Licenses PANELID e t downloads the license file to the HMI Panel and activates it Once the activation is completed the enabled features or status of the activation keys will be displayed in the Feature status list box that can be seen on the right side of the Activation keys boxes NOTE After the activation is complete to enable license in the panel y
131. hoe ee Woa StrokeWidt gt Figure 156 rt i Oo my a gt A is Me E IOIO TEE mm E 3 T E a Trend Title ETE I svn 100 To E eai retriever err Title M s o E X Scale 7 ll See ane N a a e 7 rr nl lhl a z T ranana m aysa Curve 1 ES 7 nial acii ee aon smo Ma fons a a SEA A a i A n e a Color a 128 0 0 Figure 157 Select the Trend Widget and in the properties pane attach to the Curve x Value property the Tag for which you want the data to be plotted Data are always plotted against time Num Curves Number of curves This property allows you to configure the number of trend curves in the Trend window A maximum of 5 curves can be configured in a Trend window Page Duration Here you can set the time range of the X Axis However you can dynamically change the page duration in Runtime with the Date Time combo widgets attaching it to the Trend window page duration properties X Labels This property defines the number of Labels in the X axis scale Y Labels This property defines the number of Labels in the Y axis scale Title These properties allow you to modify the Trend title and font properties like font size label etc Curve x These properties allow you define the Tag or the Trend buffer that will be plotted into the trend window Scaling can be applied to the Tag values To apply scaling use the X Forms attached to dialog You can set the M
132. ication to run the PDF Reader or to open a PDF file stored on the Flash the USB memory stick or the SD Card NOTE If you want to store a PDF file in the Flash then you can follow instructions described in the chapter Us ng the ntegrated FTP Server To open the PDF Reader fill in the forms as described in the following figure Action List Action List e A W a Launch4pplication s LaunchApplication a Macro Properties i Launch Browser aT hie LaunchApplication Multi Lang Actions aam z Tag Actions path Flash QTHMI PDF jn Data Transter E arguments Toggle Bit Set Bit a Reset Bit Single Instance true Step Tag ActivateGroup DeactivateGroup ok Cancel Figure 95 If you want to open a PDF file directly type the absolute path of file in the field arguments For example Storage Card PDF demo pdf NOTE The PDF Reader works only with some HMI panels It doesn t work with the Simulator the Windows Client or Activex 7 3 10 LaunchBrowser LaunchBrowser will launch the default web browser You can define the URL address of the webpage in the arguments NOTE Not all the CPDX platforms are equipped with a default web browser Contact Technical Support for additional information Action List aan Action List Ay W W LaunchBrowser Show Dialog Macro Properties Close Dialog z ShorMessage EE a T z LaunchApplication Tag Actions a Data Tr
133. ideos in the playlist in order to avoid upscaling and downscaling Audio is not supported 17 5 1 Using Media Player in JavaScript The Media Player Widget can be also referenced in JavaScript programs with the following syntax get the mediaplayer widget var mediaWet page getWidget MediaPlayerWegt2 oad the play list mediaWet setProperty medialist Storage Card demo_3 avi Storage Card video1_3 avi set the loopstyle O noloop 1 loop one 2 loop all 3 random mediaWet setProperty loopstyle 2 start playing the first file mediaWegt mediapath Storage Card demo_3 avi For a complete reference about JavaScript refer to chapter Working with JavaScript 18 Working with Custom Widgets Designer Studio has a large widget library which includes predefined dynamic widgets such as buttons lights gauges switches Trends Recipes and dialog items as well as Static images such as shapes pipes tanks motors etc With the widget library you can simply drag and drop an object onto the page and then size move rotate or transform it any way you want All widgets in the gallery are vector based so they look good at any size Custom widgets are widgets created by the user and based on the existing widgets from the gallery This chapter describes how to create a custom widget and assign properties to it The advantage of the custom widget is that it can be built out of several elements b
134. idth It gets or sets the Widget width in pixels function btnStd1_onMouseRelease me var wet page getWidget rect1 wet width 10 height number height It gets or sets the Widget height in pixels function btnStd1_onMouseRelease me var wet page getWidget rect1 wet height 10 visible boolean visible It gets or sets the Widget visible state function btnStd4_onMouseRelease me var wet page getWidget rect1 wet visible false function btnStd5_onMouseRelease me var wet page getWidget rect1 wet visible true value number value It gets or sets the Widget value function btnStd6_onMouseRelease me var wet page getWidget field1 wet value 100 opacity number opacity range from 0 to 1 It gets or sets the Widget opacity Values are decimals from O to 1 where 1 is 100 Opaque function btnStd8_onMouseRelease me var wet page getWidget rect1 wet opacity 0 5 rotation number rotation in degrees It gets or sets the rotation angle for the Widget The rotation is done by degree and makes a clockwise rotation starting at the East position function btnStd9_onMouseRelease me var wet page getWidget rect1 wet rotation 45 userValue string userValue It gets or sets a user defined value for the Widget This field can be used by JavaScript functions to store additional data with the Widget function btnStd9_onMouseRelease me var wet page getWi
135. iggered The Graphics reports contain graphical elements and generic composition of widgets including screen shots or alarms ProjectView o deTest019 Printer BA deTest019_Printer el Pages A F Config Protocols ak Report Graphics 1 Report 2 Figure 205 15 1 1 Alarm Reports To add a report for line by line alarm printing click on the Alarm Report button as shown in the following figure Projectl sp ssn Delete ke A Config EA Protocols Figure 206 Mark the check box Use Default Printer Settings if the report can use default settings for the printer The format of the printout can be freely defined using the report editor the paper size can be defined in number of characters while the available fields are listed in the box on the right side Use Default Printer Settings Available fields 60 chars a Severity Time Enable Tel Source Value State Description Spacer gt Figure 207 To include a field in the line to be printed just drag and drop them from the list to the page layout The field can be resized using the mouse the tooltip is showing the dimension in chars In case of the text is bigger than the dedicated space the auto wrap is applied NOTE Only one Alarm Report can be set active in a project 15 1 2 Reports To add a graphic report click on the Report button as shown in the following figure som Delete My 1 Pagel 5 a
136. igure 128 7 10 7 DeleteUMDynamicFile The DeleteUMDynamicFile macro allows you to delete the dynamic user management file This means that the users created edited or deleted in Runtime will be erased and the server will restore the settings from the project file originally downloaded from Designer No Macro Properties are required 7 10 8 ExportUsers The ExportUsers macro allows exporting user details to an xml file usermgnt_user xml User details will be in encrypted form In the Macro Properties the destination folder path must be set to the location where the usermgnt_user xml file is saved If using a USB drive plugged in to the USB port the path will be USBMemory followed by the specified folder in the memory or left empty for root folder NOTE The external drives plugged in the USB port of the panel must have format FAT or FAT32 NTFS format is not supported Since the file is encrypted there is no way to edit the user configuration from this exported file This action is most useful for making a backup to be used for a later restore Action List A W W ExportLsers a Macro Properties _ WriteCurentRecipe Set DownLoadCurRecipe Up LoadCurRecipe Dump Recipe Data i RestoreRecipeData User Management Actions chUser et Password i leet bere a Figure 129 7 10 9 ImportUsers The ImportUsers macro allows importing user details from an xml file named usermgnt_user xml
137. ile For example if we are making a Dump at 10 10AM on 1 1 2012 then the file name will look like D2012_01_01_T10_10_alarmBuffer1 csv DYear_Month_day_THour_Minute_Filename This helps to know the Time at which the Dump was made and also to identify which one is the latest NOTE This option is only supported when exporting to CSV directly timeSpec This option defines the time format used when dumping the event archive to file e Local the time values exported are the time of the HMI device e Global the time values exported are in the Coordinated Universal Time UTC format Example e Local 2012 10 11T05 13 43 724 07 00 e Global 2012 10 11112 13 43 724Z When exporting Event buffers in binary format assuming the DumpConfigFile option is set to true recommended settings the result of the dump action execution is 2 folders one is called data and it contains the data files the second one is called config and it does contain the configuration files needed by the tool to recover the complete information for proper conversion to CSV Once the two folders are copied from the root of the USB drive to the computer disk the folder structure will look as follows A config alarms xml eventconfig xml data AlarmBuffer1 dat AlarmBuffer1 inf AlarmBufferReader exe NOTE The utility is distributed in Designer in the folder Festo Software Designer Studio Utils The AlarmBufferReader can be called from command line wi
138. ile Suite runtime HMI works Unter feld1_onDatauipdate me es 4 var varbool project getTag varbool l field3_onDataU Pagel js 19 5 var wari project getTag var 1 on oars a J 6 var var2 project getTag varz aial ebbini ee if varbool 1 i vari var2 project setTag var 1 var 1 Condition 16 Value Scope iss ae ee 18 var varbool project getTag varbo proto_ null gt me CNumericWgtina oo 0 temp undefined Bese varbool undefined project setTag var 1 temp Welcome to the Ot Script debugger Debugger commands start with a period Any other input will be evaluated by the script interpreter Tvoe helo for help gsdb gt Deua ouat console fT Figure 255 For a complete reference guide about Qt Script Debugger you can open the following link in your browser http doc troll no 4 7 qtscriptdebugger manual html 20 5 Limitations Widgets cannot be instantiated from JavaScript The Widgets can only be accessed and changed If you need additional Widgets on the page you can add hidden Widgets on the page and show or position them from JavaScript 21 Updating System Components in CPDX HMI Most of the system software components can be easily upgraded by the end users this ensures a high degree of flexibility in providing updates and fixes to existing and running systems This upgrade can be done using USB flash dr
139. ing containing the name of widget Return value An object representing the widget If the widget does not exist null is returned function btnStd1_onMouseRelease me var my_button page getWidget btnStd1 setTimeout number setTimeout functionName delay It starts a timer to execute a given function after a given delay once Parameters functionName A string containing the name of function to call delay The delay in milliseconds Return value It returns a number corresponding to the timerID var duration 3000 var myTimer page setTimeout innerChangeWidthQ duration clearTimeout void clearTimeout timerID It stops and clear the timeout timer with the given timer Parameters timerlD The timer to be cleared and stopped var duration 3000 var myTimer page setTimeout innerChangeWidth duration do something page clearTimeout myTimer setinterval number setinterval functionName interval It starts a timer that executes the given function at the given interval Parameters functionName A string containing the name of function to call interval The interval in milliseconds Return value It returns a number corresponding to the timerlD var interval 3000 var myTimer page setinterval innerChangeWidth Q interval clearInterval void clearlnterval timerID It stops and clears the interval timer with the given timer Parameters timerlD The timer to be cleared and stopped var interva
140. inimum or Maximum of the curves You can also attach a Tag to these minimum and maximum properties This enhances the ability to change the min and max dynamically in the Runtime Also you can modify the properties such as colors update time number of samples etc of the Trend curves through the property view 10 2 History Trend If you want to analyze the data at a later time the Trend data will need to be stored For this purpose you use History Trend When you select History Trend you can store the data information with reference to time The first step in creating a History Trend is to create a Trend Buffer The purpose of the trend buffer is to save a sequence of values of a specified Tag in order to record the state of the tag while time changes Once values are stored in the buffer a dedicated widget called History Trend viewer can be used to display the curve ina graphical format The History Trend viewer is available in the widget gallery In the History Trend widget the start time of the Trend window will be the current time and stop time will be the current time duration of the window The plot starts from the left end of the Trend window as in the figure below The graph will be automatically refreshed during a certain interval of time until the stop time When the curve reaches the stop time the graph will scroll left and the update of the curve will continue until it again reaches the right side of the viewer At
141. is pressed e when a button is released e when the value of a Widget a numeric field for example or of one of the widget properties attached to a tag changes an event will be triggered This is the OnDataUpdate event when a page is entered when a page is left on exit when the visualization component of at least one object in a certain page changes when an alarm is triggered when the scheduler engine is triggered because of a time condition Whenever the system generates an event it is possible to attach one of the following actions to the event e aspecific action selected from a list of predefined actions e apiece of JavaScript code The figure below shows an example of an action activated by pressing a button w Properties aA amp 6 a Button Value 0 Click Type momentary Label Fill Color 123 123 192 Show Frame true yi Events OnMousePress Action OnMouseRelease Action Add Macros OnDataUpdate Action Add JavaScript Figure 68 By associating actions to events the Designer programmer configures program interactions with the interface 6 System Variables System variables are special tags containing information about the runtime and its Operation System variables are available in the Attach to dialog from the Source selection as shown in the following picture field Lvalue bo Alarms Communication bo Daylight Saving Time gt Device b Dump Information gt Mo
142. ity which comes by default next to the ID column Severity column takes the values from the Severity settings from the Alarm Editor 8 5 Enable Disable Column Sorting You can enable or disable the column sorting option available at Runtime for the Alarms Widget by clicking on the column header The sorting order is based on the string sorting Properties a x Ad al ag Alarms List Col Prop Sort Column Display Configure Figure 141 8 6 Configure Alarms History Widget Designer automatically logs the Alarm list based on the Flag Settings set in the Alarms Editor under Log Event Types To see the Historical Alarm list you must configure the Alarms History Widget available in the Gallery on a dedicated page Duration Refresh Alarm Time Alarm Name Alarm Id Event Type Alarm State Backward Forward Figure 142 NOTE Starting from version 1 80 the event viewer in the gallery includes two new buttons called Backward and Forward they allow you to scroll the events in the past or in the future in steps defined by the Duration property The selection of the Event Buffer is available in the property panel as shown in the figure Combo Box Text None Index 0 DataLink PageDurat List None 1 Mil List Data OnDataUpd Display EventButter Event Butte EventBull rae Idal Events a Eventi XMLFileWgt Event Events Event4 Event5 Evento Event mM
143. ive plugged into the USB port the path will be USBMemory or if you use an SD Card the path will be Storage Card followed by the specified folder in the memory NOTE The execution of the Dump action will automatically force a flush to disk of the data temporarily maintained in the RAM memory See the chapter Trend Editor for further information about the policy used to save sampled data to disk NOTE The external drives plugged on the USB port of the panel must have format FAT or FAT32 NTFS format is not supported Action List Action List A W W DumpT rendi ControlUserLED Dump Trend Delete Trend Dump EventArchive Delete EventArchive Reset Proto Erount 3 Safely Remove Media CopyCodesysProject Recipe Actions Down Load Recipe UpLoadRecipe Macro Properties DumptTrend TrendName FolderPath USBMemory DumpAsCSY true DatetimePret true timeSpec Global TrendName The name of the trend to be WiiteCurent Recipe Set DownLoadCurRecipe UpLoadCurRecipe dumped Cancel _ Figure 110 DumpAsCSV If this option is set to true then the buffer will be directly dumped to the specified location as a CSV file in the format specified below If it is set as False then the dump of the trend file will be in binary format the result of the dump operation is actually a couple of files one with extension dat and one with extension inf An external utility is then r
144. ives loaded with the new software modules and by running the procedure described in detail in this chapter Each unit comes from the manufacturing with a product code label which includes all the information related to the factory settings in terms of hardware software and firmware components Product labeling is the first reference for checking the factory settings and version of the components installed at time of manufacturing The update tool on the HMI panel also provides the user with detailed information on the components actually running in the system NOTE Files required for upgrades depend on the product code Using the wrong files for upgrade may result in system malfunctions and may even render the system unusable NOTE Files for upgrades are distributed on demand as a technical support activity 21 1 System Settings Tool The System Settings tool comes with an interface based on a rotating menu with navigation buttons at the top and bottom to scroll between the available options The tool is shown in the figure below On the left side several components and functions are highlighted and for each of them the right side Info pane shows the information about the current version when applicable In the picture below the version of the Main OS component is shown Info Name UNZO Download Configuration OS Date 71 10 09 He O1 Type Windows Embedded CE 6 0 Download Main OS HS oi Version UNZ
145. ject You can attach a Tag toa different property by selecting the property in the Property view and clicking on the Attach To pop up menu You can also right click on the object and select the Attach To menu item The Attach To dialog will be displayed and you can select the desired property from a list on the right part of the dialog NOTE A specific chapter later in this document describes in detail the Attach to concept 4 8 Testing the Project HM Simulator provides the facility to test the project functionality before downloading it to the panel This feature is useful to test the project when no PLC hardware is available The user can choose real PLC or PLC simulator for the project The simulator field in 7ag Editor and simulator settings dialog are used to configure HM Simulator 4 8 1 Launching the HMISimulator HM Simulator can be launched from Designer and also can be run as a Standalone application If you launch from Designer select the Run gt Start Simulator menu item to start it Format View Window Help ca Download To Target Manage Target Start Simulator Figure 33 At this point the simulator is running locally on the PC similar to the way the server runs on a panel 4 8 2 Stopping the HMISimulator Format View Window Help s Download To Target yy ie Manage Target W Stop Simulator Figure 34 To stop the HM Simulator select
146. ject properties can be set at programming time or configured to be dynamic To change a property at programming time you can use the page toolbar or the property pane which shows the properties available for the selected object 4 oo a 100 X H SY me fee UH i Figure 62 The page toolbar permits a quick change of the most commonly used object properties When you need a complete view of all the properties of a certain object you need to use the property pane You have to select an object to see its properties shown in the property pane The property pane allows you to both change a property at programming time and attach the property to a dynamic element From the property pane when you click on the right side of a property cell you get the ability to Attach to the property to a tag This operation is done using the Attach to dialog shown in the figure below Properties 1 x ad ef l Field Value 100 Number F Attach To Keypad TYP niimerc Events Figure 63 The Attach to dialog has two tabs The first is called Tag and allows you to attach the property to an element The source can be selected using the radio buttons The element to which the property can be attached is a lag a System Variable see chapter System Variables for an explanation of the meaning of all System Variables a property from another Widget an element of a Recipe The radio buttons at the botto
147. k Da Month oo Mare CURRENTLY SET standard Time 7 Figure 72 6 4 Device The variables in this category can be used to adjust specific device settings and get operational information field L value XForms SOUrce Tag System Widget Recipe Tag Current RAM usage d Device Available System Memory Backlight Time Battery LED Battery Timeout Display Brightness External Timeout Flash Free Space System Font List System Mode System UpTime Touch Buzzer ReadOnly Read Write Write Only TagIndex o Figure 73 Available System Memory Returns the free available RAM memory in bytes it is a 64 bit data it is a read only variable Backlight Time Returns the activation time in hours of the display backlight lamp since production of the unit it is a read only variable Battery LED Allows you to enable disable the use of the front LED indicator to report the low level battery status It can have values O disabled or 1 enabled Battery Timeout Reserved Display Brightness This variable is an integer of R W type Its range goes from 0 to 255 It can be used to check brightness level and adjust it from the application Typical use is connected to a slider widget External Timeout Allows setting the non operational time after which the display backlight is automatically turned off The backlight is automatically turned back on when the user presses on the touch screen The variable i
148. l 3000 var myTimer page setinterval innerChangeWidthQ interval do something page clearInterval myTimen clearAllTimeouts void clearAllTimeouts It clears all the timers started Page clearAllTimeouts Q 20 3 1 7 Group Object A group is a basic logical element that is associated with a set of logical tags It provides an interface to enable the uniform operation on a Set of logically connected tags 20 3 1 8 Methods getTag object getTag TagName Gets the tag specified by TagName from the group object Parameters TagName A string representing the tag name Return value An object that is the value of the tag or if tag value is an array it returns the complete array If you need to retrieve an element of the array check the method getTag available in object Project undefined is returned if tag is invalid var group new Group project getGroup GroupName group var value group getTag Tag1 getCount number getCount 0 Returns total number of tags in this group Return value The number of tags var group new Group project getGroup GroupName group var value group getCount getTags object getTags Returns the list of all tags in group Return value An array of all tags in the group var group new Group project getGroup enginesettings group var tagList group getTags for var i 0 i lt tagList length i var tagName tag List i do something 20
149. le if you want to run Notepad application the argument should be notepad exe Path application path when the target platform is Windows CE the path is flash qthmi This is the folder that you see and have access to when connecting to the panel via FTP Arguments Some applications may need arguments to be passed For example to open a pdf file specify the file name so that while launching the application the file name set in the argument is loaded on the application For example flash qthmi Manual pdf will open the document Manual pdf Single Instance This argument allows the application to start in a single instance or multiple instances When single instance is selected the system first verifies whether the application is already running If it is running then the application pulls it up the operating system puts it in the foreground to the user s attention if it is not running then the application is launched Action List Action List e A wW W Launch pplicationi Macro ShowMessage Macro Properties LaunchApplication Launch Browser MuttiLang Actions 7 app Name Reader exe i Set Language E path flash qthmi LaunchApplication Tag Actions Data Transfer Toggle bit Set Bit 2 Reset Bit arguments WriteTag Commands z Step Tag ActivateGroup arguments flash qthmi example pdf Single Instance true Figure 94 PDF Reader You can use the macro LaunchAppl
150. lected Tag the Audit Trail will record the write operation to that Tag together with the time stamp and user that executed the write operation 14 4 Configure Alarms in the Audit Trail You can specify the alarms to be monitored by the Audit Trail Double click Audit Trail from the project workspace and click on the Alarms tab Select the alarms you want to be logged in the Audit Trail The Audit Trail for alarms will also record and acknowledge the operation done by the logged in user Figure 203 14 5 Configure Login or Logout Details in Audit Trail Alarm4 Alarm5 Alarm6 Alarm7 Alarm Alarm9 Alarm10 Alarmi1 Alarm12 Alarm13 Alarm14 Alarm15 Alarm16 Alarm17 Ss So a Ss Gaga GB G 0 8 80 0 0 a a AuditTrail AuditTrail AuditTrail AuditTrail Event3 AuditTrail AuditTrail AuditTrail AuditTrail AuditTrail AuditTrail AuditTrail AuditTrail AuditTrail AuditTrail AuditTrail AuditTrail The Audit Trail can record information about user login and user logout events These settings are available in the Misc tab of the Audit Trail il Protocols ne Tags 2 gw Events Buffer PE Scheduler a 2 MultiLanguage er Security dig UserGroups 7 zz Users Ekg AuditTrail E AuditTrail 2 Wa Recipes sa a Dictionaries DialogPages p Page Templates Be Keypads A Mi Alphabet E Numeric Figure 204 Settings Audit Login Details Audit
151. lete Delete Project Target 192 168 0 14 7 status Figure 42 NOTE Transferring a project after the above settings will result in a change of the default configuration At the next download the new ports will be used on the target and the new ports will have to be specified in the software to match the new selection In the download dialog click on Advanced Menu and set the port Download System Files Figure 43 Set the HTTP HTTPS port and FTP FTPS port of the Target They represent the port numbers the software uses to connect to the FTP S and the HTTP S servers on the Target This is useful whenever default ports are for some reason in use by other applications or services or if the local network requires using different port settings studio Port Settings Figure 44 The HMI system also supports the ability to transfer a project to the panel device using a USB drive To transfer the project via an external USB flash disk you need to first create the so called Update Package From the Run menu click on Manage Target and select the Update Package as shown in the following figure Retrieve Projects Load Project Unload Project Upload Project Delete Project Download System Files Restart Target Update Runtime Update Package Target Setup Target Note 127 0 0 1 Status
152. lso for each single widget defined within the project all the widgets can be reached from the tree structure on the left part of the widget tab Permissions can be given at three levels e Project level e Page level e Widget level In the tree structure the permission for a page can be set as e Full Access e Hide e Read Only All the widgets on this page will take the settings that have been assigned to the page with a type of hierarchy logic Suppose the page permission is set as Read Only then all the widgets in the page will have the permission as Read Only On selecting a widget inside the page from the tree structure you can see that the permission is given as Use Base Settings This means that it takes the permission given to the page Read Only The widget permission takes the priority as follows Low priority Basic settings widget settings in general for the project Medium priority Page settings Settings for all the widgets on a particular page High priority Widget settings individual widgets or its group parent widget permission of any page For example suppose a widget is set at Read Only permission at project Level and it is given Full Access at page Level then the page Level Settings will be taken Later in the chapter we explain how to modify permissions for a specific widget directly from the page view rather than locating the widget from the tree view shown in the authorization dialog
153. lue 6 6 Network field Lvalue XForms Source Tag System Widget Recipe Tag Battery LED gt Device gt Dump Information gt Monitor and DVI Switch Settings IP Address Mac ID Subnet Mask gt Printing gt SD Card gt Time Read Only Read Write Write Only TagIndex o Figure 75 The system variables in this category allow you to show and set network device parameters Except for the MAC ID they are all strings of R W type 6 7 Printing The variables in this category return information about the Printing system All the variables are read only field Lvalue XForms SOUTE Tag System Widget Recipe Tad Current RAM usage 4 Printing Completion percentage Current disk usage Current job Current RAM usage Disk quota Graphic job queue size RAM quota Status Text job queue size Read Only Read Write Write Only Tagindex o Cancel Figure 76 In the table below you can read the description of the available system variables The percentage of competition of the current print job It Completion percentage ranges from 0 to 100 men deuse The size in bytes of folder where PDF reports are stored it 5 is reportspool if option Spool media typeis Flash Current job The name of the report the job is processing Current RAM usage 5 size in bytes of the RAM used to process the current The maximum size in bytes of the folder
154. m allow you to set the access type The Tagindex selection is used in the case of arrays to determine the array element field Lvalue XForms Source Tag System Widget search Tad Tag4 4 Variables protl Tagl Tag Tags Tag 4 Variables prot2 Tags ReadOnly Read Write Write Only Tagindex o Figure 64 When adding Tags the Protocols used in the Project are shown in the tag Dialog box and when expanding each protocol the corresponding tags can be seen The tags will be arranged in alphabetical order inside each Protocol There is an Option to search the tag to be attached by its name as shown in the Figure above This makes it easy to find Tags The search can be done in two ways first you can start typing the tag name in the left box and this will jump into the list to the first tag starting with the characters you have entered second you can type in the search box any part of a tag name and this will automatically apply a filter to the view so that only the tags which contain the search characters are displayed field L value Source a Tag a System A Widget P Recipe Tag motorl e 4 Varablesprotl Motor MotorBack MotorFront ReadOnly Read Write Write Only TagIndex O Figure 65 The second tab is called XForms and it is shown in the figure below The XForms tab allows you to apply transformations to the numeric value of the source element before it is
155. macro allows you to make the page duration longer 7 5 10 ZoomResetTrend ZoomResetTrend macro allows you to reset the zoom level back to the original zoom level 7 5 11 PauseTrend PauseTrend macro allows you to stop plotting the Trend curves in the Trend window When used with Real Time Trend the plotting stops when the curve reaches the right border of the graph The Trend logging operation is not stopped from the panel when this macro command is used 7 5 12 ResumetTrend ResumeTrend macro allows you to resume a Trend plotting you previously paused After executing the ResumeTrend macro the Trend window will start to plot the data to the Trend once again 7 5 13 Show Trend Cursor The ShowTrendCursor macro allows the user to know the value of the curve at a given point on the X Axis Use this macro to activate the Trend Cursor At Runtime upon executing the macro a Vertical Line Cursor will display in the Trend Widget When the Graphic Cursor is enabled the scrolling of the Trend is stopped You can implement Scroll Cursor macros to move the Graphic Cursor over the curves or to move the entire Trend window Action List Action Lit A Y 6 Show rendCursor Macro Script Corint i DeactivateGroup a Macro Properties a ShowTrendCursor oo Refresh Trend Trend Name JrendWindow 2 ScrallRight Trend Show Cursor true j FageLeftTrend PageRight Trend Page Duration Trend i Pause Trend s Res
156. me expressed in UTC format They are all Int 32 bits of read write type except for the System time which is a 64 bit variable still of read write type This is actually the UTC time which also is available as date time from the other variables 6 10 USB Drive The variables in this category return information about the external USB drive connected to the panel They are 64 bit variables except the drive name which is a String All the variables are read only field Lvalue Source Tag System Widget Recipe Tag oystem Time gt Monitor and DVI Switch Settings gt Network PLE gt Printing gt SD Card ail USB Dre USB Drive FreeSpace USB Drive Mame USB Drive Size USB Drive Status User Managemen ReadOnly Read Write Write Only TagIndex Q Figure 79 USB Drive free spaceSize in bytes of the available space USB Drive Name Name of the USB device USB Drive Size Size in bytes of the device plugged in the USB port USB Drive Status Status of the USB device 6 11 User Management These system variables return information about users and groups field Lvalue XForms Source i 3 j Tag a system 4 Widget i i Recipe Tag System Time gt Monitor and DVI Switch Settings gt Network gt PLC gt Printing gt SD Card gt Time 4 User Management No Of Remote Clients Alrve This Client Group Name This Client ID This Client User Name ReadOnly Read Writ
157. mmunication Protocols esssseesseesseesseeesscesseesseersseesseesseess 22 4 3 1 Configuring a Communication DIiVEL cccseccescceccesccescceceesceeseees 22 AA Adae VAISS cans esdusnss cea teas escisacas dicots gasses Go ieaimeane ase aaa eas 24 AON Designer Pa SECC OM sisir E e 25 Au Desine Data TYPES wuciwesssicaasaateitectecenicewctendcacacena near leas Gacmnes 27 4 5 DESISMING a Pao Ecser aar n de viees telat uaa ieee 29 AS IMPON TPAS Ooie E E 30 4 6 The Designer Widget Gallery ccsscssssccsssccssccesscceescceesceeesceeesss 31 4 7 Attach To and Dynamic Properties cccceseccessccesceeesceeesceeeees 33 Heo TESTING Tne PIO OCU esie R 36 4 8 1 Launching the HMISIMULAtOS cccescceescceescesscceescccnsceeesceesceeeess 36 4 82 Stopping the AMISIMUATOI sereia a tacdeveaesasecastant 36 476 3 SIMULALOE SEINE S erna na E EE EE TA 37 4 8 4 Browsing Project from HMISIMULAatOl ccceseccessccescceesceesceeeees 39 4 9 Transferring the Project to Target ccceccsescessccsecccesccesceesceesceees 39 4 9 1 When Target Flash Memory iS LOW ccccsssscesscccsscccnsceesceeesceeeecs 46 LOD Tine RUMMIME Ood areis an abewscceteagek teetaat cuecsdaactestassevine 46 AAO Usine Windows Chent Cheni zoss E 49 4 11 Using ActiveX Client for Internet Explorer esssessssessseesseesseeesseesseess 51 4 11 1 Copy ActiveX into the Target Device esssessssesseessseesseessecssecesseessees
158. nd runtime version 1 90 and above and operating system version BSP on panel V1 54 or above for CPDX series 16 Keypads Keypads are used for data entry operations Several keypads are provided in the Studio by default including Numeric Alphabet Alphabet Small and Up Down as shown in the following pictures Figure 218 Alphabet keypad Figure 220 Up Down Keypad 16 1 Creating and Using Custom Keypads Keypads can be created from scratch using the following procedure Note that you can also change the existing keypads From the Project View pane right click on the Keypads folder A context menu will be displayed as shown in the figure below Figure 221 Clicking on the Insert Keypad will generate a pop up with the New Keypad dialog as shown below Figure 222 The user can select any of the available keypads that are provided in the project template the list shown on the left side to create a custom keypad If you need to create a keypad from scratch then select the Blank option This will insert a Blank Keypad as shown below Figure 223 You can use the widgets available from the Keypad Widget gallery as shown in the picture below to create the custom keypad Widget Gallery a x Edit Controls Custom shapes Alphabets Generic Numeric US Int Alphabets US Int Generic US Int Numeric Figure 224 A sample custom created keypad is shown below Newly created keypads will b
159. nd the Default Font used by all the table like widgets such as alarms or events Use the Default button to set the default language used when the Runtime starts Multi language Languages Text ape Add 3 Delete y Default Langld Language Writing system Default Font 1 1 lt Lang1 gt Any Tahoma 2 2 Lang2 Cyrillic Arial 3 3 Langs Simplified Chinese SimSun Figure 167 11 1 1 Language Display Combo This combo can be used to change language at the design phase This helps users to view the page in the different supported languages at design time itself Format View Window Help File Edit Run Ba Figure 168 11 2 Multi Language Widget Multi language support is available for different objects like push buttons static text message alarm description and pop up messages 11 2 1 Multi Language for Static Text Widget When you double click a text widget on the page the dialog shown below will open Here you can edit the text for the selected language and select the font The bold italic and color properties are set for all the languages globally for the widget Text for each of the languages can be given by selecting the language from the combo box However it is recommended that you use the export and import features as described in the chapter Export and Import of Multilanguage Strings s emt Label
160. nitor and DVI Switch Settings b Network gt SD Card b Time gt USB Drive bo User Management ReadOnly Read Write Write Only TagIndex oO Figure 69 System variables are divided into categories Categories are described in specific chapters 6 1 Alarms The variables in this category return information about the actual number of alarms divided per status field Lvalue Source Tag System Widget Recipe Tag Current RAM usage Not Triqgered Acknowledged Not Triggered Not Acknowledged Number of missed alarm events Triggered Acknowledged Triggered Alarms Triggered Not Acknowledged Lommunicatia Daylight Saving Time Device Dump Information Monitor and DVI Switch Settings Read Only Read Write Write Only TagIndex O Figure 70 All these system variables are Int type 32 bit read only 6 2 Communication These variables return information about the status of the communication between the target device and the controllers configured in the Protocol Editor field Lvalue XForms SOuUrce Tag System Widget Recipe Tag Current RAM usage 4 Communication Protocol Communication Status Protocol Error Count Protocol Error Message gt Daylight Saving Time gt Device gt Dump Information gt Monitor and DVI Switch Settings gt Network gt PLC gt Printing ReadOnly Read Write Write Only TagIndex 0 Cancel
161. nload Error set unknown recipe controller not ready Tags write failed ane 4 Upload triggered triggered Triggered an Triggered an upload request request Upload done Upload action completed Error occurred when doing upload errors similar to Upload Error download errors Errors like data not available NOTE When the panel starts up the value of Recipe Status is 0 9 5 Configuring Recipe Widget for Runtime Execution Two default Recipe Widgets are available in the advanced Widget Gallery category The Recipe Set Widget allows you to select a Recipe set for the upload and download operations If you have more than one Recipe in the project then the Recipe Menu Widget can be directly used to manage all the Recipes from a single Widget listing Recipes and selecting the sets for each Recipe Recipe Set Recipe Menu Recipe Set Recipe Download Upload Recipe Set Download Upload Figure 153 9 6 Configure Recipe Transfer Macros The Recipe transfer action can be completed through the action list dialog The transfer of Recipes can be achieved by any of the following methods Attaching an action to an event for button or switches Configuring the action from the Alarms action list Using the Scheduler actions list Description of actions available for Recipes is included in the relevant chapter Action List ut Action List A W W UpLoadRecipe Recipe Actions Macro Properties DownLoadRecipe UpLoad
162. ns LogQut Figure 119 7 9 7 DumpRecipeData The DumpRecipeData macro allows you to dump the recipe to the Flash memory a USB memory or an SD card In the Macro Properties define the location where to save the dumped file Recipe data is saved in CSV format If you use a USB drive the path will be USBMemory or if you use an SD Card the path will be Storage Card followed by the specified folder in the memory NOTE The external drives plugged in the USB port of the panel must have format FAT or FAT32 NTFS format is not supported Action Lit F A W W DumpRecipeD ataf ControlUserLED Macro Properties Delete Trend IF att ancien ncaa Soars eae ee cee ee eae DumpEventArchive FERRO renee USBMemory DeleteEventArchive DatetimePretxedFileName true ResetProtoEmCount neeem en i SafelyRemoveMedia Recipe Actions z DownLoadRecipe UpLoadRecipe WriteCurentRecipeSet toe 1 3f User Management Actions O Ra Termi it Figure 120 DateTimePrefixFileName When this option is enabled the dumped file will have the Date and Time as prefix of the name of the File For example if we are making a Dump at 10 10AM on 1 1 2012 then the file name will look like D2012_01_01_T10_10_recipe1 csv DYear_Month_day_THour_Minute_Filename This helps to know the Time at which the Dump was executed and also to identify which one is the latest 7 9 8 RestoreRecipeData The RestoreRecipeData macr
163. ntain number Password must contain special character User must change his initial password Enable logoff time Inactivity logoff time Figure 126 7 10 5 DeleteUser The DeleteUser macro is used to delete users at runtime Upon executing this macro a template page will pop up where you can Select the user you wish to delete No parameters are required to set this macro After executing the macro the Delete User form will be displayed as shown in the figure below User name Password useri Comments Password must contain number Password must contain special character User must change his initial password Enable logoff time Inactivity logoff time Figure 127 7 10 6 EditUsers The EditUsers macro is used to edit users at runtime When executing this macro a template page pops up Here you can select a user and modify this user s parameters such as Username Password Group Comments flags like password must contain numbers password must contain special character user must change his initial password enable logoff time and Inactivity Logoff Time After executing the macro a User Edit form will pop up as shown in the figure below User name usert ha Password useri Group admin g Comments Password must contain number Password must contain special character User must change his initial password Enable logoff time Inactivity logoff time F
164. o allows you to restore the Recipe data using the saved Recipe data file from the USB memory or SD card In Macro Properties provide the file path of the Recipe files In the figure below the example shows the case of a USB drive If you use a USB drive the path will be USBMemory or if you use an SD Card the path will be Storage Card followed by the specified folder in the memory NOTE The external drives plugged on the USB port of the panel must have format FAT or FAT32 NTFS format is not supported Action List W we RestoreRecipeD atal ba en Macro Properties SafelyRemoveMedia Recipe Actions DownLoadRecipe User Management Actions ok Figure 121 7 10 User Management Actions User Management Actions macros have been designed for user management and security settings in Runtime 7 10 1 LogOut The LogOut macro allows you to log off the current user in Runtime After executing the LogOut macro the HMI behavior depends on whether a Default user is configured in the project or not If there is a Default user the LogOut automatically logs in the Default user If there is not a Default user or you logout from the Default user then the log in screen is shown Action List Action List e A W W LogQut User Management Actions Figure 122 7 10 2 SwitchUser The SwitchUser macro allows you to switch between two users without logging out the logged in user The server continues runnin
165. of the numeric keypad Then open and modify the default numeric keypad and save it with its original name The now modified numeric keypad will be assigned by default to all numeric fields in the project 17 Special Widgets 17 1 Date Time Widget The Date Time widget is a widget that can be used to view and edit the current time and date at Runtime The widget can be found in the Widget Gallery The widget value has to be attached to the System Time system variable If you drag and drop the widget it automatically shows the current time which it takes from the system time In the Property pane of the widget you can set the format of the date and time as Date only Time only Date and Time Different formats for representing date and time are available as shown in the figure below 3 Properties 1x DateTime Value 2106 02 07711 58 DataLink System Time _SysPrc eee or DEEE hhmm WDD YYYY hh mm Time Spec OnDataUpdate ae e vt hh mm ss E Display M DD Y 12 79 11 11 24 29 D MM YY E 7 D MM YYYY D MM YY D MM YYYY mmm DO YYYY D mmm YYYY IMM DD YYYY h mm ss H mim ss AP ihimm m Figure 229 The Time Spec option allows selecting which time the widget has to show during Runtime three options are available for this property e Server e Local e Global To understand the difference between the options available for the Time Spec property you need to recall the ba
166. onjunction with the Save button of the Alarm widget it is required to properly save at runtime the changes made in the Enable check boxes from the Enable column in the alarm widget 04 01 2012 12 05 00 04 01 2012 12 05 00 04 01 2012 12 05 00 Figure 108 7 7 System Actions The System Actions macro allows you to use the system properties in Runtime 7 7 1 Restart The Restart system macro allows you to restart Designer Runtime After executing the macro the Designer server goes to configuration mode and restarts Runtime 7 7 2 ControlUserLED This allows the switching ON OFF or blinking of the User LED In the action properties the LED action can be set to OFF ON or Blink Action List Action List A W W Control serLED Macro Script i SerollEventsForward Macro Properties a ControlUserLED Restart LED Action OFF Dump Trend Delete Trend l DumpEventArchive Delete EventArchive ResetProtoEmCount Safely Remove Media Recipe Actions z DownLoadRecipe UpLoadRecipe Figure 109 NOTE Not all HMI models have User LED indicators Check the product documentation for further information 7 7 3 DumpTrend The DumpTrend macro is used to store the Historical Trend data to external drives such as a USB drive or an SD card In the macro properties you must configure the Historical Trend name you want to store and the destination folder path If you use a USB dr
167. onsidered significant and then stored only if its value in comparison with the last saved value goes out from the specified boundaries In case the triggering condition is based on a trigger tag value change the boundaries are applied to the trigger tag value 10 3 Configuring Trend Window for History Trends The History Trend widget trend window is the area used to display the trend buffer in a curve format After configuring the trend buffer in Trend Editor you can use the Historical Trend viewer widget to plot the trend curve on the screen From the trend gallery page drag and drop the History Trend widget to the page a Properties aA x x Wh m he la H ees 2 i 8 Ff El History Trend MaxY 100 05 30 00 05 30 00 05 30 00 05 30 00 05 30 00 05 30 00 W Color W 28 00 OoOO E a StrokeWidt 2 Curve 2 Figure 160 Then in the property pane of the Trend window attach the trend buffer to be plotted in the trend window as shown in the figure below Tag System Widget Recpe Tag Trend1 _MultiLangMgr BtnStds BtnStd2 PanelTrendl Trend Trend2 Trend Wit ReadOnly Read Write Write Only TagIndex O Figure 161 10 4 Trend Window Properties Advanced View With the help of the property pane of the trend window you can customize the Trend window properties such as X Axis time Y Axis value number of trend curves changes to the labels grids number of samples
168. operty allows you to select the bit position inside the Tag Action List P A W W ResetBit Project__T Figure 100 7 4 5 WriteTag WriteTag allows you to write constant values to the controller memory In the Macro properties you have to specify the Tag name and the value to be written Action List P A Y W WiiteT ag Project _T Macro Properties MuttiLang Acti Set Language Tag Actions l Data Transfer Figure 101 7 4 6 StepTag The StepTag macro allows you to increment or decrement the value of a Tag TagName Name of the Tag you want to Step Step Step value Do not step over limit Step Limit enable Step Limit If the Do not step over limit is true then the macro will work until the Tag value reaches the specified value Acton List A W a StepT ag Project_T a Macro Properties Figure 102 7 5 Trend Actions Trend actions are used for both Live Data Trends and the Historical Trends Widget 7 5 1 RefreshTrend The RefreshTrend macro is used to refresh the Historical Trend window You have to specify the Trend Widget in the macro properties 7 5 2 ScrollLeftTrend The ScrollLeftTrend macro is used to scroll the Trend window to the left side by one tenth 1 10 of the page duration NOTE With the Real Time trend it is recommended to pause the trend using the macro PauseTrend otherwise the window Is continuously shifted to the current value 7 5 3 ScrollRightTrend
169. ot triggered status Both when entering the triggered and not triggered status When the alarm is acknowledged When the alarm is reset E When the alarm is disabled E When the alarm is enabled Figure 138 8 3 3 Actions The user can specify the conditions under which the action s configured for the specific Alarm must be executed Set here for which transitions of Alarm s status the programmed action s has to be executed When entering the triggered status E When entering the not triggered status E Both when entering the triggered and not triggered status E When the alarm is acknowledged When the alarm is reset E When the alarm is disabled E When the alarm is enabled Figure 139 By default the actions are executed only when the Alarm enters the triggering condition you may change this by configuring the system to execute the configured action also for the other alarm states available 8 4 Configure Alarms Widget You can insert the Alarms Widget in a page to see the status and acknowledge or reset the alarms Simply drag and drop the Active Alarms Widget from the Gallery Source Value Description Ack Reset Save Check Uncheck All Filter Hide Not Triggered Figure 140 The Alarm Widget will display the Alarms in Runtime NOTE Starting from version 1 80 the Alarms widget provided in the gallery no longer has the Priority column The widget has a new column called Sever
170. ou must restart it 21 4 2 Save License Save License operation is done to create the license file now for activation later Manage Target 1 License folder G Users Username Documents workspace Panel Info Activate Panel Select Panel 192 168 4 3 Panel ID 0030D80210E7 Activation Keys 03C3E 44445 4 7554 8600C CODESYS B1C31 05E38 496B 9FA93 POF VNC 4 Add Another key Import License Save License 1 Select the location used to backup license files From this point on the path selected will be called LICENSEFOLDER in the document 2 Select Save License option using the radio button 3 Enter Panel ID Once you enter the Panel ID e Ifyou have the backup files of previously activated or created license files in the LICENSEFOLDER the activation key and enabled features will be displayed in the Activation keys section e One empty edit box in the Activation keys section will be enabled to enter a new activation key e The Save License button will be enabled 4 Enter activation key If you have a new activation key to be activated enter it in the empty edit box in the Activation keys section Once you enter new activation key e The Add Another Key button will be enabled so that you can add a new edit box and enter another activation key 5 Save License Once you have completed entering the activation key you can press the Save License button for saving license files Once you press the
171. ow For example when working with a gauge object the most common action taken by the programmer is to attach a Tag to the needle so that the value of the Tag referenced in the controller memory is represented by the needle movement Properties a E amp n mE Value 25 Min Attach To Max 200 Events Configure Display Figure 31 To attach the Tag to the needle single click on the object to display its properties in the Property view Locate the Value property and click on the button on the right part of the field as shown in above figure Select the Attach To menu item and a dialog will be displayed as shown in the figure below field Lvalue Source Tag System Widget Recipe Tag 4 Variables protl Tagl Tag Tag3 Tag4 ReadOnly Read Write Write Only TagIndex o Figure 32 When attaching a Tag you can attach four types of data sources Tag System Tag another object property Widget and Recipes Select the Tag source type to attach to a Tag defined in the Tag editor Select the System source type to attach to a System Tag Select the Widget source type to attach to data from another object Select the Recipe source type to attach to Recipe data from Recipe manager Now select the Tags from the Tag Name combo and Click OK Tags can be attached to many different properties of the ob
172. p groupinstance The group element to be filled callback A string containing the name of the function to be called when the group is ready Return value A number value that is the status 1 for success O for fail var group new Group var status project getGroup enginesettings group if status 1 var value group getTag Tag1 if value undefined do something with the value var g new Group var status project getGroup enginesettings g fnGroupReady function fnGroupReady groupName group var val group getTag Tag1 if val undefined do something with the value getTag object getTag tagName state index void getTag tagName state index callback It returns the tag value or the complete array if index value is 1 of the given tagName Parameters tagName A string of the tag name state The state element to be filled index An index if the tag is array type 1 returns the complete array Default is O callback function name if an asynchronous read is required Default Return value Tags value is returned If tag is array type and index 1 then the complete array is returned Remarks For non array tags provide index as 0 var state new State var value project getTag Tag1 state 0 i for non array type tags index is not considered so can be left as 0 if value undefined do something with s var state new Sta
173. quare Wave Max Mini Period msec 0 Figure 38 4 8 3 1 Variables The data is stored in a variable in the simulator This variable holds the value of the Tag so the client can read and write to the Tag value 4 8 3 2 Counter A count value is incremented from 1 to 1000 When the counter reaches 1000 the value is reset to O and the counter restarts 4 8 3 3 Sine Wave A sine wave value is generated and written to the Tag value The Min Max and Period values of the Sine wave can be defined for each Tag 4 8 3 4 Triangle Wave A triangle wave value is generated and written to the Tag value The Min Max and Period values of the wave can be defined for each Tag 4 8 3 5 Square Wave A square wave value is generated and written to the Tag value The Min Max and Period values of the Sine wave can be defined for each Tag 4 8 4 Browsing Project from HMISimulator In the HM Simulator users have the option to select a project using the browse button in the toolbar Users can select any project file already created E HMISimulator Figure 39 4 9 Transferring the Project to Target The Designer project can be transferred to the Designer Server Target system using the Download to Target item in the Run Menu NOTE The project can be transferred to the device via Ethernet or via USB drive In case the project is downloaded to the unit via Ethernet the panel must have a valid IP address assigned
174. records each containing information on the actions executed and the user that did them The Audit Trail can be enabled with or without user management So it can access and Supervise all actions from all users and a normal user could not stop or change this 14 1 Enable or Disable the Audit Trail In the Project View pane right click on the Audit Trail and click either enable or disable the Audit Trail recording on Runtime The padlock symbol in the tree informs you that in the project the Audit Trail is enabled or disabled When the Audit Trail is enabled the padlock symbol is shown locked otherwise it stays open PrajectView 1 x FA ops Project ig Projectl i J J Pages ae 1 Pagel Eee Config El Protocols p Events Buffer gt p o ise SCheduler ky MultiLanguage bs Security 3 see fo UserGroups i i Users Enable Fal my clit Ia Recipes e Dictionaries ya DialogPages ate m Page Templates Figure 200 14 2 Configure Audit Events You can have more than one set of Audit Records To add to the Audit files you need to configure the Events buffer Double click the Events buffer from the project workspace Next add the events buffer and set the file size and then select the log type Audit Here there is an option for selecting the storage where the dumped Audit files have to be stored There are three options Flash USBMemory SD Card For SD Card and USBMemory a
175. rmissions click the browse button on the Authorization Setting column The Admin Authorizations dialog will open giving you access to tabs for the different available options 13 3 1 Widget Permissions The following figure shows the dialog where you can change the widgets permissions admin authorizatio 5 fa PageMLTextMarWat ES Alarms History ERTI Page3 if _PageMLTextMarWat CESA TrendWgt2 dS BinStd2 ES Binstd3 iey Pagei _PageMLTextgrWat E i ActiveAlarms H 4 BinStd Figure 188 For the widget the possible options are e Full Access e Read Only e Hide Widget Ticks Schedule TrendWindow EqitBox AnalogVideo Message BarGraph Shape ListBox Labels TrendCurve ComboBox Needle Label Grid When you click on Base settings the right part of the dialog shows the permissions that will be valid as default and at the project level admin authorizatio m fj Base 5E tings i G a Page2 ete Pages E i Pagel G 93 TemplatePage1 Widget Ticks Schedule TrendWindow EditBox AnalogVideo Message BarGraph ListBox Labels Permission Full Access Full Access Full Access Full Access Full Access Full Access Full Access Full Access Full Access Full Access TrendCurve Full Access ComboBox Full Access Full Access Full Access Full Access Full Access Full Access ae i Figure 189 The widgets security settings can be changed not only globally but a
176. ro Properties Show Message ShowMessage Tag Actions Data Transfer message Italian Pop up message ToggleBit WriteTag Step Tag EnterCFGMode EnterOPMode SaveContiguration ControlUserLED Cancel Figure 172 11 3 Export and Import of Multi language Strings The easiest way to translate a project into multiple languages is to use the Export feature exporting all text to a file The translation can be done in that document then using the Import feature bring all text for all languages back into the project The Multi language strings will be exported in CSV file format then you can modify the strings with an external editor and import it back to the Designer Studio The CSV file exported by Designer is coded in Unicode To edit it you need a specific tool that supports CSV files encoded in Unicode format To export the Multi language strings open the Multi language editor and switch to Text view Then click the Export button and save the CSV file You can then modify the exported CSV file and Import back to Designer Click the Save button to save the text NOTE It is recommended that you set all languages that will be used in the project before exporting the file This will guarantee that the exported file will contain all columns and language definitions for that project Page Widgetid TemplatePagel labell text Label TemplatePagel label2 text Label Label TemplatePagel label text
177. s 52 4 11 2 Internet Explorer Settings ccssscccsssscccssscccessscccessscceesesceeesess 52 4 11 3 Security Setting for Trusted Site ZONE s eessseessseessseeessecessecesseeesses 53 4 11 4 Install Active X on Internet ExplOrer cccccsseccesssccesssccesscceeeseeees 55 Le V1 IM SANUS ACUI CO Jarecuoceas os eee eine h eaaese ces aE 56 4 116 ActiveX INFOPMAUON svestvivies heinecciscissesiiaeeecininiesds intestines hanced 56 Basic Programming Concepts in D SIQNEL scccssccesscesscesscesscescceeseeeses 57 56 Ata EO snctantuscersesboavsnnivenensdisanahaviGopnedasteawisblseitsed decctucleszidsbeasieeives 57 5 2 EVENS caet E E N E 61 System Variable S cyrri oni nenen E TA A E 63 6 1 A e E E E 63 Oe COMMUNICATION wssccste2eca cece dcicctsasexadenctuaveletaiiuisedeaaestsaneateenncttedssuans 64 6 3 Days nl Savin MME sesepi iener ain eE E ETEO 66 DA DOV Oe cincetare can wahtactteetauassseacin vias den antect teens aera ae tumsaeeaes 67 65 DUMP AWTON MALO wedeadseeuttevsiscrscivtaaeteuchetoncdebattedscancsed situ etevdbstoseietents 69 6 6 NEIWOK rnei A T TE E 70 r PANIE A A E mene ae eee eS 70 CO E Dd Os r N Sne oe ee NE eee See 72 Geo TE becieashusteeses T cents 73 O MUS EDIN Cs ccomscea suatacoseurtaesas das eieunsneesoatt ersaucusoen con iaeiaomuecseasieesiereae 73 Gli UserManasement assisa ennn a R 74 Works WINACHONS sosar ausieten bes bta tial Gte hess eta en alas 76 TEV 1 WAGES CL ACLION Sisccccsicov
178. s CE operating system Version 6 R3 The operating system and all its options are built around the minimum set of requirements of the HMI runtime there is no option to get direct access to the Operating system settings as all the needed components are managed via the runtime itself or via Designer Later in this document you will find more information on how to install the HMI runtime and how to manage the update of other system components firmware on the units but always with a dedicated interface which prevents a direct access to the operating system often a source of complexity Runtime Modes The HMI runtime is composed of two logic units one is called server the other one is called client The server unit is responsible for handling the HMI services such as running the communication protocols performing data acquisition driving trend buffer sampling activities monitoring alarms and so on The client unit is the part which is responsible for the visualization process using the data collected at the server side to render it on the display as graphical information The server unit of the HMI runtime can be in one of two operating modes Configuration Mode and Operation Mode Configuration Mode the server is idle activity has not started for example no project is loaded on the panel or system files are missing Operation Mode the server is active it is operating according to the settings defined by the syst
179. s an int of R W type Flash Free Space Returns the free space left in the device internal flash System Font List List of system fonts The variable is a read only string System Mode Returns a value informing the operation status of the runtime the possible values are 1 Booting 2 Configuration mode 3 Operating mode 4 Restart 5 Shutdown System UpTime Returns the total time in hours in which the system has been powered since production of the unit It is a read only variable Touch Buzzer Allows you to enable disable the touch audible feedback It can have values O disabled or 1 enabled 6 5 Dump Information These variables return information about the status of the copy process to external drives USB or SD Card for trend and archive buffers field Lvalue XForms Source Tag System Widget Recipe Tag Battery LED gt Alarms gt Communication gt Daylight Saving Time Dump Information Dump Archive Status Dump Trend Status gt Printing gt SD Card Read Only Read Write Write Only TagIndex o Figure 74 Dump Trend Status Returns value 1 during the copy process of the trend buffers If the copy duration time is less than one second the system variable does not change its value Dump Archive Status Returns value 1 during the copy process of the archive buffers If the copy duration time is less than one second the system variable does not change its va
180. s to the global Variable Widget as shown in the following figure File Edit Run Format View Window Help SG AD Langi Properties _VariablesWat _PageMgr Figure 240 17 4 1 Using Variables in JavaScript The Variables can be also referenced in JavaScript programs with the following syntax For Local Variables var varWet page getWidget _VariablesWet var compVar varWet getProperty VariableName For Global Variables var varWet project getWidget _VariablesWet var compVar varWet getProperty VariableName 17 5 Media Player Widget The Media Player Widgets are available under Media Player in the Media category of the widget gallery Media Media Player Figure 241 The widget can be used to play videos from a playlist The video files can be stored on the Flash a USB memory stick or an SD Card There are two available widgets The first one is without the multimedia frame so it just plays the video without any user control The second widget includes a multimedia frame where you can find buttons to play and stop the video To use the widget just drag and drop it onto a project page The widget properties are shown in the following figure Properties Ad aH agl MediaPlayer Media Play List Loop Style NoLoop Figure 242 The Media Player widget properties are Media Player List allows you to create a playlist by selecting the video files to be available to the widget Loop Styl
181. scribed in a dedicated chapter 8 3 Setting Events This chapter describes how to set Events in the Alarm Configuration Editor 8 3 1 Log Events Select the Log tab in the dialog box as shown in figure The list below this represents a set of conditions for which you may want to store the specific event in the Alarm History Buffer Click the check boxes corresponding to the application requirements Set here the alarm status transitions that has to be logged in the event buffer When entering the triggered status When entering the not trigqgered status Both when entering the triggered and not tiggered status When the alarm is acknowledged When the alarm is reset When the alarm is disabled E When the alarm is enabled Figure 136 The Alarm Events History can be accessed by logging in a dedicated buffer called Event Buffer to configure the Event Buffer double click on Buffers in the Configuration Editor as shown in the figure below Here there is an Option of Selecting the storage type There are three Options Flash USBMemory and SD Card For SD Card and USBMemory a specific path must be provided where the files have to be stored NOTE An external USB drive is referenced by the operating system as USBMemory an SD card as Storage Card ProjectView aX 1 Pagel protocols AuditTrail Events Buffer x AuditTrail01 ig AuditTrail01 e Pages E 1 Pagel E 2 Page
182. sessesssesess 109 P81 SCUPANSWASC sicsece reese spo ssdeccecteccwseeisscess Ae ek OS 109 F 2D RECIE ACTIONS iore E 110 791 DOWMOACRECIDG Sixccvsssceedsacondses nus E O E 110 F 9D WOIOAGRCCIDES mierea EE S 111 7 9 3 WriteCurrentRecipeSet sscccsscccssccnssccnssccnssccnssccsscessscenescens 112 AIA DowmMmoadCUrRECIDO cesano eana E E N 113 95 Upload CUOLRECID EG crire a a a T Stee heen 114 79 6 RESORECIDE coerente E E inenorasaeatnnteedeanoeeenens 115 RIT DUMPRCCIDCD AN sacecs niswscaveoscucnspinwialseavereds as enneurpeievennaieaceaennceceaasis 116 7 923 RESLOLTERECIDED Ole wceccrsncencesasiatencsnsaudsiashurtecswacudssasoateacerersesasuanteess 117 7 10 User Management Actions cccsccsscosscosccesccesccsceesccescesceesceescees 118 AIOT OS O Wlscasscckssmavetlcaee sada veshasecca a ea ateieecaesaees 118 FO SWAG USC roen TE EE E T ceceat sites TE 119 71 0 3 RESE tPA SWOT d a a T O 121 PAOA AN TOU E E EI E EN E T ee ere 121 TA Foo a BE E E gene EN TE E E AA EA OET EE E 122 Fe OSG EUU SOT oae A 123 7 10 7 DeleteUMDynamicFile ccccssccssssccesssccsscceesccessccesscceeeseceeess 124 FAQS EXPOMUSCIS aeai E TN ace seerseteeiees 124 FLO 9 WIM DOW SEIS 224 cwaleecesvevect an ceranevabiatiavcusiaecs ante ntawonesancvapaecnavanereaceeas 125 ALE IW CIAVACTIONS sieatetetiesicesiin iodciedbiceinsiadeitedeeactes doi dieateacdavslaresednoas 126 7 slid Pla MCG Na issisuseavsaievas EEEE EAA EEEE 127 7 AV SOD MCC deanna ee
183. sic concepts behind the HMI system architecture Please read the chapter Runtime Modes to become familiar with the HMI software architecture first If you select Server as Time Spec the widget will show the time information as handled by the server side of the HMI system If you select Global as Time spec it will show the Global Time GMT If you select Local as Time Spec it will show the Local Time in the Widget the time of the target where the project is running Please see the chapter Time zone options for Client for additional information on how to interpret the time information when running the project on a remote client Properties 1x DateTime Value 2106 02 07711 58 Datalink System Time _SysPre Number Forma MM DD YY hh mm s OnDataUpdate lite 7 3 m Display global 12 29 11 11 24 29 a Figure 230 17 2 RSS Feed Widget The RSS Really Simple Syndication Feed widget allows you to display on the screen your favorite RSS feeds directly from the Internet The widget is available in the Widget Gallery When placed on the page the widget looks as shown in the figure below E Title 99 99 EEEE ENEE AE EET SA ENE EEE E NT i Feed Description l 100 lm i i l i l l l l d E M Ja Figure 231 The RSS Feed widget main properties are RSS Source allows you to specify the feed URL UpdateRate allows you
184. ss to the System Settings tool can be activated with a tap tap sequence over the touchscreen during the power up phase Tap tap consists of a high frequency sequence of touch activations done by the simple means of finger tapping the touchscreen performed during the power up and started immediately after the device has been powered 21 1 1 List of Upgradable Components The HMI panels support the upgrade of the following components System Supervisor Firmware of the system supervisor controller sample file name packaged_GekkoZigBee_v4 13 bin NOTE IMPORTANT The System Supervisor Component can be upgraded only if the actual version on the panel is V4 13 or above Version V4 08 V4 09 V4 10 and V4 11 MUST NOT be updated they do not support automatic update from System Settings Main FPGA FPGA firmware sample file name 4146xaf02r06 bin Safe FPGA back up copy of the Main FPGA that ensures unit booting in case of main FPGA corruption may be after failed update Sample file name 4146xaf02r06 bin NOTE When updating FPGA firmware on the panel the same file must be used for Main and Safe FPGA components Bootloader Loader to handle panel start up sample file name redboot_UN20HS010025 bin Main OS Main Operating System sample file name mainos_UN20HS0160M0237 bin Configuration OS Back up operating system that ensures units are recovering in case of main operating system corruption may be after a failed update sample
185. supervisor firmware used for the RTC and power supply handling NOTE The System Settings tool also includes other options not all options are described and documented at this time IMPORTANT Operation with the System Settings Tool is critical and when not performed correctly may cause product damages requiring service of the product Ask Technical Support for further details When executed in System Mode the System settings also provide the BSP Settings Only when recalled from the System Mode the BSP settings show an additional tab called Password as shown in the figure below Next Info Mame UNO F BSP intossettings BSP Settinc Old password Hew password Confirm password 7 Metwork Figure 257 This function allows you to protect access to the System Settings in System mode with a password so all the advanced and critical functions are not easily accessible to anyone To activate the protection simply mark the check box Password Protected and specify the desired password as shown in the figure The password must be at least 5 characters long If you are changing a password previously defined or disabling the protection you are asked to provide the old password first NOTE Please keep a note of the configured password in a safe place There is no way to reset the password protection and in case it is lost the unit must be returned to the
186. t hand side of the window you will find the Project View and Object View as a Sliding tab Project View presents the project files in the form of a hierarchical Project Tree Object View lists the Widgets with the corresponding ID s used in the page The center area is the main working space and is where editors create the HMI display pages and configure the project s various features The current page or pages opened in the Editor View are indicated by a tab at the top of the center area You can quickly switch between the different pages in the Editor View by clicking on the desired tab The right part of the window shows the properties for the selected object and on the very right side the Widget Gallery can be found as a slide in pane The Widget Gallery provides a large library of symbols and graphic objects When an object is selected the object visual settings can be changed by editing the various properties in the Property View Vewdth 6 40 Heaght 460 Bkod Color 255 255 255 Tempata mone a Events p Everts Buffer Pe Scheduler gt Multilanguage Security i Properties Pane A DialegPages E Page Templates Project Tree Ready Figure 16 NOTE The Studio workspace layout can be freely changed at any time any change is saved and maintained among Studio activations In case you need to reset the workspace to the original default layout use the command called Reset and Restart
187. te project getTag Tag1 state 1 fnTagReady function fnfagReady tagName tagState if tagName Tag1 var myValue tagState getValue setTag number setTag tagName tagValue index forceWrite Sets the given Tag in the project Name and value are in a String Parameters tagName A string of the tag name tasValue An object containing the value to write index An index if tag is array type Set 1 to pass complete array Default is O forceWrite A boolean value for enabling force write of tags the function will wait for the value to be written before it returns back Default is false Return value Interger value for denoting success and failure of action when forceWrite is true A 0 means success and 1 means failure If forceWrite is false returned value will be undefined var val 1 2 3 4 5 var status project setTag Tag1 val 1 true if Status 0 Success pelse Failure var val value project setTag Tag1 val getRecipeltem object getRecipeltem recipeName recipeSet recipeElement Gets the value of the given recipe set element Parameters recipeName A string representing the recipe name recipeSet A string representing the recipe set can be either the recipe set name or O based set index recipeElementA string representing the recipe Element can be either the element name or O based element index Return value An object with the value of the recipe
188. th the following syntax AlarmBufferReader AlarmBuffer1 FILE AlarmBuffer1 csv Where AlarmBuffer1 is the name of the dumped dat file without extension and AlarmBuffer1 csv is the desired output file name Action List Action Lit P A W W DumpE vent rchivel Event Actions a Macro Properties ScrollEvents Backward DumpEventArchive z SorallEvents Forward EventArchive AuditTrail FolderPath USBMemory DumpContigFile false Delete Trend AE anes Dump EventArchive DatetimePrefxedF true Delete EventArchive timeSpec Global ResetProtoEnCount SafelyRemoveMedia i CopyCodesys Project Recipe Actions DownLoadRecipe UpLoadRecipe Dump Trend Figure 111 The utility called AuditTrailBufferReader exe is available for Audit Trail buffers NOTE The action must to be configured with the option DumpConfigFile set to true The result of the dump is a directory structure similar to the one generated for Events The conversion tool can be called from the command line according to the following syntax AuditTrailBufferReader AuditTrail FILE AuditTrail csv Where AuditTrail is the name of the dumped buffer without extension and AuditTrail1 csv is the desired output file name 7 7 6 ResetProtoErrCount The ResetProtoErrCount macro is used to reset the Protocol Error Count System Variable See the chapter System Variables for further information about system variables 7 7 7 DeleteEvent
189. ther the control list will be just an indicator or a combination of both For example witha machine in Manual mode the Control list will let the operator select which state should be active and while in Auto mode the list is an indication of the active step 17 4 Variables Widget The Variables widget is available in the Advanced category under the Data Sources sub category as shown in the following figure Widget Gallery variables Figure 237 The purpose of the Variables widget is to have some internal variables that can be used for operations such as data transfer or use in JavaScript programs The variables are local to the page where the widget has been inserted To insert the widget in a page just drag and drop it to any position on the page This will display a placeholder to indicate that the widget is present but it will not be visible at runtime You can create some variables and assign values as shown in the following figure Figure 238 The configured Variables can be referenced from the Attach tag dialog once you click on the Widget source as shown in the following figure Source Tag System Widget Recipe Tag bo BtndtdS 4 Variables Wt Variablel Variable Variables gt _MultiLangMgr ReadOnly Read Write Write Only TagIndex o Figure 239 In case global variables are needed they can be configured from the project widget adding the desired variable
190. tically check for the update package on the root of the USB drive and ask to proceed with the update according to the following figure HMI Update Wizard 1 2 OK Please wait examining system Available updates usBMemory 7 Auto select best match Components that will be updated Project Files Font files gt System Files Figure 48 Mark the Auto select best match check box and click the Next button The rest is automatically done by the system NOTE The Update Package can also be used to update the panel s runtime For this please see the chapter Updating Runtime from USB Pen Drive 4 9 1 When Target Flash Memory is Low While trying to download a project to the Target if the project size is almost near or greater than the free space available in the flash memory then it s not possible to download the project directly The difference between the project size and available free memory should be at least 2MB Target device doest not hawe enough free memory A Do you want to delete some unloaded projects Manage Target Figure 49 While clicking Download a warning message will pop up mentioning that the Target memory is low and whether you need to delete some projects as in the figure given above Soon after you click Manage Target the Manage Target window will open showing all the available projects in the Target Deleting the unwanted projects from the target cre
191. tions The section describes how to configure security settings in the Designer Studio NOTE To enable or disable the user management feature right click on the Security folder in the Project View and set Enable or Disable See the following figure as a reference 5 a ecu _ od Usel Enable a ft Users Figure 186 13 2 Configuring Groups and Authorizations Open UserGroups to configure in the ProjectView roject2 Authorized Home Page Use Last Visited Fage Comments Authorization Settings a Project admi true Fage Admin gt Pages guest true Pagel Guest guestAuth _ E 1 Pagel unauthorized false Unauthorized unauthorzedAuth Config a El Protocols a Tags H HT Trends Figure 187 New User groups can be added by clicking the Button Three predefined groups are available by anh these groups cannot be deleted and their names cannot be changed Predefined group authorizations and comment fields can instead be changed according to the application s requirements For each group of users you can assign a Home Page This means that whenever a user from this User Group is logging in the selected Home Page for that group will appear There is one additional option called Use Last Visited Page If enabled and a user logs in the page visited by the previous user will be displayed 13 3 Modifying the Access Permission of Groups To modify and assign the pe
192. to specify the refresh time Properties are shown in the figure below NOTE Feeds sources are fixed and cannot be changed at runtime Properties Tx itr Sd ef l E RSS Feed z RSS Source http rss cnn comyrss cnn_topstor http Tss cenn com rss enn_topstoies http sports espn go com espn T38 NEWS http feeds newsweek com newsweek TopNews http articles moneycentral msn com Feeds R5957 Figure 232 NOTE The RSS Feed widget is specifically designed to work on units where the Internet Explorer browser Pocket Internet Explorer is part of the operating system 17 3 Control List Widget Control List widget is a convenient way to represent the status associated with a particular process but also a way to control that process from the same widget The Control List widget is available in the Widget Gallery There are two types of control lists One is a control list group in which the up and down buttons are present on the control list itself The state can be selected with the up and down buttons The other type of control list has no pre configured buttons in the group In that case the state can be selected by pressing on the screen v Properties ax w xar aeaee Eh jee e P Font Arial bB JABIE S E Vokie State 4 Selection 4 Write Mode Write On Select State 0 State 0 Read Only false State 1 State 1 List Data State 0 State 1 State 2 State 3 Sta Stata 9 OnDataUpdate St
193. trait mode and they still appear as horizontal Click Finish to complete the Wizard Once the HMI model is chosen you can convert the project to any other model using the project properties portion of the screen as shown below This will not resize all widgets in the project to the correct size to fit a smaller or larger screen it will simply change the model type and give a warning if some objects will be lost during the conversion E Fike Edit Run Format View Window Help Bl A hd a S OBL ei Langl eB Bede gets BS ya te Aal o Moneda i StH ss J Peete sail S rT a o opad ie a x L Fagel Pra cit Promerbes px ip Hee bese Ea pe nan Eg Projecti Lith arty Ba gr ProjecthiiTestiMigr _PLOMgr Taghigr 9 Trendidge Dictiomaryhlgr _ Alarm fl Testhigr T Pear Ful Path DAHM Projects Pag ES a Cee EF g9 Ha Mineri Config Ly Cy H ik Ly Verski 2 Protocols Alarmsiagr JBventMgr Schedule Tedhig ScheduleMge _IdlalMigr AuditTrailkige _UserGrouphige tes Enagle User Ms false Tags ais Benawor fa Trends iy Home Page Pagel jmi A Alans _Vanabiles iegyt PageWidth eon F Events Buffer SysProphigr _KeypadMigr Te Scheduler MU Larmequege SS MultiLanguag by Secunty dp Userdroups z al Users SmcOption disable p AuditTirail EI AuditTrail Figure 15 4 2 Workspace The Designer Studio workspace is divided into three main areas On the lef
194. u to add a description of the tag R W This option determines if the tag must be managed as Read only R Write only W or Read Write R W Active As explained above tags are grouped per page and if needed in users groups By default tags are not active this means they are automatically activated by the runtime when the visualization requires them You can force the system to continuously read a certain tag even if not present in the current page by setting its Active property to true An example is if you need to embed a tag within an email message sent by the panel We recommend that you leave this parameter at false to avoid unexpected results in terms of overall device performance Simulator Designer Studio provides off line simulation The behavior of each tag during simulation mode can be specified here by choosing between several profiles as shown in the figure below Simulator Details Data Simulator META Variables Counter Sine Wave Triangle Wave Square Wave ro al LILI os i i aaa ok Cancel Figure 22 Scaling Tag values are normally transferred as they are from the protocol to the real time tag database You can specifically apply scaling to the tag values before they are stored in the database The available scaling options are shown in the figure below Scaling can be specified in terms of linear relationship as a formula or as range conversion Tag scaling By formula Tag
195. ual Widget Gallery eessseesseesseessseesseesseesseessscesseesseess 195 15 3 PAM EV CNS cees awed soeincaceasebaneaoeatauiducnanssasewtuianwsaeaasaoa teense 196 154 PrinterconniearatiOnNc saia A T 199 15 5 SUpPPOred PrintEi Scien E A N 200 15 6 Minimum requirements sc xsiteversoisesenstoweveuspaneveannseeweuspavascacraneredenaets 201 KeyPad eenaa aa e eee 202 16 1 Creating and Using Custom Keypads eeseesseesseesssesesessesseeseeeseesse 203 16 2 Deleting or Renaming Custom Keypads cccsssccesscceesceesceeeecs 206 PEVATI CLG ena a r S 207 V7 Dae Vie WIGS E onea E ATA 207 172 Roofecd Widi elaine a AA 208 V7 COnTOLLISEWida Elana a eed i 209 U7 Bel Sal E E AE E A E AE E A A EA E T 210 1732 Selec O iera EE TE EE TE ETTE A 212 I7 NEON SE lE C oinn a 212 UZ Dole NV EGS ONEN O sasara be ausdes Gusiscalusatonadeaeeniateereubace ators 212 W735 REA GO MY ennaa a ot heed Geren esas 212 174 Vatia bles WIGS Cl asete n cca cccatavesen uae ctoacuse dean daeticeah teeta oescaseacbeewtees 213 V7 AA USING VatlaDleS in JavaSript sasesieevaceitabdaswias r aa 215 M75 Medo Player WIGS Torana a E E OE 215 18 19 20 21 22 17 5 1 Using Media Player in JavaScript ccscccsseccceseccesssccesecceesecceeess 217 Working with Custom WIGEeTtS cecccseccsscccsscccnscccnsceeescesescesscceescseuss 219 18 1 Creating a CUSTOM WIdGEL ccc ceecceeecceseccessccensceeesceeesceeesceeecss 219 18 2
196. umbers If True the password should contain at least one numeric digit 13 5 Default User You can program a Default User for a project When the system starts or reboots the Runtime is logged in with the default user All the privilege settings of the default user will be activated in the system If you want to log in as a different user in Runtime you can use either the Switch User macro or the Log Off macro The default user will automatically get logged in if any user other than default user logs off 13 6 Assigning Widget Permissions from Page View You can assign different levels of security to different user groups on a single widget directly from the project pages Select the widget then right click and select security settings from the context menu Next choose the group and assign the security properties to access the widget as shown in the figure Copy Paste Delete Group Ungroup Convert to group Custom Properties Order Align Space Size Rotate Select Covered Attach To E admin quest unauthorized UserGroupl UserGroup UserGroups Expand all Figure 196 Authorizations 4 SRN Action Permission ak image 1 NextPac lke Base EIE T binstdo1 extPage se Base Settings LoadPage Use Base Settings NextPage Use Base Settings Use Base Settings il Figure 197 13 7 Operation on Runtime After starting the Runtime if a default us
197. ume Trend Alarm Actions Cancel Figure 105 7 5 14 ScrollTrendCursor The ScrollTrendCursor macro allows the user to scroll the Trend Cursor in forward or reverse time direction The Y Cursor value will display the Trend value at the point of the cursor The scrolling percentage can be set at 1 or 10 The percentage is calculated based on the Trend window duration Action List Action List A W W ScrollTrendCursor Scroll Percente Scroll Percentage Cursor scroll length in Figure 106 7 6 Alarm Actions Alarm Actions are macros used to acknowledge or reset the alarms The actions listed here can be used to build a custom Widget for the alarm display you can observe an example of how these are used in the default Alarm Widget available in the Widget gallery RPE Action List P A Y Hews Pause Trend a Macro Properties Resume Trend Scroll TrendCursor Seroll Trend To Time Alarm Actions Select All Alarms Figure 107 7 6 1 SelectAllAlarms This macro allows you to select all the Alarms in the Alarm Widget 7 6 2 AckAlarm The AckAlarm macro allows for acknowledging the selected Alarms 7 6 3 ResetAlarm The ResetAlarm macro allows you to reset the selected acknowledged Alarms 7 6 4 EnableAlarms The EnableAlarms macro is used in c
198. undefined is returned if invalid If of type array an array object type is returned var value project getRecipeltem recipeName Set Element setRecipeltem number setRecipeltem recipeName recipeSet recipeElement value Gets the value of the given recipe set element Parameters recipeName A string representing the recipe name recipeSet A string representing the recipe set can be either the recipe set name or O based set index recipeElementA string representing the recipe Element can be either the element name or O based element index value An object containing the value to store in the recipe It can be an array type too Return value Interger value for denoting success and failure of action A 0 means success and 1 means failure var val 2 3 4 project setRecipeltem recipeName Set Element val if Status 0 Success pelse Failure downloadRecipe void downloadRecipe recipeName recipeSet Downloads the recipe set to corresponding tag Parameters recipeName A string representing the recipe name recipeSet A string representing the recipe set can be either the recipe set name or O based set index project downloadRecipe recipeName Set uploadRecipe void uploadRecipe recipeName recipeSet Uploads the value of tags into the provided recipe set Parameters recipeName A string representing the recipe name recipeSet A string representing the recipe s
199. ure 248 19 4 Sending Live Tag Data through E mail You can send live tag data to the recipients within the email body In e mail info select the tags you want to send from the Tag1 Tag2 Tag3 dialog boxes In the email body use the keyword TagIndex to display the tag data The Tag information that follows the symbol represents the index of the tag as per the configuration made In the example below the Temperature tag has index 2 to insert the value of the Temperature tag in the mail message body use the 2 syntax An example is shown in the figure below Email info Test Message from HMI Tag 2 Tag 3 Tora Temperature 2 Speed 1 Torque 03 Figure 249 A maximum number of 3 tags are supported in each e mail message body 20 Working with JavaScript The purpose of this chapter is to describe the JavaScript interface implemented in Designer Designer JavaScript is based on the ECMAScript programming language http www ecmascript org as defined in standard ECMA 262 Microsoft Chakra and Firefox SpiderMonkey JavaScript engines support the ECMAScript standard If you are familiar with JavaScript you can use the same type of commands in Designer as you do in a web browser If you are not familiar with the ECMAScript language there are several existing tutorials and books that cover this subject such as http doc trolltech com 4 7 ecmascript html https de
200. ut with the flexibility to select only the necessary properties to be published and made available in the custom widget Property pane 18 1 Creating a Custom Widget The following steps describe how to create a custom widget 1 Select all the Widgets you want as part of the custom Widget and group them 2 Right click on the group and select Convert To Widget from the context menu A Convert to Widget dialog box is shown below Convert To Widget _ Switch Propert Knob Slider AnalogClock AnalogClock with DayDate Bargraph Alarm Wgt P Rotation Menu Pound GAC OLUTION n Custom Security settings Attach To Expand all Figure 243 You can select existing custom widget types such as Knobs Button With Light etc or you can select Custom to create a new custom widget type 18 2 Adding the Properties After creating the custom widget the next step is to add the properties that will be published in the custom widget property pane The Property Select dialog shows all the applicable properties for the grouped widget this is basically a list of all the properties of the individual widgets grouped together You can select the properties that you want to expose for that custom widget by clicking the corresponding check box Name GroupWot4 Property Values Properties A W Display Name Property Select Attribute Nam Select the Property Names E Linear Scale 1
201. value Source value p Enable Limits Figure 23 The tag name must be always unique at the project level often it may happen that the same tags from the same symbol file have to be used for two different controllers Since having tags with the same name is not supported you can use the Alias feature to automatically add a prefix to the imported tag to make them unique at the project level When importing tags for a Protocol the tag names may be prefixed by the name given in the Alias item of the protocol configuration dialog box Please note that not all protocols support the Alias feature See protocol documentation for specific information 4 4 2 Designer Data Types When creating a tag Designer shows a dialog box in which you need to specify the tag properties The tag Memory Types are specific to the selected Protocol Modbus TCP Memory Type Offset een 400001 Data Type Arraysize unsignedShort 0 Figure 24 The tag Data Type must be selected from the list of available Designer Data Types according to the internal representation you need for the selected controller address Designer Data Types are summarized in the following table Character strings The characters are coded in UTF 8 format Boolean is one bit data float Float corresponds to the IEEE single precision 32 bit floating point type Double corresponds to IEEE double precision 64 bit floating double point type
202. veloper mozilla org en JavaScript This purpose of this document is not to explain JavaScript language but rather to describe how JavaScript is used in the HMlIce Application 20 1 Execution A JavaScript function is executed when an event occurs For example a user can define a script for the OnMousePress event and the JavaScript script will be executed when the button is pressed on the panel It is important to note that JavaScript functions are not executed in the same manner as certain other controller programming scripts such as Ladder Logic JavaScript functions are not executed at a given scan rate the whole time but they are only executed when the given event occurs This approach minimizes the overhead required to execute logic on the panel Designer provides a JavaScript engine running at the client side Each project page can contain scripts with scope local to the page where they are programmed The project can also contain global scripts that can be executed by scheduler events or alarm events but it is important to understand that the scripts are still executed at the client side In other words having more than one client connected to the panel for instance an external PC running the Windows Client means each client will run the same script providing output results that depend on the input Inputs provided to the different clients may be different This can be clarified for instance considering a situation in which the s
203. w The Display Category allows you to view by category group by clicking on either the Collapse or Expand button For example you can declare position properties like the X coordinate height width properties in a single display category called Position Description Allows you to define the description and comments within the property the information will be displayed in the property pane Advanced The properties are shown in either the Normal or Advanced mode The Advanced check box allows you to specify whether each property should appear in the advanced or in the simple property pane view mode Support Tags The Supports Tags checkbox must be marked if the property supports the Attach to attribute Tags The Tags list box indicates the internal Tag name for the Widget This internal Tag name is typically the same as the attribute name however this is not always the case You can assign a different attribute name for your custom Widget The Tag list is also used to combine Tags If you want to combine two or more properties into one select the primary property in the Property List and click on the button above the Tags list box The Property Select dialog will be displayed and you can select the properties that should be combined Note that this dialog box only shows the properties that should be combined not all properties are shown in the Properties list For example to combine the min property
204. where PDF reports Disk quota are stored Graphic job queue size of the available graphic jobs in the printing RAM quota The maximum size in bytes of the RAM used to generate reports A string representing the status of the printing system The Status Aa possible values are idle error paused and printing Text job queue size The number of the available text jobs in the printing queue 6 8 SD Card The variables in this category return information about the external SD Card plugged into the panel They are 64 bit variables except the drive name which is a String All the variables are read only field Lvalue SOUrce Tag System Widget Recipe Tag Battery LED gt Monitor and DVI Switch Settings gt Network gt PLC SD Card SD Card FreeSpace SD Card Name SD Card Size SD Card Status P Time gt USB Drive gt User Management ReadOnly Read AWwrite Write Only TagIndex o Figure 77 SD Card FreeSpace_ Size in bytes of the available space SD Card Name Name of the SD card SD Card Size Size in bytes of the card plugged in the slot SD Card Status Status of the SD card 6 9 Time field Lvalue Source Tag System Widget Day Of Month Day Of Week Hour Minute Month Second System Time Year P USE Drive gt User Management ReadOnly Read Write Write Only TagIndex Q Figure 78 The variables in this category return information about the System Ti
205. y match the project file will be opened normally if they do not match Designer shows a warning message to inform that the project has been created with a different version of Designer and report this version ID if it is available in jpr In this case Designer will offer two options to convert the project e Convert and open the project from current path The project will be converted without a backup copy of the original version e Convert and save the project to a new location and Open The older version is maintained as a backup copy Warning Select a new location before converting the project Project Name Locaton Convert Cancel Figure 7 1 4 Designer Package The Designer Studio contains the following package as part of the installation Designer Studio Designer Studio is an application for designing custom HMI projects in a user friendly manner along with a variety of options in its built in library the Widget Gallery Windows Client Designer Client is a light weight application that can be used on Windows computers to remotely view and manage an application running on an HMI HMice Application The Runtime is a standalone application that runs on the CPDX HMI The Studio allows for the update of the run time on the Target devices 2 The HMI runtime The HMI runtime is designed to support different platforms and different operating systems All the panels are running today on the base of the Window

JMobile Suite User Manual

Contents

Download Pdf Manuals

Related Search

Related Contents