Error Code Listing
Contents
1. 7 SLX200 LabVIEW VI Library gt DATAFORTH isoLynx SLX200 LabVIEW VI Library Manual isoLynx SLX200 LabVIEW VI Library User Manual MA1028 Rev A March 2007 The information in this manual has been checked carefully and is believed to be accurate however Dataforth assumes no responsibility for possible inaccuracies or omissions Specifications are subject to change without notice 2007 Dataforth Corporation All rights reserved isoLynx is a trademark of Dataforth Corporation Microsoft Windows Windows XP Visual Studio Visual C Visual Basic and Visual C are trademarks or registered trademarks of Microsoft Corporation LabVIEW CVI National Instruments and ni com are trademarks or registered trademarks of National Instruments Corporation Revision History Revision Date Author Description of Changes 3 8 07 Initial release B 3 13 07 isoLynx SLX200 LabVIEW VI Library User Manual Table of Contents 2 3 4 MOCO e 1 1 2s Related 1 1 52 Files Required to Use the SLX200 LabVIEW 2 aN OU ECL IRM ONY sepa E 3 2 Rt Reto ce PI eR ed One ER On Oe 3 2 2 Channel Numbers vicincessconcsscaiatssvsdancadcaaase sa reverat2. opening VI The user should not change the handle s value A port must be opened before making the call to open a device 4 1 1 Open SLX RTU Port Open SLX RTU Port vi Opens a Modbus RTU port with the given communication parameters Connector Pane pork name COMI baud 19200 parity Even error in no error pork handle error out Controls and Indicators ig error in no error is cluster that describes error conditions occurring before the executes If an error has already occurred the VI passes the value of the error in cluster to error out status is TRUE if an error occurred prior to the execution of this VI If status is TRUE the VI does not do anything other than pass error in information to error out 5528 code is the error code number identifying an error or warning A value of 0 indicates no error a negative value indicates a warning and a positive value indicates an error H source identifies the name of the VI that produced the error port name COM1 is a string indicating the serial port name e g COM1 COM2 etc baud 19200 is the desired communication rate Allowed values are 1200 2400 4800 9600 19200 38400 57600 and 115200 parity Even is the desired serial parity error out is a cluster that contains error information If the error in cluster indicated an error the error out cluster contains the same information Otherwise error out describes the error s
3. a user written LabVIEW VI as shown in Figure 1 1 The VI library is built on top of the dynamic link library The VI library contains only a subset of the functions available from This subset enables basic open connect status and I O operations Configuration of an isoLynx SLX200 15 not possible with the LabVIEW VI library but can be accomplished by using the SlxConfig application supplied the Three versions of the library are provided slxcom_lv_6 1 lllb slxcom_lIv_7 0 Illb slxcom_Iv_8 0 Illb one for each of LabVIEW versions 6 1 7 0 and 8 0 and above LabVIEW versions prior to 6 1 are not supported LabVIEW 70 workstation 7 0 LabVIEW 6 1 VI LabVIEW 8 0 VI 6 1 16 8 0 Serial or Ethernet connection slxcom dll ee oe Figure 1 1 SLX200 LabVIEW VI Library block diagram 1 2 Related Documentation This document should be used in conjunction with the SLX200 API User Manual and the SLX200 Software User Manual These manuals are on the CD that ships with the SLX200 and is also available by download from the Dataforth web site isoLynx SLX200 LabVIEW VI Library User Manual 1 3 Files Required to Use the SLX200 LabVIEW Library the dynamic link library the VI Library makes calls to This file must be available to your by either being in the same folder else in the current environme
4. handle chan data error in no errors dey handle error out Controls and Indicators error in no error is a cluster that describes error conditions occurring before the VI executes If an error has already occurred the VI passes the value of the error in cluster to error out status is TRUE if an error occurred prior to the execution of this VI If status is TRUE the VI does not do anything other than pass error in information to error out 5528 code is the error code number identifying an error or warning A value of 0 indicates no error a negative value indicates a warning and a positive value indicates an error Le source identifies the name of the VI that produced the error dev handle is a handle to an isoLynx SLX200 system Wire this input to the handle obtained from the Open SLX Device VI us chan is the channel ID of the first channel of a group of consecutive digital channels to write to The quantity of channels written is equal to the size of the data array input data is an array of boolean values to write to the isoLynx SLX200 system 24 data type current has only one valid value Current for digital data It is safe to leave this terminal unwired error out is a cluster that contains error information If the error in cluster indicated an error the error out cluster contains the same information Otherwise error out describes the error status of this VI dev handle is a duplicate
5. to most industrial sensors and protect valuable measurement and control signals and equipment from the dangerous and degrading effects of noise transient power surges internal ground loops and other hazards present in industrial environments Dataforth spans the globe with over 50 International Distributors and US Representative Companies Our customers benefit from a team of over 130 sales people highly trained in the application of precision products for industrial markets In addition we have a team of application engineers in our Tucson factory ready to address and solve any in depth application questions Upon receipt of a quote or order our Customer Service Department provides fast one day response of delivery information We maintain inventory that allows small quantity orders to be shipped from stock Contacting Dataforth Corporation Contact Method Contact Information E Mail Technical Support techinfo dataforth com Website www dataforth com Phone 520 704 1404 or 800 444 7644 Fax 520 741 1404 Mail Dataforth Corporation 3331 Hemisphere Loop Tucson AZ 85706 Errata Sheets Refer to the Technical Support area of Dataforth s web site www datatorth com for any errata information on this product isoLynx SLX200 LabVIEW VI Library User Manual yi 1 Introduction 1 1 Overview This manual describes the SLX200 LabVIEW VI Library which allows a user to access the functions of the SLX200 from
6. andle obtained in step 1 See the example VIs on the CD which demonstrate how to do these steps 2 2 Channel Numbers The SLX200 is a single board system with optional expansion panels for additional digital and analog channels You can calculate a channel number based on the backpanel s assigned address and the channel s position the backpanel as illustrated in the annotated block diagram below Channel numbers start at zero for either digital or analog and go up through the maximum number available 63 is the highest analog channel using the maximum of three analog expansion panels and 127 is the highest digital channel using the maximum of eight digital panels Each panel whether analog or digital may contain up to 16 channels The exception is the main base SLX200 panel which has only 12 channels numbered 0 11 A fully populated SLX200 system is shown below in Figure 2 1 isoLynx SLX200 LabVIEW VI Library User Manual Digital Cable Communication 12 Ch Analog Base System 16 Ch Digital 1 Jumpers on all J1 i positions make this 000000 digital panel 0 digital channels 0 15 Jumpers on J1 pins 3 A jumper across EL E2 Lb Ik Aandi 0 make ths position 1 makes this 1 2 3 1 digital panel 1 digital expansion panel 1 channels 16 31 analog channels 16 31 i A jumper across E1 E2 position 2 makes this expansion panel 2 analog channels 32 47 16 Ch Digital 8 A jumper acro
7. btained from the Open SLX RTU Port or Open SLX TCP Port VIs error out is a cluster that contains error information If the error in cluster indicated an error the error out cluster contains the same information Otherwise error out describes the error status of this VI dev handle is a handle to an isoLynx SLX200 system This output should be wired to the identically named input terminals of other isoLynx SLX200 Vis 4 2 2 Close SLX Device Close SLX Device vi Closes an open isoLynx SLX200 device handle The device handle is opened by a call to Open SLX Device vi Connector Pane dey handle error in no error error auc Controls and Indicators error in no error is a cluster that describes error conditions occurring before the VI executes If an error has already occurred the VI passes the value of the error in cluster to error out status is TRUE if an error occurred prior to the execution of this VI If status is TRUE the VI does not do anything other than pass error in information to error out 5528 code is the error code number identifying an error or warning A value of 0 indicates no error a negative value indicates a warning and a positive value indicates an error Le source identifies the name of the VI that produced the error dev handle is a handle to an isoLynx SLX200 system Wire this input to the handle obtained from the Open SLX Device VI error out is a cluster that contains err
8. e analog channels to write to The quantity of channels written is equal to the size of the counts array input counts is an array of signed 16 bit values to write to the isoLynx SLX200 system The data is in two s complement format where 32767 hex 7FFF corresponds to 10 volts and 32768 hex 8000 corresponds to 10 volts error out is a cluster that contains error information If the error in cluster indicated an error the error out cluster contains the same information Otherwise error out describes the error status of this VI dev handle is a duplicate of the handle passed into the identically named input terminal This output can be wired to the identically named input terminals of other isoLynx SLX200 VIs 4 3 3 Read Digital Data Read Digital Data vi Reads digital data from the requested channel s on an isoLynx SLX200 system The device handle is obtained by a call to Open SLX Device vi Connector Pane data type current dey handle chan qty error in no error dey handle Error Controls and Indicators error in no error is a cluster that describes error conditions occurring before the VI executes If an error has already occurred the VI passes the value of the error in cluster to error out status is TRUE if an error occurred prior to the execution of this VI If status is TRUE the VI does not do anything other than pass error in information to error out 5528 code is th
9. e error code number identifying an error or warning A value of 0 indicates no error a negative value indicates a warning and a positive value indicates an error 5258 source identifies the name of the VI that produced the error 24 dev handle is a handle to isoLynx SLX200 system Wire this input the handle obtained from the Open SLX Device VI us chan is the channel ID of the first channel of a group of consecutive digital channels to read from sj qty Is the number of consecutive digital channels to read starting at the channel ID given In chan 24 data type current has only one valid value Current for digital data It is safe to leave this terminal unwired error out is a cluster that contains error information If the error in cluster indicated an error the error out cluster contains the same information Otherwise error out describes the error status of this VI dev handle is a duplicate of the handle passed into the identically named input terminal This output can be wired to the identically named input terminals of other isoLynx SLX200 VIs fTF data is an array of boolean values read from the isoLynx SLX200 system 15 isoLynx SLX200 LabVIEW VI Library User Manual 4 3 4 Write Digital Data Write Digital Data vi Writes digital data to the requested channel s on an isoLynx SLX200 system The device handle is obtained by a call to Open SLX Device vi Connector Pane data type current dey
10. nt s PATH The following files are the actual libraries and contain the SLX200 VIs needed to build your own isoLynx SLX200 Vis All of the following libraries contain the same Vis They only differ in the LabVIEW version they are targeted for 6 1 116 for LabVIEW 6 1 and above 7 0 116 for LabVIEW 7 0 and above slixcom_lIv_8 0 llb for LabVIEW 8 0 and above 2 Terms You Should Know 2 1 Ports and Devices In the SLX200 LabVIEW VI Library a port represents the means of connection to the isoLynx es such as a COM port or Ethernet connection A device represents an isoLynx SLX200 except in the special case where an isoLynx has two Ethernet connectors and each one is considered a device To use the library properly the following steps must be done by your VI in this order 1 Open a port using either the Open SLX RTU Port or Open SLX TCP Port VI depending on whether your application is using Modbus RTU serial line or Modbus TCP Ethernet 2 Open a device using the Open SLX Device VI passing it the port handle given by the VI in step 1 3 Use the other VIs in the library to send data to and receive data from the isoLynx passing each the device handle obtained in step 2 4 When your VI has completed processing close the device using the Close SLX Device VI passing it the device handle obtained in step 2 5 Close the port using the Close SLX Port Vl passing it the port h
11. of 0 indicates no error a negative value indicates a warning and a positive value indicates an error H source identifies the name of the VI that produced the error dev handle is a handle to an isoLynx SLX200 system Wire this input to the handle obtained from the Open SLX Device VI error out is a cluster that contains error information If the error in cluster indicated an error the error out cluster contains the same information Otherwise error out describes the error status of this VI dev handle is a duplicate of the handle passed into the identically named input terminal This output can be wired to the identically named input terminals of other isoLynx SLX200 Vis error information provides more information about an error condition See the SLX200 Software User Manual for more information error code is zero if no error condition exists See the SLX200 Software User Manual for a description of other error codes 18
12. of the handle passed into the identically named input terminal This output can be wired to the identically named input terminals of other isoLynx SLX200 VIs 4 4 Other Routines For the following routines additional information is available about the register values in the SLX200 Software User Manual section 13 4 4 1 Read Status Read Status vi Reads the status register from an open isoLynx SLX200 system The device handle is obtained by a call to Open SLX Device vi Connector Pane dey handle 1 handle ree E E ok error in error statua ae a status bits naan error agt Controls and Indicators error in no error is a cluster that describes error conditions occurring before the VI executes If an error has already occurred the VI passes the value of the error in cluster to error out status is TRUE if an error occurred prior to the execution of this VI If status is TRUE the VI does not do anything other than pass error in information to error out 5528 code is the error code number identifying an error or warning A value of 0 indicates no error a negative value indicates a warning and a positive value indicates an error El source identifies the name of the VI that produced the error dev handle is a handle to an isoLynx SLX200 system Wire this input to the handle obtained from the Open SLX Device VI io error out is a cluster that contains error information If the er
13. or information If the error in cluster indicated an error the error out cluster contains the same information Otherwise error out describes the error status of this VI 11 isoLynx SLX200 LabVIEW VI Library User Manual 4 3 Read Write Analog Digital Data Vis For the following routines additional information is available about the register values in the SLX200 Software User Manual sections 8 10 In each of the following routines the arguments are defined as follows 1 dev handle device handle obtained by call to Open SLX Device vi 2 type either CURRENT AVERAGE MAX or MIN For the two DigitalData routines the type must be CURRENT 3 chan channel number 4 data or counts array of boolean values data or 16 bit values counts to either read from or write to the isoLynx 5 qty number of 16 bit or boolean values to transfer 12 4 3 1 Read Analog Counts Read Analog Counts vi Reads current average max or min analog counts from the requested channel s on an isoLynx SLX200 system The device handle is obtained by a call to Open SLX Device vi Connector Pane data type dey handle dey handle chan counts qty out error in no error Controls and Indicators error in no error is a cluster that describes error conditions occurring before the VI executes If an error has already occurred the VI passes the value of the error in cluster to error out status is TRUE if an e
14. osadat a E 3 HS T T E EE T AN E N E E ca bist taal AE T 5 SLA 2 AS 6 Als Portread 6 4 1 1 Open SLA RTU PRO 7 4 1 2 BY TCR PO Carero omen ntann mr erpee 8 4 1 3 SIO ee EA Or 9 A MD ee 10 4 21 DENS EXA DEV sss ie 10 4 2 2 Close SCA DEVICE sarre E ESSN 11 Ao Write Analog VIS 12 4 3 1 Read Analog 13 4 3 2 Wate Coun shalt testa a a E R ETR 14 4 3 3 ED 15 4 3 4 Te 10 49 Wenrkoues ver 17 4 4 1 eat 17 4 4 2 IRC ACME TOR Reo eenei R r 18 111 isoLynx SLX200 LabVIEW VI Library User Manual 1V About Dataforth Corporation Our passion at Dataforth Corporation is designing manufacturing and marketing the best possible signal conditioning and data communication products Our mission is setting new standards of product quality performance and customer service Dataforth Corporation with over 20 years experience is the worldwide leader in Instrument Class Industrial Electronics rugged high performance signal conditioning and data communication products that play a vital role in maintaining the integrity of industrial automation data acquisition and quality assurance systems Our products directly connect
15. ror in cluster indicated an error the error out cluster contains the same information Otherwise error out describes the error status of this VI dev handle is a duplicate of the handle passed into the identically named input terminal This output can be wired to the identically named input terminals of other isoLynx SLX200 VIs status bits indicate individual error conditions detected by the power on self test T DAC Failure is TRUE if a DAC failure was detected T ADC Failure is TRUE if an ADC failure was detected T EEPROM Failure is TRUE if a EEPROM failure was detected T SRAM Failure is TRUE if an SRAM failure was detected TF ok is TRUE if power on self test completed successfully 17 isoLynx SLX200 LabVIEW VI Library User Manual 4 4 2 Read Error Registers Read Error Registers vi Reads the error registers from an open isoLynx SLX200 system Connector Pane dey handle error in no error dey handle error code error information error out Controls and Indicators error in no error is a cluster that describes error conditions occurring before the VI executes If an error has already occurred the VI passes the value of the error in cluster to error out status is TRUE if an error occurred prior to the execution of this VI If status is TRUE the VI does not do anything other than pass error in information to error out 5528 code is the error code number identifying an error or warning A value
16. rror occurred prior to the execution of this VI If status is TRUE the VI does not do anything other than pass error in information to error out 5528 code is the error code number identifying an error or warning A value of 0 indicates no error a negative value indicates a warning and a positive value indicates an error 5258 source identifies the name of the VI that produced the error dev handle is a handle to an isoLynx SLX200 system Wire this input to the handle obtained from the Open SLX Device VI data type selects either Current Average Maximum or Minimum counts to be read from the isoLynx SLX200 system chan is the channel ID of the first channel of a group of consecutive analog channels to read from qty Is the number of consecutive analog channels to read starting at the channel ID given in chan error out is a cluster that contains error information If the error in cluster indicated an error the error out cluster contains the same information Otherwise error out describes the error status of this VI E B AEE dev handle is a duplicate of the handle passed into the identically named input terminal This output can be wired to the identically named input terminals of other isoLynx SLX200 Vis mm 116 Ld counts is an array of signed 16 bit values read from the isoLynx SLX200 system The data is in two s complement format where 32767 hex 7FFF corresponds to 10 volts and 32768 hex 8000 corre
17. rror out cluster contains the same information Otherwise error out describes the error status of this VI isoLynx SLX200 LabVIEW VI Library User Manual 4 2 Device Related Vis 4 2 1 Open SLX Device Open SLX Device vi Establishes a communication session with a single isoLynx SLX200 system Either the Open SLX RTU Port or Open SLX TCP Port VI must have run successfully before this VI is called Connector Pane pork handle dev handle error aut id 31 error in no error Controls and Indicators l io 10 error in no error is cluster that describes error conditions occurring before the VI executes If an error has already occurred the VI passes the value of the error in cluster to error out status is TRUE if an error occurred prior to the execution of this VI If status is TRUE the VI does not do anything other than pass error in information to error out 5528 code is the error code number identifying an error or warning A value of 0 indicates no error a negative value indicates a warning and a positive value indicates an error 5258 source identifies the name of the VI that produced the error id 31 is the Modbus RTU Slave ID for an RTU port handle and the Modbus TCP Unit ID fora TCP port handle NOTE isoLynx SLX200 ignores the Unit ID so it is safe to use a value of your choosing port handle is a handle to an isoLynx SLX200 RTU serial or TCP port Wire this input to the handle o
18. sponds to 10 volts 13 isoLynx SLX200 LabVIEW VI Library User Manual 4 3 2 Write Analog Counts Write Analog Counts vi Writes current average max or min analog counts to the requested channel s on an isoLynx SLX200 system The device handle is obtained by a call to Open SLX Device vi Connector Pane data type dev handle dey handle chan error out counts error in no error Controls and Indicators error in no error is a cluster that describes error conditions occurring before the VI executes If an error has already occurred the VI passes the value of the error in cluster to error out status is TRUE if an error occurred prior to the execution of this VI If status is TRUE the VI does not do anything other than pass error in information to error out 5528 code is the error code number identifying an error or warning A value of 0 indicates no error a negative value indicates a warning and a positive value indicates an error 5258 source identifies the name of the VI that produced the error dev handle is a handle to an isoLynx SLX200 system Wire this input to the handle obtained from the Open SLX Device VI 732 data type selects either Current Average Maximum or Minimum counts to write to the isoLynx SLX200 system Use Average Maximum or Minimum to preset or reset the corresponding analog input calculated values 98 chan is the channel ID of the first channel of a group of consecutiv
19. ss E1 E2 l l No jumpers or open position 3 makes this on all J1 saa make this expansion panel 3 analog channels 48 63 Te Figure 2 1 SLX200 channel numbers Perhaps the easiest way to figure channel numbers is to think in hexadecimal Consider the high nybble of the single byte channel number to be the panel number and the low nybble to be the channel slot For example channel 0x41 refers to panel 4 slot 1 the second slot from the left Other examples are shown in Figure 2 2 below The Ox indicates hexadecimal 0x27 is decimal 39 and is decimal 10 Channel numbers X X 1 panel 2 slot 7 base unit slot 10 panel 0 Figure 2 2 SLX200 channel number examples 3 Example VIs A number of example VIs are included on the CD as starting points for your own VI several each for LabVIEW 6 1 LabVIEW 7 0 and LabVIEW 8 0 and above The example VIs are very simple and are intended to demonstrate use of the SLX200 LabVIEW VI library more so than to provide a functional application isoLynx SLX200 LabVIEW VI Library User Manual 4 SLX200 Library Vis 4 1 Port related VIs These routines open and close the port the means of connection to the SLX200 In the following VIs the port handle is a unique 32 bit identifier which specifies the port being used The port handle is initialized by either of the port opening VIs and is used later by the device
20. tatus of this VI port handle is a handle to an isoLynx SLX200 RTU serial port This output should be wired to the identically named input terminal of or more Open SLX Device VIs isoLynx SLX200 LabVIEW VI Library User Manual 4 1 2 Open SLX TCP Port Open SLX TCP Port vi Opens a Modbus port with the given communication parameters Connector Pane server name TCP port 502 error in no error pork handle error que Controls and Indicators error in no error is a cluster that describes error conditions occurring before the VI executes If an error has already occurred the VI passes the value of the error in cluster to error out status is TRUE if an error occurred prior to the execution of this VI If status is TRUE the VI does not do anything other than pass error in information to error out GE code is the error code number identifying an error or warning A value of 0 indicates no error a negative value indicates a warning and a positive value indicates an error 5258 source identifies the name of the VI that produced the error server name is a string representing the domain name or IP address of the isoLynx SLX200 system E TCP port 502 is the desired server port to connect with Current isoLynx SLX200 systems only communicate on TCP port 502 the default so it is safe to leave this terminal unwired error out is a cluster that contains error information If the error in cl
21. uster indicated an error the error out cluster contains the same information Otherwise error out describes the error status of this VI port handle is a handle to isoLynx SLX200 TCP port This output should be wired to the identically named input terminal of the Open SLX Device VI 4 1 3 Close SLX Close SLX Port vi Closes an open isoLynx SLX200 port handle The port handle is opened by a call to Open SLX RTU Port vi or Open SLX TCP Port vi Connector Pane pork handle error in no error error auc Controls and Indicators error in no error is a cluster that describes error conditions occurring before the VI executes If an error has already occurred the VI passes the value of the error in cluster to error out status is TRUE if an error occurred prior to the execution of this VI If status is TRUE the VI does not do anything other than pass error in information to error out 5528 code is the error code number identifying an error or warning A value of 0 indicates no error a negative value indicates a warning and a positive value indicates an error H source identifies the name of the VI that produced the error 532 port handle is a handle to isoLynx SLX200 RTU serial or TCP port Wire this input to the handle obtained from the Open SLX RTU Port or Open SLX TCP Port VI error out is a cluster that contains error information If the error in cluster indicated an error the e
Download Pdf Manuals
Related Search