
Installation - Sky Control Usb linux command line app
=====================================================

Hardware install
----------------

Connect the sky control device to a free usb port.

Connect the RF2 output on the sky/sky+ box to one of the RF connectors on
the sky control.

(Ensure that any aerial amplifiers you have connected between the sky box
and the sky control device are 'magic eye' compatible, or they will block
the remote control signal.)

To build
--------

Run the command 'make'.

You need to have the 'libusb-dev' package installed.


To install
----------

Run the command 'make install' as user 'root'.

Example commands
----------------

switch sky digibox on and send channel '105' (channel five):

sky-control-usb --sky --channel 105


switch sky+ on and send channel '105' (channel five):

sky-control-usb --sky+ --channel 105


send channel 123 to sky digibox on controller 0, output 0:
sky-control-usb --controller 0 --box 0 0001 0002 0003

send channel 356 to sky+ on controller 0, output 1:
sky-control-usb --controller 0 --box 1 0C03 0C05 0C06


Full list of remote codes
-------------------------

http://www.heenan.me.uk/control-sky-from-pc/sky-control-codes.html


Integrating to mythtv
---------------------

To integrate with mythtv, run 'make install', then setup mythtv:

Set the external channel changing command (in the 'input connections'
settings) to:

    /usr/local/bin/sky-control-usb --box 0 --sky --channel

Then when setting up channels, set the 'frequency id' to be the three digit
sky channel number.


Advanced usage
--------------

If you want to try tuning the controller to send key presses faster, please
look at send_setup_command() in sky-control-usb.c and tweak the first two
values in that function. Then run make and sky-control-usb --setup. Note
that any setup will be lost as soon as the controller is unplugged from usb
or the PC switched off.

Please note that the default settings were carefully chosen to ensure that
no commands are ever ignored or dropped when sent to a variety of sky
digiboxes. If your sky controller becomes unreliable, please go back to the
default settings.


Credits
-------

Thanks to:

Neale Swinnerton for providing the code for the --channel option.
Alan Murphy for providing the code for incorporating s/d/x into the
channel strings.

LICENSE
-------

Copyright (C) 2005-2007 Joseph Heenan. All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:
1. Redistributions of source code must retain the above copyright
   notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright
   notice, this list of conditions and the following disclaimer in the
   documentation and/or other materials provided with the distribution.
3. The name of the author may not be used to endorse or promote products
   derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.


-- 
joseph@dusky-control.com
