ETSI TS 126 273-2017 Digital cellular telecommunications system (Phase 2+) (GSM) Universal Mobile Telecommunications System (UMTS) LTE ANSI-C code for the fixed-point Extended Adap.pdf

1、 ETSI TS 126 273 V14.0.0 (2017-04) Digital cellular telecommunications system (Phase 2+) (GSM); Universal Mobile Telecommunications System (UMTS); LTE; ANSI-C code for the fixed-point Extended Adaptive Multi-Rate - Wideband (AMR-WB+) speech codec (3GPP TS 26.273 version 14.0.0 Release 14) floppy3TEC

2、HNICAL SPECIFICATION ETSI ETSI TS 126 273 V14.0.0 (2017-04)13GPP TS 26.273 version 14.0.0 Release 14Reference RTS/TSGS-0426273ve00 Keywords GSM,LTE,UMTS ETSI 650 Route des Lucioles F-06921 Sophia Antipolis Cedex - FRANCE Tel.: +33 4 92 94 42 00 Fax: +33 4 93 65 47 16 Siret N 348 623 562 00017 - NAF

3、742 C Association but non lucratif enregistre la Sous-Prfecture de Grasse (06) N 7803/88 Important notice The present document can be downloaded from: http:/www.etsi.org/standards-search The present document may be made available in electronic versions and/or in print. The content of any electronic

4、and/or print versions of the present document shall not be modified without the prior written authorization of ETSI. In case of any existing or perceived difference in contents between such versions and/or in print, the only prevailing document is the print of the Portable Document Format (PDF) vers

5、ion kept on a specific network drive within ETSI Secretariat. Users of the present document should be aware that the document may be subject to revision or change of status. Information on the current status of this and other ETSI documents is available at https:/portal.etsi.org/TB/ETSIDeliverableSt

6、atus.aspx If you find errors in the present document, please send your comment to one of the following services: https:/portal.etsi.org/People/CommiteeSupportStaff.aspx Copyright Notification No part may be reproduced or utilized in any form or by any means, electronic or mechanical, including photo

7、copying and microfilm except as authorized by written permission of ETSI. The content of the PDF version shall not be modified without the written authorization of ETSI. The copyright and the foregoing restriction extend to reproduction in all media. European Telecommunications Standards Institute 2

8、017. All rights reserved. DECTTM, PLUGTESTSTM, UMTSTMand the ETSI logo are Trade Marks of ETSI registered for the benefit of its Members. 3GPPTM and LTE are Trade Marks of ETSI registered for the benefit of its Members and of the 3GPP Organizational Partners. GSM and the GSM logo are Trade Marks reg

9、istered and owned by the GSM Association. ETSI ETSI TS 126 273 V14.0.0 (2017-04)23GPP TS 26.273 version 14.0.0 Release 14Intellectual Property Rights IPRs essential or potentially essential to the present document may have been declared to ETSI. The information pertaining to these essential IPRs, if

10、 any, is publicly available for ETSI members and non-members, and can be found in ETSI SR 000 314: “Intellectual Property Rights (IPRs); Essential, or potentially Essential, IPRs notified to ETSI in respect of ETSI standards“, which is available from the ETSI Secretariat. Latest updates are availabl

11、e on the ETSI Web server (https:/ipr.etsi.org/). Pursuant to the ETSI IPR Policy, no investigation, including IPR searches, has been carried out by ETSI. No guarantee can be given as to the existence of other IPRs not referenced in ETSI SR 000 314 (or the updates on the ETSI Web server) which are, o

12、r may be, or may become, essential to the present document. Foreword This Technical Specification (TS) has been produced by ETSI 3rd Generation Partnership Project (3GPP). The present document may refer to technical specifications or reports using their 3GPP identities, UMTS identities or GSM identi

13、ties. These should be interpreted as being references to the corresponding ETSI deliverables. The cross reference between GSM, UMTS, 3GPP and ETSI identities can be found under http:/webapp.etsi.org/key/queryform.asp. Modal verbs terminology In the present document “shall“, “shall not“, “should“, “s

14、hould not“, “may“, “need not“, “will“, “will not“, “can“ and “cannot“ are to be interpreted as described in clause 3.2 of the ETSI Drafting Rules (Verbal forms for the expression of provisions). “must“ and “must not“ are NOT allowed in ETSI deliverables except when used in direct citation. ETSI ETSI

15、 TS 126 273 V14.0.0 (2017-04)33GPP TS 26.273 version 14.0.0 Release 14Contents Intellectual Property Rights 2g3Foreword . 2g3Modal verbs terminology 2g3Foreword . 4g31 Scope 5g32 References 5g33 Definitions and abbreviations . 5g33.1 Definitions 5g33.2 Abbreviations . 5g34 C code structure 6g34.1 Co

16、ntents of the C source code 6g34.2 Program execution 6g34.3 Code hierarchy . 6g34.5 Variables, constants and tables . 20g34.5.1 Description of fixed tables used in the C-code . 20g34.5.2 Static variables used in the C-code . 21g35 File formats 27g35.1 Audio file (encoder input/decoder output) . 27g3

17、5.2 Parameter bitstream file (encoder output/decoder input) . 27g3Annex A (informative): Change history . 28g3History 29g3ETSI ETSI TS 126 273 V14.0.0 (2017-04)43GPP TS 26.273 version 14.0.0 Release 14Foreword This Technical Specification has been produced by the 3rdGeneration Partnership Project (3

18、GPP). The contents of the present document are subject to continuing work within the TSG and may change following formal TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an identifying change of release date and an increase in version n

19、umber as follows: Version x.y.z where: x the first digit: 1 presented to TSG for information; 2 presented to TSG for approval; 3 or greater indicates TSG approved document under change control. y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections,

20、updates, etc. z the third digit is incremented when editorial only changes have been incorporated in the document. ETSI ETSI TS 126 273 V14.0.0 (2017-04)53GPP TS 26.273 version 14.0.0 Release 141 Scope The present document contains an electronic copy of the ANSI-C code for the Fixed-point Extended A

21、daptive Multi-Rate Wideband codec. Alternatively, floating-point ANSI-C code is specified in 3GPP TS 26.304 1. The fixed-point codec/encoder/decoder specified in the present document or the floating-point codec/encoder/decoder specified in 3GPP TS 26.304 1 may be used depending on if the implementat

22、ion platform is better suited for a floating-point or a fixed-point implementation. It has been verified that the fixed-point and floating-point codecs interoperate with each other without any artifacts. The fixed-point ANSI-C code in the present document defines, besides the floating-point c-code s

23、pecified in 3GPP TS 26.304 1, one valid reference implementation of the Extended Adaptive Multi-Rate Wideband transcoder (3GPP TS 26.290 2). Standard conformance it is enforced by meeting the conformance criteria defined in 3GPP TS 26.274 3. 2 References The following documents contain provisions wh

24、ich, through reference in this text, constitute provisions of the present document. References are either specific (identified by date of publication, edition number, version number, etc.) or non-specific. For a specific reference, subsequent revisions do not apply. For a non-specific reference, the

25、 latest version applies. In the case of a reference to a 3GPP document (including a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same Release as the present document. 1 3GPP TS 26.304: “Extended Adaptive Multi-Rate - Wideband (AMR-WB+) codec

26、; Floating-point ANSI-C code“. 2 3GPP TS 26.290: “Audio codec processing functions; Extended Adaptive Multi-Rate - Wideband (AMR-WB+) codec; Transcoding functions“. 3 3GPP TS 26.274: “Speech codec speech processing functions; Extended Adaptive Multi-Rate - Wideband (AMR-WB+) speech codec; Conformanc

27、e testing“. 4 3GPP TS 26.244: “Transparent end-to-end packet switched streaming service (PSS); 3GPP file format (3GP)“. 3 Definitions and abbreviations 3.1 Definitions For the purposes of the present document, the terms and definitions are given in 3GPP TS 26.290 1. 3.2 Abbreviations For the purpose

28、s of the present document, the following abbreviations apply: AMR-WB+ Extended Adaptive Multi-Rate WideBand ANSI American National Standards Institute ETS European Telecommunication Standard GSM Global System for Mobile communications I/O Input/OutputRAM Random Access Memory ROM Read Only Memory ETS

29、I ETSI TS 126 273 V14.0.0 (2017-04)63GPP TS 26.273 version 14.0.0 Release 144 C code structure This clause gives an overview of the structure of the bit-exact C code and provides an overview of the contents and organization of the C code attached to the present document. The C code has been verified

30、 on the following systems: - IBM PC/AT compatible computers with Windows 2000 SP4 and Microsoft Visual C+ v.6.0 compiler. ANSI-C was selected as the programming language because portability was desirable. 4.1 Contents of the C source code The C code distribution has the files divided in six differen

31、t directories, all present in the directory c-code. The directories are: common_fx, decoder_fx, encoder_fx, lib_amr_fx include_fx and basic_op. The distributed files with suffix “c“ contain the source code and the files with suffix “h“ are the header files. Project and workspace files are provided i

32、n the directory MSVC. 4.2 Program execution The Extended Adaptive Multi-Rate Wideband codec is implemented in two programs: - (encoder) audio encoder; - (decoder) audio decoder. The programs should be called like: - encoder encoder options -if -of ; - decoder decoder options -if -of . The input file

33、s contain one or two channels of 16-bit linear encoded PCM audio samples stored in the wav file format and the parameter files contain encoded audio data and some additional flags. The encoder and decoder options will be explained by running the applications without input arguments. Detailed informa

34、tion explaining the use of the AMR-WB+ encoder and decoder programs is provided in the users guide in Annex A of 1. See also the file readme.txt for condensed information on how to run the encoder and decoder programs. 4.3 Code hierarchy Tables 1 and 2 are call graphs that show the functions used in

35、 the audio codec. Each column represents a call level and each cell a function. The functions contain calls to the functions in rightwards neighbouring cells. The time order in the call graphs is from the top downwards as the processing of a frame advances. All standard C functions: printf(), fwrite

36、(), etc. have been omitted. Also, no basic operations (add(), L_add(), mac(), etc.) or double precision extended operations (e.g. L_Extract(), Copy() or Set_zero() appear in the graphs. The initialization of the static RAM (i.e. calling the _init functions) is also omitted. The basic operations are

37、not counted as extending the depth, therefore the deepest level in this software is level 6. ETSI ETSI TS 126 273 V14.0.0 (2017-04)73GPP TS 26.273 version 14.0.0 Release 14Table 1: Encoder call structure coder_amrwb_plus_stereo Scale_speech_st Rescale_enc_mem_st Scale_sig Decim_12k8_p Interpol HP50_

38、12k8_p Mix_ch Preemph_scaled Rescale_enc_mem_st Coder_lf AutocorrPlus Lag_window_p Levinson Az_isp Chebps2 Int_lpc Isp_Az Get_isp_pol Find_wsp Weight_a Residu2 Deemph LP_Decim2 Scale_sig scale_mem_Hp_wsp Pitch_med_ol Hp_wsp Isp_isf Qpisf_2s_46b VQ_stage1 Sub_VQ Dpisf_2s_46b Reorder_isf ETSI ETSI TS

39、126 273 V14.0.0 (2017-04)83GPP TS 26.273 version 14.0.0 Release 14coder_acelp Scale_sig Residu Weight_a Syn_filt Deemph2 Preemph Syn_filt_s Pitch_fr4 Norm_Corr Convolve Interpol_4 Pred_lt4 Convolve G_pitch Updt_tar Pit_shrp cor_h_x ACELP_4t64_fx cor_h_vec search_ixiy Quant_2p_2N1 Quant_1p_N1 Quant_3

40、p_3N1 Quant_2p_2N1 Quant_4p_4N Quant_4p_4N1 Quant_2p_2N1 Quant_5p_5N Quant_3p_3N1 Quant_2p_2N1 Quant_6p_6N_2 Quant_5p_5N Quant_3p_3N1 Quant_2p_2N1 Quant_4p_4N Quant_4p_4N1 Quant_2p_2N1 Quant_3p_3N1 Quant_2p_2N1 Quant_2p_2N1 ETSI ETSI TS 126 273 V14.0.0 (2017-04)93GPP TS 26.273 version 14.0.0 Release

41、 14Quant_1p_N1 Q_gain2_plus Segsnr Coder_tcx Cos_window Weight_a Residu2 Deemph fft9_fx init_r_fft_fx r_fft_fx FFT_reorder Adap_low_freq_emph SpPeak1k6 AVQ_Cod RE8_PPV_FX Nearest_neighbor_2D8 Scale_tcx_ifft Scale_sig Adap_low_freq_deemph SpPeak1k6 Deemph1k6 Ifft_reorder ifft9_fx r_fft_fx Get_gain Q_

42、gain_tcx Preemph Scale_sig Syn_filt_s Scale_speech Rescale_enc_mem_hf coder_hf AutocorrPlus Lag_window_p Levinson_p Az_isp_p Chebps2 ETSI ETSI TS 126 273 V14.0.0 (2017-04)103GPP TS 26.273 version 14.0.0 Release 14Int_lpc Isp_Az Get_isp_pol Isp_isf Q_isf_hf Sub_VQ Reorder_isf Isf_isp Match_gain_6k4 R

43、esidu Syn_filt Scale_sig Int_gain Residu2 Syn_filt_s E_LPC_a_weight Weight_a Q_gain_hf Band_split_taligned_2k Decim_2k Interpol_st Oversamp_2k Interpol_st Coder_stereo_x Cod_hi_stereo Residu2 Compute_exc_side Compute_cross_corr_vector Cholsolc Cholsolc_repair Smooth_ener_filter ETSI ETSI TS 126 273

44、V14.0.0 (2017-04)113GPP TS 26.273 version 14.0.0 Release 14quant_filt Pmsvq2 Msvq2 M_cbcod Fir_filt Compute_gain_match Quant_gain Cod_tcx_stereo Ctcx_stereo Cos_window Windowing Comp_gain_shap_cod Apply_gain_shap Get_gain Q_gain_pan Compute_xn_target Fft3 r_fft_fx FFT_reorder Adap_low_freq_emph SpPe

45、ak1k6 AVQ_Cod RE8_PPV_FX Nearest_neighbor_2D8 Scale_tcx_ifft Scale_sig Adap_low_freq_deemph SpPeak1k6 Deemph1k6 Ifft_reorder Ifft3 r_fft_fx Q_gain_tcx Apply_tcx_overlap Segsnr ETSI ETSI TS 126 273 V14.0.0 (2017-04)123GPP TS 26.273 version 14.0.0 Release 14Int2bin Enc_prm Int2bin AVQ_encmux split_idx

46、_noovf sort(avq_cod.c) RE8_cod RE8_vor Re8_identify_absolute Leader Re8_coord Re8_k2y RE8_PPV_FX Nearest_neighbor_2D8 Re8_compute_base_index Re8_compute_rank_of_permutation_and_s calc_bits writ_all_nq calc_bits writ_all_i init_pos_i_ovf chk_ovf chk_ovf writ_I writ_k writ_ovf Unpack4bits Int2bin Enc_

47、prm_stereo_x Iint2bin AVQ_encmux split_idx_noovf sort(avq_cod.c) RE8_cod RE8_vor re8_identify_absolute Leader re8_coord ETSI ETSI TS 126 273 V14.0.0 (2017-04)133GPP TS 26.273 version 14.0.0 Release 14re8_k2y RE8_PPV_FX nearest_neighbor_2D8 re8_compute_base_index re8_compute_rank_of_permutation_and_s

48、 calc_bits writ_all_nq calc_bits writ_all_i init_pos_i_ovf chk_ovf chk_ovf writ_I writ_ovf writ_k unpack4bits_d int2bin Enc_prm_hf int2bin ETSI ETSI TS 126 273 V14.0.0 (2017-04)143GPP TS 26.273 version 14.0.0 Release 14Table 2: Decoder call structure ETSI ETSI TS 126 273 V14.0.0 (2017-04)153GPP TS 26.273 version 14.0.0 Release 14Decoder_amrwb_plus Bin2t Dec_prm Bin2int Pack4bitsBin2t Dec_prm_stereo_x Bin2int Pack4bits_d Bin2t AVQ_Demuxdec Read_all_nq Read_nq ead_li Init_pos_i_ovf Chk_ovf Split_n Chkovf ReadI_ k RE8_Dec R