Overview

About This Project

The hale-aloha-cli-kmj system provides a command-line interface to help users understand energy use in the Hale Aloha residences at the University of Hawaii at Manoa by accessing energy consumption and power data collected by a WattDepot server. It uses the http://code.google.com/p/wattdepot/'>WattDepot API.

This system uses a web-based client to access a database that collects data from sensors installed throughout Hale Aloha's four towers: Ilima, Lehua, Lokelani, and Mokihana. This data can be broken down into tower-level and lounge-level measurements, with each tower having five lounges designated A through E.

The Command-Line Interface

http://h3o.heliohost.org/images/help.png' alt='Command-line interface.' title='Command-line interface.' />

The main command-line interface checks whether user input matches any of the known commands and passes input to a command if it matches. Typing "help" prints the correct syntax for all available commands, and typing "quit" exits the program. The user can quit at any time after a command has executed.

The seven main functions available in the command-line interface (current-power, daily-energy, energy-since, rank-towers, set-baseline, monitor-goal, and monitor-power) each measure energy consumption and power use in a specific way.

Current Power

http://h3o.heliohost.org/images/current-power.png' alt='current-power' title='current-power' /> |>current-power [tower | lounge]| |:---------------------------------|

Current-power displays the power being used by one of the towers or by one of the towers' lounges in kilowatts.

Daily Energy

http://h3o.heliohost.org/images/daily-energy.png' alt='daily-energy' title='daily-energy' /> |>daily-energy [tower | lounge] [date]| |:--------------------------------------|

Daily-energy displays the total energy in kilowatt-hours consumed by a tower or lounge on a given date in kilowatt-hours.

Energy Since

http://h3o.heliohost.org/images/energy-since.png' alt='energy-since' title='energy-since' /> |>energy-since [tower | lounge] [date]| |:--------------------------------------|

Energy-since displays the total energy in kilowatt-hours consumed by a tower or lounge since a given date until today in kilowatt-hours.

Rank Towers

http://h3o.heliohost.org/images/rank-towers.png' alt='rank-towers' title='rank-towers' /> |>rank-towers [start] [end]| |:---------------------------|

Rank-towers lists the towers in ascending order by total energy consumption, requesting data on each tower's total from a given start date up until a given end date in kilowatt-hours.

Set Baseline

http://h3o.heliohost.org/images/set-baseline2.png' />

|>set-baseline [tower | lounge] [date]| |:--------------------------------------|

This command defines date as the "baseline" day for a tower or lounge. The date is an optional argument in YYYY-MM-DD format and defaults to yesterday. When this command is executed, the system should obtain and save the amount of energy used during each of the 24 hours of that day for the given tower or lounge.

Monitor Goal

http://h3o.heliohost.org/images/monitor-goal.png' /> |>monitor-goal [tower | lounge] [interval]| |:------------------------------------------|

This command prints out a timestamp, the current power being consumed by the tower/lounge, and whether or not the lounge is meeting its power conservation goal.

Monitor Power

http://h3o.heliohost.org/images/monitor-power.png' />

|>monitor-power [tower | lounge] [interval]| |:-------------------------------------------|

This command prints out a timestamp and the current power for a tower or lounge every chosen number of seconds, and defaults to 10 seconds if no number is given. Entering any character AND a carriage return stops this monitoring process and returns the user to the command loop.

More information about the interface can be found in the User Guide.

Information about developing for this project is in the Developers Guide.

About WattDepot

http://code.google.com/p/wattdepot/'>WattDepot is an open-source API which provides a web-based service to access and display data on energy consumption and generation stored in a database. By tracking energy use and consumption in real-time, systems developed with the WattDepot API can help users better understand how their actions affect their energy consumption.