BetaFlight代码解析（20）—屏幕显示（OSD）

原创于 2025-12-11 20:53:28 发布 · 360 阅读

CC 4.0 BY-SA版权

文章标签：

79 篇文章

订阅专栏

屏幕显示 (OSD) 系统可在视频画面上实时叠加飞行信息，并提供飞行后统计信息。本文档涵盖 OSD 架构、元件系统、配置管理和警告机制。

OSD系统由多个相互连接的子系统组成，这些子系统协同工作，提供全面的飞行信息显示：

主 OSD 控制器负责初始化、更新周期以及子系统之间的协调：

各个 OSD 元素通过集中式渲染系统进行管理，该系统同时支持前景层和背景层：

元素类别	示例	功能模式
飞行数据	`OSD_ALTITUDE`，`OSD_GPS_SPEED`	`osdElementAltitude()`
电池信息	`OSD_MAIN_BATT_VOLTAGE`，`OSD_CURRENT_DRAW`	`osdElementCurrentDraw()`
态度	`OSD_ARTIFICIAL_HORIZON`，`OSD_PITCH_ANGLE`	`osdElementArtificialHorizon()`
系统信息	`OSD_FLYMODE`，`OSD_WARNINGS`	`osdElementFlymode()`
导航	`OSD_GPS_LAT`，`OSD_COMPASS_BAR`	`osdElementCompassBar()`

元素渲染系统采用状态机方法来处理复杂的多帧元素：

OSD配置通过参数组进行管理，并支持多个配置文件：

OSD系统支持元素变体，允许以不同的显示格式显示相同的数据：