[[Image:Amahi-Energy-Saver_Logo.png|150px]]<br>

This is in solid beta stage. Installation requires a little Linux knowledge.

==Introduction==

When the system is to be used again, simply wake it up with WOL (ref. http://en.wikipedia.org/wiki/Wake-on-LAN). There are many tools to generate WOL packets, and it is even possible to wake your server over the internet (good link: http://www.wakeonlan.me/).

Download the latest tested and released version here: http://code.google.com/p/amahienergysaver/downloads/list

* Initial installation

1. Copy the tar.gz file from the download page to some folder and unpack it with

2. Open a terminal, change to that folder and get superuser rights by running <code>su</code>

3. As root, run

4. When the installation is finished, reboot the computer. The config app is accessible at

1. In the config app, select ical in the Calendar field.

The following description was created based on Sunbird 1.0b1 running on Windows 7.

Please note that MythTV installation itself is non-trivial. The above assumes that MythTV is correctly installed and working.

==Let other apps control Amahi Energy Saver (version 0.8.12 and later)==

Sometimes you may wish to prevent Amahi Energy Saver from suspending the HDA while some other action is ongoing. There are two simple interfaces to achieve that.

Amahi Energy Saver regularly checks the directory /usr/share/aes-lock for scripts and executes them. If any of the scripts returns an errorlevel of 1, the HDA will not be suspended. Both Bash (*.sh) and Ruby (*.rb) are supported.

The scripts can be extremely simple. In pseudocode a script looks like this:

if (condition)

exit 1

exit 0

end

Amahi Energy Saver regularly checks the directory /usr/share/aes-lock for files with suffix '.lock'. As long as any such file exists, Amahi Energy Saver will not suspend the HDA. This is useful for other applications that support events. One Event may trigger the creation of the lock file, and another one may delete the lock file.

E.g., the event that shall cause the HDA to stay awake no matter what can call

When the job is finished, the respective event should call

Make sure to use individual names for the lock files, so that you don't accidentally delete the lock file of another application.

WakeOnLan is a freeware application provided by Readpixel which offers a very comfortable way to wake up your HDA directly from your Mac OS X desktop (ref. http://www.readpixel.com/wakeonlan/index.html).

==OBSELETE: Command Line Interface==

*Note: Root privileges are required to execute the CLI command. Navigate to /usr/share/aes to use the CLI correctly.

Lists the hosts found in the network, ie, all devices connected to the network. Gives the user the choice to add hosts to the monitored host list.

Show a list of all hosts which are monitored by AES (i.e. the monitored host list), and also allows to delete hosts from the list. If these hosts are up and running (and respond to ping), the server does not suspend.

Manually add a host to the monitored host list. Observe the MAC address format, which has to be XX:XX:XX:XX:XX:XX. Example is <br> <code>./aes.rb --addhost 12:34:56:78:90:ab</code>

<code>./aes.rb --calendar</code> shows the current setting.

<code>./aes.rb --calendar off</code> turns the calendar off,

<code>./aes.rb --calendar ical</code> activates the Amahi calendar integration. To show diag information use <code>./aes.rb --calendar debug</code>

Lists the current entries of the internal calendar. Calendar entries define times when the server does not suspend. Also, the server will be woken up at the beginning of a calendar entry.

Use this command to add an entry to the internal calendar. Format of startdate/stopdate: YYYY-MM-DD Format of starttime/stoptime: hhm:mm. Eg.

<br><code>./aes.rb --addcalendar 2010-12-20 15:00 2010-12-20 16:00</code> <br>

will keep the server awake on Dec 20th, 2010 from 15 to 16 hrs (3 to 4 pm). The server will also wake up at 15 hrs if it is suspended.

Show and modifiy the type of shutdown. NOTE: Not all shutdown types may be supported on your system, or may work correctly. Therefore, test that your machine is suspending and coming up correctly before deciding for a setting. Poweroff is safest type.

<code>./aes.rb --sbs</code> shows the current setting. <code>./aes.rb --sbs on</code> and <code>./aes.rb --sbs off</code> switch monitoring of Squeezeboxserver on or off, respectively. The command <code>./aes.rb --sbs debug</code> displays diagnostic information

aes checks regularly if the system can be suspended or shut down. This parameter specifies the time in seconds between two such checks. Normally should be left untouched.

View the energy savings in kWh due to the use of Amahi Energy Saver.

Set the average power consumption when working ("pc_on") and powered off ("pc_standby"). Values given in Watts. pc_on must be greater than pc_standby.

Displays command line help