1 /* ------------------------------------------------------------------
2 * Copyright (C) 1998-2009 PacketVideo
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
8 * http://www.apache.org/licenses/LICENSE-2.0
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
14 * See the License for the specific language governing permissions
15 * and limitations under the License.
16 * -------------------------------------------------------------------
18 /****************************************************************************************
19 Portions of this file are derived from the following 3GPP standard:
22 ANSI-C code for the Adaptive Multi-Rate (AMR) speech codec
23 Available from http://www.3gpp.org
25 (C) 2004, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TTA, TTC)
26 Permission to distribute, modify and use this file under the standard license
27 terms listed above has been obtained from the copyright holder.
28 ****************************************************************************************/
30 ------------------------------------------------------------------------------
34 Filename: /audio/gsm-amr/c/include/sid_sync.h
38 ------------------------------------------------------------------------------
41 Description: Added PV coding template sections to 3GPP version 3.2.0.
43 Description: Replaced "int" and/or "char" with OSCL defined types.
45 Description: Moved _cplusplus #ifdef after Include section.
49 ------------------------------------------------------------------------------
52 This file contains the type definition and function prototypes used by the
53 SID synchronization functions.
55 ------------------------------------------------------------------------------
61 /*----------------------------------------------------------------------------
63 ----------------------------------------------------------------------------*/
68 /*--------------------------------------------------------------------------*/
74 /*----------------------------------------------------------------------------
76 ; [Define module specific macros here]
77 ----------------------------------------------------------------------------*/
79 /*----------------------------------------------------------------------------
81 ; [Include all pre-processor statements here.]
82 ----------------------------------------------------------------------------*/
83 #define sid_sync_h "$Id $"
85 /*----------------------------------------------------------------------------
86 ; EXTERNAL VARIABLES REFERENCES
87 ; [Declare variables used in this module but defined elsewhere]
88 ----------------------------------------------------------------------------*/
90 /*----------------------------------------------------------------------------
92 ----------------------------------------------------------------------------*/
94 /*----------------------------------------------------------------------------
95 ; ENUMERATED TYPEDEF'S
96 ----------------------------------------------------------------------------*/
98 /*----------------------------------------------------------------------------
99 ; STRUCTURES TYPEDEF'S
100 ----------------------------------------------------------------------------*/
103 Word16 sid_update_rate; /* Send SID Update every sid_update_rate frame */
104 Word16 sid_update_counter; /* Number of frames since last SID */
105 Word16 sid_handover_debt; /* Number of extra SID_UPD frames to schedule*/
106 enum TXFrameType prev_ft;
109 /*----------------------------------------------------------------------------
110 ; GLOBAL FUNCTION DEFINITIONS
111 ; [List function prototypes here]
112 ----------------------------------------------------------------------------*/
113 /* initialize one instance of the sid_sync module
114 Stores pointer to state struct in *st. This pointer has to
115 be passed to sid_sync in each call.
118 Word16 sid_sync_init(void **st);
120 /* reset of sid_sync module (i.e. set state memory to zero)
123 Word16 sid_sync_reset(void *st);
125 /* de-initialize sid_sync module (i.e. free status struct)
128 void sid_sync_exit(void **st);
130 /* update handover debt
131 debtFrames extra SID_UPD are scheduled .
132 to update remote decoder CNI states, right after an handover.
133 (primarily for use on MS UL side )
135 void sid_sync_set_handover_debt(sid_syncState *st, /* i/o: sid_sync state */
138 /* To ensure that the mode only switches to a neighbouring mode */
139 void sid_sync(void *st ,
141 enum TXFrameType *tx_frame_type);
147 #endif /* _SID_SYNC_H_ */