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
