Modifying The Standard Control Basic Programs - KMC Controls FlexStat Application Manual

Modifying the Standard Control Basic Programs

Programs 1 through 5
Control Basic programs 1 through 5 are used for built-in applications
and can NOT be modified directly. Programs 6 through 10 are empty and
can be used for additional programming. Using BACstage or TotalControl,
a program (1 through 5) can be copied, pasted into a new program code
object (6 through 10), edited, and run in place of the original. (Although
programs 1–5 cannot be edited, they can be halted and set to not autorun
after restart.)
Because programs are executed sequentially, if a program is copied
and modified, ALL of the following programs must also be copied
(even if they are not modified)! For example, if program 2 is copied
into program 6 and modified, then programs 3 through 5 (even if
they contain no modifications) must also be copied into programs 7
through 9. Then programs 2 through 5 are set to NOT autorun, pro-
grams 6 through 9 are set to autorun, and the FlexStat is restarted.
Program 1
Program 1 interacts with the user interface (display and menus). If
Program 1 is copied and replaced, ensure that the common code (up to
the application branch code section) in Program 1 is running. Failure
to do so may disable one or more user interface functions.
In all models, the common code ends at nearly the bottom of the entire
code and is before the application lines (as relevant to the model):
AHU_CODE, FCU_2_PIPE_CODE, etc.
In firmware R1.3.0.8 and after, the branch code section is somewhere
around line 518 in BAC-1xx63, line 522 in BAC-1xx36, or line 370 in
BAC-1xx30 and comes after:
END_COMMON_CODE:
END
Searching for "COMMON" will quickly find the line. Earlier firmware
versions do not have this convenient flag.
In BAC-1xx63, firmware R1.3.0.4 and earlier, the branch code section is
somewhere around line 457 and looks similar to:
REM PERFORM APPROPRIATE SECTION OF CODE BASED ON
FLEXSTAT CONFIGURATION
FlexStat (General)
IF APP_MAIN_TYPE = AHU THEN
GOTO AHU_CODE
ELSE IF APP_MAIN_TYPE = RTU THEN
GOTO RTU_CODE
ELSE IF APP_MAIN_TYPE = FCU THEN
IF APP_SUB_TYPE = PIPE2 THEN GOTO FCU_2_PIPE_CODE
IF APP_SUB_TYPE = PIPE4 THEN GOTO FCU_4_PIPE_CODE
ELSE IF APP_MAIN_TYPE = HP THEN
GOTO HP_CODE
ENDIF
In BAC-1xx36 firmware R1.3.0.4 and earlier, the branch code section
(ending the common code) is somewhere around line 511 and looks
similar to:
REM PERFORM APPROPRIATE SECTION OF CODE BASED ON
FLEXSTAT CONFIGURATION
IF APP_MAIN_TYPE = AHU THEN
GOTO AHU_CODE
ELSE IF APP_MAIN_TYPE = FCU THEN
IF APP_SUB_TYPE = PIPE2 THEN GOTO FCU_2_PIPE_CODE
IF APP_SUB_TYPE = PIPE4 THEN GOTO FCU_4_PIPE_CODE
ENDIF
END
In a BAC-1xx30, firmware R1.3.0.4 and earlier, because there is nothing
specific to applications other than the AHU, there is no branch code
section. However, there is the AHU_CODE label.
After the common code, the appropriate application specific section
should be copied, modified as necessary, and running as well.
NOTE: Customized programs are the responsibility of the user. KMC
Controls does not provide support for such programs.
9 Application Guide, Rev L