Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
Version 3.19
User manual
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,
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.
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
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
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
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
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.
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.
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.
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
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.
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.
• The installation is now completed. Click Finish to close the Found New
Hardware Wizard.
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.
Main window
The main window consists of a menu, a couple of tool bars, a status bar and
the main panel.
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.
Menu system
This section describes the menu system.
File
Open
Opens a file and displays its content in the main panel.
.iss3 Script
.ica3 Archive
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.
.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).
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.
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.
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.
Select Language
Selects language in the connected system. See section Language on page 42.
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.
Release Notes
Displays release notes for the version of IQANrun that you are using.
When you download a new version, your license and user information will be
sent to our server to collect usage statistics, see table below.
License number, name and The number and names you entered when IQANrun
company was installed.
NOTE
Check for updates requires an Internet connection.
About
Displays a dialog box with licence and version information.
Options
This section describes the options that concern the user interface of IQANrun.
Appearance
There are options that concern the user interface in general. Select Tools >
Options to show the IQANrun options dialog box. Switch to the Appearance
tab.
Appearance options.
Font
Choose the font to be used in the main window and all dialog boxes.
Check Use Windows font settings to use the settings from Windows Control
Panel. Or, select your own font and size. The sample will show you how the
selected font looks like.
Icon size
Select the size of your tool bar icons. Choose between small, medium or large
icons.
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.
Switch to the Show again tab. Select the check box for each message that you
want to be shown again.
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.
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.
Toolbox
The toolbox contains buttons for all operations IQANrun
can perform on a connected IQAN system.
Tools
Get Log link Get and view the complete selected log
from master module. Available when
selecting a log.
Status bar
The status bar displays project name with machine id (when applicable), cur-
rent operation, a progress bar and communication type and status.
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
F1 Help Contents
Alt+S System
Alt+L Logs
Alt+M Measure
Alt+A Adjust
Alt+P Scripts
Alt+N Login
Alt+O Logout
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.
System
Click System on the toolbox or press <Alt+S> to show an overview of all the
modules in the system and their status.
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.
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.
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.
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.
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.
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.
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.
Enter the SIM PIN code you want and click Set. A dialog box is shown to
inform you about the result of the operation.
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.
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.
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-
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.
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.
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.
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.
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.
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.
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.
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.
Print
Click Print in the main tool bar or press <Ctrl + P> to print the current log.
Clear
Click Clear Log to clear the current log in the connected master module. All
records are deleted.
Sorting order
Click the column header you would like to sort on. If you click the same col-
umn header again the sort order toggles between ascending and descending.
Done
Clicking Done closes this window and takes you back to the log list. You can
also use the navigation buttons in the main tool bar.
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
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.
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.
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.
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.
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.
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.
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.
Missing samples threshold Select the number of continuos samples that needs to
be missing before marking them in the graph. Requires
option above to be selected.
Statistics
Select the item you want statistics for in the items list. You can also click on
the item’s curve in the graph panel to select it. The selected curve will have a
thicker line in the graph. Two circles on the selected item’s curve indicates
the two points between which rise/fall time is calculated.
Use the two cursors to select the range for calculating statistics. You will find
the cursors as small arrows above the graph. You can use the cursors as soon
as you have stopped the measurement.
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.
Peak to Peak The difference between Max and Min described above.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Mode Current mode for this adjust item. Only displayed for
multi-mode adjust items.
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 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.
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.
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.
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.
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.
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.
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.
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 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.
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.
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.
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.
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.
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.
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.
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.
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.
Logs No No No
Machine id No No Yes
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.
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.
It is also possible to store users and their passwords in your password data-
base. Stored users can be accessed in the drop down list Username. When
you select a stored user in the list, its password will be filled in automatically.
Just click OK to log in. Read more about stored passwords in section Pass-
word database on page 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.
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.
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.
Open
Use this button to open a project file from your hard drive.
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.
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.
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.
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.
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.
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>.
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.
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.
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.
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.
Draw reference lines Specifies how reference lines between components are
drawn.
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.
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.
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>.
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.
Type There are three log types; System log, Event log and
Statistics log.
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.
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.
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.
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.
You can quickly jump to a record component’s original view. Select the
record in the list and right-click on it. In the popup menu, select Go To Com-
ponent. Focus is redirected to the form where this component is located and
the component is selected.
NOTE
You must open or get the 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.
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>.
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>.
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.
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.
Compare settings.
There is also a small tool bar available with commands that will help you to
navigate in the file panes.
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.
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.
Print
Print a settings list view by clicking Print in the main tool bar or by pressing
<Ctrl+P>.
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.
This section will explain the concept of archives. Archives are used to cus-
tomize IQANrun’s user interface.
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.
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.
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.
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.
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.
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).
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Script report
When the script has been executed the result is shown in the form of a report.
.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.
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.
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.
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.
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.
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.
In systems with more than one master module, IQANrun will automatically
switch between the different master modules as needed.
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.
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.
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.
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.
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.
• 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.
Disconnect
When you are ready, disconnect the modem connection by selecting Commu-
nication > Disconnect.
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.
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.
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.
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.
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.
Password types
There are four password types available; Full access password, Limited
access password, Component password and Login.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Exit
Quits IQANsimulate.
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.
Release Notes
Displays release notes for the version of IQANsimulate that you are using.
NOTE
Check for updates requires an Internet connection.
About
Displays a dialog box with licence and version information.
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.
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.
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
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.
Raw Value Range Raw value range for sliders and edit boxes
Show master simulator One button for each master module in the project to
show or hide the corresponding simulator window.
Status bar
The status bar displays application name, simulation and communication sta-
tus.
Simulation status
Stopped Simulation is not running (Grey)
Communication status
Inactive Simulation is not running (Grey)
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
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.
You can also open project files (extension ida3). This will create a simulation
file without any simulation groups.
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.
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.
NOTE
Any text typed into a property edit box will not be applied until you press
<Enter> or <Tab>.
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>.
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.
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.
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.
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
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".
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.
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.
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.
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.
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.
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.
Simulate
You can simulate the value of input channels, adjustable channels and stored
channels. Status can be simulated for current outputs, parameter group inputs
and generic frame inputs.
Input channels
Input channel types that can be simulated are voltage input, digital inputs, fre-
quency inputs, directional frequency inputs, directional analog channels,
parameter inputs and SPN channels.
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.
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.
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.
Draw reference lines Specifies how reference lines between components are
drawn.
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.
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.
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.
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.
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.
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.
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.
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.
Message boxes
Popup message boxes are also simulated, see image below.
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
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.
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.
IQANdesign synchronization
IQANdesign and IQANsimulate both have features that allow you to control
a simulation from either user interface.
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.
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.
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.
Password types
There are four password types available; Full access password, Limited
access password, Component password and Login.
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.
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.
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.
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
password database, click on the Add Safe button. Enter the password in the
dialog box that appears and click OK.
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.
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.