User Guide

Siemens Building Technologies, Inc. I
Table of Contents
How to Use This Manual.......................................................................VII
Introduction.......................................................................................VII
Manual Organization .......................................................................VIII
Manual Conventions..........................................................................IX
Syntax Page Example ........................................................................X
Compatibility bar .........................................................................XI
Syntax ........................................................................................XII
Use.............................................................................................XII
Notes (if applicable) ..................................................................XIII
See also (if applicable)..............................................................XIII
Where To Send Comments.............................................................XIII
Chapter 1–Program Methodology ......................................................1-1
Overview..........................................................................................1-1
Introduction to PPCL .......................................................................1-3
PPCL Rules .....................................................................................1-4
General PPCL Rules.................................................................1-4
Defining Points in a PPCL Program..........................................1-6
Rules for Naming Points ...........................................................1-6
Rules for Naming a PPCL Program..........................................1-7
PPCL Program Design Guidelines..................................................1-8
Designing a Program that is Easy to Maintain..........................1-8
Designing a Program that Operates Efficiently.........................1-9
Relational Operators......................................................................1-10
Equal to (.EQ.) .......................................................................1-11
Greater than or equal to (.GE.) ...............................................1-12
Greater than (.GT.)..................................................................1-13
Less than or equal to (.LE.).....................................................1-14
Less than (.LT.).......................................................................1-15
Not equal to (.NE.) ..................................................................1-16
Logical Operators ..........................................................................1-17
And (.AND.).............................................................................1-18
Not And (.NAND.)....................................................................1-19
Or (.OR.) .................................................................................1-20
Exclusive Or (.XOR.)...............................................................1-21
Arithmetic Operators......................................................................1-22
Addition ...................................................................................1-23
Assignment .............................................................................1-24
Division....................................................................................1-25
APOGEE PPCL User’s Manual
II Siemens Building Technologies, Inc.
Multiplication ...........................................................................1-26
Subtraction..............................................................................1-27
Arithmetic Functions......................................................................1-28
Arc-Tangent (ATN)..................................................................1-29
Complement (COM)................................................................1-30
Cosine (COS)..........................................................................1-31
Natural Antilog (EXP)..............................................................1-32
Natural Log (LOG)...................................................................1-33
Root (.ROOT.).........................................................................1-34
Sine (SIN)................................................................................1-35
Square Root (SQRT)...............................................................1-36
Tangent (TAN) ........................................................................1-37
Special Functions ..........................................................................1-38
Alarm priority (ALMPRI) ..........................................................1-39
Totalized value (TOTAL).........................................................1-41
Order of Precedence .....................................................................1-42
Changing Precedence Levels with Parentheses....................1-43
Resident Points..............................................................................1-46
Alarm count (ALMCNT)...........................................................1-47
Alarm count 2 (ALMCT2) ........................................................1-48
Battery condition ($BATT).......................................................1-49
Decimal time (CRTIME) ..........................................................1-50
Day (DAY) ...............................................................................1-51
Day of the month (DAYOFM)..................................................1-52
Communications link (LINK) ...................................................1-53
Month (MONTH)......................................................................1-54
Node number (NODE0 through NODE99)..............................1-55
PDL monitor ($PDL)................................................................1-56
Seconds counter (SECNDS)...................................................1-57
Seconds counters (SECND1 through SECND7) ....................1-58
Military time (TIME).................................................................1-59
Local Variables ..............................................................................1-60
$ARG1 through $ARG15 ........................................................1-61
$LOC1 through $LOC15.........................................................1-63
Point Priority Overview ..................................................................1-64
APOGEE and pre-APOGEE Point Priority Levels ..................1-64
BACnet Priority Array..............................................................1-66
At (@) Priority Status Indicators ....................................................1-68
Testing Point Priorities ............................................................1-68
Commanding Points to a Specific Priority...............................1-68
Pre-APOGEE Firmware ..........................................................1-69
At (@) Priority Status Indicators Supported............................1-71
Emergency (@EMER) ............................................................1-72