IQANActiveStudio 2.60.7
IQANActiveStudio 2.60.7
IQANActiveStudio 2.60.7
Version 2.60
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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Main window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Menu system . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Communication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Appearance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Show again . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Languages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Other . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Main tool bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Side tool bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Online . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Status bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Keyboard shortcuts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
3 Online . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Adjust . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Measure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Run Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Continue Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Login . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Logout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Static users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Dynamic users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
File operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Update . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Get settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
Send settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Get clone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Send clone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
Send operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
4 View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
View tab buttons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Get Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Get Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Get Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Compare Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
View tab tree view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
Property inspector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
Function inspector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Measure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Print . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Channels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Property inspector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
Function inspector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
Measure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
Print . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
System overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
Measure modules and buses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
Block diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
Pin list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Property inspector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Measure channels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Print . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Log items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Log records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
Save . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
Print . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
Tree list view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Compare settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Print . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
Clone file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
5 Archives . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
Archive contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
Multiple archives . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
Install archive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
Select archive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
Delete archive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
Check for updates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
6 Scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
Run script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
Script actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
Script report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
Script execution errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
Script states . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
Script output folder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
7 Communication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
USB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
CAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
Serial port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
Simulator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
Modem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
Internet settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
Quick switch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
Connect via internet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
Connect via internet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
Disconnect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
Modem connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
Connect via modem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
Disconnect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
Phone book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
Add . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
Edit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
Delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
Export . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
Import . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
Choosing a modem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
8 Safe passwords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
Password database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
Password types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
Date restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
Add password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
Safe passwords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
Delete password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
IQANsimulate
9 User interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
Main window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
Menu system . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
Edit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
Simulate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
Appearance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
Show again . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
Other . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
Main tool bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
Status bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
Simulation status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
Communication status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
10 Application simulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
Modules, channels and functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
Modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
Channels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
Simulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
Simulation files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
Application manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
Property inspector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
Keyboard shortcuts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
Changing a property on multiple components . . . . . . . . . . . . . . . . . 164
Go to component . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
Simulation groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
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.
.ida Application
.ids Script
.ica 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.
.irl Log records (in clear text format, can be viewed later
without having access to the corresponding application
as opposed to the irf format, see above).
Close
Closes the currently opened application file.
Select Archive
Lets you select which archive you want to use when you have multiple
archives installed. For more information on archives, see section Archives on
page 108.
Install Archive
Installs an additional archive. You can have as many archives as you like. If
the archive already has been installed, it will be replaced.
Delete Archive
Deletes the currently selected archive. The default archive can not be deleted.
Print
Prints the current view. Not all views can be printed. Select printer and set
print options.
Print header will add a header to all pages with a description, date and time
and page number. Print to fit will scale the print-out so that it fits on a single
page.
NOTE
Printing is optimized for portrait mode. Using landscape mode may not print
all information.
Exit
Quits IQANrun.
View
Contains navigation menu items such as Back, Forward, Stop and Home.
Tools
Contains common tools menu items.
Options
Lets you customize the user interface and behavior of IQANrun. See section
Options on page 24.
Password Manager
Opens the password manager, see section Password database on page 141 for
more information.
Communication
For information, see section Communication on page 128.
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 103 for more information.
Show again
Some message dialog boxes have a check box named Never show this again.
By selecting that check box, you will never be shown that information or
asked that question again. Here is how you enable those messages again.
Select Tools > Options to show the IQANrun options dialog box.
Switch to the Show again tab. Select the check box for each message that you
want to be shown again.
Languages
On this tab you can select your preferred language when working with master
modules online or when viewing files. You can select a primary and a sec-
ondary language. When connecting to a master module or opening a file,
IQANrun will try to select first the primary and then the secondary language
to use when displaying component names, such as measure groups or logs.
If none of these languages are available, the default language in the current
application will be used instead.
When a preferred language was selected in a connected master module, it will
change the language selection locally on the master display as well. This is
only temporary though, when power is turned off and on again, the master
display is reset to its original language selection. Read more about languages
in section Language on page 62.
Languages options.
Other
The tab Other collects some other options in IQANrun.
Other options.
File associations
Lets you associate IQANrun with application, script and/or archive files. If a
button is disabled, IQANrun is already associated with that file type. Associ-
ating IQANrun with a file type means that if you double-click such a file in
Windows Explorer for instance, IQANrun will start and open that file.
NOTE
Changing file associations on Windows Vista requires administrator privi-
leges.
Logs
See section Logs on page 53 for more information.
Online
The side tool bar tab Online contains buttons for all opera-
tions IQANrun can perform on a connected IQAN system.
The buttons are grouped in different categories.
Tools
Script
Security
File operations
View
The side tool bar tab View contains some buttons and a tree
view where you can navigate to view different things such
as applications, logs and/or settings.
Tools
Status bar
The status bar displays application name with machine id (when applicable),
currently logged in user and his access level, current operation, a progress bar
and communication type and status.
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+A Adjust
Alt+M Measure
Alt+L Logs
Alt+D Modules
Alt+S System
Alt+N Login
Alt+O Logout
Alt+U Users
F11 Update
This section describes the operations on the Online tab on the side tool bar.
All operations on the online tab usually requires a connected master module
to function.
If you are using a third party archive, not all of the described functions in this
chapter may be available. Read section Archives on page 108 for more infor-
mation.
Tools
This section describes the operations in the Tools group. These are Adjust,
Measure, Logs, Modules and System.
Adjust
Use this button to adjust things such as inputs, outputs, function parameters,
etc. There is no need to open any application file to do this operation, all
information needed by IQANrun is fetched from the connected master mod-
ule.
Start by clicking the Adjust button on the side tool bar. The shortcut key is
<Alt+A>. A list of available adjust groups is displayed.
Adjust groups.
An adjust group contains one or more adjust items. They provide a way of
organizing all adjust items in an application to give you a better overview.
If you miss some adjust group in the list that you know should be there, you
may need higher access rights. Log in as a different user with sufficient
access rights and try again. See section Login on page 69 for more informa-
tion.
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 group
Use this button to set the factory default value for all adjust items in this
group to their current adjustable value. If some of the items have multiple
modes you will be asked whether you want to set all modes or just the active
one.
If this button is disabled, you may need higher access rights. Log in as a dif-
ferent user with sufficient access rights and try again. See section Login on
page 69 for more information.
NOTE
Not all adjust items have a factory default value that can be set from IQAN-
run. If the group only contains such adjust items, the Set Group button will be
disabled.
Copy mode
Use this button to copy all adjustable values from one mode to the active
mode. A popup menu with available modes to copy from is displayed when
you click this button. Select the mode you want to copy from. Adjust items in
the group that don’t use modes are not affected by this operation.
A confirmation dialog box is displayed before the operation is executed.
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 24 for more information on
how to do this.
Shortcut key for changing active parameter is <Ctrl+Up> or <Ctrl+Down>.
Tab will only switch focus between the bottom line buttons and the active
parameter for safety reasons.
Parameter types
The parameter value is adjusted in three different ways, depending on the
parameter’s value type - numerical, text, state or PIN code.
Numerical values are adjusted with an edit box connected to an up/down
spinner. Click the spinner buttons or enter a value in the edit box and press
<Enter> to adjust the parameter. Another way is to use the <Up> and
<Down> arrows on the keyboard. This will change the value in small steps.
Press <PgUp> and <PgDn> to move in larger steps.
There is also a slider displayed for numerical parameters. The slider is only
for visual feedback of the parameter value and can not be used for adjusting
it. When there are multiple parameters, all the sliders usually have the same
range. For some parameters part of the slider range is dark grey. This indi-
cates out of range values. Adjustments are only allowed within the light grey
range. The line with vertical pointing arrows indicates current parameter
value. For some parameters there is also a second line with horizontal arrows
which indicates current channel value.
Parameters on voltage inputs with the automatic adjustment function enabled
have a check box named Auto. When this is checked the parameter value will
automatically be adjusted by the channel value. All you need to do is make
the voltage input reach its minimum and maximum values and you’re set. For
example, to adjust a gas pedal, press it fully to the floor and then release it
again to its zero position. Both min and max are now adjusted and you are
done. If you want to adjust it manually anyway, just uncheck Auto.
Numerical parameter.
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 for example move
the slider control.
There is no need to acknowledge the new value you have adjusted it, just
leave the page when you are done by either clicking Done, Back or Home or
any button on the side tool bar. To leave the page without storing your adjust-
ments see section Cancel on page 43.
ATTENTION
Use caution when adjusting parameters over a modem connection, since there
is a longer response time on your adjustments.
All inputs and outputs are still active while you are adjusting them. This
means that you will get instantaneous feedback on your adjustments if you at
the same time activate the input or output.
Current outputs
When adjusting minimum current for a current output, parameter Min [mA],
the actual output is limited to minimum current. This will make it easier to
adjust minimum current by allowing you to activate the output without hav-
ing to hit the exact start position.
For example, to adjust a crane output you select the minimum current param-
eter by clicking it, then you activate the crane function by moving the joystick
to its maximum position. The output will now be limited to minimum current.
Change the parameter value with the spinner buttons or the <Up> and
<Down> keys until you have reached the position where the crane starts to
move.
ATTENTION
If you select another parameter while adjusting minimum current, either by
clicking another slider or pressing <Ctrl+Up/Down>, the current output will
no longer be limited to minimum current. This may cause unintentional acti-
vation of an output. In the example above, it would cause the crane to move
with maximum speed, since the joystick is in its maximum position.
Reset item
To reset an adjust item to its default value, click Reset Item on the bottom left.
All parameters are reset. The default value is displayed next to each parame-
ter.
A confirmation dialog box is displayed before the operation is executed.
Set item
To set factory default value for an adjust item to its current adjustable value,
click Set Item. All parameters are set.
IQANrun User manual 42
Tools
3 Online
The Set Item button may be disabled or invisible depending on what adjust
item you are looking at and what access level you have. If this button is dis-
abled, you may need higher access rights. Log in as a different user with suf-
ficient access rights and try again. See section Login on page 69 for more
information.
NOTE
Not all adjust items have a factory default value that can be set from IQAN-
run. The Set Item button will then be disabled.
Cancel
If you would like to cancel all your changes on the current page, click Cancel.
This will restore all parameter values for this adjust item to the original value
they had when you entered this page. The original value is displayed next to
each parameter.
Measure
Use this function to measure one or more channels in real-time. Measure-
ments can be done both numerically and graphically. There is no need to open
any application file to do this operation, all information needed by IQANrun
is fetched from the connected master module.
Start by clicking the Measure button on the side tool bar or press <Alt+M>. A
tree view of measure groups, measure items and modules is displayed. They
are divided into three different groups; System measure groups, User defined
measure groups and System status.
Measure groups
A measure group contains one or more measure items. They provide a way of
organizing all measure items in an application to give you a better overview.
Expand a measure group to see all its measure items.
cient access rights and try again. See section Login on page 69 for more infor-
mation.
NOTE
It is not possible to add and delete measure groups or items while you are
measuring.
System status
Under this node all the modules in the system will be listed. If there are any
channels with an error condition they will also be listed here under its parent
module. If the error condition for a channel goes away during a measure, the
channel will still be listed. Restart the measure to clear the tree view from
channels without errors.
The system status function is very useful to quickly spot any problems in a
machine. The System status node itself will display the most severe status
type of all underlying module and channel status types: OK (green), Warning
(yellow) or Error (red).
Graph
Select a measure group or item in the tree view and click Graph in the lower
right corner, or use the arrow keys on the keyboard and press <Enter> to con-
tinue to graphical measuring.
The measure group with all its measure items is shown together with a graph
and IQANrun starts to measure automatically.
Graphical measurement.
The measure window has a graph in the middle where each channel is mea-
sured graphically. Underneath the graph there is a list with all the measure
items and their numerical value. Each item is color-coded to match its curve
in the graph.
Start/Stop measure
To start a measurement, click the Start Measure button in the main tool bar or
press the function key F7. To stop a measurement click the Stop Measure but-
IQANrun User manual 46
Tools
3 Online
ton in the main tool bar or press <Shift + F7>. You can also use the space bar
to start and stop measuring.
It is also possible to pause the measurement. This will stop the screen from
updating but continue to measure all values in the background. Click Pause
Measure in the main tool bar or press <Ctrl + F7>.
Comment
Add a comment to your measurement by clicking Comment.
The comment is saved when you save this measurement as a file, both in
IQANrun and Excel format.
Save
After you have stopped the measurement, it is possible to save all your values
to a file. Click Save in the tool bar above the graph or press <Ctrl + S>. A
save file dialog box is shown.
There are two file formats available.
Print
Click Print in the main tool bar or press <Ctrl + P> to print the measured
graph with statistics.
Clear values
To clear all measured values, right-click in the graph panel and select Clear.
IQANrun User manual 47
Tools
3 Online
Graph options
By default the background of the graph is black and the grid color is gray, but
in the options dialog for IQANrun you can easily change these colors and
other measure options. Select Tools > Options, Measure tab or right click on
the graph window and select Options.
Measure options.
Line with The line width in pixels for the curves in graphs.
Active line width The currently selected channel can have another line
width than the others. Select that here.
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.
Values as Text. All values are now copied to Windows clipboard. Start the
other program and select Paste.
Zooming
You can easily select a section of the curves to be enlarged. Select the zoom
area by holding the left mouse button while you drag the mouse cursor over
the desired enlargement area. A zoom area is built around what will be
enlarged.
To zoom in time or X-axis only, position both cursors on either side of the
area to be zoomed. Right click in the graph and select, View Cursor Range.
Another way of doing this is to zoom in as described in the section above
while holding <Shift> pressed.
To view the complete curves again, right click in the graph and select Zoom
out or click the Zoom Out button.
Scrolling
There are two scroll bars to move the graph and curves in either horizontal or
vertical direction.
To move the active curve in the Y (up/down) direction, use the vertical scroll
bar on the right of the graph. When no measure item is selected, all curves are
moved at the same time.
Scaling
It is possible to auto scale each channel. Use Auto Scale Join to make each
channel’s values fit within the Y axis limits. The channels’ values will
overlap.
Use Auto Scale Split to split the channels so that no channel will overlap any
other channel. All channels will be visible in the graph without any
overlapping.
To manually scale a measure item, right-click in the item list and select Prop-
erties. A dialog box appears.
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.
Logs
Use this button to view and manage logs in the connected IQAN system.
Logs.
Click Logs on the side tool bar or press <Alt+L> to see a list of all available
logs in the connected master module. Some logs may be protected by a PIN
code. Those logs are marked with a small lock symbol. See also section PIN
code protection on page 36.
If you miss some log in the list that you know should be there, you may need
higher access rights. Log in as a different user with sufficient access rights
and try again. See section Login on page 69 for more information.
Add record
Click Add Record to add some text to the system log. A dialog box is pre-
sented. Enter the text you want to add in the system log and click OK. The
maximum number of characters is 250.
The text record is added with the description External record and the text you
entered as its value. It is of course stamped with current date and time.
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 69 for more informa-
tion.
Get log
To get a complete log and save it as a file, select the log in the list and click
Get Log. The log is downloaded from the connected master module and a
save dialog box is presented. Select folder and file name and save the file.
The file can later be viewed in IQANrun but requires the corresponding
application to be opened first. See section Logs on page 98 for more informa-
tion.
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 two 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.
Modules
Click Modules on the side tool bar or press <Alt+D> to see a list of all mod-
ules in the connected system.
Module list.
Select a module in the list and click Select in the lower right corner to con-
tinue. You can also double-click on a module in the list, or use the arrow keys
on the keyboard and press <Enter> to continue.
Module information.
The information is updated continuously, so you can use this view to measure
module temperature and supply voltage for example.
Save
Click Save in the main tool bar to save current module information as an
HTML file.
Print
Click Print in the main tool bar to print current module information.
Done
Clicking Done closes this window and takes you back to the log list. You can
also use the navigation buttons in the main tool bar.
System
Use this button to view system information, such as application name and
machine id. Click System on the side tool bar or press <Alt+S>.
System information.
Save
Click Save in the main tool bar to save current system information as an
HTML file.
Print
Click Print in the main tool bar to print current system information.
Machine Id
Use this button to view and/or set machine id in the connected master mod-
ule. This should only be done once in a machine’s life time, typically in pro-
duction. The machine id is a text of up to 64 characters. It should be a unique
text that identifies each machine. Typically, the machine’s chassis number or
serial number is used as machine id.
IQANrun User manual 59
Tools
3 Online
For example logs and clone files are marked with the actual machine id to
make it possible for you to later identify which machine they belong to.
Machine id form.
Enter the machine id you want and press OK. A dialog box is shown to
inform you about the result of the operation. The master module may also
require a restart before the new machine id is in effect. You will then be given
the option to restart it from IQANrun.
Some logs require a higher access level to allow machine id changing. If that
is the case, an error message is displayed. Log in as a different user with suf-
ficient access rights and try again. See section Login on page 69 for more
information.
Select Current date and time from this PC to use your PC’s clock to set the
master module clock.
Current date and time with another time zone (GMT) will do the same but
adjust the time to another time zone before setting the master module clock.
The default value shown when you enter this page is the current time zone set
on your PC. For example, to use Pacific Time (US & Canada), enter -8.
Select Other date and time to set date and time to whatever you like.
Click Set to set date and time in the connected master module. A dialog box,
telling you what time was set, is displayed.
Language
Use this button to select language in the connected master module. A list with
all available languages is displayed. The currently active language is selected
in the list.
Language list.
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)
Use the modem button to set SIM PIN code in the connected master module.
A SIM PIN code is a string that consists of four numerical characters, for
example 4260. You must enter a SIM PIN code if you use a GSM modem
with a PIN code protected SIM card. This is typically done in production
when modem and SIM card has been mounted.
NOTE
If you don’t want to use PIN codes for your SIM cards, you must make sure
that the PIN code protection has been turned off. This can be done by placing
the SIM card in a normal mobile phone and use its menu system to turn SIM
card protection off.
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)
If your are using a CAN modem you will need to setup some additional
parameters in order for the modem to be able to connect to internet. To con-
figure these parameters you need to be connected with IQANrun to the CAN
bus where the modem is located. By clicking the Modem button the modem
will be detected and you can configure the parameters required for the inter-
net connection.
The Internet service provider settings can be retreived from your network
provider. Often the only parameter that needs to be entered here is the Inter-
net Access Point Name (APN).
If you need to use the modem outside the home network of your SIM card
(e.g. internationally), you need to enable roaming data. Note however that
IQANrun User manual 65
Tools
3 Online
when connected outside the home network the cost of the data traffic is nor-
mally much more expensive. It is normally recommended to use a local SIM
card instead.
If your SIM card is PIN code protected the PIN code must be entered here
before mounting the SIM card inside the modem to avoid locking it.
NOTE
If you don’t want to use PIN codes for your SIM cards, you must make sure
that the PIN code protection has been turned off. This can be done by placing
the SIM card in a normal mobile phone and use its menu system to turn SIM
card protection off.
Under Modem info you will see the current status of the connected CAN
modem such as network provider, signal strength and network status. Finally
the Modem activation data shows the IMEI number and the activation serial
number that needs to be entered when activating a modem at the remote diag-
nostics server. To make it easier to activate a modem it is possible to copy
each value to the windows clipboard using the Copy buttons.
When you have entered all required parameters click the Set button. Then the
parameters will be stored in the modem and you will return to the system
information page.
You can also save all the modem settings in a file to be able to quickly load
the same settings when configuring multiple modems. This is done using the
Load settings and Save settings buttons.
Script
This section describes the operations in the Script group. These are Run
Script and Continue Script.
Run Script
Use the Run script button to open a script file. An open file dialog pops up.
Select the script file (extension ids) and click Open. If the script file contains
more than one script a list of the scripts will be shown. Otherwise the script
will be started directly.
The script list is shown if the script file contains more than one script.
When there are multiple scripts in the script file, select the script you want to
run in the list and click Select or double-click on the script. The script is
started.
Scripts usually display their own user instructions. Follow the on-screen
instructions and use the buttons Previous and Continue at the bottom to navi-
gate back and forward within the script.
Read more about scripts and script actions in section Scripts on page 115.
Continue Script
While running a script you may want to temporarily move away from the
script to look at a log or measure some channels for instance. As soon as you
do that the button Continue Script lights up. When you’re done measuring or
whatever you were doing, just click Continue Script to resume script execu-
tion from where you left it.
Security
Some application components or operations may be protected by access lev-
els. To access these you have to log in to the machine with a user that has an
access level that is same or higher than the required.
Users an also be managed through IQANrun. To get access to user manage-
ment in IQANrun you need to log in with a user that has administrator rights.
This chapter will explain how this is done.
Login
If you try to perform an operation that is protected by a higher access level
than the one you currently have, that operation will fail due to insufficient
access rights. The same applies if you haven’t logged in at all of course.
Only three adjust groups are shown; Loader, Hydraulic output and Engine.
To get access to these operations and components you need to log in to the
master module. Click the Login button on the side tool bar, or press <Alt+N>.
A dialog box is shown, asking for a user name and a password. Enter a user
name that you know exists and its corresponding password, and click OK.
It is also possible to store users and their passwords in your password data-
base. Stored users can be accessed in the drop down list Username. When
you select a stored user in the list, its password will be filled in automatically.
Just click OK to log in. Read more about stored passwords in section Pass-
word database on page 141.
After a successful login, the status bar is updated with your user name and
access level. The user icon next to the user name indicates whether you have
administrator rights or not. When you have administrator rights the user icon
will have a tie.
You should now be able to see the protected components in its respective
menus and perform protected operations.
Superuser
One user will always exist in every machine, the superuser. Its password is
specified in the application and will therefore be the same in all your
machines that use that application. The superuser will always have the high-
est access level possible. This user is only intended for creation and manage-
ment of other users and should not be used otherwise.
NOTE
The user name for the superuser is Superuser. User names are case sensitive,
so make sure you use a capital S when logging in as this user.
Logout
When you are done with your work in IQANrun, you should log out before
you leave the machine to prevent other users from getting access to the pro-
tected components and operations. Click the Logout button on the side tool
bar, or press <Alt+O>. The status bar is updated to show that you are not
logged in and a message is displayed.
Select Never show this again if you don’t want to see this information dialog
box when logging out in the future. To see it again, reset the “never show
again” flag via Tools > Options > Show again.
You will automatically be logged out if the connected master module is shut
down or restarted.
Users
Some users can also create and manage other users. Such users are called
administrator users. Administrator rights can be specified when creating a
new user. Administrator users can only create and manage users with same or
lower access levels than themselves.
To manage other users, first log in as an administrator user, then click the
Users button on the side tool bar, or press <Alt+U>. A list of all users with
same or lower access level than yourself is displayed.
User list.
Print
Click Print in the main tool bar to print current users information.
IQANrun User manual 72
Security
3 Online
Add a user
To add a user, click Add User. A dialog box is shown.
Enter a unique user name and a password. User names and passwords are
case sensitive and can only contain characters A-Z, a-z and 0-9.
Select an access level. You can only select access levels that are the same or
lower than yours.
Enter a tag if you need to identify this user by a number instead of name. This
number can for example be used in the application to control something.
If you want to give this user administrator rights, select the check box Admin-
istrator. This means he or she will be able to add, edit or delete other users.
Click OK to create this user and add it to the connected master module. The
user list is updated to show you the new user.
Delete user
Select the user you want to delete in the user list and click Delete User on the
main tool bar. The user is deleted in the master module and the user list is
updated.
Edit user
Select the user you want to edit in the user list and click Edit User on the
main tool bar. The same dialog box as for Add User is displayed, but this time
all fields are filled in with the selected user’s data. Change one or more fields
and click OK to update the user with the new data. The user list is updated to
show you the changes.
Static users
Some users, for example Superuser, are part of the application. Such users are
static and added when their application is downloaded to the master module.
Static users are the same (same user name, password and access level) on all
machines that use that application.
Static users can not be edited or deleted by IQANrun. They are marked with a
lock symbol in the user list.
Dynamic users
The users that are added by IQANrun are called dynamic users. These users
can differ from machine to machine.
File operations
This section describes the machine data management operations. These are
Update, Get Settings, Send Settings, Get Clone and Send Clone.
Update
Use this button to send a new application to the connected master module.
Shortcut key is <F11>. An open file dialog is shown. Select the application
file you want to send. A confirmation dialog box, showing you information
about the application you selected, is displayed.
Application information.
Click Yes to continue. A warning message is displayed to remind you that the
machine has to be stopped to proceed. Verify that the engine has been shut
down and click OK to continue.
If you have activated the select languages dialog box, it will be displayed
now. This dialog is activated by selecting the option Show send language
options dialog in Tools > Options, tab Languages.
Select the languages that you want to send to the master module. The default
language at the top of the list must always be sent and can not be deselected.
Select languages.
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.
ATTENTION
When sending an application to the master, first make sure the machine is not
moving and the engine is shut down.
Get settings
Use this button to get all settings from the connected master module and save
them in a settings file. The settings file can later be used to send these settings
to another master module. Shortcut key is <Shift+F12>.
A settings file contains adjustable, factory default and stored values.
Adjustable values User settings for voltage inputs, current outputs, PWM
outputs, servo outputs and function parameters.
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>.irs to make it easier for you to know which
machine it belongs to.
Send settings
Use this button to send the settings from a previously saved settings file to a
master module. See previous section for more information on settings files.
Shortcut key is <F12>.
Only settings that you have access rights to change will be updated. All other
settings are left unchanged. Make sure that you are logged in with sufficient
access rights before you perform this operation. See section Login on page 69
for more information. There will be no notification if your access level is too
low for some settings.
NOTE
The settings file has to belong to the same application as the one used in the
master module. If it doesn’t, the operation is aborted and an error message is
displayed.
Get clone
Use this button to get all clone data from the connected master module and
save them in a clone file. The clone file can later be sent to another master
module or viewed in IQANrun. More information on clone file viewing can
be found in section Clone file on page 107. Shortcut key for Get Clone is
<Shift+Ctrl+F11>.
Clone files are used to make a complete copy of a master module. They
include application, firmware, users, settings, machine id and logs.
There are mainly two scenarios where you would like to use clone files.
The first one is when you for some reason need to replace a master module
out in the field. To guarantee that you get exactly the same function with the
new master module, you must copy all information from the old one to the
new.
The second scenario is when you have a problem with a machine that you
need assistance to solve. Make a clone file of your machine and send that file
to your support contact. Now they have an exact copy of your machine and
can much easier help you with your problem.
Logs can be very large and are therefore optional. When you click Get Clone
a confirmation dialog pops up asking whether you would like to get logs or
not.
After the data has been received, a save file dialog box is shown. The file is
by default named <Machine id>.irc to make it easier for you to know which
machine it belongs to. Select folder and file name for your clone file and click
Save.
Send clone
Use this button to send all clone data from a previously saved clone file to a
master module. Shortcut key is <Ctrl+F11>.
Before the data is sent, IQANrun checks that your access level is high enough
for this operation. If you need higher access level, you will be given the
option to log in as a different user.
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 69
for more information.
Summary
Send operations
This table summarizes what parts of the machine information is exchanged
with different send operations.
Logs No No No
Machine id No No Yes
This section describes the View tab on the side tool bar. It is basically a tree
view that lets you navigate through channels, functions, modules, logs and
settings. Detailed information can easily be accessed in the main panel when
working with the View tab.
Everything can be reached by opening files on your hard drive. You don’t
have to be connected to a master module.
If you are using a third party archive, not all of the described functions in this
chapter may be available. Read section Archives on page 108 for more infor-
mation.
Get Application
Click this button to get the application from a connected master module
instead of opening an application file. The application is transferred from the
master module to IQANrun and then opened so you can view it.
For more information see section Application on page 84.
Get Log
First, open or get an application. Then select the log you want to view in the
tree view below and click Get Log to get the log records from a connected
master module. The log is transferred from the master module to IQANrun
and then opened so you can view it.
For more information see section Logs on page 98.
Get Settings
First, open or get an application. Then click Get Settings to get the settings
from a connected master module. All settings are transferred from the master
module to IQANrun and then opened so you can view them.
For more information see section Settings on page 103.
Compare Settings
First, open or get an application. Then open or get settings for that application
and click Compare Settings. Select another settings file (irs) to compare with
the current settings.
For more information see section Compare settings on page 104.
Application
This node is used to view structure and flow of an application. Start by open-
ing an application file or to get an application from a connected master mod-
ule.
• To open a file, click Open in the main tool bar or File menu. The shortcut
key for Open is <Ctrl+O>. Select the application file you want to view and
click Open.
• To get the application from a master module, first select the View tab and
then click Get Application in the side tool bar or press <Shift+F11>.
If the application is protected by a password you will be asked to enter the
correct password to view it. Application passwords can also be stored in your
password database. By doing that, IQANrun will automatically enter the cor-
rect password when you open the application. See section Password database
on page 141 for more information.
The application is opened and the tree view on the side tool bar is filled with
information. At the top of the tree view, there is a node called Application.
Under this node, function group nodes are added. Click any of the nodes to
view the contents of its function group in the main panel.
You may not be able to see the Application node. Some applications require a
certain access level to allow viewing of the application structure. You can get
the correct access level by requesting a safe password with sufficient access
level for application viewing from the IQAN administrator at the OEM. See
section Safe passwords on page 144 for more information.
The Application node can also be disabled by a third party archive. Read sec-
tion Archives on page 108 for more information.
A function group contains channels and/or other function groups. The rela-
tions between them are illustrated with curved lines. Click one of the chan-
nels or function groups to get more information about it.
Property inspector
To the right of the main panel you will find the Property Inspector. The
inspector window can be hidden by clicking the dotted splitter at its left edge.
Resize the inspector by dragging the splitter instead of clicking it. The prop-
erty inspector displays detailed information about the currently selected com-
ponent. Each component has a number of properties that defines its behavior.
A property has a name and a value. The name is listed in the left column of
IQANrun User manual 86
Application
4 View
the property inspector and the value in the right column. At the bottom of the
property inspector there is a hint window that will help you with a detailed
explanation of the currently selected component or property. To select a prop-
erty, click its name in the property inspector.
Property inspector.
Function inspector
Below the main panel there is a panel called the Function Inspector. It will
list functions and objects for the currently selected channel when applicable.
Some channels have multiple functions. Each function will then be displayed
under its own tab in the function inspector. A function consists of two or three
groups of objects. Each object group is calculated separately using the
method displayed below its list of objects. Select an object to get detailed
information about it in the property inspector.
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.
sure on page 44). Then in a function group on the View tab select the channel
you want to add and right-click on it. Select Add to Measure Group and then
select the group you want to add it to from the menu shown.
NOTE
You must add the user defined measure group on the Online tab before you
can select it in a popup menu on the View tab. See section User defined mea-
sure groups on page 45.
Print
Print the current view by clicking Print in the main tool bar or by pressing
<Ctrl+P>.
Options
There are some options that control the user interface for function groups.
Draw reference lines Specifies how reference lines between components are
drawn.
Channels
This node lists all channels in an application. Start by opening an application
file or to get an application from a connected master module. See section
Application on page 84 for a detailed description on how to open an applica-
tion.
You may not be able to see the Channels node. Some applications require a
certain access level to allow viewing of channels. You can get the correct
access level by requesting a safe password with sufficient access level for
application viewing from the IQAN administrator at the OEM. See section
Safe passwords on page 144 for more information.
The Channels node can also be disabled by a third party archive. Read section
Archives on page 108 for more information.
Select the node Channels to view all channels in the current application.
Under the Channels node, a separate node for each channel type available in
the current application is created. This makes it easy to view for instance all
digital inputs in an application. Just click the node Digital in under Channels
to view only digital inputs in the list view.
The main panel contains a list view where channels are listed. The list has
seven columns. The list can be sorted in different ways by clicking the col-
umn header that you want to sort by. If you click the same header once more,
the sort order is reversed, from ascending to descending or vice versa.
You can quickly jump to a channel in the function group view to see its rela-
tions with other channels. Select the channel in the channel list and right-click
on it. In the popup menu, select Go To Channel. Focus is redirected to the
function group to which this channel belongs and the channel is selected. You
can also double-click on a channel in the channel list to perform the same
operation.
Property inspector
The property inspector is available to the right of this view. See section Prop-
erty inspector on page 86 for more information.
Function inspector
The function inspector is available at the bottom of this view. See section
Function inspector on page 87 for more information.
Measure
It is possible to measure all channel values and status by clicking Start Mea-
sure in the main tool bar, or by pressing <F7>. This operation requires a con-
nection to a master module.
Value and status are measured in real-time. The update speed depends on
what communication interface you use and how many channels you are view-
ing.
Click Stop Measure in the main tool bar or press <Shift+F7> to stop measur-
ing.
NOTE
You must add the user defined measure group on the Online tab before you
can select it in a popup menu on the View tab. See section User defined mea-
sure groups on page 45.
Print
Print the current view by clicking Print in the main tool bar or by pressing
<Ctrl+P>.
Modules
The Modules node is used to view modules, CAN buses and channel connec-
tions. Start by opening an application, see section Application on page 84.
NOTE
The Modules node can be disabled by a third party archive. Read section
Archives on page 108 for more information.
System overview
Select the node Modules to view the system overview. It will show all mod-
ules and CAN buses in the current application in a tree view. The tree view
structure represents how the modules are connected to each other via CAN
buses.
System overview.
Each module and CAN bus has its own symbol and name in the tree view.
Select a module or CAN bus to get detailed information about it in the prop-
erty inspector.
Block diagram
Under the Modules node there is one node per module in the current applica-
tion. Select a module node to view its block diagram. The block diagram
view displays all channels and their connections for the selected module.
Channels are displayed with name and index. If you hover with the mouse
over a channel index, its pin number is displayed in a small tool-tip window.
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 86 for more information.
Measure channels
It is possible to measure all channel values and status in the block diagram
view by clicking Start Measure in the main tool bar, or by pressing <F7>.
This operation requires a connection to a master module.
Click Stop Measure in the main tool bar or press <Shift+F7> to stop measur-
ing.
Print
Print the current view by clicking Print in the main tool bar or by pressing
<Ctrl+P>.
Logs
Use the node Logs to view logs in an application. First, you must open the
application. This is described in section Application on page 84.
NOTE
The Logs node can be disabled by a third party archive. Read section
Archives on page 108 for more information.
Select Logs in the tree view to view a list of logs in the current application.
The log list has four columns. The list can be sorted in different ways by
clicking the column header that you want to sort by. If you click the same
header once more, the sort order is reversed, form ascending to descending or
vice versa.
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 log. Select a log node to view
log items and records for that log. You will only be able to see those logs that
you have sufficient access rights to view. If you are missing one or more logs,
you need to request a safe password with sufficient access level for the logs
you want to view from the IQAN administrator at the OEM. See section Safe
passwords on page 144 for more information.
Log items
To view the log items in the selected log, select the tab named Items in the
main panel. A list of all log items is displayed. Use the property and function
inspectors to get detailed information about a log item. See section Property
inspector on page 86 and section Function inspector on page 87 for more
information on the inspectors.
Log items.
Log records
You can also view the records in a log by selecting the tab named Records.
This tab displays a record list. The list is initially empty. To fill it with infor-
mation you can either get the log contents from a connected master module or
open a previously saved log file.
To get a log from a master module, select a log node in the tree view to the
left and click Get Log in the side tool bar or press <Shift+F8>. All records in
the selected log are received from the master module. This may take a while
if you use a slow communication interface or if the log is very large. A prog-
ress bar is displayed to show you how much has been received.
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 application that the log belongs to before you can
open or get the log records. If you don’t have the correct application opened
you will get an error message when you try to open the log.
Save
Save the records in the list by clicking Save in the main tool bar or by press-
ing <Ctrl+S>. Log records can be saved in IQANrun format (irl), Microsoft
Excel Workbook format (xls), XML format or CSV format.
Print
Print the record list view by clicking Print in the main tool bar or by pressing
<Ctrl+P>.
Settings
The Settings node lists all settings in the current application that you have
access to view. The settings are presented in a tree list view, arranged by
channel type. Initially the tree list is empty. Start by opening an application,
see section Application on page 84. The tree list is now populated with all the
adjustable or stored channels in the application, but there are no settings val-
ues. To view the values, you need to open a settings file or get the settings
from a connected master module.
To open a settings file, click Open in the main tool bar or main menu or press
<Ctrl+O>. Select the settings file, extension irs, and click Open.
To get the settings from a connected master module, first select the View tab
and then click Get Settings in the side tool bar, keyboard shortcut is
<Shift+Ctrl+F12>.
NOTE
The Settings node can be disabled by a third party archive. Read section
Archives on page 108 for more information.
Some settings may require a higher access level to allow viewing. To get suf-
ficient access rights for the settings you need to see, request a safe password
with the required access level from the IQAN administrator at the OEM.
Above the tree list view there is a caption that displays the id for the machine
that the settings belong to.
NOTE
You must open or get the application that the settings belongs to before you
can open or get the settings. If you don’t have the correct application opened
you will get an error message when you try to open the settings.
You can quickly jump to a channel in the function group view to see its rela-
tions with other channels. Select the channel in the settings tree list view and
right-click on it. In the popup menu, select Go To Channel. Focus is redi-
rected to the function group to which this channel belongs and the channel is
selected.
Compare settings
To compare the current settings with the settings from another machine or
date, click Compare Settings in the side tool bar or press <Ctrl+F12>. An
open dialog box is displayed. Select the settings file from the other machine
or date and click Open. The file extension for settings files is irs.
A file compare form is opened. The two settings files are displayed in two
panes next to each other. The two panes scroll together. Lines that differ
IQANrun User manual 104
Settings
4 View
between the two files are marked in red. To the left there is a thumbnail view.
It represents each line of the comparison as a colored line, one pixel high. At
a glance you can see the pattern of differences throughout the comparison.
The white rectangle represents the main display's current view, and the small
triangle represents the display's current line. Click on a line in the thumbnail
to position the display at that location.
On the bottom of the display is the status area. It displays a summary of all
differences between the two files.
Compare settings.
There is also a small tool bar available with commands that will help you to
navigate in the file panes.
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 application, otherwise they can
not be compared. If they belong to different applications, an error message is
displayed.
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 appli-
cation files, but there is another file type that can be used here, the clone file.
A clone file contains an application, settings, machine id and logs.
When you open a clone file, you will get access to view a complete machine
at once. The entire tree view will be filled with information; application,
channels, modules, logs and settings.
NOTE
Log records are optional when you upload a clone file from a machine. If the
user that uploaded the clone file chose not to get logs, there will be no log
records available when you view the clone file.
To open a clone file, click Open in the main tool bar or main menu, or press
<Ctrl+O>. An open file dialog is displayed. Select the clone file and click
OK. Clone files have file extension irc.
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 with the Parker logotype. 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 112 are hyperlinks
that can be clicked on. Some of them will take you to another page in the
archive and others will open up web pages or documents in external pro-
grams.
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 Run script button to open a script file. An open file dialog appears.
Select the script file you want to use and click Open. Script files have the
extension ids. If the script file contains more than one script a list of the
scripts will be shown. Otherwise the script will be started directly.
The script list is shown if the script file contains more than one script.
When there are multiple scripts in the script file, select the script you want to
run in the list and click Select or double-click on the script. The script is
started.
Scripts usually display their own user instructions. Follow the on-screen
instructions and use the buttons Previous and Continue at the bottom to navi-
gate back and forward within the script.
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.
You can resize the list by dragging the splitter at the bottom.
Adjust
The adjust functionality in the scripts works in the same way as the adjust
function described in section Adjust item on page 38.
Set language
This function provides a drop down list where you can select the language to
use in the master module. The same language will also be used in the script if
it has been translated to the selected language.
Set 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 connected the PC with the IQAN system, a green status lamp
lights up in the IQANrun status bar to indicate that the connection is OK.
Note that with some interfaces, e.g. CAN or Simulator, you need to initiate a
communication operation before the status lamp turns green. You will also
need to do this for all interfaces after a connection has been manually discon-
nected.
NOTE
Only one IQAN program can be connected to the master module, if e.g.
IQANdesign is measuring and you perform an IQANrun operation using the
same interface, IQANdesign will automatically disconnect.
IQANrun User manual 129
Options
7 Communication
USB
The USB drivers are installed automatically the first time you connect a mas-
ter module to your PC.
ATTENTION
Make certain to use a USB isolator when using the USB port. Failure to do so
may result in damage to your PC's USB port(s). For more information, see the
instruction book for your master module.
CAN
To use CAN as communication device you need a CAN adapter attached to
your PC. For a list of supported CAN adapters, see the software data sheet or
contact Parker support. IQANrun can connect using the first available CAN
adapter or you can select a specific CAN adapter in the options dialog box.
When using CAN, please make sure there is no other traffic (ICP, SAE J1939,
etc) on the bus you are using for diagnostics, otherwise the functionality can
not be guaranteed.
If there are multiple master modules connected to the same CAN bus, you
will be asked which one you want to connect to when you start to communi-
cate.
ATTENTION
The CAN adapter must be installed and connected to the PC before the pro-
gram is started, otherwise it will not be detected.
Serial port
This requires a standard RS-232 serial port on your PC. Also select which
COM port to use.
Simulator
Select this device to communicate with IQANsimulate instead of a real mas-
ter module. IQANsimulate needs to be started on the same PC and running a
simulation for this communication to work.
The programs will communicate over a TCP/IP port. Port number defaults to
8325 in both IQANrun and IQANsimulate and should not be changed. If you
must change port number, make sure you use the same port in both programs.
Modem
Select a modem in the list. The modem you are planning to use must first be
installed by Windows. Follow the instructions provided by the modem manu-
facturer for more information on the installation procedure.
Internet settings
If you want to connect to a machine over internet and you require a proxy to
connect to internet it can be configured here. By default the system settings is
used, but you can also disable proxy for IQANdesign or use a custom setting.
Quick switch
On the Communication menu there is one menu item for each communication
interface; USB, Serial Port, Simulator, CAN, Internet and Modem. Select one
of the menu items to quickly switch to that communication interface without
having to open the options dialog box.
The currently selected interface is marked with a check box in the menu.
Communication menu.
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.
If there are multiple master modules connected to the remote CAN bus, you
will be asked which one you want to connect to when you start to communi-
cate.
NOTE
To be able to connect to the remote diagnostics server IQANrun uses TCP
port number 60100. This means that your firewall must allow for outgoing
connections on this port.
Disconnect
When your done, disconnect from the remote system using Communication >
Disconnect.
Modem connection
By connecting a modem to your PC, you can communicate with a remote
IQAN system that is equipped with an RS-232 modem. It is possible to
update applications, measure and do all the things you can do with a local
system.
Start by installing the modem to your PC, follow the installation instructions
that came with the modem. Select the modem you want to use in the IQAN-
run options dialog box under the Communications tab. Before attempting to
communicate with a remote system it is a good idea to verify that a modem is
connected to the remote system master.
Once communication is initiated the text in the dialog box will keep you
informed with the progress of the call: dialing, connecting, etc.
Abort transmission
If the connection has to be stopped, click Cancel.
Disconnect
When you are ready, disconnect the modem connection by selecting Commu-
nication > Disconnect.
Phone book
There is a simple phone book available to help you keep track of all your
machines and their phone numbers. Each record in the phone book stores
these fields:
• Name
• Company
• Machine id
• Location
• Phone number
• Comment
To access the phone book, select Communication > Connect via Modem....
The dialog box shown in the previous section (page 134) is displayed.
The contents of the phone book is displayed in the list view in the middle.
Each record is displayed on its own row and each field in a separate column.
You can sort the list by clicking the column header that corresponds the field
you want to sort on. Clicking the same column once more reverses the sort
order.
Add
To add a new record in the phone book, click the button Add. A new phone
book record dialog box appears.
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.
Choosing a modem
Here are some general guidelines we can offer. Remember, these are only
general guidelines. We have several modems in our lab that break one or
more of these guidelines and still work fine. We also have a couple of
modems that follow all the rules and are problematic.
The guidelines presented here concerns the modems you connect on your PC
side, not the modems you connect to the IQAN master module. For IQAN
modem recommendations, see Remote diagnostics, Catalogue HY17-8372/
UK.
though, so the first few batches of modems sporting a brand new feature often
aren't as reliable as subsequent batches will be.
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 Application on page 84 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 application id. Before you log in, IQANrun checks the
application id in the connected master module and lets you choose between
the users in the password database that have the same id. See section Login on
page 69 for a detailed description.
User name is displayed in comments.
Date restrictions
Passwords can be date restricted, which means they will only be valid until a
certain date. The date is displayed in the comment for date restricted pass-
words. When the valid date has been passed, the password will no longer
work.
ATTENTION
Please don’t try to change the clock in your PC to get around a date restric-
tion. The password manager will detect such attempts and lock the password
completely if necessary.
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 an application file or by
selecting a master module type. Select File > New > New to open an applica-
tion file and create a new simulation based on that application.
Select File > New > New Mxx to create an empty simulation based on the
master module type you select. Empty simulations does not contain an appli-
cation, but can still be useful in some situations.
Open
Opens a file and displays its content in the main panel.
.ida Application.
Reopen
Contains a list of the most recently used files. Select a file from the list to
open it again.
Save
Saves the current simulation to a file (with extension isa).
Save As
Saves the current simulation to a new file with another name or location than
the present.
Close
Close the currently opened simulation file.
Update Application
Update the application file in the currently open simulation file.
Exit
Quits IQANsimulate.
Edit
Contains the usual edit commands Cut, Copy, Paste, Delete and Rename.
There is also the command Go To Channel that will jump to the channel that
the currently selected component references to.
Simulate
Commands to control the status of the simulator, see section Simulators on
page 179 for more information.
View
Lets you view or hide the different panels IQANsimulate uses; Application
Manager and Property Inspector.
Use Refresh to update the current form in the main panel.
Tools
Contains common tools menu items.
Options
Lets you customize the user interface and behavior of IQANsimulate. See
section Options on page 153.
Password Manager
Opens the password manager, see section Password database on page 189 for
more information.
Help
Contains common help menu items.
Contents
Will bring up the help file, which is this book as a PDF document.
Release Notes
Displays release notes for the version of IQANsimulate 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
company IQANsimulate 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 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 IQANrun.
Other options.
File association
Lets you associate IQANsimulate with application files. If the button is dis-
abled, IQANsimulate is already associated with application files. Associating
IQANsimulate with application files means that if you double-click such a
file in Windows Explorer for instance, IQANsimulate will start and open that
file.
NOTE
Changing file associations on Windows Vista requires administrator privi-
leges.
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
Simulator Screen Shot Save the current simulator window as a bitmap file
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 an application contains is decided
based on the functionality in the machine. The modules are designed with dif-
ferent mixes of inputs and outputs to suit different machine applications.
The master is the central unit in the system. All communication is routed
through the master. It also contains all non-module specific channels such as
PID regulators, counters and math channels. All calculations take place in the
master and there can only be one master in an IQAN system.
The master communicates with modules via CAN-buses (Controller Area
Network) either ICP (IQAN CAN Protocol), SAE J1939 or Generic CAN.
For further information about different module types see information in the
respective data sheets and instruction books.
Channels
A channel can either be an input, output or an internal channel. The internal
channels are not physical channels like the inputs and output. They are only
handled by the master internally.
All channels have different properties such as name, scaling, alarms, delays,
filter, etc. The properties are unique for each channel type. The internal
channels are used to create functionality. For example, if you want to control
the boom, count events, start a timer or control the speed on a diesel engine.
Most of the internal channels have both properties and one or many functions.
Input channel
Simulation
In IQANsimulate you can simulate all input channels and the status of current
outputs and all modules in an application. Input channels are simulated with
the help of sliders in the function group view or in simulation groups. Current
outputs are simulated using a popup menu in the function group or module
view. Module status can be set in the system overview form.
Add simulation groups with input channels to make it easy to simulate input
values to your application, such as temperatures, pressures and speeds. A
simulation group consists of one or more channels. For each channel there is
a slider and an edit box that will let you control the channel’s value.
With simulation groups you can group your channels anyway you like. A
simulation group can contain as many channels as you like, and there is no
limit of how many groups you can add.
While simulating input values you can measure all channel and object values.
You can also check your graphical user interface and simulate user inter-
activity on the master display, if available.
Simulation files
A simulation contains an application, simulation groups and channel values.
To open a file, click Open in the main tool bar or File menu. The shortcut key
is <Ctrl+O>. Select the file you like and click Open. Simulation files have the
extension isa.
If the file is protected by a password you will be asked to enter the correct
password to open it. Application passwords can be stored in your password
database. By doing that, IQANsimulate will automatically enter the correct
password when you open the file. See section Password database on page
189 for more information.
You can also open application files (extension ida). This will create a simula-
tion file without any simulation groups, unless the application file is old and
contains simulation groups. You will then be given the option to import the
simulation groups.
Application manager
The Application Manager is the tree view on the left side of the main panel. It
contains four root nodes:
• Simulation groups
• Application
• Channels
• Modules
Each root node displays different information for the currently opened simu-
lation file. Depending on how a file is protected, all nodes may not be visible.
For detailed information on each root node, see the following chapters.
Application manager.
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 application
manager can be used to access all simulation controls in a simulation file.
Simulation groups
To create a simulation group right click on Simulation groups in the applica-
tion manager and select Add Simulation Group in the popup menu, or select
Application > Add > Add Simulation Group. Enter a name for the new simu-
lation group in the property inspector. To add channels to the simulation
group, simply drag and drop the channels from the editor to your simulator
group. For each channel you add, a simulation item is created.
Simulation items
A simulation item controls a channel value, either through another channel’s
value or through manual control in the form of a slider and an edit box.
Manual control
When simulating, if it uses manual control, the selected simulation item will
have a slider and an edit box that enables you to specify the input value for
the channel that the simulation item controls. The value can be scaled or raw.
Scaled value gets its unit by the channel properties. Typical units for scaled
value are; %, °C and bar.
Raw value on the other hand depends on the channel type. Voltage inputs use
mV, and frequency inputs use Hz as raw value. By using raw value, you can
control the full range of the input, and thereby generate input errors by setting
an input value outside the valid range for the channel. Scaled value input is
limited to the channel’s valid range.
Enable raw value input by selecting Simulate > Raw Value Range. This set-
ting can also be accessed in the main tool bar or by right-clicking in the main
panel for simulation groups.
IQANsimulate User manual 165
Simulation groups
10 Application simulation
Drag the slider or enter a value in the edit box to set an input value for a chan-
nel. When the slider is focused, you can use the keyboard to control it.
<Ctrl+Left> and <Ctrl+Right> moves it in small steps and <PgUp>/<PgDn>
in larger steps. Pressing <Space> will move the slider to its maximum posi-
tion (max scaled value) and then back to zero when released. <Shift+Space>
does the same but in negative direction when applicable. This is useful to
simulate a full stroke for a lever for instance.
If you use the edit box to set the input value, press <Enter> when you are fin-
ished typing the input value to set it.
Automatic control
When controlling the value automatically, a second channel is connected to
the simulation item. The value of that channel controls the value of the
simulated channel. Typically, you use a math channel for this.
EXAMPLE
To simulate a crane function, for example the boom, use a math channel to
do some calculations based on the current output controlling the boom.
The math channel calculates the boom position. The simulated channel is
the voltage input for the boom position sensor. Now you can do closed
loop simulation of the boom.
The track bar and the edit box are disabled when a simulation item uses a
control channel. Select Manual control to control the simulation item
manually using the track bar or the edit box.
Properties
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.
Application
This node is used to view structure and flow of an application. Under this
node, function group nodes are added. Click any of the nodes to view the con-
tents of its function group in the main panel.
NOTE
You may not be able to see the Application node. Some applications require a
certain access level to allow viewing of the application structure. You can get
the correct access level by requesting a safe password with sufficient access
level for application viewing from the IQAN administrator at the OEM. See
section Safe passwords on page 192 for more information.
Function groups
A function group contains channels and/or other function groups. The rela-
tions between them are illustrated with curved lines. Click one of the chan-
nels or function groups to get more information about it.
Application view.
Simulate
You can simulate the value of input channels, adjustable channels and stored
channels. Status can be simulated for current outputs, parameter group inputs
and generic frame inputs.
Input channels
Input channel types that can be simulated are voltage input, digital inputs, fre-
quency inputs, directional frequency inputs, directional analog channels,
parameter inputs and SPN channels.
IQANsimulate User manual 169
Application
10 Application simulation
When a simulation is running, the selected input channel will have a slider
that you can use to simulate its input value. Drag the slider to change the
input value. Press <Ctrl+Left> and <Ctrl+Right> to change the value in small
steps using the keyboard. <PgUp>/<PgDn> changes it in larger steps.
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 application in IQANsimulate. Use
IQANdesign if you need to do that.
To show the property inspector, click on the dotted splitter on the right edge
of the main panel, or select View > Property Inspector.
Options
There are some options that control the user interface for function groups.
Draw reference lines Specifies how reference lines between components are
drawn.
Channels
This node lists all channels in an application.
NOTE
You may not be able to see the Channels node. Some applications require a
certain access level to allow viewing of channels. You can get the correct
access level by requesting a safe password with sufficient access level for
application viewing from the IQAN administrator at the OEM. See section
Safe passwords on page 192 for more information.
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.
Modules
The Modules node is used to view modules, CAN buses and channel connec-
tions.
System overview
Select the node Modules to view the system overview. It will show all mod-
ules and CAN buses in the current application in a tree view. The tree view
structure represents how the modules are connected to each other via CAN
buses.
System overview.
Each module and CAN bus has its own symbol and name in the tree view.
Select a module or CAN bus to get detailed information about it in the prop-
erty inspector.
Block diagram
Under the Modules node there is one node per module in the current applica-
tion. Select a module node to view its block diagram. The block diagram
view displays all channels and their connections for the selected module.
Channels are displayed with name and index. If you hover with the mouse
over a channel index, its pin number is displayed in a small tool-tip window.
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 selecting a status in the drop
down list next to each module in the system overview. There are a lot of dif-
ferent status values to choose from, such as OK, High temperature, Low sup-
ply voltage or No contact. Each module type has its own unique set ot status
values.
Input channel values can be simulated by using the sliders on the channel
controls in the block diagram. Raw value simulation can be used in the same
way as for the function group view.
Measure
Channel value and status is measured in real-time when a simulation is run-
ning.
Property inspector
The property inspector can be displayed to show properties for the selected
component. All property values are read-only, since you aren’t allowed to
change the application in IQANsimulate. Use IQANdesign if you need to do
that.
The simulator is a very useful tool that helps to assure the functionality of
your application before you download the file to the master. It is also very
easy to check a function if you are unsure of its behavior.
Another benefit is that if your application contains a display module you
don’t have to download your application file to check your display pages, dis-
play controls or menu system. The application file will appear exactly the
same way in the simulator as in the real master module. Use the mouse to
click on the display buttons or to turn the jog shuttle.
Simulator
Every master module has its own simulator. The simulator uses the same soft-
ware as the real master module. In addition to the master module software it
contains some extra features, such as expansion module simulation and SMS
simulation.
It will simulate all internal functions such as I/O handling, math calculations,
logs, communication and settings. If the master module has a display it will
also simulate the graphical presentation of display pages and receive input in
the form of button clicks.
IQANsimulate will automatically select the correct simulator type and ver-
sion depending on which simulation or application you use. To start the simu-
lator select Simulate > Run, or press <F9>. Before the simulator starts to run,
the application file will be checked for errors. You will be notified about the
status if there are any errors. If there are no errors, the current application will
start to run in the simulator.
The simulation file will be saved before the simulation starts. The save is
automatic unless you have disabled that option in the IQANsimulate options
dialog box.
If the correct simulator type and/or version that you are trying to start is not
installed on your computer, you will be asked if you would like to download
it from Parker’s web site. Click Yes to download it. When it has been down-
loaded, IQANsimulate will install it for you and then start the simulation.
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.
Deselect option Show simulator window on tab Appearance in the options
IQANsimulate User manual 181
Simulator display
11 Simulators
dialog box. This option can also be reached by selecting Simulate > Show
Simulator or clicking the Show Simulator button in the main tool bar. Short-
cut key is <Shift+F12>.
Keyboard shortcuts
You can use the keyboard to control the simulator buttons if you like.
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.
Application update
If the application is updated from an external source, for example IQANrun,
while the simulator is running, IQANsimulate will open the new application
and restart the simulator. When opening the new application, IQANsimulate
will try to preserve any simulation groups and items. If there are any unsaved
changes in the currently open file, you will be asked whether you want to
save those changes or not before the new application is loaded.
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 168 for more information on
locked components.
Login
Not used in IQANsimulate.
Date restrictions
Passwords can be date restricted, which means they will only be valid until a
certain date. The date is displayed in the comment for date restricted pass-
words. When the valid date has been passed, the password will no longer
work.
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.