Replicant

h1. libsamsung-ipc

libsamsung-ipc is a free software implementation of the Samsung IPC modem protocol, found in many Samsung devices.

libsamsung-ipc contains the device-specific code for transport between the kernel interface and the upper layer (usually, the Radio Interface Layer) and the definition of the data structures and values used in the protocol.

h2. Development

The "libsamsung-ipc source code":https://git.replicant.us/replicant/external_libsamsung-ipc is hosted by the Replicant project. The latest version is available on the @master@ branch.

It has support for both the Android build system and autotools.

h2. Other project using it or having used it without libsamsung-ril

* "Freesmartphone.org Cornucopia":https://github.com/freesmartphone/cornucopia/tree/master/fsogsmd/src/plugins/modem_samsung

h2. Status

The library itself is mostly complete: the actual protocol work takes place in the upper layer implementations, so only new devices support is left to be added.

h2. Tools

libsamsung-ipc ships with some tools to ease development.

h3. ipc-modem

ipc-modem is a deprecated tool that was used at the beginning of the work for talking to the Nexus S modem. It implements basic functionalities (mostly SIM unlocking and network registration), using libsamsung-ipc.

<pre>

usage: ipc-modem <command>

commands:

	start                 boot modem and start read loop

	boot                  boot modem only

	power-on              power on the modem

	power-off             power off the modem

arguments:

	--debug               enable debug messages

	--pin=[PIN]           provide SIM card PIN

</pre>

h3. ipc-test

ipc-test is a very minimalistic tool that simply boots up the modem and receives messages as they arrive. It is intended to ease boot code development by providing a standalone binary.