Panasonic HMWIN User Manual
Panasonic HMWIN User Manual

Panasonic HMWIN User Manual

Touch
Hide thumbs Also See for HMWIN:
Table of Contents

Advertisement

Quick Links

TOUCH TERMINALS
HMWIN
User Manual

Advertisement

Table of Contents
loading

Summary of Contents for Panasonic HMWIN

  • Page 1 TOUCH TERMINALS HMWIN User Manual...
  • Page 2 Copyright  2014 Panasonic Electric Works Europe AG Subject to change without notice The information contained in this document is provided for informational purposes only. While efforts were made to verify the accuracy of the information contained in this documentation, it is provided “as is”...
  • Page 3: Table Of Contents

    1.2.2 Installation ......................12 1.2.3 Licensing ......................12 1.2.4 Installing Multiple Versions of HMWIN Studio on the Same Computer ..... 14 1.2.5 Opening Projects Created with Older Version of HMWIN Studio ...... 15 1.2.6 Multilanguage for HMWIN Studio ..............15 1.2.7...
  • Page 4 StopMedia ......................84 9.2.3 ReloadMedia ...................... 84 9.2.4 PauseMedia ....................... 84 9.2.5 BrowseMedia ..................... 84 Keyboard Actions....................84 9.3.1 SendKey ......................85 9.3.2 SendKeyWidget ....................85 9.3.3 ShowKeyPad ..................... 87 9.3.4 KeyboardMacros....................87 Page Actions ...................... 88 ACGM0195V1EN HMWIN Studio User Manual...
  • Page 5 9.10.3 DumpTrend ...................... 100 9.10.4 DeleteTrend ..................... 103 9.10.5 DumpEventArchive ..................103 9.10.6 DeleteEventArchive ..................105 9.10.7 ResetProtoErrCount ..................105 9.10.8 SafelyRemoveMedia ..................105 9.10.9 CopyCodesysProject ..................106 9.11 Recipe Actions ....................107 9.11.1 DownLoadRecipe .................... 107 ACGM0195V1EN HMWIN Studio User Manual...
  • Page 6 9.13.4 PausePrinting ....................121 9.13.5 ResumePrinting ....................121 9.13.6 AbortPrinting ....................121 Using HMWIN Client ..................... 122 10.1 The HMWIN Client toolbar ................122 10.2 Settings &Time Zone Options ................122 10.3 Workspace ....................... 123 Using the Integrated FTP Server .................. 124 Using ActiveX Client for Internet Explorer ..............
  • Page 7 21.2 HighResolution ....................180 21.3 Recurrence Scheduler ..................181 21.4 Configuring Location in HMWIN Studio ............182 21.5 Configuring the Schedule Interface for Runtime Interaction ......184 21.6 Schedule the Events during Runtime .............. 184 User Management and Passwords ................186 22.1...
  • Page 8 30.1.1 Autofill tag names .................... 228 30.2 Using Indexed Addressing mode in pages ............228 Special Widgets ......................230 31.1 Date Time Widget .................... 230 31.2 RSS Feed Widget .................... 231 31.3 Control List Widget ..................232 ACGM0195V1EN HMWIN Studio User Manual...
  • Page 9 35.3.1 Using the Online Simulator ................287 35.4 Downloading the HM4Web Project ..............288 35.4.1 Running HM4Web from a Browser ..............289 35.5 HM4Web Connectivity Notes ................290 35.5.1 Server Disconnect ................... 290 35.5.2 Inactivity Timeout ..................... 291 ACGM0195V1EN HMWIN Studio User Manual...
  • Page 10 Updating System Components in HMI Panels ............. 305 38.1 List of Upgradable Components ..............305 38.2 Update of System Components from HMWIN Studio ........306 38.3 Update of the System Components via USB Flash Drive ....... 308 Access Protection to HMI Devices ................309 39.1...
  • Page 11: Getting Started

    1 Getting Started The HMWIN Studio is a software application used to create graphical HMI pages. The HMWIN 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 HMWIN Studio.
  • Page 12: Installation

    7. The installation procedure will create a program group called HMWIN Studio in the Start menu. A HMWIN Studio icon can be added to the desktop. Figure 2 Figure 3 After installing the HMWIN Studio, you can run the application by using the desktop icon or from Start > All programs > HMWIN Studio. 1.2.3 Licensing HMWIN Studio is available with a friendly 30 days free trial policy.
  • Page 13  C:\Users\[username]\AppData\Roaming\Panasonic\ Licenses are locked to the BIOS ID or to the Windows product ID of the PC where HMWIN Studio is installed If HMWIN Studio is not able to reach the server (for example because no Internet connection is available), a new button appears;...
  • Page 14: Installing Multiple Versions Of Hmwin Studio On The Same Computer

    3. System with multiple instances of HMWIN Studio already installed The installer detects that one or more installations of HMWIN Studio are present and it will ask if you want to replace the last installed instance with the new one or if you want to install another instance (Figure 5).
  • Page 15: Opening Projects Created With Older Version Of Hmwin Studio

    ID stored in the jpr file and its version ID; if they match, the project will be opened normally; if they do not match, HMWIN Studio shows a warning message to inform that the project has been created with a different version of HMWIN Studio and report this version ID if it is available in jpr.
  • Page 16 Crash reports are disabled in Windows XP OS NOTE ACGM0195V1EN HMWIN Studio User Manual...
  • Page 17: The Hmi Runtime

    Operating system settings as all the needed components are managed via the runtime itself or via HMWIN Studio. 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.
  • Page 18: Other Context Menu Options

    2.3 Other Context Menu Options The context menu has several other options: Zoom In/Out/100% Select view at runtime. Pan Mode Enables/disables pan mode; works only when you have previously activated a zoom in. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 19 Please note that projects can be deleted only after they are unloaded. If you click on a project name other than the active one, the option "Load project" will first unload the running application and then automatically activate the new one. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 20 Figure 17 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. Developer tools ACGM0195V1EN HMWIN Studio User Manual...
  • Page 21: Built-In Sntp Service

    Starting from WCE v1.76 ARM / 2.79 MIPS is possible to customize up to two SNTP servers from NOTE System Mode (MainOS) accessible via Context Menu -> System Settings -> Time -> SNTP tab. This setting is not available in Configuration Mode (ConfigOS). ACGM0195V1EN HMWIN Studio User Manual...
  • Page 22: My First Project

    HMWIN Studio projects are stored in a folder that has the same name as the project. This folder contains all the files of the project. To move, copy or backup a project, you can simply move or copy the project folder and all its contents to the desired location.
  • Page 23 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. Figure 19 ACGM0195V1EN HMWIN Studio User Manual...
  • Page 24: The Workspace

    3.2 The Workspace The HMWIN Studio workspace is divided into following main areas: Project View Presents the elements of theprojec in the form of a hierarchical Project Tree. Lists the Widgets with the corresponding ID’s used in the page. Object View Working Area Main working space where editors create the HMI pages.
  • Page 25: Communication Protocols

    Figure 22 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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 26: Tags

    3.4 Tags HMWIN Studio 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).
  • Page 27 Figure 25 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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 28: Tag Editor

    3.4.1 Tag Editor The tool in HMWIN Studio 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.
  • Page 29: Data Types

    3.4.2 Data Types When creating a tag, HMWIN Studio shows a dialog box in which you need to specify the tag properties. The tag Memory Types are specific to the selected Protocol. The tag Data Type must be selected from the list of available HMWIN Studio Data Types, according to the internal representation you need for the selected controller address.
  • Page 30: Dictionaries

    Dictionaries folder in ProjectView list all files imported in the tag editor for each protocol. Selecting a particular protocol, it is possible to delete or look at the imported dictionary files for the related protocol. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 31: Designing A Page

    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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 32: Importing A Page

    “Import Page”. Please refer to the Figure below. Figure 28 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. Figure 29 ACGM0195V1EN HMWIN Studio User Manual...
  • Page 33: Dialog

    Runtime Position can be used to specify a fixed position for the dialog window. 3.6 The 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). ACGM0195V1EN HMWIN Studio User Manual...
  • Page 34 Click on a category to display 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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 35 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. Style change may not be available for all widgets. NOTE ACGM0195V1EN HMWIN Studio User Manual...
  • Page 36 To select a sub widget like the label in a button, use ObjectView or Shift + leftClick of mouse. In this way sub widget can be changed without ungroup all widget. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 37: Attach To" And Dynamic Properties

    Figure 34 3.7 “Attach To” and Dynamic Properties HMWIN Studio 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.
  • Page 38 Property view and clicking on the Attach To or you can right-click on the object and select the Attach To… menu item. A chapter in this document describes in detail the “Attach to” concept. NOTE ACGM0195V1EN HMWIN Studio User Manual...
  • Page 39: The Hmi Simulator

    Simulator or by using the Exit option from the Context Menu. 4.3 Simulator Settings The Simulator can be used with real protocols & PLCs (Ethernet or RS-232 based protocols) or with simulated protocols. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 40 (Win32) and, for these protocols, this option remains disabled. Usually all protocols based on ETH or RS-232 can be simulated in win32 platform or in general all protocols that do not require special hardware. Figure 40 ACGM0195V1EN HMWIN Studio User Manual...
  • Page 41 Min, Max and Period values of the wave can be defined for each Tag. 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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 42: Transferring The Project To Target

    2. using an Update Package via USB 5.1 Download to Target Run -> Download to Target can be used to transfer project and runtime via Ethernet from the HMWIN Studio to the runtime. The panel must have a valid IP address assigned. Please see the chapter “Unit Basic...
  • Page 43 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 HMWIN Studio, click on the Run > Manage Target, and then click on Target Setup on the dialog.
  • Page 44 In the download dialog, click on Advanced Menu and set the port. Figure 44 ACGM0195V1EN HMWIN Studio User Manual...
  • Page 45: Update Package

    By pressing Cancel, the dialog will close, and the download operation is aborted. The automatic check for available space for project download is a feature present from HMWIN NOTE Studio and runtime version 1.80.
  • Page 46 7) Mark the “Auto select best match” check box and click the “Next” button. The rest is automatically done by the system. It is always recommended to create update packages with both flags Project and HMI IMPORTANT Runtime checked. Use latest runtime with old project not converted with HMWIN Studio can originate stability problems. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 47: The Runtime Loader

    Project Project opened in HMWIN Studio is added to the update package. HMI Runtime & HMI Runtime is added to the update package. If a project is open in Plug-In HMWIN Studio, also required plugins will be added to update package.
  • Page 48 The Runtime Loader is a feature dependent on the device Operating System and may not be NOTE available on all the units. The description provided in this chapter assumes that you are using HMWIN Studio V1.80 or later. 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.
  • Page 49: Upload Projects

    5.4 Upload Projects You can retrieve a project from a target device using the command “Upload Project”. A copy of the project is transferred from runtime to the computer running HMWIN Studio. To upload a project proceed as follows: 1. Run -> Manage Target 2.
  • Page 50 Once upload has completed, a copy of project is available in: C:\Users\username\Documents\HMWIN Studio\workspace\Uploaded\RuntimeIPAddress\workspace\ProjectName Starting from HMWIN Studio v1.90 (build 608) upload is no longer based on User Management for access protection but is protected by a dedicated password scheme. Please refer to...
  • Page 51: Programming Concepts

    6 Programming Concepts The programming guidelines for HMWIN Studio are based on a few basic concepts, which are common in many parts of the system. 6.1 Attach to In HMWIN Studio the basic programming techniques are used to configure the properties of an object placed on a page.
  • Page 52 Linear scaling can be configured when selecting the "Scale" tab 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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 53 Allows extracting a single bit or byte content from a word depending on the specified bit or byte number. Example of transformation: scaling (100/10*value + 5 ), byteIndex(0), bitIndex(1) , equivalent to: bitIndex ( byteIndex (100/10*value+5,0) , 1) ACGM0195V1EN HMWIN Studio User Manual...
  • Page 54: Events

    Figure 58 6.2 Events In a HMWIN Studio application, Events are the way to trigger Actions at the application level. Main types of Events:  Events related to buttons / touch (Click, Press, Release, Release)  Events related to external input devices like keyboards & mouse (Click, Press, Hold, Release, Wheel) ...
  • Page 55: Onclick / Onmouseclick

    Default Hold time is configured in project properties but can be redefined for each button/key. When a value -1 is specified as Hold time for a certain button, the project default value will be used. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 56: Autorepeat

    Autorepeat It is possible to enable autorepeat for Press event or for Hold event of a button/key. Autorepeat Time is specified in Project properties but can be redefined for each button/key. Figure 62 Figure 63 ACGM0195V1EN HMWIN Studio User Manual...
  • Page 57: Onwheel

    OnDataUpdate event, since OnDataUpdate notifications are sent asynchronously. 6.3 Widgets positioning: Snap to Grid / Snap to Objects To help user in precise widgets positioning two editing options options are available in HMWIN Studio: Snap to Grid Snap to Object “Snap to”...
  • Page 58: Z-Order Of Widgets

    Z-ordering of widgets is essential for performances since overlapping dynamic widgets can invalidate static optimization and reduce performance of hmi applications. In HMWIN Studio a new toolbar is available to help user understand widgets overlapping. The toolbar allows Enable visual filtering: hide widgets stacked above and/or below selected widgets (using the two buttons available in toolbar).
  • Page 59: Change Properties Of Several Widgets At Once

    For widgets of the same type (ex. two or more labels, two or more fields, two or more gauges etc) the user can change common properties in few steps using HMWIN Studio. To change multiple properties of widgets proceed as follow:...
  • Page 60: Project Properties / Project Widget

    7 Project Properties / Project Widget Project properties contain settings for the project. Project properties are available from Project View. The Properties window on right side of the HMWIN Studio contains the list of project level user-configurable data. Figure 67 7.1 Version...
  • Page 61: Developer Tools

    Developer tools are a collection of utilities useful for debugging problems at runtime. To use developer tools proceed as follow: 1) set to true Project properties ->Developer tools in HMWIN Studio 2) Download the project to the target 3) Open context menu...
  • Page 62: Profiling

    Using this option of the developer tools, it is possible to check time spent for loading/rendering the active page. Profiling will be available from the next page load and only for the first painting of the page to the screen (please note that the configuration is retained). ACGM0195V1EN HMWIN Studio User Manual...
  • Page 63: Watchdog

    (example: memory available, CPU load, events queue size etc). ACGM0195V1EN HMWIN Studio User Manual...
  • Page 64: Buzzer On Touch / Buzzer Duration

    For UN20 target (WCE MIPS hmi panels), local debugger has been disabled. However, remote NOTE debugger is available to debug JS from a PC connected to HMI panel via Ethernet. Remote debugger not supported in HMWIN Client and ActiveX. NOTE ACGM0195V1EN...
  • Page 65: Allow Js Remote Debugger

    Not all Software Plug-in modules are compatible with all targets. New software plug-in modules will be added in the future to extend optional features of the product. Once enabled, a Software Plug-in is considered as part of the runtime. You can use HMWIN Studio to install it in the target using one of the following procedures: ...
  • Page 66: Behaviour -> Home Page

    HMI to switch to a specific page. These properties can be used to synchronize pages showed on the HMI and HMWIN Client or to control an HMI with a PLC. Double click on project name present into ProjectView pane to open the project properties page:...
  • Page 67 CurrentPage This property represents the page number actually displayed on the HMI or on HMWIN Client or on both. Attached Tag must be available at least as a Write resource and must have data type that allows containing an integer value.
  • Page 68 Tag "B" as Read/Write SyncOptions Local Changing value of "A", HMI and HMWIN Client will show page requested. On "B" will be written page currently showed by HMI. Example 3 Force page change from PLC to HMI and HMWIN Client. Read current page loaded on HMWIN Client.
  • Page 69: Behavior -> Hold Time / Autorepeat Time

    Changing value of "A", HMI and HMWIN Client will show page requested. Changing page on HMI same page will be forced on HMWIN Client. Example 5 Force page change from PLC to HMI and HMWIN Client. HMI page Synchronization with HMWIN Client (not vice-versa).
  • Page 70: System Variables

    Variables return information on the actual number of alarms according to the status. Total number of alarms “Not Triggered Acknowledged” Not Triggered Acknowledged Total number of alarms “Not Triggered Not Acknowledged” Not Triggered Not Acknowledged ACGM0195V1EN HMWIN Studio User Manual...
  • Page 71: Communication

    (range of the variable is [0 - 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 = 0) ACGM0195V1EN HMWIN Studio User Manual...
  • Page 72: Device

    Returns the free available RAM memory in bytes; it is a 64 bit data; it is a Memory 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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 73 2: Buzzer blink (on and off times programmed by System Variables Buzzer On and Off) Buzzer Off Time duration in milliseconds of off time when blink has been selected minimum value: 100 maximum value: 5000 default value: 1000 ACGM0195V1EN HMWIN Studio User Manual...
  • Page 74: Dump Information

    Variables return informations about the status of CODESYS 2.3 integrated in HMI panels. PLC Status Status of Integrated Codesys 2.3. 0 = RUN 1 = STOP 2 = RELOAD_FROM_FILE 3 = RESET_WARM 4 = RESET_COLD ACGM0195V1EN HMWIN Studio User Manual...
  • Page 75: Printing

    Text job queue The number of the available text jobs in the printing queue. size 8.10 Screen Variables return information on the screen status. Time remaining to Return time remaining to unlock screen (ref. LockScreen action) unlock ACGM0195V1EN HMWIN Studio User Manual...
  • Page 76: Sd Card

    This is actually the UTC time which also is available as date/time from the other variables. Day Of Month Day of the month (1..31) Day of Week Day of the week (0=Sunday, .. , 6=Saturday) Hour Hour (0..23) Minute Minute (0..59) ACGM0195V1EN HMWIN Studio User Manual...
  • Page 77: Usb Drive

    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 HMWIN Client scope. Local and remote clients connected to the same "server" (same runtime) get a unique ID returned by this variable.
  • Page 78 ACGM0195V1EN HMWIN Studio User Manual...
  • Page 79: Actions

    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 as follows: false to hide and true to show widget. Figure 77 ACGM0195V1EN HMWIN Studio User Manual...
  • Page 80: Triggeripcamera

    The SlideWidget macro allows you to show the sliding effect of a Widget, or of a Widget group, in HMI Runtime. The widget or grouped widget can actually be outside of the page in the project and slide in and out NOTE of view. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 81: Refreshevent

    9.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 Alarms History Widget.). ACGM0195V1EN HMWIN Studio User Manual...
  • Page 82: Contextmenu

    ReplaceMedia macro is used at runtime to replace/update existing Media files of a project with new files provided via USB/SD or any other external device. Usually this macro is used to update project Images, Video or Music. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 83: Media Actions

    ReplaceMedia Macro is working in WCE and Win32 OS. When ReplaceMedia is executed in remote using HMWIN Client or via ActiveX, files are searched on HMI local storages. ReplaceMedia macro for Video & Music has been design to work in combination with MediaPlayer widget.
  • Page 84: Playmedia

    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. 9.3 Keyboard Actions The Keyboard macro actions include Send Key and Send Key Widget. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 85: Sendkey

    Figure 85 9.3.2 SendKeyWidget The SendKeyWidget macro is used to enter the predefined character or function for a specific Widget. To use the macro, define the Widget ID and the key code in the Macro Properties. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 86 Here Up and Down buttons have been implemented using the SendKeyWidget macro. See the figure below for reference. Figure 86 To use the SendKey macro, you must define the keypad type as “Macro" in the Numeric Widget NOTE properties. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 87: Showkeypad

    You can also enable/disable macro execution related to keyboard studio side at the project level and at the level of the single page. A dedicated property is available in the project property sheet and in the page property sheet. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 88: Page Actions

    The Page Actions macros are available for Alarms, Schedulers and Mouse Release Events. 9.4.1 LoadPage The LoadPage macro allows you to load the selected page of the project when the macro is executed. Figure 89 ACGM0195V1EN HMWIN Studio User Manual...
  • Page 89: Homepage

    The LastVisited page macro allows you to load the page previously displayed on HMI Runtime. 9.4.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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 90: Closedialog

    The CloseDialog macro is applicable only to Dialog pages. The Close Dialog macro allows you to close the dialog page currently displayed. 9.4.8 ShowMessage The ShowMessage macro allows you to display warning message popup when the macro is executed. Type the message that you wish to have displayed while executing the macro. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 91: Launchapplication

    Examples of path could be: \USBMemory (for USB devices in WCE) \Storage Card (for SD devices in WCE) This macro is supported only in hmi panels based on WCE OS. NOTE ACGM0195V1EN HMWIN Studio User Manual...
  • Page 92: Lockscreen

    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 “0” The BitIndex property allows you to select the bit position inside the Tag. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 93: Writetag

    The ScrollLeftTrend macro is used to scroll the Trend window to the left side, by one-tenth (1/10) of the page duration. With the Real-Time trend it is recommended pausing the trend using the macro PauseTrend, NOTE otherwise the window is continuously shifted to the current value. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 94: Scroll Right Trend

    9.7.11 ResumeTrend 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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 95: Show Trend Cursor

    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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 96: 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. Figure 94 ACGM0195V1EN HMWIN Studio User Manual...
  • Page 97: Consumptionmeterpagescroll

    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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 98: Selectallalarms

    The EnableAlarms macro is used in conjunction 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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 99: Event Actions

    The System Actions macro allows you to use the system properties in Runtime. 9.10.1 Restart The Restart system macro allows you to restart Runtime. After executing the macro, the Runtime goes to configuration mode and restart.. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 100: Controluserled

    Editor” for further information about the policy used to save sampled data to disk. The external drives plugged on the USB port of the panel must have format FAT or FAT32. NTFS NOTE format is not supported. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 101 2012-10-11T05:13:43.724-07:00 Global 2012-10-11T12:13:43.724Z The software tool required to convert the dump files to CSV are available in the HMWIN Studio NOTE folder called “Utils” under the directory where the software is installed. The tool needed to convert trend buffers is called “TrendBufferReader.exe".
  • Page 102 For example, the tag in question has been deleted from the configuration file (tags.xml). This quality may reflect that no value is available at this time, for reasons such as the value may have not been provided by the data source. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 103: Deletetrend

    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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 104 .\data\ AlarmBuffer1.dat AlarmBuffer1.inf AlarmBufferReader.exe The utility is distributed in HMWIN Studio in the folder Panasonic\HMWIN\Utils. NOTE The AlarmBufferReader can be called from command line with 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.
  • Page 105: Deleteeventarchive

    If you unplug an SD Card or a USB drive from the HMI while it is transferring or saving information, you risk losing some information. This macro provides a way to help you safely remove such devices. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 106: Copycodesysproject

    In this case files needed from hmi running CODESYS project are following: - DEFAULT.CHK - DEFAULT.PRG - BOOT.SDB Using System variables PLC -> PLC Status and PLC -> Get CopyCodesysProject Action Status the status of PLC and of CopyCodesysProject action can be verified. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 107: Recipe Actions

    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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 108: 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. Figure 104 ACGM0195V1EN HMWIN Studio User Manual...
  • Page 109: Downloadcurrecipe

    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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 110: 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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 111: Dumprecipedata

    Recipe files. Recipes to restore can be in any external storage like USB, SD or network paths. The external drives plugged on the USB port of the panel must have format FAT or FAT32. NTFS NOTE format is not supported. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 112: User Management Actions

    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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 113: Switchuser

    SwitchUser macro, the 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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 114 Figure 111 Click on the “Back" button to go back to the previously logged-in user. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 115: Resetpassword

    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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 116: Deleteuser

    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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 117: Editusers

    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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 118: 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, originally downloaded from HMWIN Studio. No Macro Properties are required. 9.12.8 ExportUsers The ExportUsers macro allows exporting user details to an xml file (usermgnt_user.xml).
  • Page 119: Importusers

    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). The external drives plugged in the USB port of the panel must have format FAT or FAT32. NTFS NOTE format is not supported. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 120: Print Actions

    Figure 118 9.13 Print Actions Figure 119 ACGM0195V1EN HMWIN Studio User Manual...
  • Page 121: Printgraphicreport

    The ResumePrinting macro allows you to start the queue if previously it was put on hold. 9.13.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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 122: Using Hmwin Client

    HMI to switchto a specific page. These properties can be used to synchronize pages showed on the HMI and HMWIN Client or to control an HMI with a PLC. Please refer toSyncOptionsfor more details. If any of the project files downloaded fromHMWIN Studio to the hmi panel change for any reason...
  • Page 123: Workspace

    This feature requires you to set the HMI RTC with the correct time zone and DST (Daylight Savings NOTE Time) options. 10.3 Workspace Using HMWIN Client, project files will be uploaded from panel and placed into a cache directory. Cache folder where project are temporary stored is under:  %appdata%\Panasonic\[build number]\client\cache where [build number] is a folder named as build number like 01.90.00.608.
  • Page 124: Using The Integrated Ftp Server

    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. Figure 121 Additional information can be found later in this document in the chapter titled “FTP Authorizations”. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 125: Using Activex Client For Internet Explorer

    12 Using ActiveX Client for Internet Explorer In the standard distribution of HMWIN Studio, a HMWIN Client and an ActiveX Client is provided. ActiveX components are NOT installed by default to the Target devices, in order to save space in the flash memory.
  • Page 126: Security Setting For Trusted Site Zone

    Figure 122 12.4 Security Setting for Trusted Site Zone Set your Internet Explorer Browser as seen in the following images: ACGM0195V1EN HMWIN Studio User Manual...
  • Page 127 Figure 123 Figure 124 ACGM0195V1EN HMWIN Studio User Manual...
  • Page 128: Install Active X In Internet Explorer

    In Internet Explorer, allow the installation of the ActiveX component when the question pops up in your browser. Figure 126 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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 129: 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\Panasonic\HMIClientAX 12.7 ActiveX information The ActiveX is able to show projects at a maximum pixel resolution of 1200 x 800. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 130: Using Vnc For Remote Access

    The VNC server uses port 5900/TCP. NOTE The Password of VNC server is null as default. Password can be changed via VNC viewer NOTE or with an external usb keyboard attach to the hmi panel. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 131: Vnc Viewer

    Drag and Drop of Windows is not supported yet by VNC server. NOTE 13.2 VNC Viewer A VNC viewer is not provided as part of HMWIN Studio. However, many types of VNC viewers are freely available. One example of compatible VNC viewer is TightVNC. ACGM0195V1EN...
  • Page 132: Alarms

    An Event can trigger the closing and reopening of the Alarm window. Please note that, in HMWIN Studio, 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.
  • Page 133 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). ACGM0195V1EN HMWIN Studio User Manual...
  • Page 134 “Live Data in Alarm Description” for further information about this feature. Color Foreground and Background colors of alarm rows (Active alarms widget) can be applied based on the status of alarm (ex. Triggered, Triggered Ack etc). ACGM0195V1EN HMWIN Studio User Manual...
  • Page 135: 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. Figure 132 14.3 Setting Events This chapter describes how to set Events in the Alarm Configuration Editor. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 136: Log Events

    The Alarm Events History can be accessed by logging in a dedicated buffer called “Event Buffer"; to configure the Event Buffer, you have to double -click on “Buffers" in the Configuration Editor (as shown in the figure below). Here there is an Option for Selecting the storage type. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 137: Notify

    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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 138: Actions

    Figure 136 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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 139: Active Alarms Widget

    Figure 138 To customize a filter proceed as follow: 1) Select Active Alarms widget 2) Into the property pane select one of the two filters availables: Filter -> (Filter Column 1 | Filter Column 2) ACGM0195V1EN HMWIN Studio User Manual...
  • Page 140 10 < Value < 20 Value ^(1[0-9]$) 20 <= Value Value ^([2-9].$) <100 100 < Value < Value ^(1[0-9][0-9]$) Value 2?/3?/4?/5? Value ^([2-9].*$) Value >= 100 Value ^([1-9][0-9][0-9].*$) Value >= 20 Value ^([2-9].*$|[1-9][0-9][0-9].*$) Figure 139 ACGM0195V1EN HMWIN Studio User Manual...
  • Page 141: Sorting

    Severity column takes the values from the Severity settings from the Alarm Editor. 14.5 Alarms History Widget HMWIN Studio 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 can use Alarms History Widget.
  • Page 142: Managing 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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 143: Live Data In Alarms 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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 144: Exporting Alarm Buffers As Csv File

    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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 145: Recipes

    Currently, the Recipe data is configured in the HMWIN Studio 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.
  • Page 146 Recipes configuration files are created automatically when the project is saved. Recipes files WARNING are saved into the subfolder data of the project folder into the PC by HMWIN Studio. When external storages are used, please copy this folder into the external storage selected. Default path is “/Storage Card/data” for SD or “/USBMemory/data”...
  • Page 147: Configuring Recipe Sets On The Page

    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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 148: 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 Function Description Set modified Current selected set changed. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 149: Configuring Recipe Widget For Runtime Execution

    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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 150: Upload Or Download Recipes During Runtime

    (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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 151: Backup And Restore Of Recipes Data

    15.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 the actions “Dump Recipe “Restore Recipe Data” for further information. Data“and ACGM0195V1EN HMWIN Studio User Manual...
  • Page 152: Trends

    Trend window. Page Duration 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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 153: History Trend

    At that moment a new scroll is automatically done and the process repeats. Automatic refresh is an option available starting from version 1.80. NOTE Figure 156 ACGM0195V1EN HMWIN Studio User Manual...
  • Page 154: Trend Editor

    Specifies if the trend runs by default when the system starts up. The trend buffers cannot be activated during Runtime NOTE Source This combo list allows selecting the Tag which is sampled by the Trend manager system. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 155: Configuring Trend Window For History Trends

    From the trend gallery page, drag and drop the “History Trend" widget to the page. Figure 158 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). ACGM0195V1EN HMWIN Studio User Manual...
  • Page 156: Trend Window Properties

    X Axis time, Y Axis value, number of trend curves, changes to the labels, grids, number of samples, etc. 16.3.1 Request Samples (Advanced View) In the “Curve x” category there is one property called “Request Samples” as shown in the figure below. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 157: Color Bands

    Select multiple cells and click on a color band to assign color to that range of time. Color Bands feature is working just using Local Time in trend viewer (not Global). NOTE Figure 161 Figure 162 ACGM0195V1EN HMWIN Studio User Manual...
  • Page 158: Trend Cursor

    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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 159: Exporting Trend Buffer Data To Csv File

    The Widget tag shown in the figure above represents the X axis cursor value for the trend window. 16.5 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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 160: Scatter Diagram / Xy Graph

    When the array tags change, is possible to force a refresh using the dedicated macro RefreshTrend. The ScatterDiagram is considered as a different type of Trend Widget. However only the NOTE RefreshTrend macro is supported for it. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 161: Data Transfers

    Data Transfer settings can be imported and exported in .csv format. This feature can be Export effectively used whenever it is more convenient to perform changes directly in the .csv file and then reimport the modified file. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 162: Data Transfer Fields

    Low limit is less or equal to zero. NOTE Below an example where: High limit=1,9 Low limit=- 0,9 • = points where the data transfer is triggered ACGM0195V1EN HMWIN Studio User Manual...
  • Page 163: Exporting Data To .Csv Files

    The OnTrigger method allows only unidirectional transfers, (A->B or B->A)  The OnUpdate method allows changing the values in accordance with the direction settings only when the source value changes.  HMWIN Studio is not a supervisory system. Its performance depends on: ACGM0195V1EN HMWIN Studio User Manual...
  • Page 164 OnTrigger system is monitoring just trigger tag and not all tags to transfer.  Using tags of type array allows server engine to optimize data transfer and reduce workload.  Too many Data Transfers can introduce side effects on page change time and on boot time. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 165: Offline Node Management

    (ORT). If the device answers to the poll, the system declares it online and starts polling it at regular intervals. The following schema shows the three polling attempts and the recovery procedure that starts when the Offline Retry Time is elapsed: Figure 170 ACGM0195V1EN HMWIN Studio User Manual...
  • Page 166: Manual Offline Node Management Process

    2. Associate an event to the button (for example OnMouseRelease) Figure 171 3. Click on the event row, click the '+' button and select Add action 4. Add the Tag Action EnableNode to the event (Tag Action -> EnableNode). ACGM0195V1EN HMWIN Studio User Manual...
  • Page 167 WARNING: all disabled device nodes will remain disabled if the same project is downloaded on the panel, on the other hand, if a different project is downloaded, all disabled devices will be re-enabled. The same happens on package update. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 168: Automatic Offline Nodedetection

    In the table set the Offline Retry Time parameter: the device on this node ID will be polled with this frequency when offline. Figure 174 19.5 Offline Management Toolbar buttons Advanced properties It shows/hides the advanced properties columns. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 169: Offline Management Fields

    Enable Offline Enable the Offline Management for the protocol Algorithm Offline Retry Time Interval, expressed in seconds, between when the node was disregarded and when the recovery procedure started. Max value for ORT is 86400sec (24h). ACGM0195V1EN HMWIN Studio User Manual...
  • Page 170: Multi-Language

    HMWIN Studio has features that allow users to provide strings for each of the languages. When in edit mode, HMWIN Studio provides support to change the display language from a language combo box. This helps users see the page look and feel at design time.
  • Page 171: Add A Language To Project

    Writing system and 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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 172: Language Display Combo

    However, it is recommended that you use the export and import features, as described in the chapter “Export and Import of Multilanguage Strings”. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 173: Multi-Language For Message Widget

    Figure 178 20.2.2 Multi-Language for Message Widget HMWIN Studio 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.
  • Page 174: Multi-Language For Alarm Messages

    20.2.3 Multi-Language for Alarm Messages HMWIN Studio 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...
  • Page 175: Export And Import Of Multi-Language Strings

    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 HMWIN Studio. The CSV file exported by HMWIN Studio is coded in Unicode. To edit it, you need a specific tool that supports CSV files encoded in Unicode format.
  • Page 176 Figure 183 The feature Import supports two formats (Figure 184):  Comma Separated Values (.csv)  Unicode Text (.txt) ACGM0195V1EN HMWIN Studio User Manual...
  • Page 177: Change Languages At Runtime

    LangID is the language index corresponding to the language ID, as it can be read from the Language Configuration Editor. After languages are changed at runtime with the macro execution, the current language is saved and NOTE retained for the next run. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 178: Limitations In Unicode Support

    20.5 Limitations in UNICODE support HMWIN Studio has been designed for working with UNICODE text. However, for compatibility reasons with all platforms, UNICODE is supported only in a subset of field types. Area Field Charset Accepted Reserved Chars/Strings Protocol Editor Alias ASCII [32..126]...
  • Page 179: Scheduler

    21 Scheduler HMWIN Studio 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: 1.
  • Page 180: Highresolution

    NOTE 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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 181: Recurrence Scheduler

    Monthly The Monthly Schedules allow you to execute a set of actions on a Monthly basis, by specifying the day in which the actions have to be executed. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 182: Configuring Location In Hmwin Studio

    21.4 Configuring Location in HMWIN Studio In HMWIN 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 system automatically calculates the sunrise and sunset time.
  • Page 183 The condition combo will list only the Tag attached to the Boolean data type. NOTE 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. Figure 190 ACGM0195V1EN HMWIN Studio User Manual...
  • Page 184: Configuring The Schedule Interface For Runtime Interaction

    Interaction”), then you can schedule the event, and modify this schedule, during Runtime on the for Run-time 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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 185 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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 186: User Management And Passwords

    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. Figure 193 ACGM0195V1EN HMWIN Studio User Manual...
  • Page 187: Configuring Security Options

    22.1 Configuring Security Options The section describes how to configure security settings in the HMWIN Studio. To enable/disable the user management feature, right click on the “Security" folder in the Project NOTE View and set Enable or Disable. See the following figure as a reference.
  • Page 188: Widget Permissions

    For the widget, the possible options are:  Full-Access,  Read-Only  Hide 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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 189 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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 190: Action Permissions

    Access limits is used to allow or restrict access to particular files and folders into the workspace. Based on Force Remote Login flag default workspace access change and as conseguence using Access limits is possible to open or close access to specific resources. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 191: 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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 192: Access Priority

    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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 193: Configuring Users

    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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 194: Assigning Widget Permissions From

    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). Figure 202 ACGM0195V1EN HMWIN Studio User Manual...
  • Page 195: Operation On Runtime

    To remove dynamic files and changes applied to user’s configuration during runtime there’re two ways:  Runtime side: DeleteUMDynamicFile action  HMWIN Studio side: Delete Dynamic Files flag available in download dialog. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 196 Figure 204 Figure 205 ACGM0195V1EN HMWIN Studio User Manual...
  • Page 197: Force Remote Login

    22.8 Force Remote Login Starting from v1.9 of HMWIN Studio, a new flag is available to force user to LogIn when using remote access (via Activex or HMWIN Client), this is working when user management is enabled. If Force Remote Login is not enable remote access will use same level of protection of local access.
  • Page 198: Audit Trails

    23 Audit Trails HMWIN Studio 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.
  • Page 199: Configure Tags In The Audit Trail

    23.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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 200: Configure Alarms In The Audit Trail

    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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 201: Configure Login Or Logout Details In Audit Trail

    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. Figure 211 23.6 Viewing Audit Trails in Runtime The Audit Trail data cannot be displayed in Runtime. It is only available in the exported data file. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 202: Exporting Audit Trail As Csv File

    23.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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 203: Reports

    24 Reports A report is a collection of information that will be printed when triggered by an event. The HMWIN Studio programming software provides an editor to configure reports, their content, the printer and the trigger conditions. The report comes as a special collection of pages with header, footer and body, including options for cover page.
  • Page 204: Graphic Report

    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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 205: Page Body

    HP PCL 3, HP PCL printers compatible with HP PCL3/PCL5e/PCL3GUI, including models 5e, HP PCL3GUI many DeskJet, LaserJet, DesignJet Epson ESC/P2 printers compatible with ESC/P2, LQ Epson Stylus printers compatible with Epson Stylus Color Color ACGM0195V1EN HMWIN Studio User Manual...
  • Page 206: Printer Tested

    Epson LX-300+II HP PCL 3 HP LaserJet P2015dm Simulate HP LaserJet 4700dtn HP PCL 3 GUI HP Deskjet 1010 HP Deskjet D5560 HP LaserJet 4700dtn HP PCL 5e HP LaserJet P2015dm Simulate HP LaserJet 4700dtn ACGM0195V1EN HMWIN Studio User Manual...
  • Page 207: Print Events

    A Graphic report printing can be started also using the dedicated action call PrintGraphicReport. The Silent option (true by default in action settings) allows, when set to false, a dialog to pop-up at runtime asking the user to adjust printer settings as shown in figure. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 208: Minimum Requirements

    Figure 214 24.5 Minimum requirements Report printing requires operating system (BSP) V1.54 or above for Windows CE devices. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 209: Screen Saver

    Mouse move  External keyboard key pressed Screen saver configuration is available in HMWIN Studio in Config -> Screen Saver section. Figure 215 To configure screen saver as slideshow, proceed as follow: 1. Right click on Screen Saver from the project tree and click Enable 2.
  • Page 210 In Tab onStart actions can be configured to execute when the screensaver start, in Tab onStop actions will execute when the screensaver stops. The Screen saver is supported by WCE & Win32 runtime. Is possible to use screensaver also in HMWIN Client & ActiveX clients.
  • Page 211: Backup/Restore

    .zip file with backup. Figure 217 Backup files can be saved in all available storages like USB, SD card, network folders etc. Backup is available in WCE only platform. It is not supported in Win32 / HMWIN Client. NOTE ACGM0195V1EN...
  • Page 212 Backup package can be restored from a formatted HMI panel using Transfer from disk option in the BSP Loader menu. Just select backup file and the system will automatically check the package to confirm its compatibility with the current platform and install it. Figure 218 ACGM0195V1EN HMWIN Studio User Manual...
  • Page 213: 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 219 Figure 220 Figure 221 ACGM0195V1EN HMWIN Studio User Manual...
  • Page 214: Creating And Using Custom Keypads

    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: ACGM0195V1EN HMWIN Studio User Manual...
  • Page 215 You can use the widgets available from the Keypad Widgets gallery (as shown in the picture below) to create the custom keypad. Figure 225 A sample custom-created keypad is shown below. Newly created keypads will be saved in the project folder. Figure 226 ACGM0195V1EN HMWIN Studio User Manual...
  • Page 216: Deleting Or Renaming Custom Keypads

    Figure 228 27.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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 217: Keypad Type

    All keys are enabled. Entering 1A keypad return back value 1A that will Ascii be display as 1 if the attached field is numeric, as 1A if the attached field is ASCII or as 1A if the attached field is hexadecimal. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 218: Keypad Position

    Figure 230 27.4 Keypad Position Runtime Positioning property of keypads can be used in HMWIN Studio to define where keypads will appear in the screen. The following options are available: Automatic: runtime will show keypads in the best position based on widget position where data entry is required.
  • Page 219: External Keyboards

    The code of the key Enable The individual enable status of the key Defines whether the key is inheriting the action programmed at the Inherits project actions project level The table shows the possible configurations: ACGM0195V1EN HMWIN Studio User Manual...
  • Page 220: Search And Filter

    Keyboard Editor will list only the keys whose Label contains the text you have entered. Figure 232 Alternatively, if Filter by has been set to key code only the Keys contains the text in their Code column will appear in the list. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 221: Shows

    A confirmation dialog will appear to request confirmation of the requested command. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 222: Keyboard Layout

    28.5 Enable Keyboard You can enable/disable keyboard actions both at the project level and at the page level. A dedicated property is available in the project property sheet and in the page property sheet. Figure 235 ACGM0195V1EN HMWIN Studio User Manual...
  • Page 223: Configure Macro Actions For Keys

    To configure actions for keys in the Keyboard Editor just click on + on the key you want to program and you will obtains the expanded view for key configuration. Press the buttons to add macro commands or Javascript functions to the key event you want to configure. Figure 236 ACGM0195V1EN HMWIN Studio User Manual...
  • Page 224: Tag Cross Reference

    The Tag Cross Reference displays listsa list of Tag Names used in currenta project. based on their location and use.. Using the Tag Cross Reference in HMWIN Studio it is possible to: Verify where each tag is used (alarms, pages, recipes, schedulers, trends etc)
  • Page 225: Tag Cross Reference: Data Update

    Figure 238 Users can choose to enable Auto Update by checking Tag Cross Reference -> Auto Update from the top toolbar of HMWIN Studio into View -> Properties dialog. Figure 239 29.4 Export data in csv Tag Cross Reference allows exporting all information collected in a csv format. The format of the csv file...
  • Page 226: Indexed Addressing

    All the three different sensors can now be visualized in a single page like the following, in which Room number is used as a selector (combo box) to pick up the right set of tags. Figure 240 In order to create the Indexed Tag Set of the previous example in HMWIN Studio. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 227 9) Double click on cells of table to select tags as shown below (or click F2 on cells for entering in edit mode) Figure 242 Index Tag datatype can be a number, a string or any type of simple data types. NOTE ACGM0195V1EN HMWIN Studio User Manual...
  • Page 228: Autofill Tag Names

    So you can selectively change the filter for handling a particular alias only. 30.2 Using Indexed Addressing mode in pages Once defined an Indexed Tag Set, let see how to design the HMI page introduced in the previous example. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 229 Index String List Room Number Room 1 Room 2 Room 3 Room 4 4) Attach to each numeric field Value the corresponding Alias variable (Room -> Temperature, Room -> Humidity, Room -> Pressure). Figure 244 ACGM0195V1EN HMWIN Studio User Manual...
  • Page 230: Special Widgets

    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). ACGM0195V1EN HMWIN Studio User Manual...
  • Page 231: Rss Feed Widget

    RSS Source Allows you to specify the feed URL UpdateRate Allows you to specify the refresh time. Properties are shown in the figure below. Feeds sources are fixed and cannot be changed at runtime. NOTE ACGM0195V1EN HMWIN Studio User Manual...
  • Page 232: Control List Widget

    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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 233: 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. Figure 262 ACGM0195V1EN HMWIN Studio User Manual...
  • Page 234: Selection

    There are two write modes for the control list: Write on Select and Write on Enter. 31.3.3 Write on Select On Write on Select, the value will automatically be written when one of the states is selected ACGM0195V1EN HMWIN Studio User Manual...
  • Page 235: Write On Enter

    To insert the widget in a page, just drag and drop it to any position on the page. This will display a place holder 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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 236 Figure 267 In case global variables are needed, they can be configured from the project widget, adding the desired variables to the global Variable Widget as shown in the following figure Figure 268 ACGM0195V1EN HMWIN Studio User Manual...
  • Page 237: Using Variables In Javascript

    The Variables can be also referenced in JavaScript programs with the following syntax: For Local Variables var varWgt = page.getWidget("_VariablesWgt"); var compVar = varWgt.getProperty("VariableName"); For Global Variables var varWgt = project.getWidget("_VariablesWgt"); var compVar = varWgt.getProperty("VariableName"); ACGM0195V1EN HMWIN Studio User Manual...
  • Page 238: Media Player Widget

    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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 239: How To Convert A Video Using Super © Video Converter (By Erightsoft)

    The Media Player Widget works only with some HMI panels (hmi panels based on ARM Cortex-A8- NOTE 1Ghz and Win32 platform). It doesn’t work the HMWIN Client or ActiveX. You can have only one Media Player widget in a page.
  • Page 240: Using Media Player In Javascript

    // set the loopstyle 0 - noloop, 1 - loop one, 2- loop all, 3 - random mediaWgt.setProperty('loopstyle', 2); //start playing the first file. mediaWgt.mediapath = '/Storage Card/demo_3.avi'; For a complete reference about JavaScript refer to chapter Working with JavaScript. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 241: Ipcamera Widget

    The supported authentication methods are: Basic NTLM version 1 Digest-MD5 No settings are required to select the method as it comes as an automatic selection from the camera web server to which the widget connects. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 242: Ipcamera Tested

    Useful when IPCamera device is protected by a username & password. Password Useful when IPCamera device is protected by a username & password. Command Command to send to PTZ controller. Ex. decoder_control.cgi?command=0 The supported authentication methods are: Basic NTLM version 1 Digest-MD5 ACGM0195V1EN HMWIN Studio User Manual...
  • Page 243: Multistate Image Widget

    31.9 Multistate Image Multilayer The Multistate Image Multilayer widget extends the features available in Multistate Image widget. Multiple layer support allows user to define more features for animations and select the best at runtime based on different situations. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 244 3) Define all layers needed. To add a new layer, use the + icon on the right of existing layers. Figure 276 4) Double click on each layer to configure images that compose the layer. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 245 Time interval of slideshow (ms). Used just when animation is enabled. Preview Preview is working like a simulator for animations. Can be used to verify animation in designing phase of widget without execute entire project. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 246: Combo Box Widget

    Data of the widget, the related value reported in the Data List (as string). Usually Index is enough for 90% of applications, however sometime it is useful to return a custom value based on an item selected in the combo box. Figure 280 ACGM0195V1EN HMWIN Studio User Manual...
  • Page 247: Consumption Meter Widget

    Graph Duration / the trend window Graph Duration Units these properties determines the time period represented by each bar Bar Duration/Bar composing the graph Duration Units ACGM0195V1EN HMWIN Studio User Manual...
  • Page 248 In TimePeriods dialog, to assign the color to the cells of the table, you can select the cells and click on the related band/color. Another way is to enter the index value of the band (1, 2, 3) into the cell to color it. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 249: Browser Widget

    Browser widget can be used to embed web pages into hmi pages. Browser widget is not supported by MIPS based panels and ActiveX. Widget properties allow user to customize many parts of the widget like: ACGM0195V1EN HMWIN Studio User Manual...
  • Page 250 This has been done to save around 3Mb of space required by this library when the widget is not used in the project. Hyper Link widget is available to create labels into hmi pages working as ACGM0195V1EN HMWIN Studio User Manual...
  • Page 251: Custom Widgets

    32 Custom Widgets HMWIN 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.
  • Page 252: Adding The Properties

    You can select the properties that you want to expose for that custom widget by clicking the corresponding check box. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 253 Attribute Name The name exposed by HMWIN Studio, 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.
  • Page 254 To select a sub widget like the label in a button, use ObjectView or Shift + leftClick of mouse. In this way sub widget can be changed without ungroup all widget. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 255: 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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 256: Send An E-Mail Message

    To configure the email server, you need to provide the following information into field EmailConfig of SendMail action: SMTP SMTP server address optional – it can be used for information purposes Server Name Server Port Port to use to connect to SMTP server. Default is 25. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 257: Configure E-Mails

    Attachment Path of the file to send in attach to the email. The system support one single attachment for each email sent. SMTP servers usually limit the max size allowed for an E-Mail NOTE attachment. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 258 Body Main content of the email. System support Live Tags. You can add more emails templates by clicking the “+" button on the left hand side. Figure 290 ACGM0195V1EN HMWIN Studio User Manual...
  • Page 259: Javascript

    ECMAScript standard. If you are familiar with JavaScript, you can use the same type of commands in HMWIN Studio 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: https://developer.mozilla.org/en/JavaScript...
  • Page 260: Widget Events

    The object that triggers the event. eventInfo Details of the event triggered. function buttonStd1_onMousePress(me, eventInfo) { //do something… 34.2.1.4 onMouseRelease void onMouseRelease (me, eventInfo) This event is available only for buttons and it occurs when the button is released. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 261: Page Events

    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… ACGM0195V1EN HMWIN Studio User Manual...
  • Page 262: System Events

    When a JavaScript callback is not found in current page, the system search for it at project level automatically. 34.2.3.1 Scheduler Event The event occurs when triggered by the proper action available in the scheduler system as shown in the figure below. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 263 Figure 291 34.2.3.2 Alarm Event The event occurs when triggered by a specific alarm condition and programmed in the proper action as shown in the figure below. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 264: Objects

    //do something… 34.3 Objects HMWIN Studio 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:...
  • Page 265: Widget

    It gets the name of the Widget. The name is a unique id for the Widget. function btnStd04_onMouseRelease(me) { var wgt = page.getWidget("rect1"); var name = wgt.objectName; number x It gets or sets the Widget ‘x’ position in pixels. function btnStd1_onMouseRelease(me) { var wgt = page.getWidget("rect1"); wgt.x = 10; ACGM0195V1EN HMWIN Studio User Manual...
  • Page 266 = page.getWidget("rect1"); wgt.visible = false; function btnStd5_onMouseRelease(me) { var wgt = page.getWidget("rect1"); wgt.visible = true; value number value It gets or sets the Widget value. function btnStd6_onMouseRelease(me) { var wgt = page.getWidget("field1"); wgt.value = 100; opacity ACGM0195V1EN HMWIN Studio User Manual...
  • Page 267 The index of the element to get from the array. Default is 0. Almost all properties that are shown in the HMWIN Studio Property view can be retrieved from the getProperty method. The index value is optional and only used for Widgets that support arrays.
  • Page 268 The index of the element to set in the array. Default is 0. Almost all properties that are shown in the HMWIN Studio Property view can be set by this method. The index value is optional and only used for Widgets that support arrays (for example a MultiState Image widget).
  • Page 269 Return value It returns a number corresponding to the timerID. var duration = 3000; var myTimer = page.setTimeout("innerChangeWidth()", duration); clearTimeout void clearTimeout( timerID ) It stops and clear the timeout timer with the given timer. Parameters ACGM0195V1EN HMWIN Studio User Manual...
  • Page 270: Group

    Follow the list of Methods supported by Group Object: getTag object getTag( TagName ) Gets the tag specified by TagName from the group object. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 271: Project

    There is only one widget for the project and it can be referenced through the project variable. Follow the list of properties of Project Object: startPage string startPage The page shown when the application is started var startPage = project.startPage; project.startPage = "Page2.jmx"; ACGM0195V1EN HMWIN Studio User Manual...
  • Page 272 The script executes to show the dialog page. project.showDialog("Dialog.jmx"); closeDialog void closeDialog() The script executes to close the currently-opened dialog page. project.closeDialog(); showMessage void showMessage( message ) The script executes to display the message popup. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 273 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. Follow some additional details related to the use of getTag function with forceRefresh parameter. If: ACGM0195V1EN HMWIN Studio User Manual...
  • Page 274 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 } else { // Failure var val = "value"; project.setTag("Tag1", val); ACGM0195V1EN HMWIN Studio User Manual...
  • Page 275 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 0 based set index. project.downloadRecipe("recipeName", "Set"); uploadRecipe ACGM0195V1EN HMWIN Studio User Manual...
  • Page 276 A string to print silentMode true = silent mode (avoids to show printer settings dialog) project.printText("Hello I Am Text Printing",true); emptyPrintQueue void emptyPrintQueue() Empties the print queue. Current job will not be aborted. project.emptyPrintQueue(); ACGM0195V1EN HMWIN Studio User Manual...
  • Page 277 = project.printStatus; project.setTag("PrintStatus",status); printGfxJobQueueSize project.printGfxJobQueueSize; Returns the number of graphic reports in queue for printing. var gfxqueuesize = project.printGfxJobQueueSize; project.setTag("printGfxJobQueueSize",gfxqueuesize); printTextJobQueueSize project.printTextJobQueueSize; Returns the number of text reports in queue for printing. var textjobqueuesize = project.printTextJobQueueSize; ACGM0195V1EN HMWIN Studio User Manual...
  • Page 278 Returns the maximum allowed size of spool folder (for PDF printouts) var diskquota = project.printDiskQuota; project.setTag("printDiskQuota",diskquota); printSpoolFolder project.printSpoolFolder; Returns current spool folder path (for PDF printouts) var spoolfolder = project.printSpoolFolder; project.setTag("printSpoolFolder",spoolfolder); printPercentage project.printPercentage; ACGM0195V1EN HMWIN Studio User Manual...
  • Page 279: State

    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… ACGM0195V1EN HMWIN Studio User Manual...
  • Page 280: Keywords

    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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 281: Debugging Of Javascript

    34.7 Debugging of JavaScript HMWIN Studio and Runtime include a JavaScript debugger to allow user to debug problems. There’re two types of debuggers:  Runtime debugger: a debugger running directly into target device (HMI panel)  Remote debugger: a debugger running on a remote PC connected to target device via Ethernet...
  • Page 282: Remote Javascript Debugger

    NOTE http://qt-project.org/doc/qt-4.8/qtscriptdebugger-manual.html 34.7.1 Remote JavaScript Debugger Remote JS debugger can be opened directly from HMWIN Studio Run -> Start JS Remote Debugger or from icon in toolbar. To start remote debugging, proceed as follow: 1. Download project with Allow JavaScript Remote enabled in project properties and JavaScript Debug enable in all pages where debugging is required.
  • Page 283 For UN20 target (WCE MIPS hmi panels), local debugger has been disabled. However, remote NOTE debugger is available to debug JS from a PC connected to HMI panel via Ethernet. Remote debugger not supported in HMWIN Client and ActiveX. NOTE Figure 297...
  • Page 284: Hm4Web Html5-Based Access

    35.1.2 Tablets / Phones HM4Web works with most tablet and phone devices. The following tablets have been tested for compatibility with HM4Web:  iOS 4.1+ - Mobile Safari  Android 2.1+ - Android Webkit Figure 299 ACGM0195V1EN HMWIN Studio User Manual...
  • Page 285: Generating Hm4Web

    You can use any of your existing HMI projects or you can make a new project using HM4Web. If you are working with an existing project, any widgets and features can be used in HMWIN Studio; however, not all features are currently available with the HM4Web option. If the project includes a feature that is not available, HM4Web will still work correctly but the feature will not be available on the remote client device.
  • Page 286: Setting Home Page

    Page2 is the home page for desktop web browsers. Figure 301 35.2.4 Start HM4Web Export After selecting the pages and home page for each platform, click on OK button to start the HM4Web page generation. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 287: Testing The Hm4Web Project

    Once the export has been started, HMWIN Studio will show a progress bar that indicates the status of each page as it is being processed. If you have many pages in the project, this process can take several minutes. Figure 302 After the Export has been completed, the progress dialog will close automatically and the HM4Web application is ready to be downloaded to the target.
  • Page 288: Downloading The Hm4Web Project

    HM4Web project is downloaded at the same time the normal HMWIN Studio project is downloaded. To download HM4Web to the panel, you perform the same steps as you would to download a normal HMWIN Studio project. Both the HMI panel project and HM4Web web project are downloaded at the same time.
  • Page 289: Running Hm4Web From A Browser

    User Management features. If the correct credentials are entered, you will be redirected to the home page that you have selected during the page export. An example of the home page is shown in the figure below. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 290: Hm4Web Connectivity Notes

    ‘disconnect’ icon will appear in a toolbar on top of the HM4Web page as shown below. Once the server is back online, the red circle-bar icon will be removed indicating normal communications with the panel. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 291: Inactivity Timeout

    35.5.4 Non-Active HM4Web Project You can be in a situation in which you have a HM4Web page in your browser, which comes from a project that is no longer active in the panel. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 292: Hm4Web Limitations

    HM4Web will not perform any server-bound communications. 35.6 HM4Web Limitations Currently not all HMWIN Studio features are supported in HM4Web. For example, HM4Web only supports a subset of widgets available in HMWIN Studio. The following sections define the items that are supported by HM4Web. 35.6.1 Widgets ...
  • Page 293: Actions

    Round Bar Button widget is not supported.  User management features of widgets are not supported.  onDataUpdate event on Page/Template Page/Dialog Pages is not supported. 35.6.2 Actions HM4Web currently supports the following HMWIN Studio actions:  HomePage  LoadPage ...
  • Page 294: Widget Event

    Save button shown below the text box to make the newly inserted value permanent. Only meaningful numbers will be accepted during the save process. Anything else will be ignored and will not result in a value change. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 295: Dialog Page

    If the proxy controls the parallel connection settings then make sure that the maximum possible parallel connections (max connections) is set to a number greater than 5 and less than or equal to 10. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 296: Why I'm Not Able To See Changes In Web

    Connecting with a web browser to the panel IP address can result in the visualization of cached pages instead of the latest downloaded pages. To avoid this behaviour you can: - disable cache of your web browser - force web page refresh - by-passing browser cache ACGM0195V1EN HMWIN Studio User Manual...
  • Page 297: System Settings Tool

    The 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. Main Items available in User Mode are: Calibrate Touch To calibrate the touch screen if needed Display settings Backlight and Brightness control ACGM0195V1EN HMWIN Studio User Manual...
  • Page 298: System Mode

    Clear internal Ctrl App: clear current folders used by CODESYS V2.3 and CODESYS V3 internal controllers for applications  \Flash\QtHmi\RTS\APP\*.*  \Flash\QtHmi\RTS\VISU\*.*  \Flash\QtHmi\codesys\*  \Flash\$SysData$\codesys\* Clear sysdata settings: clear \Flash\$SysData$ folder (used by tech. supp only for problems related to display settings) ACGM0195V1EN HMWIN Studio User Manual...
  • Page 299 Loads a new file for the splash screen image displayed by the unit at Image power up; the image must be supplied in a specific format. We suggest that you update the splash screen image directly from the HMWIN Studio programming software. Download...
  • Page 300 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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 301: License Activation Of Hmi Panel Software Modules

    37 License Activation of HMI Panel Software Modules HMWIN Studio provides the interface for activating software modules in the HMI Panel. You can access the UI from Run -> Manage Target - >License. The interface provides two operations - Activate Panel and Save License - which needs a working Internet connection or –...
  • Page 302: Save License

    Feature/status list box that can be seen on the right side of the Activation keys boxes. After the activation is complete, to enable the license in the panel you must restart it. NOTE 37.2 Save License Save License operation is done to create the license file now for activation later. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 303 Once you have completed entering the activation key, you can press the Save License button for saving license files. Once you press the Save License button  It verifies the activation key.  It creates a license file and stores it in the folder LICENSEFOLDER\HMI Licenses\PANELID. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 304: Import License

    37.3 Import license If for some reasons it is not possible to have a working Internet connection on the PC running HMWIN 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.
  • Page 305: Updating System Components In Hmi Panels

    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 file name: configos_UN20HS0160C0237.bin) ACGM0195V1EN HMWIN Studio User Manual...
  • Page 306: Update Of System Components From Hmwin Studio

    38.2 Update of System Components from HMWIN Studio HMWIN Studio provides a dialog to update system components by downloading them to the target device using the Ethernet communication interface. The dialog is available in Run -> Manage Target -> Board.
  • Page 307 In the component selection you can mark more than one check box and provide the related file to be NOTE 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. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 308: Update Of The System Components Via Usb Flash Drive

    Upgrade procedure may change depending on the hardware revision or operating system version NOTE from which you start; please contact technical support offices for any detail about the exact sequence. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 309: Access Protection To Hmi Devices

     Download and upload of project files A default value for this password is used by the HMI Runtime and by HMWIN Studio to access to device. There are three ways to change device password in the HMI Runtime: 1) Using the tab Remote in the BSP Settings (in system mode) dialog box in System menu includes (starting from BSP versions V1.64 UN30/31 and V2.73 UN20).
  • Page 310: Ports & Firewalling

    Figure 320 HMWIN Studio shows a dialog asking for the password to match the password defined in the HMI device. The new password will be stored into the computer OS registry to be used for further connections. 3) Using Set Target Password in update package. Password is updated by the runtime just after the update process is completed.
  • Page 311 ActiveX Web access HM4Web Runtime/Project Management ports Required If you need to connect to runtime using in HMWIN Studio for Runtime and Project operations like Update Runtime, Install Runtime, Download Project. Board Management ports Required if you need to connect to device with HMWIN Studio for Board operations like Update BSP, download Splash Image etc.
  • Page 312: Factory Restore

    - Restore Factory Settings allow user to select components to cleanup. Both operations do not manage firmware factory restore (MainOS, ConfigOS, Bootloader, FPGA images, etc). For more information related to Format Flash and Restore Factory Settings please ref. to System Mode ACGM0195V1EN HMWIN Studio User Manual...
  • Page 313: Tips And Tricks To Improve Performance

    41 Tips and tricks to improve performance HMWIN Studio allow max flexibility for a projects designer. User can change svgs and replace images with customized versions. However, following some simple rules is possible to have faster projects in terms of boot time, page change and animations.
  • Page 314: Best Practices For Max Performance

    7. Use “size to fit” command to make the widget to the real size of his contents. 8. Choose the image file format based on the real target you have. HMWIN Studio is supporting several raster formats like BMP, PNG, JPEG, TIFF and the vector format SVG:...
  • Page 315 This will reduce the load time of the page if we design it in an optimal way. Follow an example of good and bad usage of Static optimization. Figure 322 ACGM0195V1EN HMWIN Studio User Manual...
  • Page 316: Faq - Static Optimization

    The file imagecachelist.xml is created in project/opt folder, containing relevant information for ImageDB:  Fill color. (in case of SVG)  Size of the svg image  Number of times an image is used in the project  Number of different sizes for the same image ACGM0195V1EN HMWIN Studio User Manual...
  • Page 317: Best Practice To Use The Image Db

    (RAM) removing pages & related images up to 64MB free. In order, the runtime removes from cache: a. last visited pages and bigger and unused images (>320x240) b. if more memory is needed runtime can unload also pages in precache and all images loaded in Image DB. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 318: Faq

    42 FAQ 42.1 How to change fill color property according to Tag values HMWIN Studio allows to change the color property of a widget dynamically, basing on Tag values in two ways: 1) Using ColorPaletteCustom Xform 2) Connecting Color property to a String type Tag 42.1.1 Using ColorPaletteCustom Xform...
  • Page 319 SVG file created following the apposite guidelines, this feature can not be applied for example on jpeg or bmp files. ACGM0195V1EN HMWIN Studio User Manual...
  • Page 320: Functional Specifications And Compatibility

    30MB 43.2 Compatibility Starting from the first official release of HMWIN Studio V1.00 (00) we have applied the following policy for compatibility: HMWIN Studio version MUST always be aligned with HMWIN Studio Runtime on the panel; the user has the responsibility to update Runtime components on the Target device together with any Studio update;...
  • Page 321 Compatibility between newer versions of Runtime and those projects created and deployed with older versions of Studio is not ensured. Do not edit projects with a version of HMWIN Studio older than the one used to create them. It can result in a damage of the project and to runtime instability.

Table of Contents