git.maemo.org Git - woller/blob - README.txt

   1 Woller
   2 ======
   3
   4 Table of Contents
   5
   6 1. About
   7 2. Theory
   8 3. Usage
   9
  10
  11
  12 1. ABOUT
  13
  14
  15 Woller is a program I made out of curiosity to QT and me being lazy
  16 walking to my MythTV box to power it up. WOL (Wake On LAN [1]) is a feature
  17 that allows computers to be powered on by sending them a network package,
  18 instead of pushing a power button. So Woller is a "remote power button"
  19 for computers.
  20
  21 During the years I've been using WOL (Wake On LAN) feature of computers to
  22 wake them up when I need them.  But this time I wanted a GUI button to
  23 press instead of command line application like the ones I've previously
  24 used. I chose QT due just the heck of checking out new framework, and
  25 since it can be easily adapted to any Linux like (Meego) internet tablets,
  26 Mac, Symbian or even Windows. Anything which runs QT.
  27
  28 Since I was aiming for a desktop widget, I preferred simplicity. I wanted
  29 only minimalistic UI, thus Woller only has a list and button. At least for
  30 now.
  31
  32 If anyone else finds use for it, feel free to modify it and please send me
  33 back any enhancements you may create. Also fixes are welcome.
  34
  35 The code is available at sf.net [2] under GPL license [3].
  36
  37 BR,
  38
  39  Ilkka Tengvall
  40
  41
  42 [1] http://en.wikipedia.org/wiki/Wake-on-LAN
  43 [2] http://sourceforge.net/projects/woller-gui
  44 [3] http://www.gnu.org/licenses/
  45
  46
  47 2. THEORY
  48
  49
  50 WOL is a network device feature, where network device listens to network
  51 for magic packets. When such packet arrives, it wakes up the device it's
  52 connected to (host). Usually the network device is PC's or laptops network
  53 card, and the device to be woken up is the PC or laptop.
  54
  55 To create such a magic packet, one needs to know the MAC address of the
  56 network device. Woller then creates the magic packet using the given MAC
  57 address. The network device catches the packet, and wakes up the host.
  58
  59
  60
  61 3. USAGE
  62
  63
  64 3.1. Find your hosts MAC address.
  65
  66 This depends on your operating system. In unixes (linux, mac) it is found
  67 by issuing command "ifconfig" on command line. It might be also shown in
  68 hosts BIOS settings. Google for "find MAC address".
  69
  70
  71 3.2. Make sure WOL is enabled in target host
  72
  73 Go to your hosts BIOS and look for setting "Wake on network", "Wake on
  74 LAN" or similar entry in bios and enable it.
  75
  76
  77 3.3 Configure Woller
  78
  79 Start Woller, and go to configure dialog by selecting "Configure targets"
  80 from the drop down menu. That brings you to host list, where you press
  81 "Add" button. In the dialog that opens, give target host name, and the MAC
  82 address (e.g. format "00:11:22:aa:bb:cc", and optionally ip network
  83 address. The network address is optional. Save changes.
  84
  85 3.4. Wake it up!
  86
  87 Wake up the configured target by selecting it from the menu, and press the
  88 button next to it. Check that your host starts up.
  89
  90
  91