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—Local Variables
Siemens Building Technologies, Inc. 1-63
$LOC1 through $LOC15
Unitary pre-APOGEE APOGEE BACnet
Syntax
$LOCn
n The number that describes what $LOCn point is referenced.
• Valid values are 1 through 15.
Use
These points are used to store the results of calculations.
• $LOCn variables can store an analog or digital value.
• $LOCn variables can be used throughout the program.
• The maximum value a $LOC point can store is 32767.
— If you need to store higher values, use a virtual LPACI or
LAO point.
— If you are using APOGEE firmware, you might consider
creating a local variable by using a LOCAL statement.
Example 1
200 MIN ($LOC1,PT1,PT2,PT3)
Example 2
100 $LOC7 = (50/VALUE1+10.0) * 2.0
Notes
Local points in APOGEE field panels can store values greater than
32,767 (up to 10,000,000).
See also
LOCAL
APOGEE PPCL User’s Manual
1-64 Siemens Building Technologies, Inc.
Point Priority Overview
APOGEE and pre-APOGEE firmware use a point priority to identify
the level at which a point is commanded. Point priority also
determines if an operator or a particular control program is
responsible for controlling a point.
BACnet firmware uses a priority array to perform the same function
as the APOGEE point priority. For BACnet firmware, the priority is
mapped to one of 16 slots defined using the Command Priority
Table. Only one slot in the Priority Array is set for the point when
commanding points with the @priority operator. The value of the
point is set based on the highest slot in the Priority Array.
NOTE: Unitary firmware does not support the use of priority
indicators and manual priority modifications.
APOGEE and pre-APOGEE Point Priority Levels
APOGEE and pre-APOGEE Firmware Revisions 12.5/1.5 and
12.51/1.51 support the following priority levels:
• OPER (Operator, highest priority level)
• SMOKE (Smoke control)
• EMER (Emergency)
• PDL (Peak Demand Limiting)
• NONE (PPCL priority, lowest priority level)
A point can only be commanded by an operation with an equal or
higher priority. For example, a point in EMER priority can be
commanded by an operation with OPER, SMOKE, or EMER priority.
Table 1-5 describes the five APOGEE and pre-APOGEE point
priorities in PPCL, listed from highest to lowest priority.