view README @ 33:a91fb88a57b2 default tip

add INSTALL document
author Mychaela Falconia <falcon@freecalypso.org>
date Fri, 14 Jun 2024 20:29:17 +0000
parents 829e082793d0
children
line wrap: on
line source

The present suite consists of utilities for encoding and decoding SMS message
bodies and PDUs.  On the decoding side, it includes sms-pdu-decode and
pcm-sms-decode utilities that were previously maintained as part of FreeCalypso
host tools: they now extend beyond FreeCalypso GSM MS into SIM card exploration
(fc-simtool) and network-side SMSC prototyping applications.  On the encoding
side, there are two new programs described in doc/Generator-tool-summary and
doc/Generator-tool-workflow articles.

Similarly to gsm-codec-lib, the present sms-coding-utils package stands between
FreeCalypso and Themyscira Wireless software realms: it has potential
applications on both the mobile side and the network side of GSM.  It is
expected to be used together with any or all of the following software
components:

* FreeCalypso host tools;
* FreeCalypso SIM tools;
* ThemWi proto-SMSC implementation used to exercise SMS-over-GSUP functionality
  in Osmocom CNI suite.

However, even though the present sms-coding-utils suite is designed to be useful
with all of the above FC and ThemWi components, it does not depend on any of
them.  The present package can be compiled and installed by itself (see INSTALL
document); all run-time interactions between these utilities and other software
happen through ASCII text files or pipes, or through binary files in externally
defined record format (GSM 11.11 spec and its successors) in the case of
pcm-sms-decode.