samsung-ril¶

The samsung ril is the library that interfaces libsamsung-ipc(see below) with the android framework.
Status per devices below:

Nexus S

Functionality	Status
Data activation	Working since trunk of 14/01/2012
Data deactivation	Work in progress(partially working)
Calls with audio	working in the image 0002 (replicant 2.3)
SMS	working in the image 0002 (replicant 2.3)
DTMF	Work in progress(partially working)

libsamsung-ipc¶

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.

libsamsung-ipc is shared between SHR and Replicant projects. It's used in both for the Nexus S.

Source code is available under the GPLv3+ at: https://github.com/morphis/libsamsung-ipc (master branch).

The library is mostly complete

ipc-modemctrl¶

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).

Usage:

usage: ipc-modemctrl <command>
commands:
    start                 bootstrap modem and start read loop
    power-on              power on the modem
    power-off             power off the modem
arguments:
    --debug               enable debug messages
    --pin=[PIN]           provide SIM card PIN

Please run ipc-modemctrl like this (from host pc):

assuming your SIM PIN is 1234. If you don't have any SIM pin, don't pass the --pin argument. 

It should go like this:

<pre>
[I] Got SIM PIN!
[0] Starting modem on FMT client
[1] Starting modem_read_loop on FMT client
[2] Phone is powered up (LPM)!
[I] SIM card found
[I] SIM is initializing
[3] SIM init complete
[4] Modem is ready, requesting normal power mode
[I] SIM card found
[I] SIM is initializing
[3] SIM init complete
[5] Modem is fully ready
[I] Registered with network successfully!
[6] Registered with network! Got PLMN (Mobile Network Code): '20810'
[I] Registered with network successfully!
[6] Registered with network! Got PLMN (Mobile Network Code): '20810'
[I] Registered with network successfully!
[I] Registered with network successfully!
[6] Registered with network! Got PLMN (Mobile Network Code): '20810'
[I] SIM Phone Book init complete
</pre>

h2. Status

We were able to make the following work:
* SMS (Rx/Tx)
* Call (Rx/Tx) BUT NO AUDIO YET
* GPRS 
* SIM I/O (stored contacts, etc)
* SIM PIN unlocking