Skip to content

Latest commit

 

History

History
70 lines (54 loc) · 4.94 KB

README.md

File metadata and controls

70 lines (54 loc) · 4.94 KB
Raw

Goal

The goal of this project is to write an Android RIL on top of oFono (my fork here). For my convenience and code-safety, the RIL is written in Java as an implementation of the AOSP telephony framework's CommandsInterface, omitting the traditional rild and shared library parts.

Roadmap

  • Alpha implementation
    • Write a RIL class that the com.android.phone app (via the telephony framework) will load. This class will interface with oFono.
    • The oFono instance will be using the rilmodem driver. Yes, this first version of the RIL will be built on a RIL! This will hopefully mean fewer "moving parts" and missing functionality to start, allowing us to focus on the basic architecture.
  • Pivot oFono onto the qmimodem driver
    • Interface for qmuxd (qmiserial2qmuxd)
    • Implement more features (some work will probably be needed in the qmimodem driver), refine things like error-handling, test
    • Get rid of qmuxd and any other proprietary stuff we are relying on
  • More testing and refinements
    • As of October 2017, I had some successful tests with a fully open-source stack (no proprietary code on the apps processor!) on Replicant 6 and GT-I9195, but there is some flakiness compared to when I was running on top of CyanogenMod 12 with proprietary blobs (I think qmuxd and rmt_storage would be the only relevant blobs, but maybe there are other bits that helped initialize things into a stable state.)

Usage

  1. Build from Replicant 6 checkout with this manifest. (My device is serranoltexx, but this manifest will probably work with any Serrano device, or even any Samsung MSM8930-based device if you add its device tree from LineageOS.)
  2. Running
    • In theory, all you need to do is flash the build and boot, but in reality it currently takes some fiddling to get the modem booted.
      • Signs of success: rmtfsd logging in the main log about file requests; "apr_tal:Modem Is Up" in dmesg, ofonod logging in the radio log about QMI calls; kernel log does not have messages about the modem continually resetting.
      • Try writing "20" to /sys/devices/virtual/smdpkt/smdcntl0/open_timeout . Once you get it going, write the normal value "0".
      • You might need to restart ofonod as root, after the modem and rmtfsd appear to be talking.
      • You might try writing "1" to /sys/kernel/debug/modem_debug/reset_modem to reboot the modem if things seem stuck in a non-working state.
  3. Debugging
    • You can forward the dbus to your PC: Add <auth>ANONYMOUS</auth><allow_anonymous /> to /system/etc/dbus.conf, and adb forward localfilesystem:/tmp/dbus-android localreserved:dbus. Then use the dbus address unix:path=/tmp/dbus-android for dbus-send, d-feet, etc.
    • Look for log tags RilOfono, ofonod (in the radio log) and rmtfsd (in the main log)

Features

Nothing is thoroughly tested nor tried on a broad selection of hardware/networks yet, but the following have been implemented and tested:

  • Basic SMS sending and receiving (multipart messages and some international characters tested)
  • MMS sending and receiving
  • Basic voicecalls: dial, receive, answer, decline, hang up, send DTMF tones in call
  • User-intiated USSD (special dial codes, such as #999# which displays balance on my carrier)
  • Basic data connections
    • When testing, you might need to turn off wifi to ensure the data connection gets used.
  • Reporting to Android: phone #, ICCID, voicemail #, voicemail messages alert

Resources and Credit

  • Thanks to Bjorn Andersson @andersson and Linaro for rmtfs and their Qualcomm SoC mainlining work.
  • Thanks to Alexander Couzens @lynxis and Sysmocom for oFono patches for voicecalls etc. on QMI.
  • https://github.com/nitdroid/ofono-ril for some help on mapping ofono properties to Android RIL

Bugs and TODO

  • make dbus exceptions be checked exceptions, so the compiler will find them and I have to handle them
  • better fix for org.ofono.Message proguard kept class? (see 74caeb2ac309cfe8b0690cf9db4949cf3523b427)

Code review

These should be reviewed more closely for correctness and safety:

  • My changes to oFono (logging, SMS PDU patches)
  • selinux policy

License

ril_ofono is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

ril_ofono is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with ril_ofono. If not, see http://www.gnu.org/licenses/.