Project

General

Profile

Libsamsung-ril » History » Version 26

Paul Kocialkowski, 12/03/2012 08:59 PM

1 6 Denis 'GNUtoo' Carikli
h1. samsung-ril
2 1 Paul Kocialkowski
3 6 Denis 'GNUtoo' Carikli
The samsung ril is the library that interfaces libsamsung-ipc(see below) with the android framework.
4 1 Paul Kocialkowski
5 26 Paul Kocialkowski
h2. Supported devices
6 1 Paul Kocialkowski
7 26 Paul Kocialkowski
* Nexus S
8
* Galaxy S/Galaxy Tab P1000
9
* Galaxy S2
10
* Galaxy Nexus
11
12
h2. Features
13
14
|_. Functionality |_. Status |_. Release status |
15
| Modem bootstrap | Working | Released |
16
| Modem transport | Working | Released |
17
| Modem FMT | Working | Released |
18
| Modem RFS | Working | Released |
19
| Power to Normal (Airplane mode on) | Working | Released |
20
| Power to LPM (Airplane mode off) | Working | Released |
21
| RSSI infos | Working | Released |
22
| Icon infos | Working | Released |
23
| Modem firmware infos | Working | Released |
24
| IMEI/IMEISV | Working | Released, works best in Released |
25
| IMSI | Working | Released |
26
| USSD | Working, needs testing | Released |
27
| SIM PIN unlock | Working | Released |
28
| SIM PIN set | Working | Released |
29
| SIM PIN change | Working | Released |
30
| SIM unlock with PUK | Working | Released |
31
| SIM I/O | Partially working: infos, contacts are OK, stored SMS I/O is not | Released |
32
| Network registration | Working | Released |
33
| Operator strings | Working | Released |
34
| Network type force | Working | Released |
35
| Operator manual select | Working | Released |
36
| SMS outgoing | Working | Released |
37
| SMS incoming | Working | Released |
38
| Call incoming | Working | Released |
39
| Call outgoing | Working, but conferencing | Released |
40
| DTMF | Working | Released, works best in Released |
41
| Audio during calls | Working | Released |
42
| Audio mic mute set | Working | Released |
43
| Audio volume change | Working | Released |
44
| Audio path change | Working | Released |
45
| Data activation | Working | Released |
46
| Data deactivation | Working | Released |
47
| NV read item | Working | Released |
48
| NV write item | Working | Released |
49 6 Denis 'GNUtoo' Carikli
50
h1. libsamsung-ipc
51
52 4 Paul Kocialkowski
libsamsung-ipc is a free implementation of the protocol to speak with modems found in most Samsung devices. It is the low-level library used to communicate with the modem and needs an upper-layer (RIL) to interface with the system.
53 1 Paul Kocialkowski
54
libsamsung-ipc is shared between SHR and Replicant projects. It's used in both for the Nexus S.
55
56 25 Denis 'GNUtoo' Carikli
Source code is available under the GPLv2+ at: https://github.com/morphis/libsamsung-ipc (master branch).
57 1 Paul Kocialkowski
58 6 Denis 'GNUtoo' Carikli
The library is mostly complete
59 4 Paul Kocialkowski
60
h2. ipc-modemctrl
61 1 Paul Kocialkowski
62 5 Denis 'GNUtoo' Carikli
ipc-modemctrl is a deprecated tool that was used at the beginning of the work for talking to the nexus S modem. It implemented basic functionalities (mostly SIM unlocking and network registration).
63 1 Paul Kocialkowski
64
Usage:
65 4 Paul Kocialkowski
<pre>
66 1 Paul Kocialkowski
usage: ipc-modemctrl <command>
67
commands:
68
	start                 bootstrap modem and start read loop
69
	power-on              power on the modem
70
	power-off             power off the modem
71
arguments:
72 2 Paul Kocialkowski
	--debug               enable debug messages
73
	--pin=[PIN]           provide SIM card PIN
74 4 Paul Kocialkowski
</pre>
75 1 Paul Kocialkowski
76
Please run ipc-modemctrl like this (from host pc): 
77
78
assuming your SIM PIN is 1234. If you don't have any SIM pin, don't pass the --pin argument. 
79
80
It should go like this:
81 11 Paul Kocialkowski
82 4 Paul Kocialkowski
<pre>
83 1 Paul Kocialkowski
[I] Got SIM PIN!
84 11 Paul Kocialkowski
[0] Starting modem on FMT client
85
[1] Starting modem_read_loop on FMT client
86
[2] Phone is powered up (LPM)!
87 1 Paul Kocialkowski
[I] SIM card found
88
[I] SIM is initializing
89 11 Paul Kocialkowski
[3] SIM init complete
90
[4] Modem is ready, requesting normal power mode
91 1 Paul Kocialkowski
[I] SIM card found
92 2 Paul Kocialkowski
[I] SIM is initializing
93 11 Paul Kocialkowski
[3] SIM init complete
94
[5] Modem is fully ready
95 2 Paul Kocialkowski
[I] Registered with network successfully!
96 11 Paul Kocialkowski
[6] Registered with network! Got PLMN (Mobile Network Code): '20810'
97 4 Paul Kocialkowski
[I] Registered with network successfully!
98 11 Paul Kocialkowski
[6] Registered with network! Got PLMN (Mobile Network Code): '20810'
99 4 Paul Kocialkowski
[I] Registered with network successfully!
100 2 Paul Kocialkowski
[I] Registered with network successfully!
101 11 Paul Kocialkowski
[6] Registered with network! Got PLMN (Mobile Network Code): '20810'
102 2 Paul Kocialkowski
[I] SIM Phone Book init complete
103
</pre>
104 4 Paul Kocialkowski
105
h2. Status
106
107 3 Paul Kocialkowski
We were able to make the following work:
108 4 Paul Kocialkowski
* SMS (Rx/Tx)
109
* Call (Rx/Tx) BUT NO AUDIO YET
110
* GPRS 
111
* SIM I/O (stored contacts, etc)
112
* SIM PIN unlocking