裝置協作與共享目標

裝置共享讓其他 Edge-EMS Builder 節點的資料參與本機計算和策略。目前共享目標採用“本機 → 一個目標裝置”的方向模型，可以組合成匯聚、雙向或多級協作。

三個設定物件

物件	作用
裝置資訊	用唯一裝置編碼識別節點，記錄網路位址和是否本機
共享設定	選擇本機點位和共享週期
共享目標	指定一個接收裝置，並繫結一份或多份共享設定

共享目標由本機發起，不需要填寫從裝置清單。向多個裝置傳送時建立多個目標；多個節點向同一匯聚節點傳送時，各自設定對應目標。

設定順序

1. 在參與裝置上維護裝置資訊，確認本機標記與唯一裝置編碼。
2. 在傳送端建立共享設定，選擇點位並設定 CRON 週期。
3. 建立指向接收端的共享目標，繫結需要傳送的設定。
4. 在接收端檢查共享點位、來源裝置和最新值。

需要雙向共享時，兩端分別設定。多級匯聚可將收到的資料計算成本機聚合指標，再共享給上一級。

詳細操作見 裝置協作設定，欄位說明見 共享目標參考。

資料身分與計算

共享資料會攜帶名稱、別名和單位。相同 dataKey 可以來自不同裝置，因此查詢時應同時指定裝置編碼，不手工拼接快取鍵。

-- demo_edge 和 demo_power 均需替換為實際編碼
local localPower = tonumber(${demo_power})
local remotePower = tonumber(${[demo_edge]demo_power})
if not localPower or not remotePower then return "__Null__" end
return localPower + remotePower

歷史查詢、分組映射及控制記錄也應保留同一來源身分。

遠端控制

觸發動作可以透過裝置編碼向遠端可寫點位下發指令。目標資料型別填寫遠端實際型別，例如擷取點位為 Collection：

return {buildSlaveWriteMap("demo_edge", "Collection", "demo_setpoint", 10, nil, nil, false)}

請求已傳送不代表裝置已執行。應核對權限、裝置應答、執行端記錄與點位回讀，詳見 裝置控制記錄。

狀態與網路恢復

裝置狀態可參與策略判斷；使用遠端值時應同時檢查通訊狀態和資料時效。裝置共享依賴節點之間網路可達，裝置編碼用於識別，IP 用於連線。

在支援的 Linux 網路環境下，本機外網不可用時可借用線上裝置網路；直連恢復後切回本機網路，包括同網絡卡共享場景。該能力依賴現場路由與權限，應在實際裝置上驗證。

更換接收節點時更新共享目標的目標裝置編碼；只是位址變化時更新該裝置資訊，並檢查連線及繫結。批次同類裝置可以用 UDE 產生設定，也可使用 裝置共享 Skill。