ETSI TS 126 443-2018 Universal Mobile Telecommunications System (UMTS) LTE Codec for Enhanced Voice Services (EVS) ANSI C code (floating-point) (V14 1 0 3GPP TS 26 443 version 14 1.pdf

1、 ETSI TS 126 443 V14.1.0 (2018-01) Universal Mobile Telecommunications System (UMTS); LTE; Codec for Enhanced Voice Services (EVS); ANSI C code (floating-point) (3GPP TS 26.443 version 14.1.0 Release 14) floppy3TECHNICAL SPECIFICATION ETSI ETSI TS 126 443 V14.1.0 (2018-01)13GPP TS 26.443 version 14.

2、1.0 Release 14Reference RTS/TSGS-0426443ve10 Keywords 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 non lucratif enregistre la Sous-Prfecture de Grasse (06) N 7803/88 I

3、mportant 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 of the present document shall not be modified without the prior writ

4、ten 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 network drive within ETSI Secretariat. Users of the present documen

5、t 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 errors in the present document, please send your comment to one of t

6、he 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 except as authorized by written permission of ETSI. The content of t

7、he PDF version shall not be modified without the written authorization of ETSI. The copyright and the foregoing restriction extend to reproduction in all media. ETSI 2018. All rights reserved. DECTTM, PLUGTESTSTM, UMTSTMand the ETSI logo are trademarks of ETSI registered for the benefit of its Membe

8、rs. 3GPPTM and LTE are trademarks of ETSI registered for the benefit of its Members and of the 3GPP Organizational Partners. oneM2M logo is protected for the benefit of its Members. GSM and the GSM logo are trademarks registered and owned by the GSM Association. ETSI ETSI TS 126 443 V14.1.0 (2018-01

9、)23GPP TS 26.443 version 14.1.0 Release 14Intellectual Property Rights Essential patents 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 available for ETSI members and non-members,

10、 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 server (https:/ipr.etsi.org/). Pursuant to

11、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 become, essential to the present document. T

12、rademarks The present document may include trademarks and/or tradenames which are asserted and/or registered by their owners. ETSI claims no ownership of these except for any which are indicated as being the property of ETSI, and conveys no right to use or reproduce any trademark and/or tradename. M

13、ention of those trademarks in the present document does not constitute an endorsement by ETSI of products, services or organizations associated with those trademarks. Foreword This Technical Specification (TS) has been produced by ETSI 3rd Generation Partnership Project (3GPP). The present document

14、may refer to technical specifications or reports using their 3GPP identities, UMTS identities or GSM identities. 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.ets

15、i.org/key/queryform.asp. Modal verbs terminology In the present document “shall“, “shall not“, “should“, “should 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)

16、. “must“ and “must not“ are NOT allowed in ETSI deliverables except when used in direct citation. ETSI ETSI TS 126 443 V14.1.0 (2018-01)33GPP TS 26.443 version 14.1.0 Release 14Contents Intellectual Property Rights 2g3Foreword . 2g3Modal verbs terminology 2g3Foreword . 4g31 Scope 5g32 References 5g3

17、3 Definitions and abbreviations . 6g33.1 Definitions 6g33.2 Abbreviations . 6g34 C code structure 6g34.1 Contents of the C source code 7g34.2 Program execution 7g35 File formats 7g35.1 Input/output file format 7g35.2 Rate switching profile (encoder input) . 8g35.3 Parameter bitstream file (encoder o

18、utput / decoder input) . 8g35.3.1 ITU-T G.192 compliant format . 8g35.3.2 Compact storage format file 8g35.4 VoIP parameter bitstream file (decoder input) . 8g35.5 Bandwidth switching profile (encoder input) . 9g35.6 Channel-aware configuration file (encoder input and decoder output) 9g35.7 JBM trac

19、e file (decoder output) 9g3Annex A (informative): Change history . 10g3History 11g3ETSI ETSI TS 126 443 V14.1.0 (2018-01)43GPP TS 26.443 version 14.1.0 Release 14Foreword This Technical Specification has been produced by the 3rdGeneration Partnership Project (3GPP). The contents of the present docum

20、ent 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.z where:

21、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 digit is incr

22、emented when editorial only changes have been incorporated in the document. ETSI ETSI TS 126 443 V14.1.0 (2018-01)53GPP TS 26.443 version 14.1.0 Release 141 Scope The present document contains an electronic copy of the ANSI C floating-point code for the Enhanced Voice Services (EVS) Codec. This ANSI

23、 C code is the unique alternative reference specification besides the ANSI-C fixed-point code for the EVS Codec (3GPP TS 26.442) for a standard compliant implementation of the EVS Codec (3GPP TS 26.445), Voice Activity Detection (VAD) (3GPP TS 26.451), Comfort Noise Generation (CNG) (3GPP TS 26.449)

24、, Discontinuous Transmission (DTX) (3GPP TS 26.450), Packet Loss Concealment (PLC) of Lost Packets (3GPP TS 26.447), Jitter Buffer Management (JBM) (3GPP TS 26.448), and AMR-WB Interoperable Function (3GPP TS 26.446). Requirements for any implementation of the EVS codec to be standard compliant are

25、specified in 3GPP TS 26.444 (Test sequences). 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 no

26、n-specific. - For 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 sa

27、me Release as the present document. 1 3GPP TR 21.905: “Vocabulary for 3GPP Specifications“. 2 3GPP TS 26.445: “Codec for Enhanced Voice Services (EVS); Detailed Algorithmic Description“. 3 3GPP TS 26.451: “Codec for Enhanced Voice Services (EVS); Voice Activity Detection (VAD)“. 4 3GPP TS 26.449: “C

28、odec for Enhanced Voice Services (EVS); Comfort Noise Generation (CNG) Aspects“. 5 3GPP TS 26.450: “Codec for Enhanced Voice Services (EVS); Discontinuous Transmission (DTX)“. 6 3GPP TS 26.447: “Codec for Enhanced Voice Services (EVS); Error Concealment of Lost Packets“. 7 3GPP TS 26.448: “Codec for

29、 Enhanced Voice Services (EVS); Jitter Buffer Management“. 8 3GPP TS 26.446: “Codec for Enhanced Voice Services (EVS); AMR-WB Backward Compatible Functions“. 9 IETF RFC 3550: “RTP: A Transport Protocol for Real-Time Applications“. 10 Recommendation ITU-T G.191 (03/10): “Software tools for speech and

30、 audio coding standardization“. 11 Recommendation ITU-T G.192: “A common digital parallel interface for speech standardization activities“. ETSI ETSI TS 126 443 V14.1.0 (2018-01)63GPP TS 26.443 version 14.1.0 Release 143 Definitions and abbreviations 3.1 Definitions For the purposes of the present d

31、ocument, the definitions given in TR 21.905 1 apply. An abbreviation defined in the present document takes precedence over the definition of the same abbreviation, if any, in TR 21.905 1. 3.2 Abbreviations For the purposes of the present document, the abbreviations given in TR 21.905 1 and the follo

32、wing apply. An abbreviation defined in the present document takes precedence over the definition of the same abbreviation, if any, in TR 21.905 1. ACELP Algebraic Code-Excited Linear Prediction AMR-WB Adaptive Multi Rate Wideband (codec) CNG Comfort Noise Generator DTX Discontinuous Transmission EVS

33、 Enhanced Voice Services FB Fullband FEC Frame Erasure Concealment IP Internet Protocol JBM Jitter Buffer Management MSB Most Significant Bit MTSI Multimedia Telephony Service for IMS NB Narrowband PS Packet SwitchedPSTN Public Switched Telephone Network SAD Sound Activity Detection SC-VBR Source Co

34、ntrolled - Variable Bit Rate SID Silence Insertion Descriptor SWB Super Wideband VAD Voice Activity Detection WB Wideband WMOPS Weighted Millions of Operations Per Second 4 C code structure This clause gives an overview of the structure of the floating-point C code and provides an overview of the co

35、ntents and organization of the C code attached to the present document. The ANSI-C code has been verified on the following platforms: - IBM PC compatible computers with Windows 7 operating systems and Microsoft Visual C+ 2010 compiler, 32-bit. ANSI-C was selected as the programming language because

36、portability was desirable. ETSI ETSI TS 126 443 V14.1.0 (2018-01)73GPP TS 26.443 version 14.1.0 Release 144.1 Contents of the C source code The C code is organized as follows: Table 1: Source code directory structure Directory Description README.txt information on how to compile Makefile UNIX style

37、encoder Makefile Workspace_msvc/ Directory for the MSVC 2008 (or newer) project files lib_com/ Source code files used both in encoder and decoder lib_dec/ Source code files used solely in the decoder lib_enc/ Source code files used solely in the encoder The distributed files with suffix “c“ contain

38、the source code and the files with suffix “h“ are the header files. The ROM data is contained in files named “rom_xxx“ with suffix “c“. Makefiles are provided for the platforms in which the C code has been verified (listed above). Once the software is installed, this directory will have a compiled v

39、ersion of the encoder (named EVS_cod) and the decoder (named EVS_dec). 4.2 Program execution The codec for Enhanced Voice Services is implemented in two programs: - EVS_cod: encoder; - EVS_dec: decoder. The programs should be called like: - EVS_cod encoder options ; - EVS_dec decoder options . The i

40、nput and output files contain 16-bit linear encoded PCM samples and the bitstream file contains encoded data. The encoder and decoder options will be explained by running the programs without any input arguments. See the file readme.txt for more information on how to run the encoder and decoder prog

41、rams. 5 File formats This clause describes the file formats used by the encoder and decoder programs. The test sequences defined in 1 also use the file formats described here. 5.1 Input/output file format Input files read by the encoder and output files written by the decoder consist of 16-bit integ

42、er words per each data sample. The byte order in each word depends on the host architecture (e.g. LSB first on PCs, etc.). Both the encoder and the decoder program process complete frames corresponding to multiples of 20 ms. The remaining samples are discarded. The encoder will pad the last frame to

43、 integer multiples of 20ms frames, i.e. n speech frames will be produced from an input file with a length between (n-1)*20ms+1 sample; n*20ms. The files produced by the decoder will always have a length of n*20ms. ETSI ETSI TS 126 443 V14.1.0 (2018-01)83GPP TS 26.443 version 14.1.0 Release 145.2 Rat

44、e switching profile (encoder input) The encoder program can optionally read in a rate switching profile file which specifies the encoding bitrate for each frame of the input data. The rate switching profile is a binary file, generated by gen-rate-profile tool, which is part of STL 2009, as contained

45、 in ITU-T G.191 10. The rate switching profile contains 32-bit integer words where each word represents the encoding bitrate for each particular frame. The rate switching profile is recycled if it contains less entries than the total number of frames in the input file. The rate switching profile can

46、 contain EVS primary mode bitrates and AMR-WB IO mode bitrates arbitrarily. I.e. switching between the two modes can be specified by the rate switching profile. 5.3 Parameter bitstream file (encoder output / decoder input) The files produced by the speech/audio encoder/expected by the speech decoder

47、 contain an arbitrary number of frames in the following available formats. 5.3.1 ITU-T G.192 compliant format SYNC_WORD DATA_LENGTH B1 B2 Bnn Each box corresponds to one Word16 value in the bitstream file, for a total of 2+nn words or 4+2nn bytes per frame, where nn is the number of encoded bits in

48、the frame. Each encoded bit is represented as follows: Bit 0 = 0x007f, Bit 1 = 0x0081. The fields have the following meaning: - SYNC_WORD: Word to ensure correct frame synchronization between the encoder and the decoder. It is also used to indicate the occurrences of bad frames. In the encoder outpu

49、t: (0x6b21) In the decoder input: Good frames (0x6b21) Bad frames (0x6b20) - DATA_LENGTH: Length of the speech data. Codec mode and frame type is extracted in the decoder using this parameter 5.3.2 Compact storage format file The encoder and decoder programs can optionally write and read a file in the octet-based compact storage format. The compact storage format is specified in Annex A.2.6 of 2. 5.4 VoIP parameter bitstream file (decoder input) Packet size Arrival time RTP header G.192 format (see 6.3.1) The fields have the fo