User Guide
Table Of Contents
- Table of Contents
- How to Use This Manual
- Chapter 1–Program Methodology
- Overview
- Introduction to PPCL
- PPCL Rules
- PPCL Program Design Guidelines
- Relational Operators
- Logical Operators
- Arithmetic Operators
- Arithmetic Functions
- Special Functions
- Order of Precedence
- Resident Points
- Local Variables
- Point Priority Overview
- At (@) Priority Status Indicators
- Point Status Indicators
- Converting a Sequence of Operation intoProgram Code
- Chapter 2–Control OptionComparisons
- Chapter 3–Command Syntax
- Overview
- ACT (Activate lines)
- ADAPTM (Adaptive control, multiple)
- ADAPTS (Adaptive control, single)
- ALARM (Alarm state)
- AUTO (Auto status)
- DAY (Day mode)
- DBSWIT (Dead band switch)
- DC (Duty cycle)
- DCR (Duty cycle routine)
- DEACT (Deactivate lines)
- DEFINE (Define abbreviation)
- DISABL (Disable lines)
- DISALM (Disable alarm)
- DISCOV (Disable COV)
- DPHONE (Disable phone)
- EMAUTO (Emergency, Auto status)
- EMFAST (Emergency, Fast status)
- EMOFF (Emergency, Off status)
- EMON (Emergency, On status)
- EMSET (Emergency, set value)
- EMSLOW (Emergency, Slow status)
- ENABLE (Enable lines)
- ENALM (Enable alarm)
- ENCOV (Enable COV)
- EPHONE (Enable phone)
- FAST (Fast status)
- GOSUB (Go to subroutine)
- GOTO (Go to line)
- HLIMIT (High limit)
- HOLIDA (Holiday)
- IF/THEN and IF/THEN/ELSE (Conditional control)
- INITTO (Initialize totalized value)
- LLIMIT (Low limit)
- LOCAL (Local variable)
- LOOP (Loop control)
- MAX (Maximum value)
- MIN (Minimum value)
- NIGHT (Night mode)
- NORMAL (Normal operating mode)
- OFF (Off status)
- OIP (Operator interface program)
- ON (On status)
- ONPWRT (On after power return)
- PDL (Peak demand limiting)
- PDLDAT (PDL, define load attributes)
- PDLDPG (PDL, digital point group)
- PDLMTR (PDL, meter monitor)
- PDLSET (PDL, setpoints)
- RELEAS (Release)
- RETURN (Return/end subroutine)
- SAMPLE (Sample a statement)
- SET (Set point value)
- SLOW (Slow status)
- SSTO (Start/stop time optimization)
- SSTOCO (SSTO coefficients)
- STATE (State text command)
- TABLE (Table of coordinates)
- TIMAVG (Average over time)
- TOD (Time of day, digital points)
- TODMOD (TOD modes)
- TODSET (Time of day, analog points)
- WAIT (Wait time)
- Overview
- Glossary
- Appendix A—PPCL Reserved WordList
- Index
Command Syntax
Siemens Building Technologies, Inc. 3-5
ADAPTM (Adaptive control, multiple)
Unitary pre-APOGEE APOGEE BACnet
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.
matctl 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.
APOGEE PPCL User’s Manual
3-6 Siemens Building Technologies, Inc.
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,
c
Tst
3
1
≤
Where:
st is the Sample Time, and
T
c
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.