Library Q Format

Note

For fixed point Q formats this document uses the format QM.N, where M is the number of bits before the decimal point (excluding the sign bit), and N is the number of bits after the decimal point. For an int32 number, M+N=31.

By default, the signal processing in the audio pipeline is carried out at 32 bit fixed point precision in Q4.27 format. Assuming a 24 bit input signal in Q0.24 format, this gives 4 bits of internal headroom in the audio pipeline.

Most modules in this library assume that the signal is in a specific global Q format. This format is defined by the Q_SIG macro. An additional macro for the signal exponent, SIG_EXP is defined, where SIG_EXP = - Q_SIG.

Q_SIG

Default Q format

SIG_EXP

Default signal exponent

To ensure optimal headroom and noise floor, the user should ensure that signals are in the correct Q format before processing. Either the input Q format can be converted to Q_SIG, or Q_SIG can be changed to the desired value.

Note

Not using the DSP pipeline tool means that Q formats will not automatically be managed, and the user should take care to ensure they have the correct values for optimum performance and signal level.

For example, for more precision, the pipeline can be configured to run with no headroom in Q0.31 format, but this would require manual headroom management (e.g. reducing the signal level before a boost to avoid clipping).

To convert between Q_SIG and Q0.31 in a safe and optimised way, the APIs below are provided.

int32_t adsp_from_q31(int32_t input)

Convert from Q0.31 to Q_SIG.

Parameters:

• input – Input in Q0.31 format

Returns:

int32_t Output in Q_SIG format

int32_t adsp_to_q31(int32_t input)

Convert from Q_SIG to Q0.31.

Parameters:

• input – Input in Q_SIG format

Returns:

int32_t Output in Q0.31 format