/* * Copyright (c) 2011 The WebRTC project authors. All Rights Reserved. * * Use of this source code is governed by a BSD-style license * that can be found in the LICENSE file in the root of the source * tree. An additional intellectual property rights grant can be found * in the file PATENTS. All contributing project authors may * be found in the AUTHORS file in the root of the source tree. */ /* * settings.h * * Declaration of #defines used in the iSAC codec * */ #ifndef WEBRTC_MODULES_AUDIO_CODING_CODECS_ISAC_FIX_SOURCE_SETTINGS_H_ #define WEBRTC_MODULES_AUDIO_CODING_CODECS_ISAC_FIX_SOURCE_SETTINGS_H_ /* sampling frequency (Hz) */ #define FS 16000 /* 1.5 times Sampling frequency */ #define FS_1_HALF (uint32_t) 24000 /* Three times Sampling frequency */ #define FS3 (uint32_t) 48000 /* Eight times Sampling frequency */ #define FS8 (uint32_t) 128000 /* number of samples per frame (either 480 (30ms) or 960 (60ms)) */ #define INITIAL_FRAMESAMPLES 960 /* miliseconds */ #define FRAMESIZE 30 /* number of samples per frame processed in the encoder (30ms) */ #define FRAMESAMPLES 480 /* ((FRAMESIZE*FS)/1000) */ #define FRAMESAMPLES_HALF 240 /* max number of samples per frame (= 60 ms frame) */ #define MAX_FRAMESAMPLES 960 /* number of samples per 10ms frame */ #define FRAMESAMPLES_10ms 160 /* ((10*FS)/1000) */ /* Number of samples per 1 ms */ #define SAMPLES_PER_MSEC 16 /* number of subframes */ #define SUBFRAMES 6 /* length of a subframe */ #define UPDATE 80 /* length of half a subframe (low/high band) */ #define HALF_SUBFRAMELEN 40 /* (UPDATE/2) */ /* samples of look ahead (in a half-band, so actually half the samples of look ahead @ FS) */ #define QLOOKAHEAD 24 /* 3 ms */ /* order of AR model in spectral entropy coder */ #define AR_ORDER 6 #define MAX_ORDER 13 #define LEVINSON_MAX_ORDER 12 /* window length (masking analysis) */ #define WINLEN 256 /* order of low-band pole filter used to approximate masking curve */ #define ORDERLO 12 /* order of hi-band pole filter used to approximate masking curve */ #define ORDERHI 6 #define KLT_NUM_AVG_GAIN 0 #define KLT_NUM_AVG_SHAPE 0 #define KLT_NUM_MODELS 3 #define LPC_SHAPE_ORDER 18 /* (ORDERLO + ORDERHI) */ #define KLT_ORDER_GAIN 12 /* (2 * SUBFRAMES) */ #define KLT_ORDER_SHAPE 108 /* (LPC_SHAPE_ORDER * SUBFRAMES) */ /* order for post_filter_bank */ #define POSTQORDER 3 /* order for pre-filterbank */ #define QORDER 3 /* for decimator */ #define ALLPASSSECTIONS 2 /* The number of composite all-pass filter factors */ #define NUMBEROFCOMPOSITEAPSECTIONS 4 /* The number of all-pass filter factors in an upper or lower channel*/ #define NUMBEROFCHANNELAPSECTIONS 2 #define DPMIN_Q10 -10240 /* -10.00 in Q10 */ #define DPMAX_Q10 10240 /* 10.00 in Q10 */ #define MINBITS_Q10 10240 /* 10.0 in Q10 */ /* array size for byte stream in number of Word16. */ #define STREAM_MAXW16 300 /* The old maximum size still needed for the decoding */ #define STREAM_MAXW16_30MS 100 /* 100 Word16 = 200 bytes = 53.4 kbit/s @ 30 ms.framelength */ #define STREAM_MAXW16_60MS 200 /* 200 Word16 = 400 bytes = 53.4 kbit/s @ 60 ms.framelength */ /* This is used only at the decoder bit-stream struct. * - The encoder and decoder bitstream containers are of different size because * old iSAC limited the encoded bitstream to 600 bytes. But newer versions * restrict to shorter bitstream. * - We add 10 bytes of guards to the internal bitstream container. The reason * is that entropy decoder might read few bytes (3 according to our * observations) more than the actual size of the bitstream. To avoid reading * outside memory, in rare occasion of full-size bitstream we add 10 bytes * of guard. */ #define INTERNAL_STREAM_SIZE_W16 (STREAM_MAXW16 + 5) /* storage size for bit counts */ //#define BIT_COUNTER_SIZE 30 /* maximum order of any AR model or filter */ #define MAX_AR_MODEL_ORDER 12 /* Maximum number of iterations allowed to limit payload size */ #define MAX_PAYLOAD_LIMIT_ITERATION 1 /* Bandwidth estimator */ #define MIN_ISAC_BW 10000 /* Minimum bandwidth in bits per sec */ #define MAX_ISAC_BW 32000 /* Maxmum bandwidth in bits per sec */ #define MIN_ISAC_MD 5 /* Minimum Max Delay in ?? */ #define MAX_ISAC_MD 25 /* Maxmum Max Delay in ?? */ #define DELAY_CORRECTION_MAX 717 #define DELAY_CORRECTION_MED 819 #define Thld_30_60 18000 #define Thld_60_30 27000 /* assumed header size; we don't know the exact number (header compression may be used) */ #define HEADER_SIZE 35 /* bytes */ #define INIT_FRAME_LEN 60 #define INIT_BN_EST 20000 #define INIT_BN_EST_Q7 2560000 /* 20 kbps in Q7 */ #define INIT_REC_BN_EST_Q5 789312 /* INIT_BN_EST + INIT_HDR_RATE in Q5 */ /* 8738 in Q18 is ~ 1/30 */ /* #define INIT_HDR_RATE (((HEADER_SIZE * 8 * 1000) * 8738) >> NUM_BITS_TO_SHIFT (INIT_FRAME_LEN)) */ #define INIT_HDR_RATE 4666 /* number of packets in a row for a high rate burst */ #define BURST_LEN 3 /* ms, max time between two full bursts */ #define BURST_INTERVAL 800 /* number of packets in a row for initial high rate burst */ #define INIT_BURST_LEN 5 /* bits/s, rate for the first BURST_LEN packets */ #define INIT_RATE 10240000 /* INIT_BN_EST in Q9 */ /* For pitch analysis */ #define PITCH_FRAME_LEN 240 /* (FRAMESAMPLES/2) 30 ms */ #define PITCH_MAX_LAG 140 /* 57 Hz */ #define PITCH_MIN_LAG 20 /* 400 Hz */ #define PITCH_MIN_LAG_Q8 5120 /* 256 * PITCH_MIN_LAG */ #define OFFSET_Q8 768 /* 256 * 3 */ #define PITCH_MAX_GAIN_Q12 1843 /* 0.45 */ #define PITCH_LAG_SPAN2 65 /* (PITCH_MAX_LAG/2-PITCH_MIN_LAG/2+5) */ #define PITCH_CORR_LEN2 60 /* 15 ms */ #define PITCH_CORR_STEP2 60 /* (PITCH_FRAME_LEN/4) */ #define PITCH_SUBFRAMES 4 #define PITCH_SUBFRAME_LEN 60 /* (PITCH_FRAME_LEN/PITCH_SUBFRAMES) */ /* For pitch filter */ #define PITCH_BUFFSIZE 190 /* (PITCH_MAX_LAG + 50) Extra 50 for fraction and LP filters */ #define PITCH_INTBUFFSIZE 430 /* (PITCH_FRAME_LEN+PITCH_BUFFSIZE) */ #define PITCH_FRACS 8 #define PITCH_FRACORDER 9 #define PITCH_DAMPORDER 5 /* Order of high pass filter */ #define HPORDER 2 /* PLC */ #define DECAY_RATE 10 /* Q15, 20% of decay every lost frame apllied linearly sample by sample*/ #define PLC_WAS_USED 1 #define PLC_NOT_USED 3 #define RECOVERY_OVERLAP 80 #define RESAMP_RES 256 #define RESAMP_RES_BIT 8 /* Define Error codes */ /* 6000 General */ #define ISAC_MEMORY_ALLOCATION_FAILED 6010 #define ISAC_MODE_MISMATCH 6020 #define ISAC_DISALLOWED_BOTTLENECK 6030 #define ISAC_DISALLOWED_FRAME_LENGTH 6040 /* 6200 Bandwidth estimator */ #define ISAC_RANGE_ERROR_BW_ESTIMATOR 6240 /* 6400 Encoder */ #define ISAC_ENCODER_NOT_INITIATED 6410 #define ISAC_DISALLOWED_CODING_MODE 6420 #define ISAC_DISALLOWED_FRAME_MODE_ENCODER 6430 #define ISAC_DISALLOWED_BITSTREAM_LENGTH 6440 #define ISAC_PAYLOAD_LARGER_THAN_LIMIT 6450 /* 6600 Decoder */ #define ISAC_DECODER_NOT_INITIATED 6610 #define ISAC_EMPTY_PACKET 6620 #define ISAC_PACKET_TOO_SHORT 6625 #define ISAC_DISALLOWED_FRAME_MODE_DECODER 6630 #define ISAC_RANGE_ERROR_DECODE_FRAME_LENGTH 6640 #define ISAC_RANGE_ERROR_DECODE_BANDWIDTH 6650 #define ISAC_RANGE_ERROR_DECODE_PITCH_GAIN 6660 #define ISAC_RANGE_ERROR_DECODE_PITCH_LAG 6670 #define ISAC_RANGE_ERROR_DECODE_LPC 6680 #define ISAC_RANGE_ERROR_DECODE_SPECTRUM 6690 #define ISAC_LENGTH_MISMATCH 6730 /* 6800 Call setup formats */ #define ISAC_INCOMPATIBLE_FORMATS 6810 #endif /* WEBRTC_MODULES_AUDIO_CODING_CODECS_ISAC_FIX_SOURCE_SETTINGS_H_ */