tenWare Software

How tenScripting Works

tenScripting is distributed as an MS Visual Studio project.  It contains all of the VB.NET source code that creates the development environnent providing access to the HomeSeer classes.  When you run the tenScripting project (click on >Start) it:

Connects to your HomeSeer server to create remote copies of the key HomeSeer classes

Finds and parses all of the .vb files that are included in the project folder.  There are several sample script files included in the distributed project (SimpleSamples.vb and ComplexSamples.vb).  You add your own script files to the project for testing.

Populates the drop-down lists with the files, scripts, and methods found in these files.

Once tenScripting is running and connected to HomeSeer, you select the file/script/method that you want to run/debug. You can optionally enter a parameter for the method you selected, to be passed to the method when it is run.  When you click on the Run button, tenScripting attempts to find in memory the compiled version of the script/method you specified.  Because you added your script file to the tenScripting project, Visual Studio compiled your scripts, along with the tenScripting base code, and loaded them into memory.  If your script is found in memory, tenScripting executes it, passing to it the parameter you specified. Your script is now running in the development environment.  Once your script completes (usually very quickly), you are ready to select another script to run/test.  If you need to make changes to your script, close tenScripting, make the changes, and then start tenScripting again.

tenScripting coordinates with another utility, tenHsEvents, to display in real time any device changes as they occur, and displays HS  Log records as they are written to the log.  This aids in checking the proper execution of your script.  If you check Use tenHsEvents for Log Display, then the tenHsEvents window will open following each execution of a script from within tenScripting.

Once your script is fully debugged, tenScripting can then easily copy it to your HomeSeer scripts folder via a network share.

The tenScripting program window: