org.harctoolbox.harchardware.ir.IReceive Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of HarcHardware Show documentation

Helper functions for accessing hardware etc.

There is a newer version: 2.4.1

/*
Copyright (C) 2014 Bengt Martensson.

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 3 of the License, or (at
your option) any later version.

This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.

You should have received a copy of the GNU General Public License along with
this program. If not, see http://www.gnu.org/licenses/.
*/

package org.harctoolbox.harchardware.ir;

import java.io.IOException;
import org.harctoolbox.harchardware.HarcHardwareException;
import org.harctoolbox.ircore.IrSequence;
import org.harctoolbox.ircore.OddSequenceLengthException;

/**
 * This hardware can receive an IR signal for deployment.
 * It does not return a modulation frequency, and normally uses demodulating hardware.
 */
public interface IReceive extends IIrReader {

    /**
     * Listens to the device and returns a sequence.
     * Requires the device to be previously opened.
     * Should itself neither open or close the device.
     * @return Captured sequence, or null by timeout.
     * @throws HarcHardwareException if the device is not in valid/open state.
     * @throws IOException
     * @throws org.harctoolbox.ircore.OddSequenceLengthException
     */
    public IrSequence receive() throws HarcHardwareException, IOException, OddSequenceLengthException;

    /**
     * Signals the receiving device that it should stop receiving.
     * May not be implemented in all hardware.
     * @return status
     */
    public boolean stopReceive();
}