TI C2000 Fast Run Time Support Library USER'S GUIDE的错误

在学习TI C2000的快速运行时库的时候发现这文档错误也太多了。而且这玩意的接口文档只有pdf版的,没有html页面的那种。

该文档路径是C2000Ware_4_01_00_00/libraries/math/FPUfastRTS/c28/docs/FASTRTS_SW_LIB_UG.pdf(时间是2022.6.23,说不定以后改正了)
经常还得在源汇编代码里看,函数接口和函数实现。

问题1:有些函数名不完整

namewrong

该函数本身应该为:float32_t FS$$DIV (float32_t X, float32_t Y)。

问题2:有些函数的输入范围不完整、输出范围有错误

rangewrong

蓝色圈:文档显示不完整,其应该为[-1, 1],即acos的定义域。
红色圈:文档错误,其应该为[0, π],即acos的值域。

问题3:有部分函数接口文档根本没有内容

API

红框内的FPU64接口(关于算术和三角的函数),在文档内就在这列了个名字,后面根本没有对其的介绍、讲解。后面只有FID接口的介绍、讲解。

还有些小感悟

sincos

这是一个求单精度浮点正弦和余弦的函数。我写的话,一般会用返回一个数组的方法来求结果。但是TI这个函数是用传两个指针参数的方法来记录结果,想了想确实这样要方便点、直观点,毕竟返回数组的函数用起来挺别扭的,使用的人用的时候还要先定义一个数组。而传指针可以做到看见其变量就知道其值的含义是什么,而且还省了数组的操作。