Build Status Visualisers

A Visualiser is simply a plugin which controls a visulaisation device. As a plug in it is dynamically loaded from an assembly by the Build Status Monitor Controller and multiple monitors can be configured and used concurrently.

Each Visualiser receives data from a Monitor and it is up to the Visualiser to decide what to do with the data it recieves.

Currently there are 2 Visualisers:

##DelCon HID USB Light Visualiser##

The Delcon HID USB Visualiser is a visualiser which knows how to control a Delcon light. It uses the Delcon API to change the lights, turn them on or off or make them flash. Each light has a unique ID which unfortunately changes at times (seems to be dynamic) and is different when pluged into different machines.

Therefore, what has to happen is that the Build Monitor Application needs to be run in INFORMATION mode so you can get the HID Key before setting up the configuration data.

To do this, a number of steps are currently required:

• Modify the BuildStatusMonitor.exe.config file and set the LogLevel to Information
• run BuildStatusMonitor.exe --run from the command line
• Review the BuildStatusMonitor.log file created. If it runs sucessfully you will have a BuildStatusMonitor.Log file which contains the HID light keys. The data will look like this:

17/02/2012 9:32:14 AM,[1] INFORMATION :Log File Initialised: C:\BuildStatusMonitor\BuildStatusMonitor.Log for severity 'INFORMATION' 17/02/2012 9:32:14 AM,[1] INFORMATION :BuildStatusMonitor Application Starting. 17/02/2012 9:32:14 AM,[1] INFORMATION :Current Directory is 'C:\BuildStatusMonitor' 17/02/2012 9:32:14 AM,[1] INFORMATION :Assembly Directory is 'C:\BuildStatusMonitor\BuildStatusMonitor.exe' 17/02/2012 9:32:14 AM,[1] INFORMATION :Logging the atached Delcom Lights. 17/02/2012 9:32:14 AM,[1] INFORMATION :\?\hid#vid_0fc5&pid_b080#6&1cb2b5da&0&0000#{4d1e55b2-f16f-11cf-88cb-001111000030} 17/02/2012 9:32:14 AM,[1] INFORMATION :\?\hid#vid_0fc5&pid_b080#6&78b522f&0&0000#{4d1e55b2-f16f-11cf-88cb-001111000030} 17/02/2012 9:32:14 AM,[1] INFORMATION :Running in Test Mode.

In the log above you can see the two Delcom lights and their ID's. You need to copy the ID's to put into the configuration file. See the Build Status Configuration page for more details.

Running in --run mode runs a single poll and visualisation.

##Text File Visualiser##

The Text File Visualiser simply outputs the build status information to a text file. You cannot use the same text file for more than one visualiser.

The name of the file to write to is defined in the Log File using the Key/Value pairs as defined in the Build Status Configuration Page.