You are on page 1of 8

GSMPhone 1 RIL 10

9

2

RILSender 3 RILD 4 libril 5
 

RILReceiver 8 Java API Native API 7

Android  Telephony  Stack

6 6 Proprietary RIL library
 

© David Marques ­ dpsmarques@gmail.com

telephony.GSMPhone  class  implements  a  GSM  phone  and  exposes  all  phone  capabilities  to  the  other  components  inside  the  android  framework.Message  instance to be used in order to send the response back to the function caller with the function  result within the message itself.internal.internal.gsm.GSMPhone 1 RIL The  com.android.os.RIL  class. 10     .telephony.  This  class interfaces with the radio interface layer in order to communicate to the baseband radio  modem  though  the  com.  The  top­down  communication  between these layers is done by asynchronous function calls passing an android.android.

android.RIL  class  has  two  internal  classes  responsible  for  sending the requests and receiving the responses to and from the RIL daemon respectively.      .telephony.  Both  RILSender  and  RILReceiver  classes  run  on  its  own  threads  interacting  with  the  RIL  daemon through a linux socket to send and receive messages to the baseband radio.RIL 9 2 RILSender RILReceiver The  com.internal.

      .RILSender 3 RILD RILReceiver 8 The RIL daemon (RILD) is a native linux process that communicates with the Java telephony  API through a linux socket exposing a radio implementation agnostic protocol.

    .RILD 4 libril 5 Proprietary RIL library 6 6 7 The  RIL  daemon  (RILD)  loads  the  proprietary  RIL  library  and  registers  its  radio  specific  functions  implementation  into  the  telephony  stack.  The  proprietary  library  returns  a  response  to  the  telephony  stack  through  a  callback  function  which  marshals  the  response  and sends it back to the Java API though the same socket used to receive the request. The  Java  layers  processes  the  request  on  the  RILReceiver  class  and  forwards  the  response  to  the original request owner.  The  RILD  receives  requests  through  a  linux  socket  and  processes  the  request  calling  the  proprietary  library's  radio  function  implementation  passing  the  appropriate  parameters.

  RILD  calls  through  libril  the  proprietary  RIL  library  request  handler  function  passing  the  extracted parameters. 5.  RIL class creates a Parcel and fills its content with the specified parameters. RILD unmarshals the raw data into a Parcel and extracts the request parameters from the  Parcel. 2. Phone implementation calls RIL class to communicate with the baseband radio. 3.Solicited command flow: android RIL -> proprietary RIL R I L RILD libril proprietary ril 1. . 4.  RIL marshals the parcel into raw data and sends through the RILD socket.

4. puts the result within it and marshals the Parcel into raw  data to be sent through the RILD socket back to the Java layer.Solicited command flow: proprietary RIL -> android RIL R I L RILD libril proprietary ril 1. The request owner receives the response on a Message instance passed to the RIL class  method called to make the request. 2. Android libril creates a Parcel. Proprietary RIL library calls the response function on the android libril passing the result.  At  the  Java  layer  the  raw  data  that  came  from  the  socket  is  unmarshaled  into  a  Parcel  and the result is extracted and sent to the original request owner. 3. .

2  release  (aka  Froyo)  of  the  Android  open­source  project.  Any  future  updates  may  invalidate  the  information  contained  on  this  document.Note:  All  the  information  in  this  document  comes  from  the  Android  2. .