Speaker_Tune 模块文档¶
所属工具箱：Sensors and Actuators
简介¶
一句话描述：该模块用于在RflySim仿真中实现PX4兼容的蜂鸣器音调控制，支持播放预定义曲调与自定义曲调。
该模块是RflySim工具链Sensors and Actuators接口库中的蜂鸣器执行器模块，用于对接PX4飞控的蜂鸣器控制逻辑，在仿真场景中实现各类系统状态的音频提示。它支持通过触发信号选择播放PX4标准预定义曲调（包含开机、错误、低电量、GPS告警等多种常用系统提示音），也支持用户自定义输入曲调字符串实现个性化提示。
该模块可配合CopterSim完成飞控仿真逻辑的音频状态反馈，结果可同步在RflySim3D可视化环境中呈现音频提示，可广泛应用于无人机飞控逻辑开发、状态机调试、用户交互功能开发等场景，和PX4原生蜂鸣器行为完全兼容，帮助开发者在仿真阶段就完成完整的交互提示功能验证。
端口说明¶
输入端口（Inputs）¶
| 端口名 | 数据类型 | 维度 | 说明 |
|---|---|---|---|
Tune ID |
PX4_TUNE_ENUM / int |
1×1 |
预定义曲调的枚举ID，用于指定需要播放的预定义曲调 |
IsTuneOverride |
char / string |
N×1 |
自定义曲调字符串，当播放自定义曲调时使用，定义需要播放的曲调内容 |
Trigger |
double |
1×1 |
播放触发信号：触发值变为1时播放指定预定义曲调，变为2时播放自定义曲调，仅当触发值发生变化时才触发曲调播放 |
输出端口（Outputs）¶
本模块无输出端口。
参数配置（Parameters）¶
本模块无可配参数。
模块特性（Block Characteristics）¶
| 特性项 | 值 |
|---|---|
| 支持的数据类型 | double、single、uint8、PX4 TUNE ENUM枚举 |
| 直接馈通（Direct Feedthrough） | 是 |
| 采样时间 | 继承 |
| 代码生成支持 | 是 |
数据通信协议¶
本模块不涉及网络通信。
相关模块¶
| 模块名 | 说明 |
|---|---|
Sonar |
模拟超声波测距传感器输出距离数据 |
GPS_Recording_Playback |
回放录制的GPS数据输出位置信息 |
Optical_Flow |
输出模拟光流传感器的像素运动数据 |
Lidar |
模拟激光雷达测距输出距离数据 |
Trigger_Input |
读取PX4飞控的触发输入信号 |
PWM_Out |
输出PWM信号驱动执行机构 |
Vicon_Out |
输出Vicon动捕系统提供的位姿数据 |
使用示例¶
相关使用示例请参考以下路径：
请在上述路径中查看
Readme.pdf获取完整的示例说明与操作步骤。
注意事项与常见问题¶
- 初始化顺序：该模块依赖PX4飞控固件的蜂鸣器驱动完成音频调度，必须将其放置在RflySim自动生成的飞控任务子系统内，保证模块初始化晚于PX4固件系统初始化，否则无法正常触发音调播放。
- 触发规则匹配：曲调播放仅响应
Trigger输入的数值变化触发，仅保持固定电平不会重复播放曲调；预定义曲调播放需要Trigger从非1跳变到1，自定义曲调播放需要Trigger从非2跳变到2。 - 枚举输入格式要求：
Tune ID输入必须为PX4 TUNE ENUM类型的枚举值，不支持直接输入整数ID，若手动连接自定义信号需要转换为对应枚举类型，否则会触发Simulink类型错误。 - 自定义曲调格式要求：当使用自定义曲调功能（
IsTuneOverride输入有效）时，传入的字符串必须符合PX4官方蜂鸣曲调语法规范，不规范的字符串会被直接忽略，无法播放对应音调。 - 采样时间匹配：模块推荐使用与飞控控制周期一致的采样时间（通常为250Hz即0.004s），过大的采样时间可能导致触发信号变化无法被及时检测，出现音调播放延迟或丢失的问题。
更新日志¶
v4.10(2024-08-12): 新增蜂鸣器音调控制模块Speaker_Tune，支持预定义曲调播放与自定义曲调播放功能