diff README @ 206:1b8cb3490d48

README: update for work approaching release
author Mychaela Falconia <falcon@freecalypso.org>
date Wed, 04 Jan 2023 07:53:16 +0000
parents b45bb0f9bdfc
children 614ae8dc6807
line wrap: on
line diff
--- a/README	Wed Jan 04 06:43:53 2023 +0000
+++ b/README	Wed Jan 04 07:53:16 2023 +0000
@@ -1,14 +1,47 @@
-The present source repository is intended to be a collection of C libraries
-(each at least conceptually independent and free-standing) providing
-functionality in a spirit similar to the venerable libgsm (GSM 06.10
-implementation) from 1990s.  The following libraries are currently envisioned:
+Themyscira Wireless GSM codec libraries & utilities package
+===========================================================
 
-libgsmfrp	A preprocessor to be invoked prior to gsm_decode() from classic
-		libgsm, implementing GSM 06.11, 06.12 and 06.31 functionality
-		in the Rx direction.
+Themyscira Wireless, a technical initiative of the Women's Republic of
+Themyscira, is proud to present this package of GSM codec libraries and
+associated command line test and development utilities.  The present package
+provides two linkable C libraries, intended to be usable by any application
+that needs GSM codec functionality:
 
 libgsmefr	An implementation of EFR codec in the same spirit as classic
-		libgsm, i.e., like libgsm, but for EFR instead of 06.10.  It
-		will be based on the reference code from ETSI.
+		libgsm, i.e., like libgsm, but for EFR instead of 06.10.  It is
+		based on the reference code from ETSI.
+
+libgsmfrp	An Rx DTX handler preprocessor to be invoked prior to
+		gsm_decode() from classic libgsm, implementing GSM 06.11, 06.12
+		and 06.31 functionality in the Rx direction.
+
+These two libraries are intended primarily for use as part of GSM network
+deployment, i.e., as part of the necessary speech transcoder implementation in
+whichever network-side server process acts as the voice gateway to PSTN or
+other networks.  However, they can also be used as part of development and
+testing on the mobile side of GSM: for example, to decode TCH downlink bits and
+voice memo recordings read out of FreeCalypso GSM MS devices, or to implement
+your own lab-oriented GSM MS on top of some other PHY.
 
-libgsmamr	A similar deal for AMR, only a fuzzy idea currently.
+Each of these two Themyscira libraries (libgsmefr and libgsmfrp) is free-
+standing and independent of the other.  libgsmfrp makes use of <gsm.h> header
+file from libgsm (for gsm_byte and gsm_frame defined types) and requires this
+header file in order to compile; libgsmefr has zero dependencies nominally but
+will often be used together with libgsm and libgsmfrp.
+
+Included command line utilities
+===============================
+
+In addition to the two main libraries, the present package includes a number of
+command line utilities, falling into the following groups:
+
+* Some utilities specifically exercise and test the two core libraries;
+
+* Some utilities are not specifically for library testing but make use of
+  our libraries;
+
+* Some utilities are included because they implement some closely related and
+  relevant debug and development functionality, even though they don't link
+  with either libgsmefr or libgsmfrp.
+
+Please see the included documentation in the doc subdirectory.