中兴内部资料－C64x算法模块的接口规范

C64x算法模块的接口规范
C64x算法模块的接口规范

xxx 2004.3.10




长期以来，我们的算法模块与调度模块的接口都存在一定的问题，主要问题有三个，一
个是算法与调度间接口不够清晰，一个是不同算法整合的时候经常会出现变量、函数命
名的冲突，还有一个就是接口不够规范，经常是不同的人定出不同的接口，不利于后期
维护。

现在主要针对这几个方面的问题作一个算法的接口规范，以便今后大家工作过程中共同
遵循。

算法文件命名


通常，我们的算法文件大多是由协议提供的，即便自己作的汇编文件，其文件名也是由
原有的c函数名衍生出来的。不同算法采用同样的文件名是比较正常的，比如：vad、dt
x等，几乎所有算法都包括，另外算法与调度之间也存在潜在的文件名重名的问题。

规定所有的算法文件全部加前缀：“系统名_算法名_”。比如在GSM系统中的HR算法，算法
所有文件名都应以“gsm_hr_”最为前缀。如果该算法是一种被各系统普遍采用的算法，如
G.711、AMR等，则无需加系统名，比如GSM与3G系统中均存在AMR，则以“amr_”作为前缀
。由于C编程规范与汇编编程规范都要求文件名全部采用小写字母，因此要求文件名前缀
也全部采用小写字母。
调度模块以及其他算法模块的文件名不可采用与本模块相同的文件名前缀。

算法函数命名


通常，我们的算法函数大多是由协议提供的，即便是自己作的汇编函数，其函数名也是
由原有的c函数名衍生出来的。算法中很多函数是跨文件的全局函数，不同算法之间函数
名相同，或者算法与调度之间函数重名也是比较正常的。
规定算法模块所有全局函数名全部加前缀：“系统名_算法名_”。比如在GSM系统中的
HR算法，算法模块的所有函数名都应以“GSM_H