ATQMS-MKTG-DOC-Adroit Ignite HMI Quick Start Guide
ATQMS-MKTG-DOC-Adroit Ignite HMI Quick Start Guide
Copyright © 2021 Advanced Worx 112 (Pty) Ltd. All rights reserved.
Information in this document is subject to change without notice. The software described in this document is furnished under
a license agreement or nondisclosure agreement. The software may be used or copied only in accordance with the terms of
those agreements. No part of this publication may be reproduced, stored in a retrieval system, or transmitted in any form or
any means electronic or mechanical, including photocopying and recording for any purpose other than the purchaser’s personal
use without the written permission of Advanced Worx 112 (Pty) Ltd.
https://www.adroitscada.com
____________________________________________________________________________________________________________________________
ATQMS-MKTG-DOC-Adroit Ignite HMI Quick Start Guide.docx Page|1
Contents
1. Introduction.......................................................................................................................................... 3
1.1. General Overview...............................................................................................................................3
1.2. Product Size and Licensing Options .....................................................................................................5
1.2.1. Licensing Definitions .................................................................................................................................... 5
1.2.2. Product Sizes .............................................................................................................................................. 5
1.2.3. Adroit Ignite HMI Stand Alone ...................................................................................................................... 5
1.2.4. Client Purchases Available ............................................................................................................................ 5
2. Creating a New Configuration .............................................................................................................. 6
2.1. Creating a Device ...............................................................................................................................8
3. Configuring a Project ............................................................................................................................ 9
3.1.1. Enterprise Manager...................................................................................................................................... 9
3.1.2. Properties ................................................................................................................................................. 11
3.1.3. Toolbox .................................................................................................................................................... 11
3.1.4. Adding a New Project and Graphic Form ...................................................................................................... 12
4. Configuring the Agent Server ............................................................................................................. 13
4.1. Agents ............................................................................................................................................ 13
4.1.1. Naming Conventions .................................................................................................................................. 13
4.1.2. Slots ......................................................................................................................................................... 14
4.1.3. Tag .......................................................................................................................................................... 14
4.1.4. Adding an Agent ........................................................................................................................................ 15
4.1.5. Scanning an Agent ..................................................................................................................................... 16
4.1.6. Logging an Agent ...................................................................................................................................... 18
4.1.7. Alarming an Agent ..................................................................................................................................... 19
5. Displaying Data – Client Side Configuration ...................................................................................... 22
5.1.1. Adding Objects to a Graphic Form ............................................................................................................... 22
5.2. Behaviours ...................................................................................................................................... 23
5.2.1. Displaying a Value ..................................................................................................................................... 24
5.2.2. Changing a Value Setpoint.......................................................................................................................... 26
5.3. Line Charts ...................................................................................................................................... 29
5.3.1. Display Historical Data ............................................................................................................................... 29
5.4. Alarm Viewer Control ....................................................................................................................... 31
5.4.1. Displaying an Alarm list .............................................................................................................................. 31
6. Reusable Objects ................................................................................................................................ 33
6.1. Wizards ........................................................................................................................................... 33
6.1.1. Using and Adding a Pre-defined Wizard ....................................................................................................... 33
6.2. Templates ....................................................................................................................................... 35
6.2.1. Opening a Template .................................................................................................................................. 35
____________________________________________________________________________________________________________________________
ATQMS-MKTG-DOC-Adroit Ignite HMI Quick Start Guide.docx Page|2
1. Introduction
The Adroit Ignite HMI Quick Start Guide document is designed to help the new user install, configure and
get an understanding of the various Adroit Ignite HMI sub-systems. In addition to assist a new user in
understanding the Adroit Ignite HMI approach to SCADA/HMI project development and concepts
surrounding the Adroit Ignite HMI product.
• Agent Server (AS): The Agent Server (I/O Server), is the real-time database, which handles
the real-time values and if configured, will handle all post-processing, logging and/or
alarming the data.
• Ignite Server: The Ignite Server is a middleware server which exposes data from a number
of disparate sources, using the datasource, and also acts as a repository for the graphic forms
or mimics. When connecting to the Ignite Server the user will be prompted for login
credentials. The default credentials are the same as the Windows credentials under which
the user installed the Adroit Ignite HMI.
• Clients: The Adroit Ignite HMI comes with a number of types of Clients which can securely
connect to the Ignite Server:
a. Designer: The Ignite Designer allows the user to configure datasources as well as create
and design graphic forms.
b. Operator (View Clients) allows the user to operate and interact with graphic forms that
make up the project
c. Performance Anywhere: An HTML5 web reporting client for building dashboards
d. Adroit Air: Mobile App for push notifications such as operator messages, alarms and
process data (runs on Android and IoS)
• Datasource: Each source of data (i.e. Adroit Ignite HMI Agent Server) requires a
datasource plugin before it can be associated with the Ignite Server.
This provides the ability to expose its data as Data Elements.
___________________________________________________________________________________________________________________________
ATQMS-MKTG-DOC-Adroit Ignite HMI Quick Start Guide.docx Page|3
An example of a Data Element is Adroit.Analog.SAMPLEANALOGUE.value.
The Ignite Server allows multiple sources of data to be available to the configuration of a
system in a unified manner. It basically coverts all datatypes into universally usable elements
(Data Elements).
Datasource Purpose
Exposes the configured Agents and their slots, of the connected Adroit Ignite HMI Agent
Adroit
Server.
Event Log Exposes the events within the Windows event logs of the connected specific computer.
OLE DB Exposes the data within a specific OLE DB compliant database or data store.
• Front End Device (FED): The front-end device is a general term used for a PLC; OPC
server; RTU; any controller; or any software package that allows third party communication
(i.e. OPC, SIMATIC NET).
• Protocol Driver: Adroit Ignite HMI supports many different protocols. Once a new driver
has been installed and configured to talk to a FED, it is called a Device. A single protocol
can support multiple Devices. An example of this is the user can have multiple FEDs which
use the same protocol (i.e. MODBUS Ethernet), each FED will have its own IP address. A
device will need to be created for each FED.
___________________________________________________________________________________________________________________________
ATQMS-MKTG-DOC-Adroit Ignite HMI Quick Start Guide.docx Page|4
1.2. Product Size and Licensing Options
By now you will be familiar with the options available for the Adroit Ignite HMI software. But just to recap
the following options exist for the product.
The Adroit Ignite HMI software is, by default licensed using our soft licensing mechanism. This means it
has to be licensed finally on the machine you intend to ship your solution on. Should There is no way of
transferring these licenses between machines and each final project will need a new license to be
purchased
In situations where you would want a transferrable physical HASP USB security dongle this is available on
request and there is a cost of around US$50 (excluding transport) per HASP license or license change.
___________________________________________________________________________________________________________________________
ATQMS-MKTG-DOC-Adroit Ignite HMI Quick Start Guide.docx Page|5
2. Creating a New Configuration
Before creating a new configuration, please ensure that the Adroit Ignite is not running. Shutdown the
Ignite Server and Agent Server.
3. The Adroit Ignite HMI Configuration Editor application is used to customize the installed
applications and/or services by modifying their default settings. Users will need to familiarise
themselves with the Ignite Config Editor if they want to:-
• Agent Server Configuration such as
o Changing the Agent Server to run as a service (adding specific user log-on details to
the Agent Server)
• Changing Operator and Designer standard settings
• Adding a new protocol driver
• Making a Backup of or Restoring a Project
5. Select the Configuration menu item on the top left and check on “Allow Multiple Configurations”
option.
___________________________________________________________________________________________________________________________
ATQMS-MKTG-DOC-Adroit Ignite HMI Quick Start Guide.docx Page|6
Figure 3 - Allow Multiple Configurations
8. Once the configuration has been created click the Finish button.
___________________________________________________________________________________________________________________________
ATQMS-MKTG-DOC-Adroit Ignite HMI Quick Start Guide.docx Page|7
2.1. Creating a Device
Setup the OPC Client to the Adroit Ignite HMI BatchOPC Server demo application. This application is part
of the Adroit Ignite HMI install.
1. From the Ignite Application Launcher run the Ignite Config Editor.
3. From the Agent Server Configuration Menu, select the Driver Configuration.
4. Select OPC Client Protocol Driver and click the Add button.
6. Select “Adroit Batch OPC Server” from the OPC Server pulldown list.
7. Click OK.
8. Click Finish.
___________________________________________________________________________________________________________________________
ATQMS-MKTG-DOC-Adroit Ignite HMI Quick Start Guide.docx Page|8
3. Configuring a Project
The Designer environment is where the user will spend most of their time. It is a single engineering
window to your entire project. The user will manage connections to datasources, access the Agent Server
for Agent/Tag configuration, manage and apply security and build the graphic forms for the project.
Figure 6 - Designer
The Designer has views that are docked around the centre design area. The most important of these is
the Enterprise Manager.
To reset the Designer layout, open the View ribbon and click on the “Reset to Default Layout” button.
___________________________________________________________________________________________________________________________
ATQMS-MKTG-DOC-Adroit Ignite HMI Quick Start Guide.docx Page|9
The Enterprise Manager has three areas, they are:
Datasources
This area is where the user can create and manage the datasources. There are 3 default datasources
which are created automatically, these are:
• Adroit Ignite HMI – This Datasource connects to the Adroit Ignite HMI Agent Server.
• Eventlog – This datasource connects to the local Windows event log.
• ObjectModel - The object model datasource enables you to enhance your existing wizards,
by adding SCADA configuration to them. Its main function is to save you engineering time
when bulk creating objects, such as items of equipment, which require similar HMI/SCADA
configuration.
Management
Management consists of 3 sub-settings:
• Profile – a default profile is created at installation which is used to manage user-specific
configuration of the Designer and Operator. The profile manages all user-specific settings like
language, scripting, colour settings, menu settings and Ignite Operator settings to the graphic
form.
• Security – Security in Ignite is user-centric and operates on top of the traditional Windows
operating system security, using a configurable sub-set of the existing users and groups on
each Server computer, known as the “allowed” users and groups. For instance, when a Client
(Designer or Operator) is launched, it is necessary to login to a Server and only a user that is
either an allowed or a member of an allowed group on this Server is able to log into it. In
addition to controlling the access of these “allowed” users and groups to the Server, its
configured datasources and their data, it is possible to control or limit the access that these
users have within each Client (Designer or Operator).
• System – is mainly only for system monitoring reasons. This allows you to display which clients
are connected, subscription pool, message queues, etc.
Projects
The Projects area is where you create, build and store your own Graphic Forms. The Projects directory
by default will have Shapes Wizards and Examples and System Information graphic forms useful for
incorporating for technicians to manage the HMI/SCADA project at runtime. (all the sample project
layouts incorporate these system management elements).
Note: Projects can have sub-folders containing your Graphic Forms and it is important to give this structure some thought. We advise
the use of the ISA95 as a guideline which defines the physical structure of your plant, including enterprise, plant area, site, etc.
___________________________________________________________________________________________________________________________
ATQMS-MKTG-DOC-Adroit Ignite HMI Quick Start Guide.docx P a g e | 10
3.1.2. Properties
The Properties view contains all properties of the selected object that is placed on the Graphic Form.
The Graphic Form properties are displayed by default.
3.1.3. Toolbox
The Toolbox view contains all the base objects that the user will add to the Graphic Form.
The Toolbox view can be found below the Enterprise Manager view.
5. Select the new project “Plant Area 01”. On the Home ribbon select the New Graphic Form icon
Alternate method - right click on the selected Project folder and click “Create Graphic Form”
6. Name the graphic form “Overview”. The new graphic form is now open in the design area.
Note: It is possible to rename by right clicking on the GF and selecting Rename in the menu.
4.1. Agents
4.1.1. Naming Conventions
Agent Type Agent Server Intelligent Adroit object type Analog, Digital, Counter etc
Property of an Agent
Tag Agent Server ADT_ABC_MX_MIX_TNK_LVL.value
Object name (name.slot)
A Data Element is built up using the
Data Element Ignite Server name of the datasources. Adroit.Analog.ADT_ABC_MX_MIX_TNK_LVL.value
(Source.type.name.slot)
The most fundamental building blocks of Adroit Ignite HMI Agent Server are intelligent objects called
Agents. In addition to being able to manipulate their own data, they can read and write from the FED and
to other agents and so influence them.
___________________________________________________________________________________________________________________________
ATQMS-MKTG-DOC-Adroit Ignite HMI Quick Start Guide.docx P a g e | 13
Available Agents are grouped into six Agent groups, to allow easier access to Agents that are needed for
a project, they are:
• Primitive Agent types
Boolean, Text
4.1.2. Slots
Agents are made up of Slots. Slots of an Agent are values (attributes) or fields within an Agent that can
be retrieved and/or set. The slots within an Agent can drive the logic/function of the Agent.
4.1.3. Tag
A fully qualified named value in Adroit Ignite HMI made up of an agentName.slotName and in the Adroit
Ignite HMI world are then known as Tags. All Tags within Adroit Ignite HMI can be driven, changed
internally or externally.
___________________________________________________________________________________________________________________________
ATQMS-MKTG-DOC-Adroit Ignite HMI Quick Start Guide.docx P a g e | 14
4.1.4. Adding an Agent
To create a new Analog Agent in the Agent Server:
1. Open the Designer and navigate to the Open Configurator from the Home menu.
Alternatively, expand Datasource in the Enterprise Manager, right click on Adroit and select Open Configurator.
4. Click Add.
___________________________________________________________________________________________________________________________
ATQMS-MKTG-DOC-Adroit Ignite HMI Quick Start Guide.docx P a g e | 15
4.1.5. Scanning an Agent
Now we have created an Analog Agent, we can go ahead and start tying the Agents up to the Batch
Simulation OPC Server item.
1. Open the Designer and navigate to the Open Configurator from the Home menu.
Alternatively, expand Datasource in the Enterprise Manager, right click on Adroit and select Open Configurator.
5. Browse in the correct addressing for the Batching Simulation OPC Server (in this case
PumpRunning) Double click on the name in the OPC Browser to load or highlight the item and
click Select.
___________________________________________________________________________________________________________________________
ATQMS-MKTG-DOC-Adroit Ignite HMI Quick Start Guide.docx P a g e | 16
Figure 15 Digital Scan Config
9. Click OK.
___________________________________________________________________________________________________________________________
ATQMS-MKTG-DOC-Adroit Ignite HMI Quick Start Guide.docx P a g e | 17
4.1.6. Logging an Agent
Adroit Ignite HMI allows the “value” of a named Tag to be recorded or logged to either proprietary log
files or an OLE DB-compliant database.
1. Open the Agent Configurator window and select the Analog Agent:
ADT_ABC_MX_PMP_MASS_PV
5. In the Datasource dialog box, adjust the pathing that it reads the following:
C:\ProgramData\Adroit Technologies\Adroit\Configurations\New Config name\Datalogs\Feeder A PV
9. Make sure the start radial button is selected before clicking the OK button
___________________________________________________________________________________________________________________________
ATQMS-MKTG-DOC-Adroit Ignite HMI Quick Start Guide.docx P a g e | 18
4.1.7. Alarming an Agent
The alarming capability of the Adroit Ignite HMI SCADA is exceptionally powerful and needs careful
attention.
Alarm Routing
Alarm routing, which is configured in the Alarm agent, is where the user will configure the outputs of an
alarm. Adroit Ignite HMI Alarming supports multiple routing outputs such as Alarm Lists; SMSs; Emails;
Event logs; Multimedia notifications.
Alarm Types
Alarm Agents can monitor other Agents with pre-set Alarm Types. An alarm type is simply the required
condition or state of an Agent’s header slots. A default Alarm Agent, created on start of a blank AS
database, contains a number of pre-defined alarm types.
6. Select the Low alarm and uncheck the Acknowledgement Required check box
___________________________________________________________________________________________________________________________
ATQMS-MKTG-DOC-Adroit Ignite HMI Quick Start Guide.docx P a g e | 20
Figure 19 Alarm Configuration
___________________________________________________________________________________________________________________________
ATQMS-MKTG-DOC-Adroit Ignite HMI Quick Start Guide.docx P a g e | 21
5. Displaying Data – Client Side Configuration
Once the Agent Server has been configured the user can now display and manipulating the data on a
graphic form using Behaviours.
Make use of the Static Graphics Library from the Shapes, Wizards & Example Ribbon to add Static images
to the Graphic Form.
Under Windows Forms in the Toolbox, select the control “Label” and click on the opened Graphic Form.
Clicking on the Save icon on the top left of the design area. This will save the current selected Graphic
Form.
___________________________________________________________________________________________________________________________
ATQMS-MKTG-DOC-Adroit Ignite HMI Quick Start Guide.docx P a g e | 22
5.2. Behaviours
Behaviours are used to create the dynamics pertaining to display and manipulate Data Elements as well
as how Operators interact with the graphical representation on any screen.
Behaviour Description
Bind Value Drive a Data Element (value) to and/or from the value of a property of a control or vector.
Color Assign colors to the two states of a digital (Boolean) value; to blink a specific Color
property or the VISIBILITY property either continuously or triggered by a value. Also
define states of color based on specific value ranges to provide a visual indication of a
value, as well as define states of color based on a bit mask - a specific sequence of bits
that are set for up to 32 bits to provide a visual indication of each bit mask.
Execute Command Perform commands, such as launching an application or opening, closing or printing a
graphic form or logging a user on or off and/or switching users.
Flip Bitmap Create a defined sequence of images or a multi-image display, this Behaviour can only
be added to a Picture vector object.
Location Dynamically move the object linearly in a defined X-Y direction by means of a monitored
value.
Operator Action Typically provides methods that allow end users to change a value at runtime.
Tooltip Display additional information when the mouse cursor hovers over the object.
___________________________________________________________________________________________________________________________
ATQMS-MKTG-DOC-Adroit Ignite HMI Quick Start Guide.docx P a g e | 23
5.2.1. Displaying a Value
Display the analog value of the Agent ADT_ABC_MX_PMP_MASS_PV using a Display Value
Behaviour.
In the Designer open the graphic form Overview that you previously created.
4. In the Display Value dialog click on the Input Data Element browser button. Browse for the Data
Element ADT_ABC_MX_PMP_MASS_PV.value.
___________________________________________________________________________________________________________________________
ATQMS-MKTG-DOC-Adroit Ignite HMI Quick Start Guide.docx P a g e | 24
5. Click the Finish button.
8. Save the graphic form and test by clicking on the Run button , in the design area menu bar.
9. The user can run the batch plant simulator by clicking on the Auto start label in the OPC simulator.
___________________________________________________________________________________________________________________________
ATQMS-MKTG-DOC-Adroit Ignite HMI Quick Start Guide.docx P a g e | 25
5.2.2. Changing a Value Setpoint
___________________________________________________________________________________________________________________________
ATQMS-MKTG-DOC-Adroit Ignite HMI Quick Start Guide.docx P a g e | 26
1. Open the Graphic Form “Overview”, place a new Label on the Graphic Form with the following
properties:
• (Name): lblWaterSP
• AutoSize: True
• Backcolor: White
• Font: Arial, 9pt, style=Bold
• Text:00.00 L
3. Select the Smart Tag ( ) and add a new Display Value Behaviour to the object.
o The Input Data Element is : ADT_ABC_MX_PMP_MASS_SP.value
o String formatting is : {0:F2} L
4. Select the Smart Tag ( ) and add a new Operator Action Behaviour to the object.
o The Input Data Element is : ADT_ABC_MX_PMP_MASS_SP.value
___________________________________________________________________________________________________________________________
ATQMS-MKTG-DOC-Adroit Ignite HMI Quick Start Guide.docx P a g e | 28
5.3. Line Charts
The line chart control is used to display live as well as logged data from the Adroit Ignite HMI Agent
Server.
1. Confirm that the Graphic Form “Overview” is open and not in run mode.
2. From the toolbox view under “Data” select the LineChart control and place it on the graphic form.
3. Once the control has been placed the LineChart configuration will open.
4. Change the Title of the series from Line to “Water – Actual” by double clicking on the series name
Line.
5. Select the Values tab in the series setup. Then setup the values as follows.
• Values: Adroit.Analog.ADT_ABC_MX_PMP_MASS_PV.value
• Min: Adroit.Analog.ADT_JABC_MX_PMP_MASS_PV.engMin
• Max: Adroit.Analog.ADT_ABC_MX_PMP_MASS_PV.engMax
• Units: Adroit.Analog.ADT_ABC_MX_PMP_MASS_PV.unit
• Description: Adroit.Analog.ADT_ABC_MX_PMP_MASS_PV.agentDescription
___________________________________________________________________________________________________________________________
ATQMS-MKTG-DOC-Adroit Ignite HMI Quick Start Guide.docx P a g e | 29
6. Click the finish button save the Graphic Form.
___________________________________________________________________________________________________________________________
ATQMS-MKTG-DOC-Adroit Ignite HMI Quick Start Guide.docx P a g e | 30
5.4. Alarm Viewer Control
The Alarm viewer control allows the user to connect to ether an Alarm Agent or an Alarm list agent in
the Adroit Ignite HMI Datasource. The control, once connected to a valid alarm list, will display all
routed alarms and allows the user to acknowledge and filter the displayed alarms.
1. Confirm that the Graphic Form “Overview” is open and not in run mode.
2. From the toolbox view under “Adroit” select the AlarmViewer control and place it on the Graphic
Form.
3. Select the Smart Tag ( ) on the top right of the alarm control, this will open the task menu.
4. Click on the General Configuration, which will open the Adroit Alarm Viewer Configuration.
___________________________________________________________________________________________________________________________
ATQMS-MKTG-DOC-Adroit Ignite HMI Quick Start Guide.docx P a g e | 31
Figure 30 - Adroit Ignite HMI Alarm Viewer Configuration
7. Click the Finish button, save and run the Graphic Form.
8. To test the Alarm view drop the set point below the value.
___________________________________________________________________________________________________________________________
ATQMS-MKTG-DOC-Adroit Ignite HMI Quick Start Guide.docx P a g e | 32
6. Reusable Objects
Adroit Ignite HMI has a two mechanism that allow for re-usable objects, Wizards and Templates.
6.1. Wizards
Wizards are user defined/created objects such as pumps; motors; analogue displays. The Behaviours
of a wizards can contain substitution. Adroit Ignite HMI contains a library of Shapes Wizards and
Examples that contain a number of pre-defined wizards.
2. Select the Shapes Wizards & Examples ribbon, Select the Situational Awareness in the drop down
box “Electrical Symbols” on the left of the ribbon.
4. The user will then be prompted to supply a substitution for the Analogue Agent, Click the browse
button and select the Data Element Adroit.Analog.ADT_ABC_MX_PMP_MASS_PV make sure
that the Data Element does not contain a slot. The result should be green to display a valid Data
Element.
___________________________________________________________________________________________________________________________
ATQMS-MKTG-DOC-Adroit Ignite HMI Quick Start Guide.docx P a g e | 34
6.2. Templates
Adroit Ignite HMI Templates are re-usable Graphic Forms that can be used at run-time. The fundamental
difference between a Graphic Form and a Template is that a Template has substitution abilities. This really
means that wherever you have repeatability for displays, such as machine process values you can
effectively create a single trend configured as a Template and at runtime when you click on a certain
machine you can simply launch the Trend and substitute that machines values.
1. Confirm that the Graphic Form “Overview” is open and not in run mode.
2. From the toolbox view under Windows Form select the button control and place it on the graphic
form. Set the following properties of the button
• (Name): btnWaterValue
• Font: Arial, 9pt
• Size:107, 45
• Text: Analog Faceplate
3. With the button btnWaterValue selected, Select the Smart Tag ( ) on the top right and add a
new Execute Command Behaviour.
___________________________________________________________________________________________________________________________
ATQMS-MKTG-DOC-Adroit Ignite HMI Quick Start Guide.docx P a g e | 35
7. Click on the “Advanced View >” button, then select the Aliases tab. The Analogue Data Element
Substitution should be available in the Alias list. If not click on the get Aliases button.
8. Click on the Input field and select the Browse button and browse the Data Element
Adroit.Analog.ADT_ABC_MX_PMP_MASS_PV
9. Click the Finish button, save and run the Graphic Form.
10. When the user clicks the button, the user will see an error “This action is only available in the
Operator”.
The user will need run the Operator in order to view this function.
11. Via the Enterprise Manager, select Management, Profile, Default Profile and right clicking on it and
select the option Configure.
___________________________________________________________________________________________________________________________
ATQMS-MKTG-DOC-Adroit Ignite HMI Quick Start Guide.docx P a g e | 36
12. On the right-hand pane, select Operator Settings.
13. Browse for DefaultGraphicFormPath, and then select the browse button.
___________________________________________________________________________________________________________________________
ATQMS-MKTG-DOC-Adroit Ignite HMI Quick Start Guide.docx P a g e | 37