（Tune）完全指南：?jiǎn)?dòng)/運(yùn)行音調(diào)含義與 tune-control 調(diào)試實(shí)戰(zhàn))
嵌入式物聯(lián)網(wǎng)機(jī)器人自動(dòng)駕駛智能硬件【免費(fèi)下載鏈接】PX4-AutopilotPX4 Autopilot Software項(xiàng)目地址https://gitcode.com/gh_mirrors/px/PX4-Autopilot點(diǎn)擊查看免費(fèi)下載Pixhawk 系列飛控通過蜂鳴器發(fā)出可聽音調(diào)、配合LED 顏色與閃爍序列向用戶傳達(dá)飛行器的狀態(tài)與事件——例如解鎖成功/失敗、低電量告警、任務(wù)校驗(yàn)結(jié)果等。本文以 docs/en/getting_started/tunes.md 為骨架完整梳理 PX4 全部標(biāo)準(zhǔn)音調(diào)的含義與觸發(fā)時(shí)機(jī)并結(jié)合 src/lib/tunes/tune_definition.desc、tune_control 系統(tǒng)命令 等源碼深入講解 MML 旋律語法、uORB 消息機(jī)制與命令行調(diào)試方法。讀完本文你將能聽懂飛控的每一種提示音、快速定位異常狀態(tài)并能自行定義與測(cè)試自定義音調(diào)。一、PX4 音調(diào)系統(tǒng)的工作原理PX4 的音調(diào)系統(tǒng)由三層協(xié)作完成音調(diào)定義層所有標(biāo)準(zhǔn)音調(diào)集中定義在 src/lib/tunes/tune_definition.desc每個(gè)音調(diào)有一個(gè)序號(hào)ordinal、一個(gè)枚舉名name、一段 MML 旋律字符串和一個(gè)是否可被打斷interruptible標(biāo)志。解析執(zhí)行層src/lib/tunes/tunes.cpp 中的Tunes類負(fù)責(zé)把 MML 字符串逐字符解析成頻率 時(shí)長(zhǎng) 靜音序列ToneAlarm 驅(qū)動(dòng) 訂閱 uORB 的tune_control話題把解析結(jié)果驅(qū)動(dòng)到蜂鳴器硬件。觸發(fā)層Commander、校準(zhǔn)例程、失聯(lián)告警等模塊在相應(yīng)事件發(fā)生時(shí)通過 uORB 消息tune_control發(fā)布要播放的音調(diào) ID。其中消息定義見 msg/TuneControl.msg它同時(shí)承載預(yù)定義音調(diào) ID 與自定義音調(diào)頻率/時(shí)長(zhǎng)/音量?jī)煞N模式當(dāng)tune_id為TUNE_ID_CUSTOM(0)時(shí)使用消息里的frequency、duration、silence字段否則這些字段被忽略。音調(diào) ID 枚舉TUNE_ID_*119與 src/lib/tunes/tune_definition.desc 中的定義一一對(duì)應(yīng)該文件通過PX4_DEFINE_TUNE宏被 tune_definition.h 和 default_tunes.cpp 分別展開為TuneID枚舉、旋律字符串?dāng)?shù)組與可打斷標(biāo)志數(shù)組。二、標(biāo)準(zhǔn)音調(diào)總覽下表匯總了全部 20 個(gè)音調(diào)含保留的 0 號(hào)自定義音調(diào)及其 ID、枚舉名與播放性質(zhì)供速查ID枚舉名說明可打斷0CUSTOM自定義音調(diào)通過消息頻率/時(shí)長(zhǎng)播放是1STARTUP啟動(dòng)音調(diào)microSD 掛載成功是2ERROR_TUNE錯(cuò)誤音調(diào)硬故障重啟等是3NOTIFY_POSITIVE正向提示校準(zhǔn)成功/模式切換成功是4NOTIFY_NEUTRAL中性提示任務(wù)有效/安全開關(guān)打開是5NOTIFY_NEGATIVE負(fù)向提示校準(zhǔn)失敗/命令被拒是6ARMING_WARNING解鎖警告已解鎖否7BATTERY_WARNING_SLOW低電量告警慢速是8BATTERY_WARNING_FAST嚴(yán)重低電量告警快速是9GPS_WARNINGGPS 告警否10ARMING_FAILURE解鎖失敗音調(diào)否11PARACHUTE_RELEASE降落傘釋放否12SINGLE_BEEP單聲短嗶羅盤校準(zhǔn)提示旋轉(zhuǎn)機(jī)體否13HOME_SET設(shè)置返航點(diǎn)僅首次否14SD_INIT制作文件系統(tǒng) / 掛載失敗 / 無 SD 卡否15SD_ERROR格式化 SD 卡失敗否16PROG_PX4IO開始燒寫 PX4IO否17PROG_PX4IO_OKPX4IO 燒寫成功否18PROG_PX4IO_ERRPX4IO 燒寫失敗是19POWER_OFF關(guān)機(jī)音調(diào)否開發(fā)者提示可在倉庫中搜索字符串TUNE_ID_name例如TUNE_ID_PARACHUTE_RELEASE來定位某個(gè)音調(diào)在代碼中的觸發(fā)位置。參考 src/lib/tunes/tune_definition.desc。三、啟動(dòng)階段音調(diào)Boot/Startup這些音調(diào)在開機(jī)引導(dǎo)序列見 ROMFS/px4fmu_common/init.d/rcS中播放用來報(bào)告引導(dǎo)各環(huán)節(jié)的結(jié)果。3.1 啟動(dòng)音調(diào)Startup ToneID 1 / STARTUP? 試聽啟動(dòng)音調(diào)microSD 卡在引導(dǎo)過程中成功掛載。其旋律定義為MFT240L8 O4aO5dc O4aO5dc O4aO5dc L16dcdcdcdcT240 速度下以八度 4/5 交替演奏上行裝飾音給人系統(tǒng)就緒的聽感。3.2 錯(cuò)誤音調(diào)Error TuneID 2 / ERROR_TUNE? 試聽錯(cuò)誤音調(diào)觸發(fā)場(chǎng)景包括硬故障hard fault導(dǎo)致系統(tǒng)重啟系統(tǒng)配置為使用 PX4IO 但未檢測(cè)到 IOUAVCAN 已使能但驅(qū)動(dòng)無法啟動(dòng)SITL/HITL 已使能但_pwm_out_sim_驅(qū)動(dòng)無法啟動(dòng)FMU 啟動(dòng)失敗。對(duì)應(yīng)旋律MBT200a8a8a8PaaaPMB表示重復(fù)播放除非被打斷或顯式調(diào)用tone_control stop。3.3 制作文件系統(tǒng)Make File SystemID 14 / SD_INIT? 試聽制作文件系統(tǒng)音調(diào)觸發(fā)場(chǎng)景正在格式化 microSD 卡掛載失敗若格式化成功引導(dǎo)序列會(huì)再次嘗試掛載未檢測(cè)到 microSD 卡。該音調(diào)歷史 ID 為 16現(xiàn)枚舉名為SD_INIT。3.4 格式化失敗Format FailedID 15 / SD_ERROR? 試聽格式化失敗音調(diào)在先前嘗試掛載卡失敗之后microSD 卡格式化仍然失敗。歷史 ID 為 17現(xiàn)枚舉名為SD_ERROR。3.5 燒寫 PX4IOProgram PX4IOID 16 / PROG_PX4IO? 試聽燒寫 PX4IO 音調(diào)開始對(duì) PX4IO 協(xié)處理器進(jìn)行固件燒寫。3.6 燒寫 PX4IO 成功Program PX4IO SuccessID 17 / PROG_PX4IO_OK? 試聽燒寫成功音調(diào)PX4IO 燒寫成功。3.7 燒寫 PX4IO 失敗Program PX4IO FailID 18 / PROG_PX4IO_ERR? 試聽燒寫失敗音調(diào)觸發(fā)場(chǎng)景PX4IO 燒寫失敗PX4IO 無法啟動(dòng)未找到 AUX Mixer。該音調(diào)被標(biāo)記為可打斷interruptible避免長(zhǎng)時(shí)間占用蜂鳴器。四、運(yùn)行階段音調(diào)Operational這些音調(diào)在飛行器正常運(yùn)行期間發(fā)出用于反饋各類事件與告警。4.1 錯(cuò)誤音調(diào)Error TuneID 2 / ERROR_TUNE? 試聽錯(cuò)誤音調(diào)RC 遙控器信號(hào)丟失RC Loss。4.2 正向提示音Notify PositiveID 3 / NOTIFY_POSITIVE? 試聽正向提示音觸發(fā)場(chǎng)景校準(zhǔn)成功飛行模式切換成功命令被接受例如來自 MAVLink 命令協(xié)議安全開關(guān)已關(guān)閉飛行器可以被解鎖。4.3 中性提示音Notify NeutralID 4 / NOTIFY_NEUTRAL? 試聽中性提示音觸發(fā)場(chǎng)景任務(wù)有效且無警告空速校準(zhǔn)需要提供更多氣壓或校準(zhǔn)完成安全開關(guān)已打開/已上鎖可以安全接近飛行器。4.4 負(fù)向提示音Notify NegativeID 5 / NOTIFY_NEGATIVE? 試聽負(fù)向提示音觸發(fā)場(chǎng)景校準(zhǔn)失敗校準(zhǔn)已完成重復(fù)校準(zhǔn)被拒絕任務(wù)無效命令被拒絕、執(zhí)行失敗或暫時(shí)被拒例如來自 MAVLink 命令協(xié)議解鎖/上鎖轉(zhuǎn)換被拒絕例如起飛前檢查失敗、安全開關(guān)未關(guān)閉、系統(tǒng)不在手動(dòng)模式拒絕模式切換。4.5 解鎖警告Arming WarningID 6 / ARMING_WARNING? 試聽解鎖警告音飛行器已成功解鎖。定義MNT75L1O2G使用 Legato 模式、T75 速度演奏低八度長(zhǎng)音 G形成持續(xù)警示感該音調(diào)不可打斷。4.6 解鎖失敗音調(diào)Arming FailureID 10 / ARMING_FAILURE? 試聽解鎖失敗音調(diào)解鎖失敗。4.7 低電量告警慢速Battery Warning SlowID 7 / BATTERY_WARNING_SLOW? 試聽慢速低電量告警低電量告警對(duì)應(yīng)電量等級(jí)失效保護(hù)。4.8 低電量告警快速Battery Warning FastID 8 / BATTERY_WARNING_FAST? 試聽快速低電量告警嚴(yán)重低電量告警對(duì)應(yīng)電量等級(jí)失效保護(hù)。定義MBT255a8a8a8...P在最高速度 T255 下連續(xù)快速鳴響與慢速告警形成明顯區(qū)分。4.9 GPS 告警GPS Warning SlowID 9 / GPS_WARNING? 試聽 GPS 告警GPS 信號(hào)異常/未就緒告警。4.10 降落傘釋放Parachute ReleaseID 11 / PARACHUTE_RELEASE? 試聽降落傘釋放音調(diào)降落傘釋放被觸發(fā)。4.11 單聲短嗶Single BeepID 12 / SINGLE_BEEP? 試聽單聲短嗶磁羅盤/指南針校準(zhǔn)提示用戶開始旋轉(zhuǎn)飛行器。歷史 ID 為 14。4.12 設(shè)置返航點(diǎn)音調(diào)Home SetID 13 / HOME_SET? 試聽設(shè)置返航點(diǎn)音調(diào)返航點(diǎn)Home 位置初始化完成僅首次。歷史 ID 為 15。4.13 關(guān)機(jī)音調(diào)Power OffID 19 / POWER_OFF? 試聽關(guān)機(jī)音調(diào)飛行器正在關(guān)機(jī)例如按下關(guān)機(jī)按鈕時(shí)。五、源碼級(jí)解析MML 旋律語法所有音調(diào)都使用 MMLMusic Macro Language字符串編寫語法源自 Microsoft GWBasic/QBasic 的PLAY語句與現(xiàn)代 MML 等價(jià)但要求符號(hào)必須大寫且V符號(hào)被忽略。語法說明收錄在 src/lib/tunes/tune_definition.desc 的文件頭注釋中核心指令如下指令含義AG音符字母升降號(hào)用/#升或-降緊跟在音符后如C C# C C#Ln設(shè)置音符時(shí)長(zhǎng)長(zhǎng)度L1全音符、L2二分音符、L4四分音符、L8八分音符等默認(rèn)n4三連音用L3/L6/L12系列五連音用L5/L10/L20系列。也支持音符后簡(jiǎn)寫如L4 CDE F8G8中 F、G 為八分音符其余為四分音符On設(shè)置當(dāng)前八度合法值 06每個(gè)八度從 C 開始到 B 結(jié)束注意 C- 等價(jià)于 B/分別將當(dāng)前八度下移/上移一級(jí)Nn在七個(gè)八度范圍內(nèi)演奏指定音符合法值 0840 為休止不可與升降號(hào)或簡(jiǎn)寫時(shí)長(zhǎng)同用MNMusic Normal音符時(shí)長(zhǎng)為L(zhǎng)n指示時(shí)長(zhǎng)的 7/8默認(rèn)模式MLMusic Legato音符時(shí)長(zhǎng)等于Ln指示的完整時(shí)長(zhǎng)MSMusic Staccato音符時(shí)長(zhǎng)為L(zhǎng)n指示時(shí)長(zhǎng)的 3/4Pn/Rn休止靜音時(shí)長(zhǎng)規(guī)則同LnTn設(shè)置速度每分鐘的L4數(shù)量合法值 32255默認(rèn)T120Vn被忽略規(guī)范中用于設(shè)置音量PX4 中不生效.附點(diǎn)置于音符后使時(shí)長(zhǎng)變?yōu)樵O(shè)定值的 3/2如L4 C#.為附點(diǎn)四分音符也可用于休止MB/MFMF使音調(diào)播放一次后停止MB使音調(diào)在結(jié)束后重復(fù)播放默認(rèn)參數(shù)在 src/lib/tunes/tunes.h 中定義為默認(rèn)音符時(shí)長(zhǎng)L4、默認(rèn)八度O4、默認(rèn)速度T120、默認(rèn)模式MNNormal。解析器會(huì)忽略字符串中的空白字符并按出現(xiàn)順序執(zhí)行各指令時(shí)長(zhǎng)/八度/速度等狀態(tài)修改對(duì)后續(xù)音符持續(xù)生效。Tunes類內(nèi)部通過note_to_frequency()將音符半音序號(hào)換算為頻率Hz通過note_duration()/rest_duration()依據(jù)速度、時(shí)長(zhǎng)、模式與附點(diǎn)數(shù)量計(jì)算每個(gè)音符的播放時(shí)長(zhǎng)與靜音時(shí)長(zhǎng)單位 μs并遵守TUNE_MAX_UPDATE_INTERVAL_US 100000的最大音符更新間隔。六、TuneControl uORB 消息與驅(qū)動(dòng)鏈路當(dāng)某個(gè)模塊需要播放音調(diào)時(shí)會(huì)發(fā)布tune_controluORB 消息msg/TuneControl.msg關(guān)鍵字段如下字段類型說明tune_iduint8對(duì)應(yīng)TuneID::*見 tune 定義0 為自定義音調(diào)tune_overridebool若為 true正在播放的音調(diào)會(huì)被停止并播放新音調(diào)frequencyuint16自定義音調(diào)頻率Hz僅tune_id CUSTOM時(shí)生效durationuint32自定義音調(diào)時(shí)長(zhǎng)μssilenceuint32自定義音調(diào)靜音時(shí)長(zhǎng)μsvolumeuint8音量 0100VOLUME_LEVEL_MIN0、VOLUME_LEVEL_DEFAULT20、VOLUME_LEVEL_MAX100是否生效取決于后端驅(qū)動(dòng)消息隊(duì)列長(zhǎng)度為 4ORB_QUEUE_LENGTH。TuneID枚舉NONE-1019 見前表由 tune_definition.h 直接#includedesc 文件生成保證枚舉與旋律定義天然同步。在接收端ToneAlarm 驅(qū)動(dòng) 以 10ms 間隔訂閱tune_control收到消息后調(diào)用Tunes::set_control()設(shè)置音調(diào)如果已有音調(diào)在播放且新音調(diào)不可打斷則根據(jù)tune_override決定是否排隊(duì)重發(fā)。Tunes::set_control()的返回值src/lib/tunes/tunes.h含義如下Success新音調(diào)已設(shè)置AlreadyPlaying同一音調(diào)正在播放InvalidTune指定的默認(rèn)音調(diào)不存在WouldInterrupt已有音調(diào)正在播放且不可打斷。Commander模塊src/modules/commander/Commander.cpp、校準(zhǔn)例程src/modules/commander/calibration_routines.cpp等正是通過這一機(jī)制在解鎖、模式切換、校準(zhǔn)等事件時(shí)觸發(fā)提示音。此外tune_publisher 與 TAP_ESC 驅(qū)動(dòng) 也會(huì)消費(fèi)/轉(zhuǎn)發(fā)tune_control消息使調(diào)音不僅能驅(qū)動(dòng)本地蜂鳴器還能發(fā)送給外部設(shè)備如 TAP ESC播放。七、使用 tune-control 命令測(cè)試與調(diào)試音調(diào)PX4 提供了命令行工具tune_control用于手動(dòng)觸發(fā)與測(cè)試外部音調(diào)。前提是系統(tǒng)中有驅(qū)動(dòng)在運(yùn)行并處理tune_controluORB 話題例如 ToneAlarm。該工具實(shí)現(xiàn)在 src/systemcmds/tune_control/tune_control.cpp典型用法在飛控 NSH shell 中執(zhí)行tune_control play # 播放默認(rèn)啟動(dòng)音調(diào)STARTUP tune_control play error # 播放錯(cuò)誤音調(diào)ERROR_TUNE支持的選項(xiàng)px4_getopt解析包括選項(xiàng)參數(shù)說明-f頻率Hz設(shè)置自定義音調(diào)頻率合法范圍 0 f 22000-d時(shí)長(zhǎng)μs設(shè)置自定義音調(diào)時(shí)長(zhǎng)-t音調(diào) ID播放指定 ID 的預(yù)定義音調(diào)取值范圍 0 id 默認(rèn)音調(diào)總數(shù)-m旋律字符串直接播放自定義 MML 旋律字符串必須以M開頭-s音量設(shè)置音量超過VOLUME_LEVEL_MAX會(huì)被截?cái)酁?100例如播放自定義旋律字符串tune_control play -m MFT200e8a8a再如以 440 Hz、200ms 時(shí)長(zhǎng)播放單音tune_control play -f 440 -d 200000tune_control通過向tune_controluORB 話題發(fā)布tune_control_s消息publish_tune_control()實(shí)現(xiàn)播放這與 Commander 等內(nèi)部模塊的觸發(fā)路徑完全一致因此非常適合在地面站/控制臺(tái)手動(dòng)驗(yàn)證新編寫的旋律。注意-m傳入的旋律字符串必須保持有效直到旋律播放完畢。八、開發(fā)者如何新增或修改音調(diào)在 src/lib/tunes/tune_definition.desc 中按PX4_DEFINE_TUNE(序號(hào), 枚舉名, MML 旋律, 是否可打斷)格式增加一行序號(hào)需與現(xiàn)有條目遞增銜接當(dāng)前已用到 19。在 msg/TuneControl.msg 的TUNE_ID_*常量區(qū)同步新增對(duì)應(yīng) ID 常量并相應(yīng)更新NUMBER_OF_TUNES。在業(yè)務(wù)代碼如 Commander中用tune_control_s::TUNE_ID_XXX發(fā)布消息即可觸發(fā)。使用tune_control play -t ID在目標(biāo)硬件上驗(yàn)證效果重復(fù)性旋律務(wù)必標(biāo)記為可打斷interruptible否則會(huì)長(zhǎng)時(shí)間占用蜂鳴器src/lib/tunes/tune_definition.desc 文件頭注釋明確提示重復(fù)音調(diào)應(yīng)定義為可打斷否則需要顯式tone_control stop。需要核對(duì)某個(gè)音調(diào)在代碼中的觸發(fā)點(diǎn)時(shí)直接搜索TUNE_ID_name字符串即可例如TUNE_ID_PARACHUTE_RELEASE、TUNE_ID_BATTERY_WARNING_SLOW。九、常見問題排查開機(jī)無任何聲音先確認(rèn)蜂鳴器硬件連接與 px4_basic_concepts 中的蜂鳴器說明再檢查tone_alarm驅(qū)動(dòng)是否運(yùn)行并訂閱了tune_control話題。啟動(dòng)時(shí)聽到制作文件系統(tǒng)/格式化失敗音調(diào)表明 microSD 卡掛載或格式化異常應(yīng)檢查 SD 卡是否插好、是否需要格式化或更換。運(yùn)行中反復(fù)出現(xiàn)錯(cuò)誤音調(diào)多為 RC 信號(hào)丟失檢查遙控器接收機(jī)連接與 RC 配置若需要。音調(diào)被中斷或聽不清預(yù)定義音調(diào)的可打斷屬性決定了新音調(diào)能否搶占當(dāng)前播放需要連續(xù)告警如嚴(yán)重低電量與一次性提示如校準(zhǔn)成功在定義上做了區(qū)分。tune_control play -m ...無反應(yīng)確認(rèn)旋律以M開頭src/systemcmds/tune_control/tune_control.cpp 會(huì)校驗(yàn)首字符且 MML 語法音符、升降號(hào)、時(shí)長(zhǎng)、八度、速度符合第五節(jié)語法表。通過本文的完整音調(diào)對(duì)照表、MML 語法與源碼級(jí)鏈路分析你不僅能聽懂PX4 飛控的每一次提示還能借助tune_control命令獨(dú)立完成音調(diào)測(cè)試與自定義旋律開發(fā)。贊分享嵌入式物聯(lián)網(wǎng)機(jī)器人自動(dòng)駕駛智能硬件【免費(fèi)下載鏈接】PX4-AutopilotPX4 Autopilot Software項(xiàng)目地址https://gitcode.com/gh_mirrors/px/PX4-Autopilot點(diǎn)擊查看免費(fèi)下載相關(guān)推薦PX4-Autopilot 車輛狀態(tài)通知指南LED、蜂鳴器音調(diào)與 QGC 飛行就緒狀態(tài)全解析PX4 Autopilot 車輛狀態(tài)通知指南LED、蜂鳴器音調(diào)與 QGC 飛行就緒狀態(tài)全解析 PX4 通過視覺LED與聽覺蜂鳴器通道為開發(fā)者與飛手提供嵌入式物聯(lián)網(wǎng)機(jī)器人自動(dòng)駕駛智能硬件Ray Tune 命令行工具Tune CLI實(shí)戰(zhàn)指南用 tune list-trials 管理監(jiān)控調(diào)參實(shí)驗(yàn)Ray Tune 命令行工具Tune CLI實(shí)戰(zhàn)指南用 tune list trials 管理監(jiān)控調(diào)參實(shí)驗(yàn) 導(dǎo)讀 Ray Tune 在 tune 命令下提人工智能分布式訓(xùn)練強(qiáng)化學(xué)習(xí)任務(wù)調(diào)度模型推理服務(wù)后端eSpeak NG 語調(diào)Intonation模型完全指南Tune 定義、編譯與語音合成原理eSpeak NG 語調(diào)Intonation模型完全指南Tune 定義、編譯與語音合成原理 本文是 eSpeak NG 開源語音合成器支持上百種語言與口語音音頻上一篇5分鐘快速上手Arduino ESP32物聯(lián)網(wǎng)開發(fā)終極指南下一篇Steamless如何通過逆向工程解析SteamStub DRM保護(hù)機(jī)制創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 PX4 Autopilot 蜂鳴器音調(diào)（Tune）完全指南：?jiǎn)?dòng)/運(yùn)行音調(diào)含義與 tune-control 調(diào)試實(shí)戰(zhàn)
嵌入式物聯(lián)網(wǎng)機(jī)器人自動(dòng)駕駛智能硬件【免費(fèi)下載鏈接】PX4-AutopilotPX4 Autopilot Software項(xiàng)目地址https://gitcode.com/gh_mirrors/px/PX4-Autopilot點(diǎn)擊查看免費(fèi)下載Pixhawk 系列飛控通過蜂鳴器發(fā)出可聽音調(diào)、配合LED 顏色與閃爍序列向用戶傳達(dá)飛行器的狀態(tài)與事件——例如解鎖成功/失敗、低電量告警、任務(wù)校驗(yàn)結(jié)果等。本文以 docs/en/getting_started/tunes.md 為骨架完整梳理 PX4 全部標(biāo)準(zhǔn)音調(diào)的含義與觸發(fā)時(shí)機(jī)并結(jié)合 src/lib/tunes/tune_definition.desc、tune_control 系統(tǒng)命令 等源碼深入講解 MML 旋律語法、uORB 消息機(jī)制與命令行調(diào)試方法。讀完本文你將能聽懂飛控的每一種提示音、快速定位異常狀態(tài)并能自行定義與測(cè)試自定義音調(diào)。一、PX4 音調(diào)系統(tǒng)的工作原理PX4 的音調(diào)系統(tǒng)由三層協(xié)作完成音調(diào)定義層所有標(biāo)準(zhǔn)音調(diào)集中定義在 src/lib/tunes/tune_definition.desc每個(gè)音調(diào)有一個(gè)序號(hào)ordinal、一個(gè)枚舉名name、一段 MML 旋律字符串和一個(gè)是否可被打斷interruptible標(biāo)志。解析執(zhí)行層src/lib/tunes/tunes.cpp 中的Tunes類負(fù)責(zé)把 MML 字符串逐字符解析成頻率 時(shí)長(zhǎng) 靜音序列ToneAlarm 驅(qū)動(dòng) 訂閱 uORB 的tune_control話題把解析結(jié)果驅(qū)動(dòng)到蜂鳴器硬件。觸發(fā)層Commander、校準(zhǔn)例程、失聯(lián)告警等模塊在相應(yīng)事件發(fā)生時(shí)通過 uORB 消息tune_control發(fā)布要播放的音調(diào) ID。其中消息定義見 msg/TuneControl.msg它同時(shí)承載預(yù)定義音調(diào) ID 與自定義音調(diào)頻率/時(shí)長(zhǎng)/音量?jī)煞N模式當(dāng)tune_id為TUNE_ID_CUSTOM(0)時(shí)使用消息里的frequency、duration、silence字段否則這些字段被忽略。音調(diào) ID 枚舉TUNE_ID_*119與 src/lib/tunes/tune_definition.desc 中的定義一一對(duì)應(yīng)該文件通過PX4_DEFINE_TUNE宏被 tune_definition.h 和 default_tunes.cpp 分別展開為TuneID枚舉、旋律字符串?dāng)?shù)組與可打斷標(biāo)志數(shù)組。二、標(biāo)準(zhǔn)音調(diào)總覽下表匯總了全部 20 個(gè)音調(diào)含保留的 0 號(hào)自定義音調(diào)及其 ID、枚舉名與播放性質(zhì)供速查ID枚舉名說明可打斷0CUSTOM自定義音調(diào)通過消息頻率/時(shí)長(zhǎng)播放是1STARTUP啟動(dòng)音調(diào)microSD 掛載成功是2ERROR_TUNE錯(cuò)誤音調(diào)硬故障重啟等是3NOTIFY_POSITIVE正向提示校準(zhǔn)成功/模式切換成功是4NOTIFY_NEUTRAL中性提示任務(wù)有效/安全開關(guān)打開是5NOTIFY_NEGATIVE負(fù)向提示校準(zhǔn)失敗/命令被拒是6ARMING_WARNING解鎖警告已解鎖否7BATTERY_WARNING_SLOW低電量告警慢速是8BATTERY_WARNING_FAST嚴(yán)重低電量告警快速是9GPS_WARNINGGPS 告警否10ARMING_FAILURE解鎖失敗音調(diào)否11PARACHUTE_RELEASE降落傘釋放否12SINGLE_BEEP單聲短嗶羅盤校準(zhǔn)提示旋轉(zhuǎn)機(jī)體否13HOME_SET設(shè)置返航點(diǎn)僅首次否14SD_INIT制作文件系統(tǒng) / 掛載失敗 / 無 SD 卡否15SD_ERROR格式化 SD 卡失敗否16PROG_PX4IO開始燒寫 PX4IO否17PROG_PX4IO_OKPX4IO 燒寫成功否18PROG_PX4IO_ERRPX4IO 燒寫失敗是19POWER_OFF關(guān)機(jī)音調(diào)否開發(fā)者提示可在倉庫中搜索字符串TUNE_ID_name例如TUNE_ID_PARACHUTE_RELEASE來定位某個(gè)音調(diào)在代碼中的觸發(fā)位置。參考 src/lib/tunes/tune_definition.desc。三、啟動(dòng)階段音調(diào)Boot/Startup這些音調(diào)在開機(jī)引導(dǎo)序列見 ROMFS/px4fmu_common/init.d/rcS中播放用來報(bào)告引導(dǎo)各環(huán)節(jié)的結(jié)果。3.1 啟動(dòng)音調(diào)Startup ToneID 1 / STARTUP? 試聽啟動(dòng)音調(diào)microSD 卡在引導(dǎo)過程中成功掛載。其旋律定義為MFT240L8 O4aO5dc O4aO5dc O4aO5dc L16dcdcdcdcT240 速度下以八度 4/5 交替演奏上行裝飾音給人系統(tǒng)就緒的聽感。3.2 錯(cuò)誤音調(diào)Error TuneID 2 / ERROR_TUNE? 試聽錯(cuò)誤音調(diào)觸發(fā)場(chǎng)景包括硬故障hard fault導(dǎo)致系統(tǒng)重啟系統(tǒng)配置為使用 PX4IO 但未檢測(cè)到 IOUAVCAN 已使能但驅(qū)動(dòng)無法啟動(dòng)SITL/HITL 已使能但_pwm_out_sim_驅(qū)動(dòng)無法啟動(dòng)FMU 啟動(dòng)失敗。對(duì)應(yīng)旋律MBT200a8a8a8PaaaPMB表示重復(fù)播放除非被打斷或顯式調(diào)用tone_control stop。3.3 制作文件系統(tǒng)Make File SystemID 14 / SD_INIT? 試聽制作文件系統(tǒng)音調(diào)觸發(fā)場(chǎng)景正在格式化 microSD 卡掛載失敗若格式化成功引導(dǎo)序列會(huì)再次嘗試掛載未檢測(cè)到 microSD 卡。該音調(diào)歷史 ID 為 16現(xiàn)枚舉名為SD_INIT。3.4 格式化失敗Format FailedID 15 / SD_ERROR? 試聽格式化失敗音調(diào)在先前嘗試掛載卡失敗之后microSD 卡格式化仍然失敗。歷史 ID 為 17現(xiàn)枚舉名為SD_ERROR。3.5 燒寫 PX4IOProgram PX4IOID 16 / PROG_PX4IO? 試聽燒寫 PX4IO 音調(diào)開始對(duì) PX4IO 協(xié)處理器進(jìn)行固件燒寫。3.6 燒寫 PX4IO 成功Program PX4IO SuccessID 17 / PROG_PX4IO_OK? 試聽燒寫成功音調(diào)PX4IO 燒寫成功。3.7 燒寫 PX4IO 失敗Program PX4IO FailID 18 / PROG_PX4IO_ERR? 試聽燒寫失敗音調(diào)觸發(fā)場(chǎng)景PX4IO 燒寫失敗PX4IO 無法啟動(dòng)未找到 AUX Mixer。該音調(diào)被標(biāo)記為可打斷interruptible避免長(zhǎng)時(shí)間占用蜂鳴器。四、運(yùn)行階段音調(diào)Operational這些音調(diào)在飛行器正常運(yùn)行期間發(fā)出用于反饋各類事件與告警。4.1 錯(cuò)誤音調(diào)Error TuneID 2 / ERROR_TUNE? 試聽錯(cuò)誤音調(diào)RC 遙控器信號(hào)丟失RC Loss。4.2 正向提示音Notify PositiveID 3 / NOTIFY_POSITIVE? 試聽正向提示音觸發(fā)場(chǎng)景校準(zhǔn)成功飛行模式切換成功命令被接受例如來自 MAVLink 命令協(xié)議安全開關(guān)已關(guān)閉飛行器可以被解鎖。4.3 中性提示音Notify NeutralID 4 / NOTIFY_NEUTRAL? 試聽中性提示音觸發(fā)場(chǎng)景任務(wù)有效且無警告空速校準(zhǔn)需要提供更多氣壓或校準(zhǔn)完成安全開關(guān)已打開/已上鎖可以安全接近飛行器。4.4 負(fù)向提示音Notify NegativeID 5 / NOTIFY_NEGATIVE? 試聽負(fù)向提示音觸發(fā)場(chǎng)景校準(zhǔn)失敗校準(zhǔn)已完成重復(fù)校準(zhǔn)被拒絕任務(wù)無效命令被拒絕、執(zhí)行失敗或暫時(shí)被拒例如來自 MAVLink 命令協(xié)議解鎖/上鎖轉(zhuǎn)換被拒絕例如起飛前檢查失敗、安全開關(guān)未關(guān)閉、系統(tǒng)不在手動(dòng)模式拒絕模式切換。4.5 解鎖警告Arming WarningID 6 / ARMING_WARNING? 試聽解鎖警告音飛行器已成功解鎖。定義MNT75L1O2G使用 Legato 模式、T75 速度演奏低八度長(zhǎng)音 G形成持續(xù)警示感該音調(diào)不可打斷。4.6 解鎖失敗音調(diào)Arming FailureID 10 / ARMING_FAILURE? 試聽解鎖失敗音調(diào)解鎖失敗。4.7 低電量告警慢速Battery Warning SlowID 7 / BATTERY_WARNING_SLOW? 試聽慢速低電量告警低電量告警對(duì)應(yīng)電量等級(jí)失效保護(hù)。4.8 低電量告警快速Battery Warning FastID 8 / BATTERY_WARNING_FAST? 試聽快速低電量告警嚴(yán)重低電量告警對(duì)應(yīng)電量等級(jí)失效保護(hù)。定義MBT255a8a8a8...P在最高速度 T255 下連續(xù)快速鳴響與慢速告警形成明顯區(qū)分。4.9 GPS 告警GPS Warning SlowID 9 / GPS_WARNING? 試聽 GPS 告警GPS 信號(hào)異常/未就緒告警。4.10 降落傘釋放Parachute ReleaseID 11 / PARACHUTE_RELEASE? 試聽降落傘釋放音調(diào)降落傘釋放被觸發(fā)。4.11 單聲短嗶Single BeepID 12 / SINGLE_BEEP? 試聽單聲短嗶磁羅盤/指南針校準(zhǔn)提示用戶開始旋轉(zhuǎn)飛行器。歷史 ID 為 14。4.12 設(shè)置返航點(diǎn)音調(diào)Home SetID 13 / HOME_SET? 試聽設(shè)置返航點(diǎn)音調(diào)返航點(diǎn)Home 位置初始化完成僅首次。歷史 ID 為 15。4.13 關(guān)機(jī)音調(diào)Power OffID 19 / POWER_OFF? 試聽關(guān)機(jī)音調(diào)飛行器正在關(guān)機(jī)例如按下關(guān)機(jī)按鈕時(shí)。五、源碼級(jí)解析MML 旋律語法所有音調(diào)都使用 MMLMusic Macro Language字符串編寫語法源自 Microsoft GWBasic/QBasic 的PLAY語句與現(xiàn)代 MML 等價(jià)但要求符號(hào)必須大寫且V符號(hào)被忽略。語法說明收錄在 src/lib/tunes/tune_definition.desc 的文件頭注釋中核心指令如下指令含義AG音符字母升降號(hào)用/#升或-降緊跟在音符后如C C# C C#Ln設(shè)置音符時(shí)長(zhǎng)長(zhǎng)度L1全音符、L2二分音符、L4四分音符、L8八分音符等默認(rèn)n4三連音用L3/L6/L12系列五連音用L5/L10/L20系列。也支持音符后簡(jiǎn)寫如L4 CDE F8G8中 F、G 為八分音符其余為四分音符On設(shè)置當(dāng)前八度合法值 06每個(gè)八度從 C 開始到 B 結(jié)束注意 C- 等價(jià)于 B/分別將當(dāng)前八度下移/上移一級(jí)Nn在七個(gè)八度范圍內(nèi)演奏指定音符合法值 0840 為休止不可與升降號(hào)或簡(jiǎn)寫時(shí)長(zhǎng)同用MNMusic Normal音符時(shí)長(zhǎng)為L(zhǎng)n指示時(shí)長(zhǎng)的 7/8默認(rèn)模式MLMusic Legato音符時(shí)長(zhǎng)等于Ln指示的完整時(shí)長(zhǎng)MSMusic Staccato音符時(shí)長(zhǎng)為L(zhǎng)n指示時(shí)長(zhǎng)的 3/4Pn/Rn休止靜音時(shí)長(zhǎng)規(guī)則同LnTn設(shè)置速度每分鐘的L4數(shù)量合法值 32255默認(rèn)T120Vn被忽略規(guī)范中用于設(shè)置音量PX4 中不生效.附點(diǎn)置于音符后使時(shí)長(zhǎng)變?yōu)樵O(shè)定值的 3/2如L4 C#.為附點(diǎn)四分音符也可用于休止MB/MFMF使音調(diào)播放一次后停止MB使音調(diào)在結(jié)束后重復(fù)播放默認(rèn)參數(shù)在 src/lib/tunes/tunes.h 中定義為默認(rèn)音符時(shí)長(zhǎng)L4、默認(rèn)八度O4、默認(rèn)速度T120、默認(rèn)模式MNNormal。解析器會(huì)忽略字符串中的空白字符并按出現(xiàn)順序執(zhí)行各指令時(shí)長(zhǎng)/八度/速度等狀態(tài)修改對(duì)后續(xù)音符持續(xù)生效。Tunes類內(nèi)部通過note_to_frequency()將音符半音序號(hào)換算為頻率Hz通過note_duration()/rest_duration()依據(jù)速度、時(shí)長(zhǎng)、模式與附點(diǎn)數(shù)量計(jì)算每個(gè)音符的播放時(shí)長(zhǎng)與靜音時(shí)長(zhǎng)單位 μs并遵守TUNE_MAX_UPDATE_INTERVAL_US 100000的最大音符更新間隔。六、TuneControl uORB 消息與驅(qū)動(dòng)鏈路當(dāng)某個(gè)模塊需要播放音調(diào)時(shí)會(huì)發(fā)布tune_controluORB 消息msg/TuneControl.msg關(guān)鍵字段如下字段類型說明tune_iduint8對(duì)應(yīng)TuneID::*見 tune 定義0 為自定義音調(diào)tune_overridebool若為 true正在播放的音調(diào)會(huì)被停止并播放新音調(diào)frequencyuint16自定義音調(diào)頻率Hz僅tune_id CUSTOM時(shí)生效durationuint32自定義音調(diào)時(shí)長(zhǎng)μssilenceuint32自定義音調(diào)靜音時(shí)長(zhǎng)μsvolumeuint8音量 0100VOLUME_LEVEL_MIN0、VOLUME_LEVEL_DEFAULT20、VOLUME_LEVEL_MAX100是否生效取決于后端驅(qū)動(dòng)消息隊(duì)列長(zhǎng)度為 4ORB_QUEUE_LENGTH。TuneID枚舉NONE-1019 見前表由 tune_definition.h 直接#includedesc 文件生成保證枚舉與旋律定義天然同步。在接收端ToneAlarm 驅(qū)動(dòng) 以 10ms 間隔訂閱tune_control收到消息后調(diào)用Tunes::set_control()設(shè)置音調(diào)如果已有音調(diào)在播放且新音調(diào)不可打斷則根據(jù)tune_override決定是否排隊(duì)重發(fā)。Tunes::set_control()的返回值src/lib/tunes/tunes.h含義如下Success新音調(diào)已設(shè)置AlreadyPlaying同一音調(diào)正在播放InvalidTune指定的默認(rèn)音調(diào)不存在WouldInterrupt已有音調(diào)正在播放且不可打斷。Commander模塊src/modules/commander/Commander.cpp、校準(zhǔn)例程src/modules/commander/calibration_routines.cpp等正是通過這一機(jī)制在解鎖、模式切換、校準(zhǔn)等事件時(shí)觸發(fā)提示音。此外tune_publisher 與 TAP_ESC 驅(qū)動(dòng) 也會(huì)消費(fèi)/轉(zhuǎn)發(fā)tune_control消息使調(diào)音不僅能驅(qū)動(dòng)本地蜂鳴器還能發(fā)送給外部設(shè)備如 TAP ESC播放。七、使用 tune-control 命令測(cè)試與調(diào)試音調(diào)PX4 提供了命令行工具tune_control用于手動(dòng)觸發(fā)與測(cè)試外部音調(diào)。前提是系統(tǒng)中有驅(qū)動(dòng)在運(yùn)行并處理tune_controluORB 話題例如 ToneAlarm。該工具實(shí)現(xiàn)在 src/systemcmds/tune_control/tune_control.cpp典型用法在飛控 NSH shell 中執(zhí)行tune_control play # 播放默認(rèn)啟動(dòng)音調(diào)STARTUP tune_control play error # 播放錯(cuò)誤音調(diào)ERROR_TUNE支持的選項(xiàng)px4_getopt解析包括選項(xiàng)參數(shù)說明-f頻率Hz設(shè)置自定義音調(diào)頻率合法范圍 0 f 22000-d時(shí)長(zhǎng)μs設(shè)置自定義音調(diào)時(shí)長(zhǎng)-t音調(diào) ID播放指定 ID 的預(yù)定義音調(diào)取值范圍 0 id 默認(rèn)音調(diào)總數(shù)-m旋律字符串直接播放自定義 MML 旋律字符串必須以M開頭-s音量設(shè)置音量超過VOLUME_LEVEL_MAX會(huì)被截?cái)酁?100例如播放自定義旋律字符串tune_control play -m MFT200e8a8a再如以 440 Hz、200ms 時(shí)長(zhǎng)播放單音tune_control play -f 440 -d 200000tune_control通過向tune_controluORB 話題發(fā)布tune_control_s消息publish_tune_control()實(shí)現(xiàn)播放這與 Commander 等內(nèi)部模塊的觸發(fā)路徑完全一致因此非常適合在地面站/控制臺(tái)手動(dòng)驗(yàn)證新編寫的旋律。注意-m傳入的旋律字符串必須保持有效直到旋律播放完畢。八、開發(fā)者如何新增或修改音調(diào)在 src/lib/tunes/tune_definition.desc 中按PX4_DEFINE_TUNE(序號(hào), 枚舉名, MML 旋律, 是否可打斷)格式增加一行序號(hào)需與現(xiàn)有條目遞增銜接當(dāng)前已用到 19。在 msg/TuneControl.msg 的TUNE_ID_*常量區(qū)同步新增對(duì)應(yīng) ID 常量并相應(yīng)更新NUMBER_OF_TUNES。在業(yè)務(wù)代碼如 Commander中用tune_control_s::TUNE_ID_XXX發(fā)布消息即可觸發(fā)。使用tune_control play -t ID在目標(biāo)硬件上驗(yàn)證效果重復(fù)性旋律務(wù)必標(biāo)記為可打斷interruptible否則會(huì)長(zhǎng)時(shí)間占用蜂鳴器src/lib/tunes/tune_definition.desc 文件頭注釋明確提示重復(fù)音調(diào)應(yīng)定義為可打斷否則需要顯式tone_control stop。需要核對(duì)某個(gè)音調(diào)在代碼中的觸發(fā)點(diǎn)時(shí)直接搜索TUNE_ID_name字符串即可例如TUNE_ID_PARACHUTE_RELEASE、TUNE_ID_BATTERY_WARNING_SLOW。九、常見問題排查開機(jī)無任何聲音先確認(rèn)蜂鳴器硬件連接與 px4_basic_concepts 中的蜂鳴器說明再檢查tone_alarm驅(qū)動(dòng)是否運(yùn)行并訂閱了tune_control話題。啟動(dòng)時(shí)聽到制作文件系統(tǒng)/格式化失敗音調(diào)表明 microSD 卡掛載或格式化異常應(yīng)檢查 SD 卡是否插好、是否需要格式化或更換。運(yùn)行中反復(fù)出現(xiàn)錯(cuò)誤音調(diào)多為 RC 信號(hào)丟失檢查遙控器接收機(jī)連接與 RC 配置若需要。音調(diào)被中斷或聽不清預(yù)定義音調(diào)的可打斷屬性決定了新音調(diào)能否搶占當(dāng)前播放需要連續(xù)告警如嚴(yán)重低電量與一次性提示如校準(zhǔn)成功在定義上做了區(qū)分。tune_control play -m ...無反應(yīng)確認(rèn)旋律以M開頭src/systemcmds/tune_control/tune_control.cpp 會(huì)校驗(yàn)首字符且 MML 語法音符、升降號(hào)、時(shí)長(zhǎng)、八度、速度符合第五節(jié)語法表。通過本文的完整音調(diào)對(duì)照表、MML 語法與源碼級(jí)鏈路分析你不僅能聽懂PX4 飛控的每一次提示還能借助tune_control命令獨(dú)立完成音調(diào)測(cè)試與自定義旋律開發(fā)。贊分享嵌入式物聯(lián)網(wǎng)機(jī)器人自動(dòng)駕駛智能硬件【免費(fèi)下載鏈接】PX4-AutopilotPX4 Autopilot Software項(xiàng)目地址https://gitcode.com/gh_mirrors/px/PX4-Autopilot點(diǎn)擊查看免費(fèi)下載相關(guān)推薦PX4-Autopilot 車輛狀態(tài)通知指南LED、蜂鳴器音調(diào)與 QGC 飛行就緒狀態(tài)全解析PX4 Autopilot 車輛狀態(tài)通知指南LED、蜂鳴器音調(diào)與 QGC 飛行就緒狀態(tài)全解析 PX4 通過視覺LED與聽覺蜂鳴器通道為開發(fā)者與飛手提供嵌入式物聯(lián)網(wǎng)機(jī)器人自動(dòng)駕駛智能硬件Ray Tune 命令行工具Tune CLI實(shí)戰(zhàn)指南用 tune list-trials 管理監(jiān)控調(diào)參實(shí)驗(yàn)Ray Tune 命令行工具Tune CLI實(shí)戰(zhàn)指南用 tune list trials 管理監(jiān)控調(diào)參實(shí)驗(yàn) 導(dǎo)讀 Ray Tune 在 tune 命令下提人工智能分布式訓(xùn)練強(qiáng)化學(xué)習(xí)任務(wù)調(diào)度模型推理服務(wù)后端eSpeak NG 語調(diào)Intonation模型完全指南Tune 定義、編譯與語音合成原理eSpeak NG 語調(diào)Intonation模型完全指南Tune 定義、編譯與語音合成原理 本文是 eSpeak NG 開源語音合成器支持上百種語言與口語音音頻上一篇5分鐘快速上手Arduino ESP32物聯(lián)網(wǎng)開發(fā)終極指南下一篇Steamless如何通過逆向工程解析SteamStub DRM保護(hù)機(jī)制創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考