TSRV - StatNet Thermostat Network
Server
TSRV is a network enabled server that allows multiple clients to control
and monitor the conditions of upto 9 statnet based thermostats. TSrv's command
language is designed to be a easy to parse text based language. TSrv
has corrosponding event reporting features as well.
TSrv provides the following for each statnet thermostat
- Current temp, fan status
(AUTO/ON) and relay status (furnce, fan, cool on)
- Supports an unlimited number
of heating/cools schemes (collections of setpoints)
- Supports upto 24 setpoints
per day in
- Supports automatic scheme
selection based on the day (i.e. select a scheme for a specific day, specifica
day of week, WEEKDAY, WEEKEND, etc)
- Tracks fan/furnace/cooling
time for the day, week, month, season, year and lifetime
- Monitors furnace filter status
and provides independent reset of furnace filter usage timers
- Has scripting support allows
multiple commands to be executed via a simple identifer
- Has automated scripting support
(scripts can automatically be executed in response to a change in the tstat
- for example, whenever the fan is ON, a script can execute a command to
send you an email message)
Commands and responses/events are
completely decoupled and asynchronous
Typical TSRV commands look like this
TSTAT TEMP 1 72
TSTAT FAN_MODE 1 AUTO
TSTAT SET_POINT 1 WEEKDAY 0530 72
TSTAT SET_POINT 1 WEEKDAY 0800 68
TSTAT SET_POINT 1 WEEKDAY 1630 72
TSTAT SET_POINT 1 WEEKDAY 2200 68
Typical TSRV events/responses look like this
TSTAT UPDATE 1 MODE HEAT
TSTAT UPDATE 1 INSIDE_TEMP 73
TSTAT UPDATE 1 FAN ON
TSTAT UPDATE 1 HEAT ON
TSRV also has a general purpose messaging system to allows TSRV clients to
exchange messages amongst themselves.
TSRV is currently supported on Linux and most Unix platforms. It's
beleived that it should compile/run OK under Windows, but I've not had a
chance to try that yet. TSRV is written in C and is fairly small when
compiled and running (memory resident size is about 80K). It consumes
very little system resources.
You can read more about the protocol and use in the supplied tsrv.txt
TSRV is hosted by SourceForge. Both releases and the current CVS repository
are available to anyone. Click here to go to the
summary page on SourceForge for this project. From there, you can download
the current release, report bugs and subscribe to email lists.
TSRV is written by Gerry Duprey (gerry@cdp1802.org) and is licensed under
the GPL.
Page last updated January 3, 2002