GET_CCSI_DATA (deprecated)


DLL: GET_CCSI_DATA







Explanation




GET_CCSI_DATA: Determines the functional values of the fan in a given operating point. Additionally the function determines the technical data concerning the fan including the motor.
 







Relevance




Before GET_CCSI_DATA is executed, the command
SET_XML_PATH_PC (initialization)
GET_PRODUCTS_PC (read out products and measuring ID)
needs to have been.
GET_CCSI_DATA is "ThreadSafe",
in case noise was included in the reading during the initialization with SET_XML_PATH_PC.
This will make it unnecessary to access the collection.







Illustration




Image 1
shows GET_CCSI_DATA as block diagram.

Function GET_CCSI_DATA can only be called up if – during initialization - command SET_XML_PATH_PC/SET_XML_PATH_WS was used to upload data from the collection into working memory (RAM). In case this is with noise, it is no longer necessary to access the collection.

Input is given using the fanDescription variable:
For example:
fanDescription=141548;0;0;1,15;;23;500;0,22222;12000;1200;ebmpapst;5;F;8000;;
 
inputlist
InPut[1] 141548 Product-id mess:
InPut[2] 0 Option: (0=V u. Pfa; 1=V u. Ptot)
InPut[3] 0 Mounting: (always 0)
InPut[4] 1.15 Air density: (kg/m³)
InPut[5] Altitude: (m) [Only required if the air density Rho is not given]
InPut[6] 23 Air temperature: (°C) [Only required if the air density Rho is not given]
InPut[7] 200 Pressure difference (stat/tot): (Pa)
InPut[8] 0.13889 Air volume: (m³/s)
InPut[9] 12000 B = width installation space: (mm)
InPut[10] 1200 H = height installation space: (mm)
InPut[11] ebmpapst rlt=Calculation method by RLT; ebmpapst= Calculation method ebm-papst
InPut[12] 5 speed reserve
InPut[13] U = Voltage: (V) reserved (currently not used)

The buffer variable yields the output of the DLL:
For example:
buffer=2371,96;308,20;0,56;36,38;7,27;103,38;83,32;84,29;78,64;82,90;74,90;75,20;79,80;78,20;72,50;67,20;62,90;55,70;78,10;76,30;79,70;80,90;77,20;76,80;67,30;58,80;504,52;500,00;799,99;83,996;86,335;88,331;36,05;256,78;43,66;43,27;380 .. 480;985;1,6;3260;R3G280AJ14C1;0,080299;50/60;B;IP 54;ERP2015;TOP;;0,8;3;;51,3;400;3~;7.1;7;84;60;-25;27,29;1,39;110,00;4,52;0,00;3389,35;284;
 
outputlist
pos. 1; 1499.0 (n [1/min] fanSpeed at duty point)
pos. 2; 93.690 (Pe Ped [W] motor input power at duty point) (Pe= AC motor, Ped=EC motor VSD)
pos. 3; 0.1700 (I [A]) electric current at duty point
pos. 4; 29.910 (eta_e, eta_ed [%]) total efficiency, overall efficiency at duty point (eta_e=AC motor, eta_ed=EC motor VSD)
pos. 5; 4.6000 (U control [V] control voltage at duty point)
pos. 6; 41.110 (M [Ncm] motor shaft torque at duty point)
pos. 7; 68.880 (?m [%] motor efficiency at duty point)
pos. 8; 73.550 (LwA(A, in+out) [dB(A)] sound power A weighted at duty point)
pos. 9; 67.890 (LwA(A,in) [dB(A)] sound power A weighted inlet at duty point)
pos. 10; 72.170 (LwA(A,out) [dB(A)] sound power A weighted outlet at duty point)
pos. 11; 66.800 (Lw_62.5_Hz (in) [dB] unweighted sound power, octave band 62,5Hz inlet at duty point)
pos. 12; 66.800 (Lw_125__Hz (in) [dB] unweighted sound power, octave band 125 Hz inlet at duty point)
pos. 13; 69.000 (Lw_250__Hz (in) [dB] unweighted sound power, octave band 250 Hz inlet at duty point)
pos. 14; 67.500 (Lw_500__Hz (in) [dB] unweighted sound power, octave band 500 Hz inlet at duty point)
pos. 15; 62.000 (Lw_1000_Hz (in) [dB] unweighted sound power, octave band 1000Hz inlet at duty point)
pos. 16; 56.200 (Lw_2000_Hz (in) [dB] unweighted sound power, octave band 2000Hz inlet at duty point)
pos. 17; 50.200 (Lw_4000_Hz (in) [dB] unweighted sound power, octave band 4000Hz inlet at duty point)
pos. 18; 40.000 (Lw_8000_Hz (in) [dB] unweighted sound power, octave band 8000Hz inlet at duty point)
pos. 19; 69.900 (Lw_62.5_Hz (out) [dB] unweighted sound power, octave band 62,5Hz outlet at duty point)
pos. 20; 67.800 (Lw_125__Hz (out) [dB] unweighted sound power, octave band 125 Hz outlet at duty point)
pos. 21; 69.000 (Lw_250__Hz (out) [dB] unweighted sound power, octave band 250 Hz outlet at duty point)
pos. 22; 70.200 (Lw_500__Hz (out) [dB] unweighted sound power, octave band 500 Hz outlet at duty point)
pos. 23; 66.800 (Lw_1000_Hz (out) [dB] unweighted sound power, octave band 1000Hz outlet at duty point)
pos. 24; 65.900 (Lw_2000_Hz (out) [dB] unweighted sound power, octave band 2000Hz outlet at duty point)
pos. 25; 54.600 (Lw_4000_Hz (out) [dB] unweighted sound power, octave band 4000Hz outlet at duty point)
pos. 26; 43.100 (Lw_8000_Hz (out) [dB] unweighted sound power, octave band 8000Hz outlet at duty point)
pos. 27; 201.77 (pf [Pa] fan total pressure increase at duty point)
pos. 28; 200.00 (pfs[Pa]) fan static pressure increase at duty point)
pos. 29; 500.000 (qv [m³/h] air flow at duty point)
pos. 30; 74.024 (Lw(in) [dB] unweighted sound power sum level inlet at duty point)
pos. 31; 76.355 (Lw(aout) [dB] unweighted sound power sum level outlet at duty point)
pos. 32; 78.3540 (Lw(in+out) [dB] unweighted sound power sum level inlet+outlet at duty point)
pos. 33; 29.650 (eta_es,eta_esd [%] overall static efficiency at duty point) (eta_es=AC motor, ??sd=EC motor VSD)
pos. 34; 64.540 (Po [W] motor output power at duty point)
pos. 35; 43.4200 (?r [%] fan impeller efficiency at duty point)
pos. 36; 43.0400 (?sr [%] fan impeller static efficiency at duty point)
pos. 37: 380 .. 480 (voltage Range: [V] nominal data)
pos. 38: 985 (Pe, Ped Power input: [W]) nominal data ((Pe=AC motor, Ped=EC motor VSD)
pos. 39: 1.6 (I Current draw: [A]) nominal data
pos. 40: 3260 (n nominal data fan speed [1/min] nominal data)
pos. 41: R3G280AJ14C1 (Type)
pos. 42: 0.080299 (Discharge area: [m²])
pos. 43: 50/60 (Frequency: [Hz] nominal data)
pos. 44: B (Insulation class)
pos. 45: IP 54 (Protection class)
pos. 46: ERP2015 (ErP class)
pos. 47: TOP (Motor protection, thermal winding protection)
pos. 48: (Humidity class)
pos. 49: 0.8 (cosf nominal data)
pos. 50: 3 (Motor pole)
pos. 51: (Motor wiring; S=star, D=delta connection )
pos. 52: 51.3 (eta_e Overall efficiency ERP)
pos. 53: 400 (U voltage: [V] nominal data)
pos. 54: 3~ (Motor phase, number of phases)
pos. 55: 7.1 (Fan weight (mass) in [kg])
pos. 56: 7 (number of fan impeller blades)
pos. 57: 84 (Motor frame size [mm])
pos. 58: 60 (Max. ambient temperature [°C])
pos. 59: -25 (Min. ambient temperature [°C])
pos. 60; 54.04 (safety factor rpm [%])
pos. 61; 0.67 (specific fan power [kW/(m³/s)])
pos. 62; 42.00 (pressure inlet nozzle [Pa] (rough estimate))
pos. 63; 1.77 (pd [Pa])
pos. 64; 0.00 (Pressure loss with respect to installation space [Pa])
pos. 65; 3389.35 (max. air volume flow [m³/h]])
pos. 66; 284 ([average] mean impeller diameter [mm])

ErrorCode:= 0 AP is below the fan curve and the intersection is present
ErrorCode:= -1 No valid fanReference (MessID) was passed
ErrorCode:= -2 AP is outside of the fan curve
ErrorCode:= -3; Found no point of intersection
ErrorCode:= -5; The installation space is too small! (Width_of_box_housing(mm);height_of_box_housing(mm))
Minimum separation distance between left right outside diameter and housing is too small
ErrorCode:= -6; The required reserve in relation to the nominal speed is not reached
ErrorCode:= -7; Theoretically possible but outside the recommended range. (Applies only to axial fans)



Image 2
shows how the function "GET_CCSI_DATA can be executed with the FanScout in the "DLL" tab.
1. On pressing the button "GET_CCSI_DATA, this command is transferred from the FanScout to the DLL and executed by the DLL. The FanScout transfers the input data entered in the Input area (2+3). In this process the data are combined in a transfer string (fanDescription). The individual values are separated by a semicolon.

2. Input values required for conversion to an operating point.

3. Optional input values required for conversion to an operating point.

4. Input list: The input values are listed again here, in particular their order in the transfer string

5. Output of syntax as transferred to the DLL, e.g.: ErrorCode = GET_CCSI_DATA(fanDescription,buffer)

fanDescription=141548;0;0;1,15;;23;500;0,22222;12000;1200;ebmpapst;5;F;8000;;

buffer=2371,96;308,20;0,56;36,38;7,27;103,38;83,32;84,29;78,64;82,90;74,90;75,20;79,80;78,20;72,50;67,20;62,90;55,70;78,10;76,30;79,70;80,90;77,20;76,80;67,30;58,80;504,52;500,00;799,99;83,996;86,335;88,331;36,05;256,78;43,66;43,27;380 .. 480;985;1,6;3260;R3G280AJ14C1;0,080299;50/60;B;IP 54;ERP2015;TOP;;0,8;3;;51,3;400;3~;7.1;7;84;60;-25;27,29;1,39;110,00;4,52;0,00;3389,35;284;

6. Error code: Result=0 (execution without error)

7. This window describes how GET_CCSI_Data can be incorporated with different programming languages. (input, output, error code, specimen code...) See below number

8. Fan data and motor data as return values from the DLL

9. Fan data and motor data at the operating point as return values from the DLL

10. ocatave band at operating point as return values from the DLL

11. Output list: The output values are listed again here, in particular their order in the return string as supplied by the DLL.

12. Number of results as itemized list and JSON
 

7. Using the function in the following programming languages Delphi, C#, C++, VB.NET, VB6
-----------------------------------------------------------------------
1. Delphi:
Integrating the function: function GET_CCSI_DATA(fanDescription: PAnsiChar; var buffer: PAnsiChar): LongInt; stdcall; external EbmPapstFanDLL;
Declare variables: var n:LongInt; fanDescription,buffer: PAnsiChar;
GetMem(buffer, 4000);
Call: n := GET_CCSI_DATA(fanDescription,buffer);
show_Results_GET_CCSI_DATA(n,buffer);
FreeMem(buffer);
-----------------------------------------------------------------------
2. C#:
Integrating the function: [DllImport(@"EbmPapstFan.dll", CallingConvention = CallingConvention.StdCall, CharSet = CharSet.Ansi)]
public static extern int GET_CCSI_DATA([MarshalAsAttribute(UnmanagedType.AnsiBStr)]string fanDescription, ref string buffer);
Declare variables: int errCodeFanAlone = 9; System.String stringInputDataIntern = Convert.ToString(sbInputDataIntern); string buffer = new string(new Char(), 4000);
Call: errCodeFanAlone = GET_CCSI_DATA(stringInputDataIntern, ref buffer);
-----------------------------------------------------------------------
3. C++:
Integrating the function: [DllImport("EbmPapstFan.dll", CallingConvention = CallingConvention::StdCall, CharSet = CharSet::Ansi)]
static int GET_CCSI_DATA([MarshalAs(UnmanagedType::AnsiBStr)]String^ fanDescription, String^% buffer);
Declare variables: int errCodeFanAlone = 99; String^ stringInputDataIntern = gcnew String(sbInputDataIntern->ToString()); String^ buffer = gcnew String('0', 4000);
Call: errCodeFanAlone = GET_CCSI_DATA(stringInputDataIntern, buffer);
-----------------------------------------------------------------------
4. VB.net:
Integrating the function: <System.Runtime.InteropServices.DllImport("EbmPapstFan.dll", CallingConvention:=CallingConvention.StdCall, CharSet:=CharSet.Ansi)>
Public Shared Function GET_CCSI_DATA(<MarshalAs(UnmanagedType.AnsiBStr)> fanDescription As String, ByRef buffer As String) As Integer End Function
Declare variables: Dim errCodeFanAlone As Integer = 99 Dim stringInputDataIntern As System.String = Convert.ToString(sbInputDataIntern) Dim buffer As String = New String(New Char(), 4000)
Call: errCodeFanAlone = GET_CCSI_DATA(stringInputDataIntern, buffer))
-----------------------------------------------------------------------
5. VB6:
Integrating the function: Private Declare Function GET_CCSI_DATA Lib "D:\VB6\ebmpapstfan.dll" (ByVal path As String, ByRef sRet As String) As Long
Declare variables: Dim Int_Antwort As Long, sRet As String, Str_Input As String
sRet = String(2000, 32)
Call: Int_Antwort = GET_CCSI_DATA(Str_Input, sRet)







Document links