Comfort Chart User s Guide

1 Table of Contents Comfort Chart User’s Guide Chapter 1 Using This Guide............................................................... 1-1 Intro...
133 downloads 0 Views 692KB Size
1

Table of Contents

Comfort Chart User’s Guide Chapter 1

Using This Guide............................................................... 1-1

Introduction.................................................................................................. 1-1 Key Concepts............................................................................................... 1-2 Chapter 2

Introduction to Comfort Chart ......................................... 2-1

Introduction.................................................................................................. 2-1 Key Concepts............................................................................................... 2-2 Chapter 3

Defining Comfort Chart .................................................... 3-1

Introduction.................................................................................................. 3-1 Key Concepts............................................................................................... 3-2 Procedure Overview .................................................................................... 3-3 Detailed Procedures .................................................................................... 3-4 Chapter 4

Using Comfort Chart......................................................... 4-1

Introduction.................................................................................................. 4-1 Key Concepts............................................................................................... 4-2 Procedure Overview .................................................................................... 4-7 Detailed Procedures .................................................................................... 4-8 Appendix A

Comfort Chart ActiveX® Control .....................................A-1

Introduction..................................................................................................A-1 Key Concepts...............................................................................................A-2 Appendix B

Comfort Chart Applications .............................................B-1

Introduction..................................................................................................B-1

© November, 1999 Johnson Controls, Inc.

www.johnsoncontrols.com

2

Comfort Chart User’s Guide

Key Concepts...............................................................................................B-2 Appendix C

Document File ...................................................................C-1

Introduction..................................................................................................C-1 Key Concepts...............................................................................................C-2

Comfort Chart User’s Guide

1-1

Chapter 1

Using This Guide

Introduction The Comfort Chart is an application that operates on the M-Series Workstations. The Comfort Chart is a tool that helps operators determine how well air-handling equipment is providing thermal comfort for the building occupants or for a process within the facility.

© November 1, 2001 Johnson Controls, Inc. Code No. LIT-655251

www.johnsoncontrols.com Software Release 5.0

1-2

Comfort Chart User’s Guide

Key Concepts Chapter Organization All the chapters in this guide are divided into five main sections: Table 1-1: Chapter Organization Section

Description

Introduction

Briefly outlines the contents of the chapter.

Key Concepts

Describes background information necessary to perform or understand specific tasks.

Procedure Overview

Describes general steps for performing the tasks that are described in detail in the Detailed Procedures section. This section is geared toward users already experienced in using Comfort Chart and only need a reference.

Detailed Procedures

Describes in detail the steps needed to complete specific tasks described within the chapter. This section is geared toward users who are new to Comfort Chart.

If a section is not necessary for a particular chapter, it is omitted. For example this chapter, Using This Guide, does not contain a Detailed Procedures section.

Online Help Comfort Chart software includes online help. The help screens may be accessed by selecting Help from the menu bar, by pressing the F1 key, or by pressing Alt + H. Help describes the basic procedures for performing functions within the Comfort Chart software.

Guide Conventions As in most Windows® based programs, sometimes there are multiple ways to perform the same tasks. This guide describes how to use the mouse to perform procedures. In general, Microsoft® conventions are used to describe software features.

Comfort Chart User’s Guide

2-1

Chapter 2

Introduction to Comfort Chart

Introduction Comfort is one of the primary functions carried out by a Building Automation System (BAS). Comfort describes the temperature and humidity conditions of an area that is serviced by an air handling system. The Comfort Chart visually shows how well an air handling system is satisfying the comfort in an area. The user can quickly and easily see which systems need the most urgent attention. This chapter provides a definition of terms.

© November 1, 2001 Johnson Controls, Inc. Code No. LIT-655252

www.johnsoncontrols.com Software Release 5.0

2-2

Comfort Chart User’s Guide

Key Concepts Psychrometric Chart A psychrometric chart is a graph that displays the mathematical relationships between dry and wet bulb temperature, relative humidity, specific volume, and enthalpy. The laws of thermodynamics form the mathematical basis for the chart. Comfort for occupants is very subjective. Therefore, the chart is considered an approximation of comfort and is used to predict control problems, not to define comfort. By seeing conditions that are greatly outside the ranges (comfort zones), one can assume that the space is not comfortable for its occupants or the process.

Comfort Point A Comfort Point is a point on the psychrometric chart that represents the temperature and relative humidity of a space. Temperature and humidity setpoints may also be defined for the Comfort Point to aid in determining if a control problem exists.

Comfort Chart The Comfort Chart is a psychrometric chart that shows temperature on the X-axis and humidity index on the Y-axis. Since humidity index is fairly unknown, relative humidity curves are also shown. On the psychrometric chart, a comfort zone is identified to indicate the comfort limits defined for this zone.

Comfort Chart User’s Guide

3-1

Chapter 3

Defining Comfort Chart

Introduction Saved Comfort Chart documents contain the settings used in a particular view so that they may be used at a later time (see the Using Comfort Chart chapter in this manual for details). This chapter describes the Comfort Chart definition, which determines the data sources to be displayed and how they appear. This chapter describes how to: •

define a Comfort Point



edit a Comfort Point



define a Comfort Chart



edit a Comfort Chart



change a comfort zone



change comfort zone colors



change Comfort Chart font

© November 1, 2001 Johnson Controls, Inc. Code No. LIT-655253

www.johnsoncontrols.com Software Release 5.0

3-2

Comfort Chart User’s Guide

Key Concepts Server Connection The Server Connection allows the user to select which server provides the data. The server name is stored as part of the document data and is reconnected automatically when the document is loaded again.

Comfort Point Definition Comfort Points consist of the temperature sensor, humidity sensor, and temperature/humidity setpoints. A mechanism is provided for the user to associate Comfort Points with the objects that they represent. The user is also able to browse the objects that are currently connected to the system and select an object as the associated item. The user is able to specify an object or a constant for the temperature or humidity setpoints of a comfort point.

Comfort Chart Definition Comfort Chart defines values for the title, scale type, Comfort Points, and comfort zone that are fields in the Comfort Chart Definition dialog box.

Comfort Zone The comfort zone allows the operator to specify the display of a summer comfort zone or the operating range of a process. The operator has the ability to specify a user-defined comfort zone.

Comfort Chart User’s Guide

3-3

Procedure Overview Table 3-1: Defining Comfort Chart To Do This

Follow These Steps:

Define a Comfort Point

On the Edit menu, click Comfort Chart. Select Point Definition tab. Select chart symbol. Enter Comfort Point name. Fill in fields. Click Find. Browse. Click Add. Click OK.

Edit a Comfort Point

On Edit menu, click Comfort Chart. Highlight the Comfort Point; click Edit. Make modifications. Click OK.

Define a Comfort Chart

On Edit menu, click Comfort Chart. Enter title. Select temperature. Click Select to enter existing point. Select Comfort Point to be added. Click OK.

Edit a Comfort Chart

On Edit menu, click Comfort Chart. Enter modifications. Click OK.

Change a Comfort Zone

On the Edit menu, click Comfort Chart. Tab down to Comfort Zone and make necessary modifications. Click OK.

Change Comfort Zone Colors

On the Edit menu, click Comfort Chart Definition. Select Colors/Fonts definition tab. Click on color to change. Select desired color. Click OK.

Change Comfort Chart Font

On the Edit menu, click Comfort Chart. Click Colors/Fonts definition tab. Double click on the box to the right of the desired font change heading. Select desired font and attributes.

3-4

Comfort Chart User’s Guide

Detailed Procedures Defining a Comfort Point To define a Comfort Point: 1.

On the Edit menu, click Comfort Chart. The Comfort Chart Definition dialog box appears.

2.

Select Point Definition Tab (Figure 3-1).

Figure 3-1: Comfort Chart Definition Dialog Box 3.

Select the type of chart symbol. The options are circle, square, and triangle.

4.

Enter the Comfort Point name.

5.

Fill in the fields described in Table 3-2.

Comfort Chart User’s Guide

3-5

Table 3-2: Comfort Point Fields Fields

Description

Temperature Sensor

The name for the Temperature Object used for Comfort Point.

Temperature Setpoint

The name of the Temperature Setpoint used for the Comfort Point (optional).

Humidity Sensor

The name of the Humidity Object used for the Comfort Point.

Humidity Setpoint

The name of the Humidity Setpoint used for the Comfort Point (optional).

6.

Click Find to select the sensor or setpoint object. The Add Item dialog box appears (Figure 3-2). Add Item Item Name

JCI-MILW\1701LIT3 Filter:

Browse items:

*.*.*.*

CS Tag Names

JC.N10PC.1.0 JCI-MILW 1701LIT1 1701LIT2 1701LIT3 5301 5302 5303 5304 5305 5306 5307 5308

Add

Done

Refresh additem

Figure 3-2: Add Item Dialog Box 7.

Browse through the tree to select the sensor object.

8.

Click Add to select the object or click Done to return to Comfort Point Definition dialog box.

9.

Click OK. The Comfort Chart Point is saved and the Comfort Point Definition dialog box is closed.

3-6

Comfort Chart User’s Guide

Note:

When clicking on OK or Apply, a dialog box appears and prompts the user to add the current Comfort Point to the Comfort Chart immediately. If the point name is already defined, or the temperature/humidity sensors are not defined, a message box appears to notify the user that the point cannot be created (Figure 3-6).

Editing a Comfort Point To edit a Comfort Point: 1.

On the Edit menu, click Comfort Chart. The Comfort Chart Definition dialog box appears (Figure 3–4).

2.

Highlight a particular Comfort Point and click Edit in the Chart Definition tab. This tab switches to the Point Definition tab with the selected Comfort Point information filled (Figure 3-3).

Cafeteria

JCIMILW\1071LIT3\5305

Figure 3-3: Comfort Chart Dialog Box 3.

Make necessary modifications to the selected Comfort Point. Click OK to save the changes.

Comfort Chart User’s Guide

Defining a Comfort Chart To define a Comfort Chart: 1.

On the Edit menu, click Comfort Chart. The Comfort Chart Definition dialog box appears (Figure 3–4).

Figure 3-4: Comfort Chart Definition Dialog Box 2.

Enter the Comfort Chart title.

3.

Select the type of temperature scale.

4.

Define Comfort Zone (Table 3-3).

Table 3-3: Comfort Zone Defaults Comfort Zone

Temperatures

ASHRAE °F (Summer Conditions)-default

73.0°F, 80% RH 74.0°F, 25% RH

78.5°F, 57% RH 81.0°F, 20% RH

ASHRAE °C (Summer Conditions)-default

22.8°C, 80% RH 23.3°C, 30% RH

26.1°C, 57% RH 27.2°C, 20% RH

DIN °C

26.0°C, 30% RH 22.0°C, 35% RH

26.0°C, 65% RH 22.0°C, 65% RH

3-7

3-8

Comfort Chart User’s Guide

Note: 5.

The Default type is ASHRAE °F. Default values for the comfort zone are changed with the new temperature scale.

Click Add to enter an existing point to the Comfort Chart. The Add to Comfort Chart dialog box appears (Figure 3-5). Add to Comfort Chart Third Wing

OK Cancel

Add

Figure 3-5: Add to Comfort Chart Dialog Box 6.

Select the Comfort Point you want to add.

7.

Click Apply.

Note:

If the Comfort Point is already added, a message box appears (Figure 3-6). COMFORTCHART

Comfort point already added!

OK Message

Figure 3-6: Comfort Chart Message Dialog Box 8.

To remove a Comfort Point from the Comfort Chart, highlight the Comfort Point and click Remove (Figure 3–4).

9.

Click OK. The Comfort Chart is updated and the Comfort Chart Definition dialog box closes.

Comfort Chart User’s Guide

3-9

Editing a Comfort Chart To edit a Comfort Chart: 1.

On the Edit menu, click Comfort Chart. The Comfort Chart Definition dialog box appears (Figure 3–4).

2.

Make the necessary modifications to the Comfort Chart parameters.

3.

Click OK.

Changing a Comfort Zone To change a comfort zone: 1.

On the Edit menu, click Comfort Chart. The Comfort Chart Definition dialog box appears (Figure 3–4).

2.

Tab down to Comfort Zone and make modifications.

3.

Click OK.

The default comfort zone is specified as the summer zone in ASHRAE Standard (55-1992A), refer to Table 3-3.

3-10

Comfort Chart User’s Guide

Changing Comfort Zone Colors To change comfort zone colors: 1.

On the Edit menu, click Comfort Chart Definition. The Comfort Chart Definition dialog box appears (Figure 3–4).

2.

Select Colors/Fonts Definition Tab.

3.

Click on the color to change. The Color dialog box appears (Figure 3-7).

Figure 3-7: Color Dialog Box 4.

Select desired color.

5.

Click OK.

Comfort Chart User’s Guide

3-11

Changing Comfort Chart Fonts To change Comfort Chart fonts: 1.

On the Edit menu, click Comfort Chart. The Comfort Chart Definition dialog box appears (Figure 3–4).

2.

Click Colors/Fonts definition tab.

3.

Double click on the box to the right of desired font change heading. The Font dialog box appears (Figure 3-8).

Figure 3-8: Font Dialog Box 4.

Select desired font and corresponding attributes. Refer to Table 3-4.

Table 3-4: Font Attributes Field

Description

Font

Lists the available fonts.

Font Style

Lists the available styles for the specified font.

Size

Lists the available point sizes for the specified font.

Effects

Specifies whether the font should appear with strikeout marks or underlines.

Sample

Shows a sample of how text appears with the specified font settings.

Color

Lists the available colors for the specified font.

Script

Lists the available language scripts for the specified font.

Comfort Chart User’s Guide

4-1

Chapter 4

Using Comfort Chart

Introduction Comfort Chart can run as a standalone program or in an ActiveX® document container, such as the M3 Workstation. This chapter describes how to get started using Comfort Chart as a standalone program. This chapter describes how to: •

open a Comfort Chart file



save a Comfort Chart file



select a server connection



view Gridlines



view History

© November 1, 2001 Johnson Controls, Inc. Code No. LIT-655254

www.johnsoncontrols.com Software Release 5.0

4-2

Comfort Chart User’s Guide

Key Concepts Comfort Chart Overview The Comfort Chart is a psychrometric chart that shows temperature on the X-axis and humidity index on the Y-axis. Since humidity index is fairly unknown, relative humidity curves are also shown. Note:

The X-axis and Y-axis are reversed in the German DIN standard.

Multiple Comfort Charts may exist within a BAS. Although it is recommended that each air handling system have its own display, there is no restriction. A typical Comfort Chart displays the temperature sensors that monitor the spaces served by a given air handling system. If only a return air humidity sensor exists, it may be shared (common) by all Comfort Points of the fan system. All the Comfort Points for an air handling system may have the same symbol on the chart. If outdoor conditions are desired on the chart, a different symbol may be used to distinguish this point from the controlled Comfort Points. If few temperature sensors monitor a given air handling system, multiple air handling systems may be placed on the same chart. Different symbols could be used to distinguish points from different fan systems (up to three). Figure 4-1 is an example of the Comfort Chart.

Comfort Chart User’s Guide

4-3

Figure 4-1: Comfort Chart

Comfort Zone The comfort zone allows the operator to specify the display of a summer comfort zone or the operating range of a process. The operator also has the ability to specify a user-defined comfort zone.

Server Connection The server connection allows the user to select which server provides the data. The server name is stored as part of the document data and is reconnected automatically when the document is loaded again.

History Trail The History Trail allows the user to view the last twenty points sampled.

4-4

Comfort Chart User’s Guide

Comfort Points Comfort Points are displayed in realtime on the chart. These points represent a quadruple of BAS sensor/controller field points that relate to one another while defining the condition of an area. The points are the temperature sensor, the humidity sensor, and the temperature and humidity setpoint. The setpoints are very important since one can never assume an area is too warm or too cool without knowing where the system has been set. Each point or dot on the display can be selected with a right click of the mouse to display an information dialog box containing current values of the temperature, humidity, and setpoints. This will allow the user to know which points are out of range and whether they were set there or some system problem exists. The setpoints are optional. Figure 4-2 is an example of the Comfort Points Definition dialog box.

Figure 4-2: Comfort Points Definition Dialog Box

Comfort Chart User’s Guide

4-5

Toolbar Icons When a Comfort Chart is open, the following icons appear on the window: Table 4-1: Toolbar Icons Icon

Description New

Create a new Comfort Chart.

Open

Open an existing Comfort Chart.

Save

Save an existing Comfort Chart.

Edit Chart

Edit the current Comfort Chart settings.

Server Connection

Connection to an OPC server.

Gridlines

Show or hide the Gridlines.

History Trail

Show or hide the History Trail.

Print

Print an existing Comfort Chart.

About

Give user information about Comfort Chart.

4-6

Comfort Chart User’s Guide

Comfort Chart Menus The following menus are always available on the Comfort Chart. Additional menus appear when workstations are added. Table 4-2: Comfort Chart Main Menu Menu

Command

Description

File

New

New Comfort Chart dialog box appears.

Open

Allows user to open an existing Comfort Chart.

Edit

View

Help

Save

Allows user to save a Comfort Chart.

Save As

Allows the user to name and save a Comfort Chart.

Print Properties

Allows user to select properties before printing.

Print

Allows user to print out a Comfort Chart.

Print Preview

Allows user to preview what is to be printed.

Print Setup

Allows user to select printer settings.

Recent File List

Lists recently opened Comfort Chart files.

Exit

Allows user to exit Comfort Chart.

Comfort Chart

Allows user to open the Comfort Chart Definition box.

Server Connection

Allows user to select which server is to be connected.

Tool Bar

Allows user to view toolbar.

Status Bar

Allows user to view status bar.

Gridlines

Allows user to view Gridlines on Comfort Chart.

History

Allows user to view History Trail on Comfort Chart.

Help Topics

Gives user information about Comfort Chart.

About ComfortChartDocServer

Gives user information about ComfortChartDocServer.

Comfort Chart User’s Guide

Procedure Overview Table 4-3: Using Comfort Chart To Do This

Follow These Steps:

Open a Comfort Chart File

On the File menu, click Open. Select a Comfort Chart file. Click Open.

Save a Comfort Chart File

On the File menu, click Save. Enter a file name. Click Save.

Select a Server Connection

On the Edit menu, click Server Connection. Select name of server to provide the data. Click OK or double-click on the server.

View Gridlines

On the View menu, click on Gridlines.

View History

On the View menu, click on History.

4-7

4-8

Comfort Chart User’s Guide

Detailed Procedures Opening a Comfort Chart File To open a Comfort Chart: 1.

On the File menu, click Open. The Open dialog box appears (Figure 4-3). Open

?

Look in: DOC

File name: Files of type:

Open Comfort Files (*.cfc)

Figure 4-3: Open Dialog Box 2.

Select a Comfort Chart file and click Open.

Cancel

Comfort Chart User’s Guide

4-9

Saving a Comfort Chart File To save a Comfort Chart file: 1.

On the File menu, click Save or Save As. The Save As dialog box appears (Figure 4-4). Save As

?

Save in: DOC

Auditorium.cfc

File name:

Auditorium.cfc

Save as type:

Comfort Files (*.cfc)

Save Cancel Save As

Figure 4-4: Save As Dialog Box 2.

Enter a file name.

3.

Click Save.

Selecting a Server Connection To display the server connection: 1.

On the Edit menu, click Server Connection. The Select Server dialog box appears (Figure 4-5).

2.

Select the name of the server that is to provide the data.

3.

Click OK or double-click on the server to close the dialog box.

Note:

The server name is stored as part of the document data and connected automatically when the document is loaded again.

4-10

Comfort Chart User’s Guide

Select Server ICONICS.ModbusOPCServer JC.CFOPC JCIN1.OPCMETASERVER

OK Cancel

Select

Figure 4-5: Select Server Dialog Box

Viewing Gridlines To view Gridlines: On the View menu, click on Gridlines.

Viewing History To view History: On the View menu, click on History.

Comfort Chart User’s Guide

A-1

Appendix A

Comfort Chart ActiveX® Control

Introduction The Comfort Chart can run as a standalone program or in an ActiveX document. This appendix describes how to get started using Comfort Chart ActiveX Control. The ActiveX version of Comfort Chart is a software component that can be invoked by any container application. ActiveX applications support methods and parameters to perform all tasks.

© October 27, 2003 Johnson Controls, Inc. Code No. LIT-655255

www.johnsoncontrols.com Software Release 5.0.

A-2

Comfort Chart User’s Guide

Key Concepts ActiveX Applications ActiveX control is a loosely defined set of technologies developed by Microsoft Corporation. ActiveX control is an outgrowth of two other Microsoft technologies called Object Linking and Embedding (OLE) and Component Object Model (COM). ActiveX control is not a programming language, but rather a set of rules for how applications share information.

ActiveX Control The ActiveX control represents a specific way of implementing ActiveX technologies. They can be used to provide limited functionality of an application, such as Comfort Chart, without having to have the entire program downloaded to a machine.

Comfort Chart ActiveX Control An ActiveX control that allows the display of Comfort Chart graphics in M-Graphics displays, or in other ActiveX-compliant applications such as Internet Explorer 4. Using the Comfort Chart ActiveX control, a user can put multiple Comfort Chart images into an M-Graphics display. When a Comfort Chart ActiveX control is created in an M-Graphics display, the information for the Comfort Chart graph is saved in the M-Graphics document. Therefore, instead of having a separate .cfc file for the Comfort Chart information, the Comfort Chart information is accessed when the M-Graphics document (.gdf file) is opened. Figure A-1 is an example of Comfort Chart in ActiveX control container. Note:

For more information on ActiveX control, refer to Microsoft Visual Basic Programmer’s Guide Version 4.0 (or higher) or Understanding ActiveX and OLE; A Guide for Developers & Managers written by David Chappell.

Comfort Chart User’s Guide

A-3

ComfortActiveX

Figure A-1: Comfort Chart ActiveX Control

Expanded Right-click in a Comfort Chart ActiveX Control When a Comfort Chart ActiveX control is inserted in an ActiveX-compliant application, some of the menu options that are present in the Comfort Chart program menu bar are accessed through an expanded right-click menu (Figure A-2). The menu commands are described in Table A-1. Open Save Edit Chart Server Connection Grid Lines History ActiveX_popup

Figure A-2: Comfort Chart ActiveX Control: Expanded Right-click Options

A-4

Comfort Chart User’s Guide

Table A-1: Menu Options Command

Description

Open

Opens an existing Comfort Chart.

Save

Saves an existing Comfort Chart.

Edit Chart

Opens Comfort Chart Definition box.

Server Connection

Opens the OPC Server dialog box.

Grid Lines

Displays or hides horizontal and vertical grid lines.

History

Displays the history of the point defined.

OLE for Process Controls (OPC) Server The goal of OPC is to provide standard methods to integrate (share/exchange) plant floor system data with other business systems. OPC servers control the interaction/communication between a client requesting information and the actual physical vendor-specific data provider (hardware and/or software). For example, the Comfort Chart applications (client) communicate through an OPC server resident on the PC to communicate with the Network Control Module (NCM) or the Companion™ system. Communications between the Comfort Chart and the NCM or Companion system is coordinated via an OPC server running in the workstation. This server also provides the necessary links/interface to allow other software applications to access the facility management system data. The OPC server must be selected in order to retrieve Comfort Chart data. Refer to the Detailed Procedures section in this chapter for details on how to connect to an OPC server.

Comfort Chart User’s Guide

A-5

ActiveX Control Methods ActiveX control version of Comfort Chart supports the methods shown in Table A-2. Table A-2: ActiveX Methods Command

Description

ServerConnect

Connects to the server.

SetGridlineStatus

Sets the status of the Gridlines.

GetGridlineStatus

Returns the status of the Gridlines.

SetHistoryStatus

Sets the History status.

GetHistoryStatus

Returns the History status.

PrintComfortChartDISPLAY

Prints the Comfort Chart Display.

NewComfortChart

Creates a new Comfort Chart.

GetChartModified

Returns Comfort Chart modification status.

DisplayPopupMenu

Shows or hide pop-up menu.

SetChartModified

Sets the modification status of the chart.

GetErrorLineNumber

Shows line number of error.

LoadComfortChartDisplay

Displays Comfort Chart information stored in a valid .cfc file.

SetShowNameValueInPrint

Shows or hide point name and value in print.

GetChartDisplayTitle

Returns title of Comfort Chart.

SaveComfortchartDisplay

Saves Comfort Chart information to a file with .cfc extension.

GetPrinterPages

Displays total number of pages printed.

IsEditAllowed

Returns True when the operator has rights to edit the Comfort Chart.

IsConnectionAllowed

Returns True when the operator has rights to connect to the OPC server.

IsOpenAllowed

Returns True when the operator has rights to open a Comfort Chart Display configuration file.

LaunchSecurityServer

Launches security server for Comfort Chart ActiveX control.

A-6

Comfort Chart User’s Guide

Comfort Chart ActiveX Methods All Comfort Chart ActiveX control methods have the following attributes: Input Parameter Types, Input Parameter Descriptions, Default Value of Input Parameters, Range of Input Parameters, and Return Values. Table A-3 describes these attributes. Table A-3: ActiveX Attributes Attribute

Description

Input Parameter Type

Indicates which type of data must be entered for parameter.

Input Parameter Description

Indicates what information must be entered for this parameter in order to execute method successfully.

Default Value of Input Parameter

If no value is entered for this parameter, method assigns the default value to this input parameter.

Range of Input Parameter

Possible values of the parameter. If values other than these are entered, method is not executed and an error code is returned.

Return Value

Indicates if the method is or is not executed successfully.

Comfort Chart Input Parameter Type Description The Comfort Chart has several Input Parameter Types. Table A-4 describes these different types. Table A-4: Input Parameter Type Descriptions Input Parameter Type

Description

LPCTSTR

Indicates alphanumeric string of any length.

BOOL

Indicates whether Boolean, True, or False.

VARIANT FAR*

Indicates an all purpose data type. * Indicates data type is a pointer.

Comfort Chart User’s Guide

A-7

ServerConnection Table A-5: ServerConnection Return Values Return Value

Description

0

=

Comfort Chart was successfully connected to server.

13

=

The OPC server selected is not launched.

14

=

OPCProxy.dll is not registered.

15

=

Idataobject dispatch was not supported by the selected server.

18

=

Comfort Chart was unable to connect to the server.

SetGridlineStatus Table A-6: SetGridlineStatus Input Type

Input Description

Default Value

Range of Input

BOOL

Show Gridlines or not

False

True: Show Gridlines on the chart. False: Do not show Gridlines on the chart.

A-8

Comfort Chart User’s Guide

GetGridlineStatus Table A-7: GetGridlinestatus Return Values Return Value

Description

True

=

Gridlines are on.

False

=

Gridlines are off.

SetHistoryStatus Table A-8: SetHistoryStatus Parameters Input Type

Input Description

Default Value

Return Value

BOOL

Show or hide History on the chart.

False

True: Show History in the chart. False: Do not show History in the chart.

GetHistoryStatus Table A-9: GetHistoryStatus Return Values Return Value

Description

True

=

History data of Comfort Points are displayed.

False

=

History data of Comfort Points are not displayed.

Comfort Chart User’s Guide

A-9

PrintComfortChartDisplay Table A-10: PrintComfortChartDisplay Parameters Input Type

Input Description

Default Value

Range of Input

VARIANT FAR*

Printer DC pointer

None

Valid Printer DC pointer. Not Null.

VARIANT FAR*

CprintInfo class pointer

None

Valid CprintInfo pointer. Not Null.

Table A-11: PrintComfortChartDisplay Return Values Return Value

Description

1

=

Printer DC pointer value is Null.

2

=

CprintInfo pointer is Null.

0

=

ChartDisplay information is printed successfully.

NewComfortChart Table A-12: NewComfortChart Return Values Return Value Draws the default chart.

GetChartModified Table A-13: GetChartModified Return Values Return Value

Description

True

=

The chart has been modified.

False

=

The chart has not been modified.

DisplayPopupMenu Table A-14: DisplayPopupMenu Parameters Input Type

Input Description

Default Value

Range of Input

BOOL

Right mouse click pop-up menu is or is not displayed.

None

True: Menu appears. False: Menu does not appear.

A-10

Comfort Chart User’s Guide

SetChartModified Table A-15: SetChartModified Return Value Return Value Sets flag True if the chart is modified.

GetErrorLineNumber Table A-16: GetErrorLineNumber Return Values Return Value Line number where error occurred while loading .cfc file from disk. Line number > total number of lines in .cfc file if file is loaded successfully.

LoadComfortChartDisplay Table A-17: LoadComfortChartDisplay Parameters Input Type

Input Description

Default Value

Range of Input

LPCTTR

File name where chart information is loaded

None

Valid file name string. Not Null.

Table A-18: LoadComfortChartDisplay Return Values Return Value

Description

19

=

Comfort Chart successfully loaded.

7

=

File to be loaded is not a valid Comfort Chart file.

8

=

Value of comfort zone is out of range.

9

=

Chart type does not have a valid value.

12

=

Comfort Chart file cannot be loaded.

13

=

Server cannot be launched.

14

=

Proxy.dll is not registered.

15

=

Dataobject dispatch is not supported by the server.

16

=

License file of the OPC is missing.

18

=

Unable to connect to the server.

Comfort Chart User’s Guide

A-11

SetShowNameValueInPrint Table A-19: SetShowNameValueInPrint Parameters Input Type

Input Description

Default Value

Range of Input

BOOL

Whether to print values of the Comfort Points

False

True: Show values in the chart. False: Do not show values in the chart.

GetChartDisplayTitle Table A-20: GetChartDisplayTitle Return Value Return Value Title of the chart is displayed.

SaveComfortChartDisplay Table A-21: SaveComfortChartDisplay Parameters Input Type

Input Description

Default Value

Range of Input

LPCTSTR

File name where chart information is stored

None

A string that is not Null.

Table A-22: SaveComfortChartDisplay Return Values Return Value

Description

0

=

Comfort Chart Display is successfully saved.

11

=

Comfort Chart Display information cannot be saved.

GetPrinterPages Table A-23: GetPrinterPages Return Value Return Value Total number of pages to be printed

A-12

Comfort Chart User’s Guide

IsEditAllowed Table A-24: IsEditAllowed Return Values Return Value

Description

True

=

User has sufficient privileges to edit the Comfort Chart Display.

False

=

User does not have sufficient privileges to edit the Comfort Chart Display.

IsConnectionAllowed Table A-25: IsConnectionAllowed Return Values Return Value

Description

True

=

User has sufficient privileges to connect to the OPC server.

False

=

User does not have sufficient privileges to connect to the OPC server.

IsOpenAllowed Table A-26: IsOpenAllowed Return Values Return Value

Description

True

=

User has sufficient privileges to open a Comfort Chart Display.

False

=

User does not have sufficient privileges to open a Comfort Chart Display.

LaunchSecurityServer Table A-27: LaunchSecurityServer Return Values Return Value

Description

True

=

The security server was launched successfully.

False

=

The security server was unable to launch successfully.

Comfort Chart User’s Guide

B-1

Appendix B

Comfort Chart Applications

Introduction The Comfort Chart is a tool that helps building operators determine how well air handling equipment is providing thermal comfort for the building occupants, or for a process, within a facility. While building occupants normally refers to humans, there are situations where the Comfort Chart provides valuable information about other occupants.

© November 1, 2001 Johnson Controls, Inc. Code No. LIT-655256

www.johnsoncontrols.com Software Release 5.0

B-2

Comfort Chart User’s Guide

Key Concepts Comfort Zone The default comfort zone in the Comfort Chart is the American Society of Heating, Refrigeration, and Air Conditioning Engineers (ASHRAE) standard for summer comfort in degrees Fahrenheit. This zone is shown below in Figure B-1. Space temperatures and their associated humidity values are plotted on this psychrometric chart and the user can easily identify when an area is out of the comfort zone.

Figure B-1: Comfort Zone

Comfort Chart User’s Guide

B-3

Animal Conditions in Laboratories While there are a number of other uses for the Comfort Chart, one interesting example is using the display to monitor animal room conditions in a lab facility. Pharmaceutical companies, as well as others, use animals for important testing. These tests can be rendered useless if the thermal and humidity conditions are not kept in a tight range. Below, in Figure B-2, an example is shown for the comfort zone that rabbits can tolerate. This same procedure could be used for other applications including storage rooms, manufacturing processes, or even artwork in a museum.

Figure B-2: Tolerable Comfort Zone

Comfort Chart User’s Guide

C-1

Appendix C

Document File

Introduction Each Comfort Chart Display is contained within a document file (.cfc). This source file contains a complete definition of the Comfort Chart. The document file allows the attributes of the Comfort Chart to be changed without entering through the display itself.

© November 1, 2001 Johnson Controls, Inc. Code No. LIT-655257

www.johnsoncontrols.com Software Release 5.0

C-2

Comfort Chart User’s Guide

Key Concepts Comfort Chart Document File Figure C-1 is an example of the Comfort Chart document file.

Ccconfigfile

Figure C-1: Comfort Chart Document File