Unitary | Pre-APOGEE | APOGEE | BACnet | PXC.A |
---|---|---|---|---|
● | ● | ● |
Syntax
ADAPTM(pv,cv,sp,matctl,mam,st,kc,tcd,tch,tcc,her,dbr,der,err)
pv | Point name of the process variable being controlled. This parameter is usually an LAI point, but it can be an LAO point or a local variable that represents supply air temperature. This value should be between -50.0 and 150.0. |
cv | Controlled variable (output signal). This signal is 0.0 to 100.0 percent, direct acting, and is intended to go to TABLE statements–one for each output actuator point (for example, heating, dampers and cooling). - This parameter can be a point name or local variable. |
sp | Setpoint for the loop against which the process variable is compared. - This parameter can be a point name, local variable name, or decimal number. - This value must be between -50.0 and 150.0, and should be in the same engineering units as pv. |
matcl | Represents the output of the mixed air temperature control loop (usually an ADAPTS loop). When the value of matctl is equal to or drops below the value of mam, the cv output will not rise above the her value. - This parameter can be a point name, local variable name, or decimal number. - This value must be between 0.0 and 100.0. - For applications without dampers or without mixed air temperature override of the dampers, set matctl to 100.0. |
mam | Mixed air damper minimum position. - This parameter can be a point name, local variable name, or decimal number. - This value must be between 0.0 and 100.0. For applications without dampers (heating and cooling only), set mam to 0.0. |
st | Sample time (in seconds). This is the time, in seconds, between two successive starts of execution of the ADAPTM algorithm. It is also the time interval between two samples of data by ADAPTM. - This parameter can be an integer, point name, or local variable name. - The minimum sample time allowed is 1 second. - For a system with smaller size coils, typically set st to 5 seconds. - For a system with larger size coils, typically set st to 10 seconds. - The Sample Time must be less than or equal to one-third of the smallest Time Constant. That is, Where: st is the Sample Time, and tc is the smallest of tcd, tch, and tcc. |
kc | Control gain. - This parameter can be a point name, local variable name, or decimal number. - This value must be greater than 0.0. - For English units set kc to 3.0. For SI Units set kc to 6.0. |
tcd | Damper time constant (in seconds). - This parameter can be a point name, local variable name, or decimal number. - This value must be greater than or equal to 3 times the st value. - For applications with heating and cooling only (no dampers), set tcd to the value of tcc. The damper time constant is, itself, very small in value–typically equal to that of the supply air temperature sensor and the damper actuator stroke time. However, since the air from the dampers must go through the coil(s) before reaching the supply air temperature sensor, the coil(s) time constant(s) (minus their actuator times and the supply air temperature sensor's time constant) must be added to the damper time constant. The ADAPTM damper time constant parameter entry (in seconds) is calculated using this formula: [image here ???] Where: tcd = ADAPTM damper time constant parameter entry (in seconds) T downstream coils = time constants of coils alone downstream of dampers (between the dampers and the duct temperature sensor). T sensor = time constant of the supply air sensor (usually about 30 seconds) T damper actuator = stroke time of the damper actuator (often 30 seconds) |
tch | Heating time constant (seconds). - This parameter can be a point name, local variable name, or decimal number. - This value must be greater than or equal to 3 times the st value. - For applications with dampers and cooling only (no heating), set tch to the value of tcd. The time constant of the heating coil alone is calculated using the following formula: Where: CFMmax = Maximum or design airflow rate in cubic feet per minute GPMmax = Maximum or design hot water flow rate in gallons per minute l/s air max = Maximum or design air flow rate in liters per second l/s hot water max = Maximum or design hot water flow rate in liters per second The ADAPTM heating time constant parameter entry (in seconds) is calculated using this formula: Where: tch = ADAPTM heating time constant parameter (in seconds). T downstream coils = time constants of other coils alone downstream of heating coil (between heating coil and duct temperature sensor). T sensor = time constant of the supply air sensor (usually about 30 seconds). T hc actuator = stroke time of the heating coil actuator (often 30 seconds). |
tcc | Cooling time constant (in seconds). - This parameter can be a point name, local variable name, or decimal number. - This value must be greater than or equal to 3 times the st value. - For applications with heating and dampers only (no cooling coil), set tcc to the value of tcd. The time constant of the cooling coil alone is calculated using the following formula: Where: CFMmax = Maximum or design airflow rate in cubic feet per minute GPMmax = Maximum or design chilled water flow rate in gallons per minute L/s air max = Maximum or design air flow rate in liters per second L/s chilled water max = Maximum or design chilled water flow rate in liters per second The ADAPTM cooling time constant parameter entry (in seconds) is calculated using this formula: Where: tcc = ADAPTM cooling time constant parameter (in seconds) Tdownstream coils = time constants of coils alone downstream of cooling coil (between cooling coil and duct temperature sensor) Tsensor = time constant of the supply air sensor (often 30 seconds) tcc actuator = stroke time of the cooling coil actuator (often 30 seconds) |
her | Heating end of range (in percent). This parameter tells ADAPTM what percentage of its output is used for heating. It is assumed that the beginning of the heating range is at 0%. - This parameter can be a point name, local variable name, or decimal number. - This value must be: - Equal to or greater than 0, and - Less than or equal to dbr. - For applications with dampers and cooling only (no heating), set her to 0. The following figure shows the relationship of her to the operation of the heating, dampers and cooling outputs. Typically, the value for her will be the same as the second to the last parameter for the TABLE statement controlling the heating coil. For example, as shown in the line of code below, this value is 45.
If the value of her varies slightly due to the path taken in the code, choose a nominal value for her. ADAPTM can handle minor variations in the value of her. |
dbr | Damper beginning of range. This parameter, along with the Damper End of Range (der), tells ADAPTM what percentage of its output is used for mixed air damper control (free cooling). - This parameter can be a point name, local variable name, or decimal number. - This value must be: - Greater than or equal to her, and - Less than der. - For applications with heating and cooling only (no dampers), set dbr to the value of der. - For applications with dampers and cooling only (no heating), set dbr to 0. The following figure shows the relationship of dbr to the operation of the heating, dampers and cooling outputs. Typically, the value for dbr will be the same as the third parameter for the TABLE statement controlling the mixed air damper. For example, as shown below in the line of code below, this value is 50.
If other PPCL code is used, dbr must still be the value of the output of ADAPTM at which mixed air dampers begin to open from minimum position. If the value of dbr varies slightly due to the path taken in the code, choose a nominal value for dbr. ADAPTM can handle minor variations in the value of dbr. |
der | Damper end of range. This parameter, along with the Damper Beginning of Range (dbr), tells ADAPTM what percentage of its output is used for mixed air damper control (free cooling). Damper End of Range also tells ADAPTM what percentage of its output is used for cooling since der defines the beginning of the cooling coil range. - This parameter can be a point name, local variable name, or decimal number. - This value must be: - Greater than or equal to dbr, and - Less than or equal to 100. - For applications with heating and dampers only (no cooling), set der to 100. - For applications with heating and cooling only (no dampers), set der to the value of dbr. - The end of the cooling range is assumed to be at the adaptive control output of 100%. The following figure shows the relationship of der to the operation of the heating, dampers (for cooling), and cooling coil outputs. Typically, the value for der will be the same as the third parameter for the TABLE statement controlling the cooling coil. If there are two cooling coil TABLE statements because there is an Economizer, choose the one for Economizer ON. For example, as shown in the line of code below, this value is 65.
If other PPCL code is used, der must still be the value of the output of ADAPTM at which mixed air dampers are fully open and the cooling coil valve is just beginning to open. If the value of der varies slightly due to the path taken in the code, choose a nominal value for der. ADAPTM can handle minor variations in the value of der. |
err | Error reporting point. ADAPTM writes to this point. A zero means no error. A non-zero means an error. - This parameter is entered as a point name or local variable name. |
Do not share one error point among multiple ADAPTM lines.
ADAPTM Example
The following example also includes an ADAPTS command for mixed air temperature.
2000 C ADAPTM CONTROL STATISTICS (LOGICAL
2002 C FIRMWARE)
2004 C DIRECT CONTROL LOOP
2006 C INPUT = %X%SAT
2008 C OUTPUT = %X%VRT
2010 C SETPOINT = %X%SAS
2012 C MA TEMP CNTRL OUTPUT = $MATCTL
2014 C MA MIN POSITION = %X%MAM
2016 C SAMPLE TIME = 5 SECONDS
2018 C GAIN = %X%KC1
2020 C DAMPER TIME CONSTANT = %X%TD1
2022 C HEATING TIME CONSTANT = %X%TH1
2024 C COOLING TIME CONSTANT = %X%TC1
2026 C HEATING END OF RANGE = 45.0
2028 C DAMPER BEGIN RANGE = 50.0
2030 C DAMPER END OF RANGE = 65.0
2032 C ERROR REPORT POINT = %X%ERR
2034 ADAPTM(%X%SAT,%X%VRT,%X%SAS,$MATCTL,
%X%MAM,5,%X%KC1,%X%TD1,%X%TH1,%X%TC1,
45.0,50.0,65.0,%X%ER1)
2036 C HEATING COIL SIGNAL
2038 TABLE (%X%VRT,%X%HCO,0,100,45,0)
2040 C DAMPER RAMP
2042 TABLE ($MADRMP,$MADRCT,0,0,10,%X%MAM, 180,100)
2044 C DAMPER CONTROL SIGNAL
2046 TABLE (%X%VRT,$MADCTL,50,%X%MAM,65,100)
2048 C MIXED AIR TEMPERATURE CONTROL LOOP
2050 IF($MADRCT.LT.$MATCTL) THEN GOTO 2056
2052 ADAPTS(%X%MAT,$MATCTL,%X%MLS,10,%X%KC2,
%X%TM2,0,30.0,130.0,0.0,100.0,0.0,0.0,%X%ER2)
2054 C ECONOMIZER CONTROL
2056 IF (%X%ECM .EQ. OFF) THEN GOTO 2072
2058 C COOLING COIL SIGNAL (ECON=ON)
2060 TABLE (%X%VRT,%X%CCO,65,0,100,100)
2062 C FINAL DAMPER SIGNAL
2064 MIN (%X%MAO,$MADRCT,$MADCTL,$MATCTL)
2068 GOTO 2074
2070 C COOLING COIL SIGNAL (ECON=OFF)
2072 TABLE (%X%VRT,%X%CCO,55,0,100,100)
2074
Use
This statement is no longer supported in PXC.A devices. The PXC.A PPCL runtime will consider this statement invalid, and no replacements have been provided.
Adaptive control technology is a closed loop control application, which automatically adjusts the automation station operating parameters to compensate for changes that continuously occur during the normal building control process. With adaptive control technology, tuning and retuning are not required.
Either the ADAPTM or ADAPTS control statement can be implemented as a one-line replacement for an existing LOOP statement in PPCL.
ADAPTM is specifically designed for supply air temperature control in which two or three output devices are controlled in sequence without overlap.
The output of ADAPTM is direct acting–it rises in value as the process variable rises. To control multiple outputs, ADAPTM must be connected to TABLE statements with parameters set such that the mixed air damper output and the cooling coil output have direct action, and the heating coil output has reverse action.
To be able to control, adaptive control requires that the loop be:
- Controllable–this means that the sensor is in the right range and the output is sufficient to bring the process variable to setpoint.
- Open-loop Stable–this means that the process can achieve a steady state for every position of the final output device. (All AHU loops are open-loop stable.)
- Direct or Reverse Acting–this means the process is either always direct or always reverse acting. That is, the process does not change its action (direction or sign) within the control range.
- Modulating–this refers to the loop’s output device, such as a cooling coil with a modulating water valve. For example, DX cooling or step controlled electric heat, cannot be controlled by the ADAPTM or ADAPTS statements in PPCL.
- Not Excessive in Dead Time–this means that the total delay in the sensor and actuator signals should not exceed two times the time constant of the process.
NOTE:
The Soft Controller does not support adaptive control technology.