Page 1 Agilent E5022A/B and E5023A Hard Disk Read/Write Test System Programming Manual for E5039A/B/C Seventh Edition Software Revision This manual applies directly to system which has the software revision B.02.70 and above Part No. E5023-90023 January 2003 Printed in Japan...
Page 2 This document contains proprietary information that is protected by copyright.All rights are reserved. No part of this document may be photocopied, reproduced, or translated to another language without the prior written consent of the Agilent Technologies, Inc. Agilent Technologies Japan, Ltd.
Page 3 SAMPLE PROGRAMS or modification of any part thereof. Agilent Technologies shall not be liable for the quality, performance, or behavior of the SAMPLE PROGRAMS. Agilent Technologies especially disclaims that the operation of the SAMPLE PROGRAMS shall be uninterrupted or error free.
Page 5: Table Of Contents
Contents 1. Introduction Introduction................10 About This Manual .
Page 6 Contents hpe5022_BER_syncWindow_Q ............77 hpe5022_BER_syncWindowMode.
Page 7 Contents hpe5022_BER_berDataLoggingMode_Q..........143 hpe5022_BER_burstThreshold .
Page 8 Contents hpe5022_BER_setupChannelIcMultipleRegisterSweep ........233 hpe5022_BER_channelIcMultipleRegisterSweepData_Q ........237 hpe5022_BER_channelBoardIoData .
Page 9: Introduction
Introduction...
Page 10: Introduction
Introduction Introduction Introduction Welcome to the Agilent Technologies E5022/E5023 Programming Manual for E5039A/B. This manual provides the information on bit error measurement functions of E5039A/B used for programming. About This Manual This manual contains the following chapters: • Chapter 1, Introduction : gives an overview of this manual.
Page 11: Sample Program
Sample Program...
Page 12: Example Program
Sample Program Example Program Example Program This section describes the example programs for typical measurements. The sample program is saved at the directory named “c:\Program Files\Agilent\E5022\doc\vb\sample1.vbp” As the programming manual explains, Measurement Sequence is basically divided into six steps; Initializing, Drive On, Auto Configuration, Common Setup &...
Page 13 Sample Program Bit Error Test Measurement ErrorCheck hpe5022_BER_channelIcReferenceClock(HpE5022, ReferenceClock) ' Create BER Data Pattern bitLength = Len(BerTestPattern1) ErrorCheck hpe5022_BER_userPattern(HpE5022, hpe5022_BER_PAT_1, hpe5022_USER_DATA_BIN, bitLength, _ BerTestPattern1) ErrorCheck hpe5022_BER_selectPattern(HpE5022, hpe5022_BER_PAT_1) ' Define Track and Sector Format ErrorCheck hpe5022_BER_trackFormat(HpE5022, TrackPreambleLength, NoOfSector, VI_FALSE, GapLength) ErrorCheck hpe5022_BER_sectorFormat(HpE5022, SectPreambleLength, DataLength) ErrorCheck hpe5022_BER_berMeasByteCount(HpE5022, MeasByteCount) ErrorCheck hpe5022_BER_errorBitPerByte(HpE5022, ErrBitPerByte) ErrorCheck hpe5022_BER_channelIcFirCoefReset(HpE5022)
Page 14: Description
Sample Program Bit Error Test Measurement ' Perform Measurement ErrorCheck hpe5022_BER_measureBer(HpE5022, hpe5022_SEQ_ER_WR_M, noofave) ' Query Test Result ErrorCheck hpe5022_BER_ber_Q(HpE5022, ber, symbol, totalSector, lostSector) ErrorCheck hpe5022_BER_sectorErrorCountSize_Q(HpE5022, NumOfSize) ReDim ErrorCount(NumOfSize - 1) ReDim LostCount(NumOfSize - 1) ErrorCheck hpe5022_BER_sectorErrorCount_Q(HpE5022, ErrorCount(0), LostCount(0)) Disp$ = "Bit Error Rate: " + vbCrLf _ + "BER: "...
Page 15 Sample Program Bit Error Test Measurement “hpe5022_BER_optimizeState” “hpe5022_BER_optimize” “hpe5022_BER_berMeasByteCount” “hpe5022_BER_errorBitPerByte” “hpe5022_BER_berDataLoggingMode” “hpe5022_BER_measureBer” “hpe5022_BER_ber_Q” “hpe5022_BER_sectorErrorCountSize_Q” “hpe5022_BER_sectorErrorCount_Q” Chapter 2...
Page 16: Bit Error Track Profile Measurement
Sample Program Bit Error Track Profile Measurement Bit Error Track Profile Measurement The bit error track profile measurement allows you to observe read offset characteristics of the bit error rate. Example 2-2. Sample Program Private Sub CmdBerTrackProfile_Click() Const BerUserDataBitRate As Double = 120000000# Const ReferenceClock As Double = 20000000# Const BerTestPattern1 As String = "11001000"...
Page 17 Sample Program Bit Error Track Profile Measurement ErrorCheck hpe5022_BER_trackFormat(HpE5022, TrackPreambleLength, NoOfSector, VI_FALSE, GapLength) ErrorCheck hpe5022_BER_sectorFormat(HpE5022, SectPreambleLength, DataLength) ErrorCheck hpe5022_BER_berMeasByteCount(HpE5022, MeasByteCount) ErrorCheck hpe5022_BER_errorBitPerByte(HpE5022, ErrBitPerByte) ErrorCheck hpe5022_BER_channelIcFirCoefReset(HpE5022) ' Precompensation State ErrorCheck hpe5022_BER_channelIcPrecompState(HpE5022, VI_TRUE) ' Define Encorder ErrorCheck hpe5022_BER_channelIcEndec(HpE5022, VI_TRUE, hpe5022_BER_ENDEC_8_9, VI_TRUE) ' Defiene OTC Threshold Level ErrorCheck hpe5022_BER_otcThreshold(HpE5022, otcThreshold) ' Define Optimization ErrorCheck hpe5022_BER_optimizeState(HpE5022, hpe5022_BER_OPT_LPF, VI_TRUE)
Page 18: Functions Used In This Measurement
Sample Program Bit Error Track Profile Measurement End Sub Functions used in this measurement “hpe5022_wai” “hpe5022_abort” “hpe5022_executionMode” “hpe5022_BER_userDataBitRate” “hpe5022_BER_trackFormat” “hpe5022_BER_sectorFormat” “hpe5022_BER_selectPattern” “hpe5022_BER_userPattern” “hpe5022_BER_channelIc_Idn_Q” “hpe5022_BER_channelIcReferenceClock” “hpe5022_BER_channelIcLowPassFilter_Q” “hpe5022_BER_channelIcFirCoefReset” “hpe5022_BER_channelIcPrecompState” “hpe5022_BER_channelIcEndec” “hpe5022_BER_optimizeState” “hpe5022_BER_optimize” “hpe5022_BER_berMeasByteCount” “hpe5022_BER_errorBitPerByte” “hpe5022_BER_measureTrackProfile” “hpe5022_BER_trackProfileData_Q” Chapter 2...
Page 19: Function Reference
Function Reference This section describes the functions related with the measurement by bit error analysis. Bit Error measurement is performed by a bit error test module. If an Agilent E5039A/B is not installed in your system, this function cannot be used.
Page 20: Ber Data Pattern Definition Function
Function Reference BER Data Pattern Definition Function BER Data Pattern Definition Function hpe5022_BER_userDataBitRate C Syntax ViStatus hpe5022_BER_userDataBitRate(ViSession id, ViReal64 dataRate); Visual Basic hpe5022_BER_userDataBitRate(ByVal id As Long, ByVal dataRate As Double) Syntax As Long Description This function specifies the user data bit rate. This rate represents the speed at which the user data is recorded on the media.
Page 21 Function Reference BER Data Pattern Definition Function Error Code Description hpe5022_ERROR_NOT_INIT The resource of Agilent E5039A/B can not be opened during initialization. Check if Agilent E5039A/B is included in the rsrcArray of the “hpe5022_init” function. See Also “hpe5022_BER_userDataBitRate_Q” on page 22 Chapter 3...
Page 22: Hpe5022_Ber_Userdatabitrate_Q
Function Reference BER Data Pattern Definition Function hpe5022_BER_userDataBitRate_Q C Syntax ViStatus hpe5022_BER_userDataBitRate_Q(ViSession id, ViPReal64 dataRate); Visual Basic hpe5022_BER_userDataBitRate_Q(ByVal id As Long, ByRef dataRate As Syntax Double) As Long Description This function returns the data bit rate specified by the “hpe5022_BER_userDataBitRate” function. Parameters •...
Page 23: Hpe5022_Ber_Trackformat
Function Reference BER Data Pattern Definition Function hpe5022_BER_trackFormat C Syntax ViStatus hpe5022_BER_trackFormat(ViSession id, ViInt32 tracPre, ViInt16 sector, ViBoolean gapAuto, ViInt32 gap); Visual Basic hpe5022_BER_trackFormat(ByVal id As Long, ByVal tracPre As Long, ByVal Syntax sector As Integer, ByVal gapAuto As Integer, ByVal gap As Long) As Long Description This function specifies the track format.
Page 24 Function Reference BER Data Pattern Definition Function Values Name Value hpe5022_BER_TRAC_PRE_LENG_MIN hpe5022_BER_TRAC_PRE_LENG_MAX 100,000 Unit Byte • sector Description Specifies the number of sectors per track. Direction Preset Value hpe5022_BER_SECT_COUN_MIN) Values Name Value hpe5022_BER_SECT_COUN_MIN hpe5022_BER_SECT_COUN_MAX 1024 • gapAuto Description Specifies the length of gap to adjust automatically. In auto mode, the length of gap is adjusted so that the data length occupies the entire track length.
Page 25 Function Reference BER Data Pattern Definition Function Values Name Value Description VI_FALSE auto mode is Off VI_TRUE auto mode is On • gap Description Specifies the length of the gap. When ‘gapAuto’ is set to “VI_TRUE”, this value is not valid. Direction Preset Value Unit...
Page 26: Hpe5022_Ber_Trackformat_Q
Function Reference BER Data Pattern Definition Function hpe5022_BER_trackFormat_Q C Syntax ViStatus hpe5022_BER_trackFormat_Q(ViSession id, ViPInt32 tracPre, ViPInt16 sector, ViPBoolean gapAuto, ViPInt32 gap); Visual Basic hpe5022_BER_trackFormat_Q(ByVal id As Long, ByRef tracPre As Long, ByRef Syntax sector As Integer, ByRef gapAuto As Integer, ByRef gap As Long) As Long Description This function returns the track format specified by the “hpe5022_BER_trackFormat”...
Page 27 Function Reference BER Data Pattern Definition Function Error Code Description hpe5022_ERROR_INV_ID The handle specified by ‘id’ is invalid. hpe5022_ERROR_NOT_INIT The resource of Agilent E5039A/B can not be opened during initialization. Check if Agilent E5039A/B is included in the rsrcArray of the “hpe5022_init” function. See Also “hpe5022_BER_trackFormat”...
Page 28: Hpe5022_Ber_Sectorformat
Function Reference BER Data Pattern Definition Function hpe5022_BER_sectorFormat C Syntax ViStatus hpe5022_BER_sectorFormat(ViSession id, ViInt32 sectPre, ViInt32 data); Visual Basic hpe5022_BER_sectorFormat(ByVal id As Long, ByVal sectPre As Long, ByVal Syntax data As Long ) As Long Description This function specifies the sector format. A sector consists of a sector preamble, a synchronize pattern and data pattern.
Page 29 Function Reference BER Data Pattern Definition Function Values Name Value hpe5022_BER_SECT_PRE_LENG_MIN hpe5022_BER_SECT_PRE_LENG_MAX 50,000 Unit Byte • data Description Specifies the length of data. Direction Preset Value 1000 Values Name Value hpe5022_BER_SECT_DATA_LENG_MIN hpe5022_BER_SECT_DATA_LENG_MAX 1,000,000 Unit Byte Return Values Completion Code Description VI_SUCCESS No Error Error Code...
Page 30: Hpe5022_Ber_Sectorformat_Q
Function Reference BER Data Pattern Definition Function hpe5022_BER_sectorFormat_Q C Syntax ViStatus hpe5022_BER_sectorFormat_Q(ViSession id, ViPInt32 sectPre, ViPInt32 data); Visual Basic hpe5022_BER_sectorFormat_Q(ByVal id As Long, ByRef sectPre As Long, Syntax ByRef data As Long ) As Long Description This function returns the sector format specified by the “hpe5022_BER_sectorFormat”...
Page 31: Hpe5022_Ber_Selectpattern
Function Reference BER Data Pattern Definition Function hpe5022_BER_selectPattern C Syntax ViStatus hpe5022_BER_selectPattern(ViSession id, ViInt16 pat); Visual Basic hpe5022_BER_selectPattern(ByVal id As Long, ByVal pat As Integer) As Long Syntax Description This function selects the data pattern for bit error measurement. Agilent E5022/E5023 has six user-specified data patterns for bit error measurement.
Page 32 Function Reference BER Data Pattern Definition Function Error Code Description hpe5022_ERROR_NOT_INIT The resource of Agilent E5039A/B can not be opened during initialization. Check if Agilent E5039A/B is included in the rsrcArray of the “hpe5022_init” function. See Also “hpe5022_BER_selectPattern_Q” on page 33 “hpe5022_BER_prbsPattern”...
Page 33: Hpe5022_Ber_Selectpattern_Q
Function Reference BER Data Pattern Definition Function hpe5022_BER_selectPattern_Q C Syntax ViStatus hpe5022_BER_selectPattern_Q(ViSession id, ViPInt16 pat); Visual Basic hpe5022_BER_selectPattern_Q(ByVal id As Long, ByRef pat As Integer) As Syntax Long Description This function returns the selected data pattern for bit error measurement by “hpe5022_BER_selectPattern”...
Page 34: Hpe5022_Ber_Prbspattern
Function Reference BER Data Pattern Definition Function hpe5022_BER_prbsPattern C Syntax ViStatus hpe5022_BER_prbsPattern(ViSession id, ViInt16 pat, ViInt32 rand_coef, ViInt32 rand_init); Visual Basic hpe5022_BER_prbsPattern(ByVal id As Long, ByVal pat As Integer, ByVal Syntax rand_coef As Long, ByVal rand_init As Long) As Long Description This function configures the PRBS (pseudo random bit sequence) pattern and assigns the data pattern number.
Page 35 Function Reference BER Data Pattern Definition Function Values Name Value hpe5022_BER_RAND_INIT_MIN hpe5022_BER_RAND_INIT_MAX 65535 Return Values Completion Code Description VI_SUCCESS No Error Error Code Description hpe5022_ERROR_INV_ID The handle specified by ‘id’ is invalid hpe5022_ERROR_INV_PARAMETER The following parameter ‘pat’, ‘rand_coef’ and/or ‘rand_init’ is out of range. hpe5022_ERROR_NOT_INIT The resource of Agilent E5039A/B can not be opened during initialization.
Page 36: Hpe5022_Ber_Prbspattern_Q
Function Reference BER Data Pattern Definition Function hpe5022_BER_prbsPattern_Q C Syntax ViStatus hpe5022_BER_prbsPattern_Q(ViSession id, ViInt16 pat, ViPInt32 rand_coef, ViPInt32 rand_init); Visual Basic hpe5022_BER_prbsPattern_Q(ByVal id As Long, ByVal pat As Integer, ByRef Syntax rand_coef As Long, ByRef rand_init As Long) As Long Description This function returns the PRBS pattern configuration.
Page 37 Function Reference BER Data Pattern Definition Function Error Code Description hpe5022_ERROR_PAT_MISMATCH The selected pattern is a user defined data pattern. Use the “hpe5022_BER_userPattern_Q” function instead of this function. See Also “hpe5022_BER_prbsPattern” on page 34 “hpe5022_BER_selectPattern” on page 31 “hpe5022_BER_userPattern_Q” on page 40 Chapter 3...
Page 38: Hpe5022_Ber_Userpattern
Function Reference BER Data Pattern Definition Function hpe5022_BER_userPattern C Syntax ViStatus hpe5022_BER_userPattern(ViSession id, ViInt16 pat, ViInt16 dataForm, ViInt32 bitLength, const ViChar data[]); Visual Basic hpe5022_BER_userPattern(ByVal id As Long, ByVal pat As Integer, ByVal Syntax dataForm As Integer, ByVal bitLength As Long, ByVal data As String) As Long Description This function specifies the user-defined data pattern.
Page 39 Function Reference BER Data Pattern Definition Function Values Name Value hpe5022_PAT_LENGTH_MIN hpe5022_PAT_LENGTH_MAX 32,768 • data Description Specifies the user-defined data. In case of the hexadecimal format, the data is generated from the most significant bit to the least significant bit. Direction Preset Value 1 (in binary format, for all BER user data pattern)
Page 40: Hpe5022_Ber_Userpattern_Q
Function Reference BER Data Pattern Definition Function hpe5022_BER_userPattern_Q C Syntax ViStatus hpe5022_BER_userPattern_Q(ViSession id, ViInt16 pat, ViInt16 dataForm, ViPInt32 bitLength, ViChar data); Visual Basic hpe5022_BER_userPattern_Q(ByVal id As Long, ByVal pat As Integer, ByVal Syntax dataForm As Integer, ByRef bitLength As Long, ByVal data As String) As Long Description This function returns the user-defined data pattern specified by the “hpe5022_BER_userPattern”...
Page 41 Function Reference BER Data Pattern Definition Function Direction Return Values Completion Code Description VI_SUCCESS No Error Error Code Description hpe5022_ERROR_INV_ID The handle specified by ‘id’ is invalid. hpe5022_ERROR_INV_PARAMETER The parameter ‘pat’ and/or ‘dataForm’ is out of range. hpe5022_ERROR_NOT_INIT The resource of Agilent E5039A/B can not be opened during initialization.
Page 42: Hpe5022_Ber_Patterntype_Q
Function Reference BER Data Pattern Definition Function hpe5022_BER_patternType_Q C Syntax ViStatus hpe5022_BER_patternType_Q(ViSession id, ViInt16 pat, ViPInt16 patType); Visual Basic hpe5022_BER_patternType_Q(ByVal id As Long, ByVal pat As Integer, ByRef Syntax patType As Integer) As Long Description This function returns the type of data pattern, i.e. user data pattern or pseudo random sequence data pattern.
Page 43 Function Reference BER Data Pattern Definition Function Error Code Description hpe5022_ERROR_NOT_INIT The resource of Agilent E5039A/B can not be opened during initialization. Check if Agilent E5039A/B is included in the rsrcArray of the “hpe5022_init” function. See Also “hpe5022_BER_selectPattern” on page 31 Chapter 3...
Page 44: Hpe5022_Ber_Sectorpattern_Q
Function Reference BER Data Pattern Definition Function hpe5022_BER_sectorPattern_Q C Syntax ViStatus hpe5022_BER_sectorPattern_Q (ViSession id, ViInt16 pat, ViInt16 sector, ViChar data[]); Visual Basic hpe5022_BER_sectorPattern_Q(ByVal id As Long, ByVal pat As Integer, ByVal Syntax sector As Integer, ByVal data As String) As Long Description This function returns the data pattern in the specified sector of the specified data pattern.
Page 45 Function Reference BER Data Pattern Definition Function Error Code Description hpe5022_ERROR_NOT_INIT The resource of Agilent E5039A/B can not be opened during initialization. Check if Agilent E5039A/B is included in the rsrcArray of the “hpe5022_init” function. See Also “hpe5022_BER_selectPattern” on page 31 “hpe5022_BER_trackFormat”...
Page 46: Hpe5022_Ber_Adjacenttrackpattern
Function Reference BER Data Pattern Definition Function hpe5022_BER_adjacentTrackPattern C Syntax ViStatus hpe5022_BER_adjacentTrackPattern(ViSession id, ViInt16 backAdjType, ViInt16 backAdjPat, ViReal64 backAdjPos, ViInt16 foreAdjType, ViInt16 foreAdjPat, ViReal64 foreAdjPos); Visual Basic hpe5022_BER_adjacentTrackPattern(ByVal id As Long, ByVal backAdjType As Syntax Integer, ByVal backAdjPat As Integer, ByVal backAdjPos As Integer, ByVal foreAdjType As Integer, ByVal foreAdjPat As Integer, ByVal foreAdjPos As Integer) As Long Description...
Page 47 Function Reference BER Data Pattern Definition Function Values Types of Background Adjacent Track Value hpe5022_BER_ADJACENT_TRACK_NONE hpe5022_BER_ADJACENT_TRACK_INNER hpe5022_BER_ADJACENT_TRACK_OUTER hpe5022_BER_ADJACENT_TRACK_BOTH • backAdjPat Description Specifies the type of data pattern of the background adjacent track. Direction Preset Value hpe5022_BER_PAT_2 Values Data Pattern Value hpe5022_BER_PAT hpe5022_BER_PAT_ hpe5022_BER_PAT_...
Page 48 Function Reference BER Data Pattern Definition Function Direction Preset Value hpe5022_BER_ADJACENT_TRACK_NONE Values Types of Foreground Adjacent Track Value hpe5022_BER_ADJACENT_TRACK_NONE hpe5022_BER_ADJACENT_TRACK_INNER hpe5022_BER_ADJACENT_TRACK_OUTER hpe5022_BER_ADJACENT_TRACK_BOTH • foreAdjPat Description Specifies the type of data pattern of the foreground adjacent track. Direction Preset Value hpe5022_BER_PAT_2 Values Data Pattern Value...
Page 49 Function Reference BER Data Pattern Definition Function Return Values Completion Code Description VI_SUCCESS No Error Error Code Description hpe5022_ERROR_INV_ID The handle specified by ‘id’ is invalid. hpe5022_ERROR_INV_PARAMETER The parameters ‘backAdjType’, ‘backAdjPat’, ‘backAdjPos’ , ‘foreAdjType’, ‘foreAdjPat’ and/or ‘foreAdjPos’are out of range. hpe5022_ERROR_NOT_INIT The resource of Agilent E5039A/B can not be opened during initialization.
Page 50: Hpe5022_Ber_Adjacenttrackpattern_Q
Function Reference BER Data Pattern Definition Function hpe5022_BER_adjacentTrackPattern_Q C Syntax ViStatus hpe5022_BER_adjacentTrackPattern_Q(ViSession id, ViPInt16 backAdjType, ViPInt16 backAdjPat, ViPReal64 backAdjPos, ViPInt16 foreAdjType, ViPInt16 foreAdjPat, ViPReal64 foreAdjPos); Visual Basic hpe5022_BER_adjacentTrackPattern_Q(ByVal id As Long, ByRef backAdjType Syntax As Integer, ByRef backAdjPat As Integer, ByRef backAdjPos As Double, ByRef foreAdjType As Integer, ByRef foreAdjPat As Integer, ByRef foreAdjPos As Double) As Long Description...
Page 51 Function Reference BER Data Pattern Definition Function adjacent track is written. Direction Return Values Completion Code Description VI_SUCCESS No Error Error Code Description hpe5022_ERROR_INV_ID The handle specified by ‘id’ is invalid. hpe5022_ERROR_NOT_INIT The resource of Agilent E5039A/B can not be opened during initialization. Check if Agilent E5039A/B is included in the rsrcArray of the “hpe5022_init”...
Page 52: Hpe5022_Ber_Triggerdelaytime
Function Reference BER Data Pattern Definition Function hpe5022_BER_triggerDelayTime C Syntax ViStatus hpe5022_BER_triggerDelayTime(ViSession id, ViReal64 time); Visual Basic hpe5022_BER_triggerDelayTime(ByVal id As Long, ByVal time As Double) As Syntax Long Description This function specifies the trigger delay time from the index of the spinstand. Parameters •...
Page 53: Hpe5022_Ber_Triggerdelaytime_Q
Function Reference BER Data Pattern Definition Function hpe5022_BER_triggerDelayTime_Q C Syntax ViStatus hpe5022_BER_triggerDelayTime_Q(ViSession id, ViPReal64 time); Visual Basic hpe5022_BER_triggerDelayTime_Q(ByVal id As Long, ByRef time As Double) Syntax As Long Description This function returns the trigger delay time from the index of the spinstand. Parameters •...
Page 54: Hpe5022_Ber_Usersyncpattern
Function Reference BER Data Pattern Definition Function hpe5022_BER_userSyncPattern C Syntax ViStatus hpe5022_BER_userSyncPattern(ViSession id, ViInt16 dataForm, ViInt16 fieldLength, ViInt32 bitLength, const ViChar data[]); Visual Basic hpe5022_BER_userSyncPattern(ByVal id As Long, ByVal dataForm As Integer, Syntax ByVal fieldLength As Integer, ByVal bitLength As Long, ByVal data As String) As Long Description This function is used to specify the user-defined synchronized pattern.
Page 55 Function Reference BER Data Pattern Definition Function disabled. Direction Preset Value hpe5022_BER_SYNC_PATT_LENGTH_MIN Value Name Value hpe5022_BER_SYNC_PATT_LENGTH_MIN hpe5022_BER_SYNC_PATT_LENGTH_MAX • data Description Specifies the user-defined synchronized pattern data. User-defined synchronized pattern bit sequence is generated MSB first and LSB last in hexadecimal data format. Direction Return Values Completion Code...
Page 56: Hpe5022_Ber_Usersyncpattern_Q
Function Reference BER Data Pattern Definition Function hpe5022_BER_userSyncPattern_Q C Syntax ViStatus hpe5022_BER_userSyncPattern_Q(ViSession id, ViInt16 dataForm, ViPInt16 fieldLength, ViPInt32 bitLength, ViChar data[]); Visual Basic hpe5022_BER_userSyncPattern_Q(ByVal id As Long, ByVal dataForm As Syntax Integer, ByRef fieldLength As Integer, ByRef bitLength As Long, ByVal data As String) As Long Description This function queries the user-defined synchronized pattern.
Page 57 Function Reference BER Data Pattern Definition Function Error Code Description hpe5022_ERROR_INV_ID The handle specified by ‘id’ is invalid. hpe5022_ERROR_NOT_INIT The resource of Agilent E5039C cannot be opened during initialization. Check if the Agilent E5039C is included in the rsrcArray of the “hpe5022_init” function. hpe5022_ERROR_NSUP_FUNC This function is not supported by the module currently in use.
Page 58: Hpe5022_Ber_Usersyncpatternstate
Function Reference BER Data Pattern Definition Function hpe5022_BER_userSyncPatternState C Syntax ViStatus hpe5022_BER_userSyncPatternState(ViSession id, ViBoolean state); Visual Basic hpe5022_BER_userSyncPatternState(ByVal id As Long, ByVal state As Integer) Syntax As Long Description This function specifies the state of the user-defined synchronized pattern. This function is only available for use with the E5039C bit error test module.
Page 59: Hpe5022_Ber_Usersyncpatternstate_Q
Function Reference BER Data Pattern Definition Function hpe5022_BER_userSyncPatternState_Q C Syntax ViStatus hpe5022_BER_userSyncPatternState_Q(ViSession id, ViPBoolean state); Visual Basic hpe5022_BER_userSyncPatternState_Q(ByVal id As Long, ByRef state As Syntax Integer) As Long Description This function returns the state of the user-defined synchronized pattern. This function is only available for use with the E5039C bit error test module.
Page 60: Hpe5022_Ber_Sectorstate
Function Reference BER Data Pattern Definition Function hpe5022_BER_sectorState C Syntax ViStatus hpe5022_BER_sectorState(ViSession id, ViInt16 sector, ViBoolean state); Visual Basic hpe5022_BER_sectorState(ByVal id As Long, ByVal sector As Integer, ByVal Syntax state As Integer) As Long Description This function specifies the read state of specified sector in read operation. This function is only available for use with the E5039C bit error test module.
Page 61 Function Reference BER Data Pattern Definition Function Error Code Description hpe5022_ERROR_INV_ID The handle specified by ‘id’ is invalid. hpe5022_ERROR_NOT_INIT The resource of Agilent E5039C can not be opened during initialization. Check if the Agilent E5039C is included in the rsrcArray of the “hpe5022_init” function. hpe5022_ERROR_INV_PARAMETER The parameter ‘sector’...
Page 62: Hpe5022_Ber_Sectorstate_Q
Function Reference BER Data Pattern Definition Function hpe5022_BER_sectorState_Q C Syntax ViStatus hpe5022_BER_sectorState_Q(ViSession id, ViInt16 sector, ViPBoolean state); Visual Basic hpe5022_BER_sectorState_Q(ByVal id As Long, ByVal sector As Integer, ByRef Syntax state As Integer) As Long Description This function returns the read state of specified sector in read operation. This function is only available for use with the E5039C bit error test module.
Page 63 Function Reference BER Data Pattern Definition Function Error Code Description hpe5022_ERROR_INV_ID The handle specified by ‘id’ is invalid. hpe5022_ERROR_NOT_INIT The resource of Agilent E5039C can not be opened during initialization. Check if the Agilent E5039C is included in the rsrcArray of the “hpe5022_init” function. hpe5022_ERROR_INV_PARAMETER The parameter ‘sector’...
Page 64: Hpe5022_Ber_Sectorstatereset
Function Reference BER Data Pattern Definition Function hpe5022_BER_sectorStateReset C Syntax ViStatus hpe5022_BER_sectorStateReset(ViSession id); Visual Basic hpe5022_BER_sectorStateReset(ByVal id As Long) As Long Syntax Description This function sets all sector state to reset value (i.e. VI_TRUE). This function is only available for use with the E5039C bit error test module. Parameters •...
Page 65: Hpe5022_Ber_Sectorcount
Function Reference BER Data Pattern Definition Function hpe5022_BER_sectorCount C Syntax ViStatus hpe5022_BER_sectorCount(ViSession id, ViInt16 sector); Visual Basic hpe5022_BER_sectorCount(ByVal id As Long, ByVal sector As Integer) As Long Syntax Description This function specifies the number of sectors. Parameters • id Description Specifies the system identifier.
Page 66: Hpe5022_Ber_Sectorcount_Q
Function Reference BER Data Pattern Definition Function hpe5022_BER_sectorCount_Q C Syntax ViStatus hpe5022_BER_sectorCount_Q(ViSession id, ViPInt16 sector); Visual Basic hpe5022_BER_sectorCount_Q(ByVal id As Long, ByRef sector As Integer) As Syntax Long Description This function returns the number of sectors. Parameters • id Description Specifies the system identifier.
Page 67: Hpe5022_Ber_Sectorgateperiod
Function Reference BER Data Pattern Definition Function hpe5022_BER_sectorGatePeriod C Syntax ViStatus hpe5022_BER_sectorGatePeriod(ViSession id, ViReal64 period); Visual Basic hpe5022_BER_sectorGatePeriod(ByVal id As Long, ByVal period As Double) As Syntax Long Description This function specifies the sector gate period. This function is only available for use with the E5039C bit error test module.
Page 68: Hpe5022_Ber_Sectorgateperiod_Q
Function Reference BER Data Pattern Definition Function hpe5022_BER_sectorGatePeriod_Q C Syntax ViStatus hpe5022_BER_sectorGatePeriod_Q(ViSession id, ViPReal64 period); Visual Basic hpe5022_BER_sectorGatePeriod_Q(ByVal id As Long, ByRef period As Double) Syntax As Long Description This function returns the sector gate period. This function is only available for use with the E5039C bit error test module.
Page 69: Hpe5022_Ber_Writegate
Function Reference BER Data Pattern Definition Function hpe5022_BER_writeGate C Syntax ViStatus hpe5022_BER_writeGate(ViSession id, ViReal64 trigDelay, ViReal64 aperture); Visual Basic hpe5022_BER_writeGate(ByVal id As Long, ByVal trigDelay As Double, ByVal Syntax aperture As Double) As Long Description This function specifies the write gate delay and aperture time. This function is only available for use with the E5039C bit error test module.
Page 70 Function Reference BER Data Pattern Definition Function Return Values Completion Code Description VI_SUCCESS No Error Error Code Description hpe5022_ERROR_NOT_INIT The resource of Agilent E5039C can not be opened during initialization. Check if the Agilent E5039C is included in the rsrcArray of the “hpe5022_init” function. hpe5022_ERROR_INV_ID The handle specified by ‘id’...
Page 71: Hpe5022_Ber_Writegate_Q
Function Reference BER Data Pattern Definition Function hpe5022_BER_writeGate_Q C Syntax ViStatus hpe5022_BER_writeGate_Q(ViSession id, ViPReal64 trigDelay, ViPReal64 aperture); Visual Basic hpe5022_BER_writeGate_Q(ByVal id As Long, ByRef trigDelay As Double, Syntax ByRef aperture As Double) As Long Description This function returns the write gate delay and aperture time. This function is only available for use with the E5039C bit error test module.
Page 72: Hpe5022_Ber_Readgate
Function Reference BER Data Pattern Definition Function hpe5022_BER_readGate C Syntax ViStatus hpe5022_BER_readGate(ViSession id, ViReal64 trigDelay, ViReal64 aperture); Visual Basic hpe5022_BER_readGate(ByVal id As Long, ByVal trigDelay As Double, ByVal Syntax aperture As Double) As Long Description This function specifies the read gate delay and aperture time. This function is only available for use with the E5039C bit error test module.
Page 73 Function Reference BER Data Pattern Definition Function Return Values Completion Code Description VI_SUCCESS No Error Error Code Description hpe5022_ERROR_NOT_INIT The resource of Agilent E5039C can not be opened during initialization. Check if the Agilent E5039C is included in the rsrcArray of the “hpe5022_init” function. hpe5022_ERROR_INV_ID The handle specified by ‘id’...
Page 74: Hpe5022_Ber_Readgate_Q
Function Reference BER Data Pattern Definition Function hpe5022_BER_readGate_Q C Syntax ViStatus hpe5022_BER_readGate_Q(ViSession id, ViPReal64 trigDelay, ViPReal64 aperture); Visual Basic hpe5022_BER_readGate_Q(ByVal id As Long, ByRef trigDelay As Double, Syntax ByRef aperture As Double) As Long Description This function returns the read gate delay and aperture time. This function is only available for use with the E5039C bit error test module.
Page 75: Hpe5022_Ber_Syncwindow
Function Reference BER Data Pattern Definition Function hpe5022_BER_syncWindow C Syntax ViStatus hpe5022_BER_syncWindow(ViSession id, ViReal64 window); Visual Basic hpe5022_BER_syncWindow(ByVal id As Long, ByVal window As Double) As Syntax Long Description This function specifies the time to search the synchronized pattern from the read gate start.
Page 76 Function Reference BER Data Pattern Definition Function Error Code Description hpe5022_ERROR_NSUP_FUNC This function is not supported by the module currently in use. See Also “hpe5022_BER_syncWindow_Q” on page 77“ Chapter 3...
Page 77: Hpe5022_Ber_Syncwindow_Q
Function Reference BER Data Pattern Definition Function hpe5022_BER_syncWindow_Q C Syntax ViStatus hpe5022_BER_syncWindow_Q(ViSession id, ViPReal64 window); Visual Basic hpe5022_BER_syncWindow_Q(ByVal id As Long, ByRef window As Double) Syntax As Long Description This function returns the time to search the synchronized pattern from the read gate start.
Page 78: Hpe5022_Ber_Syncwindowmode
Function Reference BER Data Pattern Definition Function hpe5022_BER_syncWindowMode C Syntax ViStatus hpe5022_BER_syncWindowMode(ViSession id, ViInt16 mode); Visual Basic hpe5022_BER_syncWindowMode(ByVal id As Long, ByVal mode As Integer) As Syntax Long Description This function specifies the synchronized pattern window mode (auto or manual). If the auto mode is selected, synchronized pattern window is set to the read gate aperture time.
Page 79 Function Reference BER Data Pattern Definition Function Error Code Description hpe5022_ERROR_INV_PARAMETER The parameter ‘mode’ is out of range. hpe5022_ERROR_NSUP_FUNC This function is not supported by the module currently in use. See Also “hpe5022_BER_syncWindowMode” on page 78“ Chapter 3...
Page 80: Hpe5022_Ber_Syncwindowmode_Q
Function Reference BER Data Pattern Definition Function hpe5022_BER_syncWindowMode_Q C Syntax ViStatus hpe5022_BER_syncWindowMode_Q(ViSession id, ViPInt16 mode); Visual Basic hpe5022_BER_syncWindowMode_Q(ByVal id As Long, ByRef mode As Integer) Syntax As Long Description This function returns the synchronized pattern window mode (auto or manual). This function is only available for use with the E5039C bit error test module.
Page 81: Channel Ic Configuration Function
Function Reference Channel IC Configuration Function Channel IC Configuration Function hpe5022_BER_channelIc_Idn_Q C Syntax ViStatus hpe5022_BER_channelIcIdn_Q(ViSession id, ViPString chip); Visual Basic hpe5022_BER_channelIcIdn_Q(ByVal id As Long, ByVal chip As String) As Syntax Long Description This function returns the name of the installed channel IC. Parameters •...
Page 82: Hpe5022_Ber_Channelicreferenceclock
Function Reference Channel IC Configuration Function hpe5022_BER_channelIcReferenceClock C Syntax ViStatus hpe5022_BER_channelIcReferenceClock(ViSession id, ViReal64 clk); Visual Basic hpe5022_BER_channelIcReferenceClock(ByVal id As Long, ByVal clk As Syntax Double) As Long Description This function specifies the reference clock of the time base generator. Parameters •...
Page 83: Hpe5022_Ber_Channelicreferenceclock_Q
Function Reference Channel IC Configuration Function hpe5022_BER_channelIcReferenceClock_Q C Syntax ViStatus hpe5022_BER_channelIcReferenceClock_Q(ViSession id, ViPReal64 clk); Visual Basic hpe5022_BER_channelIcReferenceClock_Q(ByVal id As Long, ByRef clk As Syntax Double) As Long Description This function returns the time base generator’s reference clock specified by the “hpe5022_BER_channelIcReferenceClock”...
Page 84: Hpe5022_Ber_Channeliclowpassfilter
Function Reference Channel IC Configuration Function hpe5022_BER_channelIcLowPassFilter C Syntax ViStatus hpe5022_BER_channelIcLowPassFilter(ViSession id, ViReal64 fc, ViReal64 boost); Visual Basic hpe5022_BER_channelIcLowPassFilter(ByVal id As Long, ByVal fc As Double, Syntax ByVal boost As Double) As Long Description This function specifies the cut-off frequency and boost gain of the low pass filter in the channel IC.
Page 85: Hpe5022_Ber_Channeliclowpassfilter_Q
Function Reference Channel IC Configuration Function hpe5022_BER_channelIcLowPassFilter_Q C Syntax ViStatus hpe5022_BER_channelIcLowPassFilter_Q(ViSession id, ViPReal64 fc, ViPReal64 boost); Visual Basic hpe5022_BER_channelIcLowPassFilter_Q(ByVal id As Long, ByRef fc As Syntax Double, ByRef boost As Double) As Long Description This function returns the cut-off frequency and boost gain of the low pass filter in the channel IC.
Page 86: Hpe5022_Ber_Channelicfircoefreset
Function Reference Channel IC Configuration Function hpe5022_BER_channelIcFirCoefReset C Syntax ViStatus hpe5022_BER_channelIcFirCoefReset(ViSession id) Visual Basic hpe5022_BER_channelIcFirCoefReset(ByVal id As Long) As Long Syntax Description This function resets the TAP coefficient of the FIR filter. The TAP coefficient is set to the default value. The “hpe5022_BER_channelIcProperty” function configures the TAP coefficient of the FIR filter.
Page 87: Hpe5022_Ber_Channelicprecompdelay
Function Reference Channel IC Configuration Function hpe5022_BER_channelIcPrecompDelay C Syntax ViStatus hpe5022_BER_channelIcPrecompDelay(ViSession id, const ViReal64 precDel[]); Visual Basic hpe5022_BER_channelIcPrecompDelay(ByVal id As Long, ByRef precDel As Syntax Double) As Long Description This function specifies the write precompensation delay value of the channel IC. Agilent E5022/E5023 allows you to specify two bits before target bit.
Page 88: Hpe5022_Ber_Channelicprecompdelay_Q
Function Reference Channel IC Configuration Function hpe5022_BER_channelIcPrecompDelay_Q C Syntax ViStatus hpe5022_BER_channelIcPrecompDelay_Q(ViSession id, ViReal64 precDel[]); Visual Basic hpe5022_BER_channelIcPrecompDelay_Q(ByVal id As Long, ByRef precDel As Syntax Double) As Long Description This function returns the write precompensation delay value of the channel IC. Parameters •...
Page 89: Hpe5022_Ber_Channelicprecompstate
Function Reference Channel IC Configuration Function hpe5022_BER_channelIcPrecompState C Syntax ViStatus hpe5022_BER_channelIcPrecompState(ViSession id, ViBoolean state); Visual Basic hpe5022_BER_channelIcPrecompState(ByVal id As Long, ByVal state As Syntax Integer) As Long Description This function selects if the write precompensation is activated. The “hpe5022_BER_channelIcPrecompDelay” function specifies the precompensation delay time.
Page 90: Hpe5022_Ber_Channelicprecompstate_Q
Function Reference Channel IC Configuration Function hpe5022_BER_channelIcPrecompState_Q C Syntax ViStatus hpe5022_BER_channelIcPrecompState_Q(ViSession id, ViPBoolean state); Visual Basic hpe5022_BER_channelIcPrecompState_Q(ByVal id As Long, ByRef state As Syntax Integer) As Long Description This function returns the write precompensation state. Parameters • id Description Specifies the system identifier. This is given by the “hpe5022_init”...
Page 91: Hpe5022_Ber_Channelicendec
Function Reference Channel IC Configuration Function hpe5022_BER_channelIcEndec C Syntax ViStatus hpe5022_BER_channelIcEndec(ViSession id, ViBoolean scramble, ViInt16 blocEndec, ViBoolean precode); Visual Basic hpe5022_BER_channelIcEndec(ByVal id As Long, ByVal scramble As Integer, Syntax ByVal blocEndec As Integer, ByVal precode As Integer) As Long Description This function configures the encoder / decoder functions.
Page 92 Function Reference Channel IC Configuration Function Name Value Description hpe5022_BER_ENDEC_16_18 16/18 hpe5022_BER_ENDEC_32_34 32/34 hpe5022_BER_ENDEC_24_26 24/26 hpe5022_BER_ENDEC_32_33 32/33 hpe5022_BER_ENDEC_48_49 48/49 hpe5022_BER_ENDEC_48_50 48/50 hpe5022_BER_ENDEC_48_51 48/51 hpe5022_BER_ENDEC_48_52 48/52 hpe5022_BER_ENDEC_50_51 50/51 hpe5022_BER_ENDEC_50_52 50/52 hpe5022_BER_ENDEC_50_53 50/53 hpe5022_BER_ENDEC_50_54 50_54 hpe5022_BER_ENDEC_96_100 96/100 hpe5022_BER_ENDEC_96_102 96/102 • precode Description Specifies the switching state of the precoder.
Page 93 Function Reference Channel IC Configuration Function Error Code Description hpe5022_ERROR_INV_PARAMETER Either one of the parameters ‘blocEndec’, ‘scramble’ and/or ‘precode’ is out of range. hpe5022_ERROR_NOT_INIT The resource of Agilent E5039A/B can not be opened during initialization. Check if Agilent E5039A/B is included in the rsrcArray of the “hpe5022_init”...
Page 94: Hpe5022_Ber_Channelicendec_Q
Function Reference Channel IC Configuration Function hpe5022_BER_channelIcEndec_Q C Syntax ViStatus hpe5022_BER_channelIcEndec_Q(ViSession id, ViPBoolean scramble, ViPInt16 blocEndec, ViPBoolean precode); Visual Basic hpe5022_BER_channelIcEndec_Q(ByVal id As Long, ByRef scramble As Integer, Syntax ByRef blocEndec As Integer, ByRef precode As Integer) As Long Description This function returns the encoder / decoder configuration specified by the “hpe5022_BER_channelIcEndec”...
Page 95 Function Reference Channel IC Configuration Function Error Code Description hpe5022_ERROR_NOT_INIT The resource of Agilent E5039A/B can not be opened during initialization. Check if Agilent E5039A/B is included in the rsrcArray of the “hpe5022_init” function. hpe5022_ERROR_NSUP_FUNC This function is not available for the installed IC.
Page 96: Hpe5022_Ber_Channelicdetectortype
Function Reference Channel IC Configuration Function hpe5022_BER_channelIcDetectorType C Syntax ViStatus hpe5022_BER_channelIcDetectorType (ViSession id, ViInt16 detType); Visual Basic hpe5022_BER_channelIcDetectorType(ByVal id As Long, ByVal detType As Syntax Integer) As Long Description This function selects the detector type. Either PR4, EPR4, EEPR4 or advanced can be selected.
Page 97 Function Reference Channel IC Configuration Function Error Code Description hpe5022_ERROR_NOT_INIT The resource of Agilent E5039A/B can not be opened during initialization. Check if Agilent E5039A/B is included in the rsrcArray of the “hpe5022_init” function. hpe5022_ERROR_NSUP_FUNC The selected detector type is not available for the installed channel See Also “hpe5022_BER_channelIcDetectorType_Q”...
Page 98: Hpe5022_Ber_Channelicdetectortype_Q
Function Reference Channel IC Configuration Function hpe5022_BER_channelIcDetectorType_Q C Syntax ViStatus hpe5022_BER_channelIcDetectorType _Q(ViSession id, ViPInt16 detType); Visual Basic hpe5022_BER_channelIcDetectorType_Q(ByVal id As Long, ByRef detType As Syntax Integer) As Long Description This function returns the detector type specified by the “hpe5022_BER_channelIcDetectorType” function. Parameters •...
Page 99: Hpe5022_Ber_Selecttestsignal
Function Reference Channel IC Configuration Function hpe5022_BER_selectTestSignal C Syntax ViStatus hpe5022_BER_selectTestSignal(ViSession id, ViInt16 testNum); Visual Basic hpe5022_BER_selectTestSignal(ByVal id As Long, ByVal testNum As Integer) As Syntax Long Description This function selects the test signal from the test signal 1/2 connectors on the E5039A/B front panel.
Page 100 Function Reference Channel IC Configuration Function Error Code Description hpe5022_ERROR_NOT_INIT The resource of Agilent E5039A/B can not be opened during initialization. Check if Agilent E5039A/B is included in the rsrcArray of the “hpe5022_init” function. hpe5022_ERROR_NSUP_FUNC The selected signal number is not available for the installed channel See Also “hpe5022_BER_selectTestSignal_Q”...
Page 101: Hpe5022_Ber_Selecttestsignal_Q
Function Reference Channel IC Configuration Function hpe5022_BER_selectTestSignal_Q C Syntax ViStatus hpe5022_BER_selectTestSignal_Q(ViSession id, ViPInt16 testNum); Visual Basic hpe5022_BER_selectTestSignal_Q(ByVal id As Long, ByRef testNum As Integer) Syntax As Long Description This function returns the test signal from the test signal 1/2 connectors on the E5039A/B front panel.
Page 102: Hpe5022_Ber_Testsignalstring_Q
Function Reference Channel IC Configuration Function hpe5022_BER_testSignalString_Q C Syntax ViStatus hpe5022_BER_testSignalString_Q(ViSession id, ViInt16 testNum, ViPString port1_str, ViPString port2_str); Visual Basic hpe5022_BER_testSignalString_Q(ByVal id As Long, ByVal testNum As Integer, Syntax ByVal port1_str As String, ByVal port2_str As String) As Long Description This function returns the name of the specified test signal from the test signal 1/2 connectors on the Agilent E5039A/B front panel.
Page 103 Function Reference Channel IC Configuration Function Error Code Description hpe5022_ERROR_NOT_INIT The resource of Agilent E5039A/B can not be opened during initialization. Check if Agilent E5039A/B is included in the rsrcArray of the “hpe5022_init” function. hpe5022_ERROR_NSUP_FUNC The selected signal number is not available for the installed channel IC.
Page 104: Hpe5022_Ber_Channelicproperty
Function Reference Channel IC Configuration Function hpe5022_BER_channelIcProperty C Syntax ViStatus hpe5022_BER_channelIcProperty(ViSession id, ViInt32 property, const ViReal64 value []); Visual Basic hpe5022_BER_channelIcProperty(ByVal id As Long, ByVal property As Long, Syntax ByRef value As Double) As Long Description This function specifies the configuration of time base divider, low pass filter, FIR filter and so on of the channel IC.
Page 105: Hpe5022_Ber_Channelicproperty_Q
Function Reference Channel IC Configuration Function hpe5022_BER_channelIcProperty_Q C Syntax ViStatus hpe5022_BER_channelIcProperty_Q(ViSession id, ViInt32 property, ViPReal64 value []); Visual Basic hpe5022_BER_channelIcProperty_Q(ByVal id As Long, ByVal property As Long, Syntax ByRef value As Double) As Long Description This function returns configurations of the channel IC specified by the “hpe5022_BER_channelIcProperty”...
Page 106: Hpe5022_Ber_Channelicbytesize_Q
Function Reference Channel IC Configuration Function hpe5022_BER_channelIcByteSize_Q C Syntax ViStatus hpe5022_BER_channelIcByteSize_Q(ViSession id, ViPInt 16 bits); Visual Basic hpe5022_BER_channelIcByteSize_Q(ByVal id As Long, ByRef bits As Integer) Syntax As Long Description This function returns the number of bits per byte. However, the number of bits per byte depend on the channel IC and its configurations.
Page 107: Hpe5022_Ber_Channelicupdatestate
Function Reference Channel IC Configuration Function hpe5022_BER_channelIcUpdateState C Syntax ViStatus hpe5022_BER_channelIcUpdateState(ViSession id); Visual Basic hpe5022_BER_channelIcUpdateState Lib “hpe5022_32.dll” (ByVal id As Long) Syntax As Long Description This function updates the BER measurement state when the current read channel IC register is set. This function should be called when the setting routine of the read channel IC register is completed.
Page 108: Hpe5022_Ber_Channelicregister
Function Reference Channel IC Configuration Function hpe5022_BER_channelIcRegister C Syntax ViStatus hpe5022_BER_channelIcRegister(ViSession id, ViInt32 addr, ViInt32 upperBitPos, ViInt32 lowerBitPos, ViInt32 data); Visual Basic hpe5022_BER_channelIcRegister(ByVal id As Long, ByVal addr As Long, ByVal Syntax upperBitPos As Long, ByVal lowerBitPos As Long, ByVal data As Long) As Long Description This function writes a specified data to the specified address of the channel IC register.
Page 109 Function Reference Channel IC Configuration Function • upperBitPos Description Specifies the upper bit position of the register. Direction Values Name Value hpe5022_BER_REG_DATA_BIT_MIN hpe5022_BER_REG_DATA_BIT_MAX • lowerBitPos Description Specifies the lower bit position of the register. Direction Values Name Value hpe5022_BER_REG_DATA_BIT_MIN hpe5022_BER_REG_DATA_BIT_MAX •...
Page 110 Function Reference Channel IC Configuration Function Error Code Description hpe5022_ERROR_NOT_INIT The resource of Agilent E5039A/B can not be opened during initialization. Check if Agilent E5039A/B is included in the rsrcArray of the “hpe5022_init” function. See Also “hpe5022_BER_channelIcRegister_Q” on page 84 “hpe5022_BER_channelIcMultipleRegisters”...
Page 111: Hpe5022_Ber_Channelicregister_Q
Function Reference Channel IC Configuration Function hpe5022_BER_channelIcRegister_Q C Syntax ViStatus hpe5022_BER_channelRegister_Q(ViSession id, ViInt32 addr, ViInt32 upperBitPos, ViInt32 lowerBitPos, ViPInt32 data); Visual Basic hpe5022_BER_channelRegister_Q(ByVal id As Long, ByVal addr As Long, Syntax ByVal upperBitPos As Long, ByVal lowerBitPos As Long, ByRef data As Long) As Long Description This function returns data from the specified channel IC address.
Page 112 Function Reference Channel IC Configuration Function Error Code Description hpe5022_ERROR_INV_ID The handle specified by ‘id’ is invalid. hpe5022_ERROR_INV_PARAMETER The parameter ‘addr’, ‘upperBitPos’ and/or ‘lowerBitPos’ is out of range. hpe5022_ERROR_NOT_INIT The resource of Agilent E5039A/B can not be opened during initialization. Check if Agilent E5039A/B is included in the rsrcArray of the “hpe5022_init”...
Page 113: Hpe5022_Ber_Channelicmultipleregisters
Function Reference Channel IC Configuration Function hpe5022_BER_channelIcMultipleRegisters C Syntax ViStatus hpe5022_BER_channelIcMultipleRegisters(ViSession id, ViInt32 points, const ViInt32 addr[], const ViInt32 data[]); Visual Basic hpe5022_BER_channelIcMultipleRegisters(ByVal id As Long, ByVal points As Syntax Long, ByRef addr As Long, ByRef data As Long) As Long Description This function writes a specified data to several address of the channel IC.
Page 114 Function Reference Channel IC Configuration Function Values Name Value hpe5022_BER_REG_DATA_MIN hpe5022_BER_REG_DATA_MAX 65,535 Return Values Completion Code Description VI_SUCCESS No Error Error Code Description hpe5022_ERROR_INV_ID The handle specified by ‘id’ is invalid. hpe5022_ERROR_INV_PARAMETER The parameter ‘points’, ‘addrs’ and/or ‘data’ is out of range. hpe5022_ERROR_NOT_INIT The resource of Agilent E5039A/B can not be opened during initialization.
Page 115: Hpe5022_Ber_Channelicmultipleregisters_Q
Function Reference Channel IC Configuration Function hpe5022_BER_channelIcMultipleRegisters_Q C Syntax ViStatus hpe5022_BER_channelIcMultipleRegisters_Q(ViSession id, ViInt32 points, const ViInt32 addr[], ViInt32 data[]); Visual Basic hpe5022_BER_channelIcMultipleRegisters_Q(ByVal id As Long, ByVal points Syntax As Long, ByRef addr As Long, ByRef data As Long) As Long Description This function returns the register values from specified channel IC register addresses.
Page 116 Function Reference Channel IC Configuration Function Return Values Completion Code Description VI_SUCCESS No Error Error Code Description hpe5022_ERROR_INV_ID The handle specified by ‘id is invalid. hpe5022_ERROR_INV_PARAMETER The parameter ‘points’ and/or ‘addrs’ is out of range. hpe5022_ERROR_NOT_INIT The resource of Agilent E5039A/B can not be opened during initialization.
Page 117: Hpe5022_Ber_Channelicregisterssave
Function Reference Channel IC Configuration Function hpe5022_BER_channelIcRegistersSave C Syntax ViStatus hpe5022_BER_channelIcRegisterSave(ViSession id, ViInt16 configNum); Visual Basic hpe5022_BER_channelIcRegistersSave(ByVal id As Long, ByVal configNum As Syntax Integer) As Long Description This function saves all register values and current reference clock of the read channel IC to the EEPROM by the specified configuration number.
Page 118 Function Reference Channel IC Configuration Function Return Values Completion Code Description VI_SUCCESS No Error Error Code Description hpe5022_ERROR_INV_ID The handle specified by ‘id is invalid. hpe5022_ERROR_INV_PARAMETER The parameter ‘configNum’ is out of range. hpe5022_ERROR_MEMORY Can’t access to memory or failed check sum.
Page 119: Hpe5022_Ber_Channelicregistersrecall
Function Reference Channel IC Configuration Function hpe5022_BER_channelIcRegistersRecall C Syntax ViStatus hpe5022_BER_channelIcRegistersRecall(ViSession id, ViInt16 configNum); Visual Basic hpe5022_BER_channelIcRegistersRecall(ByVal id As Long, ByVal configNum Syntax As Integer) As Long Description This function recalls all register values and current reference clock of the read channel IC from the EEPROM by the specified configuration.
Page 120: Hpe5022_Ber_Channelicinfofile_Q
Function Reference Channel IC Configuration Function hpe5022_BER_channelIcInfoFile_Q C Syntax ViStatus hpe5022_BER_channelIcInfoFile_Q(ViSession id, ViPString fileName); Visual Basic hpe5022_BER_channelIcInfoFile_Q(ByVal id As Long, ByVal fileName As Syntax String) As Long Description This function returns the read channel IC information file name.This function is only available for use with the E5039C bit error test module.
Page 121 Function Reference Channel IC Configuration Function Error Code Description hpe5022_ERROR_NOT_INIT The resource of Agilent E5039A/B can not be opened during initialization. Check if Agilent E5039A/B is included in the rsrcArray of the “hpe5022_init” function. hpe5022_ERROR_NSUP_FUNC This function is not supported by the module currently in use.
Page 122: Ber Pattern Write Function
Function Reference BER Pattern Write Function BER Pattern Write Function hpe5022_BER_write C Syntax ViStatus hpe5022_BER_write(ViSession id, ViReal64 offset); Visual Basic hpe5022_BER_write(ByVal id As Long, ByVal offset As Double) As Long Syntax Description This function executes the write sequence. The sequence of this function is as follows: 1.
Page 123 Function Reference BER Pattern Write Function Error Code Description hpe5022_ERROR_INV_ID The handle specified by ‘id’ is invalid. hpe5022_ERROR_INV_PARAMETER The parameter ‘offset’ is out of range. hpe5022_ERROR_NOT_INIT The resource of Agilent E5039A/B can not be opened during initialization. Check if Agilent E5039A/B is included in the rsrcArray of the “hpe5022_init”...
Page 124: Optimization Function
Function Reference Optimization Function Optimization Function hpe5022_BER_optimizeState C Syntax ViStatus hpe5022_BER_optimizrState(ViSession id, ViInt16 category, ViBoolean state); Visual Basic hpe5022_BER_optimizeState(ByVal id As Long, ByVal category As Integer, Syntax ByVal state As Integer) As Long Description This function specifies the optimization state. The “hpe5022_BER_optimize” function performs the optimization.
Page 125 Function Reference Optimization Function Values Name Value Description VI_TRUE Optimization will be done VI_FALSE Optimization won’t be done Return Values Completion Code Description VI_SUCCESS No Error Error Code Description hpe5022_ERROR_INV_ID The handle specified by ‘id’ is invalid. hpe5022_ERROR_INV_PARAMETER The parameter ‘category’ and/or ‘state’ is out of range.
Page 126: Hpe5022_Ber_Optimizestate_Q
Function Reference Optimization Function hpe5022_BER_optimizeState_Q C Syntax ViStatus hpe5022_BER_optimizrState_Q(ViSession id, ViInt16 category, ViPBoolean state); Visual Basic hpe5022_BER_optimizeState_Q(ByVal id As Long, ByVal category As Integer, Syntax ByRef state As Integer) As Long Description This function returns the optimization state. Parameters • id Description Specifies the system identifier.
Page 127: Hpe5022_Ber_Optimizesequenceconfig
Function Reference Optimization Function hpe5022_BER_optimizeSequenceConfig C Syntax ViStatus hpe5022_BER_optimizeSequenceConfig(ViSession id, ViInt16 seqType); Visual Basic hpe5022_BER_optimizeSequenceConfig(ByVal id As Long, ByVal seqType As Syntax Integer) As Long Description This function specifies the sequence type of the optimization. The “hpe5022_BER_optimize” function performs the optimization. The selected sequence will be used in the optimization.
Page 128: Hpe5022_Ber_Optimizesequenceconfig_Q
Function Reference Optimization Function hpe5022_BER_optimizeSequenceConfig_Q C Syntax ViStatus hpe5022_BER_optimizeSequenceConfig_Q(ViSession id, ViPInt16 seqType); Visual Basic hpe5022_BER_optimizeSequenceConfig_Q(ByVal id As Long, ByRef seqType Syntax As Integer) As Long Description This function returns a sequence type of the optimization. The “hpe5022_BER_optimize” function performs the optimization. Parameters •...
Page 129: Hpe5022_Ber_Optimize
Function Reference Optimization Function hpe5022_BER_optimize C Syntax ViStatus hpe5022_BER_optimize(ViSession id); Visual Basic hpe5022_BER_optimize(ByVal id As Long) As Long Syntax Description This function performs an optimization of BER. The selected categories by the “hpe5022_BER_optimizeState” function are optimized. The “hpe5022_BER_optimizeSequenceConfig” function allows you to perform an erase and a write sequence before the optimization.
Page 130 Function Reference Optimization Function Error Code Description hpe5022_ERROR_NOT_INIT The resource of HP E5039A is not opened at initialize. Check if the HP E5039A is included in the rsrcArray of the "hpe5022_init" function. See Also “hpe5022_BER_optimizeState” on page 93 “hpe5022_BER_optimizeSequenceConfig” on page 96 Chapter 3...
Page 131: Track Offset Compensation
Function Reference Track Offset Compensation Track Offset Compensation This section describes the function of a track offset compensation for a bit error test. hpe5022_BER_trackOffsetCompInterval C Syntax ViStatus hpe5022_BER_trackOffsetCompInterval(ViSession id, ViInt32 interval); Visual Basic hpe5022_BER_trackOffsetCompInterval(ByVal id As Long, ByVal interval As Syntax Integer) As Long Description...
Page 132 Function Reference Track Offset Compensation Error Code Description hpe5022_ERROR_INV_ID The handle specified by ‘id’ is invalid. hpe5022_ERROR_INV_PARAMETER The parameter ‘interval’ is out of range. See Also “hpe5022_BER_trackOffsetCompInterval_Q” on page 102 Chapter 3...
Page 133: Hpe5022_Ber_Trackoffsetcompinterval_Q
Function Reference Track Offset Compensation hpe5022_BER_trackOffsetCompInterval_Q C Syntax ViStatus hpe5022_BER_trackOffsetCompInterval_Q(ViSession id, ViPInt32 interval); Visual Basic hpe5022_BER_trackOffsetCompInterval_Q(ByVal id As Long, ByRef period As Syntax Integer) As Long Description This function returns the number of spindle revolutions that is track offset compensation sequence interval. Parameters •...
Page 134: Bit Error Rate Measurement Function
Function Reference Bit Error Rate Measurement Function Bit Error Rate Measurement Function hpe5022_BER_berMeasByteCount C Syntax ViStatus hpe5022_BER_berMeasByteCount(ViSession id, ViReal64 byteNum); Visual Basic hpe5022_BER_berMeasByteCount(ByVal id As Long, ByVal byteNum As Syntax Double) As Long Description This function specifies the number of read bytes for a user data. You should enter a value more than reciprocal number of required error bit rate.
Page 135 Function Reference Bit Error Rate Measurement Function Figure 3-6 Measurement Bytes Parameters • id Description Specifies the system identifier. This is given by the “hpe5022_init” function. Direction • byteNum Description Specifies the number of measurement bytes for user data. The value over a reciprocal number of an expected bit error rate should be specified.
Page 136 Function Reference Bit Error Rate Measurement Function “hpe5022_BER_sectorFormat” — Sect = ‘sector’ of “hpe5022_BER_trackFormat” — Ave = ‘ave’ of “hpe5022_BER_measureBer”, “hpe5022_BER_measureTrackProfile” or “hpe5022_BER_747Config” Return Values Completion Code Description VI_SUCCESS No Error Error Code Description hpe5022_ERROR_INV_ID The handle specified by ‘id’ is invalid. hpe5022_ERROR_INV_PARAMETER The parameter ‘byteNum’...
Page 137: Hpe5022_Ber_Bermeasbytecount_Q
Function Reference Bit Error Rate Measurement Function hpe5022_BER_berMeasByteCount_Q C Syntax ViStatus hpe5022_BER_berMeasByteCount_Q(ViSession id, ViPReal64 byteNum); Visual Basic hpe5022_BER_berMeasByteCount_Q(ByVal id As Long, ByRef byteNum As Syntax Double) As Long Description This function returns the number of read bytes specified by the “hpe5022_BER_berMeasByteCount”...
Page 138: Hpe5022_Ber_Errorbitperbyte
Function Reference Bit Error Rate Measurement Function hpe5022_BER_errorBitPerByte C Syntax ViStatus hpe5022_BER_errorBitPerByte(ViSession id, ViReal64 bit); Visual Basic hpe5022_BER_errorBitPerByte(ByVal id As Long, ByVal bit As Double) As Syntax Long Description This function specifies the number of error bits per byte. Agilent E5022/E5023 compares the bit stream by a byte and counts the bytes where an error has occurred.
Page 139 Function Reference Bit Error Rate Measurement Function “hpe5022_BER_ber_Q” on page 118 Chapter 3...
Page 140: Hpe5022_Ber_Errorbitperbyte_Q
Function Reference Bit Error Rate Measurement Function hpe5022_BER_errorBitPerByte_Q C Syntax ViStatus hpe5022_BER_errorBitPerByte_Q(ViSession id, ViPReal64 bit); Visual Basic hpe5022_BER_errorBitPerByte_Q(ByVal id As Long, ByRef bit As Double) As Syntax Long Description This function returns the number of error bits per byte specified by the “hpe5022_BER_errorBitPerByte”...
Page 141: Hpe5022_Ber_Berdataloggingmode
Function Reference Bit Error Rate Measurement Function hpe5022_BER_berDataLoggingMode C Syntax ViStatus hpe5022_BER_berDataLoggingMode(ViSession id, ViBoolean sectorData, ViInt16 rawData); Visual Basic hpe5022_BER_berDataLoggingMode(ByVal id As Long, ByVal sectorData As Syntax Integer, ByVal rawData As Integer) As Long Description This function selects the data logging mode. The logging mode is effective for the “hpe5022_BER_sectorErrorCount_Q”...
Page 142 Function Reference Bit Error Rate Measurement Function Name Value Description hpe5022_BER_RAW_DATA_LAST_REV Raw data is stored for the last revolution only Return Values Completion Code Description VI_SUCCESS No Error Error Code Description hpe5022_ERROR_INV_ID The handle specified by ‘id’ is invalid. hpe5022_ERROR_INV_PARAMETER The parameter ‘sectorData’...
Page 143: Hpe5022_Ber_Berdataloggingmode_Q
Function Reference Bit Error Rate Measurement Function hpe5022_BER_berDataLoggingMode_Q C Syntax ViStatus hpe5022_BER_berDataLoggingMode_Q(ViSession id, ViPBoolean sectorData, ViPInt16 rawData); Visual Basic hpe5022_BER_berDataLoggingMode_Q(ByVal id As Long, ByRef sectorData As Syntax Integer, ByRef rawData As Integer) As Long Description This function returns the data logging mode specified by the “hpe5022_BER_berDataLoggingMode”...
Page 144: Hpe5022_Ber_Burstthreshold
Function Reference Bit Error Rate Measurement Function hpe5022_BER_burstThreshold C Syntax ViStatus hpe5022_BER_burstThreshold(ViSession id, ViInt16 length, ViInt16 counts); Visual Basic hpe5022_BER_burstThreshold(ByVal id As Long, ByVal length As Integer, ByVal Syntax counts As Integer) As Long Description This function specifies the burst length threshold parameters. This function is only available for use with the E5039C bit error test module.
Page 145 Function Reference Bit Error Rate Measurement Function Return Values Completion Code Description VI_SUCCESS No Error Error Code Description hpe5022_ERROR_INV_ID The handle specified by ‘id’ is invalid. hpe5022_ERROR_INV_PARAMETER The parameter ‘length’ and/or ‘counts’ is out of range. hpe5022_ERROR_NSUP_FUNC This function is not supported by the module currently in use.
Page 146: Hpe5022_Ber_Burstthreshold_Q
Function Reference Bit Error Rate Measurement Function hpe5022_BER_burstThreshold_Q C Syntax ViStatus hpe5022_BER_burstThreshold_Q(ViSession id, ViPInt16 length, ViPInt16 counts); Visual Basic hpe5022_BER_burstThreshold_Q(ByVal id As Long, ByRef length As Integer, Syntax ByRef counts As Integer) As Long Description This function returns the burst length threshold parameters. This function is only available for use with the E5039C bit error test module.
Page 147: Hpe5022_Ber_Measureber
Function Reference Bit Error Rate Measurement Function hpe5022_BER_measureBer C Syntax ViStatus hpe5022_BER_measureBer(ViSession id, ViInt16 seqType, ViInt16 ave); Visual Basic hpe5022_BER_measureBer(ByVal id As Long, ByVal seqType As Integer, ByVal Syntax ave As Integer) As Long Description This function measures the on-track error rate. The detailed sequence of this function is as follows: 1.
Page 148 Function Reference Bit Error Rate Measurement Function Values Name Value Description hpe5022_SEQ_ER_WR_M Erase ->Write ->Measure hpe5022_SEQ_WR_M Write ->Measure hpe5022_SEQ_M Measure • ave Description Specifies the number of measurement counts to be averaged. Direction Values Name Value Description hpe5022_BER_COUN_MIN Minimum counts to be averaged.
Page 149 Function Reference Bit Error Rate Measurement Function Error Code Description hpe5022_ERROR_NOT_INIT The resource of E5039A/B can not be opened during initialization. Check if E5039A/B is included in the rsrcArray of the "hpe5022_init" function. hpe5022_ERROR_PARAMETER_SET_FAILED The measurement data byte exceeds limit. See “hpe5022_BER_berMeasByteCou nt”...
Page 150: Hpe5022_Ber_Setupber
Function Reference Bit Error Rate Measurement Function hpe5022_BER_setupBer C Syntax ViStatus hpe5022_BER_setupBer(ViSession id, ViInt16 seqType, ViInt16 ave, ViPObject testHndl); Visual Basic hpe5022_BER_setupBer(ByVal id As Long, ByVal seqType As Integer, ByVal ave Syntax As Integer, ByRef testHndl As Long) As Long Description This function assigns the bit error measurement sequence to the specified test identifier.
Page 151 Function Reference Bit Error Rate Measurement Function Return Values Completion Code Description VI_SUCCESS No Error Error Code Description hpe5022_ERROR_INV_ID The handle specified by ‘id’ is invalid. hpe5022_ERROR_INV_PARAMETER The parameter ‘seqType’ is out of range. hpe5022_ERROR_MEM_ALLOC Lack of memory. Release the finished setup function using the “hpe5022_releaseSetup”...
Page 152: Hpe5022_Ber_Ber_Q
Function Reference Bit Error Rate Measurement Function hpe5022_BER_ber_Q C Syntax ViStatus hpe5022_BER_ber_Q(ViSession id, ViPReal 64 ber, ViPInt32 symbol, ViPInt32 totalSector, ViPInt32 lostSector); Visual Basic hpe5022_BER_ber_Q(ByVal id As Long, ByRef ber As Double, ByRef symbol Syntax As Long, ByRef totalSector As Long, ByRef lostSector As Long) As Long Description This function returns the bit error measurement result.
Page 153 Function Reference Bit Error Rate Measurement Function sectors include the number of lost sectors. Direction • lostSector Description Returns the number of lost sectors. Lost sector represents the sector where a synchronized pattern is not found. Direction Return Values Completion Code Description VI_SUCCESS No Error...
Page 154: Hpe5022_Ber_Berex_Q
Function Reference Bit Error Rate Measurement Function hpe5022_BER_berEx_Q C Syntax ViStatus hpe5022_BER_berEx_Q(ViSession id, ViPReal 64 ber, ViPInt32 symbol, ViPInt32 burst, VipInt32 totalSector, ViPInt32 lostSector); Visual Basic hpe5022_BER_berEx_Q(ByVal id As Long, ByRef ber As Double, ByRef symbol Syntax As Long, ByRef burst As Long, ByRef totalSector As Long, ByRef lostSector As Long) As Long Description This function returns the bit error measurement result.
Page 155 Function Reference Bit Error Rate Measurement Function Description Returns the number of burst error array. If an E5039A/B is used as the BER module, it always returns 0. Direction • totalSector Description Returns the number of total sectors. The number of total sectors include the number of lost sectors.
Page 156: Hpe5022_Ber_Berdatasize_Q
Function Reference Bit Error Rate Measurement Function hpe5022_BER_berDataSize_Q C Syntax ViStatus hpe5022_BER_berDataSize_Q(ViSession id, ViPInt32 size); Visual Basic hpe5022_BER_ berDataSize_Q(ByVal id As Long, ByRef size As Long) As Long Syntax Description This function returns the size of the BER data. Parameters •...
Page 157: Hpe5022_Ber_Berdata_Q
Function Reference Bit Error Rate Measurement Function hpe5022_BER_berData_Q C Syntax ViStatus hpe5022_BER_berData_Q(ViSession id, ViInt32 symbol[], ViInt32 lostSector[]); Visual Basic hpe5022_BER_berData_Q(ByVal id As Long, ByRef symbol As Long, ByRef Syntax lostSector As Long) As Long Description This function returns the BER data. Parameters •...
Page 158 Function Reference Bit Error Rate Measurement Function Error Code Description hpe5022_ERROR_NOT_INIT The resource of E5039A/B can not be opened during initialization. Check if E5039A/B is included in the rsrcArray of the "hpe5022_init" function. See Also “hpe5022_BER_setupBer” on page 116 “hpe5022_BER_berDataSize_Q” on page 120 Chapter 3...
Page 159: Hpe5022_Ber_Berdataex_Q
Function Reference Bit Error Rate Measurement Function hpe5022_BER_berDataEx_Q C Syntax ViStatus hpe5022_BER_berDataEx_Q(ViSession id, ViInt32 symbol[], ViInt32 burst[], ViInt32 lostSector[]); Visual Basic hpe5022_BER_berDataEx_Q(ByVal id As Long, ByRef symbol As Long, ByRef Syntax burst As Long, ByRef lostSector As Long) As Long Description This function returns the BER data.
Page 160 Function Reference Bit Error Rate Measurement Function Error Code Description hpe5022_ERROR_DATA_CORRUPT The bit error measurement data is corrupt. Check if your measurement sequence is correct. hpe5022_ERROR_NOT_INIT The resource of E5039A/B can not be opened during initialization. Check if E5039A/B is included in the rsrcArray of the "hpe5022_init"...
Page 161: Hpe5022_Ber_Sectorerrorcountsize_Q
Function Reference Bit Error Rate Measurement Function hpe5022_BER_sectorErrorCountSize_Q C Syntax ViStatus hpe5022_BER_sectorErrorCountSize_Q (ViSession id, ViPInt32 size); Visual Basic hpe5022_BER_sectorErrorCountSize_Q(ByVal id As Long, ByRef size As Long) Syntax As Long Description This function returns the size of array data returned by the “hpe5022_BER_sectorErrorCount_Q”...
Page 162: Hpe5022_Ber_Sectorerrorcount_Q
Function Reference Bit Error Rate Measurement Function hpe5022_BER_sectorErrorCount_Q C Syntax ViStatus hpe5022_BER_sectorErrorCount_Q(ViSession id, ViInt32 err[], ViInt32 lost[]); Visual Basic hpe5022_BER_sectorErrorCount_Q(ByVal id As Long, ByRef err As Long, Syntax ByRef lost As Long) As Long Description This function returns the total of error symbol, lost sectors for each sector. The “hpe5022_BER_measureBer”...
Page 163 Function Reference Bit Error Rate Measurement Function Error Code Description hpe5022_ERROR_INACCURATE_BER The ‘err’ result is not accurate because there are too many errors to count. hpe5022_ERROR_DATA_CORRUPT The bit error measurement data is corrupt. Check if your measurement sequence is correct or if the logging mode has been set to “VI_TRUE”.
Page 164: Hpe5022_Ber_Sectorerrorcountex_Q
Function Reference Bit Error Rate Measurement Function hpe5022_BER_sectorErrorCountEx_Q C Syntax ViStatus hpe5022_BER_sectorErrorCountEx_Q(ViSession id, ViInt32 err[], ViInt32 burst[], ViInt32 lost[]); Visual Basic hpe5022_BER_sectorErrorCountEx_Q(ByVal id As Long, ByRef err As Long, Syntax ByRef burst As Long, ByRef lost As Long) As Long Description This function returns the total count of error symbol, burst error, and lost sectors for each sector.
Page 165 Function Reference Bit Error Rate Measurement Function Return Values Completion Code Description VI_SUCCESS No Error Error Code Description hpe5022_ERROR_INV_ID The handle specified by ‘id’ is invalid. hpe5022_ERROR_INACCURATE_BER The ‘err’ result is not accurate because there are too many errors to count. hpe5022_ERROR_DATA_CORRUPT The bit error measurement data is corrupt.
Page 166: Hpe5022_Ber_Errorlengthhistogram_Q
Function Reference Bit Error Rate Measurement Function hpe5022_BER_errorLengthHistogram_Q C Syntax ViStatus hpe5022_BER_errorLengthHistogram_Q (ViSession id, ViInt32 err[]); Visual Basic hpe5022_BER_errorLengthHistogram_Q(ByVal id As Long, ByRef err As Long) Syntax As Long Description This function returns the error length histogram. The “hpe5022_BER_measureBer” or “hpe5022_BER_setupBer” function must be executed before this function is performed.
Page 167: Hpe5022_Ber_Errorrawdatasize_Q
Function Reference Bit Error Rate Measurement Function hpe5022_BER_errorRawDataSize_Q C Syntax ViStatus hpe5022_BER_errorRawDataSize_Q (ViSession id, ViPInt32 size); Visual Basic hpe5022_BER_errorRawDataSize_Q(ByVal id As Long, ByRef size As Long) As Syntax Long Description This function returns the size of array data returned by the “hpe5022_BER_errorRawData_Q”...
Page 168: Hpe5022_Ber_Errorrawdata_Q
Function Reference Bit Error Rate Measurement Function hpe5022_BER_errorRawData_Q C Syntax ViStatus hpe5022_BER_errorRawData_Q (ViSession id, ViInt32 sector[], ViInt32 locate[], ViInt32 rdData[], ViInt32 wrData[]); Visual Basic hpe5022_BER_errorRawData_Q(ByVal id As Long, ByRef sector As Long, Syntax ByRef locate As Long, ByRef rdData As Integer, ByRef wrData As Integer) As Long Description This function returns the sector number and position in the sector where an error...
Page 169 Function Reference Bit Error Rate Measurement Function Parameters • id Description Specifies the system identifier. This is given by the “hpe5022_init” function. Direction • sector Description Returns the sector number where an error occurred. The returned data is set in array. When the raw data logging mode of “hpe5022_BER_berDataLoggingMode”...
Page 170 Function Reference Bit Error Rate Measurement Function Error Code Description hpe5022_ERROR_INACCURATE_BER Some errors are not listed in the array. because there are too many errors to count. hpe5022_ERROR_DATA_CORRUPT The bit error measurement data is corrupt. Check if your measurement sequence is correct.
Page 171: Bit Error Rate Track Profile Measurement
Function Reference Bit Error Rate Track Profile Measurement Bit Error Rate Track Profile Measurement hpe5022_BER_measureTrackProfile C Syntax ViStatus hpe5022_BER_measureTrackProfile(ViSession id, ViInt16 seqType, ViInt16 measFunc, ViInt16 points, ViReal64 range, ViInt16 ave); Visual Basic hpe5022_BER_measureTrackProfile(ByVal id As Long, ByVal seqType As Syntax Integer, ByVal measFunc As Integer, ByVal points As Integer, ByVal range As Double, ByVal ave As Integer) As Long Description...
Page 172 Function Reference Bit Error Rate Track Profile Measurement Figure 3-8 Head Movement at Track Profile Measurement The “hpe5022_BER_trackProfileData_Q” function returns the measurement results. Parameters • id Description Specifies the system identifier. This is given by the “hpe5022_init” function. Direction • seqType Description Selects the type of measurement sequence.
Page 173 Function Reference Bit Error Rate Track Profile Measurement Values Name Value hpe5022_TRACK_PROFILE_SIZE_MIN hpe5022_TRACK_PROFILE_SIZE_MAX • range Description Specifies the read track offset range. The read track offset can be set from -range to +range by a step of range/(points-1)). ´ Direction Unit Meter Values...
Page 174 Function Reference Bit Error Rate Track Profile Measurement Error Code Description hpe5022_ERROR_HARD_HAMP Hardware error is detected in the head amplifier. hpe5022_ERROR_INV_ID The handle specified by ‘id’ is invalid. hpe5022_ERROR_INV_DRIVE_CONDITION The spinstand drive is turned off. Turn it on before executing this function.
Page 175: Hpe5022_Ber_Setuptrackprofile
Function Reference Bit Error Rate Track Profile Measurement hpe5022_BER_setupTrackProfile C Syntax ViStatus hpe5022_BER_setupTrackProfile(ViSession id, ViInt16 seqType, ViInt16 measFunc, ViInt16 points, const ViReal64 range, ViInt16 ave, ViPObject testHndl); Visual Basic hpe5022_BER_setupTrackProfile(ByVal id As Long, ByVal seqType As Integer, Syntax ByVal measFunc As Integer, ByVal points As Integer, ByVal range As Double, ByVal ave As Integer, ByRef testHndl As Long) As Long Description This function assigns the BER track profile measurement sequence to the specified...
Page 176 Function Reference Bit Error Rate Track Profile Measurement Direction Unit Meter Values Same as ‘range’ parameter in the “hpe5022_BER_measureTrackProfile” function. • ave Description Specifies the average count. Direction Values Name Value hpe5022_BER_TRACK_PROFILE_COUNT_MIN hpe5022_BER_TRACK_PROFILE_COUNT_MAX • testHndl Description Returns the test identifier. This identifier is used to execute the BER’s Track Profile measurement by the “hpe5022_measure”...
Page 177 Function Reference Bit Error Rate Track Profile Measurement “hpe5022_BER_trackProfileData_Q” on page 138 Chapter 3...
Page 178: Hpe5022_Ber_Trackprofiledata_Q
Function Reference Bit Error Rate Track Profile Measurement hpe5022_BER_trackProfileData_Q C Syntax ViStatus hpe5022_BER_trackProfileData_Q(ViSession id, ViInt16 dataType, ViReal64 offset[], ViReal64 data[]); Visual Basic hpe5022_BER_trackProfileData_Q(ByVal id As Long, ByVal dataType As Syntax Integer, ByRef offset As Double, ByRef data As Double) As Long Description This function returns the track profile data of the specified data type.
Page 179 Function Reference Bit Error Rate Track Profile Measurement Return Values Completion Code Description VI_SUCCESS No Error Error Code Description hpe5022_ERROR_INV_ID The handle specified by ‘id’ is invalid. hpe5022_ERROR_INV_PARAMETER The parameter ‘dataType’ is out of range. hpe5022_ERROR_DATA_CORRUPT The BER track profile measurement data is corrupt.
Page 180: Hpe5022_Ber_Otcthreshold
Function Reference Bit Error Rate Track Profile Measurement hpe5022_BER_otcThreshold C Syntax ViStatus hpe5022_BER_otcThreshold(ViSession id, ViReal64 otcThr); Visual Basic hpe5022_BER_otcThreshold(ByVal id As Long, ByVal otcThr As Double) As Syntax Long Description This function specifies the threshold level of the bit error rate for OTC (off-track capability).
Page 181 Function Reference Bit Error Rate Track Profile Measurement “hpe5022_BER_measureTrackProfile” on page 131 “hpe5022_BER_setupTrackProfile” on page 135 Chapter 3...
Page 182: Hpe5022_Ber_Otcthreshold_Q
Function Reference Bit Error Rate Track Profile Measurement hpe5022_BER_otcThreshold_Q C Syntax ViStatus hpe5022_BER_otcThreshold_Q(ViSession id, ViPReal64 otcThr); Visual Basic hpe5022_BER_otcThreshold_Q(ByVal id As Long, ByRef otcThr As Double) As Syntax Long Description This function returns the threshold level specified by the “hpe5022_BER_otcThreshold” function. Parameters •...
Page 183: Hpe5022_Ber_Calculateotc_Q
Function Reference Bit Error Rate Track Profile Measurement hpe5022_BER_calculateOtc_Q C Syntax ViStatus hpe5022_BER_calculateOtc_Q(ViSession id, ViPReal64 otc, ViPReal64 otcPos, ViPReal64 otcNeg); Visual Basic hpe5022_BER_calculateOtc_Q(ByVal id As Long, ByRef otc As Double, ByRef Syntax otcPos As Double, ByRef otcNeg As Double) As Long Description This function calculates the OTC (off-track capability) for bit error rate track profile measurement.
Page 184 Function Reference Bit Error Rate Track Profile Measurement Unit Meter Direction • otcNeg Description Returns the negative OTC. This represents the width from the write track offset position to the negative/left side of the OTC. Unit Meter Direction Return Values Completion Code Description VI_SUCCESS...
Page 185: Hpe5022_Ber_Trackprofiledataex_Q
Function Reference Bit Error Rate Track Profile Measurement hpe5022_BER_trackProfileDataEx_Q C Syntax ViStatus hpe5022_BER_trackProfileDataEx_Q(ViSession id, ViInt16 dataType, ViReal64 offset[], ViReal64 ber[], ViInt32 symbol[], ViInt32 totalSector[], ViInt32 lostSector[]); Visual Basic hpe5022_BER_trackProfileDataEx_Q(ByVal id As Long, ByVal dataType As Syntax Integer, ByRef offset As Double, ByRef ber As Double, ByRef symbol As Integer, ByRef totalSector As Integer, ByRef lostSector As Integer) As Long Description This function reports the track profile data of the bathtub measurement.
Page 186 Function Reference Bit Error Rate Track Profile Measurement Description Returns the number of total sectors in array order. Direction • lostSector Description Returns the total number of lost sectors in array order. Direction Return Values Completion Code Description VI_SUCCESS No Error Error Code Description hpe5022_ERROR_INV_ID...
Page 187: Hpe5022_Ber_Errorthreshold
Function Reference Bit Error Rate Track Profile Measurement hpe5022_BER_errorThreshold C Syntax ViStatus hpe5022_BER_errorThreshold(ViSession id, ViReal64 errThreshold); Visual Basic hpe5022_BER_errorThreshold(ByVal id As Long, ByVal errThreshold As Syntax Double) As Long Description This function specifies the threshold BER. This value affects the bath tub and 747 measurements.
Page 188 Function Reference Bit Error Rate Track Profile Measurement Error Code Description hpe5022_ERROR_NSUP_FUNC This function is not supported by the module currently in use. See Also “hpe5022_BER_errorThreshold_Q” on page 189“ Chapter 3...
Page 189: Hpe5022_Ber_Errorthreshold_Q
Function Reference Bit Error Rate Track Profile Measurement hpe5022_BER_errorThreshold_Q C Syntax ViStatus hpe5022_BER_errorThreshold_Q(ViSession id, ViPReal64 errThreshold); Visual Basic hpe5022_BER_errorThreshold_Q(ByVal id As Long, ByRef errThreshold As Syntax Double) As Long Description This function returns the threshold BER. This function is only available for use with the E5039C bit error test module.
Page 190: Hpe5022_Ber_Errorthresholdmode
Function Reference Bit Error Rate Track Profile Measurement hpe5022_BER_errorThresholdMode C Syntax ViStatus hpe5022_BER_errorThresholdMode(ViSession id, ViInt16 mode); Visual Basic hpe5022_BER_errorThresholdMode(ByVal id As Long, ByVal mode As Integer) Syntax As Long Description This function specifies the error threshold mode. This value affects the bath tub and 747 measurements.
Page 191 Function Reference Bit Error Rate Track Profile Measurement Error Code Description hpe5022_ERROR_INV_PARAMETER The parameter ‘mode’ is out of range. hpe5022_ERROR_NSUP_FUNC This function is not supported by the module currently in use. See Also “hpe5022_BER_errorThresholdMode_Q” on page 192“ Chapter 3...
Page 192: Hpe5022_Ber_Errorthresholdmode_Q
Function Reference Bit Error Rate Track Profile Measurement hpe5022_BER_errorThresholdMode_Q C Syntax ViStatus hpe5022_BER_errorThresholdMode_Q(ViSession id, ViPInt16 mode); Visual Basic hpe5022_BER_errorThresholdMode_Q(ByVal id As Long, ByRef mode As Syntax Integer) As Long Description This function returns the error threshold mode. This function is only available for use with the E5039C bit error test module.
Page 193: Hpe5022_Ber_Channelicadaptiveregister
Function Reference Bit Error Rate Track Profile Measurement hpe5022_BER_channelIcAdaptiveRegister C Syntax ViStatus hpe5022_BER_channelIcAdaptiveRegister(ViSession id, ViInt32 points, const ViInt32 addr[]); Visual Basic hpe5022_BER_channelIcAdaptiveRegister(ByVal id As Long, ByVal points As Syntax Long, ByRef addr As Long) As Long Description This function specifies the adaptive register list. The adaptive registers specified by this function are used in sequences including the following parameter sweep functions: “hpe5022_BER_measureTrackProfile”...
Page 194 Function Reference Bit Error Rate Track Profile Measurement Values Name Value hpe5022_BER_REG_ADDR_MIN hpe5022_BER_REG_ADDR_MAX 0x3ffff hpe5022_BER_REG_COUN_MAX Return Values Completion Code Description VI_SUCCESS No Error Error Code Description hpe5022_ERROR_NOT_INIT The resource of Agilent E5039C can not be opened during initialization. Check if the Agilent E5039C is included in the rsrcArray of the “hpe5022_init”...
Page 195: Hpe5022_Ber_Channelicadaptiveregister_Q
Function Reference Bit Error Rate Track Profile Measurement hpe5022_BER_channelIcAdaptiveRegister_Q C Syntax ViStatus hpe5022_BER_channelIcAdaptiveRegister_Q(ViSession id, ViPInt32 points, ViInt32 addr[]); Visual Basic hpe5022_BER_channelIcAdaptiveRegister_Q(ByVal id As Long, ByRef points Syntax As Long, ByRef addr As Long) As Long Description This function returns the adaptive register list. This function is only available for use with the E5039C bit error test module.
Page 196 Function Reference Bit Error Rate Track Profile Measurement See Also “hpe5022_BER_channelIcAdaptiveRegister” on page 193“ Chapter 3...
Page 197: 747 Measurement Function
Function Reference 747 Measurement Function 747 Measurement Function hpe5022_BER_747Config C Syntax ViStatus hpe5022_BER_747Config(ViSession id, ViInt16 old_pat, ViReal64 old_pos, ViInt16 adj_pat, ViInt32 trk_prof_size, const ViReal64 trk_prof_range, ViInt16 trk_prof_ave); Visual Basic hpe5022_BER_747Config(ByVal id As Long, ByVal old_pat As Integer, ByVal Syntax old_pos As Double, ByVal adj_pat As Integer, ByVal trk_prof_size As Long, ByRef trk_prof_range As Double, ByVal trk_prof_ave As Integer) As Long Description This function configures the 747 test.
Page 198 Function Reference 747 Measurement Function Unit Meter • adj_pat Description Specifies the data pattern of the adjacent track. Direction Preset Value pe5022_BER_PAT_2 Values Same as ‘pat’ parameter in the “hpe5022_BER_selectPattern” function. • trk_prof_size Description Specifies the number of points for track profile measurement.
Page 199 Function Reference 747 Measurement Function Values Name Value hpe5022_BER_TRACK_PROFILE_COUNT_MIN hpe5022_BER_TRACK_PROFILE_COUNT_MAX Return Values Completion Code Description VI_SUCCESS No Error Error Code Description hpe5022_ERROR_INV_ID The handle specified by ‘id’ is invalid. hpe5022_ERROR_INV_PARAMETER The parameter ‘oldpat’, ‘old_pos’, ‘adj_pat’, ‘trk_prof_size’ and/or ‘trk_prof_range’ is out of range. hpe5022_ERROR_NOT_INIT The resource of E5039A/B can not be opened during initialization.
Page 200: Hpe5022_Ber_747Config_Q
Function Reference 747 Measurement Function hpe5022_BER_747Config_Q C Syntax ViStatus hpe5022_BER_747Config_Q(ViSession id, ViPInt16 old_pat, ViPReal64 old_pos, ViPInt16 adj_pat, ViPInt32 trk_prof_size, ViPReal64 trk_prof_range, ViPInt16 trk_prof_ave); Visual Basic hpe5022_BER_747Config_Q(ByVal id As Long, ByRef old_pat As Integer, Syntax ByRef old_pos As Double, ByRef adj_pat As Integer, ByRef trk_prof_size As Long, ByRef trk_prof_range As Double, ByRef trk_prof_ave As Integer) As Long Description This function returns the 747 test configuration specified by the...
Page 201 Function Reference 747 Measurement Function Return Values Completion Code Description VI_SUCCESS No Error Error Code Description hpe5022_ERROR_INV_ID The handle specified by ‘id’ is invalid. hpe5022_ERROR_NOT_INIT The resource of E5039A/B can not be opened during initialization. Check if E5039A/B is included in the rsrcArray of the "hpe5022_init"...
Page 202: Hpe5022_Ber_Measure747
Function Reference 747 Measurement Function hpe5022_BER_measure747 C Syntax ViStatus hpe5022_BER_measure747(ViSession id, ViInt32 points, const ViReal64 offset[]); Visual Basic hpe5022_BER_measure747(ByVal id As Long, ByVal points As Long, ByRef Syntax offset As Double) As Long Description This function performs the 747 test. The 747 measures the OTC (off-track capability) versus the track offset when BER is measured.
Page 203 Function Reference 747 Measurement Function Direction • points Description Specifies the number of measurement points to build the 747 curve. This number must be the same as the array size of ‘offset’ Direction Values Name Value hpe5022_BER_747_SIZE_MIN hpe5022_BER_747_SIZE_MAX • offset Description Specifies the distance between the track center and its adjacent track to be listed in array order.
Page 204 Function Reference 747 Measurement Function Error Code Description hpe5022_ERROR_INV_ID The handle specified by ‘id’ is invalid. hpe5022_ERROR_INV_DRIVE_CONDITION The spinstand drive is turned off. Turn it on before executing this function. See the “hpe5022_driveState” function. hpe5022_ERROR_INV_PARAMETER The parameter ‘points’ and/or ‘offset’ is out of range. hpe5022_ERROR_NOT_INIT The resource of E5039A/B can not be opened during initialization.
Page 205: Hpe5022_Ber_Setup747
Function Reference 747 Measurement Function hpe5022_BER_setup747 C Syntax ViStatus hpe5022_BER_setup747(ViSession id, ViInt32 points, const ViReal64 offset[], ViPObject testHndl); Visual Basic hpe5022_BER_setup747(ByVal id As Long, ByVal points As Long, ByRef offset Syntax As Double, ByRef testHndl) As Long Description This function assigns the 747 measurement sequence to the specified test identifier.
Page 206 Function Reference 747 Measurement Function Return Values Completion Code Description VI_SUCCESS No Error Error Code Description hpe5022_ERROR_INV_ID The handle specified by ‘id’ is invalid. hpe5022_ERROR_INV_PARAMETER The parameter ‘point’ or/and ‘offset’ is out of range. hpe5022_ERROR_MEM_ALLOC Lack of memory. Release the finished setup function using the “hpe5022_releaseSetup”...
Page 207: Hpe5022_Ber_747Datasize_Q
Function Reference 747 Measurement Function hpe5022_BER_747DataSize_Q C Syntax ViStatus hpe5022_BER_747DataSize_Q(ViSession id, ViPInt32 size); Visual Basic hpe5022_BER_747DataSize_Q(ByVal id As Long, ByRef size As Long) As Long Syntax Description This function returns the array size of 747 test returned by the “hpe5022_BER_747Data_Q” function. Parameters •...
Page 208: Hpe5022_Ber_747Data_Q
Function Reference 747 Measurement Function hpe5022_BER_747Data_Q C Syntax ViStatus hpe5022_BER_747Data_Q(ViSession id, ViReal64 data[]); Visual Basic hpe5022_BER_747Data_Q(ByVal id As Long, ByRef data As Double) As Long Syntax Description This function returns the data of the 747 Test. Parameters • id Description Specifies the system identifier.
Page 209: Channel Quality Measurement Function
Function Reference Channel Quality Measurement Function Channel Quality Measurement Function hpe5022_BER_autoRangeChannelQuality C Syntax ViStatus hpe5022_BER_autoRangeChannelQuality (ViSession id); Visual Basic hpe5022_BER_autoRangeChannelQuality (ByVal id As Long) As Long Syntax Description This function executes auto ranging for the channel quality. Executing this function measures a channel quality and optimize an range. It is recommended to execute this function before a channel quality measurement is made.
Page 210 Function Reference Channel Quality Measurement Function See Also “hpe5022_BER_measureChannelQuality” on page 161 “hpe5022_BER_setupChannelQuality” on page 163 “hpe5022_BER_optimize” on page 98 Chapter 3...
Page 211: Hpe5022_Ber_Measurechannelquality
Function Reference Channel Quality Measurement Function hpe5022_BER_measureChannelQuality C Syntax ViStatus hpe5022_BER_measureChannelQuality(ViSession id, ViInt16 seqType); Visual Basic hpe5022_BER_measureChannelQuality(ByVal id As Long, ByVal seqType As Syntax Integer) As Long Description This function measures the channel quality. The detailed sequence is as follows: 1.
Page 212 Function Reference Channel Quality Measurement Function Error Code Description hpe5022_ERROR_EXCESS_TRACK_DATA The data overflows a track at one revolution. Change the setting of the user data rate, rpm , track number, track format or sector format. hpe5022_ERROR_HARD_HAMP Hardware error is detected in the head amplifier.
Page 213: Hpe5022_Ber_Setupchannelquality
Function Reference Channel Quality Measurement Function hpe5022_BER_setupChannelQuality C Syntax ViStatus hpe5022_BER_setupChannelQuality(ViSession id, ViInt16 seqType, ViPObject testHndl); Visual Basic hpe5022_BER_setupChannelQuality(ByVal id As Long, ByVal seqType As Syntax Integer, ByRef testHndl As Long) As Long Description This function assigns the channel quality measurement sequence to the specified test identifier.
Page 214 Function Reference Channel Quality Measurement Function Error Code Description hpe5022_ERROR_MEM_ALLOC Lack of memory. Release the finished setup function using the “hpe5022_releaseSetup” function. hpe5022_ERROR_NOT_INIT The resource of E5039A/B can not be opened during initialization. Check if E5039A/B is included in the rsrcArray of the "hpe5022_init"...
Page 215: Hpe5022_Ber_Channelquality_Q
Function Reference Channel Quality Measurement Function hpe5022_BER_channelQuality_Q C Syntax ViStatus hpe5022_BER_channelQuality_Q (ViSession id, ViPReal64 cha_qual, ViPInt32 err_count, ViPInt32 totalSector, ViPInt32 lostSector); Visual Basic hpe5022_BER_channelQuality_Q(ByVal id As Long, ByRef chan_qual As Syntax Double, ByRef err_count As Long, ByRef totalSector As Long, ByRef lostSector As Long) As Long Description This function returns the channel quality measurement result.
Page 216 Function Reference Channel Quality Measurement Function Error Code Description hpe5022_ERROR_INV_ID The handle specified by ‘id’ is invalid. hpe5022_ERROR_DATA_CORRUPT The channel quality measurement data is corrupt. Check if your measurement sequence is correct. hpe5022_ERROR_NOT_INIT The resource of E5039A/B can not be opened during initialization.
Page 217: Hpe5022_Ber_Channelqualityrawdatasize_Q
Function Reference Channel Quality Measurement Function hpe5022_BER_channelQualityRawDataSize_Q C Syntax ViStatus hpe5022_BER_channelQualityRawDataSize_Q (ViSession id, ViPInt32 size); Visual Basic hpe5022_BER_channelQualityRawDataSize_Q(ByVal id As Long, ByRef size As Syntax Long) As Long Description This function returns the size of array data returned by the “hpe5022_BER_channelQualityRawData_Q”...
Page 218: Hpe5022_Ber_Channelqualityrawdata_Q
Function Reference Channel Quality Measurement Function hpe5022_BER_channelQualityRawData_Q C Syntax ViStatus hpe5022_BER_channelQualityRawData_Q (ViSession id, ViPReal64 chan_qual[], ViInt32 err_count[]); Visual Basic hpe5022_BER_channelQualityRawData_Q(ByVal id As Long, ByRef chan_qual Syntax As Double, ByRef error_count As Long) As Long Description This function returns the measurement result of the channel quality for each sector. Parameters •...
Page 219 Function Reference Channel Quality Measurement Function Error Code Description hpe5022_ERROR_NOT_INIT The resource of E5039A/B can not be opened during initialization. Check if E5039A/B is included in the rsrcArray of the "hpe5022_init" function. See Also “hpe5022_BER_measureChannelQuality” on page 161 “hpe5022_BER_setupChannelQuality” on page 163 “hpe5022_BER_channelQualityRawDataSize_Q”...
Page 220: Channel Ic Register Sweep Measurement
Function Reference Channel IC Register Sweep Measurement Channel IC Register Sweep Measurement hpe5022_BER_measureChannelIcRegisterSweep C Syntax ViStatus hpe5022_BER_measureChannelIcRegisterSweep(ViSession id, ViInt16 seqType, ViInt32 addr, ViInt32 upperBitPos, ViInt32 lowerBitPos, ViInt16 points, ViInt32 reg_list[]); Visual Basic hpe5022_BER_measureChannelIcRegisterSweep(ByVal id As Long, ByVal Syntax seqType As Integer, ByVal addr As Long, ByVal upperBitPos As Long, ByVal lowerBitPos As Long, ByVal points As Integer, ByRef reg_list As Long) As Long Description This function performs the channel IC register value sweep.
Page 221 Function Reference Channel IC Register Sweep Measurement sweep. Direction Values Name Value Description Write ® Measure ® Write ® hpe5022_SEQ_WR_M Measure ® ... hpe5022_SEQ_M Write ® Measure ® Measure ® Measure ® ... • addr Description Specifies the channel IC register address. Direction Name Value...
Page 222 Function Reference Channel IC Register Sweep Measurement Direction Values Name Value hpe5022_BER_REG_SWEEP_COUN_MIN hpe5022_BER_REG_SWEEP_COUN_MAX • reg_list Description Specifies the channel IC register value list. Direction Values Name Value hpe5022_BER_REG_DATA_MIN hpe5022_BER_REG_DATA_MAX 65,535 Return Values Completion Code Description VI_SUCCESS No Error Error Code Description hpe5022_ERROR_EXCESS_TRACK_DATA The data overflows a track at one...
Page 223 Function Reference Channel IC Register Sweep Measurement Error Code Description hpe5022_ERROR_NOT_INIT The resource of E5039A/B can not be opened during initialization. Check if E5039A/B is included in the rsrcArray of the "hpe5022_init" function. See Also “hpe5022_BER_setupChannelIcRegisterSweep” on page 224 “hpe5022_BER_channelIcRegisterSweepData_Q” on page 227 Chapter 3...
Page 224: Hpe5022_Ber_Setupchannelicregistersweep
Function Reference Channel IC Register Sweep Measurement hpe5022_BER_setupChannelIcRegisterSweep C Syntax ViStatus hpe5022_BER_setupChannelIcRegisterSweep(ViSession id, ViInt16 seqType, ViInt32 addr, ViInt32 upperBitPos, ViInt32 lowerBitPos, ViInt16 points, ViInt32 reg_list[], ViPObject testHndl); Visual Basic hpe5022_BER_setupChannelIcRegisterSweep(ByVal id As Long, ByVal seqType Syntax As Integer, ByVal addr As Long, ByVal upperBitPos As Long, ByVal lowerBitPos As Long, ByVal points As Integer, ByRef reg_list As Long, ByRef testHndl As Long) As Long Description...
Page 225 Function Reference Channel IC Register Sweep Measurement function. • lowerBitPos Description Specifies the channel IC register’s lower bit position. Direction Values Same as ‘lowerBitPos’ parameter in the “hpe5022_BER_measureChannelIcRegisterSweep” function. • points Description Specifies the number of points for register sweep. Direction Values Same as ‘points’...
Page 226 Function Reference Channel IC Register Sweep Measurement Error Code Description hpe5022_ERROR_MEM_ALLOC Lack of memory. Release the finished setup function using the “hpe5022_releaseSetup” function. hpe5022_ERROR_NOT_INIT The resource of E5039A/B can not be opened during initialization. Check if E5039A/B is included in the rsrcArray of the "hpe5022_init"...
Page 227: Hpe5022_Ber_Channelicregistersweepdata_Q
Function Reference Channel IC Register Sweep Measurement hpe5022_BER_channelIcRegisterSweepData_Q C Syntax ViStatus hpe5022_BER_channelIcRegisterSweepData_Q(ViSession id, ViReal64 chan_qual[], ViInt32 err_count[], ViInt32 lostSector[]); Visual Basic hpe5022_BER_channelIcRegisterSweepData_Q(ByVal id As Long, ByRef Syntax chan_qual As Double, ByRef err_count As Long, ByRef lostSector As Long) As Long Description This function returns the channel IC register value sweep data from the specified data.
Page 228 Function Reference Channel IC Register Sweep Measurement Return Values Completion Code Description VI_SUCCESS No Error Error Code Description hpe5022_ERROR_INV_ID The handle specified by ‘id’ is invalid. hpe5022_ERROR_DATA_CORRUPT The register sweep measurement data is corrupt. Check if your measurement sequence is correct. hpe5022_ERROR_NOT_INIT The resource of E5039A/B can not be opened during initialization.
Page 229: Hpe5022_Ber_Measurechannelicmultipleregistersweep
Function Reference Channel IC Register Sweep Measurement hpe5022_BER_measureChannelIcMultipleRegisterSweep C Syntax ViStatus hpe5022_BER_measureChannelIcMultipleRegisterSweep(ViSession id, ViInt16 seqType, ViInt16 regPoints, const ViInt32 addr[], const ViInt32 upperBitPos[], const ViInt32 lowerBitPos[], ViInt16 sweepPoints, ViInt32 reg_list[]); Visual Basic hpe5022_BER_measureChannelIcMultipleRegisterSweep(ByVal id As Long, Syntax ByVal seqType As Integer, ByVal regPoints As Integer, ByVal addr As Long, ByVal upperBitPos As Long, ByVal lowerBitPos As Long, ByVal sweepPoints As Integer, ByRef reg_list As Long) As Long Description...
Page 230 Function Reference Channel IC Register Sweep Measurement Description Specifies the channel IC register address. The length of the array is ‘regPoints.’ Direction Values Name Value hpe5022_BER_REG_ADDR_MIN hpe5022_BER_REG_ADDR_MAX 0x3ffff • upperBitPos Description Specifies the upper bit position of the channel IC register. The length of the array is ‘regPoints.’...
Page 231 Function Reference Channel IC Register Sweep Measurement • reg_list Description Specifies the channel IC register value list. The sweep data ‘reg_list’ is one-dimensional array and includes ‘sweepPoints’ blocks of multiple registers per read/write operation. The number of registers in a block is ‘regPoints.’ As a result, the length of the list is ‘regPoints’...
Page 232 Function Reference Channel IC Register Sweep Measurement Error Code Description hpe5022_ERROR_NSUP_FUNC This function is not supported by the module currently in use. See Also “hpe5022_BER_setupChannelIcMultipleRegisterSweep” on page 233“ “hpe5022_BER_channelIcMultipleRegisterSweepData_Q” on page 237“ Chapter 3...
Page 233: Hpe5022_Ber_Setupchannelicmultipleregistersweep
Function Reference Channel IC Register Sweep Measurement hpe5022_BER_setupChannelIcMultipleRegisterSweep C Syntax ViStatus hpe5022_BER_setupChannelIcMultipleRegisterSweep(ViSession id, ViInt16 seqType, ViInt16 regPoints, const ViInt32 addr[], const ViInt32 upperBitPos[], const ViInt32 lowerBitPos[], ViInt16 sweepPoints, ViInt32 reg_list[], const ViPObject testHndl); Visual Basic hpe5022_BER_setupChannelIcMultipleRegisterSweep(ByVal id As Long, ByVal Syntax seqType As Integer, ByVal regPoints As Integer, ByVal addr As Long, ByVal upperBitPos As Long, ByVal lowerBitPos As Long, ByVal sweepPoints As...
Page 234 Function Reference Channel IC Register Sweep Measurement Description Specifies the channel IC register address. The length of the array is ‘regPoints.’ Direction Values Name Value hpe5022_BER_REG_ADDR_MIN hpe5022_BER_REG_ADDR_MAX 0x3ffff • upperBitPos Description Specifies the uupper bit position of the channel IC register. The length of the array is ‘regPoints.’...
Page 235 Function Reference Channel IC Register Sweep Measurement • reg_list Description Specifies the channel IC register value list. The sweep data ‘reg_list’ is one-dimensional array and includes ‘sweepPoints’ blocks of multiple registers per read/write operation. The number of registers in a block is ‘regPoints.’ As a result, the length of the list is ‘regPoints’...
Page 236 Function Reference Channel IC Register Sweep Measurement Error Code Description hpe5022_ERROR_NSUP_FUNC This function is not supported by the module currently in use. See Also “hpe5022_BER_measureChannelIcMultipleRegisterSweep” on page 229“ Chapter 3...
Page 237: Hpe5022_Ber_Channelicmultipleregistersweepdata_Q
Function Reference Channel IC Register Sweep Measurement hpe5022_BER_channelIcMultipleRegisterSweepData_Q C Syntax ViStatus hpe5022_BER_channelIcMultipleRegisterSweepData_Q(ViSession id, ViReal64 chan_qual[], ViInt32 err_count[], ViInt32 lostSector[]); Visual Basic hpe5022_BER_channelIcMultipleRegisterSweepData_Q(ByVal id As Long, Syntax ByRef chan_qual As Double, ByRef err_count As Long, ByRef lostSector As Long) As Long Description This function returns the data of the channel IC multiple register value sweep.
Page 238 Function Reference Channel IC Register Sweep Measurement Values Name Value hpe5022_BER_REG_SWEEP_REG_COUN_MAX Return Values Completion Code Description VI_SUCCESS No Error Error Code Description hpe5022_ERROR_NOT_INIT The resource of Agilent E5039C can not be opened during initialization. Check if the Agilent E5039C is included in the rsrcArray of the “hpe5022_init”...
Page 239: Hpe5022_Ber_Channelboardiodata
Function Reference Channel IC Register Sweep Measurement hpe5022_BER_channelBoardIoData C Syntax ViStatus hpe5022_BER_channelBoardIoData(ViSession id, ViInt32 addr, ViInt32 data); Visual Basic hpe5022_BER_channelBoardIoData(ByVal id As Long, ByVal addr As Long, Syntax ByVal data As Long) As Long Description This function writes the specified data into the specified channel board I/O address.
Page 240 Function Reference Channel IC Register Sweep Measurement Error Code Description hpe5022_ERROR_INV_PARAMETER The parameter ‘addr’ or ‘data’ is out of range. hpe5022_ERROR_NSUP_FUNC This function is not supported by the module currently in use. See Also “hpe5022_BER_channelBoardIoData_Q” on page 241“ Chapter 3...
Page 241: Hpe5022_Ber_Channelboardiodata_Q
Function Reference Channel IC Register Sweep Measurement hpe5022_BER_channelBoardIoData_Q C Syntax ViStatus hpe5022_BER_channelBoardIoData_Q(ViSession id, ViInt32 addr, ViInt32 data); Visual Basic hpe5022_BER_channelBoardIoData_Q(ByVal id As Long, ByVal addr As Long, Syntax ByRef data As Long) As Long Description This function returns the channel board I/O data from the specified channel board I/O address.
Page 242 Function Reference Channel IC Register Sweep Measurement Error Code Description hpe5022_ERROR_INV_PARAMETER The parameter ‘addr’ is out of range. hpe5022_ERROR_NSUP_FUNC This function is not supported by the module currently in use. See Also “hpe5022_BER_channelBoardIoData_Q” on page 241“ Chapter 3...
Page 243: Hpe5022_Ber_Channelboardromdata
Function Reference Channel IC Register Sweep Measurement hpe5022_BER_channelBoardRomData C Syntax ViStatus hpe5022_BER_channelBoardRomData(ViSession id, ViInt32 addr, ViInt32 size, const ViInt32 data[]); Visual Basic hpe5022_BER_channelBoardRomData(ByVal id As Long, ByVal addr As Long, Syntax ByVal size As Long, ByRef data As Long) As Long Description This function writes the data to the channel board EEPROM.
Page 244 Function Reference Channel IC Register Sweep Measurement Error Code Description hpe5022_ERROR_INV_ID The handle specified by ‘id’ is invalid. hpe5022_ERROR_INV_PARAMETER The parameter ‘addr,’ ‘size,’ or ‘data’ is out of range. hpe5022_ERROR_NSUP_FUNC This function is not supported by the module currently in use. See Also “hpe5022_BER_channelBoardRomData_Q”...
Page 245: Hpe5022_Ber_Channelboardromdata_Q
Function Reference Channel IC Register Sweep Measurement hpe5022_BER_channelBoardRomData_Q C Syntax ViStatus hpe5022_BER_channelBoardRomData_Q(ViSession id, ViInt32 addr, ViInt32 size, ViInt32 data[]); Visual Basic hpe5022_BER_channelBoardRomData_Q(ByVal id As Long, ByVal addr As Syntax Long, ByVal size As Long, ByRef data As Long) As Long Description This function reads and returns the data from the channel board EEPROM.
Page 246 Function Reference Channel IC Register Sweep Measurement Error Code Description hpe5022_ERROR_INV_PARAMETER The parameter ‘addr’ or ‘size’ is out of range. hpe5022_ERROR_NSUP_FUNC This function is not supported by the module currently in use. See Also “hpe5022_BER_channelBoardRomData” on page 243“ “hpe5022_BER_channelBoardRomAddressRange_Q” on page 247“ Chapter 3...
Page 247: Hpe5022_Ber_Channelboardromaddressrange_Q
Function Reference Channel IC Register Sweep Measurement hpe5022_BER_channelBoardRomAddressRange_Q C Syntax ViStatus hpe5022_BER_channelBoardRomAddressRange_Q(ViSession id, ViPInt32 address_min, ViPInt32 address_max); Visual Basic hpe5022_BER_channelBoardRomAddressRange_Q(ByVal id As Long, ByRef Syntax address_min As Long, ByRef address_max As Integer) As Long Description This function returns the address range of the channel board EEPROM. This function is only available for use with the E5039C bit error test module.
Page 248 Function Reference Channel IC Register Sweep Measurement Chapter 3...
Page 249: Manual Changes
Manual Changes This appendix contains the information of the firmware/software versions and or configurations of the Agilent Technologies E5022A/B. The information in this manual applies directly to an Agilent Technologies E5022A/B whose firmware/software revision is listed on the title page of this manual.
Page 250: Changes In Revision A.04.30 From Revion A.04.20
Manual Changes Changes in Revision A.04.30 from Revion A.04.20 Changes in Revision A.04.30 from Revion A.04.20 The following functions have been added. • hpe5022_BER_optimizeSequenceConfig • hpe5022_BER_optimizeSequenceConfig_Q • hpe5022_BER_trackOffsetCompInterval • hpe5022_BER_trackOffsetCompInterval_Q Appendix A...
Page 251: Changes In Revision A.04.20 From Revion A.04.10.Xx
Manual Changes Changes in Revision A.04.20 from Revion A.04.10.xx Changes in Revision A.04.20 from Revion A.04.10.xx The following values are added in the “hpe5022_BER_channelIcEndec” function. • hpe5022_BER_ENDEC_96_100 • hpe5022_BER_ENDEC_96_102 Appendix A...
Page 252: Changes In Revision A.04.00.01 From Revion A.04.00
Manual Changes Changes in Revision A.04.00.01 from Revion A.04.00 Changes in Revision A.04.00.01 from Revion A.04.00 The following functions are added. • “hpe5022_BER_adjacentTrackPattern” • “hpe5022_BER_adjacentTrackPattern_Q” Appendix A...
Page 253 Index Numerics hpe5022_BER_berEx_Q, 154 hpe5022_BER_berMeasByteCount, 134 747 measurement, 197 hpe5022_BER_berMeasByteCount_Q, 137 hpe5022_BER_burstThreshold, 144 hpe5022_BER_burstThreshold_Q, 146 adjacent track, 197 hpe5022_BER_calculateOtc_Q, 183 hpe5022_BER_channelBoardIoData, 239 hpe5022_BER_channelBoardIoData_Q, 241 hpe5022_BER_channelBoardRomAddressRange_Q, 247 BER (Bit Error Rate), 19 hpe5022_BER_channelBoardRomData, 243 bit error rate calculation, 138, 152, 154 hpe5022_BER_channelBoardRomData_Q, 245 Bit Length, 134 hpe5022_BER_channelIcAdaptiveRegister, 193...
Page 254 Index hpe5022_BER_measure747 hpe5022_BER_trackFormat, 23 , 202 hpe5022_BER_trackFormat_Q, 26 hpe5022_BER_measureBer, 147 hpe5022_BER_trackOffsetCompInterval, 131 hpe5022_BER_measureChannelIcMultipleRegisterSweep, hpe5022_BER_trackOffsetCompInterval_Q, 133 hpe5022_BER_trackProfileData_Q, 178 hpe5022_BER_measureChannelIcRegisterSweep hpe5022_BER_trackProfileDataEx_Q, 185 , 220 hpe5022_BER_triggerDelayTime, 52 hpe5022_BER_measureChannelQuality, 211 hpe5022_BER_triggerDelayTime_Q, 53 hpe5022_BER_measureTrackProfile, 171 hpe5022_BER_userDataBitRate, 20 hpe5022_BER_optimize hpe5022_BER_userDataBitRate_Q, 22 , 129 hpe5022_BER_userPattern hpe5022_BER_optimizeSequenceConfig, 127 , 38 hpe5022_BER_optimizeSequenceConfig_Q, 128 hpe5022_BER_userPattern_Q...
Page 255 Index preamble, 23 user defined data pattern, 38 Index...
Page 257 REGIONAL SALES AND SUPPORT OFFICES For more information about Agilent Technologies test and measurement products, applications, services, and for a current sales office listing, visit our web site: http://www.agilent.com/find/tmdir. You can also contact one of the following centers and ask for a test and measurement sales representative.

This manual is also suitable for:

E5023a E5022a E5039c E5039a E5039b

Agilent Technologies E5022B Programming Manual

1 Introduction

2 Sample Program

3 Function Reference

Quick Links

Related Manuals for Agilent Technologies E5022B

Summary of Contents for Agilent Technologies E5022B