You copied the Doc URL to your clipboard.

ETSI basic operations

The compilation tools support the original ETSI family of basic operations described in the ETSI G.729 recommendation Coding of speech at 8 kbit/s using conjugate-structure algebraic-code-excited linear prediction (CS-ACELP).

To make use of the ETSI basic operations in your own code, include the standard header file dspfns.h. The intrinsics supplied in dspfns.h are listed in Table 22.

Table 22. ETSI basic operations that the ARM compilation tools support
Intrinsics
abs_sL_add_cL_multL_sub_cnorm_l
addL_deposit_hL_negatemac_rround
div_sL_deposit_lL_satmsu_rsaturate
extract_hL_macL_shlmultshl
extract_lL_macNsL_shrmult_rshr
L_absL_msuL_shr_rnegateshr_r
L_addL_msuNsL_subnorm_ssub

The header file dspfns.h also exposes certain status flags as global variables for use in your C or C++ programs. The status flags exposed by dspfns.h are listed in Table 23.

Table 23. ETSI status flags exposed in the ARM compilation tools
Status flagDescription
Overflow

Overflow status flag.

Generally, saturating functions have a sticky effect on overflow.

Carry

Carry status flag.


Example

#include <limits.h>
#include <stdint.h>
#include <dspfns.h>       // include ETSI basic operations
int32_t C_L_add(int32_t a, int32_t b)
{
    int32_t c = a + b;
    if (((a ^ b) & INT_MIN) == 0)
    {
        if ((c ^ a) & INT_MIN)
        {
            c = (a < 0) ? INT_MIN : INT_MAX;
        }
    }
    return c;
}
__asm int32_t asm_L_add(int32_t a, int32_t b)
{
    qadd r0, r0, r1
    bx lr
}
int32_t foo(int32_t a, int32_t b)
{
    int32_t c, d, e, f;
    Overflow = 0;         // set global overflow flag
    c = C_L_add(a, b);    // C saturating add
    d = asm_L_add(a, b);  // assembly language saturating add
    e = __qadd(a, b);     // ARM intrinsic saturating add
    f = L_add(a, b);      // ETSI saturating add
    return Overflow ? -1 : c == d == e == f; // returns 1, unless overflow
}

See also

  • the header file dspfns.h for definitions of the ETSI basic operations as a combination of C code and intrinsics

  • European Telecommunications Standards Institute (ETSI) basic operations in Using the Compiler

  • ETSI Recommendation G.191: Software tools for speech and audio coding standardization

  • ITU-T Software Tool Library 2005 User's manual, included as part of ETSI Recommendation G.191

  • ETSI Recommendation G723.1 : Dual rate speech coder for multimedia communications transmitting at 5.3 and 6.3 kbit/s

  • ETSI Recommendation G.729: Coding of speech at 8 kbit/s using conjugate-structure algebraic-code-excited linear prediction (CS-ACELP).