You are on page 1of 194

IQAN Active Studio

Version 2.60

User manual

IQAN Active Studio User manual


License
Software User Agreement
Important-please read carefully before use of the Software.
Your use of this computer program is subject to the terms and conditions of the following Soft-
ware User Agreement. If you do not wish to accept these terms and conditions, do not install or
use this Software and please return this Software to the place you obtained it for refund.

License agreement, restrictions on use


Use
This is a license agreement between you (the entity to whom this software is provided) and
Parker Hannifin Corporation (“Licensor”). This agreement permits you to Use each program
furnished directly or indirectly from Licensor, either by Licensor or its authorized distributors
(“Distributors”) including any Copies thereof and any supporting materials and any related
updated programs or program portions (“Software”). The term “Copies” means any duplica-
tions, reproductions, transcriptions of any Software, either in whole or in part and by any
means whatsoever including electronic, mechanical, and manual processes. The term “Use”
means copying any portion of any Software or using any Software, but only in connection with
the analysis, specification, use, installation, repair, sale of products through Licensor or its
Distributors.

Restrictions
You will have a non-transferable and non-exclusive right to Use the Software. You may make
Copies of the Software provided that any such Copies are made solely for your Use or for
archival or back-up and no other purposes. No right to Use, print, copy of display the Software,
in whole or in part, is granted except as expressly provided in this agreement. You will not
reverse engineer, disassemble or decompile the Software. You agree to reproduce and include
any and all copyright notices, software user agreements notices and terms and conditions,
trademarks and other legends in and on every Copy of the Software.

Ownership
Title and ownership of the Software and Copies thereof shall at all times exclusively remain in
Licensor or its designee. You will obtain no greater right in and to the Software than a right in
the nature of the License limited to the Use of any such Software and subject to compliance
with all of the terms and conditions contained in this Agreement. To the extent that the Soft-
ware becomes deliverable under any U.S. Government funded prime contract or subcontract,
(i) you acknowledge and agree that this Software represent “commercial computer software”
as defined in the DoD Federal Acquisitions Regulation Supplement (DFARS) § 525.227-7014
(a)(I), and (ii) the Government’s right in connection with the Software will be limited in accor-
dance with the terms and conditions of this Agreement consistent with the policies stated in
DFARS Subpart 227.7202.

Modifications
Modifications or enhancements made by Licensor to any Software from time to time may be
made available to you at the sole option of Licensor or its Distributors. If the Software is
modified by you or merged into other program materials processed or used by solely by you,

IQAN Active Studio User manual


Licensor and its Distributors shall not have any liability or incur any expense or be affected in
any way by any such modification or merger, even if such modification or merger results in the
formation of an updated or new work. Rather, such Software, in its modified or merged form,
shall continue at all times to be the sole and exclusive property of Licensor and shall be subject
to all provisions of this Agreement.

Limited warranty
Limited warranty
Licensor warrants that (a) the original Software will perform substantially in accordance with
the accompanying written materials for a period of ninety (90) days from the date of receipt;
and (b) any hardware accompanying the Software will be free from defects in materials and
workmanship under normal use and service for a period of one (1) year from receipt date. Any
implied warranties on the Software and the hardware are limited only to ninety (90) days and
one (1) year respectively. The limited warranty applies to the original Software and not to any
copies made by you or others from the original Software or copies thereof.

Customer remedies
Licensor’s entire liability and your exclusive remedy shall be, at Licensor’s option either (a)
return of the price paid or (b) repair or replacement of the Software or hardware that does not
meet Licensor’s limited warranty and that is returned to the Licensor with a copy of your
receipt. The limited warranty is void if failure of the Software or hardware has resulted from
accident, abuse, or misapplication of the original hardware and Software only and in no case
shall the limited warranty apply to any copies of the original Software. Any replacement Soft-
ware shall be warranted for the remainder of the original warranty period or for thirty (30)
days, whichever is longer.

No other warranties
Licensor disclaims all other warranties, either express or implied, including but not limited to
implied warranties of merchantability and fitness for a particular purpose, with respect to the
Software, any accompanying written material, any accompanying hardware, and any services
for any of the foregoing.

No other liability
In no event will Licensor or its agents or suppliers or Distributors be liable for any direct or
indirect damages whatsoever (including without limitation, damages for negligence, strict
liability, breach of contract, loss of business profits, business interruption, loss of business
information, or pecuniary loss) arising out of the use of, or inability to use or failure to deliver
the Software or any defects therein, even if the Licensor has been advised of the possibility of
such damages. In no event shall the aggregate liability of Licensor, its agents, suppliers and
distributors exceed an amount equal to the price paid for the Software license.

ATTENTION
If you do not accept the terms and conditions of this license do not install or use the Software.

IQAN Active Studio User manual


Contents

IQAN Active Studio


Version 2.60
1 Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Software installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
New installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Upgrading from version 1.x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
USB driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Hardware installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Installation procedure - Windows XP . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Installation procedure - Windows Vista . . . . . . . . . . . . . . . . . . . . . . . . . 14

IQANrun
2 User interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Main window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Menu system . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Communication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Appearance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Show again . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Languages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Other . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Main tool bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Side tool bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Online . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Status bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Keyboard shortcuts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
3 Online . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Adjust . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Measure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

IQAN Active Studio User manual 4


Contents

Logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Run Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Continue Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Login . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Logout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Static users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Dynamic users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
File operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Update . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Get settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
Send settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Get clone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Send clone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
Send operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
4 View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
View tab buttons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Get Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Get Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Get Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Compare Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
View tab tree view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
Property inspector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
Function inspector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Measure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Print . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Channels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Property inspector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
Function inspector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
Measure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
Print . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
System overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
Measure modules and buses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
Block diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
Pin list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Property inspector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97

IQAN Active Studio User manual 5


Contents

Measure channels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Print . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Log items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Log records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
Save . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
Print . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
Tree list view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Compare settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Print . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
Clone file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
5 Archives . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
Archive contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
Multiple archives . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
Install archive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
Select archive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
Delete archive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
Check for updates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
6 Scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
Run script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
Script actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
Script report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
Script execution errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
Script states . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
Script output folder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
7 Communication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
USB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
CAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
Serial port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
Simulator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
Modem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
Internet settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
Quick switch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
Connect via internet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
Connect via internet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
Disconnect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
Modem connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
Connect via modem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
Disconnect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
Phone book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
Add . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136

IQAN Active Studio User manual 6


Contents

Edit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
Delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
Export . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
Import . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
Choosing a modem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
8 Safe passwords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
Password database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
Password types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
Date restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
Add password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
Safe passwords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
Delete password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146

IQANsimulate
9 User interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
Main window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
Menu system . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
Edit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
Simulate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
Appearance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
Show again . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
Other . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
Main tool bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
Status bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
Simulation status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
Communication status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
10 Application simulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
Modules, channels and functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
Modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
Channels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
Simulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
Simulation files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
Application manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
Property inspector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
Keyboard shortcuts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
Changing a property on multiple components . . . . . . . . . . . . . . . . . 164
Go to component . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
Simulation groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165

IQAN Active Studio User manual 7


Contents

Simulation groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165


Simulation items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
Edit simulation items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
Function groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
Simulate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
Measure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
Property inspector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
Channels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
Channel list view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
Simulate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
Measure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
Property inspector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
Modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
System overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
Block diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
Pin list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
Simulate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
Measure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
Property inspector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
11 Simulators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
Simulator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
Simulator display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181
Simulate menu system and display pages . . . . . . . . . . . . . . . . . . . . . 182
During simulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184
IQANdesign synchronization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186
IQANdesign controlling IQANsimulate . . . . . . . . . . . . . . . . . . . . . . . . . 186
IQANsimulate controlling IQANdesign . . . . . . . . . . . . . . . . . . . . . . . . . 186
Window size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
12 Safe passwords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188
Password database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
Password types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
Date restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
Add password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
Safe passwords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
Delete password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194

IQAN Active Studio User manual 8


1 Installation

The installation software installs all files you need to run IQAN Active Stu-
dio. It will also install some example files in a folder called IQAN Files under
My Documents.
If you are planning on using USB to connect to an IQAN master module, you
must run the installation program for IQAN Active Studio before connecting
the USB cable to your computer. It will install the driver files needed by Win-
dows plug and play feature.
Please close all IQAN programs and unplug all IQAN modules from your PC
before you start the installation.

IQAN Active Studio User manual 9


Software installation
1 Installation

Software installation
The installation program should start automatically when you insert the
installation CD. If it doesn’t, or you are not using a CD, please run the setup
executable manually to start the installation.
Please follow the instructions given by the installation program. To install
with the default settings, just click Next on every page shown.

License Agreement page in installation program.

New installation
In the User Information page, please enter name and company. A License
Number is also required to get full functionality. If you don’t enter a valid
license number, an evaluation version will be installed. The evaluation ver-
sion is fully functional, but will only work with the simulator.
IQAN Active Studio will also accept an IQANrun 1.x license number.

Upgrading from version 1.x


If you already have version 1 of a software installed, you don’t need to enter a
license number when installing version 2 of that software. The old license
will be used instead.

ATTENTION
All IQAN software tools takes advantage of Windows possibilities of having
multiple users on the same machine. This means that each user can have its

IQAN Active Studio User manual 10


Software installation
1 Installation

own settings, etc. The license on the other hand is valid for all users on the
same PC. Only one user needs to install the program and all other users on
that PC will share the same license number. Administrator privileges are
required during installation.
In the Select Component page, please select which softwares you want to
install. A separate installation program will then be started for each software
you select in this list.

USB driver
During the installation of IQANrun, drivers for USB will be installed. There
is one common driver and one driver per master module type.

NOTE
If you’re installing on Windows Vista, there is a confirmation dialog box for
each driver being installed. Click Install to install the drivers one by one, or
select Always trust software from "Parker Hannifin" and then click Install to
install all drivers at once. The driver installation may take a few minutes.

Driver installation confirmation dialog.

IQAN Active Studio User manual 11


Hardware installation
1 Installation

Hardware installation
The USB driver files are installed during the software installation. However,
the final registration can not be done until an IQAN master module is con-
nected to the PC with a USB cable.

NOTE
Please close all IQAN programs and unplug all IQAN modules from your PC
before proceeding with this installation.

Installation procedure - Windows XP


The steps below describes the driver installation procedure for Windows XP.
• First, make sure you have installed the software as described in the previ-
ous section.
• Connect a powered IQAN master module to a USB port on your PC.
• Windows now detects the new hardware. A dialog box is shown.

Found New Hardware Wizard.

• Select No, not this time and click Next.

IQAN Active Studio User manual 12


Hardware installation
1 Installation

You don’t need to insert any installation CD.

• Select Install the software automatically and click Next.

Installing driver for master module IQAN-MDL.

• The driver is now being installed.


IQAN Active Studio User manual 13
Hardware installation
1 Installation

Successful installation of master module IQAN-MDL.

• The installation is now completed. Click Finish to close the Found New
Hardware Wizard.

Installation procedure - Windows Vista


The steps below describes the driver installation procedure for Windows
Vista.
• First, make sure you have installed the software as described in the previ-
ous section.
• Connect a powered IQAN master module to a USB port on your PC.
• Windows now detects the new hardware. A help balloon is displayed in
Windows task bar.

Installing device driver software.

• Wait for the installation to be completed.

IQAN Active Studio User manual 14


Hardware installation
1 Installation

Device driver software installed successfully.

IQAN Active Studio User manual 15


IQANrun

IQANrun User manual


2 User interface

This section describes the user interface of IQANrun. The user interface is
designed to function with different screen resolutions and font sizes. It is
highly customizable. All settings, such as panel sizes, window positions and
column widths are stored in Windows registry.
Commonly used or important functions are accessible through tool bar
buttons and keyboard shortcuts. The keyboard shortcuts follow Windows
standard whenever possible.

IQANrun User manual 17


Main window
2 User interface

Main window
The main window consists of a menu, a couple of tool bars, a status bar and
the main panel.

IQANrun main window.

The main panel content depends on what you are doing and which system
you are connected to. It is described in detail in the following chapters.

IQANrun User manual 18


Menu system
2 User interface

Menu system
This section describes the menu system.

File
Open
Opens a file and displays its content in the main panel.

File type File content

.ida Application

.ids Script

.ica Archive

.irc Clone (application, settings and optionally logs)

.irf Full log (requires the corresponding application to be


opened first)

.irl Log records (can be viewed in IQANrun without


having access to the corresponding application)

.irm Measure data

.irs Settings (binary format, requires the corresponding


application to be opened first)

Reopen
Contains a sub menu with your most recently used files. Select the one that
you want to open.

Save
Saves the current data to a file. Not all views can be saved.

File type File content

.irl Log records (in clear text format, can be viewed later
without having access to the corresponding application
as opposed to the irf format, see above).

.irm Measure data.

.xls Microsoft Excel Workbook format. Logs and measured


graphs can be stored in Excel format.

.htm Some views are stored in HTML format, for example,


module and system info.

IQANrun User manual 19


Menu system
2 User interface

.mht Script reports can be saved in an HTML archive


format. One single file containing both the report and
images.

.xml The eXtensible Markup Language (XML) is a general-


purpose markup language. Its primary purpose is to
facilitate the sharing of structured data across different
information systems.
Logs can be stored in XML format.

.csv The Comma-Separated Values file format is a file type


that stores tabular data. It is a delimited text file, which
uses a comma to separate values.
Logs can be stored in CSV format.

Close
Closes the currently opened application file.

Select Archive
Lets you select which archive you want to use when you have multiple
archives installed. For more information on archives, see section Archives on
page 108.

Install Archive
Installs an additional archive. You can have as many archives as you like. If
the archive already has been installed, it will be replaced.

Delete Archive
Deletes the currently selected archive. The default archive can not be deleted.

Print
Prints the current view. Not all views can be printed. Select printer and set
print options.

IQANrun User manual 20


Menu system
2 User interface

Print dialog box.

Print header will add a header to all pages with a description, date and time
and page number. Print to fit will scale the print-out so that it fits on a single
page.

NOTE
Printing is optimized for portrait mode. Using landscape mode may not print
all information.

Exit
Quits IQANrun.

View
Contains navigation menu items such as Back, Forward, Stop and Home.

Tools
Contains common tools menu items.

Options
Lets you customize the user interface and behavior of IQANrun. See section
Options on page 24.

Password Manager
Opens the password manager, see section Password database on page 141 for
more information.

Communication
For information, see section Communication on page 128.

IQANrun User manual 21


Menu system
2 User interface

Help
Contains common help menu items.

Contents
Will bring up the help file, which is this book as a PDF document.

IQAN Home Page


Starts your web browser and goes to http://www.iqan.com.

Release Notes
Displays release notes for the version of IQANrun that you are using.

Check For Updates


Check for an updated version of IQANrun on the Internet. If you are using
archives with the update feature enabled, those will also be checked for
updates, see also section Check for updates on page 114.
If there are any new versions, you will be informed on what has been changed
and then you can download and install them on your computer.

File download progress.

When you download a new version, your license and user information will be
sent to our server to collect usage statistics, see table below.

IP address The IP address you are connecting from, typically the


address of your company’s Internet gateway or your
ISP.

License number, name and The number and names you entered when IQANrun
company was installed.

License type Full, evaluation or beta.

Installation date The date when IQANrun was installed.

IQANrun User manual 22


Menu system
2 User interface

Days used The number of days IQANrun has been used.

Versions The versions you are upgrading from and to.

NOTE
Check for updates requires an Internet connection.

About
Displays a dialog box with licence and version information.

IQANrun User manual 23


Options
2 User interface

Options
This section describes the options that concern the user interface of IQANrun.

Appearance
There are options that concern the user interface in general. Select Tools >
Options to show the IQANrun options dialog box. Switch to the Appearance
tab.

Appearance options.

Font
Choose the font to be used in the main window and all dialog boxes.
Check Use Windows font settings to use the settings from Windows Control
Panel. Or, select your own font and size. The sample will show you how the
selected font looks like.

Icon size
Select the size of your tool bar icons. Choose between small, medium or large
icons.

IQANrun User manual 24


Options
2 User interface

Show form hints


Show hints for buttons and other controls on the main panel when you hover
with the mouse over them.

Show tool bar hints


Show hints for the buttons on the main and side tool bars when you hover
with the mouse over them.

Selected adjust item color


The currently selected adjust item will use this color as its background. This
will make it easier for you to see which parameter you are currently adjusting.
To disable this function, select None. For more information about adjusting,
see section Adjust on page 35.

Settings viewer
See section Settings on page 103 for more information.

Show again
Some message dialog boxes have a check box named Never show this again.
By selecting that check box, you will never be shown that information or
asked that question again. Here is how you enable those messages again.
Select Tools > Options to show the IQANrun options dialog box.

Show again options.

Switch to the Show again tab. Select the check box for each message that you
want to be shown again.

IQANrun User manual 25


Options
2 User interface

Languages
On this tab you can select your preferred language when working with master
modules online or when viewing files. You can select a primary and a sec-
ondary language. When connecting to a master module or opening a file,
IQANrun will try to select first the primary and then the secondary language
to use when displaying component names, such as measure groups or logs.
If none of these languages are available, the default language in the current
application will be used instead.
When a preferred language was selected in a connected master module, it will
change the language selection locally on the master display as well. This is
only temporary though, when power is turned off and on again, the master
display is reset to its original language selection. Read more about languages
in section Language on page 62.

Languages options.

Show send language options dialog


The option Show send language options dialog is explained in section Update
on page 75.

IQANrun User manual 26


Options
2 User interface

Other
The tab Other collects some other options in IQANrun.

Other options.

File associations
Lets you associate IQANrun with application, script and/or archive files. If a
button is disabled, IQANrun is already associated with that file type. Associ-
ating IQANrun with a file type means that if you double-click such a file in
Windows Explorer for instance, IQANrun will start and open that file.

NOTE
Changing file associations on Windows Vista requires administrator privi-
leges.

Automatically check for updates


Select how often you want IQANrun to automatically check for updates.
Select Never to disable this function.

Script output folder


See section Script output folder on page 127 for more information.

Logs
See section Logs on page 53 for more information.

IQANrun User manual 27


Main tool bar
2 User interface

Main tool bar


The main tool bar contains buttons for navigation and file operations.

The main tool bar.

Tool bar buttons (from left to right)

Back Go back to previous page.

Forward Go forward in page history.

Stop Stop current operation.

Home Go to main window (see image on page 18).

Open Open and view a file.

Save Save current view in IQANrun or an external format.

Print Print current view on paper.

Start Measure Start to measure.

Pause Measure Pause an ongoing measurement.

Stop Measure Stop an ongoing measurement.

IQANrun User manual 28


Side tool bar
2 User interface

Side tool bar


The side tool bar contains two tabs, Online and View. The Online tab contains
operations that require a connection to a master module to be performed. On
the View tab you can instead work with files on your hard disk.

Online
The side tool bar tab Online contains buttons for all opera-
tions IQANrun can perform on a connected IQAN system.
The buttons are grouped in different categories.

Tools

Adjust View adjust groups

Measure View measure groups

Logs View logs

Modules View modules

System System information and settings

Script

Run Script Open a script and run it

Continue Script Continue script execution from where


you left off.

Security

Login Log in to master module

Logout Log out from master module

Users Add, edit or delete users in master


module

File operations

Update Update master module with new


application

Get Settings Get settings from master module

Send Settings Send settings to master module

Get Clone Get clone file from master module

Send Clone Send clone file to master module

IQANrun User manual 29


Side tool bar
2 User interface

View
The side tool bar tab View contains some buttons and a tree
view where you can navigate to view different things such
as applications, logs and/or settings.

Tools

Get Application Get and view application from master


module.

Get Log Get and view a complete log from master


module.

Get Settings Get and view settings from master


module.

Compare Settings Compare the currently opened settings


with another settings file.

IQANrun User manual 30


Status bar
2 User interface

Status bar
The status bar displays application name with machine id (when applicable),
currently logged in user and his access level, current operation, a progress bar
and communication type and status.

The status bar.

The progress bar is displayed when IQANrun is communicating with an


IQAN system. You can always interrupt the communication by clicking Stop
on the tool bar.

IQANrun User manual 31


Keyboard shortcuts
2 User interface

Keyboard shortcuts
Here is a list of keyboard shortcuts in IQANrun.

Shortcut Command

Ctrl+O Open

Ctrl+S Save

Ctrl+P Print

Alt+Left Back

Alt+Right Forward

Alt+Home (or Esc) Home

F1 Help Contents

F7 (or Space) Start Measure

Ctrl+F7 Pause Measure

Shift+F7 (or Space) Stop Measure

Alt+E Online tab

Alt+A Adjust

Alt+M Measure

Alt+L Logs

Alt+D Modules

Alt+S System

Alt+R Run Script

Alt+N Login

Alt+O Logout

Alt+U Users

F11 Update

Shift+F12 Get Settings

F12 Send Settings

Shift+Ctrl+F11 Get Clone

Ctrl+F11 Send Clone

IQANrun User manual 32


Keyboard shortcuts
2 User interface

Alt+W View tab

Shift+F11 Get Application

Shift+F8 Get Log

Shift+Ctrl+F12 Get Settings

Ctrl+F12 Compare Settings

IQANrun User manual 33


3 Online

This section describes the operations on the Online tab on the side tool bar.
All operations on the online tab usually requires a connected master module
to function.
If you are using a third party archive, not all of the described functions in this
chapter may be available. Read section Archives on page 108 for more infor-
mation.

IQANrun User manual 34


Tools
3 Online

Tools
This section describes the operations in the Tools group. These are Adjust,
Measure, Logs, Modules and System.

Adjust
Use this button to adjust things such as inputs, outputs, function parameters,
etc. There is no need to open any application file to do this operation, all
information needed by IQANrun is fetched from the connected master mod-
ule.
Start by clicking the Adjust button on the side tool bar. The shortcut key is
<Alt+A>. A list of available adjust groups is displayed.

Adjust groups.

An adjust group contains one or more adjust items. They provide a way of
organizing all adjust items in an application to give you a better overview.
If you miss some adjust group in the list that you know should be there, you
may need higher access rights. Log in as a different user with sufficient
access rights and try again. See section Login on page 69 for more informa-
tion.

IQANrun User manual 35


Tools
3 Online

Select adjust group


Select an adjust group in the list and click Select in the lower right corner to
continue. You can also double-click on a group in the list, or use the arrow
keys on the keyboard and press <Enter> to continue.

PIN code protection


If the adjust group is protected by a PIN code, a dialog box is shown to enable
you to enter the correct PIN code. PIN code protected adjust groups are
marked with a small lock symbol.

Enter PIN code dialog box.

Once the correct PIN code has been entered, the adjust group will be
unlocked until power is turned off on the master module. Unlocked protected
adjust groups are marked with an open lock symbol.

Adjust items
When you have selected an adjust group, a new list with all its adjust items is
displayed. Each adjust item represents a channel, such as a voltage input, cur-
rent output or function parameter for example.

IQANrun User manual 36


Tools
3 Online

Adjust item list.

Reset group
Use this button to reset all adjust items in this group to their factory default
value. If some of the items have multiple modes you will be asked whether
you want to reset all modes or just the active one.

Mode selection dialog box.

IQANrun User manual 37


Tools
3 Online

Set group
Use this button to set the factory default value for all adjust items in this
group to their current adjustable value. If some of the items have multiple
modes you will be asked whether you want to set all modes or just the active
one.
If this button is disabled, you may need higher access rights. Log in as a dif-
ferent user with sufficient access rights and try again. See section Login on
page 69 for more information.

NOTE
Not all adjust items have a factory default value that can be set from IQAN-
run. If the group only contains such adjust items, the Set Group button will be
disabled.

Copy mode
Use this button to copy all adjustable values from one mode to the active
mode. A popup menu with available modes to copy from is displayed when
you click this button. Select the mode you want to copy from. Adjust items in
the group that don’t use modes are not affected by this operation.
A confirmation dialog box is displayed before the operation is executed.

Copy mode confirmation.

Not all adjust groups allow modes to be copied. The Copy Mode button will
then be disabled.

Adjust item
Select an adjust item in the same way as you selected adjust group before.
The adjust item is displayed.

IQANrun User manual 38


Tools
3 Online

Adjust item for a current output.

At the top of the form there are some information values that are measured in
real-time while you are adjusting.

Channel value The actual status and value of this adjust item
(channel).

Limits Scaled min and max for the channel you are adjusting.
Only applicable to voltage inputs.

Reference value Status and value of this adjust groups reference


channel. Not all adjust groups have a reference
channel.

Mode Current mode for this adjust item. Only displayed for
multi-mode adjust items.

An adjust item has one or more parameters. Each parameter is represented by


its name, unit, default value, original value and current value. The default
value is the value this parameter will get if you reset it and original value is
the value the parameter had when you entered this form.

IQANrun User manual 39


Tools
3 Online

If the item is bi-directional, its parameters are grouped by direction. Each


direction group has the direction name as header, for example, Up, Left or
Forward. And if the adjust item is a current or PWM output, its parameters
appear on two different tabs Currents (Modulation Ratios for PWM) and
Slopes.

Select parameter
Click on a parameter to make it the active parameter. You can only adjust one
parameter at a time. The active parameter is highlighted. The highlight color
can be changed, see section Appearance on page 24 for more information on
how to do this.
Shortcut key for changing active parameter is <Ctrl+Up> or <Ctrl+Down>.
Tab will only switch focus between the bottom line buttons and the active
parameter for safety reasons.

Parameter types
The parameter value is adjusted in three different ways, depending on the
parameter’s value type - numerical, text, state or PIN code.
Numerical values are adjusted with an edit box connected to an up/down
spinner. Click the spinner buttons or enter a value in the edit box and press
<Enter> to adjust the parameter. Another way is to use the <Up> and
<Down> arrows on the keyboard. This will change the value in small steps.
Press <PgUp> and <PgDn> to move in larger steps.
There is also a slider displayed for numerical parameters. The slider is only
for visual feedback of the parameter value and can not be used for adjusting
it. When there are multiple parameters, all the sliders usually have the same
range. For some parameters part of the slider range is dark grey. This indi-
cates out of range values. Adjustments are only allowed within the light grey
range. The line with vertical pointing arrows indicates current parameter
value. For some parameters there is also a second line with horizontal arrows
which indicates current channel value.
Parameters on voltage inputs with the automatic adjustment function enabled
have a check box named Auto. When this is checked the parameter value will
automatically be adjusted by the channel value. All you need to do is make
the voltage input reach its minimum and maximum values and you’re set. For
example, to adjust a gas pedal, press it fully to the floor and then release it
again to its zero position. Both min and max are now adjusted and you are
done. If you want to adjust it manually anyway, just uncheck Auto.

Numerical parameter.

IQANrun User manual 40


Tools
3 Online

Text values are adjusted by entering the desired text in an edit box.

Text parameter.

State values are adjusted by selecting desired state in a list box.

State parameter.

PIN codes are adjusted by entering the old PIN code and the new PIN code.
The new PIN code must be entered twice to prevent input errors.

PIN code parameter.

Disabled parameters
In some cases a single parameter is disabled, which means it can not be
adjusted. Disabled parameters are displayed with a lock symbol and the text
“Not adjustable”.

Disabled parameter.

Adjusting
The parameter value is adjusted online, which means it is actually changed in
the connected master module instantaneously when you for example move
the slider control.
There is no need to acknowledge the new value you have adjusted it, just
leave the page when you are done by either clicking Done, Back or Home or
any button on the side tool bar. To leave the page without storing your adjust-
ments see section Cancel on page 43.

IQANrun User manual 41


Tools
3 Online

ATTENTION
Use caution when adjusting parameters over a modem connection, since there
is a longer response time on your adjustments.
All inputs and outputs are still active while you are adjusting them. This
means that you will get instantaneous feedback on your adjustments if you at
the same time activate the input or output.

Current outputs
When adjusting minimum current for a current output, parameter Min [mA],
the actual output is limited to minimum current. This will make it easier to
adjust minimum current by allowing you to activate the output without hav-
ing to hit the exact start position.
For example, to adjust a crane output you select the minimum current param-
eter by clicking it, then you activate the crane function by moving the joystick
to its maximum position. The output will now be limited to minimum current.
Change the parameter value with the spinner buttons or the <Up> and
<Down> keys until you have reached the position where the crane starts to
move.

ATTENTION
If you select another parameter while adjusting minimum current, either by
clicking another slider or pressing <Ctrl+Up/Down>, the current output will
no longer be limited to minimum current. This may cause unintentional acti-
vation of an output. In the example above, it would cause the crane to move
with maximum speed, since the joystick is in its maximum position.

Reset item
To reset an adjust item to its default value, click Reset Item on the bottom left.
All parameters are reset. The default value is displayed next to each parame-
ter.
A confirmation dialog box is displayed before the operation is executed.

Reset item confirmation.

Set item
To set factory default value for an adjust item to its current adjustable value,
click Set Item. All parameters are set.
IQANrun User manual 42
Tools
3 Online

The Set Item button may be disabled or invisible depending on what adjust
item you are looking at and what access level you have. If this button is dis-
abled, you may need higher access rights. Log in as a different user with suf-
ficient access rights and try again. See section Login on page 69 for more
information.

NOTE
Not all adjust items have a factory default value that can be set from IQAN-
run. The Set Item button will then be disabled.

Cancel
If you would like to cancel all your changes on the current page, click Cancel.
This will restore all parameter values for this adjust item to the original value
they had when you entered this page. The original value is displayed next to
each parameter.

IQANrun User manual 43


Tools
3 Online

Measure
Use this function to measure one or more channels in real-time. Measure-
ments can be done both numerically and graphically. There is no need to open
any application file to do this operation, all information needed by IQANrun
is fetched from the connected master module.
Start by clicking the Measure button on the side tool bar or press <Alt+M>. A
tree view of measure groups, measure items and modules is displayed. They
are divided into three different groups; System measure groups, User defined
measure groups and System status.

Measure groups and modules.

Measure groups
A measure group contains one or more measure items. They provide a way of
organizing all measure items in an application to give you a better overview.
Expand a measure group to see all its measure items.

System measure groups


These are the predefined measure groups available from the master module.
If you miss some measure group in the tree view that you know should be
there, you may need higher access rights. Log in as a different user with suffi-

IQANrun User manual 44


Tools
3 Online

cient access rights and try again. See section Login on page 69 for more infor-
mation.

User defined measure groups


Here you can add your own measure groups. Click Add at the bottom left to
add a new measure group. Right-click on it and select Rename or press <F2>
to rename it. You can give it any name you like. To add measure items to your
group, drag and drop items from the other measure groups. Another way to
add measure items is to open or get the application and add channels from the
View tab. See section User defined measure groups on page 88 for more
information.
User defined measure groups are automatically saved on your PC. They know
which application they belong to, so if you later measure on another machine
with the same application, they will show up again.
To delete a measure item or a complete group, select it and click Delete or
press <Ctrl+Del>. A confirmation dialog box appears. Click Yes to delete.

Delete measure item confirmation dialog box.

NOTE
It is not possible to add and delete measure groups or items while you are
measuring.

System status
Under this node all the modules in the system will be listed. If there are any
channels with an error condition they will also be listed here under its parent
module. If the error condition for a channel goes away during a measure, the
channel will still be listed. Restart the measure to clear the tree view from
channels without errors.
The system status function is very useful to quickly spot any problems in a
machine. The System status node itself will display the most severe status
type of all underlying module and channel status types: OK (green), Warning
(yellow) or Error (red).

IQANrun User manual 45


Tools
3 Online

Start and stop


Use the button Start Measure button in the main tool bar or press <F7> to
start measuring. To stop, click Stop Measure or press <Shift+F7>. You can
also use the space bar to start and stop measuring.

Graph
Select a measure group or item in the tree view and click Graph in the lower
right corner, or use the arrow keys on the keyboard and press <Enter> to con-
tinue to graphical measuring.
The measure group with all its measure items is shown together with a graph
and IQANrun starts to measure automatically.

Graphical measurement.

The measure window has a graph in the middle where each channel is mea-
sured graphically. Underneath the graph there is a list with all the measure
items and their numerical value. Each item is color-coded to match its curve
in the graph.

Start/Stop measure
To start a measurement, click the Start Measure button in the main tool bar or
press the function key F7. To stop a measurement click the Stop Measure but-
IQANrun User manual 46
Tools
3 Online

ton in the main tool bar or press <Shift + F7>. You can also use the space bar
to start and stop measuring.
It is also possible to pause the measurement. This will stop the screen from
updating but continue to measure all values in the background. Click Pause
Measure in the main tool bar or press <Ctrl + F7>.

Comment
Add a comment to your measurement by clicking Comment.

Measurement comment dialog box.

The comment is saved when you save this measurement as a file, both in
IQANrun and Excel format.

Save
After you have stopped the measurement, it is possible to save all your values
to a file. Click Save in the tool bar above the graph or press <Ctrl + S>. A
save file dialog box is shown.
There are two file formats available.

.irm IQANrun Measure file. Use this format to be able to


open it with IQANrun to view it later.

.xls Microsoft Excel Workbook. Saves all measured values


in an Excel workbook. Opens the file in Microsoft
Excel after it has been saved.

Print
Click Print in the main tool bar or press <Ctrl + P> to print the measured
graph with statistics.

Clear values
To clear all measured values, right-click in the graph panel and select Clear.
IQANrun User manual 47
Tools
3 Online

Graph options
By default the background of the graph is black and the grid color is gray, but
in the options dialog for IQANrun you can easily change these colors and
other measure options. Select Tools > Options, Measure tab or right click on
the graph window and select Options.

Measure options.

Show grid Turns grid on in graphs.

Background color The background color in graphs.

Grid color The grid color in graphs.

Line with The line width in pixels for the curves in graphs.

Active line width The currently selected channel can have another line
width than the others. Select that here.

IQANrun User manual 48


Tools
3 Online

Glitch detect Glitch detect can be useful to detect short pulses or


glitches in a large graphical measurement. Without
glitch detect, IQANrun uses mean value calculation
when presenting a large amount of data in the graph.
With glitch detect, IQANrun presents min and max
values in each point instead of mean value. This makes
it possible to easily find glitches in very large
measurements.

Time depth This is the amount of data shown while you are
measuring graphically.

Max update rate This is the maximum display update rate when
measuring graphically. If your computer is slow or you
are measuring a lot of items, the display can have
problems showing all values in real time. Then it can
be useful to decrease this value. The value only affects
the display updating while measuring, all values are
still stored for each system sample.

Start measure Start to measure immediately when entering the graph


automatically in graph form.

Start measure Start to measure immediately when entering the


automatically in list measure form.

Mark missing samples in When measuring, samples can be lost due to


graph communication problems or by measuring too many
channels. Missing samples are then calculated by
interpolation between the surrounding values. Select
this option to draw missing samples with a darker color
in the graph.

Missing samples threshold Select the number of continuos samples that needs to
be missing before marking them in the graph. Requires
option above to be selected.

Statistics
Select the item you want statistics for in the items list. You can also click on
the item’s curve in the graph panel to select it. The selected curve will have a
thicker line in the graph. Two circles on the selected item’s curve indicates
the two points between which rise/fall time is calculated.
Use the two cursors to select the range for calculating statistics. You will find
the cursors as small arrows above the graph. You can use the cursors as soon
as you have stopped the measurement.

IQANrun User manual 49


Tools
3 Online

Positioning the cursors


The cursors are two vertical lines which can be positioned along the X-axis.
You move each cursor by dragging its arrow at the top of the graph panel.
Drag each cursor to the desired position.
You can move both cursors at the same time by holding <Shift> pressed
while you move one of the cursors. Also, you can move the cursor back to the
default position by clicking on it while holding down <Ctrl>.

Locking the cursors


The cursors can be locked in their positions. Right-click in the graph and
select Lock Left or Lock Right. When locked, they can’t be moved. To unlock
a cursor, select Lock Left or Lock Right once more.

Statistic values
In the lower right panel you will find measurement statistics belonging to the
selected channel. Move the cursors to calculate statistics for a different range.

Value 1 The item’s value at the left cursor’s position.

Value 2 The item’s value at the right cursor’s position.

Min The item’s lowest value between the two cursors.

Max The item’s highest value between the two cursors.

Peak to Peak The difference between Max and Min described above.

Mean Mean value between the cursors.

True RMS Mean value between the two cursors. Calculation


carried out as per true RMS.

T1 Left cursor position at the X-axis.

T2 Right cursor position at the X-axis.

T2-T1 Time between the two cursors.

Rise time/Fall time Time between the minimum and maximum value
between the two cursors.
The heading alternates between Rise and Fall
depending on which value is first.
Two circles on the selected item’s curve indicates the
two points between which this value is calculated.

Copy values as text


If you want to do more advanced statistics it is possible to export all mea-
sured values to an external program. Right click in the graph and select Copy

IQANrun User manual 50


Tools
3 Online

Values as Text. All values are now copied to Windows clipboard. Start the
other program and select Paste.

Zooming
You can easily select a section of the curves to be enlarged. Select the zoom
area by holding the left mouse button while you drag the mouse cursor over
the desired enlargement area. A zoom area is built around what will be
enlarged.
To zoom in time or X-axis only, position both cursors on either side of the
area to be zoomed. Right click in the graph and select, View Cursor Range.
Another way of doing this is to zoom in as described in the section above
while holding <Shift> pressed.
To view the complete curves again, right click in the graph and select Zoom
out or click the Zoom Out button.

Scrolling
There are two scroll bars to move the graph and curves in either horizontal or
vertical direction.
To move the active curve in the Y (up/down) direction, use the vertical scroll
bar on the right of the graph. When no measure item is selected, all curves are
moved at the same time.

Scaling
It is possible to auto scale each channel. Use Auto Scale Join to make each
channel’s values fit within the Y axis limits. The channels’ values will
overlap.
Use Auto Scale Split to split the channels so that no channel will overlap any
other channel. All channels will be visible in the graph without any
overlapping.
To manually scale a measure item, right-click in the item list and select Prop-
erties. A dialog box appears.

Measure item properties.

IQANrun User manual 51


Tools
3 Online

Enter min and max values for the Y axis. You can also change the color of the
measure item’s curve if you like. Click OK to update the graph.

IQANrun User manual 52


Tools
3 Online

Logs
Use this button to view and manage logs in the connected IQAN system.

Logs.

Click Logs on the side tool bar or press <Alt+L> to see a list of all available
logs in the connected master module. Some logs may be protected by a PIN
code. Those logs are marked with a small lock symbol. See also section PIN
code protection on page 36.
If you miss some log in the list that you know should be there, you may need
higher access rights. Log in as a different user with sufficient access rights
and try again. See section Login on page 69 for more information.

Add record
Click Add Record to add some text to the system log. A dialog box is pre-
sented. Enter the text you want to add in the system log and click OK. The
maximum number of characters is 250.
The text record is added with the description External record and the text you
entered as its value. It is of course stamped with current date and time.

IQANrun User manual 53


Tools
3 Online

Add record dialog box.

Clear log
To delete all records in a log select the log in the list and click Clear Log. A
confirmation dialog box is displayed. Click Yes to clear the log.

Clear log confirmation dialog box.

Some logs require a higher access level to allow this operation. If that is the
case, an error message is displayed. Log in as a different user with sufficient
access rights and try again. See section Login on page 69 for more informa-
tion.

Insufficient access rights.

Get log
To get a complete log and save it as a file, select the log in the list and click
Get Log. The log is downloaded from the connected master module and a
save dialog box is presented. Select folder and file name and save the file.
The file can later be viewed in IQANrun but requires the corresponding
application to be opened first. See section Logs on page 98 for more informa-
tion.

IQANrun User manual 54


Tools
3 Online

View log
Select a log in the list and click Select in the lower right corner to continue.
You can also double-click on a log in the list, or use the arrow keys on the
keyboard and press <Enter> to continue.

System log.

The latest log records are fetched from the connected master module and dis-
played in a list. By default, 50 records are fetched. This can be changed in
Tools > Options under the tab Other. If you would like to see more records,
click More in the bottom tool bar and you will get 50 more.
The log records list has four columns. The list can be sorted in different ways
by clicking the column header that you want to sort by. If you click the same
header once more, the sort order is reversed.

Index Record index. The first record in the log has index 1.

Date/Time Date and time when record was written to log. For
modules with no real-time clock this column is titled
Time and lists startup count and time since last startup.

IQANrun User manual 55


Tools
3 Online

Description Module or channel name or some other explanatory


text.

Value/Status Value and/or status of this record. Not applicable to all


log records.

Save
Click Save in the main tool bar or press <Ctrl + S> to save all fetched log
records to a file. A save file dialog box is shown.
There are two file formats available.

.irl IQANrun Log file. Use this format to be able to open it


with IQANrun to view it later.

.xls Microsoft Excel Workbook. Saves all fetched log


records in an Excel workbook. Opens the file in
Microsoft Excel after it has been saved.

.xml The eXtensible Markup Language (XML) is a general-


purpose markup language. Its primary purpose is to
facilitate the sharing of structured data across different
information systems.

.csv The Comma-Separated Values file format is a file type


that stores tabular data. It is a delimited text file, which
uses a comma to separate values.

Print
Click Print in the main tool bar or press <Ctrl + P> to print the current log.

Clear
Click Clear Log to clear the current log in the connected master module. All
records are deleted.

Sorting order
Click the column header you would like to sort on. If you click the same col-
umn header again the sort order toggles between ascending and descending.

Done
Clicking Done closes this window and takes you back to the log list. You can
also use the navigation buttons in the main tool bar.

IQANrun User manual 56


Tools
3 Online

Modules
Click Modules on the side tool bar or press <Alt+D> to see a list of all mod-
ules in the connected system.

Module list.

Select a module in the list and click Select in the lower right corner to con-
tinue. You can also double-click on a module in the list, or use the arrow keys
on the keyboard and press <Enter> to continue.

IQANrun User manual 57


Tools
3 Online

Module information.

The information is updated continuously, so you can use this view to measure
module temperature and supply voltage for example.

Save
Click Save in the main tool bar to save current module information as an
HTML file.

Print
Click Print in the main tool bar to print current module information.

Done
Clicking Done closes this window and takes you back to the log list. You can
also use the navigation buttons in the main tool bar.

IQANrun User manual 58


Tools
3 Online

System
Use this button to view system information, such as application name and
machine id. Click System on the side tool bar or press <Alt+S>.

System information.

There may also be additional application specific information.

Save
Click Save in the main tool bar to save current system information as an
HTML file.

Print
Click Print in the main tool bar to print current system information.

Machine Id
Use this button to view and/or set machine id in the connected master mod-
ule. This should only be done once in a machine’s life time, typically in pro-
duction. The machine id is a text of up to 64 characters. It should be a unique
text that identifies each machine. Typically, the machine’s chassis number or
serial number is used as machine id.
IQANrun User manual 59
Tools
3 Online

For example logs and clone files are marked with the actual machine id to
make it possible for you to later identify which machine they belong to.

Machine id form.

Enter the machine id you want and press OK. A dialog box is shown to
inform you about the result of the operation. The master module may also
require a restart before the new machine id is in effect. You will then be given
the option to restart it from IQANrun.

Restart question dialog.

Some logs require a higher access level to allow machine id changing. If that
is the case, an error message is displayed. Log in as a different user with suf-

IQANrun User manual 60


Tools
3 Online

ficient access rights and try again. See section Login on page 69 for more
information.

Date and Time


Click Date and Time to set the real time clock in the connected master mod-
ule.

Set date and time form.

Select Current date and time from this PC to use your PC’s clock to set the
master module clock.
Current date and time with another time zone (GMT) will do the same but
adjust the time to another time zone before setting the master module clock.
The default value shown when you enter this page is the current time zone set
on your PC. For example, to use Pacific Time (US & Canada), enter -8.
Select Other date and time to set date and time to whatever you like.
Click Set to set date and time in the connected master module. A dialog box,
telling you what time was set, is displayed.

IQANrun User manual 61


Tools
3 Online

Date and time adjusted successfully.

Language
Use this button to select language in the connected master module. A list with
all available languages is displayed. The currently active language is selected
in the list.

Language list.

IQANrun User manual 62


Tools
3 Online

To change the active language, select the language you want in the list and
click Select. A message is displayed to inform you that the selected language
was set.

Language set message.

Select Never show this again if you don’t want to see this information dialog
box when setting language in the future. To see it again, reset the “never
show again” flag via Tools > Options > Show again.
The selected language will be used both in IQANrun and in the master mod-
ule. Language affects component names, such as measure groups, adjust
groups, etc and the menu system in the master display.

Modem (RS232)
Use the modem button to set SIM PIN code in the connected master module.
A SIM PIN code is a string that consists of four numerical characters, for
example 4260. You must enter a SIM PIN code if you use a GSM modem
with a PIN code protected SIM card. This is typically done in production
when modem and SIM card has been mounted.

NOTE
If you don’t want to use PIN codes for your SIM cards, you must make sure
that the PIN code protection has been turned off. This can be done by placing
the SIM card in a normal mobile phone and use its menu system to turn SIM
card protection off.

IQANrun User manual 63


Tools
3 Online

Modem form for an RS232 modem.

Enter the SIM PIN code you want and click Set. A dialog box is shown to
inform you about the result of the operation.

SIM PIN code set successfully.

IQANrun User manual 64


Tools
3 Online

Modem (CAN)
If your are using a CAN modem you will need to setup some additional
parameters in order for the modem to be able to connect to internet. To con-
figure these parameters you need to be connected with IQANrun to the CAN
bus where the modem is located. By clicking the Modem button the modem
will be detected and you can configure the parameters required for the inter-
net connection.

Modem form for a CAN modem.

The Internet service provider settings can be retreived from your network
provider. Often the only parameter that needs to be entered here is the Inter-
net Access Point Name (APN).
If you need to use the modem outside the home network of your SIM card
(e.g. internationally), you need to enable roaming data. Note however that
IQANrun User manual 65
Tools
3 Online

when connected outside the home network the cost of the data traffic is nor-
mally much more expensive. It is normally recommended to use a local SIM
card instead.
If your SIM card is PIN code protected the PIN code must be entered here
before mounting the SIM card inside the modem to avoid locking it.

NOTE
If you don’t want to use PIN codes for your SIM cards, you must make sure
that the PIN code protection has been turned off. This can be done by placing
the SIM card in a normal mobile phone and use its menu system to turn SIM
card protection off.

Under Modem info you will see the current status of the connected CAN
modem such as network provider, signal strength and network status. Finally
the Modem activation data shows the IMEI number and the activation serial
number that needs to be entered when activating a modem at the remote diag-
nostics server. To make it easier to activate a modem it is possible to copy
each value to the windows clipboard using the Copy buttons.
When you have entered all required parameters click the Set button. Then the
parameters will be stored in the modem and you will return to the system
information page.
You can also save all the modem settings in a file to be able to quickly load
the same settings when configuring multiple modems. This is done using the
Load settings and Save settings buttons.

IQANrun User manual 66


Script
3 Online

Script
This section describes the operations in the Script group. These are Run
Script and Continue Script.

Run Script
Use the Run script button to open a script file. An open file dialog pops up.
Select the script file (extension ids) and click Open. If the script file contains
more than one script a list of the scripts will be shown. Otherwise the script
will be started directly.

The script list is shown if the script file contains more than one script.

When there are multiple scripts in the script file, select the script you want to
run in the list and click Select or double-click on the script. The script is
started.
Scripts usually display their own user instructions. Follow the on-screen
instructions and use the buttons Previous and Continue at the bottom to navi-
gate back and forward within the script.

IQANrun User manual 67


Script
3 Online

Script start page example.

Read more about scripts and script actions in section Scripts on page 115.

Continue Script
While running a script you may want to temporarily move away from the
script to look at a log or measure some channels for instance. As soon as you
do that the button Continue Script lights up. When you’re done measuring or
whatever you were doing, just click Continue Script to resume script execu-
tion from where you left it.

IQANrun User manual 68


Security
3 Online

Security
Some application components or operations may be protected by access lev-
els. To access these you have to log in to the machine with a user that has an
access level that is same or higher than the required.
Users an also be managed through IQANrun. To get access to user manage-
ment in IQANrun you need to log in with a user that has administrator rights.
This chapter will explain how this is done.

Login
If you try to perform an operation that is protected by a higher access level
than the one you currently have, that operation will fail due to insufficient
access rights. The same applies if you haven’t logged in at all of course.

Insufficient access rights to set machine id.

Application components such as adjust groups, measure groups or logs may


also be protected in your application. If you are not logged in as a user with
sufficient access level, you will not even see these components in the differ-
ent menus in IQANrun or the master display.

IQANrun User manual 69


Security
3 Online

Only three adjust groups are shown; Loader, Hydraulic output and Engine.

To get access to these operations and components you need to log in to the
master module. Click the Login button on the side tool bar, or press <Alt+N>.
A dialog box is shown, asking for a user name and a password. Enter a user
name that you know exists and its corresponding password, and click OK.

Login dialog box.

It is also possible to store users and their passwords in your password data-
base. Stored users can be accessed in the drop down list Username. When
you select a stored user in the list, its password will be filled in automatically.
Just click OK to log in. Read more about stored passwords in section Pass-
word database on page 141.
After a successful login, the status bar is updated with your user name and
access level. The user icon next to the user name indicates whether you have
administrator rights or not. When you have administrator rights the user icon
will have a tie.

IQANrun User manual 70


Security
3 Online

You should now be able to see the protected components in its respective
menus and perform protected operations.

Two extra adjust groups, Transmission and Other, are shown.

Superuser
One user will always exist in every machine, the superuser. Its password is
specified in the application and will therefore be the same in all your
machines that use that application. The superuser will always have the high-
est access level possible. This user is only intended for creation and manage-
ment of other users and should not be used otherwise.

NOTE
The user name for the superuser is Superuser. User names are case sensitive,
so make sure you use a capital S when logging in as this user.

Logout
When you are done with your work in IQANrun, you should log out before
you leave the machine to prevent other users from getting access to the pro-
tected components and operations. Click the Logout button on the side tool
bar, or press <Alt+O>. The status bar is updated to show that you are not
logged in and a message is displayed.

IQANrun User manual 71


Security
3 Online

Logged out dialog box.

Select Never show this again if you don’t want to see this information dialog
box when logging out in the future. To see it again, reset the “never show
again” flag via Tools > Options > Show again.
You will automatically be logged out if the connected master module is shut
down or restarted.

Users
Some users can also create and manage other users. Such users are called
administrator users. Administrator rights can be specified when creating a
new user. Administrator users can only create and manage users with same or
lower access levels than themselves.
To manage other users, first log in as an administrator user, then click the
Users button on the side tool bar, or press <Alt+U>. A list of all users with
same or lower access level than yourself is displayed.

User list.

Print
Click Print in the main tool bar to print current users information.
IQANrun User manual 72
Security
3 Online

Add a user
To add a user, click Add User. A dialog box is shown.

Add user dialog box.

Enter a unique user name and a password. User names and passwords are
case sensitive and can only contain characters A-Z, a-z and 0-9.
Select an access level. You can only select access levels that are the same or
lower than yours.
Enter a tag if you need to identify this user by a number instead of name. This
number can for example be used in the application to control something.
If you want to give this user administrator rights, select the check box Admin-
istrator. This means he or she will be able to add, edit or delete other users.
Click OK to create this user and add it to the connected master module. The
user list is updated to show you the new user.

Delete user
Select the user you want to delete in the user list and click Delete User on the
main tool bar. The user is deleted in the master module and the user list is
updated.

Edit user
Select the user you want to edit in the user list and click Edit User on the
main tool bar. The same dialog box as for Add User is displayed, but this time
all fields are filled in with the selected user’s data. Change one or more fields
and click OK to update the user with the new data. The user list is updated to
show you the changes.

IQANrun User manual 73


Security
3 Online

Static users
Some users, for example Superuser, are part of the application. Such users are
static and added when their application is downloaded to the master module.
Static users are the same (same user name, password and access level) on all
machines that use that application.
Static users can not be edited or deleted by IQANrun. They are marked with a
lock symbol in the user list.

Dynamic users
The users that are added by IQANrun are called dynamic users. These users
can differ from machine to machine.

IQANrun User manual 74


File operations
3 Online

File operations
This section describes the machine data management operations. These are
Update, Get Settings, Send Settings, Get Clone and Send Clone.

Update
Use this button to send a new application to the connected master module.
Shortcut key is <F11>. An open file dialog is shown. Select the application
file you want to send. A confirmation dialog box, showing you information
about the application you selected, is displayed.

Application information.

Click Yes to continue. A warning message is displayed to remind you that the
machine has to be stopped to proceed. Verify that the engine has been shut
down and click OK to continue.
If you have activated the select languages dialog box, it will be displayed
now. This dialog is activated by selecting the option Show send language
options dialog in Tools > Options, tab Languages.
Select the languages that you want to send to the master module. The default
language at the top of the list must always be sent and can not be deselected.

Select languages.

IQANrun User manual 75


File operations
3 Online

Select only the languages you need to shorten the download time and save
memory space in the master module. There will also be less options to choose
from for the machine owner in the language menu on the master display.
When you have selected the languages you want, click OK to proceed with
the application download.
Status is shown during the send operation by a progress bar.

Sending application.

After sending is complete, the master module will automatically be restarted.


Depending on which type of master module you use, this can take some time.
After a new application has been downloaded, some master modules need to
burn it in their memory at the first start-up. Do not turn off the power to your
master module during this operation.

Abort file transfer


If the file transfer has to be stopped, click Cancel.

ATTENTION
When sending an application to the master, first make sure the machine is not
moving and the engine is shut down.

Get settings
Use this button to get all settings from the connected master module and save
them in a settings file. The settings file can later be used to send these settings
to another master module. Shortcut key is <Shift+F12>.
A settings file contains adjustable, factory default and stored values.

Adjustable values User settings for voltage inputs, current outputs, PWM
outputs, servo outputs and function parameters.

Factory default values Factory settings for same as above.

Stored values Values for event counters, timers, SMS inputs, text
parameters, state parameters, etc.

IQANrun User manual 76


File operations
3 Online

After the file has been received, a save file dialog box is shown. The file is by
default named <Machine id>.irs to make it easier for you to know which
machine it belongs to.

Send settings
Use this button to send the settings from a previously saved settings file to a
master module. See previous section for more information on settings files.
Shortcut key is <F12>.
Only settings that you have access rights to change will be updated. All other
settings are left unchanged. Make sure that you are logged in with sufficient
access rights before you perform this operation. See section Login on page 69
for more information. There will be no notification if your access level is too
low for some settings.

NOTE
The settings file has to belong to the same application as the one used in the
master module. If it doesn’t, the operation is aborted and an error message is
displayed.

Get clone
Use this button to get all clone data from the connected master module and
save them in a clone file. The clone file can later be sent to another master
module or viewed in IQANrun. More information on clone file viewing can
be found in section Clone file on page 107. Shortcut key for Get Clone is
<Shift+Ctrl+F11>.
Clone files are used to make a complete copy of a master module. They
include application, firmware, users, settings, machine id and logs.
There are mainly two scenarios where you would like to use clone files.
The first one is when you for some reason need to replace a master module
out in the field. To guarantee that you get exactly the same function with the
new master module, you must copy all information from the old one to the
new.
The second scenario is when you have a problem with a machine that you
need assistance to solve. Make a clone file of your machine and send that file
to your support contact. Now they have an exact copy of your machine and
can much easier help you with your problem.
Logs can be very large and are therefore optional. When you click Get Clone
a confirmation dialog pops up asking whether you would like to get logs or
not.

IQANrun User manual 77


File operations
3 Online

Get logs confirmation dialog.

After the data has been received, a save file dialog box is shown. The file is
by default named <Machine id>.irc to make it easier for you to know which
machine it belongs to. Select folder and file name for your clone file and click
Save.

Send clone
Use this button to send all clone data from a previously saved clone file to a
master module. Shortcut key is <Ctrl+F11>.
Before the data is sent, IQANrun checks that your access level is high enough
for this operation. If you need higher access level, you will be given the
option to log in as a different user.

Higher access level required.

After the clone file has been sent a dialog box is displayed that informs you
about what was sent and what wasn’t. Logs can not be exchanged and are
therefore never sent, only received.

IQANrun User manual 78


File operations
3 Online

Send clone information dialog box.

Only settings that you have access rights to change will be updated. All other
settings are left unchanged. Make sure that you are logged in with sufficient
access rights before you perform this operation. See section Login on page 69
for more information.

IQANrun User manual 79


Summary
3 Online

Summary
Send operations
This table summarizes what parts of the machine information is exchanged
with different send operations.

Information Update Send settings Send clone


application

Application (including Yes No Yes


application default values,
languages and static users)

Logs No No No

Adjustable values No Yes Yes

Factory default values No Yes Yes

Stored values No Yes Yes

Machine id No No Yes

Dynamic users No No Yes

Static and dynamic users are explained on page 74.

IQANrun User manual 80


4 View

This section describes the View tab on the side tool bar. It is basically a tree
view that lets you navigate through channels, functions, modules, logs and
settings. Detailed information can easily be accessed in the main panel when
working with the View tab.
Everything can be reached by opening files on your hard drive. You don’t
have to be connected to a master module.
If you are using a third party archive, not all of the described functions in this
chapter may be available. Read section Archives on page 108 for more infor-
mation.

IQANrun User manual 81


View tab buttons
4 View

View tab buttons


This section describes the buttons on the View tab. There are four buttons: Get
Application, Get Log, Get Settings and Compare Settings.

Get Application
Click this button to get the application from a connected master module
instead of opening an application file. The application is transferred from the
master module to IQANrun and then opened so you can view it.
For more information see section Application on page 84.

Get Log
First, open or get an application. Then select the log you want to view in the
tree view below and click Get Log to get the log records from a connected
master module. The log is transferred from the master module to IQANrun
and then opened so you can view it.
For more information see section Logs on page 98.

Get Settings
First, open or get an application. Then click Get Settings to get the settings
from a connected master module. All settings are transferred from the master
module to IQANrun and then opened so you can view them.
For more information see section Settings on page 103.

Compare Settings
First, open or get an application. Then open or get settings for that application
and click Compare Settings. Select another settings file (irs) to compare with
the current settings.
For more information see section Compare settings on page 104.

IQANrun User manual 82


View tab tree view
4 View

View tab tree view


The view tab tree view contains five root nodes:
• Application
• Channels
• Modules
• Logs
• Settings
Each root node displays different information about an application and/or
machine. Depending on how a file or machine is protected, all nodes may not
be visible. For detailed information on each root node, see the following
chapters.

View tab tree view.

IQANrun User manual 83


Application
4 View

Application
This node is used to view structure and flow of an application. Start by open-
ing an application file or to get an application from a connected master mod-
ule.
• To open a file, click Open in the main tool bar or File menu. The shortcut
key for Open is <Ctrl+O>. Select the application file you want to view and
click Open.
• To get the application from a master module, first select the View tab and
then click Get Application in the side tool bar or press <Shift+F11>.
If the application is protected by a password you will be asked to enter the
correct password to view it. Application passwords can also be stored in your
password database. By doing that, IQANrun will automatically enter the cor-
rect password when you open the application. See section Password database
on page 141 for more information.

Enter application password dialog box.

The application is opened and the tree view on the side tool bar is filled with
information. At the top of the tree view, there is a node called Application.
Under this node, function group nodes are added. Click any of the nodes to
view the contents of its function group in the main panel.
You may not be able to see the Application node. Some applications require a
certain access level to allow viewing of the application structure. You can get
the correct access level by requesting a safe password with sufficient access
level for application viewing from the IQAN administrator at the OEM. See
section Safe passwords on page 144 for more information.
The Application node can also be disabled by a third party archive. Read sec-
tion Archives on page 108 for more information.
A function group contains channels and/or other function groups. The rela-
tions between them are illustrated with curved lines. Click one of the chan-
nels or function groups to get more information about it.

IQANrun User manual 84


Application
4 View

Application view and function inspector.

Some function groups may be password protected. This is indicated by a


small lock icon at the top right corner of the function group control. The lock
icon may be locked or unlocked depending on whether you are allowed to
view its contents or not.

IQANrun User manual 85


Application
4 View

Locked function group Transmission function.

Password protected function groups must be unlocked to be viewed. To view


its contents, right click on it and select Unlock. A password dialog box is dis-
played. Enter the correct password and click OK. The lock icon should now
be unlocked and you can view the function group.

Enter function group password dialog box.

Function group passwords can also be stored in your password database. By


doing that, IQANrun will automatically unlock the function group when you
open the application. See section Password database on page 141 for more
information.

Property inspector
To the right of the main panel you will find the Property Inspector. The
inspector window can be hidden by clicking the dotted splitter at its left edge.
Resize the inspector by dragging the splitter instead of clicking it. The prop-
erty inspector displays detailed information about the currently selected com-
ponent. Each component has a number of properties that defines its behavior.
A property has a name and a value. The name is listed in the left column of
IQANrun User manual 86
Application
4 View

the property inspector and the value in the right column. At the bottom of the
property inspector there is a hint window that will help you with a detailed
explanation of the currently selected component or property. To select a prop-
erty, click its name in the property inspector.

Property inspector.

Function inspector
Below the main panel there is a panel called the Function Inspector. It will
list functions and objects for the currently selected channel when applicable.
Some channels have multiple functions. Each function will then be displayed
under its own tab in the function inspector. A function consists of two or three
groups of objects. Each object group is calculated separately using the
method displayed below its list of objects. Select an object to get detailed
information about it in the property inspector.

IQANrun User manual 87


Application
4 View

Function inspector.

Measure
It is possible to measure all channel values and status by clicking Start Mea-
sure in the main tool bar, or by pressing <F7>. This operation requires a con-
nection to a master module.

Measure active.

Value and status are measured in real-time. The update speed depends on
what communication interface you use and how many channels you are view-
ing.
Click Stop Measure in the main tool bar or press <Shift+F7> to stop measur-
ing.

User defined measure groups


Channels can be added to user defined measure groups on the Online tab. To
do that first you need to connect to a machine (or simulator) running the same
application, for instance by measuring it on the Online tab (see section Mea-

IQANrun User manual 88


Application
4 View

sure on page 44). Then in a function group on the View tab select the channel
you want to add and right-click on it. Select Add to Measure Group and then
select the group you want to add it to from the menu shown.

NOTE
You must add the user defined measure group on the Online tab before you
can select it in a popup menu on the View tab. See section User defined mea-
sure groups on page 45.

Print
Print the current view by clicking Print in the main tool bar or by pressing
<Ctrl+P>.

Options
There are some options that control the user interface for function groups.

Function group options.

IQANrun User manual 89


Application
4 View

Show hints Displays tool-tip hints when hovering over channels


and function groups.

Show grid Displays a grid in the background.

Grid size, X and Y Number of pixels between each grid pixel.

Grid color Color of grid pixels.

Draw reference lines Specifies how reference lines between components are
drawn.

Reference line colors Color of reference lines.

Value type colors Channels can be colored differently depending on


which value type they have.

Check status colors Channels can be colored differently depending on their


application check status.

For more information about applications, function groups, channels, func-


tions and objects, see IQANdesign User Manual.

IQANrun User manual 90


Channels
4 View

Channels
This node lists all channels in an application. Start by opening an application
file or to get an application from a connected master module. See section
Application on page 84 for a detailed description on how to open an applica-
tion.
You may not be able to see the Channels node. Some applications require a
certain access level to allow viewing of channels. You can get the correct
access level by requesting a safe password with sufficient access level for
application viewing from the IQAN administrator at the OEM. See section
Safe passwords on page 144 for more information.
The Channels node can also be disabled by a third party archive. Read section
Archives on page 108 for more information.
Select the node Channels to view all channels in the current application.
Under the Channels node, a separate node for each channel type available in
the current application is created. This makes it easy to view for instance all
digital inputs in an application. Just click the node Digital in under Channels
to view only digital inputs in the list view.

Channel list view.

IQANrun User manual 91


Channels
4 View

The main panel contains a list view where channels are listed. The list has
seven columns. The list can be sorted in different ways by clicking the col-
umn header that you want to sort by. If you click the same header once more,
the sort order is reversed, from ascending to descending or vice versa.

Name Channel name.

Order Calculation order. Channels with lower calculation


order are calculated before channels with higher
calculation order.

Type Channel type.

Module Which module the channel is assigned to.

Function group Which function group the channel belongs to.

Value Channel value.

Status Channel status.

You can quickly jump to a channel in the function group view to see its rela-
tions with other channels. Select the channel in the channel list and right-click
on it. In the popup menu, select Go To Channel. Focus is redirected to the
function group to which this channel belongs and the channel is selected. You
can also double-click on a channel in the channel list to perform the same
operation.

Property inspector
The property inspector is available to the right of this view. See section Prop-
erty inspector on page 86 for more information.

Function inspector
The function inspector is available at the bottom of this view. See section
Function inspector on page 87 for more information.

Measure
It is possible to measure all channel values and status by clicking Start Mea-
sure in the main tool bar, or by pressing <F7>. This operation requires a con-
nection to a master module.
Value and status are measured in real-time. The update speed depends on
what communication interface you use and how many channels you are view-
ing.
Click Stop Measure in the main tool bar or press <Shift+F7> to stop measur-
ing.

IQANrun User manual 92


Channels
4 View

User defined measure groups


Channels can be added to user defined measure groups on the Online tab. To
do that first you need to connect to a machine (or simulator) running the same
application, for instance by measuring it on the Online tab (see section Mea-
sure on page 44). Then in a channel list on the View tab select the channel you
want to add and right-click on it. Select Add to Measure Group and then
select the group you want to add it to from the menu shown.

NOTE
You must add the user defined measure group on the Online tab before you
can select it in a popup menu on the View tab. See section User defined mea-
sure groups on page 45.

Print
Print the current view by clicking Print in the main tool bar or by pressing
<Ctrl+P>.

IQANrun User manual 93


Modules
4 View

Modules
The Modules node is used to view modules, CAN buses and channel connec-
tions. Start by opening an application, see section Application on page 84.

NOTE
The Modules node can be disabled by a third party archive. Read section
Archives on page 108 for more information.

System overview
Select the node Modules to view the system overview. It will show all mod-
ules and CAN buses in the current application in a tree view. The tree view
structure represents how the modules are connected to each other via CAN
buses.

System overview.

Each module and CAN bus has its own symbol and name in the tree view.
Select a module or CAN bus to get detailed information about it in the prop-
erty inspector.

IQANrun User manual 94


Modules
4 View

Measure modules and buses


It is possible to measure module and CAN bus status by clicking Start Mea-
sure in the main tool bar, or by pressing <F7>. This operation requires a con-
nection to a master module. For CAN buses, utilization is also measured.
CAN bus utilization will tell you how much of the available bandwidth is
used in reality.
Value and status are measured in real-time. The update speed depends on
what communication interface you use and how many channels you are view-
ing.
Click Stop Measure in the main tool bar or press <Shift+F7> to stop measur-
ing.

Block diagram
Under the Modules node there is one node per module in the current applica-
tion. Select a module node to view its block diagram. The block diagram
view displays all channels and their connections for the selected module.
Channels are displayed with name and index. If you hover with the mouse
over a channel index, its pin number is displayed in a small tool-tip window.

Module block diagram.

IQANrun User manual 95


Modules
4 View

You can quickly jump to a channel in the function group view to see its rela-
tions with other channels. Select the channel in the block diagram and right-
click on it. In the popup menu, select Go To Channel. Focus is redirected to
the function group to which this channel belongs and the channel is selected.

Pin list
In the module block diagram view there is a second tab called Pin List. This
tab contains a list of all pins on the current module. The list has three col-
umns.

Pin Connector and pin number.

Name A short description of what this pin is used for.

Channel Name of the channel connected to this pin.

Description Channel description.

Pin list view.

IQANrun User manual 96


Modules
4 View

Property inspector
The property inspector is available to the right of this view. See section Prop-
erty inspector on page 86 for more information.

Measure channels
It is possible to measure all channel values and status in the block diagram
view by clicking Start Measure in the main tool bar, or by pressing <F7>.
This operation requires a connection to a master module.
Click Stop Measure in the main tool bar or press <Shift+F7> to stop measur-
ing.

Print
Print the current view by clicking Print in the main tool bar or by pressing
<Ctrl+P>.

IQANrun User manual 97


Logs
4 View

Logs
Use the node Logs to view logs in an application. First, you must open the
application. This is described in section Application on page 84.

NOTE
The Logs node can be disabled by a third party archive. Read section
Archives on page 108 for more information.
Select Logs in the tree view to view a list of logs in the current application.
The log list has four columns. The list can be sorted in different ways by
clicking the column header that you want to sort by. If you click the same
header once more, the sort order is reversed, form ascending to descending or
vice versa.

Name Log name.

Order Logs with lower calculation order are calculated before


logs with higher calculation order. This is also the
order used when displaying logs in the master display’s
menu system.

Description Log description.

Type There are three log types; System log, Event log and
Statistics log.

Log list.

IQANrun User manual 98


Logs
4 View

Under the node Logs there is one node for each log. Select a log node to view
log items and records for that log. You will only be able to see those logs that
you have sufficient access rights to view. If you are missing one or more logs,
you need to request a safe password with sufficient access level for the logs
you want to view from the IQAN administrator at the OEM. See section Safe
passwords on page 144 for more information.

Log items
To view the log items in the selected log, select the tab named Items in the
main panel. A list of all log items is displayed. Use the property and function
inspectors to get detailed information about a log item. See section Property
inspector on page 86 and section Function inspector on page 87 for more
information on the inspectors.

Log items.

Measure log items


It is possible to measure all log items, value and status, by clicking Start Mea-
sure in the main tool bar, or by pressing <F7>. This operation requires a con-
nection to a master module. Log item objects are also measured in the
function inspector.
Value and status are measured in real-time. The update speed depends on
what communication interface you use and how many channels you are view-
ing.
Click Stop Measure in the main tool bar or press <Shift+F7> to stop measur-
ing.

IQANrun User manual 99


Logs
4 View

Log records
You can also view the records in a log by selecting the tab named Records.
This tab displays a record list. The list is initially empty. To fill it with infor-
mation you can either get the log contents from a connected master module or
open a previously saved log file.
To get a log from a master module, select a log node in the tree view to the
left and click Get Log in the side tool bar or press <Shift+F8>. All records in
the selected log are received from the master module. This may take a while
if you use a slow communication interface or if the log is very large. A prog-
ress bar is displayed to show you how much has been received.

Get log progress bar.

To open a previously saved log file instead, click Open in the main tool bar or
press <Ctrl+O>. Select the log file in the open file dialog that pops up and
click Open. File extension for a full log file is irf.

IQANrun User manual 100


Logs
4 View

Log records.

The log records list has four columns. The list can be sorted in different ways
by clicking the column header that you want to sort by. If you click the same
header once more, the sort order is reversed.

Index Record index. The first record in the log has index 1.

Date/Time Date and time when record was written to log. For
modules with no real-time clock this column is titled
Time and lists startup count and time since last startup.

Description Module or channel name or some other explanatory


text.

Value/Status Value and/or status of this record. Not applicable to all


log item types.

You can quickly jump to a record component’s original view. Select the
record in the list and right-click on it. In the popup menu, select Go To Com-
ponent. Focus is redirected to the form where this component is located and
the component is selected.

NOTE
You must open or get the application that the log belongs to before you can
open or get the log records. If you don’t have the correct application opened
you will get an error message when you try to open the log.

IQANrun User manual 101


Logs
4 View

Wrong application error message.

Save
Save the records in the list by clicking Save in the main tool bar or by press-
ing <Ctrl+S>. Log records can be saved in IQANrun format (irl), Microsoft
Excel Workbook format (xls), XML format or CSV format.

Print
Print the record list view by clicking Print in the main tool bar or by pressing
<Ctrl+P>.

IQANrun User manual 102


Settings
4 View

Settings
The Settings node lists all settings in the current application that you have
access to view. The settings are presented in a tree list view, arranged by
channel type. Initially the tree list is empty. Start by opening an application,
see section Application on page 84. The tree list is now populated with all the
adjustable or stored channels in the application, but there are no settings val-
ues. To view the values, you need to open a settings file or get the settings
from a connected master module.
To open a settings file, click Open in the main tool bar or main menu or press
<Ctrl+O>. Select the settings file, extension irs, and click Open.
To get the settings from a connected master module, first select the View tab
and then click Get Settings in the side tool bar, keyboard shortcut is
<Shift+Ctrl+F12>.

Settings tree view.

NOTE
The Settings node can be disabled by a third party archive. Read section
Archives on page 108 for more information.

IQANrun User manual 103


Settings
4 View

Some settings may require a higher access level to allow viewing. To get suf-
ficient access rights for the settings you need to see, request a safe password
with the required access level from the IQAN administrator at the OEM.
Above the tree list view there is a caption that displays the id for the machine
that the settings belong to.

NOTE
You must open or get the application that the settings belongs to before you
can open or get the settings. If you don’t have the correct application opened
you will get an error message when you try to open the settings.

Tree list view


There is one node for each channel in the tree view. Under each channel node
there can be additional nodes. Channels that have a factory default value will
have a child node for that. Channels with multiple modes will have one child
node for each mode.
The settings values are listed to the right of the channel or mode name. Chan-
nels that have more than one parameter will have one value per parameter.
The parameters are listed in columns. There is a caption row for each channel
type that lists parameter names in bold.
If an adjustable value for a channel differs from the factory default value, that
value can optionally be listed in different color. The default color is red. This
will help you to quickly spot settings that deviate from the factory default.
Change the color under Tools > Options > Appearance > Settings viewer.

Settings viewer options.

You can quickly jump to a channel in the function group view to see its rela-
tions with other channels. Select the channel in the settings tree list view and
right-click on it. In the popup menu, select Go To Channel. Focus is redi-
rected to the function group to which this channel belongs and the channel is
selected.

Compare settings
To compare the current settings with the settings from another machine or
date, click Compare Settings in the side tool bar or press <Ctrl+F12>. An
open dialog box is displayed. Select the settings file from the other machine
or date and click Open. The file extension for settings files is irs.
A file compare form is opened. The two settings files are displayed in two
panes next to each other. The two panes scroll together. Lines that differ
IQANrun User manual 104
Settings
4 View

between the two files are marked in red. To the left there is a thumbnail view.
It represents each line of the comparison as a colored line, one pixel high. At
a glance you can see the pattern of differences throughout the comparison.
The white rectangle represents the main display's current view, and the small
triangle represents the display's current line. Click on a line in the thumbnail
to position the display at that location.
On the bottom of the display is the status area. It displays a summary of all
differences between the two files.

Compare settings.

There is also a small tool bar available with commands that will help you to
navigate in the file panes.

Next/Previous Difference Navigates to the next/previous difference found.


(Ctrl+Down/Ctrl+Up)

Reload (Ctrl+R) Reloads the files and updates the differences. Not
applicable when comparing settings.

Find Next/Previous (F3/ Enter a search phrase in the edit field and click one of
Shift+F3) the buttons to search up or down in the active pane. To
search in the other pane, activate it by clicking in it.

Close Close this window and return to IQANrun.

IQANrun User manual 105


Settings
4 View

NOTE
The two settings files must belong to the same application, otherwise they can
not be compared. If they belong to different applications, an error message is
displayed.

Wrong application error message.

Print
Print a settings list view by clicking Print in the main tool bar or by pressing
<Ctrl+P>.

IQANrun User manual 106


Clone file
4 View

Clone file
In the previous sections in this chapter we have mostly been discussing appli-
cation files, but there is another file type that can be used here, the clone file.
A clone file contains an application, settings, machine id and logs.
When you open a clone file, you will get access to view a complete machine
at once. The entire tree view will be filled with information; application,
channels, modules, logs and settings.

NOTE
Log records are optional when you upload a clone file from a machine. If the
user that uploaded the clone file chose not to get logs, there will be no log
records available when you view the clone file.
To open a clone file, click Open in the main tool bar or main menu, or press
<Ctrl+O>. An open file dialog is displayed. Select the clone file and click
OK. Clone files have file extension irc.

IQANrun User manual 107


5 Archives

This section will explain the concept of archives. Archives are used to cus-
tomize IQANrun’s user interface.

IQANrun User manual 108


Archive contents
5 Archives

Archive contents
An archive is used to customize the user interface of IQANrun. It contains
one or more pages that can be displayed in IQANrun’s main panel, similar to
a web browser displaying web pages. Each page can contain text, graphics
and hyperlinks.
When IQANrun is started it will use the start page of the currently active
archive as its home page. You can easily reach the home page from anywhere
in IQANrun by clicking Home in the main tool bar or select View > Home.
The shortcut key is <Alt+Home>.
There will always be at least one archive available, the default archive that
comes with the installation program. The default archive is very simple, it
only contains one page with the Parker logotype. The logotype is a hyperlink
to Parker’s web site.

Default archive start page.

Archives can also contain files, such as manuals, instructions, applications,


scripts and videos. The files are reached through hyperlinks on archive pages.
For example, the machine user manual is stored as a PDF file in the archive
and is connected to a hyperlink on the start page called User manual. When
you click on that hyperlink, Adobe Acrobat Reader is started and opens the

IQANrun User manual 109


Archive contents
5 Archives

user manual. Of course, Adobe Acrobat Reader has to be installed on your PC


for this to work.
Hyperlinks can be either text or images. Text hyperlinks are easily recognized
by the blue color and underline format, just like a normal web page.
Another use of archives is to reduce the functionality of the side tool bar. But-
tons and tree view nodes can be disabled and/or made available as hyperlinks
on any of the archive pages. This is all up to the designer of the archive.
For detailed information on how to use your specific archive, please contact
the designer of the archive, usually the machine manufacturer.

IQANrun User manual 110


Multiple archives
5 Archives

Multiple archives
IQANrun can handle multiple archives, but will only allow one to be active at
a time. All you have to do is install the archives you need and then select
which one you want as your active archive. You can switch to another archive
whenever you like.

Install archive
To install a new archive, select File > Install Archive. An open file dialog is
displayed. Select the archive file you want to install and click Open. Archive
files have the extension ica.
If the same archive file was already installed you will be asked if you want to
replace it with this file.

Archive already exists message.

The archive is now installed and selected as the active archive, which means
IQANrun will now use its start page as the new home page.
All the blue underlined texts you see in the image on page 112 are hyperlinks
that can be clicked on. Some of them will take you to another page in the
archive and others will open up web pages or documents in external pro-
grams.

IQANrun User manual 111


Multiple archives
5 Archives

Archive start page example.

Select archive
To select another archive as your active one, select File > Select Archive. A
thumbnail view of all installed archives is displayed in IQANrun’s main
panel. Select the archive you want and click Select.
The archive is selected as the active archive and IQANrun will use its start
page as the new home page. Of course IQANrun will remember the selection
you made, so the next time you start IQANrun, this archive will still be the
selected archive.

IQANrun User manual 112


Multiple archives
5 Archives

Select archive form.

Delete archive
If you would like to delete an archive, first select it as the active archive, then
select File > Delete Archive. A confirmation dialog pops up. Click Yes to
confirm. The archive is deleted.

Delete archive confirmation.

IQANrun User manual 113


Check for updates
5 Archives

Check for updates


Archives can be updated via Internet, just like IQANrun. Use the Check for
Updates item on the Help menu to update your archives.
IQANrun will contact the update server for each of your archives to check if
there are any updates available. It will also check for updates on IQANrun
itself.
If updates are found a list of all available archive updates is displayed. Select
the archives that you want to update by checking the corresponding check-
boxes in the list. Click OK to proceed with downloading and installing the
selected updates. To save time, IQANrun will only download those parts of
an archive that has been updated, not the complete archive file.

Archive updates available.

NOTE
Not all archives support web updating. This is decided by the archive
designer. Of course, archives without web update support will not be checked
for updates. Please contact the archive designer for more information or
should there be any problems with your archive update.

NOTE
On rare occasions, you may have to update IQANrun before you are allowed
to update an archive. When this happens you will be informed and only
IQANrun will be updated. After IQANrun has been updated and restarted,
select Help > Check for Updates once more to update the archive(s).

IQANrun User manual 114


6 Scripts

This section describes the script concept in IQANrun. A script can be used to
perform a sequence of actions, either manually or automatically. All actions
are logged and presented in a report at the end of the script.

IQANrun User manual 115


Run script
6 Scripts

Run script
Use the Run script button to open a script file. An open file dialog appears.
Select the script file you want to use and click Open. Script files have the
extension ids. If the script file contains more than one script a list of the
scripts will be shown. Otherwise the script will be started directly.

The script list is shown if the script file contains more than one script.

When there are multiple scripts in the script file, select the script you want to
run in the list and click Select or double-click on the script. The script is
started.
Scripts usually display their own user instructions. Follow the on-screen
instructions and use the buttons Previous and Continue at the bottom to navi-
gate back and forward within the script.

IQANrun User manual 116


Run script
6 Scripts

Script start page example.

A script contains a number of pages that will be shown in sequence when you
run it. On each page instructions and information can be presented. You can
also be requested to enter information or adjust parameters in the master
module.
A script can perform most of the actions that can be done manually with
IQANrun. The difference is that a lot of the actions can be performed auto-
matically without any user interaction.

IQANrun User manual 117


Script actions
6 Scripts

Script actions
This section describes the different script actions that you will encounter
when running a script. Note that the actions listed here are the only the ones
requiring user input. Other script actions are executed silently between one
page and the next.

Instructions
Instructions can contain text that gives you instructions on how to use the
script or how to perform a certain task. The instructions can also contain
images to give further help.

Instructions example.

Menu
A menu lets you choose one of several options and at the same time continue
to the next page in the script.

An example of a menu in a script.

Text input
During the script execution you might be requested to enter text for different
purposes. A text input field can look different depending on the purpose. For
example it can have one or several rows, there can be predefined choices or
the input could be hidden when it is used for passwords.

IQANrun User manual 118


Script actions
6 Scripts

Examples of text input fields.

Check boxes
Check boxes are used in the script to enter values that can be either true or
false (on/off). It can typically be used to set options for a machine or a check-
list of items that should be done.

Checkbox example.

Radio buttons
Radio buttons are used to select one choice from a number of available
options.

Radio buttons example.

Condition checks
Sometimes it is required that a condition is fulfilled before you are allowed to
continue to the next page in the script. These conditions can be for example
the value of a measured channel in the master, or that you have to tick of a
number of items in a checklist.

IQANrun User manual 119


Script actions
6 Scripts

Condition check not fulfilled.

Condition checks OK.

When the condition is not fulfilled and you are not allowed to continue the
Continue button is disabled. There can however also be cases when you are
allowed to continue even if a condition is not fulfilled. In these cases you
might be requested to enter a comment to clarify why the condition was not
fulfilled.

Comment dialog when a condition is not fulfilled.

Measure
A channel value can be measured on a script page. The value is updated con-
tinuously as long as the page is shown. The channel’s unit and status are also
shown.

Channel measurement in a script.

IQANrun User manual 120


Script actions
6 Scripts

Timer
A timer is used to measure execution time of some operation. For example it
can be used to measure the time of the boom’s movement from minimum to
maximum position.

Timer example.

Invalid channel listing


This action lists all invalid physical channels on the master and it’s expansion
units. You can use this list to find out if there are any errors in the system,
such as unconnected inputs, shortage or timeouts. When the channel’s status
changes to OK it is kept in the list but the icon changes from red to green.

Invalid channel list.

You can resize the list by dragging the splitter at the bottom.

Adjust
The adjust functionality in the scripts works in the same way as the adjust
function described in section Adjust item on page 38.

Set language
This function provides a drop down list where you can select the language to
use in the master module. The same language will also be used in the script if
it has been translated to the selected language.

Set language drop down list.

Set machine ID
The machine ID input field has current machine ID as it’s default value. You
can change the machine ID by typing a new value.

IQANrun User manual 121


Script actions
6 Scripts

Set machine ID.

Read logs
This action shows log records from a log in the master unit. It might be lim-
ited to show only the most recent log items depending on the setting in the
script.

An example of read log.

IQANrun User manual 122


Script report
6 Scripts

Script report
When the script has been executed the result is shown in the form of a report.

Example of a script report.

Printing the report


You can print the current report using the Print button or by selecting File >
Print from the menu. If you have a PDF printer driver installed you can use
the print function to save the report to PDF.

Saving the report


You can save the report in the three different formats.

IQANrun User manual 123


Script report
6 Scripts

.htm Single HTML file. Images in the report will be saved as separate files.

.mht HTML archive. One single file containing both the report and images.

.xml Saves all the data from the script execution in XML format.

A script can be configured to automatically save the report. In this case an


XML report is saved in the script output folder, see section Options on page
127. The XML format is suitable for import of report data to for example
other databases.

IQANrun User manual 124


Script execution errors
6 Scripts

Script execution errors


While the scripts executes an error may occur. It can be a e.g. communication
errors, authorization errors or calculation errors. When an error occurs an
error dialog is shown.

Example of error dialog while executing a script.

The script error dialog contains two or three buttons. The Abort button aborts
the script. The Retry button shows the last page of the script again, making it
possible to correct any entries made before retrying the failed action. Finally
the Ignore button executes the next script action, ignoring the one that failed.
The Ignore button is only available if the script action has the property Con-
tinue on error set in the script.
Note that it is possible to continue the script after aborting it using the Con-
tinue script button in IQANrun. This has the same effect as selecting the
Retry button in the error dialog.

IQANrun User manual 125


Script states
6 Scripts

Script states
As the script executes the information collected is stored for use in reports
and other script actions within the script. The information consists of e.g. val-
ues entered on script pages, adjusted parameters and measured values from
the master unit. The collected information and status at a given time is
referred to as the script state.
Some scripts are built so that they can be executed one part at the time until
the complete script has been executed. For example in a production script the
first part could consist of entering some information about the machine. Later
on, another user continues the script and adjusts some machine parameters.
Finally a third user does the final test of the machine and collects measured
data. In the end data from all three script executions are collected in the same
report file.
After each part of the script in the example above IQANrun saves the script
state for that particular machine. When a another user executes the script
IQANrun loads the script state making it possible to collect data from all sta-
tions before getting the final report.
The script state is saved in the script output folder (see section Options on
page 127). To be able to share the states between several computers the script
output folder has to be a common network folder.

IQANrun User manual 126


Options
6 Scripts

Options
There is only one option specific to the scripting functionality. You can
change this option by selecting Tools > Options in the menu. Select the tab
Other to show the option related to scripts.

The options dialog.

Script output folder


This is where IQANrun stores files created while running a script. A folder
structure in created in the specified folder with the following folders:
• Script name
• Machine ID
• Date and time of script execution
A new folder is created each time a script is executed (if any output should be
stored). Files stored in the output folder are for example received clone files,
setting files and generated script reports.
If a script saves it’s state during execution it is also placed in the script output
folder, but directly under the machine ID folder (see also section Script states
on page 126).
IQANrun User manual 127
7 Communication

This chapter describes different ways of communicating with an IQAN sys-


tem. There are six communication types available; USB, CAN, serial port,
simulator, internet and modem.

IQANrun User manual 128


Options
7 Communication

Options
Before transferring data between the PC and the IQAN system, you need to
set up your communication options. Select Tools > Options and select the
Communication tab in the dialog box.
When you have connected the PC with the IQAN system, a green status lamp
lights up in the IQANrun status bar to indicate that the connection is OK.
Note that with some interfaces, e.g. CAN or Simulator, you need to initiate a
communication operation before the status lamp turns green. You will also
need to do this for all interfaces after a connection has been manually discon-
nected.

Select communication device and modem type.

NOTE
Only one IQAN program can be connected to the master module, if e.g.
IQANdesign is measuring and you perform an IQANrun operation using the
same interface, IQANdesign will automatically disconnect.
IQANrun User manual 129
Options
7 Communication

USB
The USB drivers are installed automatically the first time you connect a mas-
ter module to your PC.

ATTENTION
Make certain to use a USB isolator when using the USB port. Failure to do so
may result in damage to your PC's USB port(s). For more information, see the
instruction book for your master module.

CAN
To use CAN as communication device you need a CAN adapter attached to
your PC. For a list of supported CAN adapters, see the software data sheet or
contact Parker support. IQANrun can connect using the first available CAN
adapter or you can select a specific CAN adapter in the options dialog box.
When using CAN, please make sure there is no other traffic (ICP, SAE J1939,
etc) on the bus you are using for diagnostics, otherwise the functionality can
not be guaranteed.
If there are multiple master modules connected to the same CAN bus, you
will be asked which one you want to connect to when you start to communi-
cate.

Module selection dialog.

If you want to switch to another module, select Communication > Disconnect


and then start to communicate again to get the module selection dialog box.

ATTENTION
The CAN adapter must be installed and connected to the PC before the pro-
gram is started, otherwise it will not be detected.

IQANrun User manual 130


Options
7 Communication

Serial port
This requires a standard RS-232 serial port on your PC. Also select which
COM port to use.

Simulator
Select this device to communicate with IQANsimulate instead of a real mas-
ter module. IQANsimulate needs to be started on the same PC and running a
simulation for this communication to work.
The programs will communicate over a TCP/IP port. Port number defaults to
8325 in both IQANrun and IQANsimulate and should not be changed. If you
must change port number, make sure you use the same port in both programs.

Modem
Select a modem in the list. The modem you are planning to use must first be
installed by Windows. Follow the instructions provided by the modem manu-
facturer for more information on the installation procedure.

Internet settings
If you want to connect to a machine over internet and you require a proxy to
connect to internet it can be configured here. By default the system settings is
used, but you can also disable proxy for IQANdesign or use a custom setting.

Quick switch
On the Communication menu there is one menu item for each communication
interface; USB, Serial Port, Simulator, CAN, Internet and Modem. Select one
of the menu items to quickly switch to that communication interface without
having to open the options dialog box.
The currently selected interface is marked with a check box in the menu.

Communication menu.

IQANrun User manual 131


Connect via internet
7 Communication

Connect via internet


If your IQAN system includes an IQAN-G2 modem you can connect
remotely to your system over internet. It is possible to update applications,
measure and do all the things you can do with a local system.
All remote diagnostics communication is routed through a Proemion gateway
server. Because of this you will also need an account at Proemion to be able
to access the remote diagnostics service.

Connect via internet


To connect to an IQAN system over internet, select Communication > Con-
nect via Internet. This brings up a dialog where you need to supply your user-
name and password for the Proemion remote diagnostics service.

Connect via internet dialog box.

After entering username and password, click Get machines to get a list of all
machines that you have access to. To identify the machines in the list their
machine IDs are shown in the first column. In addition to this the IMEI num-
ber of the modem is shown in the list since this is guaranteed to be unique.
The state column shows if a machine is offline, online or busy with a remote
connection. Select a machine that is online and click Connect.

IQANrun User manual 132


Connect via internet
7 Communication

If there are multiple master modules connected to the remote CAN bus, you
will be asked which one you want to connect to when you start to communi-
cate.

Module selection dialog.

NOTE
To be able to connect to the remote diagnostics server IQANrun uses TCP
port number 60100. This means that your firewall must allow for outgoing
connections on this port.

Disconnect
When your done, disconnect from the remote system using Communication >
Disconnect.

IQANrun User manual 133


Modem connection
7 Communication

Modem connection
By connecting a modem to your PC, you can communicate with a remote
IQAN system that is equipped with an RS-232 modem. It is possible to
update applications, measure and do all the things you can do with a local
system.
Start by installing the modem to your PC, follow the installation instructions
that came with the modem. Select the modem you want to use in the IQAN-
run options dialog box under the Communications tab. Before attempting to
communicate with a remote system it is a good idea to verify that a modem is
connected to the remote system master.

Connect via modem


In the Communication menu you will find the command for connecting via
modem. Select Communication > Connect via Modem... and do one of the
following:
• Enter the phone number of the remote modem to be called in the text field
Telephone number.
• Select an entry from the phone book list.
• Select a previously dialled number in the drop down list Telephone num-
ber.

Connect via modem dialog box.

Click Dial to connect to the remote modem.


IQANrun User manual 134
Modem connection
7 Communication

Once communication is initiated the text in the dialog box will keep you
informed with the progress of the call: dialing, connecting, etc.

Abort transmission
If the connection has to be stopped, click Cancel.

Disconnect
When you are ready, disconnect the modem connection by selecting Commu-
nication > Disconnect.

IQANrun User manual 135


Phone book
7 Communication

Phone book
There is a simple phone book available to help you keep track of all your
machines and their phone numbers. Each record in the phone book stores
these fields:
• Name
• Company
• Machine id
• Location
• Phone number
• Comment
To access the phone book, select Communication > Connect via Modem....
The dialog box shown in the previous section (page 134) is displayed.
The contents of the phone book is displayed in the list view in the middle.
Each record is displayed on its own row and each field in a separate column.
You can sort the list by clicking the column header that corresponds the field
you want to sort on. Clicking the same column once more reverses the sort
order.

Add
To add a new record in the phone book, click the button Add. A new phone
book record dialog box appears.

Phone book record dialog box.

Enter record data in the fields and click OK to store the record. All fields are
optional, but you should at least enter a phone number, for obvious reasons.

IQANrun User manual 136


Phone book
7 Communication

Edit
To edit a record in the phone book, select the record in the list view and click
the button Edit. The phone book record dialog box appears. Change one or
more fields and click OK to store your changes.

Delete
To delete a record in the phone book, select the record in the list view and
click the button Delete. A confirmation dialog box appears.

Delete record confirmation.

Click Yes to delete the record.

Export
To be able to share your phone book with others or move it to another com-
puter there is an export function. Click Export and a save dialog box appears.
Select a folder and enter a file name for the file where you want your records
stored. All records in the phone book are exported.

Import
To import previously exported records, click Import. An open file dialog box
appears. Select the file that you want to import. All the records in the file are
imported.

IQANrun User manual 137


Choosing a modem
7 Communication

Choosing a modem
Here are some general guidelines we can offer. Remember, these are only
general guidelines. We have several modems in our lab that break one or
more of these guidelines and still work fine. We also have a couple of
modems that follow all the rules and are problematic.
The guidelines presented here concerns the modems you connect on your PC
side, not the modems you connect to the IQAN master module. For IQAN
modem recommendations, see Remote diagnostics, Catalogue HY17-8372/
UK.

We recommend avoiding Winmodems and RPI modems


These modems, otherwise known as software modems, offload some of the
“smarts” of the modem to the host computer. They use software drivers to
handle things like compression and error correction that are normally handled
by the hardware/firmware in the modem. To be fair, these modems have a
couple advantages – the drivers are easy to update, and the overall cost of the
modem is lowered (the whole concept of a software modem probably came
about as a result of the competition in the modem market).
In our view software modems have several disadvantages, for example:
The host computer is forced to donate resources in support of the communi-
cations session (not only the CPU, but also memory, data bus, power and so
on).
Shifting these duties to software results in an overall loss of efficiency (cus-
tom hardware is better suited to handle this type of processing).
They seldom work well with GSM modems.
How can you tell if a modem is a software modem? Usually, you'll see “Win
modem” or “RPI” somewhere on the box.

We recommend using external modems


This is simply the best way to ensure you get a modem with all its brains
intact. As far as we know, it's not practical to produce an external modem that
uses drivers to handle things like error correction and compression. An exter-
nal modem is also easier to monitor and troubleshoot (most have status indi-
cator lights on the front panel).

We recommend using direct lines


... and not going through the company switchboard. If you have to go through
the company switchboard, use an analog line. Also, make sure the switch-
board doesn’t do any noise reduction on the line you will be using.

We recommend against “chasing the latest technology”


Modem makers often race to hit the market first with a new feature in order to
gain market share. It often takes a little while to get new features reliable
IQANrun User manual 138
Choosing a modem
7 Communication

though, so the first few batches of modems sporting a brand new feature often
aren't as reliable as subsequent batches will be.

We recommend getting a modem with the features you need


... and no more. In other words, if you need a modem strictly for data commu-
nication, why get a voice modem? This is a cost saving recommendation for
the most part, but there's a certain “less can go wrong” issue also.

We recommend using well-known brands


It's tough to know for sure if the maker of your modem will still be around in
a year or two in the event you need a new driver or support for your modem.
The odds seem to be a bit better if you stick to an established brand.

Buy from a store with a reasonable return policy


This should allow you to test the modem in the environment you'll be using.

If you need to buy many modems for a project


... buy one or two first and test them thoroughly with the code you'll be using
before committing the money for all of them. This only makes sense. If you're
going to be buying a couple hundred modems, make sure you're getting
modems that will work well in your situation.

If nothing else works


... try using a GSM modem on the PC side as well. Make sure that both
modems have SIM cards from the same network operator.

IQANrun User manual 139


8 Safe passwords

Files, components and operations are often protected by a password to pre-


vent unauthorized personnel to access sensitive application or machine data.
When you open a protected file, IQANrun will ask for its password. If you try
to perform a protected operation, you will be asked to log in with a user name
and password first.
There is a safe and easy function to handle passwords in IQANrun. By adding
a password to IQANrun’s password database you don’t need to enter it each
time you open a protected file or perform a protected operation. In fact, you
don’t even need to know what the password is.
IQANrun uses something called safe passwords to achieve this. Safe pass-
words are encrypted which means they can be sent safely via for example
email. The encryption also ensures that the end user can not read the actual
password.
Safe password encryption is done with the help of a public key. The public
key ties the safe password to a specific user and computer, which means no
one else than the password requester can use the safe password. Every IQAN-
run user has its own unique public key.

IQANrun User manual 140


Password database
8 Safe passwords

Password database
The password database stores one or many passwords on your computer.
Only you will have access to the passwords. If someone else logs in to the
same computer, they will get their own password database. Passwords stored
in the database can not be copied or moved to another user or computer.
There is a password manager that lets you manage your passwords. Start the
password manager by selecting Tools > Password Manager.

Password manager.

In the password manager you can see your public key and a list of all your
passwords. The password list has four columns. You can sort the list by click-
ing the different column headers.

Name The name of the application, clone, script or archive


that this password is connected to.

Type Password type. There are two types available in


IQANdesign; Full access password and Component
password.

IQANrun User manual 141


Password database
8 Safe passwords

Comment Additional password details.

Id The id of the application, clone, script or archive that


this password is connected to.

Password types
There are four password types available; Full access password, Limited
access password, Component password and Login.

Full access password


Full access passwords are actually meant to be used when opening a pro-
tected file for editing in for example IQANdesign or IQANscript. It can how-
ever be used in IQANrun to open a protected file. You will not be granted
editing access though, only viewing.
A full access password works in the same way as a limited access password,
except it will always allow viewing and provide the highest access level
available. See next section for more details.

Limited access password


Limited access passwords are used when opening a protected file with the
same id as the limited access password. There can only be one limited access
password per id in the database. If you add the same password again, the old
one will be replaced.
There are four file types that can be password protected; applications, clones,
scripts and archives.
Comment shows details for the password, such as viewing access and access
level id connected to this password. Viewing access and access level id are
used for application and clone files. Script and archive passwords always
allow viewing and don’t use access levels.
Viewing allowed for an application (or clone) file means that you have access
to the Application and Channels nodes on the View tab. The Modules, Logs
and Settings nodes are always available. See section View on page 81 for
more information.
The access level id decides which components you are allowed to see on the
View tab. Components that can be protected by access level are; adjust items
(settings) and logs.

Component password
Used to unlock protected components, such as function groups, in files with
the same id as the component password. The component id is shown in com-
ments. See section Application on page 84 for more information on locked
components.

IQANrun User manual 142


Password database
8 Safe passwords

Login
Used to add a user name and password to the login dialog box. Logins are
also connected to an application id. Before you log in, IQANrun checks the
application id in the connected master module and lets you choose between
the users in the password database that have the same id. See section Login on
page 69 for a detailed description.
User name is displayed in comments.

Date restrictions
Passwords can be date restricted, which means they will only be valid until a
certain date. The date is displayed in the comment for date restricted pass-
words. When the valid date has been passed, the password will no longer
work.

ATTENTION
Please don’t try to change the clock in your PC to get around a date restric-
tion. The password manager will detect such attempts and lock the password
completely if necessary.

IQANrun User manual 143


Add password
8 Safe passwords

Add password
Whenever you enter a password for a protected file or component or when
you log in to a master module, you will be asked whether you want to add the
password to your database. Click Yes to store the password.
The password is stored and will be used automatically when IQANrun detects
the need for it next time.

Add password question.

If you click No, the password is added to the database anyway but only tem-
porary. Temporary passwords remain in the database as long as IQANrun is
running. This means that if you open a file with the same id and password
during the same IQANrun session, you don’t have to enter the password
again. When you exit IQANrun, all temporary passwords are removed. The
text (Temporary) is added to the comment for temporary passwords.
If you don’t see the dialog Add password, you probably turned it off by
selecting the check box Never show this again. To get it back, go to Tools >
Options and select tab Show again. Select the check box next to Add pass-
word in the list and click OK.

Safe passwords
To add a safe password to the database, you must first receive it from your
password administrator. You do that by sending the administrator a message,
for instance by email, with your public key and a request for the password
you need.
The public key can be found above the password list in the password manager
dialog. There are also two buttons available. Click Send as Mail to create a
new message in your email software with the public key in it. Add the email
address for the administrator and a request for a password in the message, and
then send it. To enter the public key in some other software, click Copy to
copy it to Windows clipboard and then paste it where you like.
When your request has been granted, you will receive a safe password in
return. The safe password is just a long string of characters. To add it to your
password database, click on the Add Safe button. Enter the password in the
dialog box that appears and click OK.

IQANrun User manual 144


Add password
8 Safe passwords

Add safe password dialog box.

The safe password is added to your password database and appears in the
password list. Check the password list to verify that you received the correct
password with the access you need.

IQANrun User manual 145


Delete password
8 Safe passwords

Delete password
Select a password in the password list and click Delete to delete it from the
database. A confirmation dialog box is shown asking you to confirm the dele-
tion. Click Yes to delete the password.

Delete password confirmation.

Click Delete all to empty the database completely.

IQANrun User manual 146


IQANsimulate

IQANsimulate User manual


9 User interface

This section describes the user interface of IQANsimulate. The user interface
is designed to function with different screen resolutions and font sizes. It is
highly customizable. All settings, such as panel sizes, window positions and
column widths are stored in Windows registry.
Commonly used or important functions are accessible through tool bar
buttons and keyboard shortcuts. The keyboard shortcuts follow Windows
standard whenever possible.

IQANsimulate User manual 148


Main window
9 User interface

Main window
The main window consists of a menu, a tool bar, a status bar, an application
manager (to the left), a property inspector (to the right) and the main panel.

IQANsimulate main window.

The main panel content depends on what you are doing and which system
you are connected to. It is described in detail in the following chapters.

IQANsimulate User manual 149


Menu system
9 User interface

Menu system
This section describes the menu system.

File
New
Creates a new simulation file either by opening an application file or by
selecting a master module type. Select File > New > New to open an applica-
tion file and create a new simulation based on that application.
Select File > New > New Mxx to create an empty simulation based on the
master module type you select. Empty simulations does not contain an appli-
cation, but can still be useful in some situations.

Open
Opens a file and displays its content in the main panel.

File type File content

.isa Simulation, contains an application, simulation groups


and component values.

.ida Application.

Reopen
Contains a list of the most recently used files. Select a file from the list to
open it again.

Save
Saves the current simulation to a file (with extension isa).

Save As
Saves the current simulation to a new file with another name or location than
the present.

Close
Close the currently opened simulation file.

Update Application
Update the application file in the currently open simulation file.

Exit
Quits IQANsimulate.

IQANsimulate User manual 150


Menu system
9 User interface

Edit
Contains the usual edit commands Cut, Copy, Paste, Delete and Rename.
There is also the command Go To Channel that will jump to the channel that
the currently selected component references to.

Simulate
Commands to control the status of the simulator, see section Simulators on
page 179 for more information.

View
Lets you view or hide the different panels IQANsimulate uses; Application
Manager and Property Inspector.
Use Refresh to update the current form in the main panel.

Tools
Contains common tools menu items.

Options
Lets you customize the user interface and behavior of IQANsimulate. See
section Options on page 153.

Password Manager
Opens the password manager, see section Password database on page 189 for
more information.

Help
Contains common help menu items.

Contents
Will bring up the help file, which is this book as a PDF document.

IQAN Home Page


Starts your web browser and goes to http://www.iqan.com.

Release Notes
Displays release notes for the version of IQANsimulate that you are using.

Check For Updates


Check for an updated version of IQANsimulate on the Internet. If there is a
new version, you will be informed on what has been changed and then you
can choose to download and install it on your computer.

IQANsimulate User manual 151


Menu system
9 User interface

File download progress.

When you download a new version, your license and user information will be
sent to our server to collect usage statistics, see table below.

IP address The IP address you are connecting from, typically the


address of your company’s Internet gateway or your
ISP.

License number, name and The number and names you entered when
company IQANsimulate was installed.

License type Full, evaluation or beta.

Installation date The date when IQANsimulate was installed.

Days used The number of days IQANsimulate has been used.

Versions The versions you are upgrading from and to.

NOTE
Check for updates requires an Internet connection.

About
Displays a dialog box with licence and version information.

IQANsimulate User manual 152


Options
9 User interface

Options
This section describes the options that concern the user interface of IQAN-
simulate.

Appearance
There are options that concern the user interface in general. Select Tools >
Options to show the IQANsimulate options dialog box. Switch to the Appear-
ance tab.

Appearance options.

Font
Choose the font to be used in the main window and all dialog boxes.

IQANsimulate User manual 153


Options
9 User interface

Check Use Windows font settings to use the settings from Windows Control
Panel. Or, select your own font and size. The sample will show you how the
selected font looks like.

Use large icons


Select to use large icons on the tool bar icons.

Show tool bar hints


Show hints for the buttons on the main tool bar when you hover with the
mouse over them.

Stay on top when running simulator


Tries to keep IQANsimulate on top of all other programs when you are run-
ning a simulation to let you be able to see and control the simulator all the
time.

Use different window size when simulating


See section Window size on page 187.

Simulator window size


Select the size of the simulator window; Half, Normal, or Double.

Show simulator window


Select to show simulator window while simulating.

Show again
Some message dialog boxes have a check box named Never show this again.
By selecting that check box, you will never be shown that information or
asked that question again. Here is how you enable those messages again.
Select Tools > Options to show the IQANsimulate options dialog box. Switch
to the Show again tab. Select the check box for each message that you want to
be shown again.

IQANsimulate User manual 154


Options
9 User interface

Other
The tab Other collects some other options in IQANrun.

Other options.

File association
Lets you associate IQANsimulate with application files. If the button is dis-
abled, IQANsimulate is already associated with application files. Associating
IQANsimulate with application files means that if you double-click such a
file in Windows Explorer for instance, IQANsimulate will start and open that
file.

NOTE
Changing file associations on Windows Vista requires administrator privi-
leges.

Always open last file


Select to automatically open the most recently used file when IQANsimulate
is started.

IQANsimulate User manual 155


Options
9 User interface

Save before simulating


Select to automatically save the current file before a simulation is started.

Port number
Other programs such as IQANdesign or IQANrun will communicate with
IQANsimulate over a TCP/IP port. Port number defaults to 8325 in all pro-
grams and should not be changed. If you must change the port number, make
sure you use the same port everywhere.

Automatically check for updates


Select how often you want IQANsimulate to automatically check for updates.
Select Never to disable this function.

IQANsimulate User manual 156


Main tool bar
9 User interface

Main tool bar


The main tool bar contains buttons for commonly used file operations.

The main tool bar.

Tool bar buttons (from left to right)

New Open an application and create a new simulation based


on it

Open Open a simulation or application

Save Save current file

Save As Save current file with different name or location

Cut Cut selected component to the clipboard

Copy Copy selected component to the clipboard

Paste Paste component from the clipboard

Delete Delete selected component

Run Start simulator

Pause Pause a running simulation

Stop Stop simulator

Step Run simulator one step (system cycle)

Raw Value Range Raw value range for sliders and edit boxes

Show Simulator Show simulator window while simulating

Simulator Screen Shot Save the current simulator window as a bitmap file

Go Up Jump to parent function group when viewing


application

IQANsimulate User manual 157


Status bar
9 User interface

Status bar
The status bar displays application name, simulation and communication sta-
tus.

The status bar.

Simulation status
Stopped Simulation is not running (Grey)

Started Simulation has been started but is not running yet


(Grey)

Paused Simulation is running but has been paused (Yellow)

Running Simulation is running (flashing Grey/Green)

Communication status
Inactive Simulation is not running (Grey)

Active SImulation is running, but no software has connected


to the simulator yet (Yellow)

Connected Another software has connected to the simulator


(Green)

Disconnected Another software has disconnected from the simulator


(Yellow)

IQANsimulate User manual 158


10 Application
simulation

An IQAN system consists of one master module, various expansion modules


and an application file.
The application file consists of information about the system’s modules,
buses, addresses, inputs, outputs and internal channels – everything that plays
a role in controlling a machine.
IQANsimulate can use an application file to simulate a complete IQAN sys-
tem; master module and expansion modules. This gives you the opportunity
to have a virtual machine on your desktop.

IQANsimulate User manual 159


Modules, channels and functions
10 Application simulation

Modules, channels and functions


An application file contains information about the system’s modules, buses,
addresses, external channels (physical inputs and outputs) and so called
“internal channels”, that are handled and calculated by the master.

Modules
The type of master and expansion modules an application contains is decided
based on the functionality in the machine. The modules are designed with dif-
ferent mixes of inputs and outputs to suit different machine applications.
The master is the central unit in the system. All communication is routed
through the master. It also contains all non-module specific channels such as
PID regulators, counters and math channels. All calculations take place in the
master and there can only be one master in an IQAN system.
The master communicates with modules via CAN-buses (Controller Area
Network) either ICP (IQAN CAN Protocol), SAE J1939 or Generic CAN.
For further information about different module types see information in the
respective data sheets and instruction books.

Channels
A channel can either be an input, output or an internal channel. The internal
channels are not physical channels like the inputs and output. They are only
handled by the master internally.
All channels have different properties such as name, scaling, alarms, delays,
filter, etc. The properties are unique for each channel type. The internal
channels are used to create functionality. For example, if you want to control
the boom, count events, start a timer or control the speed on a diesel engine.
Most of the internal channels have both properties and one or many functions.
Input channel

Input channel Internal channel Internal channel Output channel

Properties Properties Properties


Functions
A simple illustration, how the channels can influence on each other.

IQANsimulate User manual 160


Simulation
10 Application simulation

Simulation
In IQANsimulate you can simulate all input channels and the status of current
outputs and all modules in an application. Input channels are simulated with
the help of sliders in the function group view or in simulation groups. Current
outputs are simulated using a popup menu in the function group or module
view. Module status can be set in the system overview form.
Add simulation groups with input channels to make it easy to simulate input
values to your application, such as temperatures, pressures and speeds. A
simulation group consists of one or more channels. For each channel there is
a slider and an edit box that will let you control the channel’s value.
With simulation groups you can group your channels anyway you like. A
simulation group can contain as many channels as you like, and there is no
limit of how many groups you can add.
While simulating input values you can measure all channel and object values.
You can also check your graphical user interface and simulate user inter-
activity on the master display, if available.

Simulation files
A simulation contains an application, simulation groups and channel values.
To open a file, click Open in the main tool bar or File menu. The shortcut key
is <Ctrl+O>. Select the file you like and click Open. Simulation files have the
extension isa.
If the file is protected by a password you will be asked to enter the correct
password to open it. Application passwords can be stored in your password
database. By doing that, IQANsimulate will automatically enter the correct
password when you open the file. See section Password database on page
189 for more information.

Enter application password dialog box.

You can also open application files (extension ida). This will create a simula-
tion file without any simulation groups, unless the application file is old and
contains simulation groups. You will then be given the option to import the
simulation groups.

IQANsimulate User manual 161


Application manager
10 Application simulation

Application manager
The Application Manager is the tree view on the left side of the main panel. It
contains four root nodes:
• Simulation groups
• Application
• Channels
• Modules
Each root node displays different information for the currently opened simu-
lation file. Depending on how a file is protected, all nodes may not be visible.
For detailed information on each root node, see the following chapters.

Application manager.

IQANsimulate User manual 162


Property inspector
10 Application simulation

Property inspector
To the right of the main panel you will find the Property Inspector. The
inspector window can be hidden by clicking the dotted splitter at its left edge.
Resize the inspector by dragging the splitter instead of clicking it. The prop-
erty inspector displays detailed information about the currently selected com-
ponent. Each component has a number of properties that defines its behavior.
A property has a name and a value. The name is listed in the left column of
the property inspector and the value in the right column. At the bottom of the
property inspector there is a hint window that will help you with a detailed
explanation of the currently selected component or property. To select a prop-
erty, click its name in the property inspector.

Property inspector.

To change any property of a selected component, simply click on it in the


property inspector.
The highlighted property will have either an edit box where you enter text or
value, or a drop down box from which to make a selection. Some properties
use a combination of these, a drop down box where you also can enter text or
values.

NOTE
Any text typed into a property edit box will not be applied until you press
<Enter> or <Tab>.

IQANsimulate User manual 163


Property inspector
10 Application simulation

Keyboard shortcuts
Use <Up> /<Down> or <Tab>/<Shift+Tab> to move between properties. Use
<Alt+Left> and <Alt+Right> to collapse and expand group properties. When
focus is on the property name, type the first letter in a property name to select
that property. Move focus from property name to property value and vice
versa by pressing <Ctrl+Tab>.

Changing a property on multiple components


It is possible to change a common property on several components at once.
Select the components in the editor. When multiple components are selected,
the property inspector will show only the properties that are shared by all the
selected components, for example Name or Description.
If a property has different values on the selected components, its value will be
Indeterminate in the property inspector. If all the selected components has the
same property value, its shared value will be presented in the property inspec-
tor.
Select the property you want to change. Enter or select a new value. The
property is updated on all the selected components.

Go to component
Properties that have a component as their value offers a shortcut if you would
like to look closer on that component. Right-click on the property name and
select Go to component in the popup menu. The property component will be
selected in the main panel and its properties will be displayed in the property
inspector.

IQANsimulate User manual 164


Simulation groups
10 Application simulation

Simulation groups
Simulation groups are containers for simulation items. A simulation item is
basically a simulation control for an input channel. You can add as many sim-
ulation groups and items as you like.
Use simulation groups and items to organize your simulation controls in a
structured and logical way. The node Simulation groups in the application
manager can be used to access all simulation controls in a simulation file.

Simulation groups
To create a simulation group right click on Simulation groups in the applica-
tion manager and select Add Simulation Group in the popup menu, or select
Application > Add > Add Simulation Group. Enter a name for the new simu-
lation group in the property inspector. To add channels to the simulation
group, simply drag and drop the channels from the editor to your simulator
group. For each channel you add, a simulation item is created.

Simulation items
A simulation item controls a channel value, either through another channel’s
value or through manual control in the form of a slider and an edit box.

Some simulation items in a simulation group.

Manual control
When simulating, if it uses manual control, the selected simulation item will
have a slider and an edit box that enables you to specify the input value for
the channel that the simulation item controls. The value can be scaled or raw.
Scaled value gets its unit by the channel properties. Typical units for scaled
value are; %, °C and bar.
Raw value on the other hand depends on the channel type. Voltage inputs use
mV, and frequency inputs use Hz as raw value. By using raw value, you can
control the full range of the input, and thereby generate input errors by setting
an input value outside the valid range for the channel. Scaled value input is
limited to the channel’s valid range.
Enable raw value input by selecting Simulate > Raw Value Range. This set-
ting can also be accessed in the main tool bar or by right-clicking in the main
panel for simulation groups.
IQANsimulate User manual 165
Simulation groups
10 Application simulation

Drag the slider or enter a value in the edit box to set an input value for a chan-
nel. When the slider is focused, you can use the keyboard to control it.
<Ctrl+Left> and <Ctrl+Right> moves it in small steps and <PgUp>/<PgDn>
in larger steps. Pressing <Space> will move the slider to its maximum posi-
tion (max scaled value) and then back to zero when released. <Shift+Space>
does the same but in negative direction when applicable. This is useful to
simulate a full stroke for a lever for instance.
If you use the edit box to set the input value, press <Enter> when you are fin-
ished typing the input value to set it.

Automatic control
When controlling the value automatically, a second channel is connected to
the simulation item. The value of that channel controls the value of the
simulated channel. Typically, you use a math channel for this.
EXAMPLE
To simulate a crane function, for example the boom, use a math channel to
do some calculations based on the current output controlling the boom.
The math channel calculates the boom position. The simulated channel is
the voltage input for the boom position sensor. Now you can do closed
loop simulation of the boom.

The track bar and the edit box are disabled when a simulation item uses a
control channel. Select Manual control to control the simulation item
manually using the track bar or the edit box.

Properties

Simulate channel The channel that this simulation item simulates.

Control channel Select a channel to control the value of the simulate


channel. To manually control the value using the track
bar, select "Manual control".

Input type Select a value type for the control channel, "Raw
value" or "Scaled value".
Available if "Control channel" is a channel.

Spring back Select "Yes" to have the simulation track bar return to
neutral position when releasing handle.
Available if "Control channel" is "Manual control".

Edit simulation items


To add a simulation item, drag a channel from any other view and drop it on a
simulation group in the application manager. Drag and drop is also used to
copy an item from one group to another.
IQANsimulate User manual 166
Simulation groups
10 Application simulation

By default the simulation item will get the same name as the channel it con-
trols. Rename it in the property inspector.
Simulation items are deleted by selecting one or more in the main panel and
clicking Delete in the main tool bar or Edit menu. Keyboard shortcut is
<Ctrl+Del>.

Options
There are some options that control the user interface for simulation groups.

Simulation group options.

Show hints Displays tool-tip hints when hovering over channels


and function groups.

Show references Draws lines between simulation item s that reference


each other.

Show grid Displays a grid in the background.

Grid size, X and Y Number of pixels between each grid pixel.

Grid color Color of grid pixels.

IQANsimulate User manual 167


Application
10 Application simulation

Application
This node is used to view structure and flow of an application. Under this
node, function group nodes are added. Click any of the nodes to view the con-
tents of its function group in the main panel.

NOTE
You may not be able to see the Application node. Some applications require a
certain access level to allow viewing of the application structure. You can get
the correct access level by requesting a safe password with sufficient access
level for application viewing from the IQAN administrator at the OEM. See
section Safe passwords on page 192 for more information.

Function groups
A function group contains channels and/or other function groups. The rela-
tions between them are illustrated with curved lines. Click one of the chan-
nels or function groups to get more information about it.

Application view.

Some function groups may be password protected. This is indicated by a


small lock icon at the top right corner of the function group control. The lock
icon may be locked or unlocked depending on whether you are allowed to
view its contents or not.

IQANsimulate User manual 168


Application
10 Application simulation

Locked function group Transmission function.

Password protected function groups must be unlocked to be viewed. To view


its contents, right click on it and select Unlock. A password dialog box is dis-
played. Enter the correct password and click OK. The lock icon should now
be unlocked and you can view the function group.

Enter function group password dialog box.

Function group passwords can also be stored in your password database. By


doing that, IQANrun will automatically unlock the function group when you
open the application. See section Password database on page 189 for more
information.

Simulate
You can simulate the value of input channels, adjustable channels and stored
channels. Status can be simulated for current outputs, parameter group inputs
and generic frame inputs.

Input channels
Input channel types that can be simulated are voltage input, digital inputs, fre-
quency inputs, directional frequency inputs, directional analog channels,
parameter inputs and SPN channels.
IQANsimulate User manual 169
Application
10 Application simulation

When a simulation is running, the selected input channel will have a slider
that you can use to simulate its input value. Drag the slider to change the
input value. Press <Ctrl+Left> and <Ctrl+Right> to change the value in small
steps using the keyboard. <PgUp>/<PgDn> changes it in larger steps.

Slider control on selected input channel.

By default, it is the scaled value that is simulated. If you want to simulate raw
value instead, select Simulate > Raw Value Range. Now you can simulate
input errors by moving the slider beyond scaled min or max. The measured
value is still scaled though.

Adjustable and stored channels


Adjustable and stored channel types that can be simulated are function
parameters, text parameters, event counters, memorizing channels and timers.
Select a channel and right-click on it. Select menu item Set Value. A dialog
box is displayed.

Set Value dialog box.

IQANsimulate User manual 170


Application
10 Application simulation

Enter the value you want to set this channel to and click OK.

Channel status
Select a channel of type current output, parameter group input or generic
frame input and right-click on it. Select a status in the sub-menu under Set
Status.

NOTE
Current outputs that have been set to status overload or open load can only be
reset to OK by its command value dropping to zero, just as it would be in a
real master module.

Measure
Channel values and status will be measured when you are running a simula-
tion. Value and status are measured in real-time.

Property inspector
The property inspector can be displayed to show properties for the selected
component in the function group view. All property values are read-only,
since you aren’t allowed to change the application in IQANsimulate. Use
IQANdesign if you need to do that.
To show the property inspector, click on the dotted splitter on the right edge
of the main panel, or select View > Property Inspector.

Options
There are some options that control the user interface for function groups.

IQANsimulate User manual 171


Application
10 Application simulation

Function group options.

Show hints Displays tool-tip hints when hovering over channels


and function groups.

Show grid Displays a grid in the background.

Grid size, X and Y Number of pixels between each grid pixel.

Grid color Color of grid pixels.

Draw reference lines Specifies how reference lines between components are
drawn.

Reference line colors Color of reference lines.

IQANsimulate User manual 172


Application
10 Application simulation

Value type colors Channels can be colored differently depending on


which value type they have.

Check status colors Channels can be colored differently depending on their


application check status.

For more information about applications, function groups, channels, func-


tions and objects, see IQANdesign User Manual.

IQANsimulate User manual 173


Channels
10 Application simulation

Channels
This node lists all channels in an application.

NOTE
You may not be able to see the Channels node. Some applications require a
certain access level to allow viewing of channels. You can get the correct
access level by requesting a safe password with sufficient access level for
application viewing from the IQAN administrator at the OEM. See section
Safe passwords on page 192 for more information.

Channel list view


Select the node Channels to view all channels in the current application.
Under the Channels node, a separate node for each channel type available in
the current application is created. This makes it easy to view for instance all
digital inputs in an application. Just click the node Digital in under Channels
to view only digital inputs in the list view.

Channel list view.

The main panel contains a list view where channels are listed. The list has
seven columns. The list can be sorted in different ways by clicking the col-
umn header that you want to sort by. If you click the same header once more,
the sort order is reversed, form ascending to descending or vice versa.

IQANsimulate User manual 174


Channels
10 Application simulation

Name Channel name.

Order Calculation order. Channels with lower calculation


order are calculated before channels with higher
calculation order.

Type Channel type.

Module Which module the channel is assigned to.

Function group Which function group the channel belongs to.

Value Channel value.

Status Channel status.

You can quickly jump to a channel in the function group view to see its rela-
tions with other channels. Select the channel in the channel list and right-click
on it. In the popup menu, select Go To Channel. Focus is redirected to the
function group to which this channel belongs and the channel is selected. You
can also double-click on a channel in the channel list to perform the same
operation.

Simulate
It is not possible to control the input values from this view.

Measure
Channel values and status will be measured when you are running a simula-
tion. Value and status are measured in real-time.

Property inspector
The property inspector can be displayed to show properties for the selected
channel in the list view. All property values are read-only, since you aren’t
allowed to change the application in IQANsimulate. Use IQANdesign if you
need to do that.

IQANsimulate User manual 175


Modules
10 Application simulation

Modules
The Modules node is used to view modules, CAN buses and channel connec-
tions.

System overview
Select the node Modules to view the system overview. It will show all mod-
ules and CAN buses in the current application in a tree view. The tree view
structure represents how the modules are connected to each other via CAN
buses.

System overview.

Each module and CAN bus has its own symbol and name in the tree view.
Select a module or CAN bus to get detailed information about it in the prop-
erty inspector.

Block diagram
Under the Modules node there is one node per module in the current applica-
tion. Select a module node to view its block diagram. The block diagram
view displays all channels and their connections for the selected module.
Channels are displayed with name and index. If you hover with the mouse
over a channel index, its pin number is displayed in a small tool-tip window.

IQANsimulate User manual 176


Modules
10 Application simulation

Joystick block diagram.

You can quickly jump to a channel in the function group view to see its rela-
tions with other channels. Select the channel in the block diagram and right-
click on it. In the popup menu, select Go To Channel. Focus is redirected to
the function group to which this channel belongs and the channel is selected.

Pin list
In the module block diagram view there is a second tab called Pin List. This
tab contains a list of all pins on the current module. The list has three col-
umns.

Pin Connector and pin number.

Description A short description of what this pin is used for.

Channel Name of the channel connected to this pin.

Simulate
While simulating, you can set module status by selecting a status in the drop
down list next to each module in the system overview. There are a lot of dif-
ferent status values to choose from, such as OK, High temperature, Low sup-
ply voltage or No contact. Each module type has its own unique set ot status
values.

IQANsimulate User manual 177


Modules
10 Application simulation

Set module status.

Input channel values can be simulated by using the sliders on the channel
controls in the block diagram. Raw value simulation can be used in the same
way as for the function group view.

Measure
Channel value and status is measured in real-time when a simulation is run-
ning.

Property inspector
The property inspector can be displayed to show properties for the selected
component. All property values are read-only, since you aren’t allowed to
change the application in IQANsimulate. Use IQANdesign if you need to do
that.

IQANsimulate User manual 178


11 Simulators

The simulator is a very useful tool that helps to assure the functionality of
your application before you download the file to the master. It is also very
easy to check a function if you are unsure of its behavior.
Another benefit is that if your application contains a display module you
don’t have to download your application file to check your display pages, dis-
play controls or menu system. The application file will appear exactly the
same way in the simulator as in the real master module. Use the mouse to
click on the display buttons or to turn the jog shuttle.

IQANsimulate User manual 179


Simulator
11 Simulators

Simulator
Every master module has its own simulator. The simulator uses the same soft-
ware as the real master module. In addition to the master module software it
contains some extra features, such as expansion module simulation and SMS
simulation.
It will simulate all internal functions such as I/O handling, math calculations,
logs, communication and settings. If the master module has a display it will
also simulate the graphical presentation of display pages and receive input in
the form of button clicks.
IQANsimulate will automatically select the correct simulator type and ver-
sion depending on which simulation or application you use. To start the simu-
lator select Simulate > Run, or press <F9>. Before the simulator starts to run,
the application file will be checked for errors. You will be notified about the
status if there are any errors. If there are no errors, the current application will
start to run in the simulator.
The simulation file will be saved before the simulation starts. The save is
automatic unless you have disabled that option in the IQANsimulate options
dialog box.
If the correct simulator type and/or version that you are trying to start is not
installed on your computer, you will be asked if you would like to download
it from Parker’s web site. Click Yes to download it. When it has been down-
loaded, IQANsimulate will install it for you and then start the simulation.

Missing simulator message.

To stop the simulator, select Simulate > Stop, or press <Esc>.

IQANsimulate User manual 180


Simulator display
11 Simulators

Simulator display
If your application contains a display module, for example IQAN-MD3, an
image of the display will appear on the screen when you are simulating. This
image is interactive, which means you can use the display buttons by clicking
on them with the mouse.
For applications without a display module, an image of the master module is
shown instead. If it has LED’s to display module status, the simulator will
simulate the behavior of these as well.

IQAN-MC2 simulator.

The simulator window can be placed anywhere on the screen. It is always on


top of the main window.

IQAN-MD3 simulator showing main display page.

To get a screenshot of the simulator, press <F12>. A save file dialog is dis-
played, asking you where to save the screenshot. It is saved in plain bitmap
(bmp) format.
If you don’t want to see the simulator while simulating, it can be turned off.
Deselect option Show simulator window on tab Appearance in the options
IQANsimulate User manual 181
Simulator display
11 Simulators

dialog box. This option can also be reached by selecting Simulate > Show
Simulator or clicking the Show Simulator button in the main tool bar. Short-
cut key is <Shift+F12>.

Keyboard shortcuts
You can use the keyboard to control the simulator buttons if you like.

Key MDL/MDL2 MD3

Ctrl+<F1-F5> Buttons F1-F5 Buttons F1-F4 (F5 not


available)

Ctrl+<F6-F9> Buttons A-D not available

Ctrl+<Home> Menu button Menu button

Ctrl+<Page Up> Jog-shuttle clockwise Button Up

Ctrl+<Page Down> Jog-shuttle counter- Button Down


clockwise

Ctrl+<Enter> Jog-shuttle clicked Button OK

Ctrl+<Backspace> Escape button Escape button

Simulate menu system and display pages


The menu system, display pages and display controls will behave the same
way in the simulator as in the real master module display. You will for exam-
ple find the menu system if you click on the menu button on the display dur-
ing simulation.
Use the mouse cursor to click on the display buttons.

NOTE
The simulator uses the PC clock for date and time. You can adjust it via the
simulator menu system or IQANrun, but it will be reset to the PC clock set-
tings again.

Displays with jog shuttle


Some displays have a jog shuttle as input device. To click the jog shuttle you
need to click within the inner circle.
To turn the jog shuttle with the mouse cursor, just select the outer circle of the
knob and move the cursor up and down or side to side. You don’t need to fol-
low the knob around its circumference or attempt to mimic a turning motion.

Message boxes
Popup message boxes are also simulated, see image below.

IQANsimulate User manual 182


Simulator display
11 Simulators

IQAN-MDL simulator showing an error message.

IQANsimulate User manual 183


During simulation
11 Simulators

During simulation
In IQANsimulate, a track bar (slider) is added to all input channels to control
the channel values during simulation. The track bar is only visible when the
channel or its simulation item is selected. You control the value of the input
channel by moving the slider sideways using your mouse or the keyboard.
See table below for keyboard shortcuts.

Keyboard shortcuts

<Ctrl+Left arrow> Value is decreased by 1% of complete range. Digital


<Ctrl+Down arrow> channels are set to False.

<Ctrl+Right arrow> Value is increased by 1% of complete range. Digital


<Ctrl+Up arrow> channels are set to True.

<Page Down> Value is decreased by 10% of complete range. Digital


channels are set to False.

<Page Up> Value is increased by 10% of complete range. Digital


channels are set to True.

<Home> Value is set to its minimum.

<End> Value is set to its maximum.

<Space> Value is set to its (scaled) maximum on key down and


reset to zero on key up.

<Shift+Space> Value is set to its (scaled) minimum on key down and


reset to zero on key up.

All channels in the application will show the actual channel status and the
actual channel value. If you hover the mouse cursor over the channel you will
see the complete status message.

Pausing simulation
It is possible to halt the simulation temporarily by selecting Simulate >
Pause. Start simulation again by selecting Simulate > Run again.

One sample step


While paused, it is possible to execute only one sample by selecting Simulate
> Step. Very useful if you want to change some input values and then execute
one sample to see the calculated results.
You can also start your simulation by using Simulate > Step. This will start
the simulator and immediately pause it, so you can study the start-up
sequence in detail.

IQANsimulate User manual 184


During simulation
11 Simulators

Application update
If the application is updated from an external source, for example IQANrun,
while the simulator is running, IQANsimulate will open the new application
and restart the simulator. When opening the new application, IQANsimulate
will try to preserve any simulation groups and items. If there are any unsaved
changes in the currently open file, you will be asked whether you want to
save those changes or not before the new application is loaded.

IQANsimulate User manual 185


IQANdesign synchronization
11 Simulators

IQANdesign synchronization
IQANdesign and IQANsimulate both have features that allow you to control
a simulation from either user interface.

IQANdesign controlling IQANsimulate


IQANsimulate can be controlled remotely by IQANdesign. The Start, Stop,
Pause and Step functions are available in IQANdesign main menu and main
tool bar. Input values can be controlled from IQANdesign with the help of
sliders in IQANdesign’s function group view.
When starting a simulation from IQANdesign, it will first start IQANsimulate
if it is not already running, then send the application file currently opened in
IQANdesign to IQANsimulate. If IQANsimulate does not have any simula-
tion file opened, it will start simulating immediately using the application file
sent by IQANdesign.
If a simulation file is already opened, IQANsimulate will first check if the
simulation file matches the id of the application sent from IQANdesign. If
not, you have to decide if you want to open another simulation file or create a
new empty file.

Application mismatch warning.

After making sure the application matches the simulation file, IQANsimulate
will update the simulation file with the new application and then start the sim-
ulation.

IQANsimulate controlling IQANdesign


When controlling the simulator from IQANsimulate, IQANdesign is synchro-
nized so its simulate menu items and tool bar buttons are enabled/disabled
accordingly. This synchronization will only work if the simulation was
started from IQANdesign.

IQANsimulate User manual 186


Window size
11 Simulators

Window size
IQANsimulate can be used with a limited user interface to save up some
screen real estate. This can be useful when running multiple programs during
simulation.
Let IQANsimulate switch to a separate window size automatically when
starting a simulation by enabling the option Use different window size when
simulating on the Appearance tab in the options dialog box.
When using this option, the property inspector is hidden and some buttons on
the tool bar will be removed during simulation. Change window size and
position to what you like. When simulation is stopped, window size, position,
menu bar and property inspector are restored. From now on IQANsimulate
will switch between these two window states every time you start or stop a
simulation.

IQANsimulate with smaller window during simulation.

IQANsimulate User manual 187


12 Safe passwords

Files and components can be protected by a password to prevent unautho-


rized personnel to access sensitive application or machine data. When you
open a protected file or component, IQANsimulate will ask for its password.
There is a safe and easy function to handle passwords in IQANsimulate. By
adding a password to IQANsimulate’s password database you don’t need to
enter it each time you open a protected file or component. In fact, you don’t
even need to know what the password is.
IQANsimulate uses something called safe passwords to achieve this. Safe
passwords are encrypted which means they can be sent safely via for example
email. The encryption also ensures that the end user can not read the actual
password.
Safe password encryption is done with the help of a public key. The public
key ties the safe password to a specific user and computer, which means no
one else than the password requester can use the safe password. Every IQAN-
simulate user has its own unique public key.

IQANsimulate User manual 188


Password database
12 Safe passwords

Password database
The password database stores one or many passwords on your computer.
Only you will have access to the passwords. If someone else logs in to the
same computer, they will get their own password database. Passwords stored
in the database can not be copied or moved to another user or computer.
There is a password manager that lets you manage your passwords. Start the
password manager by selecting Tools > Password Manager.

Password manager.

In the password manager you can see your public key and a list of all your
passwords. The password list has three columns. You can sort the list by
clicking the different column headers.

Name The name of the application that this password is


connected to.

Type Password type. There are three types available in


IQANsimulate; Full access password, Limited access
password and Component password.

IQANsimulate User manual 189


Password database
12 Safe passwords

Comment Additional password details.

Id The id of the application that this password is


connected to.

Password types
There are four password types available; Full access password, Limited
access password, Component password and Login.

Full access password


Full access passwords are actually meant to be used when opening a pro-
tected application file for editing in IQANdesign. It can however be used in
IQANsimulate to open a protected application file. You will not be granted
editing access though, only viewing.
A full access password works in the same way as a limited access password,
except it will always allow viewing and provide the highest access level
available. See next section for more details.

Limited access password


Limited access passwords are used when opening a protected file with the
same id as the limited access password. There can only be one limited access
password per id in the database. If you add the same password again, the old
one will be replaced.
Comment shows details for the password, such as viewing access and access
level id connected to this password. Viewing allowed for an application file
means that you have access to the Application and Channels nodes in the sim-
ulation navigation tree view. The Modules node is always available.
The access level id decides which components you are allowed to see.

Component password
Used to unlock protected components, such as function groups, in files with
the same id as the component password. The component id is shown in com-
ments. See section Function groups on page 168 for more information on
locked components.

Login
Not used in IQANsimulate.

Date restrictions
Passwords can be date restricted, which means they will only be valid until a
certain date. The date is displayed in the comment for date restricted pass-
words. When the valid date has been passed, the password will no longer
work.

IQANsimulate User manual 190


Password database
12 Safe passwords

ATTENTION
Please don’t try to change the clock in your PC to get around a date restric-
tion. The password manager will detect such attempts and lock the password
completely if necessary.

IQANsimulate User manual 191


Add password
12 Safe passwords

Add password
Whenever you enter a password for a protected file or component, you will be
asked whether you want to add the password to your database. Click Yes to
store the password.
The password is stored and will be used automatically when IQANsimulate
detects the need for it next time.

Add password question.

If you click No, the password is added to the database anyway but only tem-
porary. Temporary passwords remain in the database as long as IQANsimu-
late is running. This means that if you open a file with the same id and
password during the same IQANsimulate session, you don’t have to enter the
password again. When you exit IQANsimulate, all temporary passwords are
removed. The text (Temporary) is added to the comment for temporary pass-
words.
If you don’t see the dialog Add password, you probably turned it off by
selecting the check box Never show this again. To get it back, go to Tools >
Options and select tab Show again. Select the check box next to Add pass-
word in the list and click OK.

Safe passwords
To add a safe password to the database, you must first receive it from your
password administrator. You do that by sending the administrator a message,
for instance by email, with your public key and a request for the password
you need.
The public key can be found above the password list in the password manager
dialog. There are also two buttons available. Click Send as Mail to create a
new message in your email software with the public key in it. Add the email
address for the administrator and a request for a password in the message, and
then send it. To enter the public key in some other software, click Copy to
copy it to Windows clipboard and then paste it where you like.
When your request has been granted, you will receive a safe password in
return. The safe password is just a long string of characters. To add it to your

IQANsimulate User manual 192


Add password
12 Safe passwords

password database, click on the Add Safe button. Enter the password in the
dialog box that appears and click OK.

Add safe password dialog box.

The safe password is added to your password database and appears in the
password list. Check the password list to verify that you received the correct
password with the access you need.

IQANsimulate User manual 193


Delete password
12 Safe passwords

Delete password
Select a password in the password list and click Delete to delete it from the
database. A confirmation dialog box is shown asking you to confirm the dele-
tion. Click Yes to delete the password.

Delete password confirmation.

Click Delete all to empty the database completely.

IQANsimulate User manual 194

You might also like