歡迎來到Linux教程網
設為首頁 加入收藏
Linux教程網
Linux教程網
Linux教程網
Linux教程網 >> Linux編程 >> Linux編程 >> Android RIL源碼研究筆記 の ril_command (一)

Android RIL源碼研究筆記 の ril_command (一)

日期：2017/3/1 10:50:25   编辑：Linux編程
Android源碼目錄hardware/ril/libril中總共包含5個C/CPP文件，它們分別是ril_commands.h、ril_unsol_commands.h、ril_event.h、ril_event.cpp和ril.cpp。這篇文章主要分析commands相關的兩個頭文件，這兩個文件主要定義了所有telephony可以接收的命令或者響應的事件類型，以及相應的處理函數。

進行源碼分析前，我們必須先知道目前主流智能手機的硬件架構中有兩個處理器，一個稱為Application Processor（AP），主要用於運行操作系統，執行應用程序；一個稱為Baseband Processor（BP），專門負責手機中和射頻無線通信相關的功能。AP和BP芯片間通信基於串口，通信協議是廣泛使用的AT指令。

接著來了解下RIL中的兩種Response類型：

一是Solicited Response（經過請求的回復），應用的場景是AP主動向BP發送一個AT指令，請求BP進行相應處理並在處理結束時回復一個AT指令通知AP執行的結果。源碼中對應的文件是ril_commands.h。

一是Unsolicited Response（未經請求的回復），應用場景是BP主動向AP發送AT指令，用於通知AP當前系統發生的與Telephony相關的事件，例如網絡信號變化，有電話呼入等。源碼中對應的文件是ril_unsol_commands.h。

首先當然先看下ril_commands.h文件:

  1. // 每一列分別對應：
  2. // BP接收的請求 - BP對請求的處理函數 - AP對返回結果的處理函數
  3. {0, NULL, NULL}, //none
  5. // #define RIL_REQUEST_GET_SIM_STATUS 1(in ril.h)
  6. // 獲取SIM接口和SIM卡的狀態，傳入參數"data"是NULL
  7. // 響應函數"response"是const RIL_CardStatus *
  8. // 有效的返回碼：無，該函數必須保證成功調用
  9. {RIL_REQUEST_GET_SIM_STATUS, dispatchVoid, responseSimStatus},
  11. // #define RIL_REQUEST_ENTER_SIM_PIN 2
  12. // 請求pin碼的輸入，"data"是const char**
  13. // 其中((const char**)data)[0]是pin碼
  14. // "response"是int*，其中((int*)response)[0]是剩余可輸入次數
  15. // 有效的返回碼：SUCCESS/RADIO_NOT_AVAILABLE/GENERIC_FAILURE/PASSWORD_INCORRECT
  16. {RIL_REQUEST_ENTER_SIM_PIN, dispatchStrings, responseInts},
  18. // #define RIL_REQUEST_ENTER_SIM_PUK 3
  19. // 請求PUK碼和新的PIN碼的輸入，"data"是const char**
  20. // 其中((const char**)data)[0]是PUK碼，((const char**)data)[1]是新的PIN碼
  21. // "response"是int*，其中((int*)response)[0]是剩余可輸入次數
  22. // 有效的返回碼：SUCCESS/RADIO_NOT_AVAILABLE/GENERIC_FAILURE/PASSWORD_INCORRECT
  23. {RIL_REQUEST_ENTER_SIM_PUK, dispatchStrings, responseInts},
  25. // #define RIL_REQUEST_ENTER_SIM_PIN2 4
  26. // 請求PIN2碼的輸入，"data"是const char**
  27. // 其中((const char**)data)[0]是pin2碼
  28. // "response"是int*，其中((int*)response)[0]是剩余可輸入次數
  29. // 有效的返回碼：SUCCESS/RADIO_NOT_AVAILABLE/GENERIC_FAILURE/PASSWORD_INCORRECT
  30. {RIL_REQUEST_ENTER_SIM_PIN2, dispatchStrings, responseInts},
  32. // #define RIL_REQUEST_ENTER_SIM_PUK2 5
  33. // 請求PUK2碼和新的PIN2碼的輸入，"data"是const char**
  34. // 其中((const char**)data)[0]是PUK2碼，((const char**)data)[1]是新的PIN2碼
  35. // "response"是int*，其中((int*)response)[0]是剩余可輸入次數
  36. // 有效的返回碼：SUCCESS/RADIO_NOT_AVAILABLE/GENERIC_FAILURE/PASSWORD_INCORRECT
  37. {RIL_REQUEST_ENTER_SIM_PUK2, dispatchStrings, responseInts},
  39. // #define RIL_REQUEST_CHANGE_SIM_PIN 6
  40. // 請求更改PIN碼，"data"是const char**
  41. // 其中，((const char**)data)[0]是舊PIN碼，((const char**)data)[1]是新PIN碼
  42. // "response"是int*，其中((int*)response)[0]是剩余可輸入次數
  43. // 有效的返回碼：SUCCESS/RADIO_NOT_AVAILABLE/GENERIC_FAILURE/PASSWORD_INCORRECT
  44. {RIL_REQUEST_CHANGE_SIM_PIN, dispatchStrings, responseInts},
  46. // #define RIL_REQUEST_CHANGE_SIM_PIN2 7
  47. // 請求更改PIN2碼，"data"是const char**
  48. // 其中，((const char**)data)[0]是舊PIN2碼，((const char**)data)[1]是新PIN2碼
  49. // "response"是int*，其中((int*)response)[0]是剩余可輸入次數
  50. // 有效的返回碼：SUCCESS/RADIO_NOT_AVAILABLE/GENERIC_FAILURE/PASSWORD_INCORRECT
  51. {RIL_REQUEST_CHANGE_SIM_PIN2, dispatchStrings, responseInts},
  53. // #define RIL_REQUEST_ENTER_NETWORK_DEPERSONALIZATION 8
  54. // 請求輸入網絡個人碼以便去激活，"data"是const char**
  55. // 其中，((const char**)data))[0]是網絡個人碼
  56. // "Response"是int*，((int*)response)[0]是剩余可輸入次數
  57. // 有效返回碼是：SUCCESS/RADIO_NOT_AVAILABLE/GENERIC_FAILURE/PASSWORD_INCORRECT
  58. {RIL_REQUEST_ENTER_NETWORK_DEPERSONALIZATION, dispatchStrings, responseInts},
  60. // #define RIL_REQUEST_GET_CURRENT_CALLS 9
  61. // 請求獲取當前呼叫列表，"data"是NULL
  62. // "response"類型必須是const RIL_Call **
  63. // 有效返回碼是：SUCCESS/RADIO_NOT_AVAILABLE/GENERIC_FAILURE
  64. {RIL_REQUEST_GET_CURRENT_CALLS, dispatchVoid, responseCallList},
  66. // #define RIL_REQUEST_DIAL 10
  67. // 初始化一個語音呼叫，"data"是const RIL_Dial*類型
  68. // "response"是NULL
  69. // 有效返回碼是：SUCCESS/RADIO_NOT_AVAILABLE/GENERIC_FAILURE
  70. {RIL_REQUEST_DIAL, dispatchDial, responseVoid},
  72. // #define RIL_REQUEST_GET_IMSI 11
  73. // 獲取SIM卡中的國際移動用戶識別碼IMSI，只在RADIO_STATE_SIM_READY時可用
  74. // "data"是NULL，"response"是包含IMSI的const char*類型
  75. // 有效返回碼是：SUCCESS/RADIO_NOT_AVAILABLE/GENERIC_FAILURE
  76. {RIL_REQUEST_GET_IMSI, dispatchVoid, responseString},
  78. // #define RIL_REQUEST_HANGUP 12
  79. // 掛斷某一激活的通話，類似AT指令：AT+CHLD=1x；在HANDUP請求返回時，RIL將在
  80. // 下一次RIL_REQUEST_GET_CURRENT_CALLS請求時，顯示這個連接不可用
  81. // "data"是int*，其中((int*)data)[0]包含連接的索引，即上面CHLD中的x值
  82. // "response"是NULL
  83. // 有效返回碼是：SUCCESS/RADIO_NOT_AVAILABLE/GENERIC_FAILURE
  84. {RIL_REQUEST_HANGUP, dispatchInts, responseVoid},
  86. // #define RIL_REQUEST_HANGUP_WAITING_OR_BACKGROUND 13
  87. // 掛斷所有等待的或者保持的通話，類似AT指令：AT+CHLD=0；在HANDUP請求返回時，
  88. // RIL將在下一次RIL_REQUEST_GET_CURRENT_CALLS請求時，顯示這個連接不可用
  89. // "data"和"response"都是NULL
  90. // 有效返回碼是：SUCCESS/RADIO_NOT_AVAILABLE/GENERIC_FAILURE
  91. {RIL_REQUEST_HANGUP_WAITING_OR_BACKGROUND, dispatchVoid, responseVoid},
  93. // #define RIL_REQUEST_HANGUP_FOREGROUND_RESUME_BACKGROUND 14
  94. // 釋放所有激活的通話並激活保持的或者等待的通話，類似AT指令：AT+CHLD=1
  95. // 在HANDUP請求返回時
  96. // RIL將在下一次RIL_REQUEST_GET_CURRENT_CALLS請求時，顯示這個連接不可用
  97. // "data"和"response"都是NULL
  98. // 有效返回碼是：SUCCESS/RADIO_NOT_AVAILABLE/GENERIC_FAILURE
  99. {RIL_REQUEST_HANGUP_FOREGROUND_RESUME_BACKGROUND, dispatchVoid, responseVoid},
  101. // #define RIL_REQUEST_SWITCH_WAITING_OR_HOLDING_AND_ACTIVE 15
  102. // 通話連接狀態的轉換，將所有激活的通話轉為保持或等待狀態，或者將保持或等待的
  103. // 通話轉為激活狀態，類似AT指令：AT+CHLD=2
  104. // 狀態的轉換有以下幾種，假設通話1處於等待態，通話處於是激活態
  105. // 轉換前 轉換後
  106. // 通話1 通話2 通話1 通話2
  107. // ACTIVE HOLDING HOLDING ACTIVE
  108. // ACTIVE WAITING HOLDING ACTIVE
  109. // HOLDING WAITING HOLDING ACTIVE
  110. // ACTIVE IDLE HOLDING IDLE
  111. // IDLE IDLE IDLE IDLE
  112. // "data"和"response"都是NULL
  113. // 有效返回碼是：SUCCESS/RADIO_NOT_AVAILABLE/GENERIC_FAILURE
  114. {RIL_REQUEST_SWITCH_WAITING_OR_HOLDING_AND_ACTIVE, dispatchVoid, responseVoid},
  116. // #define RIL_REQUEST_CONFERENCE 16
  117. // 請求加入電話會議，類似AT指令：AT+CHLD=3
  118. // "data"和"response"都是NULL
  119. // 有效返回碼是：SUCCESS/RADIO_NOT_AVAILABLE/GENERIC_FAILURE
  120. {RIL__CONFERENCE, dispatchVoid, responseVoid},
  122. // #define RIL_REQUEST_UDUB 17
  123. // 發送用戶確定用戶忙UDUB（user determined user busy）信號
  124. // "data"和"response"都是NULL
  125. // 有效返回碼是：SUCCESS/RADIO_NOT_AVAILABLE/GENERIC_FAILURE
  126. {RIL_REQUEST_UDUB, dispatchVoid, responseVoid},
  128. // #define RIL_REQUEST_LAST_CALL_FAIL_CAUSE 18
  129. // 請求最近一次通話中斷的錯誤碼，"data"是NULL，"response"是int*
  130. // ((int*)response)[0]是RIL_LastCallFailCause類型。
  131. // 有效返回碼是：SUCCESS/RADIO_NOT_AVAILABLE/GENERIC_FAILURE
  132. {RIL_REQUEST_LAST_CALL_FAIL_CAUSE, dispatchVoid, responseInts},
  134. // #define RIL_REQUEST_SIGNAL_STRENGTH 19
  135. // 請求當前的信號強度等相關信息，當天線打開時必須返回成功
  136. // "data"是NULL，"response"是const RIL_SignalStrength
  137. // 有效返回碼是：SUCCESS/RADIO_NOT_AVAILABLE
  138. {RIL_REQUEST_SIGNAL_STRENGTH, dispatchVoid, responseRilSignalStrength},
  140. // #define RIL_REQUEST_REGISTRATION_STATE 20
  141. // 請求當前的注冊狀態，"data"是NULL，"response"是const char**類型
  142. // ((const char **)response)[0]表示注冊狀態，取值如下：
  143. // 0 - 未注冊，移動終端MT當前沒有搜索新的運營商去注冊
  144. // 1 - 已注冊，本地網絡
  145. // 2 - 未注冊，移動終端MT當前正在搜索新的運營商去注冊
  146. // 3 - 拒絕注冊
  147. // 4 - 未知
  148. // 5 - 已注冊，漫游
  149. // 10 - 類似0，但指示緊急呼叫使能
  150. // 12 - 類似2，但指示緊急呼叫使能
  151. // 13 - 類似3，但指示緊急呼叫使能
  152. // 14 - 類似4，但指示緊急呼叫使能
  153. // ((const char **)response)[1]，如果注冊在GSM/WCDMA網絡上，則表示LAC，
  154. // 否則是NULL，有效的LAC值是0x0000 -- 0xffff
  155. // ((const char **)response)[2]，如果注冊在GSM/WCDMA網絡上，表示CID，
  156. // 否則是NULL，有效的CID值是0x00000000 -- 0xffffffff
  157. // GSM網絡中，CID指Cell ID，以16bits表示
  158. // UMTS網絡中（3G網絡），CID指UMTS Cell Identity，以28bits表示
  159. // ((const char **)response)[3]，指示可用的無線技術：
  160. // 0 - Unknown, 1 - GPRS, 2 - EDGE, 3 - UMTS, 4 - IS95A, 5 - IS95B
  161. // 6 - 1xRTT, 7 - EvDo Rev.0, 8 - EvDo Rev.A, 9 - HSDPA, 10 - HSUPA
  162. // 11 - HSPA, 12 - EVDO Rev B
  163. // ((const char **)response)[4]，CDMA網絡中表示基站ID，否則為NULL
  164. // 基站ID是十進制表示的
  165. // ((const char **)response)[5]，CDMA網絡中表示基站緯度，否則為NULL
  166. // ((const char **)response)[6]，CDMA網絡中表示基站經度，否則為NULL
  167. // ((const char **)response)[7]，CDMA網絡中表示是否支持並發服務
  168. // 0 - 不支持，1 - 支持
  169. // ((const char **)response)[8]，CDMA網絡中表示系統ID，否則為NULL
  170. // 取值范圍是0 - 32767
  171. // ((const char **)response)[9]，CDMA網絡中表示網絡ID，否則為NULL
  172. // 取值范圍是0 - 65535
  173. // ((const char **)response)[10]，CDMA和EVDO網絡中表示TSB-58漫游指示符
  174. // 否則為NULL，有效值是0 - 255
  175. // ((const char **)response)[11]，CDMA和EVDO網絡中表示當前系統是否在PRL中
  176. // 否則為NULL，0 - 不在，1 - 在
  177. // ((const char **)response)[12]，CDMA和EVDO網絡中表示默認的TSB-58漫游指示符
  178. // 否則為NULL，有效值是0 - 255
  179. // ((const char **)response)[13]，如果注冊狀態是3（拒絕注冊），這個值表示拒絕的
  180. // 原因，取值如下：0 - 一般，1 - 認證失敗，2 - IMSI在HLR中是未知的，3 - 非法MS，// 4 - 非法ME，5 - PLMN不允許，6 - 本地網絡不允許，7 - 漫游不允許，
  181. // 8 - 本地網絡沒有可用的蜂窩站點，9 - 網絡失效，10 - 持續定位更新拒絕// ((const char **)response)[13]，當前蜂窩站點的主要擾碼，十進制表示
  182. // 如果未在UMTS網絡中注冊，或者注冊狀態未知，則為NULL
  183. // 注意：當注冊狀態未知時，在Android電話系統中將作為服務不可用來處理
  184. {RIL_REQUEST_REGISTRATION_STATE, dispatchVoid, responseStrings},

Linux編程

Linux下的時鐘編程

PHP與Java構造函數的區別

Android 類似360 系統啟動時間提示

Java類訪問權限修飾符

Linux C SQLite3 編程

Kafka的Producer和Consumer的示例(使用Java語言)

JVM-內存分配與回收策略

Java中的各種排序算法

Linux教程網

linux的存儲管理:硬盤、分區及文件系統

存儲管理：一、硬盤、分區及文件系統二、硬盤配額限制 一、硬盤、分區、文件系統硬盤的物理概念：硬盤

Novell發布新款企業級Linux及新解決方案

山東鐵通基於國產Linux調度指揮管理系統研發成功

Android基礎教程：在程序中添加圖片

linux基礎之shell編程(1)

Fedora 9桌面截圖

紅旗Linux網絡配置BUG及解決

passwd: User not known to the underlying authentication解決

Linux下新手裝網卡指南

相关文章
Linux編程SHELL編程PERL編程
文章推荐
热点聚焦

C語言：運行中獲取宏名字的技巧

Android ImageView 圖片等比縮放問題

Eclipse編譯ijkplayer

Hibernate PO對象狀態

S3C2410A的異常機制[中斷處理]

運用HTML5+CSS3和CSS濾鏡做的精美的登錄界面

[Java][MyBatis]物理分頁實現

Java消息隊列--JMS概述

C語言和設計模式（之原型模式）

簡單的jQuery提交例子

Copyright © Linux教程網 All Rights Reserved