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

 /**
   *  註冊一個回調爲調頻接收機事件通知。
   *    <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;
       }

/**
   *    註銷客戶的事件通知回調。
   *    <p>
   *   這是一個同步調用用於註銷客戶的事件回調。
   *    <p>
   *    @return true always.
   *    @see  #acquire
   *    @see  #release
   *    @see  #registerClient
   *

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

/**
   *    註冊一個回調爲調頻發射機事件通知。
   *    <p>
   *    這是一個同步調用註冊用於事件通知的調頻發射機的司機。自調頻驅動異步執行一些任務,該功能容許客戶端異步接收信息。
   *    <p>
   *    在調用該函數時,客戶機必須經過一個回調函數用來實現異步事件。必須非空值參數的回調。若是一個NULL值傳遞給這個函數,註冊將會失敗。
   *    <p>
   *   客戶端能夠選擇哪些事件將從接收器發送司機只需實現事件但願接收的功能。
   *    <p>
   *    @param 回調事件回調處理事件的調頻發射機。
   *    @return true 若是回調註冊,假回調註冊失敗。
   *    @see #acquire
   *    @see #unregisterTransmitClient
   *
   */

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

/**
   *    註銷發射機事件通知回調。
   *    <p>
   *    這是一個同步調用用於註銷發射機客戶的事件回調。
   *    <p>
   *    @return true always.
   *
   *    @see  #acquire
   *    @see  #release
   *    @see  #registerTransmitClient
   *
   */

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

 /**
   *   禁用 FM .
   *    <p>
   *   這是一個同步調用用於禁用調頻裝置。時這個函數將使用客戶端再也不須要使用調頻裝置。曾稱,大多數調頻裝置提供的功能將被禁用,直到客戶端經過#設備再次啓用。
   *    <p>
   *    @return true if disabling succeeded, false if disabling
   *            failed.
   *    <p>
   *    @see   #enable
   *    @see   #registerClient
   */

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

/**
   *    從新配置設備的區域設置
   *    (FM Band, De-Emphasis, Channel Spacing, RDS/RBDS mode).
   *    <p>
   *  這是一個同步調用用於調頻設備上的配置設置。包含在結構經過設置一般不一樣於一個地理區域到另外一個地方。
   *    <p>
   *    @param configSettings    Contains settings for the FM radio
   *                             (FM band, De-emphasis, channel
   *                             spacing, RDS/RBDS mode)
   *    <p>
   *    @return      true if configure succeeded, false if
   *                 configure failed.
   */

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

/**
    *   音樂調頻設備指定的FM頻率。
    *    <p>
    *    這種方法音樂電臺的調頻裝置提供指定的頻率。惟一有效頻率帶內啓用或設定的配置能夠經過這個功能來調諧。試圖調整頻率集以外的樂隊將致使一個錯誤。
    *    <p>
    *   一旦完成調到指定的頻率,事件回調FmRxEvRadioTuneStatus將被調用。
    *
    *    @param frequencyKHz  Frequency (in kHz) to be tuned
    *                         (Example: 96500 = 96.5Mhz)
    *   @return true if setStation call was placed successfully,
    *           false if setStation failed.
    */

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

/**
    *    設置所需的WAN避免陷波濾波器。
    *    <p>
    *  這個方法設置所需的陷波濾波器基於當前WAN帶頻率達到FM-WAN併發性。應用程序應該聽數據調用事件和調用函數在每一個數據調用鏈接讓u,實現FM-WAN併發性。
    *
    */

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

/**
   *   不然返回true,若是成功,則返回false
   *    <p>
   *  該方法內部天線類型設置爲true / false
   *
   *    @param intAntenna true is 內部天線存在
   *
   *    <p>
   *    @return    true/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;
       }

 /**
   *  設置FM 電源狀態
   *
   *    <p>
   *   該方法集調頻電源狀態。

   *    <p>
   */

/**
   *    Returns :
   *
   *        FMOff        - If the FM Radio is turned off
   *        FMRxOn       - If the FM Receiver is currently turned on
   *        FMTxOn       - If the FM Transmitter is currently turned on
   *        FMReset      - If the FM Radio is reset
   *
   *    Gets the FM power state
   *
   *    <p>
   *    This method gets the FM power state.
   *
   *    <p>
   */

     public static int getFMPowerState()        {           return FMState;        }