장치 협업 및 공유 대상

장치 공유는 다른 Edge-EMS Builder 노드의 데이터를 로컬 계산과 전략에 활용하는 기능입니다. 현재 공유 대상은 “로컬 장치 → 대상 장치 하나”의 방향 모델을 사용하며, 조합하여 데이터 집결, 양방향 또는 다단계 협업을 구성할 수 있습니다.

세 가지 설정 객체

객체	역할
장치 정보	고유 장치 코드로 노드를 식별하고 네트워크 주소 및 로컬 장치 여부 기록
공유 설정	로컬 데이터 포인트와 공유 주기 선택
공유 대상	수신 장치 하나를 지정하고 하나 이상의 공유 설정 바인딩

공유 대상은 로컬 장치에서 생성하므로 종속 장치 목록을 입력할 필요가 없습니다. 여러 장치로 전송할 때는 대상을 여러 개 생성하고, 여러 노드가 같은 집결 노드로 전송할 때는 각 노드에 해당 대상을 설정합니다.

설정 순서

참여 장치의 장치 정보를 관리하고 로컬 장치 표시와 고유 장치 코드를 확인합니다.
송신 측에서 공유 설정을 생성하고 데이터 포인트와 CRON 주기를 지정합니다.
수신 측을 가리키는 공유 대상을 생성하고 전송할 설정을 바인딩합니다.
수신 측에서 공유 데이터 포인트, 원본 장치 및 최신 값을 확인합니다.

양방향 공유가 필요하면 양쪽을 각각 설정합니다. 다단계 집결에서는 수신한 데이터로 로컬 집계 지표를 계산한 후 상위 단계에 공유할 수 있습니다.

상세 절차는 장치 협업 설정, 필드 설명은 공유 대상 참조를 참조하세요.

데이터 식별 및 계산

공유 데이터에는 이름, 별칭 및 단위가 포함됩니다. 같은 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을 사용할 수 있습니다.