Sei sulla pagina 1di 193

IQAN Active Studio

Version 3.19

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 3.19
1 Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Software installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
New installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Upgrading from version 1.x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
USB driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Hardware installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Installation procedure - Windows XP . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Installation procedure - Windows Vista . . . . . . . . . . . . . . . . . . . . . . . . . 15

IQANrun
2 User interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Main window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Menu system . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Communication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Appearance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Show again . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Other . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Main tool bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
System diagnostics tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Toolbox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Project view tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Status bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Keyboard shortcuts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
3 System Diagnostics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
System information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Module info . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Machine Id . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

IQAN Active Studio User manual 4


Contents

Date and Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41


Language . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Modem (RS232) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Modem (CAN) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Add record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Clear log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Backup log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
View log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Measure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Measure groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Graph . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Adjust . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Select adjust group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
PIN code protection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Adjust items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Adjust item . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Open Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Continue Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Get operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Get and View Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Get clone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Get settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Send operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Send Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Send clone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Send settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
Send operations summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Login . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Logout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
4 Project View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Project View tab operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
Open . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
Get and View button . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
Get project link . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
Get Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
Get Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
View tab tree view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
System overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
Block diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
Pin list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

IQAN Active Studio User manual 5


Contents

Property inspector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Measure channels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Print . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Functionality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Property inspector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Function inspector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Measure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
Print . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Channels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
Property inspector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Function inspector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Print . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Log items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Log records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Save . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
Print . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
Tree list view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
Compare settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
Print . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
Clone file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
5 Archives . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Archive contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
Multiple archives . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
Install archive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
Select archive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
Delete archive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
Check for updates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
6 Scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
Run script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
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
Ethernet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
Simulator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131

IQAN Active Studio User manual 6


Contents

Modem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
Internet settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
Quick switch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
Remote diagnostics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
Connect via Internet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
Connect via modem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
Disconnect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
Phone book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
Add . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
Edit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
Delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
Export . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
Import . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
8 Safe passwords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
Password database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
Password types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
Date restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
Add password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
Safe passwords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
Delete password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144

IQANsimulate
9 User interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
Main window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
Menu system . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
Edit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
Simulate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
Appearance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
Show again . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
Other . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
Main tool bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
Status bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
Simulation status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
Communication status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
10 Project simulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
Modules, channels and functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
Modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
Channels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158

IQAN Active Studio User manual 7


Contents

Simulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
Simulation files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
Project manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
Property inspector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
Keyboard shortcuts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
Changing a property on multiple components . . . . . . . . . . . . . . . . . 162
Go to component . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
Simulation groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
Simulation groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
Simulation items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
Edit simulation items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
System overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
Block diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
Pin list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
Simulate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
Measure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
Property inspector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
Functionality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
Function groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
Simulate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
Measure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
Property inspector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
Channels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
Channel list view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
Simulate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
Measure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
Property inspector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
11 Simulators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
Simulator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
Simulator display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
Simulate menu system and display pages . . . . . . . . . . . . . . . . . . . . . 181
During simulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
IQANdesign synchronization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185
IQANdesign controlling IQANsimulate . . . . . . . . . . . . . . . . . . . . . . . . . 185
IQANsimulate controlling IQANdesign . . . . . . . . . . . . . . . . . . . . . . . . . 185
Window size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186
12 Safe passwords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
Password database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188
Password types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
Date restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
Add password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191

IQAN Active Studio User manual 8


Contents

Safe passwords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191


Delete password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193

IQAN Active Studio User manual 9


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 10


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 11


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 12


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 13


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 14
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 15


Hardware installation
1 Installation

Device driver software installed successfully.

IQAN Active Studio User manual 16


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 18


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 19


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

.ida3 Project file

.ids3 Stripped project file

.iss3 Script

.ica3 Archive

.irc3 Clone (applications, settings and optionally logs)

.irf3 Full log (requires the corresponding project to be


opened first)

.irl3 Log records (can be viewed in IQANrun without


having access to the corresponding project)

.irm3 Measure data

.irs3 Settings (binary format, requires the corresponding


project 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

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

.irm3 Measure data.

.xlsx Microsoft Excel format. Logs and measured graphs can


be stored in Excel format.

IQANrun User manual 20


Menu system
2 User interface

.xls Microsoft Excel 97-2003 format. Logs and measured


graphs can be stored in Excel format.

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


script reports.

.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 project 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 107.

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 21


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 26.

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

IQANrun User manual 22


Menu system
2 User interface

Login
Logs in to the connected system to get access to protected components and
operations. See section Login on page 78.

Logout
Logs out from the connected system. See section Logout on page 80.

Set machine Id
Sets the machine id in the connected system. See section Machine Id on page
39.

Set Date and Time


Sets date and time in the connected system. See section Date and Time on
page 41.

Select Language
Selects language in the connected system. See section Language on page 42.

Configure CAN modem


Configures a IQAN CAN modem. See section Modem (CAN) on page 44.

Configure RS232 modem


Configures parameters for an RS232 modem connected to the IQAN master
module. See section Modem (RS232) on page 43.

Get > Get Clone...


Gets a clone from the connected system. See section Send clone on page 75.

Get > Get Settings...


Gets a clone from the connected system. See section Send settings on page
76.

Send > Send project...


Sends a project file to the connected system. See section Send Project on
page 73.

Send > Send Clone...


Sends a clone file to the connected system. See section Send clone on page
75.

Send > Send Settings...


Sends a settings file to the connected system. See section Send settings on
page 76.

IQANrun User manual 23


Menu system
2 User interface

Compare settings
Compares the current settings in the project view with the settings from a set-
tings file. See section Compare settings on page 103.

Communication
For information, see section Communication on page 128.

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 113.
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.

IQANrun User manual 24


Menu system
2 User interface

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.

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 25


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.

IQANrun User manual 26


Options
2 User interface

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

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 60.

Settings viewer
See section Settings on page 102 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.

IQANrun User manual 27


Options
2 User interface

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 28


Options
2 User interface

Other
The tab Other collects some other options in IQANrun.

Other options.

File associations
Lets you associate IQANrun with project, script and/or archive files. If a but-
ton is disabled, IQANrun is already associated with that file type. Associating
IQANrun with a file type means that if you double-click such a file in Win-
dows Explorer for instance, IQANrun will start and open that file.

NOTE
Changing file associations on Windows Vista or later requires administrator
privileges.

IQANrun User manual 29


Options
2 User interface

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 Scripts on page 68 for more information.

Languages
Select your preferred language when working with master modules online or
when viewing files. You can select a primary and a secondary 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 display-
ing component names, such as measure groups or logs.
If none of these languages are available, the default language in the current
file or system 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 42.

Show send language options dialog


The option Show send language options dialog is explained in section Send
Project on page 73.

IQANrun User manual 30


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 19).

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.

Login Logs in to the IQAN system to get access to protected


components and operations. When logged in the
current user is shown here.

IQANrun User manual 31


System diagnostics tab
2 User interface

System diagnostics tab


The System Diagnostics tab contains operations that require a connection to a
master module to be performed. This tab contains a number of buttons
arranged in a toolbox to the left and the main panel that is changed depending
on the selected tool.

Toolbox
The toolbox contains buttons for all operations IQANrun
can perform on a connected IQAN system.

System System information, diagnostics and


settings.

Logs View logs

Measure View measure groups

Adjust View adjust groups

Scripts Run or continue a script

Get Get a project, clone or settings from the


system.

Send Send a project, clone or settings to the


system.

IQANrun User manual 32


Project view tab
2 User interface

Project view tab


The Project View tab contains a tree view where you can
navigate to view different things such as applications, logs
and/or settings. For this tree view to be visible a project file
must be opened or retrieved from the system. If no project
file is open two buttons will be shown instead.

Project view buttons

A number of additional tools is available as links once a


project file has been opened.

Tools

Open button Opens a project file

Get and View Get and view project from IQAN


button system.

Get project link Same as Get and View button. Available


when selecting the system node.

Get Log link Get and view the complete selected log
from master module. Available when
selecting a log.

Get Settings link Get and view settings from master


module. Available when selecting the
settings node.

IQANrun User manual 33


Status bar
2 User interface

Status bar
The status bar displays project name with machine id (when applicable), cur-
rent 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 34


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+D System Diagnostics tab

Alt+S System

Alt+L Logs

Alt+M Measure

Alt+A Adjust

Alt+P Scripts

Shift+F11 Get and View Project

Shift+Ctrl+F11 Get Clone

Shift+F12 Get Settings

F11 Send Project

Ctrl+F11 Send Clone

F12 Send Settings

Alt+W Project View tab

Shift+F8 Get Log

Shift+Ctrl+F12 Get Settings

IQANrun User manual 35


Keyboard shortcuts
2 User interface

Alt+N Login

Alt+O Logout

Alt+G Select Language

Ctrl+F12 Compare Settings

IQANrun User manual 36


3 System
Diagnostics

This section describes the operations on the System Diagnostics tab. All oper-
ations on the system diagnostics tab usually requires a connected master
module to function.

IQANrun User manual 37


System
3 System Diagnostics

System
Click System on the toolbox or press <Alt+S> to show an overview of all the
modules in the system and their status.

Module list with system information selected.

To the left a number of buttons is shown. The topmost button represents sys-
tem information followed by one button for each module in the system. The
number of errors on a module is indicated on the corresponding button. The
view is continuously updated so any new errors will immediately be visible.
The system overview function is very useful to quickly spot any problems in
a machine.

System information
The system information includes information such as project name and ver-
sion and machine id. There may also be project specific information.
For systems with more than one master module IQANrun checks the system
integrity by making sure that the correct master modules are present and that
they are using compatible applications. If more than one error is found during
this check the system integrity is shown as Error with further details as a hint
when pointing at the error.

Module info
By selecting a module further information is shown about that module. This
includes for example module type and address as well as production data.

IQANrun User manual 38


System
3 System Diagnostics

Any active faults are listed together with measured value and status of the
corresponding channels. If a fault disappears the channel is still measured,
but the status will change to OK.

Module information.

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

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

Machine Id
The system information contains a link to change the machine id in the con-
nected system. This operation is also available in the menu Tools > Set
Machine Id.
Changing the machine id should only be done once in a machine’s life time,
typically in production. The machine id is a text of up to 25 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.
Logs, measures, settings and clone files are marked with the actual machine
id to make it possible for you to later identify which machine they belong to/
originate from. The machine id is also used to identify a machine when con-
necting to it remotely.

IQANrun User manual 39


System
3 System Diagnostics

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 systems 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
sufficient access rights and try again. See section Login on page 78 for more
information.

IQANrun User manual 40


System
3 System Diagnostics

Date and Time


Click the Set date and time link to set the real time clock in the connected
master module. You can also find this operation under the Tools menu.

Set date and time form.

Select Current date and time from this PC to use your PC’s clock to set the
IQAN system 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 41


System
3 System Diagnostics

Date and time adjusted successfully.

Language
Use this link to select language in the connected master module. This opera-
tion is also available under the Tools menu.
A list with all available languages is displayed. The currently active language
is selected in the list.

Language list.

IQANrun User manual 42


System
3 System Diagnostics

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)
When an RS232 modem is selected in the system overview a configure link is
available next to the module name. The modem configuration is also avail-
able in the menu under Tools > Configure RS232 Modem.
Use the RS232 modem configuration 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 43


System
3 System Diagnostics

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.

Modem (CAN)
When a CAN modem is selected in the system overview a configure link is
available next to the module name. The CAN modem configuration is also
available in the menu under Tools > Configure CAN Modem.

IQANrun User manual 44


System
3 System Diagnostics

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.

Modem form for a CAN modem.

The Internet service provider settings can be retrieved 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
when connected outside the home network the cost of the data traffic is nor-

IQANrun User manual 45


System
3 System Diagnostics

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.

If you want to use SMS you need to specify the SMS service center. Contact
your service provider to get information about this setting.
Under Modem info you will see the current status of the connected CAN
modem such as network provider, signal strength and network status. It also
contains information if the modem is connected to the server or not. Click on
the button Test Server Connection to tell the modem to connect to the server.
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
diagnostics 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 46


Logs
3 System Diagnostics

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

Logs.

Click Logs on the toolbox or press <Alt+L> to see a list of all available logs
in the connected system. Some logs may be protected by a PIN code. Those
logs are marked with a small lock symbol. See also section PIN code protec-
tion on page 60.
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 78 for more information.
Each log shows a status indicating if it is full or not. If the log is full it can
either stop logging (Log full, stopped) or start overwrite the oldest records
(Log full, recycling).

Add record
Click Add Record to add some text to the selected system log. A dialog box is
presented. Enter the text you want to add in the system log and click OK. The
maximum number of characters is 250.

IQANrun User manual 47


Logs
3 System Diagnostics

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.

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 78 for more informa-
tion.

Insufficient access rights.

IQANrun User manual 48


Logs
3 System Diagnostics

Backup log
To get a complete log and save it as a file, select the log in the list and click
Backup 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 proj-
ect to be opened first. See section Logs on page 97 for more information.

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.

IQANrun User manual 49


Logs
3 System Diagnostics

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 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 five file formats available.

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


with IQANrun to view it later.

.xlsx Microsoft Excel format. Saves all fetched log records


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

.xls Microsoft Excel 97-2003 format. 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 UTF8-encoded
text file, which uses a semicolon 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.

IQANrun User manual 50


Logs
3 System Diagnostics

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 51


Measure
3 System Diagnostics

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 project file to do this operation, all information needed by IQANrun is
fetched from the connected IQAN system.
Start by clicking the Measure button on the toolbox or press <Alt+M>. A tree
view of measure groups and measure items.

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 a project to give you a better overview.
Expand a measure group to see all its measure items.
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-
cient access rights and try again. See section Login on page 78 for more infor-
mation.

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.
IQANrun User manual 52
Measure
3 System Diagnostics

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-
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>.
IQANrun User manual 53
Measure
3 System Diagnostics

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 three file formats available.

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


open it with IQANrun to view it later.

.xlsx Microsoft Excel format. Saves all measured values in


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

.xls Microsoft Excel 97-2003 format. 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 54


Measure
3 System Diagnostics

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.

IQANrun User manual 55


Measure
3 System Diagnostics

Line width 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.

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.

IQANrun User manual 56


Measure
3 System Diagnostics

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.

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.

IQANrun User manual 57


Measure
3 System Diagnostics

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
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.

IQANrun User manual 58


Measure
3 System Diagnostics

Measure item properties.

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 59


Adjust
3 System Diagnostics

Adjust
Use this button to adjust things such as inputs, outputs, function parameters,
etc. There is no need to open any project file to do this operation, all informa-
tion needed by IQANrun is fetched from the connected IQAN system.
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 a project 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 78 for more informa-
tion.

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.
IQANrun User manual 60
Adjust
3 System Diagnostics

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.

Adjust item list.

IQANrun User manual 61


Adjust
3 System Diagnostics

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.

Set default
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 78 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 from 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.

IQANrun User manual 62


Adjust
3 System Diagnostics

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.

Adjust item for a current output.

IQANrun User manual 63


Adjust
3 System Diagnostics

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.
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 26 for more information on
how to do this.
Shortcut key for changing active parameter is <Ctrl+Up> or <Ctrl+Down>.
You can also use <Tab> and <Shift+Tab> to switch focus between the
parameters and buttons.

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 up/down but-
tons. Click the 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
IQANrun User manual 64
Adjust
3 System Diagnostics

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.

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.

IQANrun User manual 65


Adjust
3 System Diagnostics

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 change the value.
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 67.

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 con-
trol must return to 0 before any output will be allowed. This is to avoid unin-
tentional activation of an output when leaving the minimum current
limitation.

IQANrun User manual 66


Adjust
3 System Diagnostics

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 default
To set factory default value for an adjust item to its current adjustable value,
click Set Default. All parameters are set.
The Set Default 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 78 for more
information.

NOTE
Not all adjust items have a factory default value that can be set from IQAN-
run. The Set Default 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 67


Scripts
3 System Diagnostics

Scripts
Click Scripts on the toolbox or press <Alt+P> to use scripts created in IQAN-
script. The script start page contains favorite and recent scripts as well as
recent script reports from previous scripts that has ben executed. You can add
a favorite script by clicking on the Add favorite link or by clicking on the
favorite icon while executing a script.

Scripts page.

To run a script that is not listed among the favorites or previous scripts, use
the Open Script button in the bottom of the page. If a script is already running
you can continue the execution using the Continue Script button.

Open Script
Use the Open script button to open a script file. An open file dialog pops up.
Select the script file (extension ids3) 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.

IQANrun User manual 68


Scripts
3 System Diagnostics

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 69


Scripts
3 System Diagnostics

Script start page example.

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

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. When you
return to the scripts page the button Continue Script is enabled. When you’re
done measuring or whatever you were doing, just click Continue Script to
resume script execution from where you left it.

IQANrun User manual 70


Get operations
3 System Diagnostics

Get operations
Clicking the Get button in the toolbox brings up the available operations for
retrieving files from the system. These operations includes Get and View
Project, Get Clone and Get Settings.

Get and View Project


Use this button to get the complete project from the IQAN system and view it
in IQANrun. The shortcut key for this operation is <Shift+F11>. Once the
project has been retrieved the Project View tab is activated. Here you can
measure channels in the project, get complete logs and settings. For more
details see section Project View on page 82.

Get clone
Use this button to get all clone data from the connected IQAN system and
save them in a clone file. The clone file can later be sent to another IQAN
system or viewed in IQANrun. More information on clone file viewing can
be found in section Clone file on page 106. Shortcut key for Get Clone is
<Shift+Ctrl+F11>.
Clone files are used to make a complete copy of the master modules in an
IQAN system. They include applications, firmwares, 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.

Get logs confirmation dialog.

IQANrun User manual 71


Get operations
3 System Diagnostics

After the data has been received, a save file dialog box is shown. The file is
by default named <Machine id>.irc3 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.

Get settings
Use this button to get all settings from the connected IQAN system and save
them in a settings file. The settings file can later be used to send these settings
to another IQAN system. 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.

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

IQANrun User manual 72


Send operations
3 System Diagnostics

Send operations
Clicking the Send button in the toolbox brings up the available operations for
sending files to the system. These operations includes Send Project, Send
Clone and Send Settings.

Send Project
Use this button to send a new project file to the connected IQAN system.
Shortcut key is <F11>. An open file dialog is shown. Select the project file
you want to send. A confirmation dialog box, showing you information about
the project you selected, is displayed.

Project 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.
IQANrun will check that the required master modules can be found in the
system before starting to send the project. If any master module is missing a
warning will be shown with information about which master modules that
will be updated. If you want to update the modules found select Yes.

Incomplete system confirmation.

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.
IQANrun User manual 73
Send operations
3 System Diagnostics

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.

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 all master modules will automatically be


restarted. Depending on which type of master module you use, this can take
IQANrun User manual 74
Send operations
3 System Diagnostics

some time. After a new application has been downloaded, some master mod-
ules 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 a project to the IQAN system, first make sure the machine is
not moving and the engine is shut down.

Send clone
Use this button to send all clone data from a previously saved clone file to an
IQAN system. 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 75


Send operations
3 System Diagnostics

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 78
for more information.

Send settings
Use this button to send the settings from a previously saved settings file to an
IQAN system. 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 78
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 project as the one used in the sys-
tem. If it doesn’t, the operation is aborted and an error message is displayed.

Send operations summary


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

IQANrun User manual 76


Send operations
3 System Diagnostics

Information Update Send settings Send clone


application

Application (including Yes No Yes


application default values,
languages and 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

IQANrun User manual 77


Security
3 System Diagnostics

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.

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 78


Security
3 System Diagnostics

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

To get access to these operations and components you need to log in to the
IQAN system. Click the Login link on the top 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.

IQANrun User manual 79


Security
3 System Diagnostics

Just click OK to log in. Read more about stored passwords in section Pass-
word database on page 139.
After a successful login, the top tool bar is updated with your user name. The
Login link is replaced by a Logout link. You should now be able to see the
protected components in its respective menus and perform protected opera-
tions.

Three extra adjust groups, Hydraulic output, Transmission and Other, are shown.

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 link on the top tool bar,
or press <Alt+O>. The tool bar is updated to show that you are not logged in
and a message is displayed.

IQANrun User manual 80


Security
3 System Diagnostics

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.

IQANrun User manual 81


4 Project View

This section describes the Project View tab. 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 Project View tab.
Everything can be reached by opening files on your hard drive. You don’t
have to be connected to a master module.

IQANrun User manual 82


Project View tab operations
4 Project View

Project View tab operations


This section describes the buttons and links available on the Project View tab.
When activating the Project View tab without any project open, only two but-
tons are available. With these buttons you can either open a project file or get
a project from the connected IQAN system.

Project view buttons.

Open
Use this button to open a project file from your hard drive.

Get and View button


Click this button to get the project from a connected IQAN system instead of
opening a project file. The project is transferred from the master module to
IQANrun and then opened so you can view it.
For more information see section System on page 85.

Get project link


When a project is opened you can get another project from the system by
clicking the Get project link which is visible when the system note is selected
in the project manager.

Get Log
First, open or get a project. Then select the log you want to view in the tree
view below and click the Get log records link 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 97.

Get Settings
First, open or get a project. Then select the settings node in the project man-
ager tree and click the Get Settings link to get the settings from the connected
IQAN system. All settings are transferred from the master module(s) to
IQANrun and then opened so you can view them.
For more information see section Settings on page 102.

IQANrun User manual 83


View tab tree view
4 Project View

View tab tree view


The view tab tree view contains four root nodes:
• System
• Functionality
• Logs
• Settings
Each root node displays different information about an project 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 84


System
4 Project View

System
The System node is used to view modules, CAN buses and channel connec-
tions. Start by opening a project file or to get a project from a connected
IQAN system.
• To open a file, click Open in the main tool bar or File menu. The shortcut
key for Open is <Ctrl+O>. Select the project file you want to view and
click Open.
• To get the project from an IQAN system, first select the Project View tab
and then click Get and View button or the Get project link when the sys-
tem node is selected <Shift+F11>.
If the project is protected by a password you will be asked to enter the correct
password to view it. Project passwords can also be stored in your password
database. By doing that, IQANrun will automatically enter the correct pass-
word when you open the project. See section Password database on page 139
for more information.

Enter project password dialog box.

The project file is opened and the tree view on the side tool bar is filled with
information.

System overview
Select the node System to view the system overview. It will show all modules
and CAN buses in the current project. It also shows how the modules are con-
nected to the different CAN buses.

IQANrun User manual 85


System
4 Project View

System overview.

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

Block diagram
Under the System node there is one node per module in the current project.
Select a module node to view its block diagram. The block diagram view dis-
plays 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.

IQANrun User manual 86


System
4 Project View

Module 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.

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

Channel Name of the channel connected to this pin.

Description Channel description.

IQANrun User manual 87


System
4 Project View

Pin list view.

Property inspector
The property inspector is available to the right of this view. See section Prop-
erty inspector on page 90 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 88


Functionality
4 Project View

Functionality
This node is used to view structure and flow of the applications within a proj-
ect. Under the functionality node there is one node for each application in the
project. There is one application for each master module.
Under each application, function group nodes are shown. 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 Functionality node. Some projects 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 142 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.

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

IQANrun User manual 89


Functionality
4 Project View

icon may be locked or unlocked depending on whether you are allowed to


view its contents or not.

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 139 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 90
Functionality
4 Project 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 91


Functionality
4 Project 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.

IQANrun User manual 92


Functionality
4 Project View

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.

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.

IQANrun User manual 93


Functionality
4 Project View

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 94


Channels
4 Project View

Channels
This node lists all channels in a project. Start by opening an project file or to
get a project from a connected IQAN system. See section System on page 85
for a detailed description on how to open a project.
You may not be able to see the Channels node. Some projects require a cer-
tain access level to allow viewing of channels. You can get the correct access
level by requesting a safe password with sufficient access level for applica-
tion viewing from the IQAN administrator at the OEM. See section Safe
passwords on page 142 for more information.
Select the node Channels to view all channels in the current project. Under
the Channels node, a separate node for each channel type available in the cur-
rent 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
five 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, from ascending to descending or vice versa.

IQANrun User manual 95


Channels
4 Project View

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.

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 90 for more information.

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

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

IQANrun User manual 96


Logs
4 Project View

Logs
Use the node Logs to view logs in an application. First, you must open the
project. This is described in section System on page 85.
Select Logs in the tree view to view a list of logs in the current project. The
log list has five 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.

Application The application that the log belongs to.

Log list.

Under the node Logs there is one node for each application in the project.
Each application node in turn contains the logs belonging to that application.
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
IQANrun User manual 97
Logs
4 Project View

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 142 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 90 and section Function inspector on page 91 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 98


Logs
4 Project 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 records link 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 progress 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 99


Logs
4 Project 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.

IQANrun User manual 100


Logs
4 Project View

NOTE
You must open or get the project 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.

Wrong project 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 (irl3), 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 101


Settings
4 Project View

Settings
The Settings node lists all settings in the current project 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 a project, see section Sys-
tem on page 85. The tree list is now populated with all the adjustable or stored
channels in the project, but there are no settings values. To view the values,
you need to open a settings file or get the settings from a connected IQAN
system.
To open a settings file, click Open in the main tool bar or main menu or press
<Ctrl+O>. Select the settings file, extension irs3, and click Open.
To get the settings from a connected IQAN system, first select the Settings
node in the Project View tab and then click on the Get Settings link, keyboard
shortcut is <Shift+Ctrl+F12>.

Settings tree 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.

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

IQANrun User manual 102


Settings
4 Project View

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, use Tools > Compare Settings in the main menu 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 irs3.
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
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.

IQANrun User manual 103


Settings
4 Project View

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.

NOTE
The two settings files must belong to the same project, otherwise they can not
be compared. If they belong to different projects, an error message is dis-
played.

IQANrun User manual 104


Settings
4 Project View

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 105


Clone file
4 Project View

Clone file
In the previous sections in this chapter we have mostly been discussing proj-
ect files, but there is another file type that can be used here, the clone file. A
clone file contains applications, 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 106


5 Archives

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

IQANrun User manual 107


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 links to the most common operations. The logotype is
a hyperlink to Parker’s web site.

Default archive start page.

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


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 108


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.
For detailed information on how to use your specific archive, please contact
the designer of the archive, usually the machine manufacturer.

IQANrun User manual 109


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 111 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 110


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 111


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 112


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 113


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 114


Run script
6 Scripts

Run script
Use the Scripts button to work with scripts. This brings up a script page with
shortcuts to favorite scripts, recent scripts as well as recent reports. Select a
script to run either from the shortcuts or by using the Open Script button. You
can add a favorite script by clicking on the Add favorite link or by clicking on
the favorite icon while executing a script.
If you use the Open Script button, an open file dialog appears. Select the
script file you want to use and click Open. Script files have the extension
ids3. 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.

IQANrun User manual 115


Run script
6 Scripts

Script list for script files containing several scripts.

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.

System status
This action shows the status of the complete system including errors on any
inputs or outputs. See section System on page 38 for more information. All
the information can also be included in the script report.

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 63.

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.

IQANrun User manual 121


Script actions
6 Scripts

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.

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.

.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.

IQANrun User manual 123


Script report
6 Scripts

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 based on for example script name,
machine ID and 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, Ethernet, sim-
ulator, 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 the started communication between the PC and the IQAN
system, a green status lamp lights up in the IQANrun status bar to indicate
that the connection is OK.

Communication options.

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, IQAN-
run will automatically select the one with address 0. If no such module could
be found or more than one master module has address 0, you will be asked
which one you want to connect to when you start to communicate.

Module selection dialog.

In systems with more than one master module, IQANrun will automatically
switch between the different master modules as needed.

IQANrun User manual 130


Options
7 Communication

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

Ethernet
An Ethernet cable can be used to connect to your IQAN system if it contains
a master module with an Ethernet port. The PC and master module must be
on the same network and their IP addresses set up correctly. Connect either
via a router/gateway, or directly with a cable from the PC to the master mod-
ule. WiFi can also be used if the master module is connected to a WiFi access
point with a cable.
If there are multiple master modules connected to the same network, IQAN-
run will try to determine which master to connect to. When not possible, typ-
ically when there are multiple IQAN systems on the same network, you will
be asked which one you want to connect to when you start to communicate.
Select the machine you want to communicate with and click Connect.

Connect via Ethernet dialog box.

IQANrun will remember which system you where connected to last time and
try that system first next time. If you want to force another system connec-
tion, select Communication > Disconnect and then initiate a new communica-
tion again.

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.

IQANrun User manual 131


Options
7 Communication

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 IQANrun or use a custom setting.

Quick switch
On the Communication menu there is one menu item for each communication
interface; USB, Simulator, CAN, Ethernet, 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 132


Remote diagnostics
7 Communication

Remote diagnostics
If your machine is equipped with an IQAN modem it is possible to connect to
it remotely either over Internet or by via a dial-up modem. It is possible to
send and get project, measure and do all the things you can do with a local
system.

ATTENTION
Take extra care when using a remote connection to a machine.
The persons at the machine could be exposed to an increased risk.
Always inform the persons at the machine before sending updates to the
machine and before performing any adjust operations.
Check with the persons on site that:
• the machine is positioned safely
• the engine is off
• the machine cannot start to move
• the emergency stop works, and can be reached quickly
In essence, these are the same precautions you take when working on site.
The only difference when working over a remote connection is that coopera-
tion with another person who is at the machine is always necessary.

Connect via Internet


If your IQAN system includes an IQAN-G2 modem you can connect
remotely to your system over Internet.
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.
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.

IQANrun User manual 133


Remote diagnostics
7 Communication

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.

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.

Connect via modem


By connecting a modem to your PC, you can communicate with a remote
IQAN system that is equipped with an RS-232 modem, e.g. IQAN-G1. Using
this connection multi-master systems are not supported.
Start by installing the modem to your PC, follow installation instructions that
come with the modem. Select the modem you want to use in the IQANrun
options dialog box under the Communications tab. Before attempting to com-
municate with a remote system it is a good idea to verify that a modem is con-
nected to the remote system master.
In the Communication menu you will find the command for connecting via
modem. Select Communication > Connect via Modem... and do one of the
following:

IQANrun User manual 134


Remote diagnostics
7 Communication

• 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.


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

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 135) 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


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 138


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 project, clone, script or archive that


this password is connected to.

Type Password type.

Comment Additional password details.

IQANrun User manual 139


Password database
8 Safe passwords

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; projects, 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 a project (or clone) file means that you have access to
the Functionality node on the Project View tab. The System, Logs and Set-
tings nodes are always available. See section Project View on page 82 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 Functionality on page 89 for more information on locked
components.

IQANrun User manual 140


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 project id. Before you log in, IQANrun checks the proj-
ect id in the connected system and lets you choose between the users in the
password database that have the same id. See section Login on page 78 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 141


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 142


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 143


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 144


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 146


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 147


Menu system
9 User interface

Menu system
This section describes the menu system.

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

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

File type File content

.isa3 Simulation, contains an embedded project, simulation


groups and component values.

.ida3 IQANdesign project file.

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 isa3).

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 Project file


Update the embedded project file in the currently open simulation file.

Exit
Quits IQANsimulate.

IQANsimulate User manual 148


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 178 for more information.

View
Lets you view or hide the different panels IQANsimulate uses; Project Man-
ager 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 151.

Password Manager
Opens the password manager, see section Password database on page 188 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 149


Menu system
9 User interface

File download progress.

NOTE
Check for updates requires an Internet connection.

About
Displays a dialog box with licence and version information.

IQANsimulate User manual 150


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.
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.

IQANsimulate User manual 151


Options
9 User interface

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 186.

Simulator window size


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

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 152


Options
9 User interface

Other
The tab Other collects some other options in IQANsimulate.

Other options.

File association
Lets you associate IQANsimulate with project files. If the button is disabled,
IQANsimulate is already associated with project files. Associating IQANsim-
ulate with application files means that if you double-click such a file in Win-
dows Explorer for instance, IQANsimulate will start and open that file.

NOTE
Changing file associations on Windows Vista or later requires administrator
privileges.
IQANsimulate User manual 153
Options
9 User interface

Always open last file


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

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 154


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 a project and create a new simulation based on it

Open Open a simulation or project

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

Step Run simulator one step (system cycle)

Stop Stop simulator

Raw Value Range Raw value range for sliders and edit boxes

Back Navigate back in the navigation history

Forward Navigate forward in the navigation history

Go Up Jump to parent function group when viewing


application

Screen shot Takes a screen shot of a simulator. If several master


modules are used a drop down menu is shown to select
master.

Show master simulator One button for each master module in the project to
show or hide the corresponding simulator window.

IQANsimulate User manual 155


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 (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 156


10 Project
simulation

An IQAN system consists of one or more master module, various expansion


modules and a project file.
The project 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 a project file to simulate a complete IQAN system;
master modules and expansion modules. This gives you the opportunity to
have a virtual machine on your desktop.

IQANsimulate User manual 157


Modules, channels and functions
10 Project simulation

Modules, channels and functions


An project 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 a project 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 needs.
The masters are the central units in the system. All communication is routed
through the masters. They also contains all non-module specific channels
such as PID regulators, counters and math channels. All calculations take
place in the masters. An IQAN system can consist of a single or multiple
masters.
The masters communicates with modules via CAN-buses (Controller Area
Network) using IQAN CAN protocols, 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 158


Simulation
10 Project simulation

Simulation
In IQANsimulate you can simulate all input channels and the status of current
outputs and all modules in a project. 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 embedded project, 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 isa3.
If the file is protected by a password you will be asked to enter the correct
password to open it. Project passwords can be stored in your password data-
base. By doing that, IQANsimulate will automatically enter the correct pass-
word when you open the file. See section Password database on page 188 for
more information.

Enter application password dialog box.

You can also open project files (extension ida3). This will create a simulation
file without any simulation groups.

IQANsimulate User manual 159


Project manager
10 Project simulation

Project manager
The Project Manager is the tree view on the left side of the main panel. It
contains three root nodes:
• Simulation groups
• System
• Functionality
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.

Project manager.

IQANsimulate User manual 160


Property inspector
10 Project 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 161


Property inspector
10 Project 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 162


Simulation groups
10 Project 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 project man-
ager 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. Enter a
name for the new simulation 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 163


Simulation groups
10 Project 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 164
Simulation groups
10 Project 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.

IQANsimulate User manual 165


Simulation groups
10 Project simulation

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 166


System
10 Project simulation

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

System overview
Select the node System to view the system overview. It will show all modules
and CAN buses in the current project.

System overview.

Each module and CAN bus has its own symbol and name. Select a module or
CAN bus to get detailed information about it in the property inspector.

Block diagram
Under the System node there is one node per module in the current project.
Select a module node to view its block diagram. The block diagram view dis-
plays 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 167


System
10 Project 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 right clicking on a module in
the system overview and select a status from the drop down menu. There are
a lot of different status values to choose from, such as OK, High temperature,
Low supply voltage or No contact. Each module type has its own unique set ot
status values.

IQANsimulate User manual 168


System
10 Project 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 embedded project in IQANsimulate. Use IQANdesign if you need
to do that.

IQANsimulate User manual 169


Functionality
10 Project simulation

Functionality
This node contains one sub node for each application in the project. There is
one application for each master module. The application 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 contents of its function group in
the main panel.

NOTE
You may not be able to see the Functionality 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 191 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 170


Functionality
10 Project 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 188 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.

IQANsimulate User manual 171


Functionality
10 Project simulation

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.
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 172


Functionality
10 Project 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 project 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 173


Functionality
10 Project 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 174


Functionality
10 Project 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 175


Channels
10 Project simulation

Channels
Under the functionality node the channels node lists all channels in a project.

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 191 for more information.

Channel list view


Select the node Channels to view all channels in the current project. Under
the Channels node, a separate node for each channel type available in the cur-
rent project is created. This makes it easy to view for instance all digital
inputs in a project. 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.

Name Channel name.

Order Calculation order. Channels with lower calculation


order are calculated before channels with higher
calculation order.

Type Channel type.

IQANsimulate User manual 176


Channels
10 Project simulation

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 177


11 Simulators

The simulator is a very useful tool that helps to assure the functionality of
your project before you download the file to the IQAN system. It is also very
easy to check a function if you are unsure of its behavior.
Another benefit is that if your project contains one ore more display modules
you don’t have to download your project file to check your display pages, dis-
play controls or menu system. The project 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 178


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 project you use. To start the simulator
select Simulate > Run, or press <F9>. Before the simulator starts to run, the
project 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 project 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 your project file contains multiple master modules, one simulator for each
master module will be started. The communication between the master mod-
ules is also simulated so the simulation will behave as a real system with mul-
tiple master modules.
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 179


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.
Use the tool bar button for the corresponding module to turn off or on the
IQANsimulate User manual 180
Simulator display
11 Simulators

simulator user interface. To quickly hide or show all simulators, use the
option Simulate > Show Simulator. Shortcut 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 181


Simulator display
11 Simulators

IQAN-MDL2 simulator showing an error message.

IQANsimulate User manual 182


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 183


During simulation
11 Simulators

Project update
If the project is updated from an external source, for example IQANrun,
while the simulator is running, IQANsimulate will open the new project and
restart the simulator. When opening the new project, 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 project is loaded.

IQANsimulate User manual 184


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 project sent from IQANdesign. If not,
you have to decide if you want to open another simulation file or create a new
empty file.

Project 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 185


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 186


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 187


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 188


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 project file for editing in IQANdesign. It can however be used in
IQANsimulate to open a protected project file. You will not be granted edit-
ing 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 a project file means
that you have access to the Functionality and Channels nodes in the simula-
tion navigation tree view. The System 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 170 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 189


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 190


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 191


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 192


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 193

Potrebbero piacerti anche