API / SDK / developer guide
mavgen library generation
| 目標讀者 TA | 通訊協定／建置工程師 |
|---|---|
| 官方文件能力 | 從方言 XML 產生語言函式庫。 |
| 輸入 → 輸出 | 方言、語言、線路版本 → 產生的原始碼。 |
| 執行環境 | 建置期產生器工具鏈。 |
| 本站選型評估 | 語言與 MAVLink 版本支援有別。 |
| 本站建議驗證 | 固定 XML 與產生器修訂；檢查產生結果相容性。 |
UAV／任務整合 · protocol
MAVLink
MAVLink Project
在載具、地面站與伴隨系統間交換結構化訊息。
固定方言 XML 及產生器版本。通訊協定定義、產生式函式庫支援與自動駕駛實作是不同相容性檢查。簽署是驗證而非加密。
MAVLINK / DEVELOPER FIELD GUIDE
選對接口，定義可驗證的結果。
公司／專案背景、十個技術入口，以及每份引用的實作分析。
2026-10-08 · 串接尚未實測
公司／專案背景全貌
依官方公司或專案自述撰寫的原創概要；完整原文請見來源。
| 專案 | MAVLink 是載具與機載元件的輕量訊息協定。XML 方言定義用於產生語言函式庫；遙測串流與要求／回應微服務服務不同通訊需求。 |
|---|---|
| 開發者適用性 | 適合建置通訊協定轉接、伴飛應用與地面系統。它定義訊息與互動，並不保證特定自動駕駛系統實作全部功能。 |
| 適用角色 | 進行 AI 供應商初選的採購、合作夥伴與產品負責人。 |
|---|---|
| 本站評估 | 用定位與公司背景判斷初步適配度；另行取得專案部署、支援與商務條件。 |
已核對官方來源；未執行真實 API、推論或效能測試。預期結果為建議內部契約。
十項技術入口比較
依開發任務選出的十個有文件技術入口；不是十套獨立 SDK 或官方排名。
| 接口 | 用途與 TA |
|---|---|
| 01 · mavgen library generationAPI / SDK / developer guide | 從方言 XML 產生語言函式庫。通訊協定／建置工程師 |
| 02 · C reference libraryAPI / SDK / developer guide | 在 C 中封裝及解析 MAVLink 訊息。嵌入式韌體開發者 |
| 03 · PymavlinkAPI / SDK / developer guide | 在 Python 解析及處理 MAVLink 訊息。Python 遙測開發者 |
| 04 · Common message definitionsAPI / SDK / developer guide | 查詢欄位型別、單位及語意。遙測結構設計者 |
| 05 · Heartbeat/connection protocolAPI / SDK / developer guide | 探索元件並監控心跳存在性。連線狀態開發者 |
| 06 · Packet serializationAPI / SDK / developer guide | 理解線路框架與酬載序列化。編解碼器作者 |
| 07 · MAVLink 2 signingAPI / SDK / developer guide | 驗證簽署訊息並套用重播檢查。傳輸驗證工程師 |
| 08 · Routing rulesAPI / SDK / developer guide | 依系統／元件定址路由訊息。多元件網路開發者 |
| 09 · Packet-loss interpretationAPI / SDK / developer guide | 估算封包遺失時解讀序列缺口。遙測可靠性分析者 |
| 10 · Time synchronization v2API / SDK / developer guide | 透過時間同步訊息估算時鐘偏移。多時鐘資料管線工程師 |
逐份文件分析
能力摘要依據官方文件；限制與建議測試為本站工程評估。
API / SDK / developer guide
C reference library
| 目標讀者 TA | 嵌入式韌體開發者 |
|---|---|
| 官方文件能力 | 在 C 中封裝及解析 MAVLink 訊息。 |
| 輸入 → 輸出 | 具型別欄位／位元組串流 → 封包／解碼訊息。 |
| 執行環境 | 僅標頭的產生式 C 函式庫。 |
| 本站選型評估 | 選擇正確方言與通訊協定版本。 |
| 本站建議驗證 | 以錄製測試資料驗證校驗及訊息邊界。 |
API / SDK / developer guide
Pymavlink
| 目標讀者 TA | Python 遙測開發者 |
|---|---|
| 官方文件能力 | 在 Python 解析及處理 MAVLink 訊息。 |
| 輸入 → 輸出 | 連線／日誌輸入 → 具型別訊息。 |
| 執行環境 | Python pymavlink。 |
| 本站選型評估 | 需要自訂訊息時須明確選擇方言。 |
| 本站建議驗證 | 轉接層保留發送者 ID 與解碼錯誤。 |
API / SDK / developer guide
Common message definitions
| 目標讀者 TA | 遙測結構設計者 |
|---|---|
| 官方文件能力 | 查詢欄位型別、單位及語意。 |
| 輸入 → 輸出 | 訊息 ID／名稱 → 規範欄位定義。 |
| 執行環境 | 產生式編解碼器及轉接層的參考。 |
| 本站選型評估 | 已定義訊息不一定由所有自動駕駛系統發送。 |
| 本站建議驗證 | 逐欄位檢查比例、特殊值及座標框架。 |
API / SDK / developer guide
Heartbeat/connection protocol
| 目標讀者 TA | 連線狀態開發者 |
|---|---|
| 官方文件能力 | 探索元件並監控心跳存在性。 |
| 輸入 → 輸出 | HEARTBEAT 串流 → 元件識別／存活觀測。 |
| 執行環境 | MAVLink 接收端。 |
| 本站選型評估 | 逾時政策取決於通道／應用。 |
| 本站建議驗證 | 揭露最後接收與斷線政策；存在心跳不是飛行許可。 |
API / SDK / developer guide
Packet serialization
| 目標讀者 TA | 編解碼器作者 |
|---|---|
| 官方文件能力 | 理解線路框架與酬載序列化。 |
| 輸入 → 輸出 | 訊息欄位 → MAVLink 封包位元組。 |
| 執行環境 | 通訊協定編解碼層。 |
| 本站選型評估 | MAVLink 1 與 2 的框架及擴充處理不同。 |
| 本站建議驗證 | 以截斷／無效測試封包驗證解碼拒絕。 |
API / SDK / developer guide
MAVLink 2 signing
| 目標讀者 TA | 傳輸驗證工程師 |
|---|---|
| 官方文件能力 | 驗證簽署訊息並套用重播檢查。 |
| 輸入 → 輸出 | 簽署封包、金鑰與時間戳狀態 → 接受決策。 |
| 執行環境 | 支援簽署的 MAVLink 2 實作。 |
| 本站選型評估 | 簽署提供驗證，不加密訊息內容。 |
| 本站建議驗證 | 依政策拒絕無效簽章；日誌不得包含金鑰。 |
API / SDK / developer guide
Routing rules
| 目標讀者 TA | 多元件網路開發者 |
|---|---|
| 官方文件能力 | 依系統／元件定址路由訊息。 |
| 輸入 → 輸出 | 封包目標與已知路由 → 轉送決策。 |
| 執行環境 | MAVLink 路由器／元件。 |
| 本站選型評估 | 廣播與定向流量處理不同。 |
| 本站建議驗證 | 以離線測試資料驗證沒有非預期跨載具傳送。 |
API / SDK / developer guide
Packet-loss interpretation
| 目標讀者 TA | 遙測可靠性分析者 |
|---|---|
| 官方文件能力 | 估算封包遺失時解讀序列缺口。 |
| 輸入 → 輸出 | 觀測序列編號 → 遺失估算。 |
| 執行環境 | 接收端分析。 |
| 本站選型評估 | 路由／篩選可能影響觀測序列缺口。 |
| 本站建議驗證 | 註明觀測通道，避免將每個缺口視為無線電遺失。 |
API / SDK / developer guide
Time synchronization v2
| 目標讀者 TA | 多時鐘資料管線工程師 |
|---|---|
| 官方文件能力 | 透過時間同步訊息估算時鐘偏移。 |
| 輸入 → 輸出 | 時間戳交換 → 偏移／往返觀測。 |
| 執行環境 | 參與的 MAVLink 元件。 |
| 本站選型評估 | 開機時間與日曆時間不可互換。 |
| 本站建議驗證 | 合併串流前記錄時間領域及偏移可信度。 |
04 / INPUT · EXPECTED OUTPUT · ACCEPTANCE
實作前先看懂預期結果
僅離線解碼／遙測契約示意；未連接設備、傳送封包或發送載具命令。
示意契約 · 未呼叫 API 或執行模型 · 不是供應商實測輸出
解碼位置測試資料
| 輸入 | 虛構 GLOBAL_POSITION_INT 值 lat=250000000、lon=1210000000、relative_alt=12000。 |
|---|---|
| 預期結果 | 內部緯度 25 度、經度 121 度、相對起始點高度 12 公尺。 |
| 驗收條件 | 保留 sysid／compid 及開機時間領域；不推論 UTC 或新鮮度。 |
無符合訊息
| 輸入 | 有效錄製封包不含要求訊息類型。 |
|---|---|
| 預期結果 | 內部 status=empty、samples=[]。 |
| 驗收條件 | 篩選空結果不代表連線中斷。 |
損壞框架
| 輸入 | 測試資料包含無效校驗或不完整位元組。 |
|---|---|
| 預期結果 | 內部解碼錯誤；無正規化位置。 |
| 驗收條件 | 不得將未驗證欄位視為健康遙測。 |
心跳缺口
| 輸入 | 錄製心跳缺口超過應用門檻。 |
|---|---|
| 預期結果 | 內部 state=disconnected；last_sample 標為過期。 |
| 驗收條件 | 回報所選門檻及觀測時間；不發送恢復命令。 |
將預期結果對應至你的應用
整合後將實際 SDK 或服務回應對應至此建議內部契約。下列識別碼與數值均為示意；不含憑證或真實請求。
預期輸出 JSON — 示意，非實測 · MAVLink-expected-results.json
{
"schema_version": "1.0.0",
"example": true,
"provider": "MAVLink",
"status": "ok",
"input_id": "sample-001",
"data": {
"message": "GLOBAL_POSITION_INT",
"system_id": 1,
"component_id": 1,
"latitude_deg": 25.0,
"longitude_deg": 121.0,
"relative_altitude_m": 12.0,
"altitude_reference": "home",
"time_domain": "boot",
"time_boot_ms": 1000,
"received_at": null,
"freshness": "unmeasured",
"connection_state": "illustrative_observed"
},
"error": null,
"verification": "illustrative-only;not-provider-response"
}| 結果解讀 | 傳輸或執行成功不代表模型準確。有效空結果須與操作失敗分開。 |
|---|---|
| 可重現性 | 記錄模型、環境、設定與輸入識別；代表性測試前約定品質及延遲條件。不宣稱已實測效能。 |
| 操作範圍 | 僅離線解碼／遙測契約示意；未連接設備、傳送封包或發送載具命令。 |
開發評估
任務紀錄訊息解碼器
開發構想規格・串接尚未實測
接口能力依據官方文件或程式庫；以下產品方向、輸入、交付與驗收條件則是我們的開發評估。
需整合驗證
估算可交付產品前，需共同驗證執行環境、資料結構或硬體。
- 原型輸入規劃
- 支援的模擬器或測試載具、鎖定韌體版本與遙測通道。
- 原型交付規劃
- 附載具、座標框架、時間與連線狀態的唯讀任務檢視。
- 驗收條件
- 對照參考紀錄檢查位置、電池與連線；明確顯示過期資料及斷線。
- 依賴條件
- 逐機型及韌體相容性、模擬器，以及另外審核的實體作業流程。
串接前置條件
固定方言 XML 及產生器版本。通訊協定定義、產生式函式庫支援與自動駕駛實作是不同相容性檢查。簽署是驗證而非加密。
開發順序
- 確認 MAVLink 的存取、授權與支援版本。
- 準備上述樣本，針對「任務紀錄訊息解碼器」先實作一個有官方文件的操作。
- 整理輸出時保留來源、時間與錯誤狀態，並保留供應商回應供審核。
- 通過驗收條件後，再估算擴展投入與客戶交付。
如何驗證需求
記錄產品瀏覽、官方文件點擊、規格下載與技術 Hub 點擊。這些是事件次數，不等於獨立人數或已完成串接。
本次可行性評估依實作條件判斷；尚未給定流量排名或交期承諾。