STL 2026 ITU Submission

.gitattributes

@@ -0,0 +1,2 @@
+# Binary test data files - prevent CRLF corruption
+src/unsup/test_data/cftest1.dat binary

.github/workflows/ci.yml

@@ -0,0 +1,144 @@
+name: CI
+
+on:
+  push:
+    branches: [dev, main, STL_2026_itu_submission]
+  pull_request:
+    branches: [dev, main]
+
+jobs:
+  build-and-test:
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-latest
+            compiler: gcc
+            cc: gcc
+            cxx: g++
+          - os: ubuntu-latest
+            compiler: gcc-32bit
+            cc: gcc
+            cxx: g++
+            cflags: "-m32"
+          - os: ubuntu-latest
+            compiler: clang
+            cc: clang
+            cxx: clang++
+          - os: macos-latest
+            compiler: clang
+            cc: clang
+            cxx: clang++
+          - os: windows-latest
+            compiler: msvc
+            cc: cl
+            cxx: cl
+
+    runs-on: ${{ matrix.os }}
+    name: ${{ matrix.os }} / ${{ matrix.compiler }}
+    timeout-minutes: 15
+
+    steps:
+      - run: git config --global core.autocrlf false
+      - uses: actions/checkout@v4
+
+      - name: Install 32-bit libraries
+        if: matrix.cflags == '-m32'
+        run: sudo apt-get update && sudo apt-get install -y gcc-multilib g++-multilib
+
+      - name: Configure (Unix)
+        if: runner.os != 'Windows'
+        run: cmake . ${{ matrix.cflags && format('-DCMAKE_C_FLAGS="-m32 -msse2 -mfpmath=sse" -DCMAKE_CXX_FLAGS="-m32 -msse2 -mfpmath=sse"') || '' }}
+        env:
+          CC: ${{ matrix.cc }}
+          CXX: ${{ matrix.cxx }}
+
+      - name: Configure (Windows)
+        if: runner.os == 'Windows'
+        run: |
+          # Exclude build directory from Windows Defender to avoid scan delays
+          powershell -Command "Add-MpPreference -ExclusionPath '${{ github.workspace }}'"
+          cmake .
+
+      - name: Build (Unix)
+        if: runner.os != 'Windows'
+        run: cmake --build .
+
+      - name: Build (Windows)
+        if: runner.os == 'Windows'
+        run: cmake --build . --config Release
+
+      - name: Test (Unix)
+        if: runner.os != 'Windows'
+        run: ctest --output-on-failure
+
+      - name: Test (Windows)
+        if: runner.os == 'Windows'
+        run: ctest --output-on-failure --build-config Release
+
+  manual:
+    runs-on: ubuntu-latest
+    name: LaTeX manual
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install TeX Live
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y texlive-latex-extra texlive-fonts-recommended latexmk
+
+      - name: Build manual
+        run: cd doc/manual && latexmk -pdf -halt-on-error STLmanual.tex < /dev/null
+
+      - name: Upload PDF
+        uses: actions/upload-artifact@v4
+        with:
+          name: STL-manual
+          path: doc/manual/STLmanual.pdf
+
+  build-s390x:
+    runs-on: ubuntu-latest
+    name: s390x (big-endian)
+    timeout-minutes: 30
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install cross-compiler and QEMU
+        run: |
+          sudo apt-get update -q -y
+          sudo apt-get install -y gcc-s390x-linux-gnu g++-s390x-linux-gnu qemu-user-static
+      - name: Configure (cross-compile for s390x)
+        run: |
+          cmake -DCMAKE_C_COMPILER=s390x-linux-gnu-gcc \
+                -DCMAKE_CXX_COMPILER=s390x-linux-gnu-g++ \
+                -DCMAKE_SYSTEM_NAME=Linux \
+                -DCMAKE_SYSTEM_PROCESSOR=s390x \
+                -DCMAKE_CROSSCOMPILING_EMULATOR=/usr/bin/qemu-s390x-static \
+                -DCMAKE_EXE_LINKER_FLAGS="-static" \
+                .
+      - name: Build
+        run: cmake --build .
+      - name: Test
+        run: ctest --output-on-failure
+
+  build-i386-container:
+    runs-on: ubuntu-latest
+    name: i386 container
+    timeout-minutes: 45
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: docker/setup-qemu-action@v3
+        with:
+          platforms: linux/386
+
+      - name: Build and test in i386 container
+        run: |
+          docker run --rm --platform linux/386 \
+            -e DEBIAN_FRONTEND=noninteractive \
+            -v ${{ github.workspace }}:/src -w /src \
+            debian:bullseye bash -c "
+              apt-get update && apt-get install -y --no-install-recommends gcc g++ cmake make python3 &&
+              cmake . -DCMAKE_C_FLAGS='-msse2 -mfpmath=sse' -DCMAKE_CXX_FLAGS='-msse2 -mfpmath=sse' &&
+              cmake --build . &&
+              ctest --output-on-failure
+            "

.gitignore

@@ -47,8 +47,6 @@ src/is54/test_data/voice.bec
 src/is54/test_data/voice.hbs
 !src/is54/test_data/voice.log
 src/is54/test_data/voice.rek
-src/sv56/test_data/voice.prc
-src/sv56/test_data/voice.rms
 src/unsup/test_data/astrip.blk
 src/unsup/test_data/undo.txt
 src/utl/test_data/voice.rnp
@@ -97,3 +95,8 @@ bld/
 .vs/
 *vcxproj*
 *.sln*
+.vscode/
+/build
+*.double
+stderr.txt
+stdout.txt

CMakeLists.txt

@@ -1,6 +1,7 @@
-cmake_minimum_required(VERSION 3.1)
+cmake_minimum_required(VERSION 3.10...3.31)
 project(STL2023 VERSION 2023)
-add_definitions( -DVERSION_STL="${CMAKE_PROJECT_NAME}" )
+
+add_definitions( -DVERSION_STL="${CMAKE_PROJECT_NAME}" -DCMAKE_POLICY_VERSION_MINIMUM=3.5 )
 
 set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/bin)
 
@@ -21,9 +22,11 @@ add_subdirectory(src/basop/test_framework)
 add_subdirectory(src/basop/flc)
 add_subdirectory(src/bs1770demo)
 add_subdirectory(src/eid)
+add_subdirectory(src/eid-amr)
 add_subdirectory(src/esdru)
 add_subdirectory(src/fir)
 add_subdirectory(src/freqresp)
+add_subdirectory(src/gain_chk)
 add_subdirectory(src/g711)
 add_subdirectory(src/g711iplc)
 add_subdirectory(src/g722)

cmake/CompareTextFiles.cmake

@@ -0,0 +1,20 @@
+# cmake/CompareTextFiles.cmake
+# Compare two text files, ignoring line-ending differences (CRLF vs LF).
+#
+# Usage (from a -P script):
+#   include(/path/to/CompareTextFiles.cmake)
+#   compare_text_files(GOT <file> EXPECTED <file> [LABEL <name>])
+
+function(compare_text_files)
+    cmake_parse_arguments(_CTF "" "GOT;EXPECTED;LABEL" "" ${ARGN})
+
+    file(READ "${_CTF_GOT}" _got)
+    string(REPLACE "\r\n" "\n" _got "${_got}")
+
+    file(READ "${_CTF_EXPECTED}" _want)
+    string(REPLACE "\r\n" "\n" _want "${_want}")
+
+    if(NOT _got STREQUAL _want)
+        message(FATAL_ERROR "Text file mismatch: ${_CTF_LABEL}\n--- got ---\n${_got}\n--- expected ---\n${_want}")
+    endif()
+endfunction()

doc/manual/Makefile

@@ -1,7 +1,7 @@
 BIBTEX = bibtex
 PDFLATEX = pdflatex
 
-PARTS = STLmanual.tex intro.tex g711.tex g711iplc.tex g726.tex g727.tex g728.tex g722.tex rpe.tex rate.tex eid.tex mnru.tex sv56.tex reverb.tex truncate.tex freqresp.tex stereoop.tex esdru.tex bs1770demo.tex basop.tex utl.tex wmc_tool.tex
+PARTS = STLmanual.tex intro.tex g711.tex g711iplc.tex g726.tex g727.tex g728.tex g722.tex rpe.tex rate.tex eid.tex mnru.tex sv56.tex reverb.tex truncate.tex freqresp.tex stereoop.tex esdru.tex bs1770demo.tex  gain_chk.tex basop.tex utl.tex wmc_tool.tex
 
 STLmanual.pdf : $(PARTS) bibliography.bib
 	$(PDFLATEX) $(PARTS)

doc/manual/STLmanual.tex

@@ -182,6 +182,11 @@
 %=============================================================================
 \include{freqresp}
 
+%=============================================================================
+% chapter gain_chk: Gain amplification verification tool
+%=============================================================================
+\include{gain_chk}
+
 %=============================================================================
 % chapter stereoop: Stereo processing tool
 %=============================================================================

doc/manual/basop.tex

@@ -1008,27 +1008,27 @@ \subsection{Variable definitions}
 \subsection{Operators with complexity weight of 1}
 
 %........................................................
-\NewOperator{CL\_shr(CL\_var1, var2)}
+\NewOperator{CL\_shr(CL\_var1, L\_var2)}
 
-Arithmetically shifts right the real and imaginary parts of the 32-bit complex number CL\_var1 by var2 positions.\\
-If var2 is negative, real and imaginary parts of CL\_var1 are shifted to the most significant bits by (-var2) positions with 32-bit saturation control.\\
-If var2 is positive, real and imaginary parts of CL\_var1 are shifted to the least significant bits by (var2) positions with sign extension.\\
+Arithmetically shifts right the real and imaginary parts of the 32-bit complex number CL\_var1 by L\_var2 positions.\\
+If L\_var2 is negative, real and imaginary parts of CL\_var1 are shifted to the most significant bits by (-L\_var2) positions with 32-bit saturation control.\\
+If L\_var2 is positive, real and imaginary parts of CL\_var1 are shifted to the least significant bits by (L\_var2) positions with sign extension.\\
 The following code snippet describes the operations performed on real \& imaginary part of a complex number:
 
-{\tt \rulex{5mm}CL\_result.re = L\_shr(CL\_var1.re, L\_shift\_val);\\
-\rulex{5mm}CL\_result.im = L\_shr(CL\_var1.im, L\_shift\_val);\\
+{\tt \rulex{5mm}CL\_result.re = L\_shr(CL\_var1.re, L\_var2);\\
+\rulex{5mm}CL\_result.im = L\_shr(CL\_var1.im, L\_var2);\\
 }
 
 %........................................................
-\NewOperator{CL\_shl(CL\_var1, var2)}
+\NewOperator{CL\_shl(CL\_var1, L\_var2)}
 
-Arithmetically shifts left the real and imaginary parts of the 32-bit complex number CL\_var1 by L\_shift\_val positions.\\
-If var2 is negative, real and imaginary parts of CL\_var1 are shifted to the least significant bits by ( -var2 ) positions with sign extension.\\
-If var2 is positive, real and imaginary parts of CL\_var1 are shifted to the most significant bits by (var2) positions with 32-bit saturation control.\\
+Arithmetically shifts left the real and imaginary parts of the 32-bit complex number CL\_var1 by L\_var2 positions.\\
+If L\_var2 is negative, real and imaginary parts of CL\_var1 are shifted to the least significant bits by ( -L\_var2 ) positions with sign extension.\\
+If L\_var2 is positive, real and imaginary parts of CL\_var1 are shifted to the most significant bits by (L\_var2) positions with 32-bit saturation control.\\
 The following code snippet describes the operations performed on real \& imaginary part of a complex number:
 
-{\tt \rulex{5mm} CL\_result.re = L\_shl(CL\_var1.re, L\_shift\_val);\\
-\rulex{5mm} CL\_result.im = L\_shl(CL\_var1.im, L\_shift\_val);
+{\tt \rulex{5mm} CL\_result.re = L\_shl(CL\_var1.re, L\_var2);\\
+\rulex{5mm} CL\_result.im = L\_shl(CL\_var1.im, L\_var2);
 }
 
 %........................................................
@@ -1503,7 +1503,7 @@ \subsection{Operators with complexity weight of 1}
 Multiplies 16-bit var1 by 16-bit var2, sign extends to 64 bits; subtracts this 64 bit value from the 64 bit W\_acc without saturation control, and returns a 64 bit result.
 
 %........................................................
-\NewOperator{W\_mult\_16\_16(W\_acc, var1, var2)}
+\NewOperator{W\_mult\_16\_16(var1, var2)}
 
 \textbf{ This operator is SIMD and VLIW friendly}
 
@@ -1542,29 +1542,29 @@ \subsection{Operators with complexity weight of 1}
 Deposits the 32-bit L\_var1 into the 32 MS bits of the 64-bit output. The 32 LS bits of the output are zeroed.
 
 %........................................................
-\NewOperator{W\_sat\_l(W\_v1)}
+\NewOperator{W\_sat\_l(W\_var1)}
 
-Saturates the 64-bit variable W\_v1 to 32-bit value and returns the lower 32 bits.\\
+Saturates the 64-bit variable W\_var1 to 32-bit value and returns the lower 32 bits.\\
 For example, a 64-bit wide accumulator is helpful in accumulating 16*16 multiplies without checking for saturation.
 However, at the end of the multiply-and-accumulate loop, we need to return only the 32-bit value after checking for saturation.\\
-If W\_v1 is in 33Q31 format, then the result returned will be saturated to 1Q31 format.
+If W\_var1 is in 33Q31 format, then the result returned will be saturated to 1Q31 format.
 
 %........................................................
-\NewOperator{W\_sat\_m(W\_v1)}
+\NewOperator{W\_sat\_m(W\_var1)}
 
-Arithmetically shifts right the 64-bit variable W\_v1 by 16 bits; saturates the 64-bit value to 32-bit value and returns the lower 32 bits.\\
+Arithmetically shifts right the 64-bit variable W\_var1 by 16 bits; saturates the 64-bit value to 32-bit value and returns the lower 32 bits.\\
 For example, a 64-bit wide accumulator is helpful in accumulating 32\*16 multiplies without checking for saturation.
 A 32\*16 multiply gives a 48-bit product; at the end of the multiply-and-accumulate loop, the result is in the lower 48 bits of the 64-bit accumulator.
 Now an arithmetic right shift by 16 bits will drop the LSB 16 bits.
 Now we should check for saturation and return the lower 32 bits.\\
-If W\_var is in 17Q47 format, then the result returned will be saturated to 1Q31 format.
+If W\_var1 is in 17Q47 format, then the result returned will be saturated to 1Q31 format.
 
 %........................................................
-\NewOperator{W\_shl\_sat\_l(W\_1, var1)}
+\NewOperator{W\_shl\_sat\_l(W\_var1, L\_var2)}
 
-Arithmetically shifts left the 64-bit W\_v1 by v1 positions with lower 32-bit saturation and returns the 32 LSB of 64-bit result.\\
-If v1 is negative, the result is shifted to right by (-var1) positions and sign extended.
-After shift operation, returns the 32 MSB of 64-bit result.
+Arithmetically shifts left the 64-bit W\_var1 by L\_var2 positions with lower 32-bit saturation and returns the 32 LSB of 64-bit result.\\
+If L\_var2 is negative, the result is shifted to right by (-L\_var2) positions and sign extended.
+After shift operation, returns the 32 LSB of 64-bit result.
 
 %........................................................
 \NewOperator{W\_extract\_l(W\_var1)}
@@ -1611,7 +1611,7 @@ \subsection{Operators with complexity weight of 1}
 %........................................................
 \NewOperator{W\_neg(W\_var1)}
 
-Negates a 64-bit variables W\_var1 with 64-bit saturation control.
+Negates the 64-bit variable W\_var1 with 64-bit saturation control.
 Set overflow flag. Returns 64-bit result.
 
 %........................................................
@@ -1713,7 +1713,7 @@ \subsection{Operators}
 Returns the 32 MSB of the 64-bit result after truncating of the lower 32 bits.
 The operation is performed in fractional mode.
 
-For example, if L\_var1 is in 1Q31 format and var2 is in 1Q31 format, then the product is produced in 1Q63 format which is then truncated, saturated, and returned in 1Q31 format.
+For example, if L\_var1 is in 1Q31 format and L\_var2 is in 1Q31 format, then the product is produced in 1Q63 format which is then truncated, saturated, and returned in 1Q31 format.
 
 The following code snippet describes the operations performed: