
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
----------------

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


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 channel, 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.
