API / SDK / developer guide
CMake build and feature configuration
| 目標讀者 TA | 嵌入式 C 開發者 |
|---|---|
| 官方文件能力 | 建置動態／靜態函式庫並選擇 SDK 功能。 |
| 輸入 → 輸出 | 原始碼與 CMake 選項 → 函式庫及標頭。 |
| 執行環境 | 目標工具鏈的 C 編譯器與 CMake。 |
| 本站選型評估 | 安全與選配服務取決於建置選項。 |
| 本站建議驗證 | 記錄編譯器、版本及啟用的加密後端。 |
工業 IoT／SCADA · SDK / protocol
open62541
open62541 Project
利用 C 函式庫實作 OPC UA 客戶端與伺服器整合。
參考涵蓋 1.5 文件系列及明確連結的 1.5.0／1.5.2 頁面。實作須固定單一版本與建置選項；範例伺服器認證不會自動延伸至應用程式。
OPEN62541 / DEVELOPER FIELD GUIDE
選對接口，定義可驗證的結果。
公司／專案背景、十個技術入口，以及每份引用的實作分析。
2026-10-08 · 串接尚未實測
公司／專案背景全貌
依官方公司或專案自述撰寫的原創概要；完整原文請見來源。
| 專案 | open62541 是 OPC UA 的開源 C 實作，以可設定的平台外掛支援工業用戶端／伺服器連線。 |
|---|---|
| 維護與適用性 | 專案指出目前由 o6 Automation 維護。適合自行建置 OPC UA 應用並管理原生程式碼、資訊模型及安全設定的團隊。 |
| 適用角色 | 進行 AI 供應商初選的採購、合作夥伴與產品負責人。 |
|---|---|
| 本站評估 | 用定位與公司背景判斷初步適配度；另行取得專案部署、支援與商務條件。 |
已核對官方來源；未執行真實 API、推論或效能測試。預期結果為建議內部契約。
十項技術入口比較
依開發任務選出的十個有文件技術入口；不是十套獨立 SDK 或官方排名。
| 接口 | 用途與 TA |
|---|---|
| 01 · CMake build and feature configurationAPI / SDK / developer guide | 建置動態／靜態函式庫並選擇 SDK 功能。嵌入式 C 開發者 |
| 02 · Server lifecycle C APIAPI / SDK / developer guide | 建立、循環執行及關閉 OPC UA 伺服器。閘道實作者 |
| 03 · Typed server variablesAPI / SDK / developer guide | 新增變數並更新具型別的數值。設備資料模型工程師 |
| 04 · Information model guideAPI / SDK / developer guide | 建立節點、參照、變數型別與物件型別。工業整合架構師 |
| 05 · AccessControl pluginAPI / SDK / developer guide | 整合工作階段驗證與授權回呼。伺服器安全整合者 |
| 06 · Logging plugin APIAPI / SDK / developer guide | 將 SDK 日誌接入應用程式日誌。維運與 SDK 維護者 |
| 07 · ECC security configurationAPI / SDK / developer guide | 核對橢圓曲線安全後端需求。安全連線工程師 |
| 08 · Client services and subscriptionsAPI / SDK / developer guide | 使用遠端服務並接收監控項目通知。遙測用戶端開發者 |
| 09 · PubSub publishing tutorialAPI / SDK / developer guide | 設定發布欄位與 PubSub 發布端。工業訊息開發者 |
| 10 · PubSub subscriber tutorialAPI / SDK / developer guide | 將發布欄位接收至目標變數。邊緣資料使用者 |
逐份文件分析
能力摘要依據官方文件；限制與建議測試為本站工程評估。
API / SDK / developer guide
Server lifecycle C API
| 目標讀者 TA | 閘道實作者 |
|---|---|
| 官方文件能力 | 建立、循環執行及關閉 OPC UA 伺服器。 |
| 輸入 → 輸出 | 伺服器設定 → 生命週期狀態與網路服務。 |
| 執行環境 | 應用程式管理的 C 程序。 |
| 本站選型評估 | 伺服器執行期間不得變更設定。 |
| 本站建議驗證 | 檢查啟動回傳狀態並於關閉時釋放資源。 |
API / SDK / developer guide
Typed server variables
| 目標讀者 TA | 設備資料模型工程師 |
|---|---|
| 官方文件能力 | 新增變數並更新具型別的數值。 |
| 輸入 → 輸出 | NodeId、屬性與值 → 變數節點／狀態。 |
| 執行環境 | C 伺服器位址空間。 |
| 本站選型評估 | 須明確設定可寫權限；型別須相符。 |
| 本站建議驗證 | 後續整合驗證型別不符及唯讀失敗。 |
API / SDK / developer guide
Information model guide
| 目標讀者 TA | 工業整合架構師 |
|---|---|
| 官方文件能力 | 建立節點、參照、變數型別與物件型別。 |
| 輸入 → 輸出 | 資產語意 → 可瀏覽的具型別圖譜。 |
| 執行環境 | 用戶端／伺服器資訊模型設計。 |
| 本站選型評估 | 單一數值缺少 NodeId、型別及語意脈絡。 |
| 本站建議驗證 | 核對單位、命名空間識別及參照關係。 |
API / SDK / developer guide
AccessControl plugin
| 目標讀者 TA | 伺服器安全整合者 |
|---|---|
| 官方文件能力 | 整合工作階段驗證與授權回呼。 |
| 輸入 → 輸出 | 工作階段／使用者脈絡與要求操作 → 存取決策。 |
| 執行環境 | 伺服器外掛設定。 |
| 本站選型評估 | 應用政策須對應實際使用者與節點權限。 |
| 本站建議驗證 | 驗證拒絕的使用者無法讀寫受保護節點。 |
API / SDK / developer guide
Logging plugin API
| 目標讀者 TA | 維運與 SDK 維護者 |
|---|---|
| 官方文件能力 | 將 SDK 日誌接入應用程式日誌。 |
| 輸入 → 輸出 | SDK 日誌類別／層級／訊息 → 日誌目的端。 |
| 執行環境 | C 日誌外掛。 |
| 本站選型評估 | 編譯期日誌選擇限制執行期可顯示的內容。 |
| 本站建議驗證 | 使用關聯脈絡且避免記錄憑證。 |
API / SDK / developer guide
ECC security configuration
| 目標讀者 TA | 安全連線工程師 |
|---|---|
| 官方文件能力 | 核對橢圓曲線安全後端需求。 |
| 輸入 → 輸出 | 後端、政策與憑證設定 → 安全通道可用性。 |
| 執行環境 | 啟用加密的建置。 |
| 本站選型評估 | 支援曲線隨加密後端及版本而異。 |
| 本站建議驗證 | 連接設備前驗證對端信任及政策相容性。 |
API / SDK / developer guide
Client services and subscriptions
| 目標讀者 TA | 遙測用戶端開發者 |
|---|---|
| 官方文件能力 | 使用遠端服務並接收監控項目通知。 |
| 輸入 → 輸出 | 端點、服務要求或監控項目 → 結果／回呼。 |
| 執行環境 | C 用戶端；服務處理包含用戶端迭代。 |
| 本站選型評估 | 訂閱傳送通知；監控項目產生通知。 |
| 本站建議驗證 | 分別追蹤服務狀態與訂閱存活性。 |
API / SDK / developer guide
PubSub publishing tutorial
| 目標讀者 TA | 工業訊息開發者 |
|---|---|
| 官方文件能力 | 設定發布欄位與 PubSub 發布端。 |
| 輸入 → 輸出 | 設定的資料欄位 → 發布資料集訊息。 |
| 執行環境 | 啟用 PubSub 的 C 建置。 |
| 本站選型評估 | 教學為開發起點；傳輸與版本須相符。 |
| 本站建議驗證 | 檢查欄位順序、型別及訂閱端解讀。 |
API / SDK / developer guide
PubSub subscriber tutorial
| 目標讀者 TA | 邊緣資料使用者 |
|---|---|
| 官方文件能力 | 將發布欄位接收至目標變數。 |
| 輸入 → 輸出 | PubSub 訊息與讀取設定 → 目標變數更新。 |
| 執行環境 | 依文件傳輸設定執行的 C 訂閱範例。 |
| 本站選型評估 | 收到封包不代表所有目標欄位語意正確。 |
| 本站建議驗證 | 驗證發布端識別、欄位對應及缺少訊息的處理。 |
Official source repository
| TA | 評估原始碼與維護的開發者 |
|---|---|
| 本站驗證建議 | 核對版本標籤、範例及建置選項；範例伺服器認證不代表您的應用程式獲認證。 |
04 / INPUT · EXPECTED OUTPUT · ACCEPTANCE
實作前先看懂預期結果
僅為 OPC UA 轉接內部契約示意；未執行伺服器、用戶端、設備寫入或網路連線。
示意契約 · 未呼叫 API 或執行模型 · 不是供應商實測輸出
讀取具型別值
| 輸入 | 示意 NodeId 對應 Double 變數。 |
|---|---|
| 預期結果 | 內部結果保存 value=24.0、type=Double 與 status=Good。 |
| 驗收條件 | 保留 NodeId 及可取得的實際時間戳；不捏造新鮮度。 |
有效空瀏覽
| 輸入 | 瀏覽可存取但沒有符合參照的節點。 |
|---|---|
| 預期結果 | 內部 status=empty 且 references=[]。 |
| 驗收條件 | 僅服務及操作狀態成功時分類為空。 |
型別寫入遭拒
| 輸入 | 向 Int32 變數提議寫入字串。 |
|---|---|
| 預期結果 | 內部 status=error 並保留供應端狀態。 |
| 驗收條件 | 不得靜默轉型或宣稱設備已變更。 |
不受信任端點
| 輸入 | 對端憑證未通過設定的信任政策。 |
|---|---|
| 預期結果 | 內部連線失敗；data=null。 |
| 驗收條件 | 區分憑證失敗與空位址空間。 |
將預期結果對應至你的應用
整合後將實際 SDK 或服務回應對應至此建議內部契約。下列識別碼與數值均為示意；不含憑證或真實請求。
預期輸出 JSON — 示意，非實測 · Open62541-expected-results.json
{
"schema_version": "1.0.0",
"example": true,
"provider": "open62541",
"status": "ok",
"input_id": "sample-001",
"data": {
"node_id": "ns=2;s=Example.Temperature",
"value": 24.0,
"type": "Double",
"status_code": "Good",
"source_timestamp": null
},
"error": null,
"verification": "illustrative-only;not-provider-response"
}| 結果解讀 | 傳輸或執行成功不代表模型準確。有效空結果須與操作失敗分開。 |
|---|---|
| 可重現性 | 記錄模型、環境、設定與輸入識別；代表性測試前約定品質及延遲條件。不宣稱已實測效能。 |
| 操作範圍 | 僅為 OPC UA 轉接內部契約示意；未執行伺服器、用戶端、設備寫入或網路連線。 |
開發評估
OPC UA 訊號讀取器
開發構想規格・串接尚未實測
接口能力依據官方文件或程式庫；以下產品方向、輸入、交付與驗收條件則是我們的開發評估。
需整合驗證
估算可交付產品前，需共同驗證執行環境、資料結構或硬體。
- 原型輸入規劃
- 測試設備或模擬器、訊號對照表與明確單位。
- 原型交付規劃
- 附時間、資料新鮮度、單位與連線狀態的設備數值。
- 驗收條件
- 對照來源驗證比例與時間；設備斷線時不得顯示正常。
- 依賴條件
- 閘道或服務帳號、設備資料結構與測試環境。
串接前置條件
參考涵蓋 1.5 文件系列及明確連結的 1.5.0／1.5.2 頁面。實作須固定單一版本與建置選項；範例伺服器認證不會自動延伸至應用程式。
開發順序
- 確認 open62541 的存取、授權與支援版本。
- 準備上述樣本，針對「OPC UA 訊號讀取器」先實作一個有官方文件的操作。
- 整理輸出時保留來源、時間與錯誤狀態，並保留供應商回應供審核。
- 通過驗收條件後，再估算擴展投入與客戶交付。
如何驗證需求
記錄產品瀏覽、官方文件點擊、規格下載與技術 Hub 點擊。這些是事件次數，不等於獨立人數或已完成串接。
本次可行性評估依實作條件判斷；尚未給定流量排名或交期承諾。