org.harctoolbox.harchardware.ir

Class Arduino

java.lang.Object

org.harctoolbox.harchardware.ir.IrSerial<LocalSerialPortBuffered>

org.harctoolbox.harchardware.ir.Arduino

All Implemented Interfaces:

Closeable, AutoCloseable, IHarcHardware, ICapture, IRawIrSender, IReceive, IStringCommand

public class Arduino
extends IrSerial<LocalSerialPortBuffered>
implements IRawIrSender, ICapture, IReceive, IStringCommand

This class supports sending and capturing from an Arduino connected through a (virtual) serial port. For sending, the sketch scrutinize_sender should be running, for receiving the sketch scrutinize_receiver.

Field Summary

Fields

Modifier and Type	Field and Description
static int	defaultBaudRate
static String	defaultPortName
static String	okString

Fields inherited from class org.harctoolbox.harchardware.ir.IrSerial

debug, serialPort, verbose

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

repeatMax

Constructor Summary

Constructors

Constructor and Description
Arduino()
Arduino(String portName)
Arduino(String portName, int baudRate, boolean verbose)
Arduino(String portName, int baudRate, int beginTimeout, boolean verbose)
Arduino(String portName, int beginTimeout, int middleTimeout, int endingTimeout, boolean verbose)
Arduino(String portName, int baudRate, int beginTimeout, int middleTimeout, int endingTimeout, boolean verbose)

Method Summary

Modifier and Type	Method and Description
ModulatedIrSequence	capture() Listens to the device and returns a sequence.
String	getVersion() Returns the hardware version (not the version of the driver software).
static void	main(String[] args)
void	open() Opens the device with previously set parameters.
String	readString() Reads a line of text.
String	readString(boolean wait)
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)
void	sendString(String cmd)
void	setFallbackFrequency(double fallbackFrequency)
void	setLineEnding(String lineEnding)
void	setTimeout(int beginTimeout, int middleTimeout, int endingTimeout)
boolean	stopCapture() Signals the capturing device that it should stop capturing.
boolean	stopReceive() Signals the receiving device that it should stop receiving.

Methods inherited from class org.harctoolbox.harchardware.ir.IrSerial

close, getTransmitter, isValid, setBaudRate, setDataSize, setDebug, setFlowControl, setParity, setPortName, setStopBits, setTimeout, setVerbosity

Methods inherited from class java.lang.Object

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

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

getTransmitter

Methods inherited from interface org.harctoolbox.harchardware.ir.IReceive

setTimeout

Methods inherited from interface org.harctoolbox.harchardware.IHarcHardware

isValid, setDebug, setVerbosity

Methods inherited from interface java.io.Closeable

close

Field Detail

defaultPortName

public static final String defaultPortName

See Also:

Constant Field Values

okString

public static final String okString

See Also:

Constant Field Values

defaultBaudRate

public static final int defaultBaudRate

See Also:

Constant Field Values

Constructor Detail

Arduino

public Arduino()
        throws gnu.io.NoSuchPortException,
               gnu.io.PortInUseException,
               gnu.io.UnsupportedCommOperationException,
               IOException

Throws:

gnu.io.NoSuchPortException

gnu.io.PortInUseException

gnu.io.UnsupportedCommOperationException

IOException

Arduino

public Arduino(String portName)
        throws gnu.io.NoSuchPortException,
               gnu.io.PortInUseException,
               gnu.io.UnsupportedCommOperationException,
               IOException

Throws:

gnu.io.NoSuchPortException

gnu.io.PortInUseException

gnu.io.UnsupportedCommOperationException

IOException

Arduino

public Arduino(String portName,
               int baudRate,
               boolean verbose)
        throws gnu.io.NoSuchPortException,
               gnu.io.PortInUseException,
               gnu.io.UnsupportedCommOperationException,
               IOException

Throws:

gnu.io.NoSuchPortException

gnu.io.PortInUseException

gnu.io.UnsupportedCommOperationException

IOException

Arduino

public Arduino(String portName,
               int baudRate,
               int beginTimeout,
               boolean verbose)
        throws gnu.io.NoSuchPortException,
               gnu.io.PortInUseException,
               gnu.io.UnsupportedCommOperationException,
               IOException

Throws:

gnu.io.NoSuchPortException

gnu.io.PortInUseException

gnu.io.UnsupportedCommOperationException

IOException

Arduino

public Arduino(String portName,
               int beginTimeout,
               int middleTimeout,
               int endingTimeout,
               boolean verbose)
        throws gnu.io.NoSuchPortException,
               gnu.io.PortInUseException,
               gnu.io.UnsupportedCommOperationException,
               IOException

Throws:

gnu.io.NoSuchPortException

gnu.io.PortInUseException

gnu.io.UnsupportedCommOperationException

IOException

Arduino

public Arduino(String portName,
               int baudRate,
               int beginTimeout,
               int middleTimeout,
               int endingTimeout,
               boolean verbose)
        throws gnu.io.NoSuchPortException,
               gnu.io.PortInUseException,
               gnu.io.UnsupportedCommOperationException,
               IOException

Throws:

gnu.io.NoSuchPortException

gnu.io.PortInUseException

gnu.io.UnsupportedCommOperationException

IOException

Method Detail

setLineEnding

public void setLineEnding(String lineEnding)

Parameters:

lineEnding - the lineEnding to set

setFallbackFrequency

public void setFallbackFrequency(double 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

Overrides:

open in class IrSerial<LocalSerialPortBuffered>

Throws:

IOException

HarcHardwareException

getVersion

public String getVersion()

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

Overrides:

getVersion in class IrSerial<LocalSerialPortBuffered>

Returns:

Version string. Semantics can vary.

capture

public ModulatedIrSequence capture()
                            throws IOException,
                                   HarcHardwareException

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.

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

setTimeout

public void setTimeout(int beginTimeout,
                       int middleTimeout,
                       int endingTimeout)
                throws IOException

Specified by:

setTimeout in interface ICapture

Throws:

IOException

reset

public void reset()

main

public static void main(String[] args)

Parameters:

args - the command line arguments

sendString

public void sendString(String cmd)
                throws IOException

Specified by:

sendString in interface IStringCommand

Throws:

IOException

readString

public String readString()
                  throws IOException

Description copied from interface: IStringCommand

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 IStringCommand

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

Throws:

IOException

ready

public boolean ready()
              throws IOException

Description copied from interface: IStringCommand

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 IStringCommand

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