前几章我们分析了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真

* @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 >

* < 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;
   }

 /**
   *  注册一个回调为调频接收机事件通知。
   *    <p>
   *   这是一个同步调用注册用于调频接收机的事件通知司机。自调频驱动异步执行一些任务,该功能允许客户端异步接收信息。
   *    <p>
   *   在调用该函数时,客户机必须通过一个回调函数用来实现异步事件。必须非空值参数的回调。如果一个NULL值传递给这个函数,注册将会失败。
   *    <p>
   *    客户端可以选择哪些事件将从接收器发送司机只需实现事件希望接收的功能。
   *    <p>
 @param回调事件回调处理事件的调频接收机。
@return真如果回调注册,假如果回调注册失败了。
@see #acquire
@see # unregisterClient
   *
   */

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;
   }

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;
   }

/**
   *   初始化 FM .
   *    <p>
   *  这是一个同步调用用于初始化调频tranceiver。如果已经初始化该函数将intialize tranceiver默认设置。只有在成功地调用这个函数的许多调频设备接口可以使用。
   *    <p>
   *    使接收者时,客户机还必须提供的区域设置接收器将运作。这些设置(包括在configSettings)通常用于设置调频接收机操作在一个特定的地理区域。这些设置可以更改后启用调频驱动程序通过使用#配置功能。
   *    <p>
   *    这个电话只能出具一个调频接收器的所有者。发行这个调用,客户机必须首先成功地调用#qcquire。
   *    <p>
   *    @param configSettings  the settings to be applied when
   *                             turning on the radio
   *    @return true if Initialization succeeded, false if
   *            Initialization failed.
   *    @see   #registerClient
   *    @see   #disable
   *
   */

 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);
   }

 /**
    *   启用/禁用模拟低电力模式。
    *    <p>
    *   这种方法启用/禁用模拟低电力模式。
    *
    */

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

 /**
   *  返回true,如果内部调频天线
   *
   *    <p>
   *   该方法返回true内部FM天线可用,否则假
   *    <p>
   *    @return    true/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;
   }

   *    <p>
   */

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

 public static int getFMPowerState()
   {
      return FMState;
   }

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