Android FM模块学习之四源码分析（五）

      前几章我们分析了FM模块的几个主要的类文件，今天要分析的是：FMTransceiver.java

public class FmTransceiver
{
   /* Primary FM States :
    * FM will be in one of the 4 states at any point of time
    *    '0'  - FMState_Turned_Off
    *    '1'  - FMState_Rx_Turned_On
    *    '2'  - FMState_Tx_Turned_On
    *    '3'  - FMState_Srch_InProg
   */
<pre name="code" class="java">   public static final int FMState_Turned_Off   = 0;
   public static final int FMState_Rx_Turned_On = 1;
   public static final int FMState_Tx_Turned_On = 2;
   public static final int FMState_Srch_InProg  = 3;
           

/ *FM状态:

*FM 在任何时候都处于以下四种状态中的一种：

*“0”——FMState_Turned_Off

* ' 1 ' - FMState_Rx_Turned_On

* ' 2 ' - FMState_Tx_Turned_On

“3”——FMState_Srch_InProg

* /

/ * *

*允许访问V4L2 FM设备。

*这种同步调用允许客户端使用V4L2调频装置。这一定是第一次调用之前发布的客户端可以使用任何接收器接口。

*

*这也叫权力的调频模块。

*

* @param设备路径字符串,无线电设备

*

* @return真

如果V4L2调频设备了,假如果V4L2调频设备不能被收购,可能被其他客户

* @see #释放

*

* /

protected boolean acquire(String device){
      boolean bStatus = true;
      if (sFd <= 0) { // if previous open fails fd will be -ve.
         sFd = FmReceiverJNI.acquireFdNative(V4L2_DEVICE);

         if (sFd > 0) {
            Log.d(TAG, "Opened "+ sFd);
            bStatus = true;
         }
         else {
            Log.d(TAG, "Fail to Open "+ sFd);
	    bStatus = false;
         }
           

/ * *

*发布访问V4L2调频装置。

* < p >

这个同步调用允许客户端版本控制V4L2调频装置。 这个函数应该被称为调频装置时不再需要。 这应该是最后一次调频客户发行的调用。 一旦调用,客户端必须调用#acquire来重新请求 V4L2设备控制调频装置，可以再次使用。

* < p >

之前客户端可以释放控制调频接收机接口,它必须禁用调频接收器,如果客户端启用它,并注销注册的回调函数。 如果客户端接收方的所有权,它将自动返回到系统。

* < p >

*这也叫权力的调频模块。

* < p >

* @param无线电设备路径字符串,

* @return真 如果V4L2调频装置释放,假如果V4L2调频设备不能被释放

* @see #收购

* /

static boolean release(String device) {
      if (sFd!=0)
      {
         FmReceiverJNI.closeFdNative(sFd);
         sFd = 0;
         Log.d("FmTransceiver", "Turned off: " + sFd);
      } else
      {
         Log.d("FmTransceiver", "Error turning off");
      }
      return true;
   }
           

public boolean registerClient(FmRxEvCallbacks callback){
      boolean bReturnStatus = false;
      if (callback!=null)
      {
         mRxEvents.startListner(sFd, callback);
         bReturnStatus = true;
      } else
      {
         Log.d(TAG, "Null, do nothing");
      }
      return bReturnStatus;
   }
           

/**

   *    注销客户的事件通知回调。

   *    <p>

   *   这是一个同步调用用于注销客户的事件回调。

   *    <p>

   *    @return true always.

   *    @see  #acquire

   *    @see  #release

   *    @see  #registerClient

   *

public boolean unregisterClient () {
      mRxEvents.stopListener();
      return true;
   }
           

public boolean registerTransmitClient( FmTransmitterCallbacks callback){
      boolean bReturnStatus = false;
      if (callback!=null)
      {
         mTxEvents.startListner(sFd, callback);
         bReturnStatus = true;
      } else
      {
         Log.d(TAG, "Null, do nothing");
      }
      return bReturnStatus;
   }
           

public boolean unregisterTransmitClient () {
      mTxEvents.stopListener();
      return true;
   }
           

public boolean enable (FmConfig configSettings, int device){

      boolean status;
      //Acquire the deviceon Enable
      if( !acquire("/dev/radio0")){
         return false;
      }
      Log.d(TAG, "turning on " + device);
      mControl.fmOn(sFd, device);

      Log.d(TAG, "Calling fmConfigure");
      status = FmConfig.fmConfigure (sFd, configSettings);
      if (!status) {
          Log.d(TAG, "fmConfigure failed");
          FmReceiverJNI.closeFdNative(sFd);
          sFd = 0;
      }
      return status;
   }
           

public boolean disable(){
      mControl.fmOff(sFd);
      return true;
   }
           

public boolean configure(FmConfig configSettings){
      boolean status=true;
      int lowerFreq = configSettings.getLowerLimit();
      Log.d(TAG, "fmConfigure");
      status = FmConfig.fmConfigure (sFd, configSettings);
      status = setStation (lowerFreq);
      return status;
   }
           

public boolean setStation (int frequencyKHz) {
      int ret;

      mControl.setFreq(frequencyKHz);
      ret = mControl.setStation(sFd);
      if(ret < 0 )
      {
         return false;
      }
      else
      {
         return true;
      }
   }
           

public void setNotchFilter(boolean value) {
	FmReceiverJNI.setNotchFilterNative(sFd, V4L2_CID_PRIVATE_TAVARUA_SET_NOTCH_FILTER, value);
   }
           

public boolean setAnalogMode(boolean value) {
        int re = mControl.setAudioPath(sFd, value);
        re = FmReceiverJNI.setAnalogModeNative(value);
        if (re == 1)
            return true;
        return false;
   }
           

public boolean getInternalAntenna()
   {

       int re = FmReceiverJNI.getControlNative (sFd, V4L2_CID_PRIVATE_TAVARUA_ANTENNA);

       if (re == 1)
         return true;

       return false;
   }
           

public boolean setInternalAntenna(boolean intAnt)
   {

       int iAntenna ;

       if (intAnt)
          iAntenna = 1;
       else
          iAntenna = 0;


       int re = FmReceiverJNI.setControlNative (sFd, V4L2_CID_PRIVATE_TAVARUA_ANTENNA, iAntenna);

       if (re == 0)
         return true;

       return false;
   }
           

static void setFMPowerState(int state)
   {
      FMState = state;
   }
           

public static int getFMPowerState()
   {
      return FMState;
   }