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-95
SAMPLE (Sample a statement)
Unitary pre-APOGEE APOGEE BACnet
Syntax
SAMPLE(sec) line
sec Interval in seconds between evaluations of state.
• This value must be entered as an integer ranging
from 1 to 32,767.
line Any PPCL statement that does not include its own timing
function. This includes: WAIT, PDL, TOD, TIMAVG, LOOP,
SSTO, or another SAMPLE command.
Use
Defines how often a command is evaluated. The SAMPLE command
can be helpful in situations, such as preventing short cycling in
ON/OFF decisions or reducing COVs from noisy flow transmitters.
Example
200 SAMPLE(600) ON(HALFAN)
Notes
The SAMPLE command executes immediately on a return from
power failure, after an ENABLE command, or during the first
execution of PPCL following a database load.
Valid commands can include assignment, calculations, and program
control (GOTO, GOSUB).
APOGEE PPCL User’s Manual
3-96 Siemens Building Technologies, Inc.
SET (Set point value)
Unitary pre-APOGEE APOGEE BACnet
Syntax
SET(value,pt1,...,pt15)
value
Value to which points are commanded.
• This value can be a decimal, a logical point, or a local
variable. Integers are not allowed.
pt1
through
pt15
Point names of logical points.
SET(@prior, value, pt1,...,pt14)
@prior
Defines a specific point priority.
value Value to which points are commanded. This value can be a
decimal, a logical point, or a local variable. Integers are
allowed in APOGEE firmware.
pt1
through
pt14
Point names of LAO or LDO, L2SL, L2SP, LOOAL, LOOAP,
LFSSL, LFSSP, and LPACI point types.
NOTE: The SET(@prior) command is not available in Unitary
firmware.
Use
Changes output points to a new value.
• Acceptable point types are: LAO or LDO, L2SL, L2SP, LOOAL,
LOOAP, LFSSL, LFSSP, and LPACI.
• A maximum of 15 points can be changed with one SET
command.
• A maximum of 14 points can be changed with one
SET(@ prior…) command.