VTI Instruments EX1629 User Manual Download Page 113

Page: 113 / 346

www.vtiinstruments.com

EX1629 Command Set

113

vtex1629_dio_clear_events_all

UNCTION

ROTOTYPE

ViStatus vtex1629_dio_clear_events_all (ViSession

);

UNCTION

ARAMETERS

= contains a session handle to the instrument. This handle is obtained by the function and remains valid until the

session is closed.

ATA

TEM

ESET

ALUE

Not applicable to this function.

ESCRIPTION

This function clears the DIO event configuration for all events.

XAMPLE

ViSession instrumentHandle;
ViStatus status;
…
…
status = vtex1629_dio_clear_events_all(instrumentHandle);

Summary of Contents for EX1629

Page 1: ...EX1629 48 CHANNEL STRAIN GAGE INSTRUMENT USER S MANUAL P N 82 0109 000 Released February 17th 2012 VTI Instruments Corp 2031 Main Street Irvine CA 92614 6509 949 955 1894...

Page 2: ...and Output 16 Multiple Gain Ranges 16 Sampling Rate 17 Digital Filtering 17 Triggering 17 Input Connector 17 TEDS Transducer Support 17 LXI Trigger Bus 17 LXI Limit Events 17 EX1629 Specifications 18...

Page 3: ...39 Using Multiple Network Cards 39 Preventive Maintenance 41 SECTION 3 43 BASIC OPERATION 43 Introduction 43 Engineering Unit EU Conversion 43 Quarter Bridge 350 Quarter Bridge 120 Quarter Bridge User...

Page 4: ...easurement Unit 69 Reset 69 Reboot 69 Network Configuration 69 Time Configuration 71 Upgrade 72 SECTION 6 73 PROGRAMMING 73 Introduction 73 Default Settings 73 Opening an Instrument Session 75 Closing...

Page 5: ...unction Definition 104 EX1629 Function Set 105 vtex1629_abort 105 vtex1629_allow_all_channels 106 vtex1629_break_lock 107 vtex1629_check_lock 108 vtex1629_clear_stored_config 109 vtex1629_close 110 vt...

Page 6: ...ber 164 vtex1629_get_lead_wire_resistance 165 vtex1629_get_linearscaling_configuration 166 vtex1629_get_lxi_limit_event_enabled 167 vtex1629_get_lxi_limit_event_latch 168 vtex1629_get_lxibus_configura...

Page 7: ..._set_arm_delay 234 vtex1629_set_arm_source 235 vtex1629_set_bridge_limit 236 vtex1629_set_bridge_limit_enabled 238 vtex1629_set_cal_out 239 vtex1629_set_cal_source 240 vtex1629_set_completion_resistor...

Page 8: ...trigger_count 289 vtex1629_set_trigger_delay 290 vtex1629_set_trigger_source 291 vtex1629_set_trigger_source_timer 292 vtex1629_set_trigger_timer 293 vtex1629_set_unstrained_voltage 294 vtex1629_soft_...

Page 9: ...READ_MEMORY_2430 329 WRITE_AND_COPY_SCRATCHPAD_2430 330 DS2431 Commands 331 WRITE_SCRATCHPAD_2431 331 READ_SCRATCHPAD_2431 333 COPY_SCRATCHPAD_2431 334 READ_MEMORY_2431 335 WRITE_AND_COPY_SCRATCHPAD_...

Page 10: ...duties and taxes for products returned to VTI from another country VTI warrants that its software and firmware designated by VTI for use with a product will execute its programming when properly inst...

Page 11: ...ct has been designed and manufactured according to the following specifications SAFETY IEC 61010 1 2001 2nd Ed EN 61010 1 2001 2nd Ed EMC IEC 61326 1 2005 CISPR 11 1990 IEC 61326 1 2005 IEC 61000 4 2...

Page 12: ...symbols may appear on the product or in the manual ATTENTION Important safety instructions Indicates hazardous voltage Frame or chassis ground Indicates that the product was manufactured after August...

Page 13: ...electric shock the grounding conductor must be connected to earth ground Operating Conditions To avoid injury electric shock or fire hazard Do not operate in wet or damp conditions Do not operate in...

Page 14: ...r Road Suite 13 Valley View OH 44125 Phone 216 447 8950 Fax 216 447 8951 VTI Instruments Lake Stevens Instrument Division 3216 Wetmore Avenue Suite 1 Everett WA 98201 Phone 949 955 1894 Fax 949 955 30...

Page 15: ...her equipment to be connected or cabled together The design of the EX1629 provides full configuration flexibility with all bridge completion and excitation source configurations set programmatically T...

Page 16: ...self calibration process completes quickly and does not require removal of the actual input connections making it convenient to run often Confidence Measurement System In addition to the main bridge m...

Page 17: ...direct input of bridge configuration parameters and input configuration management LXI Trigger Bus The EX1629 features an LXI LAN eXtensions for Instrumentation compatible 8 channel trigger bus on th...

Page 18: ...Base T Ethernet INPUT CONNECTOR RJ 45 BRIDGE EXCITATION REGULATION Independent high side and low side control on a per channel basis HIGH SIDE RANGE 0 to 8 V LOW SIDE RANGE 0 to 8 V RESOLUTION 14 bit...

Page 19: ...sive of lead wire desensitization errors Exclusive of gage errors Exclusive of noise Note 3 30 days 5 C from unstrained voltage measurement Note 4 Only applies outside of self calibration window FULL...

Page 20: ...25 V COMMON MODE INPUT RANGE 15 V CMRR dc TO 60 Hz 120 dB typical 110 dB minimum Gain 100 FILTERING ANALOG ANTI ALIAS LPF 60 kHz 1 pole per channel DIGITAL FIR FILTERING Passband ripple fs 3125 Hz fs...

Page 21: ...GER BUS CHANNELS 8 CONNECTORS 2 Micro DB 25 ELECTRICAL Logic type M LVDS Type 1 VIT 50 mV maximum VIT 50 mV minimum VOS 1 V typical POWER REQUIREMENTS LINE VOLTAGE 90 250 V ac 50 60 Hz INPUT POWER 200...

Page 22: ...is required in order to calculate the total system uncertainty For this analysis it must be noted that the listed characteristics are for each source independently Bridge Completion The characteristic...

Page 23: ...e measurement circuitry is a balanced 160 mV the transfer function of strain to voltage is nonlinear for quarter bridge configuration and that results in the small disparity Quarter bridge measurement...

Page 24: ...tation voltage This quantity has a lower uncertainty because as a difference measurement it is subject to fewer error sources While these performance characteristics are provided they should not be ad...

Page 25: ...nsates for the lead wire resistance and delivers the correct excitation value For quarter bridge configurations it is highly recommended that the full 3 wire connection be used as shown in Figure 2 3...

Page 26: ...inferred through the shunt calibration process or by calling the vtex1629_set_lead_wire_resistance and vtex1629_set_half_bridge_lead_wire_desensitization functions Please reference the Bridge Completi...

Page 27: ...to external electrical magnetic and thermal disturbances However as with all precision instrumentation certain precautions if taken into consideration can help achieve maximum performance 1 The unit...

Page 28: ...This utility uses the VXI 11 discovery protocol to discover the EX1629 This utility can also be used to upgrade the EX1629 s driver and firmware For more information on using the LInC U utility pleas...

Page 29: ...e For example in a full bridge configuration using excitation remote sense the measurements are insensitive to the resistance of all connections However in a quarter bridge configuration the resistanc...

Page 30: ...Bridge 1 of 48 channels Excitation Sense Sense Excitation Sense Excitation Sense Excitation Excitation Sense Excitation Sense RJ 45 Pin 12345678 Pin 2 Pin 7 Pin 6 Pin 3 Pin 8 Pin 1 10K 10K Instrumenta...

Page 31: ...0 not 2000 Strain Bridge 8 pin telcom connector RJ 45 350 120 User 10K 10K Excitation Sense TEDS COMM External customer shunt cal resistor terminals Internal Rcal 55K Excitation Excitation Half Bridge...

Page 32: ...s present in each gage not the total of the four gages For example if the positive gages are subjected to tensile strain of 1000 and the negative gages are subjected to compressive strain of 1000 the...

Page 33: ...tation Excitation Excitation Sense Sense Excitation Sense Excitation Sense 0 V Excitation Excitation Sense 10K 10K Instrumentation Amplifier x1 x10 x100 Hi Lo Shield 150 150 Sense Cal AGND Sense Wagne...

Page 34: ...GURATION The wideband output connector defined in Table 3 5 is a high performance analog wideband buffered output that can be connected to a high speed digitizer for measuring structural vibration lev...

Page 35: ...OUTPUT DIAGRAM DRIVER INSTALLATION The EX1629 is shipped with a VTI Instruments Corp Drivers and Product Manuals CD which includes software drivers user s manuals the VTI Instruments Product Catalog...

Page 36: ...Figure 5 3 For more information see Network Configuration in Section 5 NETWORK TROUBLESHOOTING If an error occurs when trying to discover the EX1629 see Web Page Operation in Section 5 for more infor...

Page 37: ...PERTIES 4 Select Internet Protocol TCP IP then click the Properties button as shown in Figure 2 10 FIGURE 2 10 LOCAL AREA CONNECTION PROPERTIES DIALOG BOX 5 Determine if the PC is set to use auto or s...

Page 38: ...to IP 1 Remove all network connections from the PC except for the connection to the EX1629 Wireless adapters should be disabled as well 2 Apply power to the EX1629 and wait for the LAN LED to turn gre...

Page 39: ...ique IP address is assigned to the EX1629 by consulting a network administrator 7 In the Subnet Mask field enter the subnet mask in the Determine PCs Network Settings step 8 In the Gateway Address fie...

Page 40: ...P Address field Although any valid network IP address can be used 192 168 1 2 is used in this example For more information on valid IP addresses please consult with an IT administrator 7 Set the Subne...

Page 41: ...sed f If not automatically completed after the IP address is entered set the Subnet mask field to 255 255 255 0 FIGURE 2 16 COMPLETED NIC STATIC IP CONFIGURATION g Click OK to exit the network configu...

Page 42: ...pable of using the optional calibration kit Self calibration is recommended on a monthly basis and should only be performed by qualified technicians operators see Self Calibration for more information...

Page 43: ...nects the back half resistors to the Sense measurement line as illustrated in Figure 2 3 The automatic configuration however can be overridden as these elements can be configured independently Common...

Page 44: ...ge configuration where the completion resistor is external to the instrument since only one leg of the bridge is active it is a quarter bridge not a half bridge which would contain two strain gage res...

Page 45: ...conversion applies to the following bridge configuration R g R g VOUT VEXC R R FIGURE 3 4 HALF BRIDGE POISSON CONFIGURATION The half bridge strain conversion is calculated according to sense backhalf...

Page 46: ...nversion applies to the following bridge configuration VOUT VEXC FIGURE 3 6 FULL BRIDGE POISSON CONFIGURATION The full bridge strain conversion is calculated according to sense sense diff V V V excita...

Page 47: ...ally configures the input path for full bridge mode in which the completion resistor is shorted and the back half resistors are disconnected Linear This performs a scaling of the differential voltage...

Page 48: ...ed as a factory option Off refers to the disabling of all of the resistor paths The default value of the completion resistor is full INPUT MULTIPLEXER The connection of the EX1629 s signal conditionin...

Page 49: ...train conversions gage factor and Poisson ratio The gage factor GF a measure of strain gage sensitivity is a dimensionless quantity defined as the ratio of the fractional change in resistance to the f...

Page 50: ...th respect to the positive and negative supplies that compose the total excitation voltage This programming independence provides the flexibility of balanced or unbalanced excitation Specifically the...

Page 51: ...over whether the local sense or remote sense lines of the excitation source are measured If the remote sense lines are not connected to the external strain bridge such as in quarter bridge configurati...

Page 52: ...ventional method of providing a value to the EU conversion it is also possible to manually enter a value This would normally only be done for system diagnostic purposes SCAN LIST CONFIGURATION The EX1...

Page 53: ...f the instrument For example if a tare value of 100 is entered when the units are microstrain it will be considered as 100 However if the units setting is then changed to strain this tare value will b...

Page 54: ...e absolute time of scan initiation If enabled the EX1629 can also return data from its confidence measurement system such as the excitation source voltages and excitation source currents SHUNT CALIBRA...

Page 55: ...16 channels D F internal_remote every channel B internal_local every channel C teds_remote 1 per 16 channels A E TABLE 3 4 SHUNT CALIBRATION SETTINGS Shunt calibration configuration involves two discr...

Page 56: ...to mitigate the effects of time and temperature on the signal conditioning circuitry of the EX1629 resulting in significant performance improvement However it cannot compensate or correct for potenti...

Page 57: ...t the ability to save user configurations to non volatile storage however This option saves all configuration variables and automatically restores them at power on or reset instead of using the factor...

Page 58: ...4 LO 25 CH 30 LO 25 CH 46 LO 26 CH 13 LO 26 CH 29 LO 26 CH 45 LO 27 CH 12 LO 27 CH 28 LO 27 CH 44 LO 28 CH 11 LO 28 CH 27 LO 28 CH 43 LO 29 CH 10 LO 29 CH 26 LO 29 CH 42 LO 30 CH 9 LO 30 CH 25 LO 30 C...

Page 59: ...pull up When configured as inputs the DIO signals 0 through 15 may be used as trigger and or arm sources Several vendors provide appropriate mating connectors AMP part number 216166 1 44 pin housing i...

Page 60: ...RIG_N7 TABLE 3 7 LXI TRIGGER BUS CONNECTOR PIN ASSIGNMENTS TEDS TRANSDUCER SUPPORT The EX1629 supports reading and writing to Transducer Electronic Data Sheets TEDS devices that implement the IEEE 145...

Page 61: ...in 8 Pin 1 IO GND 10K 10K Instrumentation Amplifier x1 x10 x100 Hi Lo Shield 150 150 Sense Cal AGND Sense Wagner Cal AGND 430 kHz LOW PASS FILTER 60 3 kHz LOW PASS FILTER ADC TRIFILAR FILTER FIGURE 3...

Page 62: ...wn network configuration To perform a network reset 1 Power off the EX1629 2 Press and hold the reset button 3 Power on the EX1629 4 Continue to hold the reset button for at least 30 seconds 5 Release...

Page 63: ...tem and is diagramed in Figure 4 1 IDLE IDLE LAYER ARM LAYER TRIG LAYER INIT LAYER DEVICE LAYER Init Wait for ARM Event ARM Delay ARM Event ARM Count 0 or ARM Count Inf No Yes Software Arm ARM COUNT I...

Page 64: ...ent transitions back into the INIT layer If Init Continuous mode is enabled the ARM layer is automatically reentered without the issuance of a trigger initialize command However unlike with a trigger...

Page 65: ...returned will be 8 To be clear there is a single FIFO in the EX1629 that holds both main input channel data as well as confidence measurement system data ADC CLOCK AND SYNCHRONIZATION As was previous...

Page 66: ...acquire data that is synchronized across all acquisition channels This requires configuring one of the devices as a master and the remaining devices as slaves The devices must be connected together u...

Page 67: ...and show the instruments that were discovered as shown in Figure 5 1 To open the web page click on the hostname hyperlink in the Discover Devices tab The IP address of the EX1629 can also be viewed fr...

Page 68: ...onal status and information only The Index page is an example of a status page Action This type of page initiates a command on the instrument but does not involve parameter entry The Reboot page is an...

Page 69: ...rument reset clears the FIFO reading memory All desired acquisition data must be retrieved from the FIFO prior to the issuance of this command REBOOT This action page is used to perform a complete ins...

Page 70: ...P and AutoIP enabling Static and then assigning a static IP address subnet mask and gateway address and optionally up to three DNS servers see Figure 5 3 NOTE The 169 254 16 subnet is reserved by the...

Page 71: ...ary 1 1970 the beginning of the epoch The time and date can be manually specified on the Time Configuration page Figure 5 4 Manual configuration will be necessary if the network environment is such th...

Page 72: ...ble state requiring return to the factory An uninterruptible power supply may be used to avoid this risk Perform the following steps to conduct a firmware upgrade 1 Perform a Reboot or a power cycle 2...

Page 73: ...atile storage If there is a user defined configuration stored in non volatile storage that configuration is applied after a reset power cycle or use of the vtex1629_reset function The vtex1629_clear_s...

Page 74: ...Specified Order 0 Auto Calculated Order 6 DIGITAL I O CONFIGURATION RESET VALUES CONFIGURATION PARAMETER RESET VALUE Bank 0 Direction 0 Input Bank 0 Pull up 0 Passive Bank 1 Direction 0 Input Bank 1 P...

Page 75: ...instrrev Note that in the sample code above error code checking and handling is included The structure used above can be used as a template for all functions In the examples that follow error code ch...

Page 76: ...s set the EU conversion for all channels result vtex1629_set_EU_conversion vi channels numberOfChannels VTEX1629_EUCONV_QTR_BRIDGE_120 set the gain result vtex1629_set_gain vi channels numberOfChannel...

Page 77: ...numChannels MAX_NUMBER_OF_CHANNELS ViReal64 minArr MAX_NUMBER_OF_CHANNELS ViReal64 maxArr MAX_NUMBER_OF_CHANNELS int i 0 for i 0 i MAX_CHANNELS i channels i i for i 0 i MAX_NUMBER_OF_CHANNELS i minAr...

Page 78: ...TRIGGER AND ADC CLOCK The EX1629 supports two general use cases standalone one or more instruments that sample independently and asynchronously and master slave one master instrument and one or more s...

Page 79: ...thin the device the transmission scope for the line should be set to internal transmission only If the sample clock output is intended to be driven out on the external trigger bus the transmission sco...

Page 80: ...can be output to other devices using the external trigger bus As with the sample clock and synchronization signal configurations the same LXI Trigger Bus line can be used by the device for its trigge...

Page 81: ...Multiple Instruments Master Slave Example Configuration The Master Slave configuration is suitable for larger acquisition systems up to several thousand channels hundreds of instruments By sharing a s...

Page 82: ...1629_reset_trigger_arm slave_vi Reset the trigger system on the master device result vtex1629_reset_trigger_arm master_vi Configure the LXI trigger bus lines on the master device Lines 0 3 are externa...

Page 83: ...imer master_vi 5 Configure the trigger pattern to generate an event based on the timer result vtex1629_set_pattern_trig_configuration master_vi trigLxiLines trigDioLines VI_TRUE VTEX1629_LXI_LINE_TWO...

Page 84: ..._OUTPUT VTEX1629_LXI_INTERNAL result vtex1629_set_lxibus_configuration slave_vi VTEX1629_LXI_LINE_SEVEN VTEX1629_LXI_OUTPUT VTEX1629_LXI_INTERNAL Configure the sample clock on the slave as an input fr...

Page 85: ...om the instrument returning to the user application when either the request has been fulfilled or the timeout elapses To fulfill the request the instrument driver may need to make many repeated querie...

Page 86: ...is specified as is the maximum number of data elements to be returned The acquisition data along with the timestamp for each scan is returned in three arrays of ViReal64 elements two for the timestamp...

Page 87: ...is important that the streaming data interface be enabled prior to initiating acquisition as the EX1629 prevents streaming data from being enabled after initiating acquisition As Figure 6 2 shows the...

Page 88: ...provides a callback function Internally the instrument driver creates a thread and then opens a socket for streaming data between the host computer and the instrument The newly constructed thread does...

Page 89: ...handle The FILE handle as well as a sample count total variable are stored in a user defined data structure A pointer to this structure is passed to the vtex1629_enable_streaming_data function along...

Page 90: ...third contains data for channels 32 through 47 Only data for channels enabled in the scanlist are included That is if the main input scanlist contains channels 0 through 15 and 16 the first data set t...

Page 91: ...nt overwriting any data that may already exist in the external memory location to which the calibration file will be written In this example the self calibration and full calibration files are output...

Page 92: ...X1629_TRIG_SRC_IMMEDIATE or at some point in the future when the instrument receives the required signals e g a raising edge on LXI 0 In general after acquisition is initiated by the vtex1629_trig_ini...

Page 93: ...to function and is presented below Initialize Initialize vtex1629_init Limit Checking Set Bridge Limit Enabled vtex1629_set_bridge_limit_enabled Get Bridge Limit Enabled vtex1629_get_bridge_limit_enab...

Page 94: ...vtex1629_dio_clear_events_all LXI Trigger Bus Calls Send LXI Bus Pulse vtex1629_send_lxibus_pulse Get LXI Bus Configuration vtex1629_get_lxibus_configuration Get LXI Bus Output vtex1629_get_lxibus_out...

Page 95: ...ter_configuration Get Settling Time vtex1629_get_settling_time Excitation Voltage Calls Get Programmed Excitation Voltage vtex1629_get_excitation Get Excitation Voltage Enabled vtex1629_get_excitation...

Page 96: ...ation vtex1629_self_cal_init Initialize Zero Calibration vtex1629_zero_cal Query Self Calibration File in Non vol Memory vtex1629_self_cal_is_stored Load Self Calibration File from Non vol Memory vtex...

Page 97: ..._wire_resistance Get Lead Wire Resistance vtex1629_get_lead_wire_resistance Set Half Bridge Lead Wire Desensitization vtex1629_set_half_bridge_lead_wire_desensitization Get Half Bridge Lead Wire Desen...

Page 98: ...a Starts data streaming from instrument vtex1629_enable_streaming_dataEx Start data streaming from instrument expert mode vtex1629_erase_teds_data Erases the data on a TEDS device for one particular c...

Page 99: ..._get_excitation Queries and returns the programmed excitation voltage for a given channel vtex1629_get_excitation_enabled Queries and returns the enabled status of the excitation voltage for a specifi...

Page 100: ...nt_source Queries and returns the shunt source for a particular channel vtex1629_get_shunt_value Queries and returns a shunt resistor value based on a given channel and shunt source vtex1629_get_store...

Page 101: ...g This functions queries the existence of a previously saved self calibration file within non volatile memory vtex1629_self_cal_is_stored This functions queries the existence of a previously saved sel...

Page 102: ...given list of channels vtex1629_set_gauge_factor Sets the gage factor for a list of channels vtex1629_set_half_bridge_lead_wire_desensitization Sets the lead wire desensitization factor a given list o...

Page 103: ...9_set_trigger_delay Sets the trigger delay for the EX1629 vtex1629_set_trigger_source Sets the trigger source on the EX1629 vtex1629_set_trigger_source_timer A convenience functions that makes calls t...

Page 104: ...will be provided and when appropriate the range of values that the parameter will accept without creating an error Ranges are assumed to be inclusive unless otherwise specified DATA ITEM RESET VALUE T...

Page 105: ...instrument This handle is obtained by the function and remains valid until the session is closed DATA ITEM RESET VALUE Not applicable to this function DESCRIPTION This function aborts data acquisition...

Page 106: ...handle to the instrument This handle is obtained by the function and remains valid until the session is closed DATA ITEM RESET VALUE Not applicable to this function DESCRIPTION This function allows t...

Page 107: ...ot applicable to this function DESCRIPTION This function releases a lock on the instrument regardless of its owner This allows for instrument recovery if the locking client application or computer bec...

Page 108: ...function owns the lock A value of 1 returned indicates that the EX1629 is locked and that the current session owns that lock DATA ITEM RESET VALUE Not applicable to this function DESCRIPTION This func...

Page 109: ...rument This handle is obtained by the function and remains valid until the session is closed DATA ITEM RESET VALUE Not applicable to this function DESCRIPTION This function erases the stored configura...

Page 110: ...the session is closed DATA ITEM RESET VALUE Not applicable to this function DESCRIPTION This function closes the current instrument programming session This command should be performed at the conclus...

Page 111: ...unction compares the two provided digests byte by byte If VI_TRUE is returned in equal all bytes in digestA and digestB are equal A digest is a digital signature or a fingerprint representing the actu...

Page 112: ...dle is obtained by the function and remains valid until the session is closed inputLine the DIO Input Line whose event action entries are being cleared DATA ITEM RESET VALUE Not applicable to this fun...

Page 113: ...vi contains a session handle to the instrument This handle is obtained by the function and remains valid until the session is closed DATA ITEM RESET VALUE Not applicable to this function DESCRIPTION T...

Page 114: ...able_logging void FUNCTION PARAMETERS No parameters are defined for this function DATA ITEM RESET VALUE Not applicable to this function DESCRIPTION This function stops the logging of driver calls EXAM...

Page 115: ...e function and remains valid until the session is closed DATA ITEM RESET VALUE Not applicable to this function DESCRIPTION This function causes streaming data from the EX1629 to cease In order to use...

Page 116: ...e name relative path is provided the file will be created in the current working directory of the application append a Boolean input value that specifies if log results will be appended to an existing...

Page 117: ...longer synchronized with the LXI clock and it is now utilizing the EX1629 s internal oscillator as its clock source Possible causes of this error include the accidental removal of the LXI cable or a m...

Page 118: ...mestamp_nsec print the data for smp_idx 0 smp_idx data dataset dataset_val ds_idx data data_len smp_idx fprintf priv_struct fout t i f n data dataset dataset_val ds_idx data data_val smp_idx if data d...

Page 119: ...to implement this function the macro INSTR_LANGUAGE_SPECIFIC must be defined It should be noted that the data page created by this function contains an error code field which should equal zero In the...

Page 120: ...el an integer input value indicating the channel for which the completion resistor is desired Valid input values 0 to 47 DATA ITEM RESET VALUE Not applicable to this function DESCRIPTION This function...

Page 121: ...ion is closed statusCode an input status code corresponding to the error for which the error message is desired errMessage a return string that contains the error message This string should be at leas...

Page 122: ...ndle is obtained by the function and remains valid until the session is closed error_code Instrument Error Code error_message Error Message DATA ITEM RESET VALUE Not applicable to this function DESCRI...

Page 123: ...dicating the number of instruments found timeout_secs an integer input value in seconds indicating the amount of time to search before timing out DATA ITEM RESET VALUE Not applicable to this function...

Page 124: ...to this function DESCRIPTION This function queries and returns the arm count for the EX1629 This count represents the number of times the EX1629 will wait for ARM events to occur after the trigger sta...

Page 125: ...to this function DESCRIPTION This function queries and returns the arm delay for the EX1629 This indicates the amount of time in seconds that the EX1629 will wait after receiving an ARM event before...

Page 126: ...ative Edge 11 0x0B VTEX1629_TRIG_SRC_LXI1_NEG LXI 1 Negative Edge 12 0x0C VTEX1629_TRIG_SRC_LXI2_NEG LXI 2 Negative Edge 13 0x0D VTEX1629_TRIG_SRC_LXI3_NEG LXI 3 Negative Edge 14 0x0E VTEX1629_TRIG_SR...

Page 127: ...www vtiinstruments com EX1629 Command Set 127 EXAMPLE ViSession instrumentHandle ViStatus status ViInt32 armsource status vtex1629_get_arm_source instrumentHandle armsource...

Page 128: ...eded status LSW MIN Limit exceeded status The limits field is a bit field This UINT32 has two bits per channel 16 channels per analog board one to represent MAX limit exceeded and one to represent MIN...

Page 129: ...tiinstruments com EX1629 Command Set 129 EXAMPLE ViSession instrumentHandle ViStatus status ViInt32 channel 5 ViReal64 min 0 ViReal64 max 0 status vtex1629_get_bridge_limit instrumentHandle channel mi...

Page 130: ...remains valid until the session is closed enabled a Boolean return value indicating the enabled status of the excitation source A returned value of 1 indicates that the excitation source is enabled DA...

Page 131: ...channels listed in this channelList array numberOfChannels a return integer value indicating the number of channels currently included in the scan list Valid return values 1 to 48 coefficientOutputAr...

Page 132: ...TE_OUT_CURR_NEG_OFFSET 57 0x39 VTEX1629_CONF_EXCITE_OUT_CURR_NEG_COMMON_MODE_RESISTANCE 58 0x3A VTEX1629_SENSE_RESISTOR_NEG 59 0x3B VTEX1629_SENSE_RESISTOR_POS 60 0x3C VTEX1629_SUPPLY_EXCITE_OUT_NEG_G...

Page 133: ...OutputArray MAX_CHANNELS int i 0 memset channelList 0x00 sizeof channelList memset coefficientOutputArray 0x00 sizeof coefficientOutputArray CalType VTEX1629_CAL_DATA_SELF coefficientSelector VTEX1629...

Page 134: ...rameter has the following valid input values Decimal Value Hex Value define Symbol Description 0 0x00 VTEX1629_CAL_DATA_COMBINED Both self and factory calibration data 1 0x01 VTEX1629_CAL_DATA_SELF Se...

Page 135: ...www vtiinstruments com EX1629 Command Set 135 fileType bufferSize buffer actualSize if status VI_SUCCESS inform the user the API call failed...

Page 136: ...ction DESCRIPTION This function returns the total buffer size required to read the cal data including terminating nulls etc The client application should use this size to allocate a sufficiently large...

Page 137: ...the calibration source Valid return values are Decimal Value Hex Value define Symbol Nominal Voltage V 0 0x00 VTEX1629_CALSRC_0 0 1 0x01 VTEX1629_CALSRC_P_0_07 0 07 2 0x02 VTEX1629_CALSRC_N_0_07 0 07...

Page 138: ...he non volatile factory calibration file that is stored within the device DATA ITEM RESET VALUE Not applicable to this function DESCRIPTION This function queries and returns the mode and value of the...

Page 139: ...mon mode 2 0x02 VTEX1629_CONFSRC_BRIDGE_NEG Bridge 3 0x03 VTEX1629_CONFSRC_EXCITE_POS Excite 4 0x04 VTEX1629_CONFSRC_EXCITE_NEG Excite 5 0x05 VTEX1629_CONFSRC_EXCITE_NEG_SENSE Excite Sense 6 0x06 VTEX...

Page 140: ...ed or not This is a 16 bit field stored in the least significant 16 bits of a UINT32 variable 0 Confidence Data within Limits 1 Confidence Data Limit exceeded for CH 15 0 Confidence Data within Limits...

Page 141: ...e mapping follows the same ordering as the source define in vtex1629 h i e if sources 3 8 and 10 are selected then they are reported in that order Confidence sources that are not part of the confidenc...

Page 142: ...Decimal Value Hex Value define Symbol mode Description 0 0x00 VTEX1629_CONF_LIMIT_DISABLE_REPORT Reporting disabled 1 0x01 VTEX1629_CONF_LIMIT_SUMMARY_REPORT_ONLY Summary report mode selected 2 0x02 V...

Page 143: ...d digest array For consistency the client application should allocate VTEX1629_MAX_DIGEST_LENGTH bytes digest the current configuration s digest digestActualSize the actual configuration digest size D...

Page 144: ...il the session is closed direction an integer return value indicating the direction of bank zero of the digital I O Valid return values 0 or 1 DATA ITEM RESET VALUE Not applicable to this function DES...

Page 145: ...n is closed pullup an integer return value indicating the pull up mode for bank zero of the digital I O Valid return values 0 or 1 DATA ITEM RESET VALUE Not applicable to this function DESCRIPTION Thi...

Page 146: ...til the session is closed direction an integer return value indicating the direction of bank one of the digital I O Valid return values 0 or 1 DATA ITEM RESET VALUE Not applicable to this function DES...

Page 147: ...on is closed pullup an integer return value indicating the pull up mode for bank one of the digital I O Valid return values 0 or 1 DATA ITEM RESET VALUE Not applicable to this function DESCRIPTION Thi...

Page 148: ...al the actual number of actions available Valid return values 1 through 8 DATA ITEM RESET VALUE Not applicable to this function DESCRIPTION This function queries and returns the current setting for DI...

Page 149: ...The dioIn parameter is a decimal value that must be converted to a 16 bit binary value Once done the eight most significant bits correspond to the eight channels of bank one channels 8 15 The eight le...

Page 150: ...he dioOut parameter is a decimal value that must be converted to a 16 bit binary value Once done the eight most significant bits correspond to the eight channels of bank one channels 8 15 The eight le...

Page 151: ...s are 0 1 or 2 dspMajor indicates the minor dsp version dspMinor indicates the minor DSP version dspBuild indicates the DSP build date indicates the date of the DSP build The client should allocate an...

Page 152: ...ic channel Valid return values for the EUConversionType parameter are Decimal Value Hex Value define Symbol EUConversionType Description 0 0x00 VTEX1629_EUCONV_VOLT_OUTPUT Voltage 1 0x01 VTEX1629_EUCO...

Page 153: ...it is advised to give the confidence filters at least 1 5 s to settle from the time the confidence source for excitation voltage is enabled or the excitation value is changed The vtex1629_measure_exc...

Page 154: ...given channel Valid return values 0 00000 to 16 00000 DATA ITEM RESET VALUE Not applicable to this function DESCRIPTION This function queries and returns the current value used in EU conversions for t...

Page 155: ...values 8 000000 through 0 000000 DATA ITEM RESET VALUE Not applicable to this function DESCRIPTION This function queries and returns the actual excitation voltages for a given channel The excitation...

Page 156: ...citation source will be returned Valid input values 0 to 47 enabled a Boolean return value indicating the enabled status of the excitation source A returned value of 1 indicates that the excitation so...

Page 157: ...ot applicable to this function DESCRIPTION This function queries the EX1629 for the current FIFO memory page count One page of data in the FIFO corresponds to one scan or sample of all enabled channel...

Page 158: ...an integer input value that specifies the channel for which the gain will be returned Valid input values 0 to 47 gain a real return value indicating the specified channel s currently configured gain...

Page 159: ...n integer input value that specifies the channel for which the gage factor will be returned Valid input values 0 to 47 gageFactor a real return value indicating the given channel s currently entered g...

Page 160: ...hannel for which the gage factor will be returned Valid input values 0 to 47 factor returned factor value for the specified channel DATA ITEM RESET VALUE Not applicable to this function DESCRIPTION Th...

Page 161: ...turn value indicating the group delay in number of samples of the currently configured filter for the given channel DATA ITEM RESET VALUE Not applicable to this function DESCRIPTION This function quer...

Page 162: ...s all frequencies NOTE When setting channel filters on the EX1629 it is highly recommended that the same filter setting be used for each group of sixteen channels 0 through 15 16 through 31 and 32 thr...

Page 163: ...tly included in the scan list Valid return values 1 to 48 muxInValue indicates the input multiplexer source Valid return values 0 to 4 DATA ITEM RESET VALUE Not applicable to this function DESCRIPTION...

Page 164: ...and remains valid until the session is closed serialNumber indicates the instruments serial number The client should allocate an array of 64 bytes for the serial number DATA ITEM RESET VALUE Not appl...

Page 165: ...nnel an integer input value that specifies the channel for which the IIR filter configuration will be returned Valid input values 0 to 47 resistance returned resistance value for the specified channel...

Page 166: ...actor m in the linear equation y mx b b a real return value indicating the offset factor b in the linear equation y mx b DATA ITEM RESET VALUE Not applicable to this function DESCRIPTION This function...

Page 167: ...led0 the limit mask for the channels 0 through 15 where the lower 16 bits are minimums for these channels while the upper 16 bits are maximums enabled1 the limit mask for the channels 16 through 31 wh...

Page 168: ...andle is obtained by the function and remains valid until the session is closed latches an 8 bit mask that indicates which of the eight corresponding LXI Trigger Bus lines will be latched when an over...

Page 169: ...define Symbol lxiLine Description 0 0x00 VTEX1629_LXI_LINE_ZERO LXI LINE 0 1 0x01 VTEX1629_LXI_LINE_ONE LXI LINE 1 2 0x02 VTEX1629_LXI_LINE_TWO LXI LINE 2 3 0x03 VTEX1629_LXI_LINE_THREE LXI LINE 3 4 0...

Page 170: ...VTI Instruments Corp 170 EX1629 Command Set EXAMPLE ViSession instrumentHandle ViStatus status ViInt32 inout scope status vtex1629_get_lxibus_configuration instrumentHandle 0 inout scope...

Page 171: ...function DESCRIPTION This function queries and returns the input state of each of the channels on the LXI Trigger Bus The input parameter is an 8 bit integer where the least significant bit of the in...

Page 172: ...s and returns the output state of each of the channels on the LXI Trigger Bus The output parameter is an 8 bit integer where the least significant bit of the integer corresponds to LXI Trigger Bus cha...

Page 173: ...d to explicitly enable the software arm source It is always available for use while in pattern arm mode All of the conditions specified must be met for an arm event to be generated If multiple conditi...

Page 174: ...to communicate the arm event to the slave devices It is also necessary to configure this LXI Trigger Bus line to be used as an output see vtex1629_set_lxibus_configuration The lxiInput parameter speci...

Page 175: ...to this function DESCRIPTION This queries and returns the EX1629 s current configuration for the pattern trigger mode of operation This mode allows the EX1629 to accept TRIG events from multiple sourc...

Page 176: ...ce configuration If the EX1629 is a master driving trigger events to peripheral slaves the lxiOutput parameter specifies the LXI Trigger Bus line that will be used to communicate the trigger event to...

Page 177: ...nput value that specifies the channel for which the Poisson ratio will be returned Valid input values 0 to 47 poissonRatio a real return value that indicates the Poisson ratio of the specified channel...

Page 178: ...f and other devices or as a slave device that receives its sample clock from another device When operating in standalone mode sampleClockMode should be configured as a master The inLine parameter indi...

Page 179: ...eCount an integer return value indicating the currently configured post trigger sample count Valid return values 0 to 400000000 DATA ITEM RESET VALUE Not applicable to this function DESCRIPTION This f...

Page 180: ...ATA ITEM RESET VALUE Not applicable to this function DESCRIPTION This function queries and returns the currently configured sample frequency in hertz Hz for all channels The EX1629 offers a discrete n...

Page 181: ...he scan list Valid return values 0 to 47 numberOfChannels a return integer value indicating the number of channels currently included in the scan list Valid return values 1 to 48 DATA ITEM RESET VALUE...

Page 182: ...failedChannelArrayActualSize the actual size of the returned array failedChannelArray parameter Valid return values 0 to 48 DATA ITEM RESET VALUE Not applicable to this function DESCRIPTION This funct...

Page 183: ...en by the EX1629 signal conditioning module to settle to the input vale 2 of the input value after a reset of the signal conditioning path The signal conditioning path is reset on a sync event The set...

Page 184: ...abled a Boolean return value indicating whether or not the shunt resistor is enabled for the given channel A returned value of 1 indicates that the shunt is enabled for that channel DATA ITEM RESET VA...

Page 185: ...SOURCE_IS_LOCAL Internal local 4 0x04 VTEX1629_SHUNT_SOURCE_TEDS TEDS remote Local and Remote refer to how the shunt resistor is connected to the bridge For Local the connection is made within the EX1...

Page 186: ...remote 1 0x01 VTEX1629_FRONT_PANEL_LOCAL Front panel local 2 0x02 VTEX1629_INTERNAL_REMOTE Internal remote 3 0x03 VTEX1629_INTERNAL_REMOTE Internal local 4 0x04 VTEX1629_TEDS_REMOTE TEDS remote Local...

Page 187: ...rray For consistency the client application should allocate VTEX1629_MAX_DIGEST_LENGTH bytes digest the current configuration s digest digestActualSize the actual configuration digest size DATA ITEM R...

Page 188: ...rn strain measurements in units of strain or microstrain A value of 1 indicates that the EX1629 is configured to return microstrain units for the given channel whereas a value of 0 indicates the EX162...

Page 189: ...ng in standalone mode synchMode should be configured as a master The inLine parameter indicates the LXI line that should be used as the synch input This value is applicable regardless of whether the d...

Page 190: ...es the currently configured tare value for the given channel DATA ITEM RESET VALUE Not applicable to this function DESCRIPTION This function reads the currently configured tare value for a specific ch...

Page 191: ...device into tedsInfo In general this should be equal to VTEX1629_TEDS_DATASIZE 32 tedsInfo A return array that will contain the TEDS Info Each element of the array corresponds to a byte of data from...

Page 192: ...es the currently configured trigger count for the EX1629 Valid return values 1 to 231 1 DATA ITEM RESET VALUE Not applicable to this function DESCRIPTION This function queries and returns the currentl...

Page 193: ...T VALUE Not applicable to this function DESCRIPTION This function queries and returns the trigger delay for the EX1629 Specifically this is the amount of time in seconds that the EX1629 will wait afte...

Page 194: ..._NEG LXI 0 Negative Edge 11 0x0B VTEX1629_TRIG_SRC_LXI1_NEG LXI 1 Negative Edge 12 0x0C VTEX1629_TRIG_SRC_LXI2_NEG LXI 2 Negative Edge 13 0x0D VTEX1629_TRIG_SRC_LXI3_NEG LXI 3 Negative Edge 14 0x0E VT...

Page 195: ...put value in seconds indicating the trigger system timer Valid return values 0 s to 4294 967295 s DATA ITEM RESET VALUE Not applicable to this function DESCRIPTION This function queries and returns th...

Page 196: ...rained voltage will be returned Valid input values 0 to 47 unstrainedVoltage a real return value that indicates the currently configured unstrained voltage for the given channel DATA ITEM RESET VALUE...

Page 197: ...ed voltage for the given channel Valid input values VI_TRUE LED is on VI_FALSE LED is off DATA ITEM RESET VALUE Not applicable to this function DESCRIPTION The function provides the user the ability t...

Page 198: ...Not applicable to this function DESCRIPTION This function opens a session with the instrument and returns a session handle It can optionally perform an identification query and or reset the instrumen...

Page 199: ...ent application should allocate VTEX1629_MAX_DIGEST_LENGTH bytes digest the stored configuration s digest digestActualSize the actual configuration digest size DATA ITEM RESET VALUE Not applicable to...

Page 200: ...ck When no client has a lock calls are accepted from all clients A lock can only be acquired if the instrument is not already locked by another user By design the locking mechanism is able to be overr...

Page 201: ...LUE Not applicable to this function DESCRIPTION This function measures the indicated bridge parameter to indicate measurement confidence The confValue parameter can assume the following values Decimal...

Page 202: ...p 202 EX1629 Command Set memset returnedVals 0x00 sizeof returnedVals status vtex1629_measure_confidence instrumentHandle CONFIDENCE_EXCITATION_CURRENT numOfChannels channels sampleCount returnedVals...

Page 203: ...ction DESCRIPTION This function measures the total excitation voltage positive excitation voltage negative excitation voltage for a list of channels Setting the euConversion parameter to VI_TRUE 1 ind...

Page 204: ...on instrumentHandle ViInt32 channels 5 0 1 2 3 4 ViInt32 numberOfChannels 5 numValues 0 ViReal64 data 5 ViStatus status status vtex1629_measure_excitation_voltage instrumentHandle channels numberOfCha...

Page 205: ...e gage and the Excitation front panel connection Moreover the EX1629 has the capability again through the confidence system to determine the current that is flowing through the lead wire resistance Ha...

Page 206: ...I Instruments Corp 206 EX1629 Command Set memset resistance 0x00 sizeof resistance status vtex1629_measure_lead_wire_resistance instrumentHandle numberOfChannels channels resistance sampleCount VI_TRU...

Page 207: ...value indicating whether the measured values will be used for future EU conversions DATA ITEM RESET VALUE Not applicable to this function DESCRIPTION This function measures the unstrained voltage for...

Page 208: ...9 before timing out and returning timeout If a zero is passed for this parameter the timeout period is infinite DATA ITEM RESET VALUE Not applicable to this function DESCRIPTION This function retrieve...

Page 209: ...S NUM_SCANS NUM_CHANNELS define TIMEOUT_SECS 5 ViSession instrumentHandle ViReal64 seconds NUM_SCANS ViReal64 fractseconds NUM_SCANS ViReal64 acqdata MAX_NUM_SAMPLES ViInt32 numdata numscans result vt...

Page 210: ...ieving data from the EX1629 before timing out and returning If a zero is passed for this parameter the timeout period is infinite DATA ITEM RESET VALUE Not applicable to this function DESCRIPTION This...

Page 211: ...d or the timeout to_secs expires whichever happens first There are other mechanisms for retrieving data from the EX1629 Please see Retrieving Data Read FIFO and Streaming Data for more information EXA...

Page 212: ...ber of bytes actually written to the array holding the MLAN buffer data DATA ITEM RESET VALUE Not applicable to this function DESCRIPTION This function reads the MicroLAN MLAN response buffer from a T...

Page 213: ...RN Its size should be equal to VTEX1629_MAX_MLAN_URN_SIZE teds_urnActualSize Output integer indicating the number of bytes actually written to the array that holds the URN DATA ITEM RESET VALUE Not ap...

Page 214: ...y the function and remains valid until the session is closed DATA ITEM RESET VALUE Not applicable to this function DESCRIPTION This function commands the instrument to assume the default settings as d...

Page 215: ...ns a session handle to the instrument This handle is obtained by the function and remains valid until the session is closed DATA ITEM RESET VALUE Not applicable to this function DESCRIPTION This funct...

Page 216: ...ntains a session handle to the instrument This handle is obtained by the function and remains valid until the session is closed DATA ITEM RESET VALUE Not applicable to this function DESCRIPTION This f...

Page 217: ...lid until the session is closed DATA ITEM RESET VALUE Not applicable to this function DESCRIPTION This function resets all trigger system configuration settings Trigger and Arm to their reset values a...

Page 218: ...ains valid until the session is closed driverRev a return string indicating the driver revision instrRev a return string indicating the firmware revision DATA ITEM RESET VALUE Not applicable to this f...

Page 219: ...data but does not affect any self calibration data that is stored in nonvolatile memory After this function the effective calibration will be the full calibration factory calibration also known as the...

Page 220: ...unction clears self calibration data from nonvolatile memory It does not however affect the current self calibration data regardless of whether it came from a recent self calibration or a loading from...

Page 221: ...e last self calibration process that was run and completed Expected data return values 0 1 or 2 DATA ITEM RESET VALUE Not applicable to this function DESCRIPTION This function returns the status of th...

Page 222: ...ot In order to ensure that the override is intentional it is strongly recommended that user intervention be required in the software application to employ it The overRide parameter is used in the case...

Page 223: ...UPTIME_FOR_CAL prompt user to verify that it is okay to override the uptime requirement if okay_to_override status vtex1629_self_cal_init instrumentHandle override rec_uptime act_uptime if status VI_S...

Page 224: ...ing A return value of 1 indicates that self calibration is running whereas 0 indicates that it is not DATA ITEM RESET VALUE Not applicable to this function DESCRIPTION This function queries the status...

Page 225: ...le within nonvolatile memory A return value of VI_TRUE 1 indicates the existence of a file whereas VI_FALSE 0 indicates that no file exists DATA ITEM RESET VALUE Not applicable to this function DESCRI...

Page 226: ...ession is closed DATA ITEM RESET VALUE Not applicable to this function DESCRIPTION This function takes a currently stored self calibration file from nonvolatile memory and loads it as the current self...

Page 227: ...r cycle and reboot Any other previously stored self calibration data will be lost Since the existence of nonvolatile self calibration data represents a permanent although revocable change from the ful...

Page 228: ...be able to store up to 256 characters The EX1629 self test consists of a set of operations that are identical to those performed during self calibration No calibration data is modified by this functi...

Page 229: ...DESCRIPTION This function returns the status of the self test initiated via the vtex1629_self_test_init function It should not be used and is not necessary with the vtex1629_self_test function as tha...

Page 230: ...ates a self test It returns immediately without waiting for the self test to complete The vtex1629_self_test_get_status is used to monitor the self test progress The vtex1629_self_test function initia...

Page 231: ...els The upper 16 bits are ignored DATA ITEM RESET VALUE Not applicable to this function DESCRIPTION This function sends a pulse out on the selected DIO channels bank one channel bank zero dioOut 15 0...

Page 232: ...VALUE Not applicable to this function DESCRIPTION This function sends a pulse out on the desired LXI Trigger Bus channels The pulseLines parameter is an 8 bit integer where the least significant bit...

Page 233: ...infinite DATA ITEM RESET VALUE armCount 1 DESCRIPTION This function sets the arm count for the EX1629 This count represents the number of times the EX1629 will wait for arm events to occur after the t...

Page 234: ...it transitions the trigger state machine from the ARM layer into the TRIG layer The actual delay exhibited by the EX1629 is dependent on the sample frequency set by calling the vtex1629_set_sample_fr...

Page 235: ...e Edge 12 0x0C VTEX1629_TRIG_SRC_LXI2_NEG LXI 2 Negative Edge 13 0x0D VTEX1629_TRIG_SRC_LXI3_NEG LXI 3 Negative Edge 14 0x0E VTEX1629_TRIG_SRC_LXI4_NEG LXI 4 Negative Edge 15 0x0F VTEX1629_TRIG_SRC_LX...

Page 236: ...MAX for CH 0 0 Bridge data is greater than the MIN for CH 15 1 Bridge data is less than the MIN for CH 15 0 Bridge data is greater than the MIN for CH 0 1 Bridge data is less than the MIN for CH 0 31...

Page 237: ...EU conversion is volts then the limit values are in volts EXAMPLE ViSession instrumentHandle ViStatus status VI_SUCCESS ViInt32 numChannels MAX_NUMBER_OF_CHANNELS ViInt32 channels MAX_NUMBER_OF_CHANNE...

Page 238: ...remains valid until the session is closed enabled a Boolean input value setting the enabled status of the excitation source A value of VI_TRUE enables the excitation source A value of VI_FALSE disable...

Page 239: ...the Description section below for more information DATA ITEM RESET VALUE Not applicable to this function DESCRIPTION This function sets the calibration input source to a specified voltage Possible va...

Page 240: ...a specified voltage Valid input values for the calSource parameter are Decimal Value Hex Value define Symbol Nominal Voltage V 0 0x00 VTEX1629_CALSRC_0 0 1 0x01 VTEX1629_CALSRC_P_0_07 0 07 2 0x02 VTEX...

Page 241: ...120 or 350 DATA ITEM RESET VALUE completionResistorMode 0 Full DESCRIPTION This function sets the mode of the completion resistor for a list of channels The acceptable values for the completionResisto...

Page 242: ...cite 5 0x05 VTEX1629_CONFSRC_EXCITE_NEG_SENSE Excite Sense 6 0x06 VTEX1629_CONFSRC_EXCITE_POS_SENSE Excite Sense 7 0x07 VTEX1629_CONFSRC_EXCITE_POS_CURR Excite Current 8 0x08 VTEX1629_CONFSRC_EXCITE_N...

Page 243: ...f the limits on all active confidence sources for a particular channel were exceeded or not This is a 16 bit field stored in the least significant 16 bits of a UINT32 variable 0 Confidence Data within...

Page 244: ...d then they are reported in that order Confidence sources that are not part of the confidence scanlist are not reported and will have their bit fields set to 0 Confidence values are reported at a maxi...

Page 245: ...ws Decimal Value Hex Value define Symbol mode Description 0 0x00 VTEX1629_CONF_LIMIT_DISABLE_REPORT Reporting disabled 1 0x01 VTEX1629_CONF_LIMIT_SUMMARY_REPORT_ONLY Summary report mode selected 2 0x0...

Page 246: ...losed direction an integer input value indicating the desired direction of bank zero of the digital I O Valid input values 0 or 1 DATA ITEM RESET VALUE direction 0 input DESCRIPTION This function sets...

Page 247: ...d pull up mode for bank zero of the digital I O Valid input values 0 or 1 DATA ITEM RESET VALUE pullup 0 passive pull up mode DESCRIPTION This function sets the pull up mode for bank zero of the digit...

Page 248: ...closed direction an integer input value indicating the desired direction of bank one of the digital I O Valid input values 0 or 1 DATA ITEM RESET VALUE direction 0 input DESCRIPTION This function sets...

Page 249: ...ed pull up mode for bank one of the digital I O Valid input values 0 or 1 DATA ITEM RESET VALUE pullup 0 passive pull up mode DESCRIPTION This function sets the pull up mode for bank one of the digita...

Page 250: ...lues 0 through 3 DATA ITEM RESET VALUE pullup 0 passive pull up mode DESCRIPTION This function sets the conditions under which DIO event transitions will occur The numActions parameter defines the siz...

Page 251: ...utTrigType 0 ViInt32 numActions MAX_DIO_CHANNELS ViInt32 outputLineArr MAX_DIO_CHANNELS ViInt32 outputActionTypeArr MAX_DIO_CHANNELS ViInt32 i 0 for i 0 i MAX_DIO_CHANNELS i outputLineArr i i outputAc...

Page 252: ...eight most significant bits to the eight channels of bank one channels 8 15 and the eight least significant bits to the eight channels of bank zero channels 0 7 This is illustrated below bank one cha...

Page 253: ...lue Hex Value define Symbol EU ConversionType Description 0 0x00 VTEX1629_EUCONV_VOLT_OUTPUT Voltage 1 0x01 VTEX1629_EUCONV_QTR_BRIDGE_120 Quarter Bridge 120 2 0x02 VTEX1629_EUCONV_QTR_BRIDGE_350 Quar...

Page 254: ...s fs less than or equal to 1 kHz While in this mode it is advised to give the confidence filters at least 1 5 s to settle from the time the confidence source for excitation voltage is enabled or the e...

Page 255: ...oltage a real input value in volts that indicates the value that should be used in EU conversions for the excitation voltage Valid input values 0 00000 to 16 00000 DATA ITEM RESET VALUE euConversionVo...

Page 256: ...tual value can be queried with the vtex1629_get_excitation function Additionally the accuracy specifications EX1629 Specifications for the instrument require that the excitation voltage be measured se...

Page 257: ...to 48 enabled a Boolean input value which controls the enabling or disabling of the excitation voltage for a given list of channels Valid input values 0 or 1 DATA ITEM RESET VALUE enabled 0 DESCRIPTIO...

Page 258: ...ain a real input value indicating the desired gain value for the given set of channels Valid input values 1 00 10 0 or 100 0 DATA ITEM RESET VALUE gain 1 0 DESCRIPTION This function sets the signal co...

Page 259: ...ontaining a list of channel numbers for which the gage factor will be set Valid input values 0 to 47 numberOfChannels the size of the channels list Valid input values 1 to 48 gageFactor a real input v...

Page 260: ...y of values which set the desensitization error for the channels indicated in the channels array Valid input values are number greater than 1 DATA ITEM RESET VALUE factor 1 DESCRIPTION This function s...

Page 261: ...sform 0 bilinear filterOrder 6 DESCRIPTION This function configures the IIR filters for a given list of channels The filterType parameter has three allowed values Decimal Value Hex Value define Symbol...

Page 262: ...ssion in Appendix B EXAMPLE ViSession instrumentHandle ViStatus status ViInt32 channels 0 ViInt32 numberOfChannels 1 configure IIR filtering on channel 0 with a 5th order Bessel filter with a cutoff f...

Page 263: ...ource The muxInValue parameter can be set to the following values Decimal Value Hex Value define Symbol muxInValue Description 0 0x00 VTEX1629_INPUTMUX_BRIDGE_TYPE_FULL Full Bridge 1 0x01 VTEX1629_INP...

Page 264: ...s the channels to which the factor parameter will apply Valid input values 0 to 47 resistance sets the lead wire resistance value Valid input values are numbers greater than 0 DATA ITEM RESET VALUE re...

Page 265: ...lues 1 to 48 m a real input value indicating the gain factor m in the linear equation y mx b b a real input value indicating the offset value b in the linear equation y mx b DATA ITEM RESET VALUE m 2...

Page 266: ...function enables measurement channels for Limit Events on the specified LXI Trigger Bus line Each of the eight LXI Trigger Bus lines can have a minimum and or maximum limit defined for any and all of...

Page 267: ...hen an over limit condition is met DATA ITEM RESET VALUE latches 0 DESCRIPTION This function sets LXI Trigger Bus lines that will be latched for LXI Limit Event outputs When latching is enabled the tr...

Page 268: ...n 0 0x00 VTEX1629_LXI_LINE_ZERO LXI LINE 0 1 0x01 VTEX1629_LXI_LINE_ONE LXI LINE 1 2 0x02 VTEX1629_LXI_LINE_TWO LXI LINE 2 3 0x03 VTEX1629_LXI_LINE_THREE LXI LINE 3 4 0x04 VTEX1629_LXI_LINE_FOUR LXI L...

Page 269: ...T VTEX1629_LXI_INTERNAL_EXTERNAL status vtex1629_set_lxibus_configuration master_instrumentHandle VTEX1629_LXI_LINE_ONE VTEX1629_LXI_OUTPUT VTEX1629_LXI_INTERNAL_EXTERNAL portion of configuring a slav...

Page 270: ...Trigger Bus channels This function only sets what will be output by the bus but does not actually enable the outputs See vtex1629_set_lxibus_configuration for information on enabling the output The ou...

Page 271: ...While in pattern mode the instrument can accept arm events from the LXI Trigger Bus digital I O bus internal timer and the software ARM command There is no need to explicitly enable the software arm...

Page 272: ...his parameter is often set to the same value as lxiOutput there are cases where it might be set to a different value For instance when the device is configured as a master device in a star multi box c...

Page 273: ...0 0 timer 0 lxiOutput VTEX1629_LXI_LINE_NONE lxiInput VTEX1629_LXI_LINE_NONE DESCRIPTION This function configures the EX1629 s pattern trigger mode of operation This mode allows the EX1629 to accept...

Page 274: ...es the lxiOutput parameter specifies the LXI Trigger Bus line that will be used to communicate the trigger event to the slave devices It is also necessary to configure this LXI Trigger Bus line to be...

Page 275: ...a list of channel numbers for which the Poisson ratio will be set Valid input values 0 to 47 numberOfChannels the size of the channels list Valid input values 1 to 48 poissonRatio a real input value...

Page 276: ...s or as a slave device that receives its sample clock from another device When operating in standalone mode sampleClockMode should be configured as a master The inLine parameter indicates the LXI line...

Page 277: ...0 postTrigSampleCount an integer input value indicating the desired post trigger sample count Valid input values 0 to 400000000 DATA ITEM RESET VALUE preTrigSampleCount 0 postTrigSampleCount 1000 DESC...

Page 278: ...ng frequency of all channels of the EX1629 The EX1629 offers a discrete number of sample frequencies Programmed values that fall between valid values will be rounded to the closest valid value See Sam...

Page 279: ...8 DATA ITEM RESET VALUE channels 0 to 47 DESCRIPTION This function defines a list of channels which will be sampled in the data acquisition process The term scanlist is used although all channels are...

Page 280: ...given list of channels VI_TRUE 1 will enable the shunt resistors for the given list of channels and VI_FALSE 0 will disable the shunt resistors for the given list of channels DATA ITEM RESET VALUE ena...

Page 281: ...RCE_IS_LOCAL Internal local 4 0x04 VTEX1629_SHUNT_SOURCE_TEDS TEDS remote Local and Remote refer to how the shunt resistor is connected to the bridge For Local the connection is made within the EX1629...

Page 282: ...AMPLE ViSession instrumentHandle ViStatus status ViInt32 channels 0 1 2 3 status vtex1629_set_shunt_source instrumentHandle channels 4 SHUNT_SOURCE_TEDS Optional LED 390 390 Rshunt DS2430AP 2 1 RCAL U...

Page 283: ...ront panel remote 1 0x01 VTEX1629_FRONT_PANEL_LOCAL Front panel local 2 0x02 VTEX1629_INTERNAL_REMOTE Internal remote 3 0x03 VTEX1629_INTERNAL_REMOTE Internal local 4 0x04 VTEX1629_TEDS_REMOTE TEDS re...

Page 284: ...indicating whether strain measurements will be returned in units of strain or microstrain Passing a value of VI_TRUE 1 will configure the instrument to return microstrain while passing a value of VI_...

Page 285: ...er device When operating in standalone mode synchMode should be configured as a master The inLine value indicates the LXI line that should be used as the synch input This value is applicable regardles...

Page 286: ...truments Corp 286 EX1629 Command Set EXAMPLE ViSession instrumentHandle ViStatus status status vtex1629_set_synch_source instrumentHandle VTEX1629_SYNC_MODE_MASTER VTEX1629_LXI_LINE_ONE VTEX1629_LXI_L...

Page 287: ...ize of the channels list Valid input values 1 to 48 tareValue a real input value indicating the tare value to set for all the indicated channels DATA ITEM RESET VALUE tareValue 0 00000 DESCRIPTION Thi...

Page 288: ...device Valid input values 0 to 32 tedsInfo an integer input array specifying the TEDS data to be written Each element of this array specifies a byte of TEDS data and the array should not contain any m...

Page 289: ...an integer input value that specifies the trigger count for the EX1629 Valid input values 1 to 231 1 Setting this parameter to 0 makes the trigCount infinite DATA ITEM RESET VALUE trigCount 1 DESCRIP...

Page 290: ...receiving a TRIG event before it begins to acquire data The actual delay exhibited by the EX1629 is dependent on the sample frequency set by calling the vtex1629_set_sample_frequency function The act...

Page 291: ...G_SRC_LXI1_NEG LXI 1 Negative Edge 12 0x0C VTEX1629_TRIG_SRC_LXI2_NEG LXI 2 Negative Edge 13 0x0D VTEX1629_TRIG_SRC_LXI3_NEG LXI 3 Negative Edge 14 0x0E VTEX1629_TRIG_SRC_LXI4_NEG LXI 4 Negative Edge...

Page 292: ...trigger events from multiple sources it is necessary to reserve one of the LXI Trigger Bus line to communicate these events within the device and to other devices in a multi device configuration If t...

Page 293: ...s to 4294 967295 s DATA ITEM RESET VALUE timer 0 DESCRIPTION This function sets the trigger timer period for the EX1629 This is the amount of time in seconds that the EX1629 will wait before generati...

Page 294: ...annels list Valid input values 1 to 48 unstrainedVoltage a real input value that indicates the unstrained voltage to set for the given list of channels DATA ITEM RESET VALUE unstrainedVoltage 0 000000...

Page 295: ...s obtained by the function and remains valid until the session is closed DATA ITEM RESET VALUE Not applicable to this function DESCRIPTION This function sends a software generated arm event to the EX1...

Page 296: ...plicable to this function DESCRIPTION This function sends a software generated synchronization event to the device This is only valid when the device is a synch master see vtex1629_set_synch_source NO...

Page 297: ...ained by the function and remains valid until the session is closed DATA ITEM RESET VALUE Not applicable to this function DESCRIPTION This function sends a software generated trigger event to the EX16...

Page 298: ...ication should allocate VTEX1629_MAX_DIGEST_LENGTH bytes digest the stored configuration s digest digestActualSize the actual size of the configuration digest DATA ITEM RESET VALUE Not applicable to t...

Page 299: ...is handle is obtained by the function and remains valid until the session is closed DATA ITEM RESET VALUE Not applicable to this function DESCRIPTION This function initiates the trigger system Specifi...

Page 300: ...s handle is obtained by the function and remains valid until the session is closed DATA ITEM RESET VALUE Not applicable to this function DESCRIPTION This function unlocks the EX1629 instrument if the...

Page 301: ...equal to VTEX1629_MAX_MLAN_DATA_LEN DATA ITEM RESET VALUE Not applicable to this function DESCRIPTION This function writes a variable sized block of MLAN commands and data to the TEDS EEPROM indicated...

Page 302: ...n DESCRIPTION This function resets the offset values of the unit before a measurement is taken It is designed to be a shorter calibration process than self calibration The overRide parameter is used i...

Page 303: ...ted FFBFFC09FB VTEX1629_ERROR_VXI_11 VXI 11 Error FFBFFC09FC VTEX1629_ERROR_TRIGGER_SYSTEM_ERROR Trigger system error FFBFFC09FD VTEX1629_ERROR_OUT_OF_LINK_IDS Link ID failure FFBFFC09FE VTEX1629_ERRO...

Page 304: ...supported remote procedure call FFBFFC0A28 VTEX1629_ERROR_DATA_FIFO_ERROR Error storing data in the FIFO FFBFFC0A29 VTEX1629_ERROR_SAMPLE_COUNT Invalid sample Count FFBFFC0A2A VTEX1629_ERROR_INCORRECT...

Page 305: ...RROR_CAL_SELF_CAL_NOT_PRESENT Self calibration data is not present FFBFFC0A52 VTEX1629_ERROR_FPGA_TRIGINIT_NOT_IN_IDLE_STATE Trigger state machine is not in the idle state FFBFFC0A53 VTEX1629_ERROR_FP...

Page 306: ...VTEX1629_ERROR_INVALID_TRIGGER_DELAY Invalid trigger delay parameter FFBFFC0A7A VTEX1629_ERROR_INVALID_TIMER_PERIOD Invalid timer period parameter FFBFFC0A7B VTEX1629_ERROR_INVALID_MLAN_DATA_LEN Inva...

Page 307: ...EX1629_ERROR_CONF_LIMIT_NOT_SUPPORTED_AT_CURR_FS Summary reporting or detailed reporting not supported for sampling frequency greater than 1 kHz FFBFFC0AA0 VTEX1629_ERROR_FS_NOT_SUPPORTED_FOR_CONF_LIM...

Page 308: ...ERROR_SCANLIST_CONTAINS_BAD_CHANNEL Scanlist contains channels that failed calibration FFBFFC0AC7 VTEX1629_ERROR_INVALID_LID Invalid link ID FFBFFC0AC8 VTEX1629_ERROR_NOT_CONNECTED Error Not connected...

Page 309: ...T_BRIDGE_NOT_COMPLETE Input bridge not complete FFBFFC0AE6 VTEX1629_WARNING_CAL_BUFFERSIZE_SMALLER_THAN_ACTUAL_SIZE Warning the passed in buffer buffer size are not large enough to hold all of the cal...

Page 310: ...VTI Instruments Corp 310 EX1629 Command Set...

Page 311: ...ve instruments These signals are distributed to the slaves via the LXI Trigger Bus NOTE The sample clock and synchronization signals may only be distributed via the LXI Trigger Bus Further only an EX1...

Page 312: ...T DIGITAL I O VXI Technology LO HI CALIBRATION SENSE Master Slave 2 Slave 1 Slave n Terminator Terminator FIGURE A 1 DAISY CHAIN CONFIGURATION NOTE Due to signal integrity concerns the maximum number...

Page 313: ...TION SENSE Terminator Terminator Terminator Terminator Trigger Bus Hub Master Inputs on LXI 0 3 Outputs on LXI 4 7 Slave 2 Inputs on LXI 4 7 Slave 1 Inputs on LXI 4 7 Slave Inputs on LXI 4 7 n FIGURE...

Page 314: ...nt such as a positive rising edge on LXI Line 3 The Master and the Slave s instruments are configured identically and some external device is used to generate an LXI Trigger Bus event The next simples...

Page 315: ...nalog Ant Aliasing Filter 1 pole RC CIC compensation filter and FIR decimation filter Butterworth Bessel IIR filters with variable fc C6713 DSP fs FIR 100dB stopband attn ripple 0 005dB where fso inpu...

Page 316: ...0938 1 173450 13 49200 250 97 00 40 5 0 479686 0 709252 0 940938 1 173450 13 38250 200 77 60 50 5 0 479686 0 709252 0 940938 1 173450 13 34600 166 67 64 67 60 5 0 479686 0 709252 0 940938 1 173450 13...

Page 317: ...band indicated in the table for a particular fs or if they must reject specific frequencies the user can make use of the IIR filters explained later in this section CIC Filter The CIC filter in the FP...

Page 318: ...et to 0 the DSP determines the order by assuming attenuation of 200 dB in stopband The filter order MUST be specified for Bessel filters the DSP designs a filter implemented as biquad sections The max...

Page 319: ...e group delay of all channels can be queried using the vtex1629_get_IIR_filter_configuration function Group delay values for channels 0 16 and 32 can then be used along with the group delays for the o...

Page 320: ...throughout the passband The warping inherent in the BLT method upsets this linearity The MZT does not warp the frequency scale so a digital Bessel filter designed by this method will have a near linea...

Page 321: ...function is implemented is provided A variant of the GET_URN function can be used to search through multiple devices in order to select a specific device but the example version of this function only...

Page 322: ...individual functions for WRITE READ and COPY can cause data loss and the recommended method is to use the WRITE_AND_COPY command and read main memory COPY_SCRATCHPAD allows the user to transfer the sc...

Page 323: ...st byte for length SendPkt sendLen CMD_RESET SendPkt sendLen CMD_GETBUF SendPkt 0 sendLen 1 MLanHostPacketSend SendPkt channel recLen MLanHostPacketReceive RecPkt channel MLAN_PACKET_SIZE return recLe...

Page 324: ...ength 3 02 84 85 got a packet without errors on receive Packet length 3 03 84 86 02 This time 3 bytes were received The 84 for CMD_RESET and then 86 02 From IEEE 1451 4 Annex G 86 is the code for CMD_...

Page 325: ...de of the device in this case indicating that it is a DS2430 The 14 is the first byte of the unique serial number and the 08 before it is the length of that serial number The DS2431 s family code is 2...

Page 326: ...device Since the entire scratchpad length is being written that must be included Then the data length block the WRITE_SCRATCHPAD command itself and the 0 which is the address in memory that the scratc...

Page 327: ...ad_2430 int channel int sendLen recLen 0 sendLen 1 reserve first byte for length access the current device with address in DATA_ID SendPkt sendLen CMD_ML_ACCESS construct a block of communication to M...

Page 328: ...access the current device with address in DATA_ID SendPkt sendLen CMD_ML_ACCESS construct a block of communication to MicroLAN SendPkt sendLen CMD_ML_DATA SendPkt sendLen 3 block length SendPkt sendL...

Page 329: ...0 sendLen 1 reserve first byte for length access the current device with address in DATA_ID SendPkt sendLen CMD_ML_ACCESS construct a block of communication to MicroLAN SendPkt sendLen CMD_ML_DATA Se...

Page 330: ...Because the read and write is accomplished in a single command data integrity cannot be verified before it is copied to memory e g a READ_SCRATCHPAD command cannot be performed in the middle of a WRIT...

Page 331: ...y However since they are issued in a single MLAN buffer the device will not be powered down and will not have a chance to lose its volatile data The example output of the WRITE_AND_COPY command is fai...

Page 332: ...e the frame MLanHostPacketSend SendPkt channel CRCcalc SendPkt 6 11 recLen MLanHostPacketReceive RecPkt channel MLAN_PACKET_SIZE return recLen Notice first that in comparison to the DS2430 scratchpad...

Page 333: ...tput for the WRITE_SCRATCHPAD command for the DS2431 is very similar to the WRITE_SCRATCHPAD for the DS2430 with the exception that the data is shorter sent packet without errors Packet length 17 10 8...

Page 334: ...h access the current device with address in DATA_ID SendPkt sendLen CMD_ML_ACCESS construct a block of communication to MicroLAN SendPkt sendLen CMD_ML_DATA SendPkt sendLen 5 block length SendPkt send...

Page 335: ...nt totRecLen 0 int i 0 for i 0 i float DS2431_MEMORY_LEN float EX1629_MAX_TEDS_READ i sendLen 1 reserve first byte for length access the current device with address in DATA_ID SendPkt sendLen CMD_ML_A...

Page 336: ...2 F0 60 00 85 got a packet without errors on receive Packet length 39 26 82 00 0A 22 F0 60 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 sent packet w...

Page 337: ...ratchpad address must be between 0 and 88 hex n return 1 SendPkt sendLen address SendPkt sendLen 0 the 5 bytes of data to write for i 0 i 2 DS2431_SCRATCHPAD_LEN DS2431_SCRATCHPAD_LEN 1 i 3 strncpy by...

Page 338: ...l write ADDITIONAL NOTES Checksums It should be noted that a page in the main memory of 1 Wire device consists of 32 bytes according to the IEEE 1451 4 specification Each page of memory is supposed to...

Page 339: ...esult 0 ViChar error 256 add platform protocol specific code here result vtex1629_write_teds_MLAN vi channel send_packet 0 1 send_packet if result 0 vtex1629_error_message vi result error printf Error...

Page 340: ...to platform endian ness before inverting the CRC This is what the MLAN bus master will return to us on a little endian host computer like an x86 CPU Intel or AMD a byte swapped inverted CRC16 This wa...

Page 341: ...Mb Flash Intel JS28F128J3D75 No Kernel and File System No N A Time Config Yes Go to webpage change values Factory cal coeffecients Yes Cannot clear can overwrite by running factory cal again Stored se...

Page 342: ...VTI Instruments Corp 342 EX1629 Onboard Memory...

Page 343: ...IC compensation filter 315 FIR decimation filter 316 IIR filters 316 E engineering unit conversion 43 engineering unit conversion calculations full bridge bending Poisson strain 47 full bridge bending...

Page 344: ...DS2430 327 DS2431 329 333 READ_SCRATCHPAD 319 320 DS2430 325 DS2431 331 reboot web page 69 reset network configuration 62 reset web page 69 retreiving data 85 asynchronous streaming data interface 87...

Page 345: ...629_get_excitation_enabled 154 vtex1629_get_fifo_count 155 vtex1629_get_gain 156 vtex1629_get_gauge_factor 157 vtex1629_get_half_bridge_lead_wire_desensitization 158 vtex1629_get_IIR_filter_configurat...

Page 346: ...i_bus_output 268 vtex1629_set_lxibus_configuration 266 vtex1629_set_pattern_arm_configuration 269 vtex1629_set_pattern_trig_configuration 271 vtex1629_set_poisson_ratio 273 vtex1629_set_sample_clock_s...

Search results

Summary of Contents for EX1629

Reviews:

Related manuals for EX1629

Brands by name

Popular brands

VTI Instruments EX1629, User Manual

Search results

Summary of Contents for EX1629

Reviews:

Related manuals for EX1629

Brands by name

Popular brands