Project

General

Profile

Wiki » History » Version 9

Denis 'GNUtoo' Carikli, 10/05/2020 09:28 PM

1 1 Denis 'GNUtoo' Carikli
h1. Wiki
2
3
h2. Introduction
4
5
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,
6
found in many Samsung devices.
7
8 5 Denis 'GNUtoo' Carikli
h2. Infrastructure
9
10 1 Denis 'GNUtoo' Carikli
*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.
11 6 Denis 'GNUtoo' Carikli
*Mailing list*: libsamsung-ipc uses the "Replicant's mailing list":https://redmine.replicant.us/projects/replicant/wiki/CommunityAndContact#Mailing-list.
12 7 Denis 'GNUtoo' Carikli
*Bug tracking*: We currently uses the "Replicant bug tracker":https://redmine.replicant.us/projects/replicant/issues.
13 5 Denis 'GNUtoo' Carikli
Feel free to also add entries there on issues that affect libsamsung-ipc but not Replicant.
14
In this case it's a good idea to use "Telephony and mobile data" in the category and also mention that it doesn't affect Replicant (if that's not obvious) and how to reproduce the issue if that's applicable.
15 1 Denis 'GNUtoo' Carikli
16
h3. Distributions
17
18
* It is used in Replicant
19
* 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.
20
* 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.
21
* 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.
22
23
h3. Build systems
24
25
* It builds under Android with the Android.mk build system
26
* It also builds under GNU/Linux with the autotools build system. This makes it easy to package.
27
28
h3. Telephony daemons
29
30 8 Denis 'GNUtoo' Carikli
* 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-ril to see how easy it can be used with various Android distributions other than Replicant.
31 1 Denis 'GNUtoo' Carikli
* 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.
32
* There are out of tree patches for adding support for it in Ofono.
33
34
h3. Devices
35
36
* It supports the following devices which are currently supported by Replicant:
37
** Galaxy S II (GT-I9100)
38
** Galaxy S III (GT-I9300)
39
** Galaxy Note (GT-N7000)
40
** Galaxy Note II (GT-N7100)
41
** Galaxy Nexus (GT-I9250)
42
** Galaxy Tab 2 7.0 GSM (GT-P3100)
43
** Galaxy Tab 2 10.1 GSM (GT-P5100)
44
** Galaxy Note 8.0 GSM (GT-N5100)
45
* It also supports devices that are not supported anymore by Replicant:
46
** Nexus S (GT-I902x)
47
** Galaxy S (GT-I9000)
48
49
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.
50
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.
51
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:
52 2 Denis 'GNUtoo' Carikli
* New patches shouldn't break exiting drivers
53
* New patches shouldn't break compilation
54
* Anyone can test and report regressions if there are some, so we can fix it with the help of the reporter and/or testers.
55 1 Denis 'GNUtoo' Carikli
56
h3. Limitations
57
58 4 Denis 'GNUtoo' Carikli
* 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.
59 1 Denis 'GNUtoo' Carikli
* 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).
60 9 Denis 'GNUtoo' Carikli
* Libsamsung-ril needs to be ported to more recent rild API but the work on that has already started.
61 1 Denis 'GNUtoo' Carikli
* 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.
62
63
h2. Documentation
64
65
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.