changeset 473:2d46abdfbe91

libgsmefr version 1.1.0 for DHF addition
author Mychaela Falconia <falcon@freecalypso.org>
date Wed, 15 May 2024 05:22:02 +0000
parents d80ccb3c3970
children 285381a001fc
files CHANGES Library-versions doc/EFR-library-API
diffstat 3 files changed, 15 insertions(+), 3 deletions(-) [+]
line wrap: on
line diff
--- a/CHANGES	Tue May 14 07:30:48 2024 +0000
+++ b/CHANGES	Wed May 15 05:22:02 2024 +0000
@@ -6,8 +6,10 @@
   functionality of libgsm (GSM 06.10 encoder and decoder implementation) has
   been absorbed into libgsmfr2.
 
-* Libgsmefr version 1.0.1 exhibits approximately 2x performance improvement
-  over the original version.
+* Libgsmefr version 1.1.0 exhibits approximately 2x performance improvement
+  over the original version, and also exhibits a small addition to the public
+  API: the RTP-encoded form of the standard EFR DHF is now provided as a const
+  datum.
 
 * New library added: libtwamr for 3GPP AMR-NB codec, serving as a replacement
   for libopencore-amrnb in Themyscira GSM codec exploration workflows.
--- a/Library-versions	Tue May 14 07:30:48 2024 +0000
+++ b/Library-versions	Wed May 15 05:22:02 2024 +0000
@@ -3,6 +3,6 @@
 source release package, the semantic versions of the included libraries are as
 follows:
 
-libgsmefr version 1.0.1
+libgsmefr version 1.1.0
 libgsmfr2 version 2.0.0
 libtwamr  version 1.0.0
--- a/doc/EFR-library-API	Tue May 14 07:30:48 2024 +0000
+++ b/doc/EFR-library-API	Wed May 15 05:22:02 2024 +0000
@@ -205,3 +205,13 @@
 flag from its initial value given to EFR_encoder_create() - the new value of
 this flag passed to EFR_encoder_reset() always takes effect.  There is no
 provision for changing this mode within an encoder session without a full reset.
+
+Public const datum: decoder homing frame
+========================================
+
+While the encoder homing frame is the same for all codecs defined by ETSI and
+then later 3GPP, each codec has its own unique decoder homing frame (DHF).  A
+public const datum introduced in libgsmefr version 1.1.0 provides the
+RTP-encoded form of the ETSI-prescribed DHF for EFR:
+
+extern const uint8_t EFR_decoder_homing_frame[EFR_RTP_FRAME_LEN];