Download

The BCVTB release includes the binary files that are compiled for Windows, Mac OS X, and Linux.

To install the BCVTB, proceed as follows:

1. Follow the user installation instruction. This is sufficient for most users.

2. Next, if you like to develop new code for Ptolemy or for the BCVTB interface, follow the developer installation instruction.

Note for users of Microsoft Internet Explorer: Internet Explorer may save the file with the extension .zip instead of .jar. To avoid this, click "Save Target As..." (using the right mouse button) and then enter the name of the installation file, for example, bcvtb-install-win64-v1.6.0.jar. (Or use Firefox to avoid this problem.)

Note for Mac OS X users: Under Mac OS X, when download the bcvtb-install-mac64-v1.6.0.jar file and click on it, a dialog pops up that says:

The workaround is to find the jar in the Finder, right click on it and select open Jar launcher.

Note for Mac OS X 10.11 (El Capitan) users: Apple has enabled a new default security oriented featured called System Integrity Protection, often called rootless, in OS X 10.11 onwards. This new feature prevents all versions of the BCVTB to run correctly. A workaround is available at https://github.com/lbl-srg/bcvtb/issues/32.

1. Release 1.6.0 (April 21, 2016)

1.1. Download

1.2. Release notes

^(a) On Windows 64-bit, to use Dymola a C/C++ compiler is required which can generate 64-bit executable and libraries.

This version contains the following updates:

1. Fixed a bug that was causing system environment variables to be ignored.

2. The example files have been updated for EnergyPlus 8.5.0.

3. The BCVTB support for Windows 32 bit has been discontinued.

4. This version has been compiled with Java (1.8.0_77 64-bit). It has been tested on Linux (Ubuntu 14.04 64-bit), Windows (7 and 8.1 64-bit), Mac OS X (10.10.5 64-bit) with latest releases of EnergyPlus (8.5.0), MATLAB (R2016a), and Dymola (2016 FD01).

5. The development site of the BCVTB was migrated from svn to github (https://github.com/lbl-srg/bcvtb).

Note for Mac OS X 10.11 (El Capitan) users: Apple has enabled a new default security oriented featured called System Integrity Protection, often called rootless, in OS X 10.11 onwards. This new feature prevents all versions of the BCVTB to run correctly. A workaround is available at https://github.com/lbl-srg/bcvtb/issues/32.

2. Release 1.5.0 (January 30, 2015)

2.1. Download

Note that these versions work with EnergyPlus 8.2, which needs to be downloaded separately from https://github.com/NREL/EnergyPlus/releases/latest.

2.2. Release notes

^(a) On Windows 64-bit, to use Dymola a C/C++ compiler is required which can generate 64-bit executable and libraries.

This version contains the following updates:

1. Added support for FMUs for co-simulation and model exchange for FMI version 2.0.
2. Ptolemy II has been updated to version 11.

3. The example files have been updated for EnergyPlus 8.2.

4. The BCVTB support for Linux 32 bit has been discontinued.

3. Release 1.4.0 (March 20, 2014)

3.1. Download

Note that these versions work with EnergyPlus 8.1, which needs to be downloaded separately from http://www.energyplus.gov.

3.2. Release notes

^(a) On Windows 64-bit, to use Dymola a C/C++ compiler is required which can generate 64-bit executable and libraries.

1. Added two Python actors for scripting.
2. Improved the Functional Mock-up Unit (FMU) for co-simulation import interface to support the Functional Mock-up Interface (FMI) for co-simulation API for tool coupling.

3. Updated example files for EnergyPlus 8.1.

4. Release 1.3.0 (May 01, 2013)

4.1. Download

Note that these versions work with EnergyPlus 8.0, which needs to be downloaded separately from http://www.energyplus.gov.

4.2. Release notes

^(a) On Windows 64-bit, to use Dymola a C/C++ compiler is required which can generate 64-bit executable and libraries.

This version contains the following updates:

1. Added two Python actors for scripting.
2. Improved the Functional Mock-up Unit (FMU) for co-simulation import interface to support the Functional Mock-up Interface (FMI) for co-simulation API for tool coupling.

3. Updated example files for EnergyPlus 8.1.

5. Release 1.3.0 (May 01, 2013)

5.1. Download

Note that these versions work with EnergyPlus 8.0, which needs to be downloaded separately from http://www.energyplus.gov.

5.2. Release notes

^(a) On Windows 64-bit, to use Dymola a C/C++ compiler is required which can generate 64-bit executable and libraries.

This version contains the following updates:

1. Added TRNSYS as a client with an example file.
2. Added a Functional Mock-up Unit (FMU) for co-simulation import interface with an example file.

3. Updated example files for EnergyPlus 8.0.

6. Release 1.2.0 (October 16, 2012)

6.1. Download

Note that these versions work with EnergyPlus 7.2, which needs to be downloaded separately from http://www.energyplus.gov.

6.2. Release notes

^(a) On Windows 64-bit, to use Dymola a C/C++ compiler is required which can generate 64-bit executable and libraries.

This version contains the following updates:

1. Added TRNSYS as a client with an example file.
2. Added a Functional Mock-up Unit (FMU) for co-simulation import interface with an example file.

3. Updated example files for EnergyPlus 8.0.

7. Release 1.2.0 (October 16, 2012)

7.1. Download

Note that these versions work with EnergyPlus 7.2, which needs to be downloaded separately from http://www.energyplus.gov.

7.2. Release notes

^(a) On Windows 64-bit, to use Dymola a C/C++ compiler is required which can generate 64-bit executable and libraries.

This version contains the following updates:

1. Fixed a buffer overflow which causes the error message ***stack smashing detected ***, followed by a termination of the client program.
2. Added an example file that describes how to convert an array of strings into an array of doubles.

8. Release 1.1.0 (January 31, 2012)

8.1. Download

Note that these versions work with EnergyPlus 7.0, which needs to be downloaded separately from http://www.energyplus.gov.

To fix a bug that may occur when exchanging a large amount of data with EnergyPlus for Windows, a new dll must be downloaded. Follow the following links to fix the bug:

• EnergyPlus 7.0, build 36 bug fix

• EnergyPlus 7.1, build 12 bug fix

The Mac OS X and Linux versions of EnergyPlus are not affected by this bug.

8.2. Release notes

^(a) On Windows 64-bit, to use Dymola a C/C++ compiler is required which can generate 64-bit executable and libraries.

This version contains the following updates:

1. The example files have been updated for EnergyPlus 7.0.

2. An actor has been added that allows reading CSV files.
3. The BCVTB has also been compiled for Windows 64 bit (in addition to Windows 32 bit, Linux 32/64bit and Mac OS X 64 bit).

9. Release 1.0.0 (February 28, 2011)

9.1. Download

Note that these versions work with EnergyPlus 6.0, which needs to be downloaded separately from http://www.energyplus.gov. To fix a bug that may occur when exchanging a large amount of data with EnergyPlus 6.0, build 23, proceed as described here.

9.2. Release notes

This version contains the following updates:

1. Added interface for analog/digital converter.

2. Fixed a bug that occured when hundreds of data were exchanged. Note to EnergyPlus users: To fix this bug also in EnergyPlus 6.0.0, build 23, proceed as described here.

10. Release 0.8.0 (November 17, 2010)

10.1. Download

Note that these versions work with EnergyPlus 6.0, which needs to be downloaded separately from http://www.energyplus.gov. To fix a bug that may occur when exchanging a large amount of data with EnergyPlus 6.0, build 23, proceed as described here.

10.2. Release notes

This version contains the following updates:

1. Improved documentation for all actors, including the examples for how to use the different actors.

2. Added examples for EnergyPlus 6.0.

3. Fixed a bug that occured when hundreds of data were exchanged. Note to EnergyPlus users: To fix this bug also in EnergyPlus 6.0.0, build 23, proceed as described here.

11. Release 0.7.0 (August 9, 2010)

11.1. Download

Note that these versions work with EnergyPlus 5.0, which needs to be downloaded separately from http://www.energyplus.gov.

11.2. Release notes

This version contains the following updates:

1. Addition of the BACnet interface that can read to and write from BACnet devices.
2. Addition of examples for Radiance.
3. Completely revised manual.

12. Release 0.6.0 (April 27, 2010)

12.1. Download

Note that these versions work with EnergyPlus 5.0, which needs to be downloaded separately from http://www.energyplus.gov.

12.2. Release notes

This version contains the following updates:

1. For the EnergyPlus client, the official version of EnergyPlus 5.0 can be used. EnergyPlus needs to be downloaded from http://www.energyplus.gov

2. The example files have been updated for EnergyPlus 5.0.

3. All configurations settings are now in the file systemVariables-*.properties.

4. The files bin/setenv.sh and bin/setenv.bat have been renamed to bin/setDevelopmentEnvironment.sh and bin/setDevelopmentEnvironment.sh. These files have been changed so that they get all environment variables from the file bin/systemVariables-*.properties. This avoids duplicate entry of system variables.

5. The Apache Ant build system is now distributed with the BCVTB installation. It will be installed in bcvtb/apache-ant. Existing installations of Apache Ant will not be affected by the BCVTB.
6. The expat library is included for Windows and Linux. (The default installation of Mac OS X already contains the expat library.)

13. Release 0.5.1 (February 9, 2010)

13.1. Download

• bcvtb-install-0.5.1.jar

• ep-4.0.zip This zip-file requires a password. To obtain the password, email the password of the official EnergyPlus installation to ZhengweiLi.

13.2. Release notes

This version contains a bug fix that caused a NullPointerException if the SystemCommand actor is called from a finite state machine.

14. Release 0.5.0 (February 4, 2010)

14.1. Download

• bcvtb-install-0.5.0.jar

• ep-4.0.zip This zip-file requires a password. To obtain the password, email the password of the official EnergyPlus installation to ZhengweiLi.

14.2. Release notes

This version contains the following updates:

1. Added a compact schedules to the EnergyPlus interface.

2. For the EnergyPlus interface, changed variable names in xml configuration file variables.cfg. The following name changes have been made

   • old	new
     dayschedule	(Replaced by schedule)
     n/a	schedule

Note that the new object schedule is similar to the Schedule:Compact in EnergyPlus and hence should not be used with a Schedule:Week.

• You will have to manually update your files variables.cfg from earlier BCVTB versions.

• For the EnergyPlus interface, changed variable names in idf files. The following name changes have been made

  • old	new
    BCVTB	ExternalInterface
    PtolemyLink	PtolemyServer
    Schedule:Day:Dynamic	(replaced by ExternalInterface:Schedule)
    n/a	ExternalInterface:Schedule
    n/a	ExternalInterface:Actuator

  You will have to manually update your idf files from earlier BCVTB versions.

15. Release 0.4.0 (November 5, 2009)

15.1. Download

• bcvtb-install-0.4.0.jar

• ep-3.1.zip This zip-file requires a password. It is the same file as the one that is distributed with the BCVTB version 0.2.0. To obtain the password, email the password of the official EnergyPlus installation to ZhengweiLi.

15.2. Release notes

This version contains the following updates:

1. Added a new actor called SystemCommand that allows to call any system command from Ptolemy. See the example for further information.

2. Added option to start the BCVTB from a java jar file. This allows to start the BCVTB from a file explorer or from a command line with several options. See Files/BCVTBJar for a description.

3. Added the example examples/dymolaEPlus31-singleZone, in which an air-based HVAC system that is modeled in Modelica is linked to a building model of EnergyPlus.

16. Release 0.3.1 (September 4, 2009)

16.1. Download

• bcvtb-install-0.3.1.jar

• ep-3.1.zip This zip-file requires a password. It is the same file as the one that is distributed with the BCVTB version 0.2.0. To obtain the password, email the password of the official EnergyPlus installation to ZhengweiLi.

16.2. Release notes

This version is a minor update that addresses the following issues:

1. For the Simulink interface, fixed a bug that prevented the BCVTB library to be displayed in Simulink's library browser.
2. Fixed compilation problems on Mac OS X 10.6 (Snow Leopard).

17. Release 0.3.0 (August 24, 2009)

17.1. Download

• bcvtb-install-0.3.0.jar

• ep-3.1.zip This zip-file requires a password. It is the same file as the one that is distributed with the BCVTB version 0.2.0. To obtain the password, email the password of the official EnergyPlus installation to ZhengweiLi.

17.2. Release notes

1. This version contains a subset of Ptolemy. Users do not need to install their own Ptolemy version.
2. Cygwin is not required anymore.

3. In the files variables.cfg, the header needs to look like

   <?xml version="1.0" encoding="ISO-8859-1"?>
   <!DOCTYPE BCVTB-variables SYSTEM "variables.dtd">
   <BCVTB-variables>

   i.e., you need to add the second line to your existing file.

4. Due to shipping a new Ptolemy version, the files system.xml and system-windows.xml had to be changed. Previous files can be updated by running the following bash script from the examples directory fixModels.sh.

18. Release 0.2.0 (June 30, 2009)

18.1. Download

• bcvtb-install-0.2.0.jar

• ep-3.1.zip This zip-file requires a password. To obtain the password, email the password of the official EnergyPlus installation to ZhengweiLi.

18.2. Release notes

1. The parameters of the Ptolemy Simulator object changed. To update your files system-windows.xml (or system.xml on Linux or Mac), run from cygwin (or a bash shell) the command

   $BCVTB_HOME/bin/updateSystemFiles.sh system-windows.xml

2. The EnergyPlus object DAYSCHEDULE:DYNAMIC has been renamed to SCHEDULE:DAY:DYNAMIC.

3. Due to a change in the parameters of the Simulator object, file names must not be quoted anymore. I.e., in system.xml or in system-windows.xml, change "socket.cfg" to socket.cfg.

4. The Simulator object now writes the simulation output to a log file (default is simulation.log) and to the console. However, console output is currently only working on Linux and on Mac OS X. The reason is that Ptolemy on Windows is started using javaw which does not write the output stream to the console.

5. The build system has been changed from Makefiles to Apache Ant. Cygwin is still needed to compile Ptolemy on Windows, but the compilation of the BCVTB does not require cygwin anymore.

19. Release 0.1.1 (September 30, 2008)

19.1. Download

19.2. Release notes

1. The EnergyPlus executable that contains the BCVTB interface is not part of this distribution. To obtain the EnergyPlus 2.1.0 executable with the BCVTB interface, email a request together with the EnergyPlus installation password to ZhengweiLi.

2. Improved reporting to log files by the socket library.
3. Improved the make files.
4. This release contains the following bug fixes:
   1. Fixed a buffer overflow in the socket library.

   2. Updated the example in example/timeSync so that it also runs on Windows.

20. Release 0.1.0 (July 17, 2008)

20.1. Download

20.2. Release notes

1. The EnergyPlus executable that contains the BCVTB interface is not part of this distribution. To obtain the EnergyPlus 2.1.0 executable with the BCVTB interface, email a request together with the EnergyPlus installation password to ZhengweiLi.

2. This release compiles and runs fine on Mac OS X and on Linux. On Windows, the example file example/timeSync does not yet work.