iX Developer Reference Manual MAEN831P, 2016-09 English
Foreword Reference manual for iX Developer Foreword The iX Developer software is used to configure iX panels and PC operated control applications, including applications for IPCs (Industrial PCs). The iX Developer makes it easy to create logical, flexible and effective HMI applications that provide the right information on the right occasion to operators and to other systems. This manual describes the configuration software in detail.
Foreword Beijer Electronics, MAEN831P
Contents Contents 1 The Configuration Tool ................................................ 15 1.1 Introduction ..................................................... 15 1.1.1 1.1.2 1.1.3 1.1.4 1.1.5 1.1.6 1.1.7 1.1.8 Controller . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15 Tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 System Requirements and Limitations . .
Contents 3.2.4 3.3 Configuration Pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59 Screens ............................................................ 61 3.3.1 3.3.2 3.3.3 3.3.4 3.3.5 3.3.6 3.3.7 3.3.8 3.3.9 Screen Name and Screen Title . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62 Background and Foreground Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62 Startup Screen . . . . . . . . . . . . . . . . . . . . .
Contents 4.4 4.5 System Tags ...................................................... 104 Array Tags ........................................................ 107 4.5.1 4.6 4.7 4.8 4.9 4.10 Cross Reference .................................................. Triggers ........................................................... Poll Groups ....................................................... Station Handling ................................................ Index Registers ...................................
Contents 6.3.1 6.3.2 6.3.3 RESTful Web Service API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152 General . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152 REST API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152 7 Objects ................................................................... 157 7.1 Blinking Objects ....................
Contents 7.7.7 7.8 7.8.1 7.8.2 7.8.3 7.9 Text Box Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198 Additional Controls ............................................. 198 Target Platform . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199 Adding Controls to the iX Developer Toolbox . . . . . . . . . . . . . . . . . . 199 Default Controls and Installed Controls . . . . . . . . . . . . . . . .
Contents 8.8.4 8.8.5 8.8.6 8.8.7 8.8.8 8.8.9 8.8.10 8.8.11 8.8.12 Value Changed Action Triggers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263 Tags Action Triggers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264 Focus Action Triggers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264 Navigation Action Triggers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents 14 Function Keys ........................................................... 293 14.1 Definitions ....................................................... 293 14.2 Configuring Function Keys ..................................... 293 14.2.1 14.2.2 14.2.3 Function Key Actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293 Function Key Scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295 Momentary Function . . .
Contents 16.4 Object Security and Visibility ................................... 324 17 Language Management ................................................. 327 17.1 Setting Up Multiple Languages ................................. 327 17.1.1 17.2 17.3 17.4 Adding Languages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327 System Texts ...................................................... 328 User Texts .....................................................
Contents 24.5 24.6 24.7 24.8 24.9 Adobe Reader not Recognized .................................. Expression Cannot Be Found ................................... Performance Issue Related to Graphics Card ................... Error Related to Third Party Controls .......................... Performance Issue When Navigating in Script Tree View ....
Contents Beijer Electronics, MAEN831P
The Configuration Tool 1 The Configuration Tool 1.1 Introduction The iX Developer software is used to configure operator panels and PC operated control applications, including applications for IPCs (Industrial PCs) from Beijer Electronics. iX Developer contains all basic functions needed in an application. The functions are tested and developed with customer needs and preferences in focus.
The Configuration Tool 1.1.3 System Requirements and Limitations iX Developer iX Developer System Requirements Parameter Recommendation RAM 2 GB Processor 2 GHz or higher Operating system Microsoft Windows 10 Microsoft Windows 8.1 Microsoft Windows 7 SP1 Graphics card Tier 2: DirectX version: 9.0 or higher Video RAM: 120MB or higher Pixel shader: version level 2.0 or higher Vertex shader: version level 2.
The Configuration Tool iX Runtime System Requirements Parameter Recommendation Graphics card Tier 2: DirectX version: 9.0 or higher Video RAM: 120MB or higher Pixel shader: version level 2.0 or higher Vertex shader: version level 2.0 or higher Multitexture units: 4 or more Updating iX Runtime in an operator panel iX Runtime is pre-loaded in every operator panel on delivery. If necessary, this could be upgraded to a newer version using the Image Loader application.
The Configuration Tool Item Support on operator panel target Support on PC target Media Player Supported PDF Viewer Supported Web Browser Supported Navigation List Box Supported Screen Carousel Supported Drop down shadow effect Supported Rounded corners on rectangle Supported Opacity Supported Report Supported Reports containing charts and pictures can not be printed from an operator panel target Dynamics All dynamic settings are supported Some dynamic settings are not supported on i
The Configuration Tool Alternatively, select to continue using a trial version of the software. You may evaluate iX Developer with full functionality for 30 days. When the evaluation period has expired, it will still be possible to use the software, but the functions in the Run and Transfer groups will be disabled. Note: If you have already used a Demo version of iX Developer for 30 days, you will not be issued another 30 days for evaluation.
The Configuration Tool 1.1.6 Configured Features iX Developer offers the possibility to add customer-specific features in the program. This is done through the use of registration keys that are entered after the iX Developer software installation has been done. Clicking on Show Features displays a list of enabled features. To install a new feature, enter the feature registration key under Configured Features and click OK. A restart of the program is required to activate the function.
The Configuration Tool Symbols Pictures that are used in projects are converted to .png files when the project is validated. Pictures are resized to the largest static usage in any of the project screens, in order to save memory space in the panel. If a picture is enlarged in runtime using dynamics, the enlarged picture will have a lower effective resolution. Project pictures are stored in the Symbols folder as a compressed folder named Symbols.zip.
The Configuration Tool • • Renaming a data logger Changing the data type or name of a data logger's items If none of the above changes are made, then all runtime data will be kept, even when switching database type. A copy of the database can be made with the Upload Database command. Some of the databases can be exported individually in csv, comma separated values, format using the Database Export action.
Working with Projects 2 Working with Projects This section describes iX Developer and explains how to work with a project for an operator panel. In iX Developer, ribbon tabs are used instead of menu commands. This reduces the number of steps needed to design complex components, and also supplies an attractive user interface. Ribbon tabs are located in the top section of the tool window. Each ribbon tab holds one or several control groups. Each group contains a set of related controls.
Working with Projects 2.1.3 Designing Additional Functions Alarms Alarms are used to make the operator aware of events that require immediate action. An alarm is set when a certain condition is met. An alarm condition is designed as a logical evaluation of a tag value. Alarms can be divided into groups to create an order of priority. Related information Alarm Management Function Keys Function keys can be used to perform actions and execute scripts.
Working with Projects Related information Text Library Audit Trail The Audit Trail function allows tracking of operator actions. Related information Audit Trail Data Logger Data can be logged and saved to file. Bit, 16-bit, 32-bit and Real (Float) values can be logged. Be aware that logging of data consumes system resources and memory.
Working with Projects 2.2 Importing an Information Designer Project Existing Information Designer projects can be imported to iX Developer. Information Designer is the previous software used to design projects for the EXTER operator panels. The import function is accessed from the Welcome page, displayed when starting iX Developer. 1. Select the Information Designer project file. 2. Select a name and location for the imported project. 3. Click Finish.
Working with Projects 2.3 Importing an H-Designer/ADP Project Existing H-Designer/ADP projects can be imported to iX Developer. H-Designer/ADP is the previous software used to design projects for the H-/PWS-series operator panels. The following software versions are required: Software Version ADP 6.50 build 184 iX Developer 2.0 or higher 2.3.1 Exporting the H-Designer/ADP Project First, the H-Designer/ADP project has to be converted to an a2i file from within ADP by following the steps below: 1.
Working with Projects Function Controller Comment Import of name list and addresses for the first two controllers in the ADP project is supported. Import of controller settings such as IP address and COM settings is not supported. Import of index registers is not supported. Macro and sub-macro Not supported Recipes Not supported Object Comment Action push button The graphical control will be imported but the actions need to be reconfigured.
Working with Projects Shape Comment Shape Not supported Solid polygon The graphical control will be imported but needs to be reconfigured. 2.4 Optimizing Performance The following section presents a couple of issues to consider in order to optimize the iX Developer project. Some parts are related to the communication driver; other parts concern CPU load and flash operations. 2.4.1 Communication Performance Signal Types Tags used for driver communication can be static or dynamic.
Working with Projects Tag Packages Tags to be transferred are not all transferred at the same time, but are grouped into packages. The number of tags in each package depends on the driver for the controller. To make communication as fast as possible the number of packages should be minimized. Consecutive tags require a minimum number of packages, but it is perhaps not always possible to program it this way. In such cases there is a “waste” between two tags.
Working with Projects 2.4.3 Performance in the operator panel It is important to understand that due to the complex nature of a running system, there are several things that affects the overall performance.
Working with Projects Assign and configure poll-groups with care. High poll-interval frequency affects the performance. Usage of the following properties on tags will reduce performance.
Working with Projects the application utilize more than 85% without caching the application will not be able to cache any screens and therefore not experience faster screen switching times. Trend Viewers and Data Loggers Several trend viewers can show data from the same log item. In order to optimize performance in the panel, it is strongly recommended to place all log items logged on the same frequency/event in the same data logger or at least reduce the amount of data loggers.
Working with Projects Gradients Using objects with gradients creates a slightly higher load on the CPU. If a large number of objects use gradients, this will make the screen update time significantly slower. Pay special attention to objects with gradients that are updated frequently, e.g. a bar graph with a style with gradients connected to a tag that changes at short intervals. Polygons Avoid excessive use of polygons.
Working with Projects 2.5 Moving Objects with the Touch Screen iX panels with touch screens do not have a built-in keyboard. All maneuvering is done with the touch screen by pressing distinctly with a finger. Because of the resistive touch technology, the screen can only apprehend pressing on one place on the panel at the time. Pressing two points at the same time is interpreted by the panel as a point midway between the two pressed points. Related information 2.5.
Working with Projects 2.6 Peripherals 2.6.1 USB External devices such as a USB hub, flash drive, mouse, or keyboard can be connected to the USB host port. 2.6.2 Ethernet The operator panel has built-in Ethernet port(s) for connection to controllers via TCP/IP. The number of ports varies by model. Related information IP Settings 2.6.3 Memory Card An external memory card can be used as storage of e.g. pdf files and media files, to reduce used internal memory.
Development Environment 3 Development Environment This section describes how to work with iX Developer. Clicking the Options button in the File menu allows adapting the tool behavior. Related information File Menu Options 3.1 Starting iX Developer Click on Start/All Programs/iX Developer 2.20/iX Developer 2.20 to start iX Developer. iX Developer can also be started from the command line.
Development Environment 3.1.1 Creating a New Project To create a new project using the wizard includes the following steps: 1. Start iX Developer. 2. Select to create a new project. 3. Select target for the project. 4. Select controller brand and model. 5. Name the project and define where files are to be saved in the PC environment. Select operator panel Select the appropriate target from the presented set of operator panel/PC.
Development Environment The demo controller, including regular tags (data containers) and counters, is used to design and test a project directly on the development PC without connection to an external controller. Internal tags that work like controller tags, but are independent of an external controller, can be defined. It is also possible to connect to an external OPC server. The controller can be changed later by clicking the Controller button on the Controllers tab of the tags configuration page.
Development Environment 1. Change the project name, if desired. 2. Select where to store the project files by clicking Browse, or accept the suggested location. 3. Click Finish to create the new project. 3.1.2 Opening a Project To open an existing project using the wizard includes the following steps: 1. Start iX Developer. 2. Select to open a project. 3. Browse to the project file in the appearing “open project” dialog. Note: It is possible to open a compressed ZIP file of the iX Developer project.
Development Environment The Project Explorer contains a folder area, and is managed as a docked window. The desktop area is where screens are drawn and where tags and functions are handled. Configuration of objects on a screen is mainly performed using the controls in the Home and General tabs. Selecting an object on the screen displays the Home ribbon tab; double-clicking displays the General tab, except for the Button object, for which the Actions tab is displayed instead.
Development Environment Related information Project Explorer Positioning Windows Screens Tags Keyboard Navigation Pressing Alt on the keyboard displays which keyboard shortcut commands can be used to execute a command or to enter a control group, e.g. Alt + F opens the File menu, and Alt + I displays the Insert ribbon tab control groups.
Development Environment Keyboard shortcut / function key Description Ctrl + I Italic style Ctrl + U Underline F1 Display help file. Pressing F1 from within the Script Editor displays scripting help. F5 Validate project F6 Run 3.1.4 Starting iX Developer from the Command Line iX Developer can also be started from the command line, by entering: "[Path to the NeoIDE.exe file]" "[Project location]\[Project name].
Development Environment New When you start iX Developer and select to create a new project, a wizard guides you through the creation of a new project, in the same way as having selected Create New Project from the Welcome page. Related information Creating a New Project Open Selecting Open displays a dialog that allows selection of an existing project file by browsing. Save Selecting Save saves the project to the current project folder.
Development Environment Note: Selecting Save as cannot be used in order to make modifications of an existing project, keeping the original project unchanged, and saving the new version with another name. Changes will affect the original project anyway. It is recommended to make a backup copy of the original project, for example by using Windows Explorer, prior to modifying it. Back Up Project Selecting Back Up Project compresses the project and saves it as a ZIP file.
Development Environment Parameter Description Connected targets Choose the target type to transfer the project from. Upload Starts the transfer of the ZIP file from the selected target. The user will be prompted for a path where to decompress the ZIP file. If the ZIP file is password protected, the user must enter the password to be able to upload and decompress the ZIP file. Upload is supported for iX TxA, iX TxB, iX TxC , X2 base, X2 pro, X2 marine, X2 control, X2 motion and PC targets.
Development Environment Note: The active project needs to be saved in order to access the list of features. Note: If a feature has previously been installed from an iX Developer version older than 2.20 SP2, then the registration key will automatically be converted when upgrading to iX Developer version 2.20 SP2. Options Clicking the Options button allows making settings that control the behavior and appearance of iX Developer. Language Options Select in which language to run iX Developer.
Development Environment Transfer Options Select if the Download all source code checkbox in the Download dialog should be automatically selected. Ribbon Options • • GoToDefaultRibbonStrategy: This option changes the active ribbon based on the context of the selection in the desktop. When an object is created or selected, the General tab becomes active in the ribbon area.
Development Environment 3.1.6 Quick Access Toolbar The Quick Access Toolbar contains controls, expected to be used frequently. The toolbar can be customized to include other buttons. Save Saves the current project to the location specified when the project was created. Undo Executed commands can be undone using the Undo button. Clicking the small arrow at the right of the Undo button lists recently made changes for selection of the undo operation. The keyboard shortcut for Undo is Ctrl + Z.
Development Environment Customizing Quick Access Toolbar Some of the ribbon controls can be added to the Quick Access Toolbar. Right-click on the desired control and select Add to Quick Access Toolbar or Remove from Quick Access Toolbar. 3.1.7 Ribbon Tabs The ribbon tabs contain grouped controls for editing and maintaining a project, screens and objects. Click on any ribbon tab to display the ribbon.
Development Environment 3.2 Desktop Area The desktop area displays screens and configuration pages for project components such as controllers and functions. The desktop area shows only one screen or component at a time. When multiple screens or components are opened a row of tabs are shown in the upper part of the desktop area. Clicking on a tab activates its contents for editing.
Development Environment Show/Hide Info It is possible to show information about which tag each object is connected to, and if dynamics or actions are configured for the object, by clicking on the Show/Hide Info button. Show Info is activated Show/Hide Screen Tooltips A semi-transparent tooltip is displayed for each object when the cursor is rested on it, if Show Screen Tooltips is selected. Tooltips for e.g. menu commands are not affected by this setting; only tooltips for objects on the screen.
Development Environment Zoom The following methods can be used to zoom in to or out from the desktop area: • Selecting a set zoom value from the Zoom drop-down list. • Setting the Zoom Slider to a desired zoom level. • Clicking the Zoom In and Zoom Out buttons. • Placing the mouse pointer anywhere in the screen and using the scroll wheel. Pan Panning of the current screen is possible in Layout mode, if the screen is larger than the desktop area.
Development Environment Note: To display a script guide that describes iX Developer scripting possibilities in detail, select Script view mode, click anywhere in the code, and press F1. Caution: Beijer Electronics only offers support for scripting for the included examples in iX Developer Objects that can trigger events will show with expandable nodes in the Script view. Clicking the [+] of such a node expands it and shows the trigger events for the object.
Development Environment Complex behavior can be created using script code. Selections made in Layout view mode are kept when switching to Script view mode and vice versa. Nodes with edited script code are highlighted in the expanded tree view. Highlight of an edited node in the tree view It is possible to disable a script without deleting it, by right-clicking on a node with script, and selecting Unhook event handler.
Development Environment Note: Not all tags available in Tags are visible in IntelliSense when scripting. The name completion function will not show tags and objects that have names similar to script command names. If there are errors in script code during validation of a project, it is possible to navigate to the erroneous position by double-clicking the error in the error list. Press [Ctrl] + [Shift] + [Spacebar] while editing to get a tool tip with the allowed variants of an overloaded method.
Development Environment Note: When a timer is used in script code, it is important to close the timer in the code. Note: Renaming objects and screens included in scripts in Layout mode will cause the scripts not to function. Referenced Assemblies Third-party components and objects that are added to the project via Referenced Assemblies will be made available when scripting. Their methods and properties will be included by the name completion function, in the same way as for built-in components.
Development Environment Docking a Tool Drag the window heading to any position on the screen. If the tool is not docked it will become floating. To re-dock a tool: 1. If the tool is docked already, double-click on its heading to change to floating. 2. Drag the tool to the center of the desktop. A guide diamond appears, pointing towards the four edges of the desktop. Release the window to the desired direction. When the mouse pointer is in position, an outline of the window appears in the designated area.
Development Environment Note: The Auto-Hide function has to be turned off before a tool can be moved. 3.2.4 Configuration Pages Many functions, such as Alarm Server and Data Logger, are configured via table style configuration pages. In some cases there are multiple configuration pages for a feature. When applicable, the configuration page for a feature can be opened to allow direct access.
Development Environment Keyboard Navigation Navigation in configuration pages can be made using arrow keys or with [Tab]. Pressing F4 inside a table cell will in some cases open selection list. Pressing [Enter] acknowledges a selection, and pressing [Esc] cancels a selection. Press [Delete] to remove a value when editing in a field. If a row is selected when pressing [Delete], the entire row will be removed from the table. Use [Spacebar] to toggle a value in a check box.
Development Environment Clicking the button opens the Filter Builder. Several conditions can be used, and the different values/operators that can be used for making conditions are displayed when clicking on the condition building blocks. Operands and operator nodes are context sensitive. Name strings are not case sensitive. Values in the filter builder are saved individually for each function during an edit session. A filter is built as a logical expression tree.
Development Environment Screens are edited in the desktop area and can be managed from: Location Used for The Navigation Manager Adding new screens, managing links between screens, deleting screens The Screens list in the Project Explorer Adding new screens, importing screens from other projects, renaming screens, setting screen as startup screen, saving screens as templates, deleting screens, editing screen scripts The Screen group of the Home ribbon tab Adding new screens, selection of screen temp
Development Environment Background and foreground screens belong to the current project. Example Follow the steps below to use a background screen. A foreground screen is created in the same way, except that you select Foreground instead in step 5. 1. Create a background screen with some reusable elements, such as navigation buttons, and rename it to a suitable name. 2. Create a new screen.
Development Environment 3. Keep the new screen open on the desktop, and click on Parent Screen from the Screen group of the Home ribbon tab. 4. Click the screen you want to use as background. 5. Select Background. 6. Click OK. The background screen is now used for the screen. Any modification made to the background screen will be reflected in all screens using it. 3.3.3 Startup Screen The startup screen is the first screen that opens when a project is executed.
Development Environment User-created as well as predefined screen templates may be deleted by right-clicking on the template in the preview and selecting Delete Screen Template. The folder of the selected screen is then permanently deleted from disk. 3.3.5 Screen Security Using security settings for screens makes it possible to restrict access to screens based on user security groups, similarly to object security. It is not possible to set security for the Startup screen.
Development Environment Note: When using a web browser or pdf viewer object in a popup screen, only the default style for the popup screen is supported. Open Popup Screen A popup screen is opened in runtime by a Show Screen action on an object. Note: When configuring a Show Screen action for a popup screen, position of the screen can be selected. These settings override the settings made in the Screen group of the General tab.
Development Environment or closed event. Otherwise the implementation will continue running in the background, even though the screen is cached, and possibly lead to unnecessary CPU load or otherwise bad behavior. 3.3.9 Grid There are different methods to align objects in screens; Snap objects to other objects and Snap objects to grid. Grid properties are managed by right-clicking on the current screen and selecting Grid from the context menu. It is also possible to select not to snap objects.
Development Environment 3.4 Objects Objects that can be created in a screen are available from the Objects group and the Component Library. Snap lines are used to position objects in a screen and align a moved object with other objects. Information about tag connections as well as size and distance information for objects on the current screen can be displayed by using the buttons in the lower part of the desktop area. Related information Objects 3.4.
Development Environment Resize The size of an object is part of the properties for the object. To change the size of an object: • When the Select tool hovers over the resize handles of a selected object, the mouse pointer changes to an arrow. Resize the object to the desired size. • Open the property grid and edit the Height and Width values. To resize the selected object one pixel at the time, select the object, press [Shift] and use the arrow keys on the keyboard.
Development Environment Selecting Multiple Objects Multiple objects on the current screen can be selected at the same time, with the use of the mouse pointer to draw a frame that touches the objects. Alternatively, select one object and then use [Ctrl] + click to select or de-select other objects. A multiple selection can be used to arrange objects, by using the Arrange control on the Format ribbon tab. The object with the primary selection is used as guide object.
Development Environment 3. Fill in the number of objects to add and make settings for the address incrementation, and click OK. Parameter Description Number of copies Enter the number of columns and rows to create Spacing Specify the number of pixels between the added objects Address incrementation Select how to increment addresses for the added objects. Only addresses available in the driver will be added.
Development Environment Right-clicking in the Tags configuration page and selecting Create series makes it possible to create a series of tags quickly and easily, without adding graphic objects. 3.5 Navigation Manager The Navigation Manager is used to manage screens and their relations with respect to project navigation in runtime. It can be activated/deactivated from the View tab. It provides an overview of all screens in the current project.
Development Environment 3.5.1 Screen Relations The Navigation Manager is used to create relationships between screens. Dragging the mouse pointer from one screen to another screen creates a relation. A button with a Click action is defined in the first screen. This Show Screen action has the second screen as target, and when clicking it in runtime, the second screen is opened. Double-click on a screen to open the screen for editing in the desktop area. 3.5.
Development Environment Link setting Description Show Same Level References Filters out links to screens on the same hierarchical level. Show Back References Shows navigation links to higher hierarchical levels. When not selected, only links to screens on lower levels and links between screens on the same level are shown. Directed Links Draws straight link lines between screens, using the shortest way. Orthogonal Links Draws link lines in an orthogonal pattern.
Development Environment 3.6.1 Project Explorer Groups Click on the group heading to expand/collapse the groups. The number of components in each folder is apparent from the group headings. Right-clicking on a group opens a subset of the commands from the File menu and Insert tab. Right-clicking on a component in a Project Explorer group opens a context menu with a selection of common operations. Not all commands are available for all components.
Development Environment Context menu command Description Show Opens the selected project component for editing in the desktop area Rename Renames the selected project component Add Adds a new project component to the project Import Imports a project component via browsing the hard disk; e.g. a screen from another project Delete Deletes the selected component from the project Screens The Screens explorer lists the screens included in the application.
Development Environment It is also possible to assign a screen to a group by a simple drag and drop operation. Drag the screen symbol and release it on the group. Zoom Slider The Zoom slider is found in the Screens explorer and provides a way to quickly zoom in and out of your screens explorer. Search The search function provides the option to search for screens using the screen name or screen-id. The search is only performed within the selected group.
Development Environment Function Keys Function keys for operator panels as well as for the regular PC keyboard can be configured. Related information Function Keys Multiple Languages Configuring multiple languages for user texts and system texts are supported. The texts can be exported, edited and reimported to the project. A tool for automatic translations is also included. Related information Language Management Reports The reports function allows adding excel report templates to the project.
Development Environment Related information Tags Internal Tags System Tags Text Library With the text library function, text tables can be created, where values are linked to texts. Related information Text Library Recipes Several recipes can be inserted in the project. Each recipe function handles a pre-defined set of recipe items. Related information Recipe Management Script Modules Clicking on a script module in the Script Modules folder opens the script editor in the desktop area.
Development Environment 3.7.1 Components The Component Library includes a large number of predefined graphical objects, categorized into groups. User-defined graphical objects and other files may also be saved in the component library. All components in a sub folder must have unique names.
Development Environment Related information FTP Download 3.7.2 Add and Use Components Drag-and-drop any component from the library to the current screen, or use copy [Ctrl + C] and paste [Ctrl + V] commands. Objects can be copied or moved to the Component Library. A text file, that is saved in the Component Library will be converted to a text box object when pasted into a screen.
Development Environment User-Defined Categories Right-click on an empty space of the Component Library window and select Add Components to add a component to the library. To create a new category, select Add category and choose a name of your preference. A category could also be renamed or deleted. User-defined categories are not project specific. This means that all objects saved in a user-defined category will be available in all iX Developer projects.
Development Environment Component Library window, displaying full size of a selected component XAML Guidelines All information, including the image, must be contained within the XAML-file. Links to external objects will result in missing objects. Furthermore, the appearance of the XAML-file may not be dependent of external inputs, like for example a parameter controlling a multi-picture based on internal logic within the XAML-file.
Development Environment Naming Controls in XAML Not supported Supported Specify Width and Height The root control must specify a width and a height.
Development Environment Bindings These are the only properties that are supported for XAML-binding within components: • ISymbolViewboxSignature.Fill is presented as “Fill” within the property grid • ISymbolViewboxSignature.Stroke is presented as “Outline” within the property grid • ISymbolViewboxSignature.StrokeThickness is presented as “Outline Thickness” within the property grid It is not supported to bind to anything outside of the component. Supported: 3.7.
Development Environment 1. Open Expression Design and draw your image. 2. Select all your components and choose File > Export…. 3. Use the same settings as shown in the picture below. 4. Click Export All and save the file. 5. Open iX Developer.
Development Environment 6. Right-click on a node in the Component Library and choose Add Components. 7. Select the XAML file that you exported from Expression Design. Advanced – XAML bindings in iX Developer It is possible to bind some of the component’s properties to tags directly in iX Developer’s property grid. The following properties are supported: • Fill • Outline • Outline thickness Kaxaml 1. Download Kaxaml from http://www.kaxaml.com. 2. Open your exported xaml file in Kaxaml. 3.
Development Environment Dynamic properties The following dynamic properties are supported by iX Developer: XAML code before modification: 88 Beijer Electronics, MAEN831P
Development Environment Modify the xaml code by replacing Fill, Stroke and StrokeThickness with dynamics properties. Don’t forget to add the namespace.
Development Environment Import to iX Developer 1. Open iX Developer. 2. Right-click on a node in the Component Library and select Add Components. 3. Select the XAML file that you modified in Kaxaml. Observe how your component’s appearance is altered when changing fill/outline color or outline thickness. When you have modified the component you can easily copy it to the Component Library. This will allow you to reuse the graphic/component later on. 3.
Development Environment 3.8.1 Search The Search feature provides a case-insensitive and alphabetical search, that makes it easy to reduce the number of displayed properties. 3.8.2 Toggling views The different views in the Property grid can be selected by using the menu on the top of the window.
Development Environment Select whether Favorites are editable or not Show or hide the Copy Properties functions in the Property Grid 3.8.3 Favorites The properties most commonly used can be added to a Favorites-category for easier access. The favorites are saved per object type, i.e. Button has one set of favorites, Analog Numeric has one set of favorites, Chart has one set and so on. A yellow star indicates that the property is added as a favorite.
Development Environment It is easy to bring objects that may have been obscured by other objects up front, by using the arrows at the top left. Clicking the buttons at the right side of each object enables simply hiding/showing and locking/unlocking objects. Note that the top-to-bottom order in the Object browser corresponds to the front-to-back order on the screen. 3.10 Output The Output window contains messages concerning the project validation and build.
Development Environment 94 Beijer Electronics, MAEN831P
Tags 4 Tags Objects connected to tags can change values in a controller, and controller values can be reflected by changing object appearance in various ways. Objects in a screen will remain static until connected to a tag. A tag has a symbolic name and can be of different data types. Tags can belong to a connected controller, be internal or belong to the system. Internal tags are used to handle local data values, and can be viewed and treated in screens just like regular controller tags.
Tags Similarly, when building the project, a notification of any unused tags will automatically be done by displaying the Remove Unused Tags dialog. To disable or enable pop-up of this dialog, go to Options in the File menu. Select Build options in the list and then select CheckForUnusedTags under Misc. Change the status of the function to True or False.
Tags Note: Always review the candidates for removal prior to removing unused tags, since removing tags that are used in e.g. a script can result in a corrupt project. To be able to detect tags used in scripts, a certain syntax must be used. It is recommended to use the IScriptTag interface within the arguments list for the ScriptModule, thus enabling the ScriptModule to be used and reused without being locked to a specific tag setup. Use the syntax Globals.Tags.
Tags The Sum method inside the script can be utilized in many different contexts. The following picture shows how Tag3 will contain the sum of Tag1 and Tag2 when the button is clicked. Notice that the tags used in scripts must be activated to work as expected.
Tags Related information Tags Editor Options Options 4.1.2 Basic Settings To reduce complexity in the tags configuration page, some columns can be made hidden/visible. The basic settings are always displayed. It is possible to customize which columns to show by default using Tags Editor Options. Enter name, data type and access rights for the tag. Select if the tag is to belong to a controller entered on the Controllers tab.
Tags Related information Scaling 4.1.3 Scaling Scaling affects only tags connected to a controller. Checking the Scaling box displays the Offset and Gain columns.
Tags 4.1.5 Others Checking the Others box makes it possible to configure a number of additional tag properties. Parameter Description Description An optional description of the tag. Description of system tags is added automatically. Please note that the description can not be more than 200 characters long. Descriptions longer than that will cause build errors. Poll Group Makes it possible to poll groups of tags at different intervals. Always Active Prevents the tag from becoming inactive.
Tags 4.1.6 Adding Tags during Editing Tags can be added directly when editing objects. When an object is selected, the tag association can be managed from the Tag/Security group in the Home or General ribbon tabs, or by right-clicking on the object and using the Mini Toolbar. In both cases, tags are added by clicking the Add button. Note: Tags added during editing will stay internal until connected to a controller on the tags configuration page.
Tags Clicking ... in the Actions column for the selected tag brings up the Action properties window. First, a condition is configured by clicking Add under Condition. Select a condition, enter a value and click OK. Note: Only integers are allowed for numeric values. For BOOL and STRING types, only the operands == and != are allowed. Note: A tag action which alters its own tag, may cause unwanted behavior and should be avoided. Then, configure actions to be executed when the condition is met.
Tags 4.3 Internal Tags Internal tags can be used to calculate values that need not be represented in the controller, for example information only for the operator. Internal tags are selected in the same way as an external controller tags. Any number of volatile user defined tags can be created. Note: Internal tag values will not be saved in the operator panel when the project is restarted, unless the Non Volatile option is used.
Tags System tag group Project System tag Description Current Screen Id The ID of the current screen. The data type of this tag is int16 and it only has read access. This tag gets updated every time you open a screen, with the exception on popup screens. When opening a pop up screen the current screen id tag will not be updated. When entering a screen without a screen id the tag value of the current screen id will be set to -1. Note that 0 is a valid screen id.
Tags System tag group System tag Description CPU Load Core 4(2) Amount of capacity used in CPU Core 4 (in percent) Current User The user name of the currently logged in user Debug Logging Enabled Indicates if debug logging is enabled Digital Output #1(2) Digital output Digital Output #2(2) Digital output Flash Memory EOL Info(2) Information about the flash memory end of life. The three possible values are Normal, Warning - Consumed 80% of reserved block and Urgent.
Tags 4.5 Array Tags An array tag is a tag containing multiple values. If the array size is >1, the tag is considered as an array tag. Note: Array tags are only supported by controllers which use addresses that can be numerically increased. 4.5.1 Array Tag Set Up Clicking the Add button adds a tag to the list. Make settings for each added tag. When predefined values are available, these can be selected by clicking the arrow at the right of the table cell.
Tags Related information Tags Chart Object Data Exchange 4.6 Cross Reference The Cross Reference tool provides an overview of where a specific tag is used in the current project. All occurrences of the tag in the current project are listed. Double-clicking on an occurrence in the list automatically brings you to the object or function where the tag is used. The cross reference tool can be accessed by clicking the cross reference button on the Tags tab or on the View ribbon.
Tags Parameter Description Name Symbolic name. The name can be any alphanumeric string, beginning with a letter (a-z, A-Z). Tag Selection of a tag, which when changed to a value other than 0, triggers data exchange Time Time interval between data exchange operations in the format -d.HH:MM:SS.ff (days.hours:minutes:seconds.fractions of a second). The minus sign is optional and indicates a negative time interval. 4.8 Poll Groups Poll groups allow grouping tags for polling at 5 different intervals.
Tags In this example, from an Ethernet driver, Station 0 is the default station. The default station is the station addressed without using a prefix. The other stations can be addressed either as a fixed number or as an index register. With fixed station numbers, an object is always connected to the same controller address, and only the value of this controller address can be used in the object.
Tags Related information Using Index Registers for Station Handling 4.10 Index Registers With index addressing, it is possible for the operator to select from which tag an object is to collect the shown value. Without index addressing an object is always connected to the same controller address, and only the value of this address can be shown in the object. Which tags to use for indexing are defined on the Index Registers tab of the tags configuration page.
Tags Tags are connected to index registers on the Tags tab. In general index addressing can be formulated as: Display value = the content in tag (the object’s address + the content in the index register) If the content in the index register is 2, and the address of the tag specified in the object is 100, the value shown in the object will be collected from address 102. If the value in the index register is changed to 3, the value in the object will be collected from address 103 instead. 4.10.
Tags 2. Add tags and labels and connect them to Demo Controller tags according to below: 3. Select the Index Registers tab and connect Index 1 to the MotorIndex tag (D0).
Tags 4. Select the Tags tab again and check the Others box in order to display the Index Registers column. 5. Connect the Torque and Speed tags to Index Register 1. 6. Now, create a ComboBox object for selection of motor, and two analog numeric objects that will display (or set) the Torque and Speed tags for each motor. Also add explaining labels. 7. Click Configure Texts for the ComboBox object, connect the object to the MotorIndex tag, and add three texts and values according to below. 8.
Tags 10. Run the project, enter values for the objects connected to D11–D13 and D21–D23, and select the different motors using the ComboBox. 4.10.2 Using Index Registers for Station Handling For some controllers, it is possible for the operator to define from which controller station to read or write values. The station number is given as a prefix to the controller address. This is stated either as a fixed number or as an index register. The default station is the station addressed without using a prefix.
Tags This means that the value in the controller address connected to Index 1 will point out which controller station number to read or write values.
Tags Related information Station Handling 4.11 Expressions The Expressions functionality is used when connecting an object to a tag and the purpose is not to use the tag value as it is. Expressions enable the user to e.g. extract a bit from a tag, add a dynamic offset or gain, and then to use this value for a specific object. Note: Static offset and gain for a tag is set in the tags configuration page. The same expression can be connected to more than one object in the project. 4.11.
Tags Click New to create an expression and expression group (optional). Existing expressions are available from the Select Expression drop-down menu. Use the Edit and Delete buttons to edit or delete existing expressions. Select among the tags, operators and functions to insert. It is also possible to type the expression manually, but without assistance from IntelliSense (auto completion). If an expression is not valid, an error message is given when validating the project.
Tags selection dialog is displayed. Select the expression in the drop-down list and click OK. If you have saved expressions to the library that you want to remove, click Delete and select among the saved expressions in a dialog. Expressions included when installing iX Developer are not listed, since these cannot be deleted. 4.11.4 Limitations An expression is executed only on read, i.e. when the value is changed in the controller. When writing a value (from e.g.
Tags 4.13 Data Exchange Data exchange between different controllers is supported; also between controllers of different brands. The data exchange can be performed when a digital tag is set, or at a certain time interval. Data exchange can be selected for individual tags, array tags or for the complete range of tags. Note: The data exchange function is isolated from general tag/controller settings.
Tags 3. Select an address that is represented in all of the controllers.
Tags 4. Click ... in the Direction column to set up the direction of the data exchange. 5. Add a trigger tag on the Triggers tab with time interval for data exchange or use a tag, which when greater than 0, will trigger the data exchange. Alternatively, set up a trigger that includes both value change and a time interval.
Tags 6. Return to the Tags tab and select which trigger to use. Note: If the poll group contains many tag values that change frequently, the time required for them to be handled could exceed the set poll time. This could lead to problems updating the data exchange between the controllers. Set the Poll Group Interval to a higher value or use a time trigger to control the data exchange operations. Related information Triggers 4.
Tags 4.14.3 Tag Import Example If the controller in the project is changed to a system with other names for the tags used, these must be changed: 1. Click on Tags in the Project Explorer. 2. Click on the arrow to the right of the Import/Export button to display the available options of import and export operations. 3. Select Export tags from the desired controller to export the list to a text file or an Excel sheet. Enter a file name and browse to a location.
Tags 5. Open the text file in a text editor or a spread sheet application. 6. Change all current tags to corresponding tags used in the new controller, and save the file.
Tags 7. Select Import tags to the desired controller and browse to the updated file. If desired, select a row from which to start the import. It is possible to rebind columns before importing to the project, and to exclude columns. These settings can be saved by clicking the Save mapping as import module button, and will then be made available for selection from the Import module drop-down list at next import. 8. Click Import. It is now possible to deselect import of some tags.
Tags 9. In case there are name conflicts, these can be handled by changing the name, overwriting, merging or skipping conflicting items. The actions taken are saved to a log file for future reference. Note: If you select Overwrite, all settings for the existing tag will be overwritten. If you select Merge, existing actions for the tag will be kept. The imported tags are now added to the current project. Related information Basic Settings 4.14.
Tags Removing Existing Controller Tags at Import The /ImportTags command line switch may be used together with the switch /RemoveTagsNotInFile. This will remove all existing tags in the controller that are not included in the import file. 4.15 Filtering Tags A selection of tags can be displayed using the Filter Builder. Several conditions can be used, and the different values/operators that can be used for making conditions are displayed when clicking on the condition building blocks.
Tags Format Data type Range DEFAULT Treated as INT16 Bit BIT 0 and 1 Bit BOOL Values can be “false” (0) or “true” (1)(1) Signed 16-bit INT16 -32,768 – +32,767 Unsigned 16-bit UINT16 0 – +65,535 Signed 32-bit INT32 -2,147,483,648 – +2,147,483,647(2) Unsigned 32-bit UINT32 0– +4,294,967,295(2) Float with exponent, 64-bit DOUBLE 1.7 × 10308 (1) Float with exponent, 32-bit FLOAT ±3.
Tags C# type Data type Description int INT32 32 bit, -2,147,483,648 – +2,147,483,647 uint UINT32 32 bit, 0 – +4,294,967,295 float FLOAT 32 bit, ±3.4 × 1038 double DOUBLE 64 bit, ±1.7 × 10308 DateTime DATETIME 7 elements are used to store a time string STRING Storing character strings in tags Related information Script 4.17 Aliases An alias should be treated as a property of a screen and can act as a stand-in for a tag.
Tags Basic Settings Enter Alias name and Default value for the alias. If no default value is entered, the alias will be treated as a local screen variable. Parameter Description Alias Name Symbolic name. The name can be any alphanumeric string, beginning with a letter (a-z, A-Z). Default Value Selection of tags to create aliases of. If no tag is selected the alias will be treated as a local screen variable. The default value will be the default value for the alias in the created instances.
Tags The Default option is a virtual instance configured with the alias’ default values. “Show Screen” Action Parameters. Related information Action Groups Limitations • • • • • 132 Aliases do not support array tags. Aliases can not be used in connection with expressions. Aliases can not be used with the Trend Viewer object. Aliases can not be used on background screens. No scripting support for value changed event on an alias.
Controller 5 Controller iX panels can be connected to many types of automation equipment, such as PLCs, servos, and drives. The expression controller is used as a general term for the connected equipment. It is possible to connect a tag to more than one controller simultaneously. This makes it possible to use the same application with different controllers. Controllers can be enabled and disabled in runtime. A project can contain multiple controller connections.
Controller Parameter Description Name Symbolic name. The name can be any alphanumeric string, beginning with a letter (a-z, A-Z). ID Optional short name for controller; displayed in functions such as Data exchange. Active Selection of which controllers are to be active in runtime. Change of active controllers can also be performed in runtime using an action or script. Controllers are added and deleted using the Add and Delete buttons.
Controller 5.3 External OPC Server OPC is an industrial standard created in a collaboration of automation hardware and software suppliers. The standard defines methods for exchanging real-time automation data between PC-based clients using Microsoft operating systems. An OPC server acts as a controller towards an operator panel. 5.3.1 OPC Classic Client Settings for the OPC Classic client is made in the Choose Controller dialog. Select Localhost when accessing an OPC server running in your local PC.
Controller Parameter URL Description Enter URL to the OPC UA server. Only UA TCP Binary is supported which means the URL must start with “opc.tcp://” Authentication settings Choose whether to use anonymous login or enter a user name and password to enable a secured login. Namespace settings This setting offers a possibility to declare a namespace URI and bind it to a prefix.
Controller If no namespace URI prefix is entered, the default namespace URI prefix as defined in the controller settings dialog will be used. Note: Array tags are not supported by OPC UA controllers. Supported Functions Data Access (UA part 8) is supported. All variables of data types that are used in iX Developer is supported. Read / write of objects, structs and arrays is not supported. Limitations Limitation Description Browsing Browsing of servers / nodes is not supported.
Controller Each driver takes up approximately 3.0 MB. To use the downloaded drivers, iX Developer must be restarted. 5.4.1 Updating Drivers from Internet A web browser is not required to update drivers via an Internet connection. A list of drivers that can be downloaded via Internet is displayed when the connection is established. 1. In the File menu, click Update Drivers and select Update Drivers From Internet to update available drivers to the latest version, or to install new drivers.
Controller 3. Select the driver to install in iX Developer. Mark Newer selects the driver when there is a newer version than the currently installed. 4. Click Install. Related information File Menu 5.5 Synchronizing the Controller Clock In order to synchronize the controller clock with the iX Developer project, the system tags hour, minute, second, need to be added to the project from the Tags configuration page. These are then connected to addresses in the controller.
Controller 140 Beijer Electronics, MAEN831P
Web Server 6 Web Server The Web Server adds the possibility to use a server-side Application Programming Interface (API) to interact with a running project. The API operates over the HyperText Transfer Protocol (HTTP) and can be accessed from any compatible device. In addition, the web server can host web pages and related media to be consumed by web browsers. The bundled Javascript Software Development Kit (SDK) makes it easy to build interactive web pages that utilize the API.
Web Server Login Button Mark a login button with the predefined id “ix-login”. Any element can be used. Invalid Credentials Optionally add an element with the predefined id “ix-invalid-credentials” that will be shown if the login fails. 6.2 Javascript SDK The JavaScript SDK provides a rich set of client-side functionality for accessing the server-side API calls. 6.2.1 Javascript SDK Overview Javascript SDK makes it possible to build highly interactive web pages that uses tags defined in the project. 1.
Web Server Tag Value or Properties To insert the current value of a tag or tag property into an HTML element, the data-ix-tag attribute can be used. The value of the attribute should be the name of the tag as defined in the project and the property of a tag. Separate the names with a dot “.”. If no property is provided, the value of the tag is used. Formatting Formatting of a tag value can be applied to a tag of numeric type or a datetime. The format is defined using the data-ix-format attribute.
Web Server Tag value 144 Description Result a The AM/PM designator lower case. pm A The AM/PM designator upper case. PM g The hour, using a 12-hour clock from 1 to 12. 12 G The hour, using a 24-hour clock from 0 to 23. 12 h The hour, using a 12-hour clock from 01 to 12. 12 H The hour, using a 24-hour clock from 00 to 23. 12 i The minute, from 00 through 59 27 s The second, from 00 through 59. 24 X The milliseconds, from 000 through 999.
Web Server The following table describes the custom numeric format specifiers and displays sample output produced by each format specifier: Tag Value 0 Result Description Value Digit Format 4 00 → 04 4.5 0.00 → 4.50 .1 0.00 × 1000 → 1.00 × 10-01 # Digit, zero shows as absent 4 ## → 4 . Decimal separator or monetary decimal separator 4.5 0.00 → 4.50 E Separates mantissa and exponent in scientific notation 5.55 0.0 × 1000 → 5.6 × 1000 1000000 0.0 × 1000 → 1.
Web Server iX-invalid Style Basic validation is done on input values. If the value cannot be assigned to the Tag then the value will not be set. To indicate an invalid value the framework will set the CSS class “ix-invalid” on the element. This can then be used to provide the user with visual hints of the invalid state.
Web Server Options Property Type Description Argument Default refreshInterval Int The refresh interval of tag values in ms. For performance reasons it is recommended not to use low values for this setting. Optional 5000 refreshMode Overrides the default refresh mode of tag values. Optional onetime Optional onetime String Accepted modes are: none, onetime, interval. refreshModeSetter String Overrides the default refresh mode of tag setters. Accepted modes are: none, onetime, interval.
Web Server "refreshButton" is clicked. This example uses jQuery (bundled with iX.js) to bind to the click event of the "refreshButton" In HTML: In Javascript: iX.refreshTags Refreshes the tag values of the provided tag names manually. Note: Only tags used in conjunction with data-ix-tag or data-ix-setter or created by iX.createTag can be refreshed. Parameters: Name tagName Type String Description (Optional) A list of strings containing the names of the tags to refresh.
Web Server Name Type Description tagName String The name of the tag in the project to create a connection to. valueRefreshedCallback Function Optional: Function that is called when the tag value has changed. The function is not called when the tag value is the same as last checked. Function may take two optional parameters. The first parameter is the tag that changed the value, the second parameter is the old value of the tag before it changed.
Web Server Returns: Type iX.Tag Description An instance of iX.Tag. See Tag Class for a complete description. Example: This example shows how to retrieve an instance of a tag after it has been created. "tag1" and "tag1Again" will refer to the same tag instance. iX.commitTagValue Commits any unsaved tag values that was changed using iX.Tag.setValue for the provided tag names. Parameters: Name tagNames Type Array Description (Optional) A list of strings containing the names of the tags to commit.
Web Server iX.Tag Properties Name Type Description isDirty Bool Flag indicating if the local value has been changed. tagProperties Object An object with data retrieved from the server. See tag metadata below. Note that these are only available after the first refresh. Also, only value is refreshed not all of the metadata. value Flexible The value of the tag. The type of the value depends on the data type in the project. Never use this property to set the value.
Web Server iX.Tag.unsubscribeToChange Unsubscribe from changes. Name Type fn Function Description The same callback that was used with iX.Tag.subscribeToChange iX.Tag.refresh Refreshes this tag. It is recommended to refresh tags in batch (using iX.refresh) instead of refreshing individual tags. iX.Tag.commit Commit this tags value if the value has been changed. It is recommended to commit tags in batch (using iX.commit) instead of refreshing individual tags. 6.
Web Server Tags Resource Example Tag Resource Resource for interacting with individual tags. To perform multiple operations on tags it is recommended to use TagBatch resource instead. Tag Resource Verbs: GET, PUT Uri: /tags/:name GET params: Name: The name of the tag, e.g., Tag1 SystemTagDateTime PUT params: Name: The name of the tag, e.g., Tag1 SystemTagDateTime Value: The value to set the tag to, e.g.
Web Server TagBatch Resource POST params: includeMetadata: boolean indicating if only the tag value or the full tag metadata should be fetched getTags: List of tag names to return setTags: List name, value pairs representing new tag values.
Web Server TagBatch Resource Example Note: The returned value (initialValue) for tags of datetime type is presented in the ISO8601 format. Example: "2008-09-22T14:01:54.9571247Z". Dates are always returned in UTC, Coordinated Universal Time.
Web Server 156 Beijer Electronics, MAEN831P
Objects 7 Objects Static and dynamic objects that can be included in screens are available for selection from the Objects control group of the Home ribbon tab. Not all objects are visible in the normal view, but are made available by scrolling. Clicking the expand button displays all the objects, categorized into groups. An object can be created by clicking on it in the Objects group and then clicking on the screen, or by dragging it from the Objects group and dropping it on the screen.
Objects Dragging the object handles resizes it. Object appearance can be modified using the commands in the Format and Font control groups, but also by the controls on the Dynamics ribbon tab. Settings for a selected object can be managed with the control groups on the General ribbon tab, and actions can be configured from the Actions ribbon tab.
Objects Parameter Description Select Tag for Blink Interval changes blink frequency based on the selected tag value. Blink Enabled Select Tag for Blink Enable makes it possible to enable and disable blinking depending on the selected tag value: When the tag value is equal to the given value (=True), blink is enabled. When the tag value is not equal to the given value (=False), blink is disabled.
Objects Note: Bevel for Poly Line and Ellipse is only supported for projects designed for PC targets. 7.3 HMI Controls Dynamic objects such as buttons, analog numerics, sliders, meters and trend viewers are linked to tags in order to create control and monitoring functions. The tag associated with an object can be selected and changed from the Tag/Security group on the Home or General ribbon tabs, or from the context menu.
Objects Tag Monitor Object Text Object Touch Combo Box Object Touch List Box Object Trend Viewer Object 7.3.1 Action Menu Object The Action menu object is used to display multiple menu groups, each containing its own sets of actions which can be triggered in iX Runtime from the action menu object.
Objects Parameter Description Make Transparent Set transparency on the item Action Configure the action when the item is clicked The Menu Groups tab in the Edit Actions dialog contains the following properties: Parameter Description Menu Group Name The name of the menu group Picture The picture to be displayed for the menu group Make Transparent Set transparency on the menu group Note: Make sure not to use semi-transparent pictures in projects targeted for operator panel.
Objects 7.3.3 Analog Numeric Object The Analog Numeric object displays a box with a numeric or alphanumeric value. The value can be connected to a tag. Settings for the analog numeric object are available from the General ribbon tab while the object is selected: Display Format Group Parameter Description Type Selection of Integer, Decimal, String, Hex or Binary display format Number of Decimals Maximum number of decimals to display in the object. Only available when Type = Decimal.
Objects Parameter Description Hidden: The object is invisible for users with insufficient access rights Normal: The object looks normal also for users with insufficient access rights Format Group Parameter Description Auto Stretch Font Resizes the font to fit the height of the object. Default setting for the analog numeric object. Disable Operator Input Disables input in runtime Transparent Makes the object transparent, i.e.
Objects The Animated GIF can be connected to a tag which controls animation. When the value of the connected tag is 0, then animation is turned off and the picture is displayed static in its initial design. An Animated GIF not connected to a tag runs animated continuously.
Objects Note: Using the animated label object creates a slightly higher load on the CPU. Parameter Description Text The text to be displayed in the animated label Animated If enabled, the text starts to animate Animation speed Set the speed for the animation. Minimum value is 1, maximum value is 32,767.
Objects Picture Group Parameter Picture Description Selects a picture to display on the button. Pictures from the Project Pictures folder is available for selection directly. It is also possible to browse the PC environment for a picture. Select No Picture to remove a previously selected picture. Checking the Multi Picture check box will make it possible to display different pictures based on the value of a connected tag according to section Configure Multi Pictures.
Objects 5. Click OK. The picture on the button will now change according to the value of the selected tag. When the value is out of limits, no picture is displayed. Picture Alignment Group Parameter Vertical Alignment/ Horizontal Alignment Description Set alignment for the picture Clicking the small arrow in the lower right corner of the Picture Alignment group displays the picture properties with a number of additional picture settings.
Objects Visibility Group Parameter Description Transparent Makes the object transparent Creating a Button with Momentary Function In order to create a button with a momentary function, you need to combine a Set Tag action for Mouse Down with a Reset Tag action for Mouse Up . Related information Actions Ribbon Tab Script Component Library 7.3.8 Circular Meter Object The Circular Meter represents a numeric value, and displays the value of a connected tag.
Objects Angular Settings Group Parameter Description Start Angle / End Angle Determines the placement of the scale on the meter. The angular value is based on a start (0 degrees) at three o’clock, in a counter clockwise direction from there. The Start Angle must differ from the End Angle. Text Rotation Select Parallel to let the numbers follow the outline of the meter, or None to display the numbers aligned horizontally. Clockwise Determines rotation orientation, clockwise or counter clockwise.
Objects Needle Settings Group Parameter Description Analog Animation Animation that creates a smooth movement of the needle at value change. Oscillation Animation of needle initially oscillating around the new value. The function is only available in combination with Analog Animation. When Analog Animation is selected, it is possible to activate Shortest Path in the property grid under Appearance.
Objects 7.3.9 Chart Object The chart object is used to display values of connected array tags. Settings for the chart object are available from the General ribbon tab while the object is selected: Chart Settings Group Parameter Description Edit Series Add, remove and edit the current series for this chart Chart Types Choose chart type.
Objects Y1 Axis Settings Group Parameter Description Visible Set the visibility of the Y1 axis Grid Visible Set the visibility of the Y1 axis grid lines. Automatic Automatically calculates the minimum and maximum Y1 axis values. Overrides the Minimum and Maximum properties. Minimum Set the minimum value of the Y1 axis. If automatic is set, this value is ignored. Maximum Set the maximum value of the Y1 axis. If automatic is set, this value is ignored.
Objects The Edit Series Dialog Clicking the Edit Series control in the Chart Settings Group will open the Edit Series Dialog. The Edit Series Dialog contains the following settings: Parameter Description Name The name of the Series, as shown in the legend in the chart. X Tag The X Tag values. The tag must be an array tag. The number of elements shown will be the lowest common denominator of the X Tag array size and the Y Tag array size. Y Tag Optional: The Y Tag values for the chart.
Objects Settings Group Parameter Description Show Controls When the box is checked, the user is able to select database and database table in runtime Database Path to database to be loaded automatically in runtime(1) Table Name The table in the selected database to be loaded automatically in runtime(1) Browse Data Table Opens a browse dialog for selection of database and database table in design time. The path and table name will be added to the Database and Table Name fields.
Objects 7.3.12 Linear Meter Object The Linear Meter represents a numeric value, and displays the value of a connected tag. Different styles can be used to change the graphical profile of the meter, and also if the meter is to be horizontal or vertical.
Objects Tag/Security Group Parameter Description Select Tag Connection to a tag from the tags configuration page Select Security Groups Allows limiting access of the object based on security groups. If left empty, the object can be accessed by anyone. Select Visibility Configuration of visibility: Default: The visibility specified on the General tab of the Security Manager is used.
Objects Parameter Description Stretch Adapts height and width to the selection frame when resizing the picture. Lock Aspect Ratio Maintains the height/width ratio of the object. Note: Make sure not to use semi-transparent pictures in projects targeted for operator panel. Since these targets do not fully support opacity, semi-transparent pictures may turn out unclear. Related information Component Library 7.3.14 Picture Object The Picture object allows using a picture as an object.
Objects Settings Group Parameter Description Title Set the title for the Roller Panel Title Visible Determines if the title is visible or not Loop Scroll Determines if the values will loop around or not Disable Operator Input Determines if the Roller Panel is editable or not Touch Settings Group Parameter Description Scroll Sensitivity Set the sensitivity of the scroll Scroll Friction Set the friction of the scroll Text Group Parameter Description Configure Texts Opens the Configure Text
Objects Sliders in Chrome and Eclipse Horizontal styles, and Vintage Vertical style Settings for the slider object are available from the General ribbon tab while the object is selected: Value Scale Group Parameter Min Value/Max Value Description Start/end value of scale These values can consist of one decimal digit.
Objects Tag/Security Group Parameter Description Select Tag Connection to a tag from the tags configuration page Select Security Groups Allows limiting access of the object based on security groups. If left empty, the object can be accessed by anyone. Select Visibility Configuration of visibility: Default: The visibility specified on the General tab of the Security Manager is used.
Objects 7.3.18 Text Object The Text object is used to display read-only information for the operator. The displayed text can be static, or linked to intervals in a tag value that contain different strings. The text object can also be set to depend directly on a tag value using the General control on the Dynamics ribbon tab.
Objects Text Group Parameter Description Configure Texts Opens the Configure Texts dialog Configure Text Dialog The Configure Texts dialog contains the following properties: Parameter Description Text The text to be displayed for the item Start Value The starting value for when this item should be selected End Value The ending value for when this item should be selected Touch Settings Group Parameter Description Scroll Sensitivity Set the sensitivity of the scrolling Touch Combo Box Dynamics
Objects Text Group Parameter Description Configure Texts Opens the Configure Texts dialog Configure Texts Dialog The Configure Texts dialog contains the following properties: Parameter Description Text The text to be displayed for the item Start Value The starting value for when this item should be selected End Value The ending value for when this item should be selected Touch List Box dynamics It is also possible to set dynamics, i.e. tag dependent values for the Touch List Box properties.
Objects 7.4.1 Media Player Object Media files can be connected to the media player object, which allows selecting, starting and stopping the files in runtime. The table below shows the supported media formats for the various panels. Panel Supported Media Formats iX TxA, X2 base No media player object iX TxB, iX TxC .mpeg1, .wmv X2 pro 4, X2 control 4, X2 motion 4, X2 pro 7, X2 control 7, X2 motion 7, X2 marine 7, X2 marine 7 - SC .
Objects Settings Group Parameter Description Media Source Select a media file to add to the media player, from the project files folder or by browsing the PC Note: The object is not supported on iX TxA/X2 base targets. Simulation of the object on the development PC is supported only for PC targets. Note: Connecting a tag to a Media Player Object will cause the media player to try to play a media clip with a name that corresponds to the tag’s value, ignoring the configured Media Source parameter.
Objects Browse Folders Group Parameter Description Project Files Default option for browsing. The project files are listed in the Component Library. At least one of the folders has to be chosen. External Memory Card Select this option for browsing if project files are placed on an external memory card. At least one of the folders has to be chosen.
Objects Note: Microsoft Internet Explorer 9 or later is required. Settings Group Settings for the Web Browser object are available from the General ribbon tab while the Web Browser object is selected: Parameter Description Address The default web page of the web browser object. Home The web page that will be displayed when the Home button is pressed. Favorites Addition of web pages that will be available for selection from the drop-down address field in runtime.
Objects Function Limitation description PC targets operator panel targets Simulation of the web browser Simulation on the development PC Supported Not supported Support of some web pages Access of some web pages from within the web browser. Supported May not be supported. If the web browser does not behave as expected, it is recommended to use the standard Internet Explorer, available in the iX panel, instead.
Objects Item Settings Group Parameter Description Configure Items Definition of items included in the navigation list box object; see below. Height/Width Size of the items in the navigation list box. Margin Margin between navigation list box items. Border Width Width of navigation list box item borders. Corner Radius Corner radius of navigation list box items. Show Text Selection of whether to show text below navigation list box items.
Objects 7.5.2 Screen Carousel Object Screen navigation using the Screen Carousel object is performed via thumbnails in a 3D view. The screen carousel can be configured to rotate automatically, or actions can be configured to control screen carousel behavior. Note: The object is supported only for iX TxC and PC targets. Note: If the iX Developer system requirements for the graphic card are not fulfilled, the visualization of the object will have limitations. Hardware acceleration is required.
Objects Parameter Description Picture Selection of picture by browsing the PC environment or among the project files. Screen Selection of screen to navigate to. Script Info Optional text to serve as a reminder if scripts are used. Text Text displayed under each screen carousel item. Only visible if Show Text is checked under Item Settings. Use the up and down arrows to facilitate reorganizing of screen carousel items. Related information Actions Ribbon Tab 7.
Objects 7.7 Windows Controls The following Windows controls are described: Check Box Object Combo Box Object Progress Bar Object Radio Button Object 7.7.1 Group Box Object List Box Object Text Box Object – Check Box Object The Check Box object controls a digital tag value. The connected tag gets the value 1 when the box is checked and the value 0 when the box is unchecked. The appearance of the text can be adjusted in the Font group of the Home ribbon tab.
Objects 7.7.2 Combo Box Object A Combo Box can be used to create selections from a drop-down list. When a keyboard is connected to the operator panel it is also possible to make selections from the list by typing. Settings for the combo box are available from the General ribbon tab while the object is selected: Text Group Click Configure Texts to enter texts for different values. Select a tag, and then click Add until there are enough rows in the table. Enter texts and start values.
Objects When the screen opens, the script clears the box and writes the recipe name strings in the box. Selection from the combo box triggers loading of a recipe. Related information Script Recipe Management 7.7.3 Group Box Object The Group Box is used to draw a labeled frame around a group of objects. 7.7.4 List Box Object The List Box handles a list of predefined texts. Text Group Click Configure Texts to enter texts for different values.
Objects Select a tag, and then click Add until there are enough rows in the table. Enter texts and start values. It is also possible to use script code to control the contents of a list box. Example The following script code includes two objects on Screen1, a button (Button1) and a list box (ListBox1). When the button is clicked, the script is triggered and a string is written to the list box and the value of an internal counter (count) is incremented. Related information Script 7.7.
Objects Parameter Description Word Wrap Wraps the text to fit the width of the object. Not available if Autosize is selected. Auto Stretch Font Resizes the font to fit the height of the object. Not available if Autosize is selected. Auto Size Resizes the object according to the size of the default text string length and font size. Text Alignment Group Parameter Horizontal / Vertical Description Adjusts the radio button text horizontally or vertically. Not available if Autosize is selected.
Objects Radio buttons are grouped based on which screen they belong to. Related information Script 7.7.7 Text Box Object The Text Box is used to include a box with multiple rows of text. By default, the text can be modified when clicking on the box in runtime. The entered text is not saved in runtime; when the screen changes the value will be reset. The text box can also be configured as read-only.
Objects Related information Referenced Assemblies Error Related to Third Party Controls 7.8.1 Target Platform Different technologies are used for third party controls depending on the target platform for the iX Developer application. The target can be either PC or Windows CE. PC Two different technologies can be used for a PC: • Standard Windows forms and GDI+ • WPF (Windows Presentation Foundation) WPF uses vector graphics, and the appearance of the control is described in XAML.
Objects Caution: Beijer Electronics only offers limited support for thirdparty controls. 1. Select the Objects group on the Home ribbon tab, and fully expand the Objects toolbox by clicking the lower right arrow. 2. Click Add Control.
Objects 3. Select controls to add among the default controls, or click Browse to add customized controls. 4. Click OK. The added controls are now available under Additional Controls in the Objects toolbox. 7.8.3 Default Controls and Installed Controls Default controls include controls added by the user and the .Net 4 controls installed with the .Net Framework. Installed controls include all controls that are installed in the GAC (Global Assembly Cache) on your computer.
Objects or user controls for a PC. Controls developed in WPF can bind to a tag value in iX Developer. User controls and custom controls are supported in WPF. 7.9.1 WPF User Controls A WPF user control can be described as a composition of different user interface controls. Creating a WPF user control is similar to creating a window: • You have a XAML file and C# class file for a user control. • The class file extends the user control class, adding additional behavior and properties.
Objects 1. Start Visual Studio to create a new project, and select WPF User Control Library. 2. Add [DefaultProperty("Value")] to the class, to define which property the tag should set when the value is set. 3. Add a dependency property with same name as the attribute above: static readonly DependencyProperty ValueProperty; 4. Add a static constructor and register to the dependency property. 5. Create a Value property of type object. 6. Open the tab of the .xaml file. 7. Add a TextBox to the user control.
Objects Example Code 7.9.4 Creating a Windows Forms User Control for a PC Target The following example describes how to create a Windows Forms user control designated for a PC target. Note: Windows Forms control objects are placed on top of WPF control objects in PC targets.
Objects 1. Start Visual Studio to create a new project, and select Windows Forms Control Library. 2. Add a TextBox and a Button to the design surface. 3. Add Event Handler for Button click. 4. Add Event Handler for TextBox lost focus.
Objects 5.
Objects 6. Use the following code to connect the control to a tag value in iX Developer: The code shows how the value is set on the user control when the tag changes its value, and how the tag value is changed when the user control changes its value. 7.9.
Objects 1. Start Visual Studio 2005 or 2008 to create a new Smart Device Project. 2. Select Windows CE for Target platform. 3. Select Control Library. 4. Use the same code as in the Creating a Windows Forms User Control for a PC Target example.
Objects Note: Always test your code on the target platform, as properties/methods currently not supported may be included in the code. See Limitations for details.
Objects 210 Beijer Electronics, MAEN831P
Ribbon Tabs 8 Ribbon Tabs Each of the ribbon tabs holds a set of one or more groups. Each group holds a set of one or more controls that are used to manage screens and functions in a project. The behavior of the ribbon tabs can be configured to be context dependent using the Options button in the File menu. Double-click on any of the ribbon tab headings to collapse the ribbon area. A double-click on a ribbon tab, when the ribbon is collapsed, brings back the original style.
Ribbon Tabs Tag/Security Group Name Group 8.1.1 Clipboard Group The Clipboard group contains the paste, cut, copy and format painter controls. Cut Cuts the selection to the clipboard. Also available from the keyboard with [Ctrl] + x or from the context menu. Copy Copies the selection to the clipboard. Also available from the keyboard with [Ctrl] + c or from the context menu. Paste Copies the clipboard to the current screen. Also available from the keyboard with [Ctrl] + v or from the context menu.
Ribbon Tabs Related information Other Colors 8.1.2 Screen Group The Screen control group contains the add screen, background screen, delete screen and current language commands. Screens can also be added and deleted from other controls, such as the Navigation Manager and the context menu of the Project Explorer. Add Screen The Add Screen command creates a new empty screen that opens for editing.
Ribbon Tabs 8.1.3 Objects Group The Objects control group contains static and dynamic objects that can be added to a screen. Related information Objects 8.1.4 Object Variations For many of the objects it is possible to apply a preset style, using the Object Variations feature. For the Button object and the Circular Meter object there is a large number of different styles available as default, whereas for most other objects it is possible to save user-defined styles.
Ribbon Tabs The new variation will appear in the Object Variations menu when clicking on the object type it originated from. Objects supporting Save Variation Rectangle Ellipse Analog Numeric Button Text Linear Meter Slider Circular Meter Trend Viewer Chart Action Menu Animated Label Digital Clock Alarm Viewer - - The object properties are shown in the Property Grid.
Ribbon Tabs Variations saved (where applicable) Color Font Rotation Size Visibility Security groups required Audit trail description Delay Mouse/ Touch Input Visibility on access denied Opacity Horizontal and vertical alignment Picture horizontal and vertical alignment In addition to the general properties listed above, a number of object specific properties are saved: Object Property Action Menu Object View type Orientation Alarm Viewer Object Button position Analog Numeric Object Limit
Ribbon Tabs Note: Features only supported in PC environment might not work on other platforms. Related information Objects 8.1.5 Font Group All fonts available in the development PC are available for selection when designing the project. All fonts used in the project are included when downloading the project to the target. Note: For PC and iX TxC non-standard fonts are not transferred or installed to the target. Install non-standard fonts manually on the target.
Ribbon Tabs Style and Color An italic, underlined or bold style can be selected for the text. The style stays regular if all the boxes are left unchecked. Use the Font Color drop-down list to set the color of the text. 8.1.6 Format Group The Format group controls the color and position of a selected object. Predefined quick styles offer selection of uniform appearance for different objects. Selection of multiple objects makes it possible to easily affect more than one object at the same time.
Ribbon Tabs Order Objects The commands in the Order Objects group are used to send objects to the front or back of each other.
Ribbon Tabs Note: The Object Browser offers an easy way of arranging objects to the front or back of each other. Related information Object Browser Group Objects The Group Objects commands are used to manage selections of multiple objects. A grouped object is moved and treated as one object with respect to formatting and resizing, and can also be stored in the Component Library for reuse. Any selection of objects on the screen can be grouped.
Ribbon Tabs Note: Controls in the Style group on the General tab can be used to reshape objects such as meter, slider and trend viewer to predefined styles. These styles are not the same as the quick styles. Related information Font Group Other Colors Color settings for special properties of an object, for example scale color for a meter or out-of-range validation of an analog numeric object, are available from the Other Colors control.
Ribbon Tabs Parameter Description Select Tag Connection to a tag from the tags configuration page. Tags may also be added directly, but will be remain internal until connected to a controller tag. Click ... to configure expressions. Select Security Groups Allows limiting access of the object based on security groups. If left empty, the object can be accessed by anyone.
Ribbon Tabs Related information Project Explorer Invalid Names 8.2 Project Ribbon Tab The Project ribbon tab contains a number of project related functions, divided into the following groups: Run Group Transfer Group Project Group 8.2.1 Run Group The Run group enables validation, rebuilding, simulation and debugging of the project. Build The build control validates the script code and compiles the current project.
Ribbon Tabs Note: If project build fails, check that the absolute path to the project, including its components, does not exceed 260 characters. Note: Projects must be stored on the local hard drive for iX Developer to be able to run or simulate them. Simulate It is also possible to test and run the application on the development PC without connection to the selected controller, by clicking Simulate. If the project is valid, the simulation is started.
Ribbon Tabs Download The Download control sends the project to an operator panel or a PC with an iX Runtime installation, in the network environment. Parameter Description Connected targets Choose a target type to transfer the project to. Download Start the project transfer. Click the “Download all source code ( for later upload) ” check box to compress the project and save it as a ZIP file on target. Click the “Password protected” check box and enter a password to protect the ZIP file.
Ribbon Tabs Parameter Verify Description The verify function enables the user to check if a target platform configuration is identical to the project configuration. Verify is supported for iX TxA, X2 base, X2 control, X2 motion, X2 marine and X2 pro, iX TxB and iX TxC targets. If greyed out, please update to latest “System program”. Log Show the data being logged during the download and verify process.
Ribbon Tabs 3. The download dialog opens and all panels connected in the network are listed with information about IP address and panel type. Select the panel to download to in the list. 4. Check that the IP address is correct and click Download. a. Optional: Click the “Include compressed project” check box to compress the project and save it as a ZIP file. b. Optional: Click the “Password protected” check box and enter a password to protect the ZIP file. c.
Ribbon Tabs Parameter Description automatic the download of the project automatically starts, without any dialogs, when a project file is loaded to the storage device and the panel is rebooted path "\Storage Card\Project3" the path to the project, if multiple projects are stored on the storage device. SD cards use the path \StorageCard\ and devices attached to USB use \HardDisk\ applyipsettings applies saved IP settings deletesource deletes the source file from the storage device after the downloa
Ribbon Tabs Export Exports the project to a folder which is selected by the user. When exporting the project, the user might be prompted whether the panel IP settings should be set. If yes, the Target Settings dialog is opened. Assigning IP settings is only supported for iX TxA, iX TxB , X2 base, X2 control, X2 motion, X2 marine and X2 pro targets.
Ribbon Tabs Starting an iX Runtime project on a PC The different methods of transfer will have an impact on how the projects are started and stopped in the runtime PC. It is recommended to keep to one of the selected transfer methods to avoid problems. When a project has been transferred to a PC using the Download command, the project normally starts automatically when the computer is started.
Ribbon Tabs Back Up Project The project source files can be compressed into a Zip file using the Back Up Project command. The Zip file can be saved to a USB stick or, on the condition that a network connection is configured, directly to a folder in the runtime PC. Parameter Description Path to Zip file Browse to the location to save the Zip file. Password protected Optional password protection of the Zip file.
Ribbon Tabs Parameter Back up database at startup Description When using this option a backup is created at startup if the integrity check of the database succeeds. If the integrity check fails the previous backup is used. The drawback is that the databases use twice the space on disk and the startup time gets longer. If there is no backup available and the database has become corrupt, then the corrupt database is replaced by a new empty database.
Ribbon Tabs Command Description Reboot Reboots the target. Possible arguments: True and False. Using True, the target tries to start any project present. The argument False, or no argument, prevents the target from starting the project automatically. Wait Pauses the execution of the commands. This can be useful if the user runs commands that takes time for the target to recover from. Possible arguments: a number, indicating how many whole seconds to wait. Run Starts any given process.
Ribbon Tabs Post Transfer The same commands and macros as for the Pre Transfer can be used, but are executed after the file transfer. Note: Only available for PC. Related information Pre Transfer Display/Target Parameter Description No Title Bar(1) Displays the project without title bar in runtime. Title Bar Displays the project with its title and a set of minimize, maximize and close buttons in the title bar. Close Button Displays the project with its title and a close button in the title bar.
Ribbon Tabs Parameter Description Panel Rotate Displays selected rotation. It is possible to change the rotation of the panel and panel content by 0, 90, 180 or 270 degrees. Only available for T7A, T10A, X2 base, X2 control, X2 motion, X2 marine and X2 pro, and iX TxB targets. Panel Type Displays selected target. It is possible to select another target. (1) No Title Bar can not be used for popup screens.
Ribbon Tabs Mouse/Touch Input Delay It is possible to configure a delay of mouse and touch screen input in runtime. This setting is global and affects all objects for which Delay Mouse/Touch Input is selected. The Property grid is used to enable delay of mouse and touch screen input for individual objects.
Ribbon Tabs System Dialogs Parameter Description Font Select a system font that is used as the default font. Font Size Use the increase/decrease font size buttons or set a specific default font size.
Ribbon Tabs Parameter Description Enable Virtual Keyboard Select whether a virtual keyboard is to be displayed when alphanumerical input is needed. Keyboard Layout The following layouts are available for the virtual keyboard: Arabic, French, German, Hebrew, Italian, Korean, Russian, Simplified Chinese (Compact), Simplified Chinese, Spanish, Swedish, Traditional Chinese, US The virtual keyboard that is displayed in runtime depends on settings made for the Multiple Languages function.
Ribbon Tabs Example: You have the files "Iocomp.Instrumentation.CF2005.Ultra.dll" and "Iocomp.Instrumentation.CF2005.Ultra.WindowsCE.asmmeta.dll" in the same folder. Both have the same fully qualified assembly name (but different file names). Trying to add a control from the first assembly seems to work. However when the application uses namespaces in the XAML to locate the correct assembly it picks one of them, and it might be either of them.
Ribbon Tabs Choose SNTP time synchronization if the panel clock is to be synchronized against an external SNTP (Simple Network Time Protocol) server. Enter the name of the SNTP server and the time interval for the synchronization. Note: The SNTP time synchronization is supported from iX TxA version 703 and iX TxB version 231. The date and time display format (for example using AM/PM for time) is based on the operating system settings.
Ribbon Tabs Select to automatically turn off the backlight after a certain number of seconds, and whether to keep the backlight on if a notifier window (e.g. alarm indicator or communication error message) is visible. Backlight settings are supported only for operator panel targets. For other targets, the Microsoft Windows screen saver may be used. 8.3.4 Serial Ports Group For each of the COM ports, select if it is to be configured as an RS232, RS422 or RS485 port.
Ribbon Tabs 8.3.5 Servers Group The Servers group contains the FTP, Web Server, OPC UA Server and Remote Access commands. The FTP and Remote Access commands are only available when an operator panel is selected as target. FTP When enabled, it is possible to upload/download files to/from the operator panel provided that there is an FTP client program in the development PC, e.g. Internet Explorer, Windows Commander or some other standard FTP program.
Ribbon Tabs Parameter Description Enable Web Server Click this check box to enable the web server. Port Enter a server port number. Enable forms authentication Click this check box to enable forms authentication and enter user name and password. The password can be any alphanumeric string. The passwords minimum length is four characters and the maximum length is 20 characters. Related information Web Server OPC UA Server Enables the possibility to publish tags with an OPC UA Server.
Ribbon Tabs Parameter Description Enable OPC UA Server Click this check box to enable the OPC UA server. Port Enter a server port number. Allow anonymous login Click this check box to enable anonymous login. For a secured login enter user name and password and leave the check box unchecked. Address space All tags, except array tags, defined in project will be shown. The tags will be put in a folder named Tags in Namespace TagProvider on the server. The NodeClass of all tags will be Variable.
Ribbon Tabs 8.3.6 Output Devices Group Printer devices can be set up by clicking the Settings control in the Output Devices group. Printer Device USB Printer Connection When printing from a iX TxC/PC, the default printer in Windows will always be used if USB is selected as Printer Connector. Parameter Description Printer Connector Select USB Printer Type Select printer type. Selection possibilities: PCLINKJET and PCLLASERJET.
Ribbon Tabs Parameter Description Printer Connector Select Ethernet Printer Type Select printer type. Selection possibilities: PCLINKJET and PCLLASERJET. Printer supports PCL 5c Click this check box if the printer supports the PCL 5c color printer protocol. This option is only available if the printer type is set to PCLLASERJET.
Ribbon Tabs Parameter Description Printer Connector Select Serial Printer Type Not available Printer supports PCL 5c Not available Network settings Not available Serial Settings Port Name: Select which COM-port the printer is connected to Baud Rate: Select the baud rate for transmission of data. Data Bits: Select the number of data bits in each character. Parity: Set the parity bit. The parity bit in each character can be set to none , odd, even, mark or space.
Ribbon Tabs Parameter Description Serial Settings Page Length (lines): Select the number of lines to be printed out before form feed. Form feed will not take place if the page length is set to 0. Page Width (characters): Set the page width specified as the maximum characters in a single line of text. Code page: The code page consists of a table of values that describes the character set for a particular language. The default code page in iX Developer is 850.
Ribbon Tabs Related information Service Menu 8.4 Insert Ribbon Tab The Functions group, available from the Insert ribbon tab, contains functions and screen that can be added to the project. Functions Group 8.4.1 Functions Group All added components are available from Project Explorer folders. The Project Explorer already includes alarm server, multiple languages, security functions and tags. All functions are managed through their configuration pages.
Ribbon Tabs Related information Project Explorer Configuration Pages 8.5 View Ribbon Tab The Windows group, available from the View ribbon tab, contains controls to toggle visibility of the tool windows: Windows Group 8.5.1 Windows Group The tool controls in the Windows group are highlighted when active.
Ribbon Tabs 8.6 Dynamics Ribbon Tab The Dynamics ribbon tab includes the following groups: Layout Group Color Group General Group The controls on the Dynamics tab are used to change the properties of an object depending on a changed tag value. A lock icon resembling a chain indicates that a specific dynamic setting is made for the selected object. If, for example, dynamic fill settings are made, it is not possible to make fill settings for the object from the Format group on the Home tab.
Ribbon Tabs Position coordinates on the screen are given in pixels of the screen resolution. The position 0,0 corresponds to the upper left corner of the screen. To move an object vertically when a tag value changes: 1. Draw and position the object at the start position. Keep the object selected. 2. Click on Move on the Dynamics tab to open the Move Dynamics Editor. 3. Select the tag to control the movement. 4. Enter a start and end value for the tag.
Ribbon Tabs Dynamic resizing of external picture files may result in a resolution loss if the picture is enlarged to a size larger than what is used elsewhere in the current project. Width and height of an object are given in pixels of the screen resolution. To resize the width of an object when a tag value changes: 1. Draw and size the object at its start size. Keep the object selected. 2. Click on Size on the Dynamics tab to open the Resize Dynamics Editor. 3. Select the tag to control the resizing. 4.
Ribbon Tabs 8.6.3 General Group Visibility The Visible control in the Visibility group determines if an object is to be displayed in the screen or not, based on a tag value. To hide an object when a tag value changes: 1. Draw the object. Keep the object selected. 2. Click on Visible on the Dynamics tab. 3. Select the tag that is to control visibility. The object will be visible on the screen at a certain tag value. The selected value will be treated as True (visible).
Ribbon Tabs Note: Security has higher priority than dynamics. Visibility has higher priority than blink. Related information Blinking Objects General The general control offers a possibility to alter the properties of objects in iX Runtime. Converter Operators Converter operators are used to alter the properties of the objects. The converter operators can be selected from the Edit general dynamics dialog. Parameter Description Bool Converter Converts 0 to false and all other values to true.
Ribbon Tabs Edit General Dynamics The Edit general dynamics dialog contains different properties depending on which object is selected. The dialog is accessed by clicking the General control on the General group. Parameter Converter Object Description 3D View ·bool Chart Set a 3D look and feel for the chart Acknowledge all ·bool Alarm viewer Set visibility for the Acknowledge All button. Acknowledge selected ·bool Alarm viewer Set visibility for the Acknowledge Selected button.
Ribbon Tabs Parameter Converter Column header color ·color interval End angle ·raw Object Description Set the column header background color. Circular meter Set the end angle. ·linear PDF-file ·raw PDF viewer Select PDF file to add to the PDF viewer. Alarm viewer Set visibility for the filter button. ·text library group Filter ·bool Font color ·color interval Set font color in for instance the text object. Font size ·raw Set font size in for instance the text object.
Ribbon Tabs Parameter Converter Object Auto-scale X-axis ·bool Chart Used with the chart object to toggle whether iX Runtime automatically should calculate the minimum and maximum X Axis values or not. Show X-axis grid ·bool Chart Set visibility for the X Axis grid. Show X-axis ·bool Chart Set visibility for the X Axis. Auto-scale Y1-axis ·bool Chart Used with the chart object to toggle whether iX Runtime automatically should calculate the minimum and maximum Y1 Axis values or not.
Ribbon Tabs Parameter Max value Converter ·raw Object Trend viewer Set the end value of the scale. Trend viewer Set the start value of the scale. Trend viewer Set the number of scale ticks between two adjacent major ticks on the scale. ·linear Min value ·raw ·linear Minor value ticks ·raw Description ·linear Medium region color ·color interval Circular meter Set the medium region color. Medium region max ·raw Circular meter Set the maximum value of the medium region indicator.
Ribbon Tabs Parameter Radius X Converter ·raw Object Rectangle Set the radius of the X axis in the rectangle object. Rectangle Set the radius of the Y axis. ·linear Radius Y ·raw Description ·linear Scale color ·color interval Circular meter Set the scale color. Scale ·bool Circular meter Set visibility for the scale. Selected background ·color interval Action menu Set the background color of the selected action.
Ribbon Tabs Parameter X1 Converter ·raw Object Description Line Set the X1 pixel coordinates Line Set the X2 pixel coordinates Line Set the X3 pixel coordinates Line Set the X4 pixel coordinates ·linear X2 ·raw ·linear X3 ·raw ·linear X4 ·raw ·linear X-axis grid color ·color interval Chart Set the grid color of the X axis. X-axis max value ·raw Chart Set the maximum value of the X axis.
Ribbon Tabs Related information Special Controls in the Objects group Windows Controls in the Objects group Tag/Security Group on the Home Ribbon Tab 8.8 Actions Ribbon Tab Actions can be triggered in various ways, for example by clicking a button. The Actions tab controls are used to define actions for objects. Alternatively, a script can be used to trigger an action. An action is something that is performed, for example closing a screen.
Ribbon Tabs Parameter Description Mouse Enter A Mouse Enter action will be performed when the cursor enters the boundaries of an object in runtime. Mouse Leave A Mouse Leave action will be performed when the cursor leaves the boundaries of an object in runtime. For iX TxA, X2 base, X2 control, X2 motion, X2 marine and X2 pro and iX TxB targets the object boundaries are not adapted to the visible outline of the shape. Instead the active area of the object is extended to a rectangular box.
Ribbon Tabs 8.8.5 Tags Action Triggers Parameter Description Value Changed (tag will always be active) The tag will always be active. Value Changed (tag will be polled as needed) The event will only trigger if the tag is active. The tag can be deactivated if it is not in use by anything else. When the tag is deactivated the event will remain idle until the tag is activated. 8.8.
Ribbon Tabs Action group Screen Action Close Screen Description Closes the current screen If triggered from a tag in a popup screen, this will close both the popup and the parent screen. Print Screen Prints the current screen on printer or to a .PNG file. Selecting Print to file enables the following options: Project files folder: The file will be saved in a folder named “Project Files” in the projects execution path. Browse: A save dialog will be shown in runtime. (PC only).
Ribbon Tabs Action group Chart Database Datalogger Output Devices Recipe 266 Action Description Pan Down Pans down in selected chart Pan Left Pans left in selected chart Pan Right Pans right in selected chart Pan Up Pans up in selected chart Reset View Resets any panning and zoom in selected chart Zoom In Zooms into selected chart Zoom Out Zooms out of selected chart Back Up Alarm, Data Logger and Recipe Database Performs a backup of the project database Back Up all Databases for re
Ribbon Tabs Action group Reporting Action Generate Report Description Generates a report file that can be output to a printer or saved as an Excel file. Selecting “File” enables the following options: Project files folder: The file will be saved in a subfolder named ”Reports” in the “Project Files” folder. Browse: A save dialog will be shown in runtime. (PC only). Path: The file will be saved to a specified path. (PC only).
Ribbon Tabs Action group Action Description Show Dialog: Lets the user select a period of time, for which to show trend viewer history. Other Change Active Controllers Defines which controllers are to be active after having restarted the project Run Script Executes a script method saved in a script module. Close Application Closes the runtime application. Copy Debug Log to USB Memory Copies the debug log to a USB memory. Disable Debug Logger Disables the debug logger.
Ribbon Tabs 8.8.11 Script Action Script actions are used to execute script methods in script modules, triggered by actions. Script modules in the project can be selected, and for each script module all methods are listed along with their exposed parameters. Static methods are not supported. To apply a script to a selected object: 1. Go to the Actions group and select the appropriate action trigger. 2. Select action Run Script under Other. 3. Select one of the scripts from Script Modules. 4.
Ribbon Tabs 8.8.12 Multiple Actions Multiple actions can be configured by clicking small arrow in the lower right corner of any action group. Note the small arrow in the lower right corner The properties window allows configuring and sorting additional actions. The actions available depend of which object is selected in the screen prior to selecting the Actions ribbon tab. After configuring multiple actions, this is indicated for the action group on the Actions tab.
Trend Viewer 9 Trend Viewer This section describes the trend viewer object. Trend Viewers are used to present chronological data from controller tags. The curves in a trend viewer can have different sources of data. The source of data can be a log item for a data logger. The values of the tag connected to the log item is then stored in the projects database. The source can also be a Tag. The trend viewer curve then only shows real-time values and is stored in a RAM cache.
Trend Viewer Parameter Description Add Adds a new curve to the trend viewer object Remove Removes the selected curve from the trend viewer object Name The symbolic name of the curve. This name is shown if a Trend Viewer Legend is used. Tag The tag to present values for Log Item The item to be logged Expression Expression on a curve is evaluated and applied when the curve is drawn.
Trend Viewer Value Scale Group The value scale group controls the vertical scale (y-axis). If dynamic trend viewer properties are used, the settings made for these properties in the value scale group will be ignored.
Trend Viewer 9.2 Historical Mode in Trend Viewer To be able to show historical data in a trend viewer, the curves needs to be connected to log items from a data logger. To show trend viewer history, it is necessary to define trend actions to show and close the historical trend viewer. These actions can for example be programmed as button click actions. It is also possible to let the user select a time period. Major ticks settings for time axis will be ignored in historical trend viewers.
Data Logger 10 Data Logger Data can be logged and saved in the iX Developer database. Any number of tags can be connected to a data logger, and data values irrespective of type can be logged. A project can have multiple data loggers with different sampling alternatives. If you want to open a database file to inspect logged data, then you need to install an appropriate third party database viewer tool.
Data Logger 10.1.2 Logging Based on Changed Tag Value To control sampling of data by other means than regular time interval, you have to set up a separate tag to be used as a trigger. When the value of the trigger tag changes the log item is logged. 10.1.3 Maximizing the Lifetime of the Storage Media The storage media in the iX panel is based on Flash SSD (Solid State Drive). Flash SSD has no moving or mechanical parts, which gives high and reliable performance.
Data Logger Parameter Description Name Symbolic name for the logged tag Tag Tag to log Expression See section Expressions Clicking the Settings button accesses the Data Logger settings. Related information General Settings Actions 10.2.1 General Settings Parameter Description Log with interval To collect data that changes frequently, use the Log with interval of option, and define time interval in seconds. Minimum interval is 1 second.
Data Logger 10.2.
Scheduler 11 Scheduler A scheduler is used to control tags in relation to the real-time clock. This function is used to control events in the process, for example starting and stopping motors, at specific predefined calendar times. 11.1 Scheduler Set Up The scheduler configuration pages are used to set up scheduler jobs, which can include a set of tags with associated start and stop times. 11.1.1 Adding a Scheduler A scheduler can be added to the project from the Insert ribbon tab.
Scheduler 280 Beijer Electronics, MAEN831P
Reports 12 Reports The report generator allows generating Excel reports based on an Microsoft Excel made report template. The generated report can be output to a printer or saved as an Excel file. 12.1 Reports Template Set up The tag data to be displayed in the report file are set up in the template file using “placeholders”. The placeholders acts as substitute for the actual tag data that is to be inserted when the report is generated in iX Runtime.
Reports Configuration Sheet The configuration sheet is a repository where configurations on the Microsoft Excel report template can be made. This sheet is not visible in the generated report. 1. Create a new worksheet in the report template. Name the sheet <#Config>. 2. Row 10, and all rows below, in column A and B can be used to configure the SQL queries. Enter the SQL query in column B. Use the corresponding cell in column A to enter a name for the query.
Reports 12.3 Adding a Report Add a Microsoft Excel report template by pressing Add in the reports configuration page. In the appearing Add report dialog, type in or browse to the location of the Excel template file. If any changes are made to a report template after it has been uploaded to the project, the template has to be uploaded again. The template files being added to the project must have unique file names. Parameter Description Name A symbolic name for the report.
Reports 284 Beijer Electronics, MAEN831P
Recipe Management 13 Recipe Management Recipes make it possible for a set of tags to be saved in the operator panel to be downloaded at later time. The operator can download a saved recipe to the controller, which will start working with the new values. Recipe libraries consisting of recipes with different sets of parameters can be created, allowing reuse of large sets of parameters. Recipes can be created during the design of the project or from the operator panel.
Recipe Management Runtime Data Tab The actual recipes are created under the Runtime Data tab. Give the recipe a title, and type a value for each recipe item. A recipe can include a maximum of 256 items. The recipe name has to be an alphanumeric string, beginning with a letter. Name strings can contain letters (a-z, A-Z), numbers (0-9), and underscore (‘_’) characters. Some system device names such as COM1 and AUX are invalid.
Recipe Management 13.2 Recipes in the iX panel Some recipe actions can be performed by the operator in runtime. 13.2.1 Loading Recipes Recipes can be transferred to the controller using a Load recipe action when the operator panel is running. This means that the recipe values are transferred to the controller. A list of available recipes is displayed when the Load recipe action is activated. Select a recipe in the list and press [Enter] to make the controller run with the downloaded values. 13.2.
Recipe Management Action Description Start offline recipe editing Sets the tags in the specified recipe in offline mode. A notification message is shown. End offline recipe editing Sets the tags in the specified recipe in online mode, and the tags are updated from the controller. A notification message is displayed during offline mode. Example 1. Click Recipe on the Insert ribbon tab. The Recipe configuration page opens in the desktop area. 2.
Recipe Management 13.3.1 Recipe Export from an Operator Panel Target It is possible to select Export to the Project Files Folder, Export to USB, or Export to external memory card, and also to set another name of the export file. It is also possible to select the requested delimiter in the .csv file (comma or semicolon).
Recipe Management 13.3.2 Recipe Export from a PC Target It is possible to select Browse and Select an export path, Export to Path or the Export to Project Files folder, and also setting another name of the export file. The Browse and Select an export path option allows browsing for desired export destination in runtime. This may be useful if available folders in runtime are unknown when designing the project. Select the Export to Path option when you want to set the path when designing the project.
Recipe Management Note: Recipe import is not supported during project simulation. 13.4.1 Recipe Import to an Operator Panel Target It is possible to import the csv file using the Import from USB, Import from external memory card or the Import from Project Files folder selections and also setting the name of the import file. It is also possible to select the requested delimiter in the .csv file (comma or semicolon).
Recipe Management 13.4.2 Recipe Import to a PC Target It is possible to select Browse and Select a path for import file, Import from path or Import from Project Files folder, and also setting the name of the import file. The Browse and Select a path for import file option allows browsing for desired import destination in runtime. This may be useful if available folders in runtime are unknown when designing the project.
Function Keys 14 Function Keys Function keys can be configured to run actions or to run scripts. 14.1 Definitions A standard PC keyboard has 12 function keys, F1 - F12. A function key can be configured to affect only a particular screen or to be global. Global function keys behave identically for all screens. A global definition can always be accessed when the operator panel is running, provided that the current screen does not have a screen definition for that function key.
Function Keys 4. Click on the button next to the action to display the actions editor. Define the action to be performed when the function key is pressed or released. 5. In the column Security groups required it is possible to specify security group accessibility for the function key. Multiple actions can be configured for a function key. It is only possible to activate two tags connected to function keys at the same time.
Function Keys 14.2.2 Function Key Scripts To define a script for a function key: 1. Click on Function Keys in the Project Explorer to open the function keys configuration page. 2. Select the function key to be defined. 3. Select script view mode by clicking Script in the lower part of the desktop area. 4. Click on the desired button node. Double-click on the KeyDown node. Edit the script code to be performed.
Function Keys Change of Screen During Momentary Execution There are a few special cases to be aware of when, during execution of the momentary function, another screen is opened that contains settings for the function key in use. Then, dependent on the Function Key Context settings, Global or Screen (local), there will be different outcomes: • Case 1: A local function key is pressed. A change to another screen occurs. Result: The up action for the local key is executed.
Alarm Management 15 Alarm Management An alarm is used to call attention to an event that requires immediate action. An alarm is set when a certain condition is met. An alarm condition is designed as a logical evaluation of a tag value. Alarms can be divided into groups to create an order of priority.
Alarm Management The Properties window is divided into General, Alarm Distribution and Actions. 15.2.
Alarm Management Log Settings Parameter Description Max Number of Logged Rows The maximum number of alarms to save in the database. If the number of collected items becomes larger than the set value, the oldest item will be deleted. The value must be within the size of the available amount of memory in the operator panel in runtime. Repeat Counter To avoid that an alarm that is triggered repeatedly results in multiple entries in the alarm list, Repeat Count can be used.
Alarm Management Alarm Normal The specified actions are triggered once for each acknowledged alarm, for which the alarm condition is no longer met. Alarms Changed This event is intended primarily for scripting, in order to avoid performance loss that may occur when many alarms change status at once. Alarms Changed includes status changes based on Alarm Acknowledge, Alarm Active, Alarm Normal and Alarm Inactive, but not Alarm Deleted.
Alarm Management Parameter Description Internal/External Selection of internal or external alarm distributor IP Number Server The IP address of the external alarm distributor Queue Length The number of alarms to be kept in queue for the external alarm distributor. When the queue is full, no more alarms will be added to the queue. Port Number The port number of the external alarm distributor Related information Alarm Distributor Alarm Groups Alarm Items 15.
Alarm Management Alarm condition Default alarm indication Description Acknowledged The alarm condition is met, and the alarm is acknowledged Flashing green Normal The alarm has returned to normal condition, and has been acknowledged - Related information General Settings 15.4 Alarm Items Alarm items are added from the Alarm Items tab of the alarm server configuration pages. Click Add to define a new alarm.
Alarm Management Parameter Description Trigger Value Numeric value to trigger alarm with when: = true. History Specifies when the alarm is to be removed from the alarm list. Checking this box means that the alarm will remain in the list until the list is full. Leaving it unchecked means that the alarm will be removed from the list when it is acknowledged and no longer active.
Alarm Management Related information Importing and Exporting Tags Tag Import Example 15.5 Alarm Groups Alarms can be divided into groups, for example to indicate the priority of the alarms. One alarm group is defined by default. Color attributes can be individually set for each alarm group. Alarms can be sorted by group in the Alarm Viewer. 15.5.1 Defining Alarm Groups Alarm groups are added from the Alarm Groups tab of the alarm server configuration pages.
Alarm Management 15.6 Actions and Events for Alarm Items and Alarm Groups Actions can be configured for individual alarms or for alarm groups. One or multiple actions can be configured when a particular alarm event occurs for the current alarm or alarm group. Actions for individual alarms are configured from the Action column for the alarm on the Alarm Items tab. Actions for alarm groups are configured from the Action column for the alarm group on the Alarm Groups tab. 15.6.
Alarm Management 15.7 Remote Alarm Server The alarm server in the iX Developer project can operate as a stand-alone alarm server, processing alarms and showing these in the Alarm Viewer and alarm indicator. Alternatively, the alarm server can distribute alarms to clients. Each alarm server can function as alarm server and/or alarm client. The remote alarm server functionality is set up via properties. 15.7.
Alarm Management Property Description Maximum number of alarm events to distribute The number of events to distribute to the clients. The number of distributed alarms affects performance. Server Mode The alarm server can assume the following modes: Disabled: The alarm server is disabled and no alarms are processed Local: The alarm server processes alarms of its own. Remote: Alarms are distributed to remote clients.
Alarm Management 15.8 Alarm Distributor The Alarm Distributor makes it possible to send alarm notification via printer, SMS or e-mail. The function can be enabled internally in a project, or in another operator panel that acts as a server towards several connected clients. Regardless of acting as server or client, distributed alarms are saved temporarily in the local project database to ensure that information is not lost in case of e.g. interrupted power.
Alarm Management Action Component Location Enabling distribution of alarm groups or individual alarms Alarm Server Alarm Groups or Alarm Items tab Configuration of alarm distribution routes Alarm Distribution Server Receivers, Alarm Filter and Scheduler tabs Configuration of alarm distribution devices Alarm Distribution Server Configure Distribution Devices button (e-mail, printer and/or SMS) Using External Alarm Distribution Server Functions (Acting as Client) The following actions are require
Alarm Management Route A route defines a number of filtering rules for distribution of alarms. Multiple routes makes it possible to send different kinds of notifications to various receivers. Receivers Tab The receivers of distributed alarms for each route are set up on the Receivers tab. Address Book Click on the Address Book button to enter names, e-mail addresses and/or phone numbers of the persons that are to be available for selection for distributed alarm messages.
Alarm Management The contents of the address book can be exported as a .csv file, and then be imported again after modification using the Import/Export button. Related information Filtering Items Receiver Selection Click on the Receiver Selection button to set up receivers of each alarm distribution route; via e-mail, SMS and/or printer. The selected receivers are displayed under Receivers. Alarm Filter Tab Filtering of each alarm distribution route can be configured on the Alarm Filter tab.
Alarm Management if all conditions are fulfilled. An empty string does not generate a filter condition (acts as a “wild card”). Parameter Description Alarm Name The alarm item to distribute. Alarm Group The alarm group of which alarm items are to be distributed. Alarm Text All alarms including this text will be distributed. Alarm Status(es) to distribute Selection of alarm to be distributed, based on alarm status. At least one status must be selected.
Alarm Management Parameter Description Period Select daily or weekly alarm distribution Day Select weekday, if Weekly was selected for Period Start Time/Stop Time Select start and stop time of the alarm distribution Name The name is automatically filled in based on start and stop time, and cannot be edited 15.8.3 Configure Distribution Devices Click the Configure Distribution Devices button to set up the different devices.
Alarm Management Number Variable Description 8 NormalTime The time the alarm became normal 9 AcknowledgeTime The time the alarm was acknowledged 10 AlarmGroupName Alarm group name 11 AlarmGroupText Alarm group text E-mail Device Parameter 314 Description From Name The name of the sender of the e-mail From E-mail Address The e-mail address of the sender of the e-mail SMTP Server Name/IP The name or IP address of the SMTP server for sending e-mail Port The port number of the e-mail
Alarm Management Parameter Advanced Encryption Description Clear the check box to use only RSA encryption. Select the check box to use advanced encryption, like DSS, DHE and DH (1). Code Page The code page consists of a table of values that describes the character set for a particular language. The default code page in iX Developer is 65001 (UTF-8).
Alarm Management SMS Device To be able to send alarms via SMS, you have to purchase an SMS Gateway Service.
Alarm Management Related information Modifying Alarm Distribution Settings in Runtime 15.10Alarm Viewer The Alarm Viewer can be used to show more detailed alarm information than the alarm indicator. Alarms presented in the Alarm Viewer presents alarm texts from the alarm server. The alarm list shows the latest alarms. It is arranged in alarm group order.
Alarm Management 15.10.
Alarm Management Alarm Indicator Alarm Viewer Distribution via SMS, e-mail or printer via the Alarm Distributor 15.11.
Alarm Management 15.11.5 Info Button Pressing the Info button in the Alarm Viewer triggers the action specified in the Alarm Event Info Requested group on the Actions tab, when an item in the alarm server is selected. Any action in the list can be selected. This action will be applied for the individual alarm first. If no action is specified for the alarm, the action will be applied for the group. If no action is specified for the group, the action will be applied for the alarm server.
Security Management 16 Security Management Using security groups and passwords in the operator panel makes it possible to create a security system for the project. Operators can easily be assigned different authorizations in the project to restrict access to objects and functions. Security group information and passwords are stored in the project database. It is not necessary to use this function if unrestricted access is acceptable. The security function is a predefined component of the Project Explorer.
Security Management Note: The automatic logout will not be carried out if a communication error (COM error) is active in the panel. After removing the communication error from the panel, the automatic logout will be performed within the specified time, calculated from when the communication was reestablished. 16.1.1 Password Rules Properties Allows setting a minimum number of characters for passwords. Related information Logging In and Logging Out 16.
Security Management Parameter Description Name Any alphanumeric string, beginning with a letter (a-z, A-Z) Users Selection of users defined on the Users tab to be included in the group Users Invisible in Runtime When the box is checked, the users in the current group will not be available for selection from the Login dialog in runtime. It will still be possible to type in the user name and password to login.
Security Management 16.3.1 Logging In and Logging Out The login dialog can be displayed in runtime by, for example, clicking a button, for which the Login action has been specified. It is possible to change password from the login dialog. The login dialog lists all users that have been configured for the current project, except for users in groups for which Users Invisible in Runtime was selected.
Security Management Note: Security has higher priority than dynamics. It is not possible to set security on function keys. The visibility and behavior settings specified in the security manager will be used when a security group is set but no explicit visibility is specified. The following options can be set: Visibility Description Default The object looks normal and is visible for anyone. Disabled Only users in the selected security groups can affect the object.
Security Management 326 Beijer Electronics, MAEN831P
Language Management 17 Language Management iX Developer supports multilingual applications. Translation of texts and system texts can be performed directly in the application, or via export to a text file to be translated in other software. The file is imported to the application after translation. The application language can be changed in runtime, for example based on a tag value. 17.
Language Management Note: The size of the virtual keyboards vary between languages. Examples of keyboard sizes (the values are approximative) • • • • • • Arabic: 18 MB Chinese - simplified: 12 MB Chinese - traditional: 36 MB Hebrew: 6 MB Korean: 21 MB Latin alphabets: 0.1 MB. Each added language is assigned an index number. Index number 0 is reserved for the default language (the language that the application was first created in). The Add and Delete buttons can be used to add and delete languages.
Language Management Use the Show Selection/Show All button if you want to filter the current view. The Import/Export button can be used to export a system language to a text file for translation, and then import the language after translation. Note: Regional expressions for time, date, and weekdays are by default equal to the settings in the system account, but can to some extent be changed in the Date, Time and Region Group under the System Ribbon tab.
Language Management Use the Show Selection/Show All button if you want to filter the current view. The Import/Export button can be used to export a system language to a text file for translation, and then import the language after translation. Note: When an object is connected to a text in the Text library, the object’s internal denomination (that is not displayed in runtime) will be presented in grey color in the Texts list, to indicate that editing the text will not affect the runtime project.
Language Management The Text IDs tab consist of the following columns: Text ID, Default Text and one column for each language. The text in the column Default Text corresponds to the default language used in iX Developer. Clicking Add adds a row with a Text ID that is equal to the highest existing Text ID plus 1. Use the Show Selection/Show All button if you want to filter the current view.
Language Management Parameter Description Add Adds a row with a Text ID that equals to the highest existing Text ID plus 1 Reset Removes the Text ID connection and the text falls back to the previously unconnected text OK Connects the object text to the selected Text ID Cancel Closes the popup list. No changes are made.
Language Management In addition, it is also possible for the graphical components to set a Default Value Used in Design Mode. This value will be displayed in the object in design time, but not be used in runtime. Parameter Description Add Adds a tag/alias Reset Removes the Dynamic Text ID connection and the text falls back to the previously unconnected text OK Connects the object text to the selected tag/alias Cancel Closes the popup list. No changes are made.
Language Management keys. If no keys are entered iX Developer uses Microsoft Translator to translate a limited number of words per month. Note: Automatic translations provide limited functionality; especially combination of words or words with synonyms may be returned as incorrect translations. The translation tool is available by clicking Translate on the Texts or System Texts tabs of the Multiple Languages configuration pages. Each language is translated separately.
Language Management Parameter Description Translation Provider Select translation provider among available providers. Microsoft Translator Client Id Type a Client Id. You need to get an account on Windows Azure Marketplace and subscribe to Microsoft Translator API to get a Client Id and a Client Secret. Microsoft Translator Client Secret Type a Client Secret key. You need to get an account on Windows Azure Marketplace and subscribe to Microsoft Translator API to get a Client Id and a Client Secret.
Language Management Parameter Description Format Select format of the exported file; text file or Excel file. Path Browse to the location for the exported file Delimiter If Text file format was selected, select delimiter from the drop-down list; comma, semicolon, space or tab Languages Select which languages to export The exported file will also include the default language.
Language Management Parameter Description Format Select format of the file to import; text file or Excel file. Path Browse to the location of the file to import Languages Select which languages to import Import Strategy Selecting Key performs the import according to the Designer and Object columns in the multiple languages configuration page. Reference Text performs the import according to the Text column.
Language Management 338 Beijer Electronics, MAEN831P
Audit Trail 18 Audit Trail The Audit Trail function makes it possible to track operator actions. The Audit Trail database can be exported in csv format using the Database Export action. It is recommended to use the database export method rather than the backup method. Related information Database Export 18.1 Logging Strategies To meet FDA (Food and Drug Administration) demands, it is possible to log actions in a strict manner. FDA logging implies that no log entries will ever be overwritten.
Audit Trail Parameter Description Log All/Log None Click the buttons to quickly select all or no actions from the list Logging strategy Select FDA or Cyclic Buffering Max size of database The maximum size of the Audit Trail database Value change on tags, performed by user actions, can be logged by selecting Log to Audit Trail in the tags configuration page. This option is enabled only if the audit trail function is activated in the project. Related information Others in Adding Tags section 18.2.
Audit Trail 18.3 Audit Trail Viewer The Audit Trail Viewer is selected from the Objects group on the Home ribbon tab. It displays the information from the Audit Trail database. Selecting Configure Columns on the General tab when the Audit Trail Viewer object is selected makes it possible to choose and configure columns to display in runtime. 18.4 Audit Trail Export An audit trail database can be exported as a .csv file and saved to a USB stick, an external memory card or to the project files folder.
Audit Trail 18.4.1 Audit Trail Export from an iX panel Target It is possible to select export to USB, export to external memory card or export to the Project Files folder, and also setting another name of the export file. It is also possible to select the requested delimiter in the .csv file (comma or semicolon). 18.4.
Audit Trail Select the Export to Path option when you want to set the path when designing the project. If the pre-defined path is not valid in runtime, the operator may browse the PC environment by clicking a browse button. It is also possible to select the requested delimiter in the .csv file (comma or semicolon).
Audit Trail 344 Beijer Electronics, MAEN831P
Text Library 19 Text Library With the text library function, text tables can be created, where values are linked to texts. The text library function can be used for presentation of each sequence step in sequence control. Another possible application is to present error codes, where an analog signal generates error codes connected to texts in a text library. The function can also be used to give analog values specific values, depending on the selected texts.
Text Library 19.1 Connecting Objects to Text Library Texts Perform the following steps to connect an object to a text library text: 1. Select the object on the screen. 2. Click on General on the Dynamics tab. 3. Select the Text property, and select Text Library Group Converter. 4. Browse to the tag and select the text library group. The object will now present the texts from the text library instead of the value. 19.
Database Export 20 Database Export Some databases in the project can be exported as a .csv file to a USB stick, an external memory card or to the project files folder. The following databases are available for csv export: alarm server, audit trail, data logger and trend viewer. Database export is not supported during project simulation. Tip: To display certain characters (such as Chinese or Arabic) correctly in Excel, import the csv file as text, and set the file origin to Unicode (UTF-8). 20.
Database Export 20.1.1 Database Export from operator panel Target It is possible to select export to USB stick or external memory card, and also setting another name of the export file. Leaving the Overwrite box unchecked adds date and time to the export file name, thus avoiding overwriting an existing export file.
Database Export It is possible to set another name of the export file. Leaving the Overwrite box unchecked adds date and time to the export file name, thus avoiding overwriting an existing export file. The Browse and Select an Export Path option allows browsing for desired export destination in runtime. This may be useful if available folders in runtime are unknown when designing the project. Select the Export to Path option when you want to set the path when designing the project.
Database Export 350 Beijer Electronics, MAEN831P
Database Cleanup 21 Database Cleanup The Database Cleanup action can result in reduced database size and better database performance. The following are some scenarios where this action could be used: • When a large amount of data is deleted from the database file it leaves behind empty space. This means the database file might be larger than necessary. Running the Database Cleanup action reclaims this space and reduces the size of the database file.
Database Cleanup 352 Beijer Electronics, MAEN831P
iX panel System Software 22 iX panel System Software In the operator panel, iX Runtime comes pre-loaded on delivery. iX Runtime can be replaced, that is, updated to a newer version, either via PC or via external memory card. An Image Loader is used to download system programs to the operator panel via a PC. The Image Loader is available from the web site. Note: When updating an operator panel, it is important to ensure that power is not interrupted during the transfer.
iX panel System Software 22.2.2 Service Menu in iX TxA/iX TxB/iX TxBR/X2 base/X2 control/X2 motion/X2 marine/X2 pro Panels Perform the following steps to enter the service menu: 1. Apply power to the panel. 2. When the hourglass appears, press a finger on the screen and hold for approximately 20 seconds. 3. If the service menu is password protected, you will be prompted for a pin code. Enter pin code. 4.
iX panel System Software If there is already a stored project in the target panel, the copy command will result in a dialog asking if a backup of the existing project should be saved on the memory card. If IP settings are stored in the memory card, a dialog will appear, asking if the IP settings should be applied to the target panel. It is necessary to reboot the panel for the IP address to be updated.
iX panel System Software 7. Reconnect power to the operator panel. 8. Once the system files have been updated, a project can be downloaded to the operator panel. Note: When updating an operator panel, it is important to ensure that power is not interrupted during the transfer. Transfer procedure in iX TxB/iX TxBR panels The image transfer procedure is completely menu-driven. The operator panel will be ready for transfer directly afterwards, provided that all steps are performed and completed.
iX panel System Software Note: When updating an operator panel, it is important to ensure that power is not interrupted during the transfer. Transfer procedure in X2 panels The image transfer procedure is completely menu-driven. The operator panel will be ready for transfer directly afterwards, provided that all steps are performed and completed. The X2 panels can be updated either by using a USB flash drive, a recovery SD card, or using the Ethernet connection to transfer the files.
iX panel System Software Note: When updating an operator panel, it is important to ensure that power is not interrupted during the transfer. Transfer procedure using the Recovery SD Card Note: You should only use the Make Recovery SD Card option after first consulting with Beijer Electronics Support. 1. Start the Image loader software on the computer. 2. Click check box Make Recovery SD Card. 3. 4. 5. 6. 7. 8. 9. 358 Select the drive where the SD Card is connected. Click Create.
iX panel System Software Note: When updating an operator panel, it is important to ensure that power is not interrupted during the transfer.
iX panel System Software 360 Beijer Electronics, MAEN831P
Multiple Controllers 23 Multiple Controllers It is possible to use multiple drivers with one operator panel. This means that the operator panel can communicate with different controllers simultaneously. The controllers can be connected to the serial ports on the operator panel and via the Ethernet port. Note: If the same tag is connected to addresses in more than one active controller, there is no way to control from which controller the value is read in runtime. 23.
Multiple Controllers 23.1.1 Addressing Addressing of the tags in the controllers is carried out according to the help file for each driver. When assigning a tag to an object, all tags, regardless of controller connection, are available for selection. 23.1.2 Examples The following examples show configurations where multiple drivers are used in the operator panel. The operator panel communicating with one controller and one frequency converter.
Multiple Controllers The operator panel communicating in series with one controller via Ethernet and with controllers of another make. The operator panel communicating with two controllers of different makes via Ethernet.
Multiple Controllers 364 Beijer Electronics, MAEN831P
Troubleshooting 24 Troubleshooting This section describes tools to use in case of unexpected behavior in iX Developer. 24.1 Trouble Installing iX Developer on Windows 8.1 If you get an error message about .NET Framework 4.5.X when installing iX Developer on Windows 8.1, then run Windows Update and try to install iX Developer again. 24.2 Project Build Failure If project build fails, check that the absolute path to the project, including its components, does not exceed 260 characters. 24.
Troubleshooting 24.6 Expression Cannot Be Found If an error indicating that an expression cannot be found is generated at project validation, make sure that objects inserted from the Component library uses global expressions only. Related information Using Expressions 24.
