Sonar Power Manager
Author: Stephen Tarzia
        steve@stevetarzia.com

This code was written at Northwestern university in collaboration with
Robert Dick (U. Michigan), Peter Dinda (Northwestern), and Gokhan Memik 
(Northwestern).
========================================================================

LICENSE
-------
You may use this source code without any restriction.  However, we would
appreciate it if you would notify us of projects insipired by our project 
so that we can link you.


LINUX PREREQUISITES
-------------------
Under Linux, there are two main libraries required to build this code:
- Portaudio cross platform audio library V19 (V18 won't work)
    This is available in Fedora as package "portaudio-devel"
    and in Debian as package "libportaudio-dev"
- X Screen Saver extension library
    This is available in Fedora as package "libScrnSaver-devel"
    and in Debian as package "libxss-dev"
- curl is required for FTP uploading of the log file.
- wxWidgets 2.8


LINUX COMPILATION
-----------------
Run 'make sonar_gui' or 'make sonar_tui'.

You must also manually create the directory ~/.sonarPM/ before the program
can be run.


LINUX USAGE
-----------
'./sonar_gui' or './sonar_tui'


ADVANCED USAGE
--------------
You can change the ping frequency by editing the config file: 
~/.sonarPM/sonarPM.cfg

Erase ~/.sonarPM/* to eliminate the current configuration and start afresh.

'./sonar_tui --poll' is useful for piping the output into a script or for
storing a simple log of sonar readings.


WINDOWS PREREQUISITES
---------------------
Compiling for Windows is a bit trickier.  Portaudio must be downloaded and 
moved into a 'portaudio' directory and wxWidgets library must be installed
(and Makefile.vc edited to reflect its installation directory).


WINDOWS COMPILATION
-------------------
You can compile either with mingw using the standard Makfile:
'make sonar_gui.exe' or 'make sonar_tui.exe'

or with the MS Visual Studio commandline:
'nmake -f Makefile.vc'

In either case, you must manually create the folder:
'[Application Data]/sonarPM'
Normally the installer would do this, but the installer is not presently
included in the source tarball.
