# HG changeset patch
# User Mychaela Falconia <falcon@freecalypso.org>
# Date 1670735522 0
# Node ID 3fd48946dcb8c598ba8c2a8cf65ea765638bdcef
# Parent  615f144b52c6578ec5817817df5754038821bd43
doc/EFR-testing article written

diff -r 615f144b52c6 -r 3fd48946dcb8 doc/EFR-testing
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/EFR-testing	Sun Dec 11 05:12:02 2022 +0000
@@ -0,0 +1,14 @@
+When it comes to codec libraries, testing for correctness is essential, and EFR
+is no exception.  There is a set of EFR encoder and decoder test sequences
+published by ETSI in ts_100725v050200p0.zip (GSM 06.54), and our suite of tools
+includes gsmefr-etsi-enc and gsmefr-etsi-dec test programs that operate on the
+representation formats used by these test sequences.  Because these test
+programs are based on libgsmefr EFR_encode_frame() and EFR_decode_frame()
+functions, seeing gsmefr-etsi-enc produce output that matches official ETSI
+*.cod files proves that libgsmefr encoder is correct, and seeing gsmefr-etsi-dec
+produce output that matches official ETSI *.out files proves that libgsmefr
+decoder is correct.
+
+For debugging, we also have gsmefr-cod-parse and gsmefr-dec-parse utilities that
+parse ETSI *.cod and *.dec file formats and dump their content in human-readable
+form.