Comfort Chart User's Guide - Johnson Controls

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

Comfort Chart User’s Guide 2

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. www.johnsoncontrols.com Code No. LIT-655251 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.


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.



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.


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



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.


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.


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.


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).

additem

Add Done Refresh

Add Item

Item Name

Browse items:

JCI-MILW\1701LIT3

Filter: *.*.*.*

CS Tag NamesCS Tag Names

JC.N10PC.1.0JCI-MILW

1701LIT11701LIT21701LIT3

53015302530353045305530653075308

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.


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.


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


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

5. 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

Add

Cancel

OKThird Wing

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

Message

Comfort point already added!

OK

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.


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.


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.


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.


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



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.


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.


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


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.


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. 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. Edit Comfort Chart Allows user to open the Comfort Chart

Definition box. Server Connection Allows user to select which server is to be

connected. View 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 Help Topics Gives user information about Comfort

Chart. About

ComfortChartDocServer Gives user information about ComfortChartDocServer.


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.


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 n:i

File ame:n

Files of ype:t Comfort Files (*.cfc)

?

Cancel

Open

DOC

Figure 4-3: Open Dialog Box 2. Select a Comfort Chart file and click Open.


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 As

Save n:i

File ame:n

Save as ype:t Comfort Files (*.cfc)

?

Cancel

Save

Auditorium.cfcDOC

Auditorium.cfc

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.


Select Server

Select

Cancel

OKICONICS.ModbusOPCServerJC.CFOPCJCIN1.OPCMETASERVER

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. www.johnsoncontrols.com Code No. LIT-655255 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.


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.

ActiveX_popup

Open Save

Edit ChartServer onnection C

Grid Lines History

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


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.


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.


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.


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.


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.


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.


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.


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


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.


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.


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

Documents

Comfort Chart User's Guide - Johnson Controls