Building Controls Virtual Test Bed

Building Controls Virtual Test Bed

Michael Wetter

Lawrence Berkeley National Laboratory
Environmental Energy Technologies Division
Building Technologies Program
Simulation Research Group

Copyright © 2010 Lawrence Berkeley National Laboratory, Berkeley, CA

Table of Contents

1. Introduction

2. Installation and configuration

2.1. Introduction
2.2. Installation
2.3. Setting system environment variables
2.4. Uninstallation

3. Running simulations with the BCVTB

3.1. Introduction
3.2. Running the BCVTB from an explorer window
3.3. Running the BCVTB from a terminal window
3.4. Command line arguments
3.5. Example files

4. Configuring programs for use with the BCVTB

4.1. Introduction

4.2. Ptolemy II

4.3. EnergyPlus

4.3.1. Syntax of the xml file that configures the data mapping between EnergyPlus and the external interface

4.3.2. Example 1: Interface using ExternalInterface:Schedule

4.3.2.1. Create an EnergyPlus idf file
4.3.2.2. Create a configuration file
4.3.2.3. Create a Ptolemy II model

4.3.3. Example 2: Interface using ExternalInterface:Actuator

4.3.3.1. Create an EnergyPlus idf file
4.3.3.2. Create a configuration file

4.3.4. Example 3: Interface using ExternalInterface:Variable

4.3.4.1. Create an EnergyPlus idf file
4.3.4.2. Create a configuration file

4.4. Dymola

4.4.1. Create a Modelica model
4.4.2. Create a Modelica script
4.4.3. Create a Ptolemy II model

4.5. MATLAB

4.5.1. Create a MATLAB script
4.5.2. Create a Ptolemy II model

4.6. Simulink

4.6.1. Create a Simulink Block Diagram
4.6.2. Create a MATLAB script
4.6.3. Create a Ptolemy II model

4.7. Custom program using a system command

4.7.1. Create a Ptolemy II model
4.7.2. Configure the ports of the SystemCommand actor
4.7.3. Configure the parameters of the SystemCommand actor

4.8. Radiance

4.8.1. Introduction
4.8.2. Configuring Radiance
4.8.3. Create a Radiance script
4.8.4. Create a Ptolemy II model

4.9. BACnet

4.9.1. Introduction

4.9.2. Reading from BACnet

4.9.2.1. Specification of data that will be read from BACnet
4.9.2.2. Interface to BACnet Stack

4.9.3. Writing to BACnet

4.9.3.1. Specification of data that will be written to BACnet
4.9.3.2. Interface to BACnet Stack

4.9.4. Creating a Ptolemy II model

4.9.4.1. Configuring the BACnetReader
4.9.4.2. Configuring the BACnetWriter
4.9.4.3. Synchronization with real-time

5. Mathematics of the Implemented Co-Simulation

5.1. Introduction
5.2. Description

6. Development

6.1. Introduction

6.2. Functional requirements

6.3. Software requirements

6.3.1. Linux
6.3.2. Mac OS X
6.3.3. Windows

6.4. Version control

6.4.1. Checking out a version
6.4.2. Creating a branch
6.4.3. Merging
6.4.4. Resources

6.5. Updating Ptolemy II

6.6. Compiling the BCVTB

6.6.1. Compiling the BCVTB
6.6.2. Custom configuration

6.7. Structure of the file system

6.8. Running unit tests

6.9. Adding actors

6.10. Linking a simulation program to the BCVTB

6.11. Data exchange between Ptolemy II and programs that are started by the Simulator actor

7. Acknowledgements

Bibliography

List of Tables

4.1. Parameters of the Simulator actor.
4.2. Overview of the EnergyPlus objects used in the examples.
4.3. Parameters of the SystemCommand actor.
4.4. Properties of the Analog Output Object Type according to BACnet Standard, Table 12-3 (not all properties are shown).
4.5. BACnet Conformance Codes.
4.6. Attributes of the PropertyIdentifier xml element if used to write to a BACnet device.
6.1. Structure of the file system.
6.2. Definition of flag of BSD Socket message


		Chapter 1. Introduction