설비 연동 안내

1. 무엇을 고르나

원격 수집기는 설계 파트너 회사부터 순서대로 엽니다. 열리지 않은 회사에는 계정 메뉴에 「원격 수집기」가 보이지 않습니다. AASX 가져오기는 모든 회사의 owner · admin 이 사용합니다.

2. AASX 끌어 놓기

1. 「설비마스터」(또는 「설비대장 관리」) 화면에 끌어 놓거나, 계정 메뉴 → 「AAS 설비 가져오기」를 엽니다(owner · admin). 화면에 놓으면 같은 창이 그 파일로 열립니다.
2. AAS Studio 의 「연동 → 내보내기 → 전체 묶음 내려받기」로 받은 zip 하나, 또는 AASX 파일 여러 개를 끌어 놓습니다(합계 20MB 까지).
3. 「미리 보기 — 아직 아무것도 바뀌지 않았습니다」에서 기종 · 설비 · 공장 · 라인 · 계층 마디 · 설비 상세 수와 건너뛴 것 · 만들지 않은 것을 확인하고 「가져오기」를 누릅니다.

• 기종(Type) 파일은 기종이 되고, 설비(Instance) 파일은 설비가 됩니다. 같은 기종의 여러 대는 그 기종에 연결된 채로 남습니다.
• 같은 파일을 다시 놓으면 「지금 가져온 것과 같습니다 — 바뀌는 것이 없습니다」로 끝납니다. 고친 파일을 놓으면 바뀐 것만 「변경 제안」 탭에 남고, 사람이 적용하거나 거절합니다. 저절로 지우거나 덮어쓰지 않습니다.
• 묶음에 없는 필수 칸은 기본값으로 채우고 「확인 필요」로 보여 줍니다.
• 받는 파일은 AAS 메타모델 3.0 · 3.1 · 3.2 AASX(JSON · XML)이고, 파일이 밝힌 메타모델 버전대로 읽습니다(KOSMO 가 요구하는 3.1 포함). AASX 를 만들고 검사하는 도구는 오픈소스 AAS Studio(waceinc.github.io/vexplor-aas)입니다.

3. 원격 수집기 연결

1. 계정 메뉴 「원격 수집기」 → 「수집기」 탭 아래 「수집기 연결」에서 수집기 이름(설치 위치)과 서버 주소를 확인하고 「연결 명령 만들기」를 누릅니다. 등록 코드는 24시간 안에 한 번만 쓸 수 있습니다.
2. 나온 한 줄을 공장 PC 에 붙여 넣습니다 — Linux(x64 · arm64)는 터미널, Windows(x64)는 「관리자 권한으로 실행」한 명령 프롬프트나 PowerShell. 내려받기 · SHA256 대조 · 설치 · 등록 · 시작이 한 번에 끝납니다. Windows 패키지는 VEXPLOR Edge 1.2.0 버전부터 있고, 두 탭의 명령은 같은 등록 코드를 씁니다.
3. 수집기가 등록되면 같은 화면에 「연결되었습니다」가 저절로 뜹니다(3초마다 확인).
4. 「읽을 목록」 탭에서 목록을 만들고 승인합니다. 승인 전에는 값이 한 개도 오지 않습니다. 승인을 기다리는 수집기는 10초마다 목록을 다시 묻기 때문에 승인하면 수 초 안에 읽기 시작합니다.

curl -fsSL https://github.com/waceinc/vexplor-edge/releases/latest/download/get.sh | sudo sh -s -- --server https://<이 서버 주소> --code <등록 코드>

powershell -NoProfile -Command "[Net.ServicePointManager]::SecurityProtocol=[Net.ServicePointManager]::SecurityProtocol -bor 3072; & ([scriptblock]::Create((irm https://github.com/waceinc/vexplor-edge/releases/latest/download/get.ps1))) -Server https://<이 서버 주소> -Code <등록 코드>"

• 목록을 만드는 길은 둘입니다 — 「새 초안 만들기」(설비 대장의 설비를 고르고 접속 주소 · 태그를 적기) · 「AASX 에서 초안 만들기」(AASX 가져오기로 가져온 설비면 같은 AASX 의 AID 로 태그를 채움). 어느 쪽이든 사람이 승인해야 수집기에 나갑니다.
• 「수집기 연결」에서 같은 AASX 로 목록을 미리 보고 그 목록을 승인해 둘 수도 있습니다(미리 승인 — 선택). 그 명령으로 등록한 수집기는 바로 읽습니다. 「두 사람 승인」을 켠 회사는 쓸 수 없고, 그사이 목록이 바뀌면 승인하지 않고 승인 대기로 둡니다.
• 태그 역할 — 값 · 가동 상태 · 생산 수량 · 알람. 알람 태그는 같은 설비의 「알람 마스터」 기준과 연결합니다.
• 통신 방식 — OPC UA · Modbus · MQTT · HTTP, 그리고 Siemens S7 · 미쓰비시 MC(VEXPLOR Edge 1.2.0 버전 이상) · LS ELECTRIC XGT(1.3.0 버전 이상), 셋 다 읽기만. 공개 형식 · 설명서대로 만든 모의 서버로 시험했고 실제 PLC 실측은 아직 없습니다(XGT 는 여러 워드 값의 워드 순서를 실제 PLC 에서 먼저 확인).
• 읽는 주기는 최소 10초입니다(회사 설정값). 클라우드는 1초 원본을 받지 않습니다.
• 요금제마다 연결할 수 있는 수집기 대수에 상한이 있습니다. 상한에 이르면 새 등록만 막고 이미 등록된 수집기는 계속 수집합니다.
• 수집기 설치 · 설정 전 항목은 VEXPLOR Edge 설치 안내(github.com/waceinc/vexplor-edge — docs/설치.md)에 있습니다.

4. 보안과 연결 방향

• 연결은 공장 → 클라우드 한 방향입니다(https 443 밖으로). 클라우드가 공장 안으로 들어가는 연결은 없고, 원격으로 수집기나 설비를 멈추는 명령도 없습니다.
• 수집기는 등록할 때 만든 Ed25519 키로 요청마다 서명합니다. 서버는 서명 · 시각(±5분) · 한 번만 쓰는 값(nonce)을 확인합니다.
• 공장 PC 가 프록시를 거쳐 나가면 「프록시를 거쳐야 하나요?」에 프록시 주소를 적습니다. 수집기는 https 주소로만 서버에 붙습니다.
• 서버에 닿지 못하는 동안 수집기는 값을 PC 에 쌓아 두었다가 다시 보냅니다(기본 최대 30일). 같은 묶음을 다시 보내도 한 번만 저장합니다.
• 「수집 멈춤」은 빈 목록을 승인한 것으로 남고, 「폐기」한 수집기의 요청은 서버가 거절합니다. 둘 다 수집기에 명령을 보내는 것이 아닙니다.

5. 들어온 값은 어디에 보이나

• 알람 — 알람 태그는 발생 · 해제 지연과 불감대를 거쳐 「알람 이벤트 로그」와 현장 「알람 현황판」에 남습니다.
• 가동 상태 — 가동 상태 태그는 설비의 가동 구간으로 기록됩니다. 값이 끊긴 동안은 정지가 아니라 「통신 끊김(미확인)」 구간으로 남습니다.
• 수집기 상태 — 「원격 수집기」 창에서 마지막 수신 시각 · 설비 연결 수 · 보낼 대기 · 수집기 버전과 최근 묶음 · 「값이 오지 않아 상태를 모르는 구간」 수를 봅니다.

준비 중: 생산 수량 → 작업지시 실적 · 비가동 · OEE · 예방보전 화면과 값 추이 조회. 준비되면 이 안내에 화면 설명을 더합니다.

6. 보관과 계량

7. 문제가 생기면

8. AAS Studio 와 함께 쓰기

• AASX 를 만들고 검사하는 일은 VEXPLOR AAS Studio(오픈소스), 설비 대장 · 업무 화면 · 원격 수집 값은 Logic Studio 에서 합니다.
• AAS Studio 에서 위반 0건이 된 AASX 를 내려받아 「설비마스터」 화면에 끌어 놓거나 계정 메뉴 → 「AAS 설비 가져오기」에 놓으면 설비 대장이 됩니다. AID(수집 연결)가 있는 파일이면 「AASX 에서 초안 만들기」로 읽을 목록의 태그를 채웁니다.
• AAS Studio 2.5.0 이후 AASX 에 담긴 태그 힌트로 「AASX 에서 초안 만들기」가 역할(가동 상태 · 생산 수량 · 알람 등)과 규격 상한을 미리 채웁니다. 사람이 확인하고 고쳐 승인합니다.