Project

General

Profile

Libsamsung-ril » History » Version 3

Paul Kocialkowski, 11/08/2011 10:13 AM

1 1 Paul Kocialkowski
= libsamsung-ipc =
2
3
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.[[BR]]
4 2 Paul Kocialkowski
libsamsung-ipc is shared between SHR and Replicant projects. It's used in both for the Nexus S.
5 1 Paul Kocialkowski
6
Source code is available under the GPLv3+ at: https://github.com/morphis/libsamsung-ipc (master branch).
7
8
== ipc-modemctrl ==
9
10
ipc-modemctrl is the tool that comes to test libsamsung-ipc. It currently implements basic functionalities (mostly SIM unlocking and network registration).
11
12
Usage:
13
{{{
14 2 Paul Kocialkowski
usage: ipc-modemctrl <command>
15 1 Paul Kocialkowski
commands:
16
	start                 bootstrap modem and start read loop
17
	power-on              power on the modem
18
	power-off             power off the modem
19
arguments:
20
	--debug               enable debug messages
21
	--pin=[PIN]           provide SIM card PIN
22
}}}
23 2 Paul Kocialkowski
24
Please run ipc-modemctrl like this (from host pc): 
25
{{{ ./adb shell ipc-modemctrl start --pin=1234 }}}
26
27
assuming your SIM PIN is 1234. If you don't have any SIM pin, don't pass the --pin argument. 
28
29
It should go like this:
30
{{{
31
[I] Got SIM PIN!
32
[0] Starting modem on FMT client
33
[1] Starting modem_read_loop on FMT client
34
[2] Phone is powered up (LPM)!
35
[I] SIM card found
36
[I] SIM is initializing
37
[3] SIM init complete
38
[4] Modem is ready, requesting normal power mode
39
[I] SIM card found
40
[I] SIM is initializing
41
[3] SIM init complete
42
[5] Modem is fully ready
43
[I] Registered with network successfully!
44
[6] Registered with network! Got PLMN (Mobile Network Code): '20810'
45
[I] Registered with network successfully!
46
[6] Registered with network! Got PLMN (Mobile Network Code): '20810'
47
[I] Registered with network successfully!
48
[I] Registered with network successfully!
49
[6] Registered with network! Got PLMN (Mobile Network Code): '20810'
50
[I] SIM Phone Book init complete
51
}}}
52
53
If something goes wrong, please add the {{{ --debug }}} argument to get in debug mode.
54
55
== Status ==
56
57
We were able to make the following work:
58 3 Paul Kocialkowski
 * SMS (Rx/Tx)
59
 * Call (Rx/Tx) BUT NO AUDIO YET
60
 * GPRS 
61
 * SIM I/O (stored contacts, etc)
62
 * SIM PIN unlocking