Building Controls Virtual Test Bed

Building Controls Virtual Test Bed

Michael Wetter

Lawrence Berkeley National Laboratory
Environmental Energy Technologies Division
Building Technology and Urban Systems Department
Simulation Research Group

Copyright © 2008-2013 Lawrence Berkeley National Laboratory, Berkeley, CA

Table of Contents

1. Release Notes

1.1. Version 1.3.0
1.2. Version 1.2.0
1.3. Version 1.1.0
1.4. Version 1.0.0

2. Introduction

3. Installation and configuration

3.1. Introduction
3.2. Installation
3.3. Setting system environment variables
3.4. Uninstallation

4. Running simulations with the BCVTB

4.1. Introduction
4.2. Running the BCVTB from an explorer window
4.3. Running the BCVTB from a terminal window
4.4. Command line arguments
4.5. Example files

5. Configuring programs for use with the BCVTB

5.1. Introduction

5.2. Ptolemy II

5.2.1. Synchronous Data Flow (SDF) director
5.2.2. Data Type Conversion

5.3. EnergyPlus

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

5.3.2. Example 1: Interface using ExternalInterface:Schedule

5.3.2.1. Create an EnergyPlus idf file
5.3.2.2. Create a configuration file
5.3.2.3. Create a Ptolemy II model

5.3.3. Example 2: Interface using ExternalInterface:Actuator

5.3.3.1. Create an EnergyPlus idf file
5.3.3.2. Create a configuration file

5.3.4. Example 3: Interface using ExternalInterface:Variable

5.3.4.1. Create an EnergyPlus idf file
5.3.4.2. Create a configuration file

5.4. Dymola

5.4.1. Create a Modelica model
5.4.2. Create a Modelica script
5.4.3. Create a Ptolemy II model

5.5. MATLAB

5.5.1. Create a MATLAB script
5.5.2. Create a Ptolemy II model

5.6. Simulink

5.6.1. Create a Simulink Block Diagram
5.6.2. Create a MATLAB script
5.6.3. Create a Ptolemy II model

5.7.1. Introduction

5.7.2. Configuring ESP-r

5.7.3. Examples

5.7.3.1. HVAC control in MATLAB
5.7.3.2. Solar shading control in Ptolemy II

5.7.4. Developing new applications

5.8. Functional Mock-up Unit for Co-Simulation Import

5.8.1. Introduction

5.8.2. Import an FMU in the BCVTB

5.8.3. Example: Modelica room model in an FMU

5.8.3.1. Create and export the Modelica model as an FMU
5.8.3.2. Create a Ptolemy II system model

5.9. TRNSYS

5.9.1. Introduction

5.9.2. Example: HVAC control in Ptolemy II

5.9.2.1. Create the TRNSYS input file
5.9.2.2. Create a Ptolemy II model

5.10. Custom program using a system command

5.10.1. Create a Ptolemy II model
5.10.2. Configure the ports of the SystemCommand actor
5.10.3. Configure the parameters of the SystemCommand actor

5.11. Radiance

5.11.1. Introduction
5.11.2. Configuring Radiance
5.11.3. Create a Radiance script
5.11.4. Create a Ptolemy II model

5.12. BACnet

5.12.1. Introduction

5.12.2. Reading from BACnet

5.12.2.1. Specification of data that will be read from BACnet
5.12.2.2. Interface to BACnet Stack

5.12.3. Writing to BACnet

5.12.3.1. Specification of data that will be written to BACnet
5.12.3.2. Interface to BACnet Stack

5.12.4. Creating a Ptolemy II model

5.12.4.1. Configuring the BACnetReader
5.12.4.2. Configuring the BACnetWriter
5.12.4.3. Synchronization with real-time

5.13. Analog/Digital Interface

5.13.1. Introduction

5.13.2. Reading from ADInterfaceMCC

5.13.2.1. Specification of data that will be read from ADInterfaceMCC
5.13.2.2. Interface to adInterfaceMCC-Stack

5.13.3. Writing to ADInterfaceMCC

5.13.3.1. Specification of data that will be written to ADInterfaceMCC
5.13.3.2. Interface to adInterfaceMCC-Stack

5.13.4. Creating a Ptolemy II model

5.13.4.1. Configuring the ADInterfaceMCCReader and ADInterfaceMCCWriter
5.13.4.2. Synchronization with real-time

6. Mathematics of the Implemented Co-Simulation

6.1. Introduction
6.2. Description

7. Development

7.1. Introduction

7.2. Functional requirements

7.3. Software requirements

7.3.1. Linux
7.3.2. Mac OS X
7.3.3. Windows

7.4. Version control

7.4.1. Checking out a version
7.4.2. Creating a branch
7.4.3. Merging
7.4.4. Resources

7.5. Updating Ptolemy II

7.6. Compiling the BCVTB

7.6.1. Compiling the BCVTB
7.6.2. Custom configuration

7.7. Structure of the file system

7.8. Running unit tests

7.9. Adding actors

7.9.1. Adding actors to lib/ptII/myActors
7.9.2. Adding actors to other directories

7.10. Linking a simulation program to the BCVTB

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

8. Acknowledgements

Bibliography

List of Tables

5.1. Parameters of the Simulator actor.
5.2. Overview of the EnergyPlus objects used in the examples.
5.3. Parameters of the SystemCommand actor.
5.4. Properties of the Analog Output Object Type according to BACnet Standard, Table 12-3 (not all properties are shown).
5.5. BACnet Conformance Codes.
5.6. Attributes of the PropertyIdentifier xml element if used to write to a BACnet device.
5.7. Output ports of the BACnetReader actor.
5.8. Output ports of the BACnetWriter actor.
5.9. Attribute's values for the USB-1208LS Data Acquisition Device (READ mode).
5.10. Attribute's values for the USB-1208LS Data Acquisition Device (WRITE mode).
5.11. Output ports of the ADInterfaceMCCReader actor.
5.12. Output ports of the ADInterfaceMCCWriter actor.
7.1. Structure of the file system.
7.2. Definition of flag of BSD Socket message


		Chapter 1. Release Notes