Skip to content
oFono-based Java RIL for Android
Branch: master
Clone or download
Latest commit 1931e38 Oct 14, 2017
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.idea implemented SMS sending Aug 31, 2017
build/java/net/scintill/ril_ofono extract auxiliary classes and fix rawtypes Oct 6, 2017
lib/java
patches improve SELinux policy Sep 10, 2017
src extract auxiliary classes and fix rawtypes Oct 6, 2017
.gitignore implemented SMS receiving Aug 31, 2017
Android.mk simplify build, refine proguard Sep 15, 2017
AndroidManifest.xml simple demo of loading custom RIL class into com.android.phone Jul 22, 2017
COPYING initial commit Jul 18, 2017
README.md update project status Oct 13, 2017
logs (un)load modules in response to oFono's interfaces Sep 26, 2017
mount improve datacall implementation Sep 10, 2017
proguard.flags
push switch oFono to Gobi driver! Sep 2, 2017
start
stop refactor: wrapper class that handles the async parts Sep 2, 2017

README.md

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; 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/.

You can’t perform that action at this time.