Replicant » libsamsung-ipc

h1. Wiki

h2. Introduction

As its "README":https://git.replicant.us/replicant/hardware_replicant_libsamsung-ipc/plain/README says, libsamsung-ipc is a free software implementation of the Samsung IPC modem protocol,

found in many Samsung devices.

*git:* libsamsung-ipc git is hosted in "hardware_replicant_libsamsung-ipc":https://git.replicant.us/replicant/hardware_replicant_libsamsung-ipc on the Replicant git infrastructure.

*Mailing list*: libsamsung-ipc uses "Replicant's mailing list":https://redmine.replicant.us/projects/replicant/wiki/CommunityAndContact#Mailing-list.

h3. Distributions

* It is used in Replicant

* It can probably be used in other Android distributions as well if libsamsung-ril support the Android version or RIL API in uses by other Android versions and distributions.

* In the past, it was also used by "SHR":https://en.wikipedia.org/wiki/SHR_(operating_system) and was probably also available in an external Debian repository.

* It was also used with "webos-ports":https://www.webos-ports.org/wiki/Galaxy_Nexus_Hardware_Overview for a short moment. They probably reused Samsung's nonfree implementation later on.

h3. Build systems

* It builds under Android with the Android.mk build system

* It also builds under GNU/Linux with the autotools build system. This makes it easy to package.

h3. Telephony daemons

* On Replicant it is used by libsamsung-ril which interfaces with Android's rild. Make sure to check which Android versions are supported by libsamsung-ipc to see how easy it can be used with various Android distributions other than Replicant.

* In the past it was also used with cornucopia's freesmartphone.org, a middleware written in Vala used to support various hardware features of smartphones and tablet in GNU/Linux. The vapi files were removed as they ended up not being used nor maintained anymore.

* There are out of tree patches for adding support for it in Ofono.

h3. Devices

* It supports the following devices which are currently supported by Replicant:

** Galaxy S II (GT-I9100)

** Galaxy S III (GT-I9300)

** Galaxy Note (GT-N7000)

** Galaxy Note II (GT-N7100)

** Galaxy Nexus (GT-I9250)

** Galaxy Tab 2 7.0 GSM (GT-P3100)

** Galaxy Tab 2 10.1 GSM (GT-P5100)

** Galaxy Note 8.0 GSM (GT-N5100)

* It also supports devices that are not supported anymore by Replicant:

** Nexus S (GT-I902x)

** Galaxy S (GT-I9000)

We also welcome patches for devices that Replicant doesn't want to support, and we will do our best to keep the code for them working.

However keep in mind that we might not want to get devices that are give too much control to the modem or don't have removable batteries.

Because of that we might rely on testers to ensure that the code continue to work. This is similar to what Linux does to ensure that the drivers keep working:

* New patches shouldn't break exiting drivers

* New patches shouldn't break compilation

* Anyone can test and report regressions if there are some, so we can fix it with the help of the reporter and/or testers.

h3. Limitations

* The protocol implementation is not 100% complete as shown in the "status of libsamsung-ril":https://redmine.replicant.us/projects/replicant/wiki/Libsamsung-ril however it's still been used daily by people using Replicant, so if there are issues, they tend to be known. Replicant has a "Telephony and mobile data section":https://redmine.replicant.us/projects/replicant/issues?v[category_id][]=99 in its bugreporting system with issues and research topics related to libsamsung-ipc.

* At some point a really problematic bug appeared (some SIM cards were not recognized) but it got eventually fixed and it was in another part of the stack (libsamsung-ril).

* It still depends on modem kernel drivers that are not upstream. Android and GNU/Linux distributions using it were all using derivatives of vendor kernels that had the required modem drivers.

h2. Documentation

The "Replicant wiki":https://redmine.replicant.us/projects/replicant/wiki has currently most of the documentation on libsamsung-ipc. The "CellularModem":https://redmine.replicant.us/projects/replicant/wiki/CellularModem portal references most of of the modem related pages.