/*

* Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).

* All rights reserved.

* This component and the accompanying materials are made available

* under the terms of "Eclipse Public License v1.0"

* which accompanies this distribution, and is available

* at the URL "http://www.eclipse.org/legal/epl-v10.html".

*

* Initial Contributors:

* Nokia Corporation - initial contribution.

*

* Contributors:

*

* Description:

*

*/

package javax.microedition.amms.control.tuner;

import javax.microedition.media.MediaException;

import javax.microedition.media.Control;

/**

 * 

 * Please refer to JSR 234 for more details.

 */

public interface TunerControl extends Control

{

    /**

     * Please refer to JSR 234 for more details.

     */

    public static final int MONO = 1;

    /**

     * Please refer to JSR 234 for more details.

     */

    public static final int STEREO = 2;

    /**

     * Please refer to JSR 234 for more details.

     */

    public static final int AUTO = 3;

    /**

     * Please refer to JSR 234 for more details.

     */

    public static final String MODULATION_FM = "fm";

    /**

     * Please refer to JSR 234 for more details.

     */

    public static final String MODULATION_AM = "am";

    /**

     * Please refer to JSR 234 for more details.

     */

    public int getMinFreq(String modulation);

    /**

     * Please refer to JSR 234 for more details.

     */

    public int getMaxFreq(String modulation);

    /**

     * Please refer to JSR 234 for more details.

     */

    public int setFrequency(int freq, String modulation);

    /**

     * Please refer to JSR 234 for more details.

     */

    public int getFrequency();

    /**

     * Please refer to JSR 234 for more details.

     */

    public int seek(int startFreq, String modulation, boolean upwards) throws MediaException;

    /**

     * Please refer to JSR 234 for more details.

     */

    public boolean getSquelch();

    /**

     * Please refer to JSR 234 for more details.

     */

    public void setSquelch(boolean squelch) throws MediaException;

    /**

     * Please refer to JSR 234 for more details.

     */

    public String getModulation();

    /**

     * Please refer to JSR 234 for more details.

     */

    public int getSignalStrength() throws MediaException;

    /**

     * Please refer to JSR 234 for more details.

     */

    public int getStereoMode();

    /**

     * Please refer to JSR 234 for more details.

     */

    public void setStereoMode(int mode);

    /**

     * Please refer to JSR 234 for more details.

     */

    public int getNumberOfPresets();

    /**

     * Please refer to JSR 234 for more details.

     */

    public void usePreset(int preset);

    /**

     * Please refer to JSR 234 for more details.

     */

    public void setPreset(int preset);

    /**

     * Please refer to JSR 234 for more details.

     */

    public void setPreset(int preset, int freq, String mod, int stereoMode);

    /**

     * Please refer to JSR 234 for more details.

     */

    public int getPresetFrequency(int preset);

    /**

     * Please refer to JSR 234 for more details.

     */

    public String getPresetModulation(int preset);

    /**

     * Please refer to JSR 234 for more details.

     */

    public int getPresetStereoMode(int preset) throws MediaException;

    /**

     * Please refer to JSR 234 for more details.

     */

    public String getPresetName(int preset);

    /**

     * Please refer to JSR 234 for more details.

     */

    public void setPresetName(int preset, String name);

}