® AzeoTech DAQFactory® DAQFactory User's Guide DAQFactory User's Guide DAQFactory for Windows, Version 5.86, Tuesday, September 20, 2011: Copyright © 2001-2011 AzeoTech, Inc All rights reserved worldwide Information in this document is subject to change without notice AzeoTech is a registered trademark of AzeoTech, Inc DAQFactory is a registered trademark of AzeoTech, Inc Other brand and product names are trademarks of their respective holders This manual: Copyright © 2011 AzeoTech, Inc All rights reserved worldwide No portion of this manual may be copied, modified, translated, or reduced into machine-readable form without the prior written consent of AzeoTech, Inc Contents Table of Contents Introducing DAQFactory 15 1.1 End User License Agreement 15 1.2 Acknowledgements 18 1.3 Welcome to DAQFactory 19 1.4 System Requirements 19 1.5 DAQFactory Performance 20 1.6 Licensing DAQFactory 21 1.7 Moving a license 22 1.8 Using the hardware key option 23 1.9 Upgrading to a different version of DAQFactory 23 1.10 For users of earlier versions of DAQFactory 24 1.11 DAQFactory's User Interface 25 1.12 DAQFactory Objects 27 32 Guided Tour 2.1 Tour Overview 32 2.2 Tour Assumptions 32 2.3 Tour Terminology 32 2.4 Starting DAQFactory 32 2.5 Creating Channels 32 2.6 Displaying the Data 35 2.7 Graphing the data 39 2.8 Controlling an output 44 2.9 Logging Data 46 2.10 Viewing Data on the Web 48 The DAQFactory Document 53 3.1 Document Overview 53 3.2 Starting a new document 53 3.3 Saving a document 53 3.4 Saving with History 53 3.5 Opening a document 54 3.6 Safe mode 54 3.7 Autoloading a document 55 3.8 Document settings 55 © 2011 AzeoTech, Inc DAQFactory User's Guide 59 Expressions 4.1 Expressions Overview 59 4.2 Using expressions 59 4.3 The command line interface 59 4.4 The big expression window 60 4.5 Arrays 61 4.6 Subsetting 62 4.7 Strings 63 4.8 Entering hex and binary constants 63 4.9 Entering in constant time values 64 4.10 Object variables and functions 64 4.11 Specifying Connections in Expressions 65 4.12 Expression Operator / Function Reference 65 4.12.1 Order of operations 4.12.2 Boolean operators 4.12.3 Math operators 4.12.4 Bitwise operators and functions 4.12.5 Math functions 4.12.6 Trigometric functions 4.12.7 Statistical functions 4.12.8 Boxcar averaging and smoothing functions 4.12.9 String functions 4.12.10 Byte conversions 4.12.11 Time functions 4.12.12 Array creation and manipulation functions 4.12.13 Random Number functions 4.12.14 Thermocouple conversion functions 4.12.15 Misc functions 4.12.16 Constants 4.12.17 Advanced Analysis functions 65 66 66 67 68 69 70 71 72 78 82 85 86 87 87 87 89 4.13 Questions, Answers and Examples 90 4.13.1 Converting a string to DAQFactory time 4.13.2 Calcing the max for a period of the day 4.13.3 A trick to avoid divide by and other boolean tricks 4.13.4 Doing things on the hour 4.13.5 Counting digital transitions 4.13.6 Calculating the current second / minute / hour Sequences & Scripting 90 91 92 93 95 95 98 5.1 Sequence Overview 98 5.2 Creating a New Sequence 98 5.3 Starting and Stopping a Sequence 100 5.4 The most basic sequence and assignment 100 5.5 More advanced assignment operators and the arraystep statement 100 5.6 Reading inputs with the read statement and process control loops 101 © 2011 AzeoTech, Inc Contents 5.7 Programmatically starting and stopping things 103 5.8 Timed sequences and the goto statement 104 5.9 Waiting in a sequence 105 5.10 Variables 108 5.11 Private sequence variables 112 5.12 Conditional branching with the if statement 113 5.13 Replacing multiple ifs with a switch statement 114 5.14 Sequence looping with the while statement 115 5.15 Looping while counting with the for statement 115 5.16 Avoiding being hanged using the infinite loop check 116 5.17 Using sequences as functions 117 5.18 Running commands in a string with the execute function 118 5.19 Error handling with try/catch 119 5.21 Sequence Threads and Thread Priority 121 5.22 Auto-Start 122 5.23 Sequence debugging 122 5.24 Printing to the Command / Alert window 122 5.25 Watch window 123 5.26 Sequence Functions 123 5.27 System Functions 124 5.28 System Events 127 5.29 Questions, Answers and Examples 129 5.29.1 Misc sequence comments 5.29.2 Array manipulation 5.29.3 Start a sequence on the second Channels and Conversions 129 130 132 134 6.1 Channel and Conversion Overview 134 6.2 Channels and the Channel Table 134 6.3 Channel Import and Export 137 6.4 Channel History and Persistence 137 6.5 Channel Groups 139 6.6 Device Configurator 140 6.7 The Channel View 140 6.8 Fine Tuning Data Acquisition 140 6.9 Channel Functions and Variables 143 6.10 Channel List Functions 145 6.11 Conversions and the Conversion Table 146 6.12 V Channels 147 6.13 Questions, Answers and Examples 148 6.13.1 Oversampling a channel (averaging) 148 © 2011 AzeoTech, Inc DAQFactory User's Guide 6.13.2 Creating Conversions for input channels 6.13.3 AddValue() and Conversions 6.13.4 Applying a deadband to a channel Pages and Components 148 149 149 151 7.1 Page and Component Overview 151 7.2 Adding Components to Pages 151 7.3 Arranging Components on the Page 151 7.4 Edit mode 152 7.5 Grouping Components 153 7.6 Creating User Components 153 7.7 Using the Grid and Movement Lock 154 7.8 Component Find and Replace 154 7.9 Multiple Pages and Page Properties 154 7.10 Creating Popups 155 7.11 Full screen mode 156 7.12 Creating multi-lingual applications 157 7.13 Printing Pages 159 7.14 Page Functions 159 7.15 Component Names 161 7.16 Component Properties and Events 162 7.17 Component Actions 164 7.18 The Components 165 7.18.1 Static 7.18.1.1 Text Component 7.18.1.2 Panel Component 7.18.2 Displays 7.18.2.1 Variable Value Component 7.18.2.2 Descriptive Text Component 7.18.2.3 Symbol Component 7.18.2.4 The Color Property Page 7.18.2.5 The Size Property Page 7.18.2.6 Table Component 7.18.2.7 Canvas Component 7.18.2.8 LED Components 7.18.2.9 Progress Bar Component 7.18.3 Gauges 7.18.3.1 Linear Gauge and Log Gauge Component 7.18.3.2 Angular Gauge and Angular Log Gauge Component 7.18.3.3 LED Bar Gauge Component 7.18.4 Compasses 7.18.4.1 Compass Component 7.18.4.2 Dual Compass Component 7.18.5 Percent 7.18.5.1 Percent Bar and Pie Chart Component 7.18.6 Graphs 7.18.6.1 2D Graph Component 165 165 166 166 166 167 168 170 171 172 173 177 177 177 177 179 182 183 183 184 185 185 187 187 © 2011 AzeoTech, Inc Contents 7.18.6.2 3D Graph Component 7.18.6.3 Image Component 7.18.6.4 Spectrum Display Component 7.18.7 Buttons_&_Switches 7.18.7.1 Button Component 7.18.7.2 Check Box Component 7.18.7.3 Spin Button Component 7.18.7.4 Lever Switch Component 7.18.7.5 Rocker Switch Component 7.18.7.6 Toggle Switch Component 7.18.7.7 Valve Component 7.18.7.8 Three Way Rocker Component 7.18.7.9 Four Way Switch Component 7.18.8 Edit_Controls 7.18.8.1 Edit Box, Password Edit, and Multiline Edit Box Component 7.18.8.2 Date & Time Edit Component 7.18.9 Selection 7.18.9.1 Combo Box and Radio Buttons Components 7.18.9.2 Tree List Component 7.18.10 Sliders_&_Knobs 7.18.10.1 Knob Component 7.18.10.2 Slider Component 7.18.10.3 Scroll Bar Component 187 188 188 189 189 189 190 190 191 191 192 192 193 193 193 195 196 196 197 197 197 200 202 7.19 Questions, Answers and Examples 202 7.19.1 Displaying a different symbol based on a value 7.19.2 Using a password to protect pages 7.19.3 Create a popup for user name and password 7.19.4 Create a popup numeric keypad Graphing and Trending 202 203 204 206 210 8.1 Graph Overview 210 8.2 Creating a Value vs Time (Trend) graph 210 8.3 Graph scaling, zooming, and panning 211 8.4 Adding more traces to the graph 212 8.5 Multiple Axes 212 8.6 Colorizing Traces 213 8.7 Error Bars 213 8.8 Wind barbs 214 8.9 Axis and Line annotations 214 8.10 Other graph properties 215 8.11 X vs Y graphs 216 8.12 Advanced graphing 217 8.13 Graph variables and functions 218 Data Logging and Exporting 222 9.1 Data Logging Overview 222 9.2 Creating a logging set 222 © 2011 AzeoTech, Inc DAQFactory User's Guide 9.3 Logging Notes and Alerts 224 9.4 ODBC Database logging 225 9.5 Reading from an ODBC Database 227 9.6 Binary logging 229 9.7 Export Sets 229 9.8 Logging / Export Set Functions 230 9.9 Direct file access 232 9.10 Questions, Answers and Examples 235 9.10.1 Write data to a file from a sequence 9.10.2 Read a file and set an output channel from its data 9.10.3 DAQFactory / Excel Time 9.10.4 Logging on an event 9.10.5 Changing the logging file name every month 9.10.6 Changing the logging file name every day 235 237 239 239 239 240 243 10 PID Loops 10.1 PID Overview 243 10.2 Creating a new PID loop 243 10.3 Autotuning 245 10.4 PID Event 245 10.5 PID Variables and Functions 246 10.6 Questions, Answers and Examples 247 10.6.1 PID Algorithm? 247 249 11 Alarming 11.1 Alarming Overview 249 11.2 Creating a new alarm 249 11.3 Alarm Summary View 250 11.4 Alarm Logging 250 11.5 Alarm Variables and Functions 251 11.6 Questions, Answers and Examples 253 11.6.1 Basic Alarming 12 Networking / Connectivity 253 257 12.1 Networking overview 257 12.2 Real time Web with DAQConnect 257 12.3 Email - SMTP outgoing 259 12.4 Email - POP3 incoming 260 12.5 FTP 262 12.6 Voice Modem / AutoDialer (TAPI) 262 12.7 Connecting to a remote copy of DAQFactory 265 12.8 Internal Web Server (deprecated) 267 © 2011 AzeoTech, Inc Contents 12.10 Using DDE to transfer data to other windows applications 267 270 13 Analysis 13.1 Analysis overview 270 13.2 Analysis Tools 270 13.3 Capturing Channels and Graphs 270 13.4 General Statistics 271 13.5 Curve Fitting 271 13.6 Correlation and convolution 272 13.7 Histogram 272 13.8 Interpolation 273 13.9 Percentile 273 13.10 FFT 273 14 Other Features 276 14.1 Startup Flags 276 14.2 Preferences 276 14.3 Alerts 277 14.4 Quick Notes 277 14.5 Customizing 278 14.6 DAQFactory Runtime 278 14.7 Acquire mode 280 14.8 User defined time reference 281 15 Extending DAQFactory 283 15.1 Calling an External DLL 283 15.1.1 External DLL Overview 15.1.2 Loading the DLL and declaring the functions 15.1.3 The Function Prototype 15.1.4 Calling the External Function 283 283 284 285 15.2 User Devices 285 15.2.1 User Device Overview 15.2.2 Creating your own device 15.2.3 Local Variables 16 Serial and Ethernet Communications 285 286 287 289 16.1 DAQFactory Communications Overview 289 16.2 Creating a Comm Device 289 16.3 The Comm Protocol 290 16.4 Using Comm Devices 291 16.5 Monitoring and Debugging Communications 292 16.6 Low Level Comm 293 © 2011 AzeoTech, Inc 10 DAQFactory User's Guide 16.7 Low Level Comm Syncronization 294 16.8 User Comm Protocols 295 16.9 Predefined Protocols 296 16.9.1 Allen Bradley DF1 protocol 16.9.2 DataForth isoLynx protocol 16.9.3 Mitsubishi A/Q protocol 16.9.4 Mitsubishi FX direct serial protocol 16.9.5 ModbusTCP/RTU/ASCII Master protocols 16.9.6 ModbusTCP/RTU/ASCII Slave protocol 296 303 304 305 307 310 312 17 Devices 17.1 Device Overview 312 17.2 Device Functions 312 17.3 Acces I/O Device 312 17.4 Diamond Systems device 316 17.5 DDE Client device 320 17.6 ICP-DAS i7000 320 17.7 LabJack UE9 / U6 / U3 322 17.8 LabJack U12 device 324 17.9 Measurement Computing / Computerboards device 329 17.10 National Instruments NI435x device 330 17.11 National Instruments NIDAQ device 331 17.12 OPC device 331 17.13 RFScada device 333 17.14 Sensoray SmartAD device 335 17.15 Test device 336 17.16 TriLogi device 337 18 Error Code Reference 340 C1000 340 C1001 340 C1002 340 C1003 340 C1004 340 C1005 340 C1006 341 C1007 341 C1008 341 C1009 341 C1010 341 C1011 341 C1012 341 © 2011 AzeoTech, Inc ... Introducing DAQFactory1 .1 End User License Agreement 16 DAQFactory User's Guide different version of DAQFactory is subject to Section II(C) below Upon payment for a non-Express version of DAQFactory, ... same way: · DAQFactory. exe: Since DAQFactory Acquire is now part of DAQFactory Control, we have simply named the program DAQFactory and changed the executable from Control.exe to DAQFactory. exe... different version of DAQFactory 23 1.10 For users of earlier versions of DAQFactory 24 1.11 DAQFactory' s User Interface 25 1.12 DAQFactory Objects