ETSI TS 126 173-2017 Digital cellular telecommunications system (Phase 2+) (GSM) Universal Mobile Telecommunications System (UMTS) LTE ANSI-C code for the Adaptive Multi-Rate - Wid.pdf

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

2、TSI ETSI TS 126 173 V14.0.0 (2017-04)13GPP TS 26.173 version 14.0.0 Release 14Reference RTS/TSGS-0426173ve00 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 742 C Association but

3、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 and/or print versions

4、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) version kept on a specific

5、 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/ETSIDeliverableStatus.aspx If you find

6、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 photocopying and microfilm

7、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 2017. All rights reserv

8、ed. 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 registered and owned by t

9、he GSM Association. ETSI ETSI TS 126 173 V14.0.0 (2017-04)23GPP TS 26.173 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 any, is publicly avai

10、lable 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 available on the ETSI Web serv

11、er (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, or may be, or may becom

12、e, 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 identities. These should be

13、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“, “should not“, “may“, “ne

14、ed 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 TS 126 173 V14.0.0 (2

15、017-04)33GPP TS 26.173 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 Contents of the C source

16、 code 6g34.2 Program execution 6g34.3 Code hierarchy . 6g34.5 Variables, constants and tables . 10g34.5.1 Description of constants used in the C-code . 11g34.5.2 Description of fixed tables used in the C-code . 11g34.5.3 Static variables used in the C-code . 12g35 Homing procedure 16g36 File formats

17、 16g36.1 Speech file (encoder input / decoder output) 16g36.2 Mode control file (encoder input) . 16g36.3 Parameter bitstream file (encoder output / decoder input) . 17g3Default 3GPP format: 17g3ITU format (activated with command line parameter -itu) . 18g3MIME/file storage format (activated with co

18、mmand line parameter -mime) 18g3Annex A (informative): Change history . 19g3History 20g3ETSI ETSI TS 126 173 V14.0.0 (2017-04)43GPP TS 26.173 version 14.0.0 Release 14Foreword This Technical Specification (TS) has been produced by the 3rdGeneration Partnership Project (3GPP). The contents of the pre

19、sent 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 number as follows: Version x.y

20、.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, updates, etc. z the third dig

21、it is incremented when editorial only changes have been incorporated in the document. ETSI ETSI TS 126 173 V14.0.0 (2017-04)53GPP TS 26.173 version 14.0.0 Release 141 Scope The present document contains an electronic copy of the ANSI-C code for the Adaptive Multi-Rate Wideband codec. The ANSI-C code

22、 is necessary for a bit exact implementation of the Adaptive Multi Rate Wideband speech transcoder (3GPP TS 26.190 2), Voice Activity Detection (3GPP TS 26.194 6), comfort noise (3GPP TS 26.192 4), source controlled rate operation (3GPP TS 26.193 5) and example solutions for substituting and muting

23、of lost frames (3GPP TS 26.191 3). 2 References The following documents contain provisions which, 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. F

24、or a specific reference, subsequent revisions do not apply. For a non-specific reference, the 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

25、 present document. 1 3GPP TS 26.174: “AMR Wideband Speech Codec; Test sequences“. 2 3GPP TS 26.190: “AMR Wideband Speech Codec; Speech transcoding“. 3 3GPP TS 26.191: “AMR Wideband Speech Codec; Substitution and muting of lost frames“. 4 3GPP TS 26.192: “AMR Wideband Speech Codec; Comfort noise aspe

26、cts“. 5 3GPP TS 26.193: “AMR Wideband Speech Codec; Source controlled rate operation“. 6 3GPP TS 26.194: “AMR Wideband Speech Codec; Voice Activity Detection“. 7 RFC 3267 “A Real-Time Transport Protocol (RTP) Payload Format and File Storage Format for Adaptive Multi-Rate (AMR) and Adaptive Multi-Rat

27、e Wideband (AMR-WB) Audio Codecs, June 2002. 3 Definitions and abbreviations 3.1 Definitions Definition of terms used in the present document, can be found in 3GPP TS 26.190 2, 3GPP TS 26.191 3, 3GPP TS 26.192 4, 3GPP TS 26.193 5 and 3GPP TS 26.194 6. 3.2 Abbreviations For the purpose of the present

28、 document, the following abbreviations apply: AMR-WB 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 ETSI ETSI TS 126 173 V14.0.0

29、(2017-04)63GPP TS 26.173 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 this document. The C code has been verified on the following systems: - Sun

30、Microsystems workstations and GNU gcc compiler - HP workstations and cc compiler - IBM PC compatible computers with Windows NT4 operating system and GNU gcc compiler. ANSI-C was selected as the programming language because portability was desirable. 4.1 Contents of the C source code The C code distr

31、ibution has all files in the root level. The distributed files with suffix “c“ contain the source code and the files with suffix “h“ are the header files. The ROM data is contained mostly in files with suffix “tab“. The C code distribution also contains one speech coder installation verification dat

32、a file, “spch_dos.inp“. The reference encoder output file is named “spch_dos.cod“, the reference decoder input file is named “spch_dos.dec“ and the reference decoder output file is named “spch_dos.out“. These four files are formatted such that they are correct for an IBM PC/AT compatible computer. T

33、he same files with reversed byte order of the 16 bit words are named “spch_unx.inp“, “spch_unx.cod“, “spch_unx.dec“ and “spch_unx.out“, respectively. Final verification is to be performed using the GSM Adaptive Multi-Rate Wideband test sequences described in 3GPP TS 26.174 1. Makefiles are provided

34、for the platforms in which the C code has been verified (listed above). Once the software is installed, this directory will have a compiled version of encoder and decoder (the bit-exact C executables of the speech codec) and all the object files. 4.2 Program execution The GSM Adaptive Multi-Rate Wid

35、eband codec is implemented in two programs: - (encoder) speech encoder; - (decoder) speech decoder. The programs should be called like: - encoder encoder options ; - decoder . The speech files contain 16-bit linear encoded PCM speech samples and the parameter files contain encoded speech data and so

36、me additional flags. The encoder and decoder options will be explained by running the applications without input arguments. See the file readme.txt for more information on how to run the encoder and decoder programs. 4.3 Code hierarchy Tables 1 to 3 are call graphs that show the functions used in th

37、e speech codec, including the functions of VAD, DTX, and comfort noise generation. 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 processin

38、g of a frame advances. ETSI ETSI TS 126 173 V14.0.0 (2017-04)73GPP TS 26.173 version 14.0.0 Release 14All standard C functions: printf(), fwrite(), etc. have been omitted. Also, no basic operations (add(), L_add(), mac(), etc.) or double precision extended operations (e.g. L_Extract() appear in the

39、graphs. The initialization of the static RAM (i.e. calling the _init functions) is also omitted. The basic operations are not counted as extending the depth, therefore the deepest level in this software is level 6. The encoder call graph is broken down into two separate call graphs, Table 1 to 2. ET

40、SI ETSI TS 126 173 V14.0.0 (2017-04)83GPP TS 26.173 version 14.0.0 Release 14Table 1: Speech encoder call structure coder Copy Decim_12k8 Down_samp Interpol (function) Copy Set_zero HP50_12k8Scale_sigwb_vad Filter_bank Filter5 Filter3 Level_calculationvad_decision Ilog2Noise_estimate_update update_c

41、ntrl hangover_additionEstimate_Speech tx_dtx_handler Parm_serialAutocorr Lag_window LevinsonAz_isp Chebps2 Int_isp Isp_Az Get_isp_pol Isp_isf Gp_clip_test_isf Weight_a Residu Deemph2 LP_Decim2 Scale_mem_Hp_wsp Pitch_med_ol Hp_wsp Isqrt_n wb_vad_tone_detection Med_olag median5 dtx_buffer Copy dtx_enc

42、 Find_frame_indices Aver_isf_history Qisf_ns Sub_VQ Disf_ns Reorder_isf Parm_serialPow2Random Dot_product12 Isqrt_n Isf_isp Isp_Az Get_isp_pol Synthesis Copy Syn_filt_32 Deemph_32 HP50_12k8 Random Scale_sigDot_product12 Isqrt_nHP400_12k8 Weight_a Syn_filtFilt_6k_7k Reset_encoder Set_zero Init_gp_cli

43、pt_Phase_dispersion Set_zeroQpisf_2s_36b VQ_stage1 Sub_VQ Dpisf_2s_36b Reorder_isf Qpisf_2s_46b VQ_stage1 Sub_VQ Dpisf_2s_46b Reorder_isfSyn_filt Preemph2itch_fr4 Norm_Corr Convolve Isqrt_n Interpol_4 Gp_clip Pred_lt4ConvolveG_pitch Dot_product12 Updt_tar PreemphPit_shrp Cor_h_x ACELP_2t64_fx Dot_pr

44、oduct12 Isqrt_n ACELP_4t64_fx See Table 2 Q_gain2 Dot_product12 Pow2Gp_clip_test_gain_pit voice_factor Dot_product12 ETSI ETSI TS 126 173 V14.0.0 (2017-04)93GPP TS 26.173 version 14.0.0 Release 14Table 2: ACELP_4t64_fx call structure ACELP_4t64_fx Dot_product12 Isqrt_ncor_h_vecsearch_ixiy quant_1p_N

45、1 quant_2p_2N1quant_3p_3N1 quant_2p_2N1 quant_1p_N1quant_4p_4N quant_4p_4N1 Quant_2p_2N1 quant_1p_N1 quant_3p_3N1 Quant_2p_2N1Quant_1p_N1quant_2p_2N1 quant_5p_5N quant_3p_3N1 Quant_2p_2N1Quant_1p_N1quant_2p_2N1 quant_6p_6N_2 quant_5p_5N Quant_3p_3N1 quant_2p_2N1 Quant_1p_N1quant_2p_2N1quant_1p_N1 qu

46、ant_4p_4N quant_4p_4N1 quant_2p_2N1 quant_1p_N1quant_3p_3N1 quant_2p_2N1quant_1p_N1quant_2p_2N1 quant_2p_2N1 quant_3p_3N1 quant_2p_2N1Quant_1p_N1ETSI ETSI TS 126 173 V14.0.0 (2017-04)103GPP TS 26.173 version 14.0.0 Release 14Table 3: Speech decoder call structure decoder Rx_dtx_handler Dtx_dec Copy

47、Disf_ns Reorder_isf Serial_parm Pow2RandomDot_product12 Isqrt_n Serial_parm Isf_p Isp_Az Get_isp_pol Copy Synthesis Copy Syn_filt_32 Deemph_32 HP50_12k8 Oversamp_16k Copy Up_samp Interpol Random Scale_sig Dot_product12Isqrt_n HP400_12k8 Isf_Extrapolation Isf_isp Isp_Az Get_isp_polWeight_a Syn_filt F

48、ilt_6k_7k Copy Filt_7k CReset_decoder Set_zero Init_Phase_dispersion Set_zeroDpisf_2s_36b Reorder_isf pisf_2s_46b Reorder_isfInt_isp Isp_Az Get_isp_pol Lagconc insertion_sort InsertRandom Pred_lt4 Random DEC_ACELP_2t64_fx EC_ACELP_4t64_fx dec_1p_N1 add_pulses dec_2p_2N1dec_3p_3N1 Dec_2p_2N1 dec_1p_N

49、1dec_4p_4N dec_4p_4N1 dec_2p_2N1 dec_1p_N1Dec_3p_3N1 Dec_2p_2N1Dec_1p_N1Dec_2p_2N1 dec_5p_5N dec_3p_3N1 Dec_2p_2N1 Dec_1p_N1Dec_2p_2N1 dec_6p_6N_2 Dec_5p_5N dec_3p_3N1 Dec_2p_2N1 Dec_1p_N1dec_2p_2N1 dec_1p_N1 dec_4p_4N dec_4p_4N1 dec_2p_2N1 dec_1p_N1Dec_3p_3N1 Dec_2p_2N1Dec_1p_N1Dec_2p_2N1 dec_2p_2N1 dec_3p_3N1 Dec_2p_2N1 Dec_1p_N1Preemph it_shp D_gain2 Dot_product12 Isqrt_n Median5Pow2Scale_sig voice_factor Dot_product12 Phase_dispersion Set_zeroAgc2 Isqrt Isq