Visual Test Shell

From BACnet Wiki
Jump to: navigation, search

The Visual Test Shell (VTS) is free and open source software (FOSS) that allows you to test BACnet Implementations. It has scripting and logging capabilities.

The source code or the zipped executable can be downloaded from SourceForge.

Installation

  1. Download the Zipped Executable from SourceForge
  2. Unzip the files into their own folder on your machine
  3. Read ..\Docs\Quickstart.html
  4. Execute Steps 1 to 3 in the Quickstart guide to confirm that the system is operating

Quick Start

The quickest possible way to prove that all is working properly is to do a simple local broadcast to see if any other BACnet devices respond. The following exercise assumes that we are using BACnet/IP and that there are some BACnet/IP devices on the local network.

See the video


  1. Instead of Step 4 in the Quickstart guide, follow the following procedure
  2. Ensure that steps 1 to 3 are executed. Be aware that if you have been using any package that uses a BACnet stack that gets installed in the Windows IP stack, that this needs to be disabled.
  3. Create a port to transmit the message from
    1. In VTS go to Menu/Edit/Ports..
    2. Add a new port, name it eg BIPport
    3. Click the 'Enable' checkbox
    4. Click the IP tab, confirm that it is Annex-J, UDP port 0xBAC0, and that the interface matches your machine.
  4. Create an address to send our message to
    1. Go to Menu/Edit/Names..
    2. Create a new "Local Broadcast", on the "BIPport", and name it "LB"
  5. Now send the Who-Is
    1. Go to Menu/Send/Remote Device Management/Who-Is
    2. Select the "Who-Is" tab
    3. Leave the limits blank
    4. Press "send"
    5. Press close. Note that in the background, packets and responses should be seen.
  6. The vts3.cfg and vts3.vpk files can be sent (together) as a record of this transaction.