A n d r o i d 中 添 加 A T 命 令 流 程

本文假設讀者已經瞭解RIL的基本知識 從上層出發，在 
frameworks/base/telephony/java/com/android/internal/telephony/Phone.java中 添加所要發AT命令的上層函數。  
Phone是個接口，因此，添加完後，得在實現Phone接口的java類裏面實現這個方法，實現Phone的類即GSMPhone.java 位於 
frameworks/base/telephony/java/com/android/internal/telephony/gsm/GSMPhone.java  
在這裏，調用CommandInterface裏面的方法， 因此， 我們還得在CommandInterface裏面把我們要增加的方法添加進去 

同樣的，CommandInterface也是個接口，而實現這個接口的類有2個：

1. frameworks/base/telephony/java/com/android/internal/telephony/gsm/RIL.java 

2. frameworks/base/telephony/java/com/android/internal/telephony/test/SimulatedCommands.java  

其中第2個是在模擬器裏面測試用的， 我們只需要在裏面把方法添加進去，然後調用個resultSuccess或者umimplement都可以。 而第1個纔是真正到達GSM驅動的類。 
所以，我們得在RIL.java中，實現上層與下層的通信。  
在RIL.java的方法裏面，只需要定義好你所需要發送AT命令的一個標識MARK（下面還會提到）， 再把RilRequest類裏面的Parcel成員mp賦值， 然後發送出去即可。 
賦給mp的值，即爲我們需要發送到下層去處理的值， 例如傳個數組下去， 一般都先把長度寫進去， 其次再把成員依次寫入。  
=============================================================================================== 接下來，便是下層的添加過程。 
1。 hardware/ril/include/telephony/ril.h 
在此文件中，添加一個標識你所要處理的AT命令的宏， 即上面所說到的MARK， 注意不要和別的宏發生衝突。 
注意： 這裏的MARK必須定義在最後面， 不然會帶來不必要的麻煩， 理由如下：  
在ril.h中定義了每個關鍵字對應的值，同時在ril_command.h有張映射表 而且是按ril.h中的順序映射的，大家可以看作是數組的下標。 
這裏要一一對應，如果從中間插入，將會導致後面的字段映射不對。     除非把ril.h中關鍵字對應的值修改，但這樣會浪費比較多的時間。  
2。 hardware/ril/libril/ril.cpp 

在該文件的const char *requestToString(int request)函數裏面添加消息映射字符串。

3。  hardware/ril/libril/ril_commands.h 

在該文件的最後添加函數映射表， 形如{MARK, dispatch<type>, response<type>} 解釋如下： 
    

首先第1個參數即爲我們之前所定義的標識，即MARK。 第2個參數是下層的從數據流中解出數據的函數，這裏要和上層所傳下來的類型對應，例如上層傳下來的是int數組，這裏也得是dispathInts， 否則數據會出錯 
第3個參數是該函數所要返回的值， 這裏的<type>和第2個參數的一樣。  
4。 hardware/ril/reference-ril/reference-ril.c 這裏就是發AT命令的核心文件，在static void onRequest (int request, void *data, size_t datalen, RIL_Token t)裏面添加我們所要處理的AT命令函數。 
照着別人寫的， 自己加以修改就可以了。這裏對2個發送AT命令的函數進行說明下： 一般來說， 都是這樣的，對只返回成功與否的AT命令，我們用at_send_command()。 而對於有返回值的命令，我們用at_send_command_singleline()。  
====================================================================================================== 最後回到上層的RIL.java中，在processUnsolicited()或者processSolicited()裏面添加返回值即可。 
這裏我們只選擇其中一個來處理，在processUnsolicited()是處理主動上報類型的命令的，即不需要你發送命令去查詢的類型。 而processSolicited()則是需要通過發送命令纔會返回結果的類型。 
大家只要看看那函數裏面的值是如何返回的即可， 注意我們選用的返回函數，得和我們在ril_command.h裏面所添加的函數映射表裏的返回函數對應。  
到了這裏，AT命令的過程就添加結束， 命令的返回值就在調用Phone裏面的函數所傳入的Message中。 返回的是一個AsyncResult， 就是Message的obj成員 。 
這裏我們可以處理異常，一般可通過如下代碼處理(假設傳入的Message爲msg)： AsyncResult ar = (AsyncResult)msg.obj  if (ar.exception != null) 處理異常 處理結果，就對ar.result進行處理。