API / SDK / developer guide
Core Command API
| 目標讀者 TA | 裝置整合團隊 |
|---|---|
| 官方文件能力 | 透過共用服務存取裝置命令。 |
| 輸入 → 輸出 | 裝置命令請求 → 介面／裝置回應。 |
| 執行環境 | 相容 EdgeX 4.0 服務、SDK 及設定裝置介面 |
| 本站選型評估 | 接受命令不證明預期實體效果。 |
| 本站建議驗證 | 分別確認命令結果及實際裝置狀態。 |
工業 IoT／SCADA · API / SDK
EdgeX Foundry
EdgeX Foundry
透過模組化平台串接邊緣裝置服務。
技術引用固定為 EdgeX 4.0 文件，不宣稱 4.0 為最新版。儲存庫 main 為開發程式；須選相容的已發行服務及 SDK。
EDGEX FOUNDRY / DEVELOPER FIELD GUIDE
選對接口，定義可驗證的結果。
公司／專案背景、十個技術入口，以及每份引用的實作分析。
2026-10-08 · 串接尚未實測
公司／專案背景全貌
依官方公司或專案自述撰寫的原創概要；完整原文請見來源。
| 專案 | EdgeX Foundry 是 Linux Foundation 託管、供應商中立的開源 IoT 邊緣框架。 |
|---|---|
| 架構 | 專案以互通元件區分裝置整合、核心服務及應用處理。 |
| 儲存庫角色 | edgex-go 包含 Go 核心／支援服務實作；main 分支明示為開發工作。 |
| 適用角色 | 進行 AI 供應商初選的採購、合作夥伴與產品負責人。 |
|---|---|
| 本站評估 | 用定位與公司背景判斷初步適配度；另行取得專案部署、支援與商務條件。 |
已核對官方來源；未執行真實 API、推論或效能測試。預期結果為建議內部契約。
十項技術入口比較
依開發任務選出的十個有文件技術入口；不是十套獨立 SDK 或官方排名。
| 接口 | 用途與 TA |
|---|---|
| 01 · Core Command APIAPI / SDK / developer guide | 透過共用服務存取裝置命令。裝置整合團隊 |
| 02 · Core Data APIAPI / SDK / developer guide | 存取事件及讀值。遙測工程師 |
| 03 · Core Metadata APIAPI / SDK / developer guide | 管理裝置及 profile 中繼資料。裝置登錄團隊 |
| 04 · Core Keeper APIAPI / SDK / developer guide | 使用 Core Keeper 服務介面。平台營運者 |
| 05 · Application Functions Go SDKAPI / SDK / developer guide | 建立接收邊緣事件的應用管線。Go 應用工程師 |
| 06 · Application Functions Python SDKAPI / SDK / developer guide | 使用 Python 建立應用函式。Python 邊緣團隊 |
| 07 · Device Service Go SDKAPI / SDK / developer guide | 為外部協定實作裝置服務。Go 驅動作者 |
| 08 · Device Service C SDKAPI / SDK / developer guide | 實作原生裝置服務整合。C 裝置整合者 |
| 09 · Device profilesAPI / SDK / developer guide | 描述裝置資源、型別及命令。裝置模型設計者 |
| 10 · Store and ForwardAPI / SDK / developer guide | 匯出失敗時保留資料供稍後傳遞。韌性工程師 |
逐份文件分析
能力摘要依據官方文件；限制與建議測試為本站工程評估。
API / SDK / developer guide
Core Data API
| 目標讀者 TA | 遙測工程師 |
|---|---|
| 官方文件能力 | 存取事件及讀值。 |
| 輸入 → 輸出 | 事件／讀值查詢 → 儲存遙測。 |
| 執行環境 | 相容 EdgeX 4.0 服務、SDK 及設定裝置介面 |
| 本站選型評估 | 儲存讀值可能過期或使用 profile 特定型別。 |
| 本站建議驗證 | 驗證時間戳、單位及裝置識別。 |
API / SDK / developer guide
Core Metadata API
| 目標讀者 TA | 裝置登錄團隊 |
|---|---|
| 官方文件能力 | 管理裝置及 profile 中繼資料。 |
| 輸入 → 輸出 | 裝置／profile 定義 → 登錄資訊。 |
| 執行環境 | 相容 EdgeX 4.0 服務、SDK 及設定裝置介面 |
| 本站選型評估 | 登錄本身不證明實體連線。 |
| 本站建議驗證 | 檢查 profile 引用及介面設定。 |
API / SDK / developer guide
Core Keeper API
| 目標讀者 TA | 平台營運者 |
|---|---|
| 官方文件能力 | 使用 Core Keeper 服務介面。 |
| 輸入 → 輸出 | 支援設定／登錄請求 → 服務回應。 |
| 執行環境 | 相容 EdgeX 4.0 服務、SDK 及設定裝置介面 |
| 本站選型評估 | 對應部署服務 API，不沿用舊登錄假設。 |
| 本站建議驗證 | 驗證必要服務設定及後端不可用行為。 |
API / SDK / developer guide
Application Functions Go SDK
| 目標讀者 TA | Go 應用工程師 |
|---|---|
| 官方文件能力 | 建立接收邊緣事件的應用管線。 |
| 輸入 → 輸出 | 邊緣事件 → 轉換／匯出資料。 |
| 執行環境 | 相容 EdgeX 4.0 服務、SDK 及設定裝置介面 |
| 本站選型評估 | 管線成功與外部目的地持久儲存不同。 |
| 本站建議驗證 | 測試篩選、轉換及目的地失敗。 |
API / SDK / developer guide
Application Functions Python SDK
| 目標讀者 TA | Python 邊緣團隊 |
|---|---|
| 官方文件能力 | 使用 Python 建立應用函式。 |
| 輸入 → 輸出 | 訂閱事件 → Python 處理輸出。 |
| 執行環境 | 相容 EdgeX 4.0 服務、SDK 及設定裝置介面 |
| 本站選型評估 | 確認選定 Python SDK 發行版功能可用性。 |
| 本站建議驗證 | 回放相同事件樣本並驗證例外傳遞。 |
API / SDK / developer guide
Device Service Go SDK
| 目標讀者 TA | Go 驅動作者 |
|---|---|
| 官方文件能力 | 為外部協定實作裝置服務。 |
| 輸入 → 輸出 | 協定驅動資料 → EdgeX 事件／讀值。 |
| 執行環境 | 相容 EdgeX 4.0 服務、SDK 及設定裝置介面 |
| 本站選型評估 | 硬體及協定處理仍由驅動負責。 |
| 本站建議驗證 | 檢查重連、型別轉換及關閉行為。 |
API / SDK / developer guide
Device Service C SDK
| 目標讀者 TA | C 裝置整合者 |
|---|---|
| 官方文件能力 | 實作原生裝置服務整合。 |
| 輸入 → 輸出 | 原生協定資料 → 框架讀值。 |
| 執行環境 | 相容 EdgeX 4.0 服務、SDK 及設定裝置介面 |
| 本站選型評估 | 記憶體所有權及建置相依項需目標驗證。 |
| 本站建議驗證 | 測試錯誤封包及斷線清理。 |
API / SDK / developer guide
Device profiles
| 目標讀者 TA | 裝置模型設計者 |
|---|---|
| 官方文件能力 | 描述裝置資源、型別及命令。 |
| 輸入 → 輸出 | Profile 定義 → 解讀後裝置資源。 |
| 執行環境 | 相容 EdgeX 4.0 服務、SDK 及設定裝置介面 |
| 本站選型評估 | 縮放或單位錯誤可能產生看似合理但錯誤讀值。 |
| 本站建議驗證 | 依製造商參考值驗證轉換。 |
API / SDK / developer guide
Store and Forward
| 目標讀者 TA | 韌性工程師 |
|---|---|
| 官方文件能力 | 匯出失敗時保留資料供稍後傳遞。 |
| 輸入 → 輸出 | 匯出失敗 → 儲存重試工作及最終傳遞結果。 |
| 執行環境 | 相容 EdgeX 4.0 服務、SDK 及設定裝置介面 |
| 本站選型評估 | 儲存容量及重試策略限制韌性。 |
| 本站建議驗證 | 測試目的地復原及重複傳遞處理。 |
Versioned documentation
| TA | 平台架構師 |
|---|---|
| 本站驗證建議 | 本指南選定 4.0 文件；對齊服務映像及 SDK 發行版本，勿混用版本。 |
04 / INPUT · EXPECTED OUTPUT · ACCEPTANCE
實作前先看懂預期結果
EdgeX 讀值封裝示意，不是原生 EdgeX DTO JSON。未執行裝置命令、服務部署或遙測匯出。
示意契約 · 未呼叫 API 或執行模型 · 不是供應商實測輸出
讀值正規化
| 輸入 | 已知裝置 profile 及有效感測讀值。 |
|---|---|
| 預期結果 | ok 與資源、數值及宣告單位。 |
| 驗收條件 | 與裝置樣本比對轉換及時間戳。 |
查詢視窗為空
| 輸入 | 有效時間範圍查詢無讀值。 |
|---|---|
| 預期結果 | ok 且 readings: []。 |
| 驗收條件 | 不可將空歷史視為實體量測零值。 |
目的地不可用
| 輸入 | 匯出失敗但設定的暫存轉送可用。 |
|---|---|
| 預期結果 | pending／stored；外部持久儲存尚未確認。 |
| 驗收條件 | 驗證保留、重試上限及復原後重複行為。 |
Profile 不符合
| 輸入 | 輸入讀值無法對應宣告資源型別。 |
|---|---|
| 預期結果 | error；不捏造正規化值。 |
| 驗收條件 | 回報 profile／資源資訊，拒絕不可靠轉換。 |
將預期結果對應至你的應用
整合後將實際 SDK 或服務回應對應至此建議內部契約。下列識別碼與數值均為示意；不含憑證或真實請求。
預期輸出 JSON — 示意，非實測 · EdgeXFoundry-expected-results.json
{
"schema_version": "1.0.0",
"example": true,
"provider": "EdgeX Foundry",
"status": "ok",
"input_id": "sample-001",
"data": {
"device": "example-sensor",
"resource": "Temperature",
"readings": [
{
"value": 24,
"unit": "C",
"observed_at": null
}
],
"export_confirmed": false
},
"error": null,
"verification": "illustrative-only;not-provider-response"
}| 結果解讀 | 傳輸或執行成功不代表模型準確。有效空結果須與操作失敗分開。 |
|---|---|
| 可重現性 | 記錄模型、環境、設定與輸入識別；代表性測試前約定品質及延遲條件。不宣稱已實測效能。 |
| 操作範圍 | EdgeX 讀值封裝示意，不是原生 EdgeX DTO JSON。未執行裝置命令、服務部署或遙測匯出。 |
開發評估
工廠邊緣資料橋接器
開發構想規格・串接尚未實測
接口能力依據官方文件或程式庫；以下產品方向、輸入、交付與驗收條件則是我們的開發評估。
需整合驗證
估算可交付產品前，需共同驗證執行環境、資料結構或硬體。
- 原型輸入規劃
- 測試設備或模擬器、訊號對照表與明確單位。
- 原型交付規劃
- 附時間、資料新鮮度、單位與連線狀態的設備數值。
- 驗收條件
- 對照來源驗證比例與時間；設備斷線時不得顯示正常。
- 依賴條件
- 閘道或服務帳號、設備資料結構與測試環境。
串接前置條件
技術引用固定為 EdgeX 4.0 文件，不宣稱 4.0 為最新版。儲存庫 main 為開發程式；須選相容的已發行服務及 SDK。
開發順序
- 確認 EdgeX Foundry 的存取、授權與支援版本。
- 準備上述樣本，針對「工廠邊緣資料橋接器」先實作一個有官方文件的操作。
- 整理輸出時保留來源、時間與錯誤狀態，並保留供應商回應供審核。
- 通過驗收條件後，再估算擴展投入與客戶交付。
如何驗證需求
記錄產品瀏覽、官方文件點擊、規格下載與技術 Hub 點擊。這些是事件次數，不等於獨立人數或已完成串接。
本次可行性評估依實作條件判斷；尚未給定流量排名或交期承諾。