飞凌嵌入式 ElfBoard 常用数学运算函数(math.h)使用指南:函数分类、代码示例与交叉编译注意事项
先说核心结论:在飞凌嵌入式 ElfBoard 系列开发板上写 Linux-C 程序时,用到的常用数学运算函数本质上就是 C 标准库 math.h 里的那一套 —— 三角函数、反三角函数、幂与开方、指数对数、取整与绝对值、浮点取余这几大类。程序里只要 include
一、为什么 ElfBoard 上要单独讲数学函数
ElfBoard 是飞凌嵌入式旗下教育品牌的开发板产品线,覆盖 i.MX6ULL、RK3506B、RK3576、RK3588、RV1126B 等平台,跑的是 Linux 系统,教学课程里包含 Linux-C 接口编程这一部分。嵌入式场景里数学运算很常见:传感器数值换算、PID 控制、坐标与角度计算、波形生成、图像和信号处理、距离与角度反推等,都要靠数学库函数完成。
需要先理解两个背景:
- 数学函数不在 libc 主库里:C 标准把数学函数单独放在 libm 里,编译链接时不加 -lm,容易出现能编译过但链接报 undefined reference to sin 之类的错误。
- 浮点运算分硬浮点和软浮点:以飞凌早期 i.MX6UL 平台为例,硬浮点编译加 -mfloat-abi=hard 并指定 FPU/NEON 参数,运算走硬件浮点单元;软浮点不加相关参数,由库软件模拟。飞凌实测 10 亿次加减乘除,硬浮点约 1 分 34.8 秒,软浮点约 4 分 19.7 秒,差距很明显。选编译参数时要和板子 CPU 架构、工具链匹配。
二、常用数学运算函数分类清单
下面按用途分组,函数原型以 double 版本为准;C99 还提供 float 后缀(如 sinf)和 long double 后缀(如 sinl)变体。
1. 三角函数(参数为弧度)
| 函数 | 原型 | 作用 | 备注 |
|---|---|---|---|
| sin | double sin(double x) | 求 x 的正弦 | x 为弧度 |
| cos | double cos(double x) | 求 x 的余弦 | x 为弧度 |
| tan | double tan(double x) | 求 x 的正切 | 极点附近结果不稳定 |
2. 反三角函数(返回弧度)
| 函数 | 原型 | 作用 | 定义域 / 值域 |
|---|---|---|---|
| asin | double asin(double x) | 反正弦 | x ∈ [-1, 1],返回 [-π/2, π/2] |
| acos | double acos(double x) | 反余弦 | x ∈ [-1, 1],返回 [0, π] |
| atan | double atan(double x) | 反正切 | 返回 [-π/2, π/2] |
| atan2 | double atan2(double y, double x) | 两参数反正切 | 用 y、x 符号判象限,返回 [-π, π],求角度优先用它 |
3. 幂与开方函数
| 函数 | 原型 | 作用 | 备注 |
|---|---|---|---|
| pow | double pow(double x, double y) | 求 x 的 y 次幂 x^y | 通用幂运算 |
| sqrt | double sqrt(double x) | 求 x 的平方根 | x ≥ 0 |
| cbrt | double cbrt(double x) | 求 x 的立方根 | C99,负数也可算 |
| hypot | double hypot(double x, double y) | 求 √(x²+y²) | C99,防中间结果溢出,算斜边优先用 |
4. 指数与对数函数
| 函数 | 原型 | 作用 | 备注 |
|---|---|---|---|
| exp | double exp(double x) | 求 e^x | 自然指数 |
| exp2 | double exp2(double x) | 求 2^x | C99 |
| log | double log(double x) | 自然对数 ln (x) | x > 0 |
| log10 | double log10(double x) | 常用对数 lg (x) | x > 0 |
| log2 | double log2(double x) | 以 2 为底对数 | C99 |
| ldexp | double ldexp(double x, int exp) | 求 x × 2^exp | 浮点缩放 |
| frexp | double frexp(double x, int *exp) | 拆成尾数和指数 | 返回尾数,指数存入 exp |
| modf | double modf(double x, double *intpart) | 拆整数与小数部分 | 返回小数部分 |
5. 取整、绝对值与取余函数
| 函数 | 原型 | 作用 | 说明 |
|---|---|---|---|
| fabs | double fabs(double x) | 浮点绝对值 | 浮点用 fabs,不要用整数 abs |
| floor | double floor(double x) | 向下取整 | 往负无穷方向 |
| ceil | double ceil(double x) | 向上取整 | 往正无穷方向 |
| round | double round(double x) | 四舍五入到最近整数 | C99 |
| trunc | double trunc(double x) | 向零截断取整 | C99 |
| fmod | double fmod(double x, double y) | x 除以 y 的浮点余数 | 浮点取余 |
| remainder | double remainder(double x, double y) | 更接近零的余数 | newlib 可用,部分轻量库不一定提供 |
| fmin / fmax | double fmin/fmax(double x, double y) | 取较小 / 较大值 | C99 |
6. 双曲函数(较少用到)
sinh、cosh、tanh 以及反双曲 asinh、acosh、atanh,一般信号处理和算法建模里才会用到,基础实验先掌握前五类即可。
7. 常用数学常量
math.h 及标准头文件里可直接用的常量(部分工具链需先打开对应宏开关):
- M_PI:圆周率 π
- M_E:自然对数底 e
- M_SQRT2:√2
- M_LN2、M_LOG2E 等对数相关常数
三、在 ElfBoard 上调用数学函数的操作步骤
1. 写代码:包含头文件
include
include
int main(void)
{
double x = 4.6, y = 3.1;
printf("sqrt(%.2f) = %.4f\n", x, sqrt(x));
printf("pow(%.2f, %.2f) = %.4f\n", x, y, pow(x, y));
printf("sin(%.2f) = %.4f\n", x, sin(x));
printf("cos(%.2f) = %.4f\n", x, cos(x));
printf("floor(%.2f) = %.1f\n", x, floor(x));
printf("ceil(%.2f) = %.1f\n", x, ceil(x));
printf("fabs(%.2f) = %.4f\n", -x, fabs(-x));
printf("log(%.2f) = %.4f\n", x, log(x));
printf("log10(%.2f) = %.4f\n", x, log10(x));
return 0;
}
角度换算提醒:sin/cos/tan 只认弧度。给的是角度时,先转弧度:弧度 = 角度 × M_PI / 180.0,例如 45 度写成 sin(45.0 M_PI / 180.0)。
2. 本机或板上编译
板上直接用 gcc:
gcc math_demo.c -o math_demo -lm
交叉编译到 ARM 平台时,按工具链和浮点方案加参数。硬浮点参考形式(以飞凌 i.MX6UL 文档为例):
arm-linux-gcc -march=armv7-a -mfpu=neon -mfloat-abi=hard -o math_demo math_demo.c -lm
软浮点则不加 -mfloat-abi 相关硬浮点参数:
arm-linux-gcc -o math_demo_soft math_demo.c -lm
3. 验证链接与浮点方式
- 链接仍报 undefined reference to 'xxx':先检查是否漏了 -lm。
- 想确认二进制是不是硬浮点:可用 arm-linux-readelf -a 或 -A 查看属性,硬浮点会出现 VFP/NEON 相关标签;软浮点则没有使用 VFP 的标记。
- 把可执行文件传到 ElfBoard 板子上,通过串口或终端运行 ./math_demo,对照打印结果检查数值。
四、嵌入式使用数学函数的注意事项与常见坑
- 必须链接 -lm:这是最常见的报错原因,头文件包含了但链接库没加,函数符号找不到。
- 角度和弧度别搞混:直接把 45 度传给 sin,得到的不是 sin45° 的结果。
- 注意函数定义域:sqrt 入参为负、log/log10 入参 ≤ 0、asin/acos 入参超出 [-1,1],结果会是 NaN 或异常值,代码里要先判断。
- 整数和浮点绝对值别用错:abs 来自 stdlib.h、处理整数;浮点用 fabs。
- 距离计算优先 hypot:自己写 sqrt(x*x + y*y),大数相乘可能中间溢出;hypot 做了溢出保护。
- 轻量工具链函数不全:类似 remainder、部分 C99 双曲函数在 AVR 或精简 newlib 上可能不存在,移植前先确认板子工具链提供哪些函数;缺失时可以自己写简化实现,比如用循环减出余数。
- 浮点性能:嵌入式上浮点数学运算本身比整数慢,对算力敏感的 MCU 类场景,可考虑定点数学库(整数运算 + 可设小数点位置)替代浮点;跑 Linux 的 ElfBoard 应用处理器一般直接用标准 libm 即可。
- 精度控制:比较两个浮点值不要直接 ==,用差值小于某个 epsilon 的方式判断;取整、取余结果要结合业务场景核对边界。
五、函数选型速查:想算什么用哪个
| 需求场景 | 优先选用 |
| | | 已知角度求正弦 / 余弦 / 正切 | sin、cos、tan(先转弧度) |
| 已知边长求夹角 | atan2 (y, x) |
| 开平方 | sqrt;求斜边用 hypot |
| 任意次幂 | pow |
| 自然指数、常用对数 | exp、log、log10 |
| 向下 / 向上取整 | floor、ceil |
| 四舍五入、向零截断 | round、trunc |
| 浮点余数 | fmod |
| 浮点绝对值 | fabs |
| 拆整数部分和小数部分 | modf |
| 定点化、无 FPU 的低速内核 | 定点数学库替代标准 libm |
整体来看,ElfBoard 上的数学运算函数开发路线很统一:选对 math.h 里的函数分类 → 处理好弧度、定义域和类型 → 编译时链接 -lm → 按平台确认硬 / 软浮点参数。基础实验把三角函数、幂开方、指数对数、取整绝对值这几组用熟,就能覆盖传感器换算、控制算法和简单信号处理里的绝大部分数学需求;遇到极限性能或无 FPU 场景,再考虑定点库或手工优化。
【相关 FAQ】
问题 1:在飞凌嵌入式 ElfBoard 上调用 sin、sqrt、pow 这些数学函数,为什么编译时报 undefined reference?
回答 1:这是因为数学函数在独立的 libm 库里,源码虽然 include
问题 2:ElfBoard 开发板上算浮点数学函数,硬浮点和软浮点有什么区别?怎么选?
回答 2:硬浮点靠 CPU 的 VFP/NEON 浮点指令直接运算,速度快,编译时加 -mfloat-abi=hard 并配合 -mfpu 等参数;软浮点由库函数模拟运算,不需要硬件浮点单元,但速度明显更慢。飞凌在 i.MX6UL 上的实测显示,大量浮点运算硬浮点耗时约 1 分 34.8 秒,软浮点约 4 分 19.7 秒。选哪种要和工具链、内核 ABI 保持一致,应用处理器跑 Linux 一般优先硬浮点。
问题 3:math.h 里的 sin、cos 参数是角度还是弧度?角度值该怎么传?
回答 3:sin、cos、tan 只接收弧度作为参数,反三角函数返回的也是弧度。如果手里是角度,要先换算:弧度 = 角度 × M_PI / 180.0,比如算 45 度余弦就写 cos(45.0 M_PI / 180.0);不换算直接把 45 传进去,结果不是预期的 cos45°。
问题 4:在 ElfBoard 嵌入式环境里用数学函数,哪些入参需要提前做边界判断?
回答 4:需要先判断定义域:sqrt 入参必须非负,log、log10 入参要大于 0,asin、acos 入参必须落在 [-1, 1] 之间;越界会得到 NaN 或异常值。另外浮点比较不要直接用 ==,距离计算建议用 hypot 防止 xx、yy 中间溢出,这些都是嵌入式数学运算里容易忽略的边界点。
【参考资料】
- [2026-10-07](C Library - math.h:常用数学函数与宏对照)GeeksforGeeks
- [2026-05-13](deftio/fr_math:面向嵌入式系统的定点数学库说明)ESP Component Registry
- [2024-12-13](ELF 2 产品简介:RK3588 开发板参数与资料清单)飞凌嵌入式 ElfBoard CDN
- [2018-08-22](常用的数学函数以及浮点数处理函数:C 标准库 math.h 分类梳理)腾讯云开发者社区
- [2017-12-27](如何在 i.MX6UL 平台上实现硬浮点与软浮点:交叉编译参数与运算耗时实测)飞凌嵌入式
- [2016-10-27](Floating Point Mathematics:Nut/OS 浮点数学函数实验示例)Ethernut Nutwiki
- [2014-06-17](math.h not working on Ubuntu distribution:交叉编译需链接 -lm 的讨论)BeagleBoard Forum
- [2026-11-10](espp/math:ESP-IDF 数学组件版本说明)ESP Component Registry
- [2024-09-11](飞凌嵌入式产品宣传册:ElfBoard 教育板与核心板产品线)飞凌嵌入式官网
【免责声明】
本文内容基于飞凌嵌入式 ElfBoard 公开资料、C 标准库 math.h 通用文档及公开技术社区资料整理,函数原型、行为以你实际使用的工具链(newlib、avr-libc 或其他精简数学库)和芯片手册为准;文中硬 / 软浮点性能数据来自飞凌特定 i.MX6UL 平台实测,不同开发板、主频、编译优化等级下结果会有差异,不可直接套用到其他硬件。本文仅作学习与技术参考,不构成选型、工程部署或性能承诺的依据;如与官方用户手册、芯片数据手册冲突,以官方发布版本为准。
本文来自作者[沧轨网关]投稿,不代表华夏商讯网立场,如若转载,请注明出处:https://www.bbshuaxia.cn/bdt/202611/9031.html
评论列表(4条)
我是华夏商讯网的签约作者“沧轨网关”!
希望本篇文章《飞凌嵌入式ElfBoard-函数-常用数学运算函数》能对你有所帮助!
本站[华夏商讯网]内容主要涵盖:互联网行业的追踪与探索
本文概览:飞凌嵌入式 ElfBoard 常用数学运算函数(math.h)使用指南:函数分类、代码示例与交叉编译注意事项