浙江海鹽涵普控源動態(tài)庫接口說明文檔

1、海鹽涵普控源動態(tài)庫接口說明文檔由于動態(tài)庫為Delphi所寫，所以提供Delphi函數(shù)的接口，函數(shù)所用的參數(shù)類型都為整型和單精度類型，對其他程序語言的兼容性應(yīng)該沒有問題。所以下面對動態(tài)庫接口的各個函數(shù)的說明都是用Delphi定義的。1、 信號源升源函數(shù)1) 三相升源函數(shù)，早期C型和D型臺體升源函數(shù)：OutPutData_gSub(pLngAjust:LongInt; pLngSourceType:LongInt;pIntComPort:LongInt; pIntPhase:LongInt;pIntStatus:LongInt; pIntSequence:LongInt;pSngVoltage:S

2、ingle; pSngCurrent:Single;pSngFrequency:Single; pIntIABC:LongInt;pIntIB:LongInt; pIntLC:LongInt;pIntWave:LongInt; pIntWaveTimes:LongInt;pLngUWave:LongInt; pLngIWave:LongInt;Var pDelay_Time:DelayTime):LongInt;Stdcall;export; 函數(shù)相應(yīng)參數(shù)說明： pLngAjust - 是否對輸出作自動調(diào)整，1-調(diào)整，0-不調(diào)整。 pLngSourceType -信號源類型l 1、2為C形輸出

3、的信號源，l 3為D輸出的信號源，l 4為DSP信號源(此處無效) 參數(shù)說明：由于C型為2000年以前的老臺體，現(xiàn)在已經(jīng)很少，所以現(xiàn)在此函數(shù)主要用來控制D型臺體，而Dsp型則用函數(shù)DspOutPut函數(shù)來實現(xiàn)（下文會有詳細(xì)說明）。 pIntComPort - 臺體通訊用的串口 發(fā)送時為LongInt類型 即Com1傳送 1 ，以此類推。pIntPhase - 相線 l 1表示3P3W（三相三線有功）l 2表示3p3w(60Var)（三相三線60度無功）l 3表示3p3w(90Var)（三相三線90度無功）l 4表示3p3w(正弦Var)（三相三線正弦無功）l 5表示3P4W（三相四線有功）l

4、6表示3p4w(90Var)（三相四線90度無功）l 7表示3p4w(正弦Var)（三相四線正弦無功） pIntStatus - 測試狀態(tài)l 0 - 正向有功l 1 - 反向有功l 2 - 正向無功l 3 - 反向無功 pIntSequence - 相序l 1 - 正相序l 2 - 逆相序 pSngVoltage，pSngCurrent，pSngFrequency 為電壓，電流及其頻率， 其發(fā)送格式都為單精度Single類型 其輸入的數(shù)值為電表的額定電壓、電流即頻率數(shù)值。 pIntIABC - 電流相別l 0 - 表示ABC相三相電流輸出l 1 - 表示A相電流分相輸出l 2 - 表示B相電流

5、分相輸出l 3 - 表示C相電流分相輸出 pIntIB - 電流負(fù)載 此函數(shù)輸出格式為額定電流的百分比。 例如：電表標(biāo)定電流為5A，最大電流為20A 如果要升10A電流，則電流負(fù)載參數(shù) pIntIB的輸出值為200. pIntLC - 功率因數(shù) 由于功率因數(shù)需要傳遞的是1.0L、0.5C等，但是函數(shù)中的 此參數(shù)pIntLC傳遞的是LongInt類型，所以必須把需要傳 遞的功率因數(shù)進(jìn)行一下轉(zhuǎn)換。轉(zhuǎn)換格式如下： 如果是 1.0L，換算公式為 （1.0*1000）*10+1=10001 0.5C，換算公司為 （0.5*1000）*10+2=5002 以上換算過程中，L表示1，C表示2. 這里給一個V

6、b的換算過程： lStrLC = "0.5L" (此處為升源所需要的功率因數(shù)) pIntLC = Val(Mid(lStrLC, 1, Len(lStrLC) - 1) * 1000 If Mid(lStrLC, Len(lStrLC), 1) = "L" Then lIntLC = lIntLC * 10 + 1 ElseIf Mid(lStrLC, Len(lStrLC), 1) = "C" Then lIntLC = lIntLC * 10 + 2 End If pIntWave - 輸出的波形類別l 1、正弦波l 2、次群波（

7、奇次諧波）l 3、諧波l 4、可控硅波（偶次諧波） 一般的臺體上，此參數(shù)都選擇1（正弦波），其他波形都必 須是臺體硬件支持才能實現(xiàn)，否則無效。 pIntWaveTimes - 諧波次數(shù) pLngUWave，pLngIWave - 電壓、電流諧波時的百分含量 此參數(shù)中，傳遞的是三相電壓、電流的百分含量，所以三相的 含量必須組合在一起轉(zhuǎn)換成LongInt類型進(jìn)行賦值傳遞。 例如：電壓、電流含量為1%，則傳遞值為 010101à 10101 電壓、電流含量為5%，則傳遞值為 050505à 50505 電壓、電流含量10%，則傳遞值為 101010à101010 以此類

8、推。 pDelay_Time - 控源延時，此參數(shù)為一個結(jié)構(gòu)體（定義在附注中）。 該結(jié)構(gòu)體中含有兩個LongInt類型參數(shù)：l pLngSeatdyTime 為臺體升源穩(wěn)定延時l pLngAdjustTime 為臺體信號源調(diào)整延時2) 三相升源函數(shù)，Dsp型信號源升源函數(shù)DspOutput(pLngAdjust:LongInt; pIntComPort:LongInt; pIntID:LongInt; PhaseWire:LongInt; Frequency:Single; U1:Single; U2:Single; U3:Single; I1:Single; I2:Single; I3:Si

9、ngle; DUAB:Single; DUAC:Single; DU1:Single; DU2:Single; DU3:Single; WaveType:LongInt; Var pDelay_Time:DelayTime):LongInt; Stdcall;export; 函數(shù)相應(yīng)參數(shù)說明： pLngAdjust和pIntComPort兩個參數(shù)跟前面定義內(nèi)容一樣。 pIntID 為參數(shù)保留字，傳遞 1 即可。 phaseWire - 相別 參照OutPutDate_gSub函數(shù)中的pIntPhase參數(shù) 同時，單相Dsp也是用這個函數(shù)輸出，只需要這里的相別 在pIntPhase的基礎(chǔ)上增加兩

10、種，如下：l 8 單相有功l 9 單相無功 Frequency、U1、U2、U3、I1、I2、I3為額定的頻率、電壓和電流值 傳遞類型為單精度Single類型。 DUAB、DUAC 為電壓Uab和電壓Uac直接的夾角。正相序時，夾角為120和240，逆相序時為240和120（以上為平衡輸出時的夾角） DU1、DU2、DU3 為A、B、C三相電壓和電流之間的夾角。 以上各個夾角的數(shù)值范圍為（0359.99）之間。為Single單精度類型 pDelay_Time - 參照OutPutDate_gSub中的相同參數(shù)說明。 WaveType - 輸出的波形類別 參照OutPutData_gSub函數(shù)中

11、的pIntWave參數(shù)。3) 單相Dsp升源函數(shù)。單相Dsp升源函數(shù)同三相的Dsp升源函數(shù)，唯一不同的是升源時，相別phaseWire必須使用單相有功或者無功。具體傳送值在上面三相Dsp升源函數(shù)中做了具體說明。4) 單相LED顯示配3801標(biāo)準(zhǔn)表升源函數(shù)SingleRaiseVA(pIntComPort:LongInt; pSngVoltage:Single; pSngCurrent:Single; pSngFreq:Single; pIntPF:LongInt; pIntIB:LongInt; pSngMaxVoltage:Single; pIntWaveType:LongInt; pInt

12、WaveTimes:LongInt):LongInt;Stdcall;export; 函數(shù)參數(shù)說明： pIntComPort的定義及傳送值跟上面函數(shù)一致。 pSngVoltage、pSngCurrent、pSngFreq為額定電壓、電流和頻率 pIntPF為功率因數(shù)，需要換算，換算方法跟OutPutData_gSub函數(shù) 的pIntLC參數(shù)定義一樣。 pIntIB為電流負(fù)載，使用跟OutPutData_gSub函數(shù)的pIntIB參數(shù)一樣. pSngMaxVoltage - 輸出的最大電壓,根據(jù)標(biāo)準(zhǔn)表3801的不同，分為 220*1.2=264和220*1.3=286兩種。 pIntWaveTy

13、pe - 波形類別，參照上面函數(shù)相同參數(shù)定義。 pIntWaveTimes - 諧波次數(shù)，當(dāng)參數(shù)pIntWaveType為1（正弦波） 時，改參數(shù)為0.2、 信號源暫停函數(shù)1) 三相暫停函數(shù)，早期C型和D型臺體暫停函數(shù)Source_Pause_gSub(pIntComPort:LongInt);stdcall;export; 函數(shù)說明：該函數(shù)使用是，只需要傳遞串口號即可，串口號的傳遞方式 參照上面相同函數(shù)的使用。2) 三相Dsp信號源的暫停函數(shù)由于Dsp信號源使用的Modbus規(guī)約編譯，所以三相Dsp暫停函數(shù)跟Dsp的升源函數(shù)相同，不同的時，暫停時，只需要把升源函數(shù)中的電流賦值為0即可。3)

14、單相Dsp信號源的暫停函數(shù)同2 4) 單相LED配3801標(biāo)準(zhǔn)表的暫停函數(shù) SinglePause(pIntComPort :LongInt; pSngVoltage:Single):LongInt ;stdcall;export; 函數(shù)說明：串口參數(shù)的使用跟上面的相同，只是暫停時，需要輸入?yún)?shù) pSngVoltage為0即可。3、 信號源降源函數(shù)1) 三相暫停函數(shù)，早期C型和D型臺體暫停函數(shù) SourceClear_Fun(pIntComPort:LongInt):LongInt;stdcall;export; 函數(shù)說明：此函數(shù)為降源命令，只需要傳遞一個串口值就行2) 三相Dsp信號源的降源

15、函數(shù)DSP信號源降源命令跟升源命令一樣，只是在降源的時候，三相電壓電流賦值都為0就行。3) 單相Dsp信號源的降源函數(shù)同2）4) 單相LED配3801標(biāo)準(zhǔn)表的暫停函數(shù) SingleClear(pIntComPort :LongInt):LongInt ;stdcall;export; 函數(shù)說明：此函數(shù)為單相普通信號源降源命令，降源是只需要使用 次函數(shù)并傳遞一個串口值就行。4、 臺體8000板(誤差計數(shù)器)控制函數(shù)(附啟潛動測試流程)1) 函數(shù)ErrorOrder_gFun，8000板（誤差計數(shù)器）通訊命令ErrorOrder_gFun(pIntComPort:LongInt; pIntID:L

16、ongInt;pIntAddress:LongInt; pIntTime:LongInt;var pUdtAnswer:Answer):LongInt;Stdcall;export; 函數(shù)說明如下： pIntComPort - 串口，使用跟上面函數(shù)說明一樣。 pIntID - 命令控制字 2 ：讀誤差。 3 ：尋標(biāo)記準(zhǔn)備（啟潛動功能）111 4 ：尋標(biāo)記開始（啟潛動功能）222 5 ：讀取尋標(biāo)記結(jié)果（啟潛動功能） 6 ：尋標(biāo)記結(jié)束（啟潛動功能） 7 ：讀取啟、潛動開門脈沖（啟潛動功能） 8 ：讀取啟、潛動結(jié)果（啟潛動功能） 9 ：8000板狀態(tài)查詢（測試過程基本不使用）10 ：讀取標(biāo)準(zhǔn)表脈沖

17、11 ：8000板上485通道接通 12 ：8000板上485通道斷開13 ：打通第一通道。14 ：打通第二通道。 15 ：打通第三通道 16 ：打通第四通道 17 ：打通第五通道 18 ：打通第六通道 19 ：打通第七通道 20 ：打通第八通道 21 ：光電脈沖輸入22 ：表脈沖輸入28 ：單相電流雙回路，12回路切換29 ：單相電流雙回路，34回路切換30 ：單相電流雙回路，1234回路切換 pIntAddress -誤差計算器序號(即但前表位號) pIntTime - 保留字，默認(rèn)為0 pUdtAnswer - 返回誤差值（結(jié)構(gòu)體），其中參數(shù)StrTimes為當(dāng)前讀取誤差的次數(shù)，StrA

18、nswer為當(dāng)前讀取誤差?？梢詤⒄?附錄1注：由于按照國網(wǎng)增加了雙回路，切換臺體12，34回路的時候，參數(shù)pIntAddress為定值250.函數(shù)返回值為-1是表示成功。啟潛起動過程：尋標(biāo)：先發(fā)，再發(fā)（兩個一起的）發(fā)，讀結(jié)果全部表位尋標(biāo)完成，發(fā)，潛起動開始發(fā)，讀每個表位潛起結(jié)果，所有表結(jié)果，發(fā)，結(jié)束命令不尋標(biāo)：先發(fā)，再發(fā)（兩個一起的），發(fā)，潛起動開始發(fā)，讀每個表位潛起結(jié)果，所有表結(jié)果，發(fā)，結(jié)束命令2) 函數(shù)ErrorCircles_gFun，誤差測試圈數(shù)設(shè)置ErrorCircles_gFun(pIntComPort:LongInt; pIntAddress:LongInt; pIntCircl

19、es:LongInt; pLngPules:LongInt; pSngErrorMax:Single, var pUdtAnswer:Answer; var pUdtPules:Pules):LongInt;Stdcall;export;函數(shù)說明如下： pIntComPort - 串口，使用跟上面函數(shù)說明一樣。 pIntAddress -誤差計算器序號(即但前表位號) pIntCircles - 設(shè)置檢驗誤差圈數(shù) pLngPules - 設(shè)置檢驗理論脈沖數(shù) pSngErrorMax - 最大誤差限 pUdtAnswer - 命令返回值，保留 pUdtPules - 保留，默認(rèn)結(jié)構(gòu)體內(nèi)參數(shù)值都為

20、0或者13) 函數(shù)ErrorPules_gFun，誤差計算器進(jìn)行圈轉(zhuǎn)數(shù)與脈沖數(shù)的比較改命令在目前臺體上的8000板（誤差計算器）中已經(jīng)停止使用。5、 信號源幅值調(diào)整,必須和升源命令配合使用。 Adjust_Fun(pLngSourceType:LongInt; pIntComPort : LongInt):LongInt;Stdcall;export;函數(shù)說明如下： pLngSourceType，pIntComPort 參數(shù)定義使用如上面升源命令中方法一樣，請參照上面說明。 批注：此函數(shù)使用是，必須配合升源函數(shù)一起使用，而且僅僅在升源函數(shù) 在升源過程中不進(jìn)行幅值調(diào)整時才能使用（即升源函數(shù)中的參

21、數(shù)pLngAjust為0時，如果該參數(shù)為1，請不要在升源后再對信號源幅值進(jìn)行調(diào)整）。6、 讀取標(biāo)準(zhǔn)表函數(shù) OperationHC_Fun(pLngSourceType: LongInt; pIntComPort:LongInt; IntHcAddress:LongInt; IntCommandID : LongInt; IntData:LongInt; var pStrData:Standard):LongInt;stdcall;export;函數(shù)說明如下： pLngSourceType，pIntComPort參數(shù)定義使用如上面升源命令中方法一樣，請參照上面說明。 IntHcAddress -

22、 標(biāo)準(zhǔn)表地址，默認(rèn)為55 IntCommandID - 控制命令字 1 ：聯(lián)機（保留字） 2 ：脫機（保留字） 3 ：讀取標(biāo)準(zhǔn)表顯示值 4 ：標(biāo)準(zhǔn)表有功輸出及電流輸出檔位² lIntID = 10 10A檔位² lIntID = 5 5A檔位² lIntID = 1 1A檔位² lIntID = 0 自動檔位 5 ：標(biāo)準(zhǔn)表無功輸出及電流輸出檔位² lIntID = 10 10A檔位² lIntID = 5 5A檔位² lIntID = 1 1A檔位² lIntID = 0 自動檔位 6 ：設(shè)置標(biāo)準(zhǔn)表相線（phase

23、Wire）² lIntID = 1 3p4w(三相四線有功/正弦無功)² lIntID = 2 3p3w(三相三線有功/正弦無功)² lIntID = 3 3p4w(三相四線90度無功)² lIntID = 4 3p3w(三相三線60度無功)² lIntID = 5 3p3w(三相三線90度無功) 7 ：保留字 8 ：保留字 9 ：設(shè)置標(biāo)準(zhǔn)顯示電流檔位² lIntID = 100 100A檔位² lIntID = 10 10A檔位² lIntID = 1 1A檔位 10 ：保留字 pStrData - 讀取標(biāo)準(zhǔn)表返

24、回當(dāng)前測量值（結(jié)構(gòu)體） 具體參數(shù)定義，請參照附錄1.7、 日計時（秒脈沖）控制函數(shù) 由于臺體測試秒脈沖使用的是公司生產(chǎn)的時鐘晶振儀HPU-1012，此儀器測 試時產(chǎn)生的高頻脈沖和臺體上測試誤差產(chǎn)生的高頻脈沖不能通用，所以在 測試日計時（秒脈沖）的時候，先要對臺體高頻信號進(jìn)行切換。相應(yīng)函數(shù)： Procedure Ini_SecPules(pIntComPort:LongInt;pIntID:LongInt);stdcall;export 函數(shù)說明：此函數(shù)沒有返回值。 pIntComPort - 請參照上面函數(shù)相同參數(shù)定義 pIntID - 1 表示切換到秒脈沖測試狀態(tài) 0 表示切換到誤差測試狀態(tài)

25、8、 日計時（秒脈沖）誤差讀取函數(shù) Function Error_SecPules(pIntComPort:LongInt; pIntAddress:LongInt;pSngPules:Single; var pUdtAnswer:Answer):LongInt;Stdcall;export 函數(shù)說明：此函數(shù)返回值一直為-1 pIntComPort- 請參照上面函數(shù)相同參數(shù)定義 pIntAddress - 表地址 pSngPules - 測試過程的理論脈沖數(shù) 例如：時鐘晶振儀脈沖數(shù)為5000000 分頻系數(shù)為100 設(shè)置圈數(shù)為60 此時的理論脈沖數(shù)為（時鐘晶振脈沖數(shù)/分頻系數(shù)） *設(shè)置圈數(shù) 即

26、：(5000000/100)*609、 附錄11) 控源動態(tài)庫中用的結(jié)構(gòu)體定義² 標(biāo)準(zhǔn)表返回值Standard，定義如下：Type Standard = Record RealVA : Single; /A相電壓(V) RealVB: Single; /B相電壓(V) RealVC: Single; /C相電壓(V) RealAA : Single; /A相電流(A) RealAB : Single; /B相電流(A) RealAC : Single; /C相電流(A) RealPFA: Single; /A相功率因數(shù) RealPFB: Single; /B相功率因數(shù) RealPFC

27、: Single; /C相功率因數(shù) RealWA : Single; /A相功率，標(biāo)準(zhǔn)表在有功電能輸出狀態(tài)時為有功率(W)，無功時為無功功率(var) RealWB : Single; /B相功率 RealWC : Single; /C相功率 RealPF : Single; /平均功率因數(shù) RealAngle : Single; /角度 RealFrequency : Single; /頻率(Hz) RealPVA : Single; /總視在功率(VA) RealP : Single; /總視在有功功率(W) RealQ : Single; /總視在無功功率(var)End Type

28、78; 誤差返回值A(chǔ)nswer，定義如下：Type Answer = Record StrAnswer：Single； /返回誤差值。 StrTimes：Single； /返回誤差值的當(dāng)前次數(shù)。End Type² 控源時間 DelayTime,定義如下：Type DelayTime = Record SteadyTime:LongInt; /升源穩(wěn)定時間。 AdjustTime:LongInt; /升源穩(wěn)定后調(diào)整電壓、電流賦值所用時間。End Type² 結(jié)構(gòu)體 Pules，定義如下：Type Pules = Record pIntSourceVersion : LongI

29、nt; pIntConstFactor : LongInt; pIntPulesConst : LongInt; pIntRoundConst : LongInt;end;后續(xù)版本已經(jīng)不使用該結(jié)構(gòu)體，所以使用時傳遞結(jié)構(gòu)體內(nèi)參數(shù)值都賦值為0即可。附注：設(shè)置的諧波問題，我們公司Dsp信號源設(shè)置的時候，需要先進(jìn)行諧波設(shè)置然后再升源。 設(shè)置諧波函數(shù)Function SetDSPHarmonic(pIntComPort: LongInt; pIntID:LongInt; WaveDegree1:single; WaveDegree2:single; WaveDegree3:single; WaveTimes1:LongInt; WaveTimes2:LongInt; WaveTimes3:LongInt; VoltageWaveRa