org.harctoolbox.harchardware.ir

Class GirsClient<T extends ICommandLineDevice & IHarcHardware>

java.lang.Object

org.harctoolbox.harchardware.ir.GirsClient<T>

Type Parameters:

T -

All Implemented Interfaces:

Closeable, AutoCloseable, ICommandLineDevice, IHarcHardware, ICapture, IIrReader, IIrSenderStop, IRawIrSender, IRawIrSenderRepeat, IReceive, IRemoteCommandIrSender, ITransmitter

public class GirsClient<T extends ICommandLineDevice & IHarcHardware>
extends Object
implements IHarcHardware, IReceive, IRawIrSender, IRawIrSenderRepeat, IRemoteCommandIrSender, IIrSenderStop, ITransmitter, ICapture, ICommandLineDevice

Field Summary

Fields inherited from interface org.harctoolbox.harchardware.ir.IRawIrSender

repeatMax

Fields inherited from interface org.harctoolbox.harchardware.ir.IRemoteCommandIrSender

repeatMax

Fields inherited from interface org.harctoolbox.harchardware.ir.IIrReader

defaultBeginTimeout, defaultCaptureMaxSize, defaultEndTimeout

Constructor Summary

Constructors

Constructor and Description
GirsClient(T hardware)

Method Summary

Modifier and Type	Method and Description
ModulatedIrSequence	capture() Listens to the device and returns a sequence.
void	close()
void	flushInput()
int	getBeginTimeout()
String[]	getCommands(String remote) Returns an array of command names for the remote given in the argument.
int	getEndTimeout()
int	getMaxCaptureLength()
List<String>	getModules()
String[]	getRemotes() Returns an array of "remote" names.
Transmitter	getTransmitter() Returns a default Transmitter for the device.
Transmitter	getTransmitter(String connector) Parses the String argument, and returns a transmitter accordingly.
String[]	getTransmitterNames() Return possible name of transmitters, that are guaranteed to work with the getTransmitter(String).
String	getVersion() Returns the hardware version (not the version of the driver software).
boolean	hasModule(String module)
boolean	isValid() Tries to identify instances that are not valid.
static void	main(String[] args) Just for testing.
void	open() Opens the device with previously set parameters.
String	readString() Reads a line of text.
String	readString(boolean wait) Reads a line of text.
boolean	ready() Tells whether this stream is ready to be read.
IrSequence	receive() Listens to the device and returns a sequence.
void	reset()
boolean	sendIr(IrSignal irSignal, int count, Transmitter transmitter)
boolean	sendIrCommand(String remote, String command, int count, Transmitter transmitter) Sends the command to the hardware, to be sent count number of times.
boolean	sendIrCommandRepeat(String remote, String command, Transmitter transmitter) Like sendIr, but sends the IR signal until stopped by stopIr.
boolean	sendIrRepeat(IrSignal irSignal, Transmitter transmitter) Like sendCcf, but continues the transmission until interrupted by a stopIr command.
void	sendString(String cmd) Sends a command (a String) to the instance.
void	setBeginTimeout(int beginTimeout)
void	setCaptureMaxSize(int maxCaptureLength)
void	setDebug(int debug) Sets a debug parameter.
void	setEndTimeout(int endingTimeout)
void	setFallbackFrequency(int fallbackFrequency)
void	setLcd(String message)
void	setLcd(String message, int x, int y)
void	setLcdBacklight(boolean state)
void	setLcdBacklight(int flashTime)
void	setLed(int led, boolean state)
void	setLed(int led, int flashTime)
void	setLineEnding(String lineEnding)
void	setTimeout(int timeout) Deprecated.
void	setUseReceiveForCapture(boolean val)
void	setVerbosity(boolean verbose) Sets a verbosity flag, causing commands to be executed verbosely.
boolean	stopCapture() Signals the capturing device that it should stop capturing.
boolean	stopIr(Transmitter transmitter) Stops ongoing IR transmission.
boolean	stopReceive() Signals the receiving device that it should stop receiving.
void	waitFor(String goal, String areUThere, int delay, int tries)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

GirsClient

public GirsClient(T hardware)
           throws HarcHardwareException,
                  IOException

Throws:

HarcHardwareException

IOException

Method Detail

main

public static void main(String[] args)

Just for testing.

Parameters:

args - the command line arguments

setUseReceiveForCapture

public void setUseReceiveForCapture(boolean val)

close

public void close()
           throws IOException

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Throws:

IOException

getVersion

public String getVersion()
                  throws IOException

Description copied from interface: IHarcHardware

Returns the hardware version (not the version of the driver software). May be null if no relevant information available.

Specified by:

getVersion in interface IHarcHardware

Returns:

Version string. Semantics can vary.

Throws:

IOException

setVerbosity

public void setVerbosity(boolean verbose)

Description copied from interface: IHarcHardware

Sets a verbosity flag, causing commands to be executed verbosely. Exact semantic depends on the implementation.

Specified by:

setVerbosity in interface IHarcHardware

Parameters:

verbose - on or off

setDebug

public void setDebug(int debug)

Description copied from interface: IHarcHardware

Sets a debug parameter. Exact semantic depends on the implementation.

Specified by:

setDebug in interface IHarcHardware

setTimeout

@Deprecated
public void setTimeout(int timeout)
                            throws IOException

Deprecated.

Description copied from interface: IHarcHardware

Set timeout in milliseconds. Exact semantics may be dependent on the hardware.

Specified by:

setTimeout in interface IHarcHardware

Parameters:

timeout - Timeout in milliseconds.

Throws:

IOException

getBeginTimeout

public int getBeginTimeout()

Returns:

the beginTimeout

setBeginTimeout

public void setBeginTimeout(int beginTimeout)

Specified by:

setBeginTimeout in interface IIrReader

Parameters:

beginTimeout - the beginTimeout to set

getMaxCaptureLength

public int getMaxCaptureLength()

Returns:

the maxCaptureLength

setCaptureMaxSize

public void setCaptureMaxSize(int maxCaptureLength)

Specified by:

setCaptureMaxSize in interface IIrReader

Parameters:

maxCaptureLength - the maxCaptureLength to set

getEndTimeout

public int getEndTimeout()

Returns:

the endingTimeout

setEndTimeout

public void setEndTimeout(int endingTimeout)

Specified by:

setEndTimeout in interface IIrReader

Parameters:

endingTimeout - the endingTimeout to set

setLineEnding

public void setLineEnding(String lineEnding)

Parameters:

lineEnding - the lineEnding to set

isValid

public boolean isValid()

Description copied from interface: IHarcHardware

Tries to identify instances that are not valid. Exact meaning can vary.

Specified by:

isValid in interface IHarcHardware

Returns:

validity of the instance.

getModules

public List<String> getModules()

hasModule

public boolean hasModule(String module)

setFallbackFrequency

public void setFallbackFrequency(int fallbackFrequency)

Parameters:

fallbackFrequency - the fallbackFrequency to set

sendIr

public boolean sendIr(IrSignal irSignal,
                      int count,
                      Transmitter transmitter)
               throws NoSuchTransmitterException,
                      IrpMasterException,
                      IOException

Specified by:

sendIr in interface IRawIrSender

Returns:

if false, command failed.

Throws:

NoSuchTransmitterException

IrpMasterException

IOException

open

public void open()
          throws IOException,
                 HarcHardwareException

Description copied from interface: IHarcHardware

Opens the device with previously set parameters.

Specified by:

open in interface IHarcHardware

Throws:

IOException

HarcHardwareException

waitFor

public void waitFor(String goal,
                    String areUThere,
                    int delay,
                    int tries)
             throws IOException,
                    HarcHardwareException

Throws:

IOException

HarcHardwareException

capture

public ModulatedIrSequence capture()
                            throws IOException,
                                   HarcHardwareException,
                                   IrpMasterException

Description copied from interface: ICapture

Listens to the device and returns a sequence. Requires the device to be previously opened. Should itself neither open or close the device.

Specified by:

capture in interface ICapture

Returns:

Captured sequence, or null by timeout.

Throws:

IOException

HarcHardwareException - if the device is not in valid/open state.

IrpMasterException

stopCapture

public boolean stopCapture()

Description copied from interface: ICapture

Signals the capturing device that it should stop capturing. May not be implemented in all hardware.

Specified by:

stopCapture in interface ICapture

Returns:

status

receive

public IrSequence receive()
                   throws HarcHardwareException,
                          IOException,
                          IrpMasterException

Description copied from interface: IReceive

Listens to the device and returns a sequence. Requires the device to be previously opened. Should itself neither open or close the device.

Specified by:

receive in interface IReceive

Returns:

Captured sequence, or null by timeout.

Throws:

HarcHardwareException - if the device is not in valid/open state.

IOException

IrpMasterException

stopReceive

public boolean stopReceive()

Description copied from interface: IReceive

Signals the receiving device that it should stop receiving. May not be implemented in all hardware.

Specified by:

stopReceive in interface IReceive

Returns:

status

reset

public void reset()
           throws IOException

Throws:

IOException

sendString

public void sendString(String cmd)
                throws IOException

Description copied from interface: ICommandLineDevice

Sends a command (a String) to the instance.

Specified by:

sendString in interface ICommandLineDevice

Parameters:

cmd - Command string to be sent.

Throws:

IOException

readString

public String readString()
                  throws IOException

Description copied from interface: ICommandLineDevice

Reads a line of text. A line is considered to be terminated by any one of a line feed ('\n'), a carriage return ('\r'), or a carriage return followed immediately by a linefeed.

Specified by:

readString in interface ICommandLineDevice

Returns:

A String containing the contents of the line, not including any line-termination characters, or null if no input available.

Throws:

IOException

readString

public String readString(boolean wait)
                  throws IOException

Description copied from interface: ICommandLineDevice

Reads a line of text. A line is considered to be terminated by any one of a line feed ('\n'), a carriage return ('\r'), or a carriage return followed immediately by a linefeed.

Specified by:

readString in interface ICommandLineDevice

Parameters:

wait - if true, wait until something arrives, otherwise return null if nothing there.

Returns:

A String containing the contents of the line, not including any line-termination characters, or null if no input available.

Throws:

IOException

ready

public boolean ready()
              throws IOException

Description copied from interface: ICommandLineDevice

Tells whether this stream is ready to be read. A buffered character stream is ready if the buffer is not empty, or if the underlying character stream is ready.

Specified by:

ready in interface ICommandLineDevice

Returns:

True if the next read() is guaranteed not to block for input, false otherwise. Note that returning false does not guarantee that the next read will block.

Throws:

IOException - If an I/O error occurs

flushInput

public void flushInput()
                throws IOException

Specified by:

flushInput in interface ICommandLineDevice

Throws:

IOException

getTransmitter

public Transmitter getTransmitter()

Description copied from interface: IRawIrSender

Returns a default Transmitter for the device. May be null if the device ignores the Transmitter argument in sendIr.

Specified by:

getTransmitter in interface IRawIrSender

Specified by:

getTransmitter in interface IRemoteCommandIrSender

Specified by:

getTransmitter in interface ITransmitter

Returns:

Transmitter

stopIr

public boolean stopIr(Transmitter transmitter)
               throws NoSuchTransmitterException,
                      IOException

Description copied from interface: IIrSenderStop

Stops ongoing IR transmission.

Specified by:

stopIr in interface IIrSenderStop

Returns:

if false, command failed.

Throws:

NoSuchTransmitterException

IOException

getTransmitter

public Transmitter getTransmitter(String connector)
                           throws NoSuchTransmitterException

Description copied from interface: ITransmitter

Parses the String argument, and returns a transmitter accordingly. Syntax and semantics may vary.

Specified by:

getTransmitter in interface ITransmitter

Parameters:

connector - String describing desired port. Syntax is dependent on the implementing class.

Returns:

Transmitter

Throws:

NoSuchTransmitterException

getTransmitterNames

public String[] getTransmitterNames()

Description copied from interface: ITransmitter

Return possible name of transmitters, that are guaranteed to work with the getTransmitter(String). This may be generated by inquiring the device, producing correct result, or it may be some static function, describing transmitters not necessarily present on the actually deployed device.

Specified by:

getTransmitterNames in interface ITransmitter

Returns:

Array of strings that are guaranteed to work with the getTransmitter(String)

sendIrRepeat

public boolean sendIrRepeat(IrSignal irSignal,
                            Transmitter transmitter)
                     throws NoSuchTransmitterException,
                            IOException,
                            IrpMasterException

Description copied from interface: IRawIrSenderRepeat

Like sendCcf, but continues the transmission until interrupted by a stopIr command. Particular implementations, or hardware, might limit the number of transmissions, though.

Specified by:

sendIrRepeat in interface IRawIrSenderRepeat

Returns:

if false, command failed.

Throws:

NoSuchTransmitterException

IOException

IrpMasterException

getRemotes

public String[] getRemotes()
                    throws IOException

Description copied from interface: IRemoteCommandIrSender

Returns an array of "remote" names.

Specified by:

getRemotes in interface IRemoteCommandIrSender

Returns:

Throws:

IOException

getCommands

public String[] getCommands(String remote)
                     throws IOException

Description copied from interface: IRemoteCommandIrSender

Returns an array of command names for the remote given in the argument.

Specified by:

getCommands in interface IRemoteCommandIrSender

Parameters:

remote - The "remote" to search in

Returns:

Throws:

IOException

sendIrCommand

public boolean sendIrCommand(String remote,
                             String command,
                             int count,
                             Transmitter transmitter)
                      throws IOException,
                             NoSuchTransmitterException

Description copied from interface: IRemoteCommandIrSender

Sends the command to the hardware, to be sent count number of times.

Specified by:

sendIrCommand in interface IRemoteCommandIrSender

count - Number of times to repeat the command

Returns:

success

Throws:

IOException

NoSuchTransmitterException

sendIrCommandRepeat

public boolean sendIrCommandRepeat(String remote,
                                   String command,
                                   Transmitter transmitter)
                            throws IOException,
                                   NoSuchTransmitterException

Description copied from interface: IRemoteCommandIrSender

Like sendIr, but sends the IR signal until stopped by stopIr. An implementation, or a hardware, may limit the number of repeats though.

Specified by:

sendIrCommandRepeat in interface IRemoteCommandIrSender

Returns:

Throws:

IOException

NoSuchTransmitterException

setLed

public void setLed(int led,
                   boolean state)
            throws IOException,
                   HarcHardwareException

Throws:

IOException

HarcHardwareException

setLed

public void setLed(int led,
                   int flashTime)

setLcd

public void setLcd(String message)
            throws IOException,
                   HarcHardwareException

Throws:

IOException

HarcHardwareException

setLcd

public void setLcd(String message,
                   int x,
                   int y)

setLcdBacklight

public void setLcdBacklight(boolean state)

setLcdBacklight

public void setLcdBacklight(int flashTime)