Instructions to Danfoss Commercial Compressors

Foresee Calculation DLL, version 3.2

Introduction

The Danfoss Commercial Compressors calculation DLL is a small software package which calculates
compressor performance data for Danfoss scroll compressors and Maneurop reciprocating
compressors. The DLL can be considered as a black-box or a subroutine and has to be linked to a
client software application in order to be operational.

What is the DLL ?

The client software application can access the DLL to get compressor performance data at user defined
conditions.
Note: In the rest of this text Danfoss Commercial Compressors is abbreviated to Danfoss CC.

PC with Windows XP or W7, and optional with Excel 2000 to 2010.

VGA monitor with minimum resolution of 1024 x 768 pixels

Features / functionality

Difference between the DLL and a calculation

program

Although the Danfoss CC calculation DLL performs capacity calculations it shall not be confused with
an ordinary calculation program. There are several particularities:
The DLL is not an independent program. It must be linked to a client program for input and output.
The DLL does not have its own user interface.
The DLL does performance calculations but it does not list technical data such as electrical data,
dimensions etc.
The DLL includes the Danfoss CC compressor offering but not condensing units, nor Secop
reciprocating compressors manufactured for Danfoss.
The DLL can calculate performance outside the normal application envelope within certains limits.
The DLL is for experienced users only

Legal aspects

The legal text as printed at the bottom of this document also applies to the DLL itself. In particular we
emphasize the contents of paragraph 4.5 (Return codes) of this document for a correct interpretation
of the calculation results.
The DLL is sent to you on a basis of mutual trust between you and Danfoss. You are not allowed to
transfer the DLL or any of the components shipped together with it to any other third party.
In case you received the DLL from any other party than Danfoss, Danfoss cannot accept responsability
for the calculation results.

Function definitions

Initialises the DLL and specifies the path where the database is located.

Function: DFS_Initialize (FilePath)

Input parameter

File path

Function:
DFS_GetRefrigerant & DFS_GetRefrigerantH

Refrigeration & A/C mode function: DFS_GetRefrigerant (OldRefCode, NewRefCode, NewRefName)

Heating mode function: DFS_GetRefrigerantH (OldRefCode, NewRefCode, NewRefName)
Finds either the first or the next refrigerant in the database.
Input parameter

OldRefCode: 0 or actual Refrigerant code

When OldRefCode = 0; function gives the first available Refrigerant code

When OldRefCode = Refrigerant code; function gives the next available Refrigerant code
Output parameter

NewRefCode: First Refrigerant code or Next Refrigerant code

NewRefName: Refrigerant name corresponding to NewRefCode

FRCC.EI.001.A5.02 Danfoss Commercial Compressors 06/13

Instructions

Function:
DFS_GetFamily & DFS_GetFamilyH

Foresee Calculation DLL version 3.2

Refrigeration & A/C mode function: DFS_GetFamily (OldFamCode, NewFamCode, NewFamName)

Heating mode function: DFS_GetFamilyH (OldFamCode, NewFamCode, NewFamName)
Finds either the first or the next family in the database.
Input parameter

OldFamCode: 0 or actual Family code

When OldFamCode = 0; function gives the first available Family code

When OldFamCode = actual Family code; function gives the next available Family code
Output parameters

NewFamCode: First Family code or Next Family code

NewFamName: Family name corresponding to NewFamCode

Function:
DFS_GetPower & DFS_GetPowerH

Refrigeration & A/C mode function: DFS_GetPower (OldFamCode, NewFamCode, NewFamName)

Heating mode function: DFS_GetPowerH (OldFamCode, NewFamCode, NewFamName)
Finds either the first or the next power in the database.
Input parameter

OldPowCode: 0 or actual Power code

When OldPowCode = 0; function gives the first available Power code

When OldPowCode = actual Power code; function gives the next available Power code
Output parameters

NewPowCode: First Power code or Next Power code

NewPowName: Power name corresponding to NewPowCode

Function:
DFS_GetModel

Function: DFS_GetModel (Key, RefCode, FamCode, PowCode, NewKey, NewModel, AppCode,

Mode)
Finds the first key that matches given Refrigerant, Family and Power, or finds the next key that
corresponds to the old key.
Input parameter

Key: 0 or Key value

When Key = 0; function will use input parameters RefCode, FamCode & PowCode
When Key = Key value; function will ignore input parameters RefCode, FamCode & PowCode
and use the database record corresponding to Key

RefCode: Refrigerant code (see 4.1)

FamCode: Family code (see 4.2)

PowCode: Power code (see 4.3)

AppCode: Application code (see 4.4)

Mode: Application mode in double (1.0 = Refrigeration & A/C, 2.0 = Heating, 3.0 = Both)
Output parameters

NewKey:

When Key = 0; the first key which corresponds to RefCode, FamCode & PowCode
When Key = Key value; the next key which has same values for Refrigerant code, Family code
and Power code as record Key

NewModel: Compressor model name corresponding to NewKey

FRCC.EI.001.A5.02 Danfoss Commercial Compressors 06/13

Instructions

Function:
DFS_GetModelData

Foresee Calculation DLL version 3.2

Function: DFS_GetModelData (Key, FieldName, Value)

Finds the value that matches given Key and Field Name in the database record.
Input parameter

Key: Key value; function use the database record corresponding to Key

FieldName: Field name for example :

Frequency , TeMin , TeMax , TcMin or TcMax

with TeMin, TeMax, TcMin, TcMax are Border line Min-Max (outside this limit, calculations are
made, but with warning).
Output parameters

Value:

the Value which corresponds to Key & FieldName

Function:
DFS_Rating

Function: DFS_Rating (Key, Model, Refrigerant, Frequency, Te, Tc, Sc, Sh1, Sh2, Cap, Pow, Cur,
Mas, Cop, Tdis, Heat, HCop) ReturnCode
Gives compressor performance data corresponding to input conditions.
Input parameters

Key: 0 or key

When Key = 0; Function uses input parameters Model, Refrigerant & Frequency
When Key <> 0; Function uses record corresponding to Key and ignores input parameters
Model, Refrigerant & Frequency. Note: when Key is used but no record corresponding to value
Key can be found, this results in return code 1.

Model: Compressor model name

Refrigerant: Refrigerant name (not the Refrigerant code)

Frequency: Frequency in Hz

Te: Evaporating temperature in C

Tc: Condensing temperature in C

Sc: Subcooling in K

Sh1: Superheat at evaporator outlet in K

Sh2: Superheat at compressor suction inlet in K
Output parameters

Cap: Cooling capacity in W

Pow: Power input in W

Cur: Current consumption in A

Mas: Mass flow in kg/s

Cop: Coefficient of performance in W/W

Tdis: Discharge temperature in C

Heat: Heating capacity in W

HCop: Heating coefficient of performance in W/W
Return parameter

ReturnCode: Error code

FRCC.EI.001.A5.02 Danfoss Commercial Compressors 06/13

Instructions

Function:
DFS_RatingV2

Foresee Calculation DLL version 3.2

Function: RatingV2 (Key, Model, Refrigerant, Frequency, Te, Tc, Sc, Sh1, Sh2, Cap, Pow, Cur, Mas,
Cop, Tdis, Heat, HCop, SIT, IP, PEX, TS, Mi) ReturnCode
Gives compressor performance data corresponding to input conditions.
Input parameters

Key: 0 or key

When Key = 0; Function uses input parameters Model, Refrigerant & Frequency
When Key <> 0; Function uses record corresponding to Key and ignores input parameters
Model, Refrigerant & Frequency. Note: when Key is used but no record corresponding to value
Key can be found, this results in return code 1.

Model: Compressor model name

Refrigerant: Refrigerant name (not the Refrigerant code)

Frequency: Frequency in Hz

Te: Evaporating temperature in C

Tc: Condensing temperature in C

Sc: Subcooling in K

Sh1: Superheat at evaporator outlet in K

Sh2: Superheat at compressor suction inlet in K
Output parameters

Cap: Cooling capacity in W

Pow: Power input in W

Cur: Current consumption in A

Mas: Mass flow in kg/s

Cop: Coefficient of performance in W/W

Tdis: Discharge temperature in C

Heat: Heating capacity in W

HCop: Heating coefficient of performance in W/W

SIT: Intermediate dew temperature in C

IP: Intermediate injection pressure in Pa

PEX: Economizer load in W

TS: Liquid temperature in C

Mi: Injection mass flow in kg/s
Return parameter

ReturnCode: Error code

Argument types and units

Argument

Type

Unit

Argument

Type

Unit

File path

string

Frequency

integer

Hz

Key

integer

Te

double

NewKey

integer

Tc

double

Model

string

Sc

double

NewModel

string

Sh1

double

Refrigerant

string

Sh2

double

RefCode

integer

Cap

double

OldRefCode

integer

Pow

double

NewRefCode

integer

Cur

double

NewRefName

string

Mas

double

kg/s

FamCode

integer

Tdis

double

OldFamCode

integer

Cop

double

W/W

NewFamCode

integer

Heat

double

NewFamName

string

HCop

double

W/W

PowCode

integer

SIT

double

OldPowCode

integer

double

NewPowCode

integer

IP
PEX

double

C
Pa
W

NewPowName

string

TS

double

ReturnCode

integer

Mi

double

kg/s

Mode

double

FielName

string

Value

string

FRCC.EI.001.A5.02 Danfoss Commercial Compressors 06/13

Instructions

Foresee Calculation DLL version 3.2

Code definitions
Refrigerant codes

Family codes

Power codes

Application codes

Refrigerant code

Definition

R22

R404A

R407C

R410A

R134a

Family code

Definition

Hermetic scroll. A/C

Hermetic scroll. Medium temp. refrigeration

Hermetic scroll. Low temp. refrigeration

Hermetic reciprocating. A/C & medium temp. refrigeration

Hermetic reciprocating. Low temp. refrigeration

Hermetic reciprocating variable speed. Medium temp. refrigeration

Hermetic scroll. Variable speed

Hermetic scroll. Heatpump dedicated

Refrigerant code

Definition

208-230V / 1ph / 60Hz (= Danfoss CC motor voltage code 1)

460V / 3ph / 60Hz

200-230V / 3ph / 60Hz (= Danfoss CC motor voltage code 3 & 2)

400V / 3ph / 50Hz (= Danfoss CC motor voltage code 4)

230V / 1ph / 50Hz (= Danfoss CC motor voltage code 4)

230V / 3ph / 50Hz (= Danfoss CC motor voltage code 6)

500V / 3ph / 50Hz (= Danfoss CC motor voltage code 7)

575V / 3ph / 60Hz (= Danfoss CC motor voltage code 7)

380V / 3ph / 60Hz (= Danfoss CC motor voltage code 9)

11

380-480V / 3ph / 50-60 Hz

12

525-600V / 3ph / 50-60 Hz

13

200-240V / 3ph / 50-60 Hz

14

200-220V / 3ph / 50Hz

The application code is used to select either compressors for Refrigeration & A/C or for Heating
applications.
Application code

Definition

All (= all lines from Dfscalc regardless value for Mode)

Cooling (= lines from Dfscalc with Mode = 1 OR Mode = 3)

Heating (= lines from Dfscalc with Mode = 2 OR Mode = 3)

FRCC.EI.001.A5.02 Danfoss Commercial Compressors 06/13

Instructions

Return codes

Foresee Calculation DLL version 3.2

The return code indicates eventual errors or warnings related to the calculation.
Return code

Definition

Calculation OK.

-1

Product / refrigerant / frequency not found.

-2

Evaporating temperature too low.

-3

Evaporating temperature too high.

-4

Condensing temperature too low.

-5

Condensing temperature too high.

-6

Superheat too high.

-7

Subcooling too high.

-8

Negative superheat.

-9

Negative subcooling.

-10

No vapour injection calculation acceptable.

Evaporating temperature too low. Approximative result.

Evaporating temperature too high. Approximative result.

Condensing temperature too low. Approximative result.

Condensing temperature too high. Approximative result.

Cond. temp. or Superheat too high. Approximative result.

10

Superheat at compressor lower than superheat at evaporator.

11

Pressure ratio too low. Approximative result.

15

Te too low, TC too high or Sh too high. Approximative result.

When the return code is 0, this means that the calculation is OK and there are no errors or warnings.
The calculation result can be used as is.
When the return code is negative, this indicates an error. The input is invalid or the input conditions are
too far outside the compressor application envelope. No calculation is made and all output are values
are: 9999.999
When the return code is positive, this indicates a warning. The input conditions are outside the
envelope or represent an unlikely condition. The DLL performs a calculation, but the calculation result
is approximative and for information only. The result of such calculations may be required in following
situations:
To calculate performance at a condition that will appear only during a relatively short period of
time, such as pump down.
To avoid that the client application crashes when making iterative calculations.
To accelerate the client application.
A positive return code shall never be interpreted as an approval from Danfoss CC to operate the
compressor at the corresponding condition. A positive return code means in the first place that
the condition is out of envelope. In such case, the input conditions shall be verified and eventually
corrected until the return code is zero. If there is a need anyhow to operate the compressor at a
condition with positive return code, this shall be done only after consulting the Danfoss CC.
The Selection & Application Guidelines from Danfoss CC shall always be your reference for defining the
application envelope.

FRCC.EI.001.A5.02 Danfoss Commercial Compressors 06/13

Instructions

Foresee Calculation DLL version 3.2

Unit system & unit conversion

The DLL works with units C, K, W, A and kg/s. If the client application works with another unit system
the values shall be converted.

Temperature level (Te, Tc, Tdis)

Evaporating temperature (Te) and Condensing temperature (Tc) must be passed to the functions in C.
When the client application works in F this value shall be converted to C:
5
Tc = x (Tf + 40) - 40
9
Discharge temperature (Tdis) is given by the DLL in C. When the client application works in F the C
value can be converted from C to F:
9
Tf = x (Tc + 40) - 40
5

Temperature difference

Temperature differences such as subcooling (Sc) and superheat (Sh1 & Sh2) must be passed to the
funtions in K. When the client application works in F this value shall be converted to K.
5
dTk = x dTf
9
When the client application would work in C this same value can be used, since temperature difference
in C equals temperature difference in K.
dTk = dTc

Cooling capacity

Cooling capacity is given by the DLL in W. When the client application works in Btu/h the output value
can be converted from W to Btu/h:
Qb =

Qw
0.293

Power input

Power input is given by the DLL in W. Usually no conversion factor is needed.

Current consumption

Current consumption is passed by the DLL in A. Usually no conversion is needed.

Mass flow

Mass flow is given by the DLL in kg/s. When the client application works in lb/s the output value can
be converted from kg/s to lb/s:
Mlb = 2.20462 x Mkg

FRCC.EI.001.A5.02 Danfoss Commercial Compressors 06/13

Instructions

Foresee Calculation DLL version 3.2

Functions declaration : Visual Basic 6 example

Declare function: DFS_INITIALIZE LIB ..\LIB\
DFS_CALC.DLL _

(_
BYVAL STRPATH AS STRING _
) AS LONG

Declare function: DFS_GETREFRIGERANT LIB

..\LIB\DFS_CALC.DLL _

(_
BYVAL ICODE AS LONG, _
BYREF INEWCODE AS LONG, _
BYREF STRNAME AS STRING _
) AS LONG

Declare function: DFS_GETREFRIGERANTH LIB

..\LIB\DFS_CALC.DLL _

(_
BYVAL ICODE AS LONG, _
BYREF INEWCODE AS LONG, _
BYREF STRNAME AS STRING _
) AS LONG

Declare function: DFS_GETFAMILY LIB ..\LIB\

DFS_CALC.DLL _

(_
BYVAL ICODE AS LONG, _
BYREF INEWCODE AS LONG, _
BYREF STRNAME AS STRING _
) AS LONG

Declare function: DFS_GETFAMILYH LIB ..\LIB\

DFS_CALC.DLL _

(_
BYVAL ICODE AS LONG, _
BYREF INEWCODE AS LONG, _
BYREF STRNAME AS STRING _
) AS LONG

Declare function: DFS_GETPOWER LIB ..\LIB\

DFS_CALC.DLL _

(_
BYVAL ICODE AS LONG, _
BYREF INEWCODE AS LONG, _
BYREF STRNAME AS STRING _
) AS LONG

Declare function: DFS_GETPOWERH LIB ..\LIB\

DFS_CALC.DLL _

(_
BYVAL ICODE AS LONG, _
BYREF INEWCODE AS LONG, _
BYREF STRNAME AS STRING _
) AS LONG

Declare function: DFS_GETMODEL LIB ..\LIB\

DFS_CALC.DLL _

(_
BYVAL ICODE AS LONG, _
BYVAL IREFR AS LONG, _
BYVAL IFAM AS LONG, _
BYVAL IPOW AS LONG, _
BYREF INEWCODE AS LONG, _
BYREF STRNAME AS STRING, _
BYVAL MODE AS DOUBLE _
) AS LONG

FRCC.EI.001.A5.02 Danfoss Commercial Compressors 06/13

Instructions

Foresee Calculation DLL version 3.2

Declare function: DFS_GETMODELDATA LIB ..\

LIB\DFS_CALC.DLL _

(_
BYVAL ICODE AS LONG, _
BYVAL STRFIELDNAME AS STRING, _
BYREF STRVALUE AS STRING _
) AS LONG

Declare function: DFS_RATING LIB ..\LIB\DFS_

CALC.DLL _

(_
BYVAL ICODE AS LONG, _
BYVAL STRMODEL AS STRING, _
BYVAL STRREFRIG AS STRING, _
BYVAL IFREQ AS LONG, _
BYVAL TE AS DOUBLE, _
BYVAL TC AS DOUBLE, _
BYVAL SC AS DOUBLE, _
BYVAL SH1 AS DOUBLE, _
BYVAL SH2 AS DOUBLE, _
BYREF COOLINGCAPACITY AS DOUBLE, _
BYREF POWERINPUT AS DOUBLE, _
BYREF CURRENTCONSUMPTION AS DOUBLE, _
BYREF MASSFLOW AS DOUBLE, _
BYREF COP AS DOUBLE, _
BYREF DISTEMP AS DOUBLE, _
BYREF HEAT AS DOUBLE, _
BYREF HCOP AS DOUBLE _
) AS LONG

Declare function: DFS_RATINGV2 LIB ..\LIB\

DFS_CALC.DLL

(_
BYVAL ICODE AS LONG, _
BYVAL STRMODEL AS STRING, _
BYVAL STRREFRIG AS STRING, _
BYVAL IFREQ AS LONG, _
BYVAL TE AS DOUBLE, _
BYVAL TC AS DOUBLE, _
BYVAL SC AS DOUBLE, _
BYVAL SH1 AS DOUBLE, _
BYVAL SH2 AS DOUBLE, _
BYREF COOLINGCAPACITY AS DOUBLE, _
BYREF POWERINPUT AS DOUBLE, _
BYREF CURRENTCONSUMPTION AS DOUBLE, _
BYREF MASSFLOW AS DOUBLE, _
BYREF COP AS DOUBLE, _
BYREF DISTEMP AS DOUBLE, _
BYREF HEAT AS DOUBLE, _
BYREF HCOP AS DOUBLE, _
BYREF DSIT AS DOUBLE, _
BYREF DIP AS DOUBLE, _
BYREF DPEX AS DOUBLE, _
BYREF DTS AS DOUBLE, _
BYREF DMI AS DOUBLE _
) AS LONG

FRCC.EI.001.A5.02 Danfoss Commercial Compressors 06/13

Instructions

Foresee Calculation DLL version 3.2

Example on Visual Basic Application

An example is available on C:\_Foresee\Xls. This file can be used only if you install Foresee on the C drive.
This excel can be use with Excel 2000 to 2010.

List:
Give the list output and use these functions:
DFS_GetModel
DFS_GetRefrigerant
DFS_GetFamily
DFS_GetPower

Init:
Use Excel function for cleaning the list output.

Calculate:
Use the function : DFS_RatingV2

Input data

List output

Output data

Danfoss Commercial Compressors http://cc.danfoss.com

Danfoss can accept no responsibility for possible errors in catalogues, brochures and other printed material. Danfoss reserves the right to alter its products without notice. This also applies to products
already on order provided that such alterations can be made without subsequential changes being necessary in specifications already agreed.
All trademarks in this material are property of the respective companies. Danfoss and the Danfoss logotype are trademarks of Danfoss A/S. All rights reserved.
FRCC.EI.001.A5.02 - June 2013

Copyright Danfoss Commercial Compressors - DSS - 06/13