Difference between revisions of "Amahi Energy Saver"

From Amahi Wiki
Jump to: navigation, search
Line 1: Line 1:
General information is here: http://code.google.com/p/amahienergysaver/
+
==General==
 +
 
 +
This project is in alpha stage. It runs fine on my machine, however I need more feedback from the community to be sure that it's is good enough. So, please test and report your experience!
 +
 
 +
 
 +
==Download==
 +
 
 +
Download the latest version here: http://code.google.com/p/amahienergysaver/downloads/list
 +
 
  
 
==Initial setup==
 
==Initial setup==
Line 14: Line 22:
  
  
==CLI description==
+
==Logs==
./aes.rb --showmonitoredhosts
+
Logs are located in /usr/share/aes and named aes.log.*
 +
 
 +
 
 +
==Command Line Interface==
 +
*Note: Currently, you need to be root and navigate to /usr/share/aes to use the CLI correctly
 +
 
 +
<code>./aes.rb --showmonitoredhosts</code>
 
Show a list of all hosts which are monitored by AES, 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.
 
Show a list of all hosts which are monitored by AES, 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.
  
./aes.rb --shownetworkhosts
+
<code>./aes.rb --shownetworkhosts</code>
 
Lists the hosts found in the network and gives the user the choice to add them. This is useful to quickly fill the list of monitored hosts.
 
Lists the hosts found in the network and gives the user the choice to add them. This is useful to quickly fill the list of monitored hosts.
  
./aes.rb --addhost macadress
+
<code>./aes.rb --addhost macadress</code>
 
Manually add a host to the list of monitores hosts. Observe the MAC address format, which has to be XX:XX:XX:XX:XX:XX. Example is 12:34:56:78:90:ab
 
Manually add a host to the list of monitores hosts. Observe the MAC address format, which has to be XX:XX:XX:XX:XX:XX. Example is 12:34:56:78:90:ab
  
./aes.rb --showcalendar
+
<code>./aes.rb --showcalendar</code>
 
Lists the current calendar entries. Calendar entries define times when the server does not suspend. Also, the server will be woken up at the beginning of a calendar entry.
 
Lists the current calendar entries. Calendar entries define times when the server does not suspend. Also, the server will be woken up at the beginning of a calendar entry.
  
./aes.rb --addcalendar startdate starttime stopdate stoptime
+
<code>./aes.rb --addcalendar startdate starttime stopdate stoptime</code>
 
Use this command to add an entry to the calendar. Format of stardate/stopdate: YYYY-MM-DD Format of starttime/stoptime: hhm:mm. Eg. amahienergysaver --addcalendar 2010-12-20 15:00 2010-12-20 16:00 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.
 
Use this command to add an entry to the calendar. Format of stardate/stopdate: YYYY-MM-DD Format of starttime/stoptime: hhm:mm. Eg. amahienergysaver --addcalendar 2010-12-20 15:00 2010-12-20 16:00 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.
  
./aes.rb --help
+
<code>./aes.rb --shutdowntype</code>
 +
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 [on|off|debug]</code>
 +
--sbs alone shows the current setting of aes. The parameters on and of switch monitoring of Squeezeboxserver on or off, respectively. The debug option displays diagnostic information
 +
 
 +
<code>./aes.rb --help</code>
 
Displays command line help
 
Displays command line help
 +
 +
 +
==Windows client==
 +
On the download page there is a Windows client for automatic or manual wakeup of the HDA.
 +
 +
*Installation
 +
 +
Just run the msi file found on the download page. The client will be included in the startup folder.
 +
 +
*Configuration
 +
 +
1. Form the start menu, run AmahiEnergySaver -> AES Client
 +
 +
2. Right click on the icon that will appear in symbol bar, and select "Show config"
 +
 +
3. To get started, make sure that you set "Host MAC" and "Host name" to your HDA configuration. Set port if required, the default "9" should work in mos cases. Set "Subnet LAN" to your subnet, the default value should work if you network is configured as 192.168.0.
 +
 +
4. Hit the "OK" butten, then right click on the symbol again and restart the program according to 1.
 +
 +
5. Done! You should now be able to start your HDA by right clicking on the icon in the symbol bar and select "Wake now"

Revision as of 18:34, 8 January 2011

General

This project is in alpha stage. It runs fine on my machine, however I need more feedback from the community to be sure that it's is good enough. So, please test and report your experience!


Download

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


Initial setup

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

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

3. As root, run ./aes-install.sh

4. As root, run service aes start to start the service, and chkconfig --add aes on to make the service start on boot. Be careful, when you start the service the sytem MAY go to sleep when you don't expect it.

5. Navigate to /usr/bin/aes and run ./aes.rb --shownetworkhosts to show and select to add any currently active network host to the list of monitored hosts. Run ./aes.rb --showmonitoredhosts to check the monitored hosts and delete the ones you want to remove.


Logs

Logs are located in /usr/share/aes and named aes.log.*


Command Line Interface

  • Note: Currently, you need to be root and navigate to /usr/share/aes to use the CLI correctly

./aes.rb --showmonitoredhosts Show a list of all hosts which are monitored by AES, 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.

./aes.rb --shownetworkhosts Lists the hosts found in the network and gives the user the choice to add them. This is useful to quickly fill the list of monitored hosts.

./aes.rb --addhost macadress Manually add a host to the list of monitores hosts. Observe the MAC address format, which has to be XX:XX:XX:XX:XX:XX. Example is 12:34:56:78:90:ab

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

./aes.rb --addcalendar startdate starttime stopdate stoptime Use this command to add an entry to the calendar. Format of stardate/stopdate: YYYY-MM-DD Format of starttime/stoptime: hhm:mm. Eg. amahienergysaver --addcalendar 2010-12-20 15:00 2010-12-20 16:00 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.

./aes.rb --shutdowntype 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.

./aes.rb --sbs [on|off|debug] --sbs alone shows the current setting of aes. The parameters on and of switch monitoring of Squeezeboxserver on or off, respectively. The debug option displays diagnostic information

./aes.rb --help Displays command line help


Windows client

On the download page there is a Windows client for automatic or manual wakeup of the HDA.

  • Installation

Just run the msi file found on the download page. The client will be included in the startup folder.

  • Configuration

1. Form the start menu, run AmahiEnergySaver -> AES Client

2. Right click on the icon that will appear in symbol bar, and select "Show config"

3. To get started, make sure that you set "Host MAC" and "Host name" to your HDA configuration. Set port if required, the default "9" should work in mos cases. Set "Subnet LAN" to your subnet, the default value should work if you network is configured as 192.168.0.

4. Hit the "OK" butten, then right click on the symbol again and restart the program according to 1.

5. Done! You should now be able to start your HDA by right clicking on the icon in the symbol bar and select "Wake now"