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-75
OIP (Operator interface program)
Unitary pre-APOGEE APOGEE BACnet
Syntax
OIP(trigger, ''seq'')
trigger The trigger for the operator interface sequence.
• This parameter can be an LDO or LDI point name or
a local variable.
seq This variable represents the sequence of keystrokes you
would enter if you were using a terminal.
• The sequence must not exceed 80 characters
(including slashes) in length.
• The sequence must be enclosed in double quotes
('' '').
• For each level in the sequence that you advance, you
must enter a slash (/).
• If a pause is needed in a phone number, do the
following:
For APOGEE firmware, enter a comma.
For pre-APOGEE firmware, enter a period.
Use
Allows most operator functions to be executed from within a PPCL
program. This command is generally used for the following functions:
• Generating reports
• Changing point priorities
• Sending messages
• Triggering auto-dial
The OIP command uses a trigger point to determine the conditions
for execution. When the trigger point is turned on, the operator
sequence is executed once. To execute the operator sequence
again, the trigger point must be turned OFF, and then turned ON
again.
APOGEE PPCL User’s Manual
3-76 Siemens Building Technologies, Inc.
Example
100 C
102 C OIP COMMAND INFORMATION:
104 C OPERATOR SEQUENCE
106 C
108 C - POINT
110 C - DISPLAY
112 C - PRINTER
114 C - YES
116 C - VALUE
118 C - ANY
120 C - NAME
122 C - ALL NAMES
124 C
130 C TRIGGER POINT - RPT7AM
150 OIP(RPT7AM,"P/D/P/Y/V/A/N/*")
Example to Dial Out Using a Modem—APOGEE Firmware
100 C APOGEE OIP COMMAND INFORMATION:
102 C DIAL-OUT TO MODEM
110
OIP(TRIGGER,”S/H/P/I/C/P/<field panel
#>/<partner id>”)
Example to Dial Out Using a Modem—pre-APOGEE Firmware
100 C PRE-APOGEE OIP COMMAND INFORMATION:
102 C DIAL-OUT TO MODEM
110
OIP(TRIGGER,”S/D/<cabinet #>/O/C/<phone # id>/”)
Notes
• OIP commands used to generate messages, displays, and
reports should be staggered in time (that is, do not use the same
trigger point for all OIP commands). This allows one command to
complete before another begins.
• The OIP command will appear as FAILED if the operator
sequence was entered incorrectly and the control program
attempts to execute it.
• On return from power failure, after an enable command has been
executed, or during the first execution of the control program after
a database load, the OIP command will not execute until the
trigger point toggles.