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
Program Methodology—Special Functions
Siemens Building Technologies, Inc. 1-41
Totalized value (TOTAL)
Unitary pre-APOGEE APOGEE BACnet
Syntax
TOTAL(pt1)
pt1 A point name for which the totalized value is taken.
Use
Allows you to access the totalized value of a point.
Example 1
800 C
801 C THIS LINE COMPARES THE TOTALIZED VALUE OF FAN1
802 C TO DETERMINE IF IT IS GREATER THAN 500.
803 C IF THE CONDITION IS TRUE, FAN1 WILL BE PLACED
804 C INTO ALARM.
805 C
810 IF(TOTAL(FAN1).GT.500.0)THEN ALARM(FAN1)
Example 2
800 C
801 C THIS LINE ASSIGNS THE TOTALIZED VALUE
802 C OF FAN1 TO THE POINT CALLED FANRUN.
803 C
810 FANRUN = TOTAL(FAN1)
Notes
TOTAL must reside in the same field panel as the point on which the
function is being performed.
See also
INITTO
APOGEE PPCL User’s Manual
1-42 Siemens Building Technologies, Inc.
Order of Precedence
The order of precedence is the order in which operators (relational,
logical, mathematical, and special function) are evaluated.
• Operators that have a higher precedence are evaluated before
operators that have a lower precedence.
• If all the operators in the formula have equivalent precedence
levels, then the operators are evaluated from left to right.
The following example illustrates how precedence levels are applied
to mathematical operators.
Example 1
10 - 5 + 2 * 3 = x
This equation is solved as follows:
1. Multiplication has the highest precedence level in this equation.
The first step in evaluating the equation is as follows:
2 * 3 = 6
After the first level of operators has been evaluated, the equation
appears as follows:
10 - 5 + 6 = x
2. Since the remaining operators have the same precedence level,
operators are now evaluated from left to right. The last step in
evaluating the equation is as follows:
10 - 5 = 5
5 + 6 = 11
3. The solution to this equation is 11.
See Table 1-5 for a complete list of precedence levels for PPCL
operators.