Next: , Previous: , Up: Top   [Contents]


1 Overview

GNU remotecontrol is a web application serving as a management tool for multiple IP enabled HVAC thermostat devices and other Building Automation devices. The purpose of GNU remotecontrol is to read from and write to multiple IP enabled thermostat devices all at one time.

The GNU remotecontrol framework is designed to work with any IP enabled HVAC thermostat, but can be easily developed to operate any number of networked devices. This framework is built with cURL, PHP, and MySQL. This system architecture is enabled on a server-client principle, where users can login to the server using a web browser to manage multiple remote devices from a single web interface. The GNU remotecontrol framework was developed to work in combination with a Remote Monitoring Server, which monitors configurable device parameters and can generate automatic system responses and alerts. GNU remotecontrol is both scalable and distributable over multiple computers serving different roles in the HVAC or remote device management framework. The Proliphix thermostat (currently the only true IP enabled HVAC thermostat on the market) was used to develop the GNU remotecontrol web application. The Application Programming Interface (API) Proliphix IP Devices HTTP API, Revision 1.8 is used to read from and write to the Object Identification (OID) numbers defined in the Proliphix API for the Proliphix HVAC thermostat device.

We identify anytime we do not adhere to the Proliphix API instructions with the text...THIS IS A DEVIATION TO THE PROLIPHIX API...in GNU remotecontrol user manual. The only time we deviate from the Proliphix API is when there is a critical thermostat device firmware deficiency. Otherwise, the Proliphix API instructions are strictly followed by GNU remotecontrol.

GNU remotecontrol is now designed and built using the Model-View-Controller (MVC) software architectural pattern. The benefit is to provide easier code reusability and pave the way for Unattended Server Side Automation (USSA or U-S-S-A). The automation is intended to replace repetitive actions in your day-to-day usage of GNU remotecontrol. Examples of such repetition are setting the time on all thermostat devices, or interfacing with an external system such as another Energy Management System. The benefit is to free you of most, if not all, human interaction necessary to operate your GNU remotecontrol implementation.

GNU remotecontrol is now designed and built using a standard Data-Access Layer (DAL) interface via the PHP Data Objects (PDO). This construct supports the GNU remotecontrol MySQL database using the PDO data access components. The DAL can easily mature to support other types of databases or data access components.

There are two significant enhancements to the setup of GNU remotecontrol. First, there is scripting to setup the GNU remotecontrol database. Second, there is a single configuration file to connect your PHP to your MySQL for using GNU remotecontrol along with other settings necessary for GNU remotecontrol. These two enhancements greatly ease GNU remotecontrol configuration and operation.

The intended structure of this documentation is to help you achieve an understanding of why you need or want to use GNU remotecontrol and instruction for how to use GNU remotecontrol. Our research during the development of GNU remotecontrol found users operated best when they were given the opportunity to gain a high-level understanding of all the technologies associated with GNU remotecontrol. This documentation is written as a combined reference manual and technical manual for GNU remotecontrol. The Scope section contains a listing of the minimum recommended chapter reading, per user role. Each section in System Architecture and Concepts contains instructions for Security Model, any Options recommended, Requirements to run the technology, and Configuration of the technology.

We recognize this documentation contains a lot of material. The documentation is segmented for you to select what you need to read to quickly and easily learn about and start using GNU remotecontrol. It is our hope you find this documentation contains all of the information you need to successfully and effortlessly use GNU remotecontrol. We now gladly give you the latest version of GNU remotecontrol.


Next: , Previous: , Up: Top   [Contents]