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-107
Example
500 C
502 C TABLE COMMAND INFORMATION:
504 C
506 C OATEMP (X) HWSP (Y)
508 C ---------- ----------
510 C 0 DEG F 180 DEG F
512 C 60 DEG F 100 DEG F
514 C
520 TABLE(OATEMP,HWSP,0,180,60,100)
The hot water setpoint will remain at 180°F when the outside
temperature is below 0°F. The hot water setpoint will remain at 100°
F when the outside temperature is above 60°F.
Notes
TABLE statements can be cascaded by overlapping x-y pairs using
virtual points.
Do not use resident points in either the SET or the TABLE
command. With both the SET and TABLE commands, the following
should be used for resident points:
Virtual point = Resident point
APOGEE PPCL User’s Manual
3-108 Siemens Building Technologies, Inc.
TIMAVG (Average over time)
Unitary pre-APOGEE APOGEE BACnet
Syntax
TIMAVG(result,st,samples,input)
result A point name used to store the result of the average value.
• This parameter can be a point name or a local
variable.
st Sample time. This is the time, in seconds, between each
sample.
• This parameter can be an integer, a point name, or a
local variable.
samples Number of samples to be used to calculate the average.
• This must be an integer between 1 and 10.
input Point name whose average value is to be calculated.
• This parameter can be an LAI or LAO point or a local
variable.
Use
This command is used to find an average value over time. You
decide how often the values should be taken (sample time) and the
number of values to be taken.
The average is always over the most recent sample count and all
previous values are discarded.
Example
In the following statement, RMAVG would change every 600
seconds (assuming RMTEMP is changing frequently). The average
value (RMAVG) will also be updated every sample time.