VDA5050 노드 도착 판정과 주행 흐름: nodeStates·edgeStates가 바뀌는 순서
이 글의 핵심
표준은 노드를 언제 통과한 것으로 칠지를 차량이 스스로 정한다고 하고, 보통 제어점이 allowedDeviationXY 안에 있고 방향이 allowedDeviationTheta 안에 있을 때라고 합니다. 통과를 보고하는 순간 nodeStates에서 그 노드가 빠지고 lastNodeId가 바뀌며, 노드의 액션이 시작되고, 앞 엣지가 edgeStates에서 빠집니다. 시뮬레이터에서는 이 순서와 HARD 액션 동안 driving이 false가 되는 것, 엣지 maxSpeed가 상한으로만 작동하는 것을 확인했습니다.
order를 보내면 차량이 움직이고 state가 바뀝니다. 관제 입장에서 중요한 질문은 “차량이 지금 어디까지 왔다고 보고하는가”와 “그 보고를 믿고 다음 order를 보내도 되는가”입니다. 이 글은 VDA5050 2.0.0 문서(공식 저장소 2.0.0 태그의 VDA5050_EN_V1.md, 머리말에 “RELEASE CANDIDATE, FOR REVIEW”로 표기)의 6.10.2절과 6.7절의 nodePosition, 6.12절의 blocking type을 기준으로 노드 통과 판정과 state가 바뀌는 순서를 정리합니다. 차량 쪽은 libVDA5050++ v2.11.3 위에 만든 시뮬레이터(Ubuntu 24.04 aarch64 컨테이너, 브로커는 eclipse-mosquitto:2)에서 직접 order를 보내 측정했습니다. 상태 메시지는 약 1초 간격으로 나가므로 시각 측정은 0.2초 간격으로 폴링한 값이며 오차가 0.5초 안팎입니다.
표준이 정하는 것
6.10.2절의 핵심 문장은 다음과 같습니다.
- 노드를 통과한 것으로 볼 시점은 AGV가 스스로 정한다.
- 일반적으로 AGV의 제어점이 노드의 허용 반경(
allowedDeviationXY) 안에 있고 방향이 허용 각도(allowedDeviationTheta) 안에 있을 때다. - 통과를 보고하는 방법은
nodeStates에서 그 노드를 지우고lastNodeId,lastNodeSequenceId를 통과한 노드 값으로 바꾸는 것이다. - 통과를 보고하는 즉시 그 노드의 액션을 시작해야 한다.
- 노드를 통과하면 그 노드로 오던 엣지를 떠난 것이므로, 엣지를
edgeStates에서 지우고 엣지에서 활성이던 액션을 끝내야 한다. - 같은 순간이 다음 엣지로 들어가는 순간이다. 다음 엣지의 액션을 이때 시작한다. 단, 블로킹 액션 때문에 엣지에서 멈춰야 하면 다시 움직이기 시작한 뒤에 진입한 것으로 본다.
허용 오차 필드는 6.7절 nodePosition 표에 있습니다. allowedDeviationXY가 0이면 “허용 오차 없음”이 아니라 제조사의 일반 공차 안이어야 한다는 뜻이고, 0보다 크면 그 반경(미터) 안을 지나가면 통과로 봅니다. allowedDeviationTheta는 0에서 π 사이이고 theta - 값부터 theta + 값까지가 허용 범위입니다. theta가 정의돼 있으면 차량은 그 노드에서 그 각도를 취해야 하며, 앞 엣지가 회전을 금지하면 노드에서 돌아야 합니다.
핵심은 “표준이 도착 조건을 강제하지 않는다”는 점입니다. 허용 반경은 order가 차량에게 주는 힌트이고, 실제 판정과 보고 시점은 차량이 정합니다. 같은 order라도 차량에 따라 노드 앞에서 감속하며 일찍 보고하거나 정확히 정지한 뒤 보고할 수 있습니다.
시뮬레이터에서 본 통과 순서
시뮬레이터에서 n0(0,0) → n1(3,0, HARD pick) → n2(3,2, HARD drop)로 가는 order를 보내고 state를 0.2초마다 읽어 변화가 있을 때만 기록했습니다.
| 시각 | lastNodeId | driving | 위치 | nodeStates | edgeStates | 액션 |
|---|---|---|---|---|---|---|
| 0.2초 | n0 | true | (0.05, 0) | n1, n2 | e01, e12 | pick WAITING, drop WAITING |
| 2.1초 | n0 | true | (2.06, 0) | n1, n2 | e01, e12 | WAITING 유지 |
| 3.1초 | n1 | false | (3.0, 0) | n2 | e12 | pick RUNNING |
| 5.1초 | n1 | false | (3.0, 0) | n2 | e12 | pick FINISHED |
| 5.4초 | n1 | true | (3.0, 0.15) | n2 | e12 | 이동 재개 |
| 7.2초 | n2 | false | (3.0, 2.0) | 비어 있음 | 비어 있음 | drop RUNNING |
| 9.2초 | n2 | false | (3.0, 2.0) | 비어 있음 | 비어 있음 | drop FINISHED |
표준과 비교하면 다음과 같습니다.
- n1에 도착한 3.1초 상태에서
nodeStates에서 n1이 빠지고lastNodeId가 n1이 되었으며, 같은 상태에서 pick이 RUNNING이 되었습니다. 앞 엣지 e01도edgeStates에서 빠졌습니다. 도착 보고와 액션 시작이 한 state 안에서 일어났다는 점이 표준 문장과 일치합니다. - pick이 HARD라서 실행 동안
driving이 false였고, 액션이 FINISHED가 된 직후(약 0.3초 뒤)에 다음 엣지 e12 방향으로 움직이기 시작했습니다. 표준의 “블로킹 액션 때문에 멈춘 엣지는 다시 움직일 때 진입한 것으로 본다”는 문장에 해당하는 부분이지만, 이 시뮬레이터는 e12를edgeStates에 계속 남겨 두었고 진입 시점을 구분해서 보여 주지 않았습니다. 엣지 진입은 state에서 직접 관찰하지 못했습니다. - 마지막 노드(n2)에 도착한 순간
nodeStates와edgeStates가 모두 비었습니다. 이 순간부터 drop이 끝나는 9.2초까지는 order가 끝난 것이 아니라 마지막 노드의 액션이 진행 중이었다는 점이 중요합니다.nodeStates가 비었다는 사실만으로 order를 완료로 판단하면 안 되고actionStates가 모두 FINISHED 또는 FAILED인지도 봐야 합니다. 완료 판정은 state 메시지 해설에서도 다룹니다.
중간 노드에 블로킹 액션이 없으면 차량이 멈추지 않는지도 확인했습니다. n1에 pick을 붙이되 그 위치에 pick 대상이 없어 액션이 곧바로 FAILED가 되는 상황에서는 driving이 true인 채로 n1을 지나 n2까지 갔습니다(차량이 멈추지 않았다는 확인이지, 실패한 pick을 정상으로 본다는 뜻이 아닙니다). 블로킹 액션이 있을 때만 노드에서 멈추는 것은 6.12절의 blocking type 표(NONE은 주행 중에도 실행 가능, SOFT와 HARD는 차량이 움직이면 안 됨)와 일치합니다.
도착 시각과 속도
경로 길이와 속도로 도착 시각을 예측할 수 있는지 재 보았습니다. 같은 시뮬레이터에서 한 번에 한 엣지씩 order를 보냈습니다. 시뮬레이터의 기본 속도는 1.0 m/s입니다(소스에서 speedMax = 1.0으로 설정).
| 시험 | 거리 | 도착까지 |
|---|---|---|
| 기본 | 3m | 3.3초 |
엣지 maxSpeed: 0.5 | 3m | 6.4초 |
엣지 maxSpeed: 2.0 | 3m | 3.4초 |
표준 6.7절의 maxSpeed는 “엣지에서 허용되는 최대 속도”입니다. 0.5를 주면 절반 속도로 갔고, 차량 기본보다 큰 2.0을 주면 기본 속도로 갔습니다. 즉 이 시뮬레이터에서 maxSpeed는 상한으로만 작동했습니다. 관제가 maxSpeed로 차량을 더 빠르게 만들 수는 없습니다. 모든 차량이 이렇게 동작한다는 근거는 없습니다. 표준에 maxSpeed가 필수 필드가 아니라 선택 필드로 정의된 이상, 지원하지 않는 차량은 값을 무시할 수 있으므로 factsheet의 agvProtocolFeatures와 함께 확인해야 합니다(factsheet 해설).
이 숫자는 이 시뮬레이터의 단순 이동 모델(직선을 일정 속도로 이동)에서 얻은 것입니다. 실제 차량은 가감속, 장애물 정지, 회전 때문에 길이/속도보다 오래 걸립니다. 관제의 타임아웃은 이런 시뮬레이터 값이 아니라 실제 차량의 측정값에 여유를 둬서 정해야 합니다.
위치가 없는 노드와 층이 다른 노드
6.7절에서 nodePosition은 필수가 아닙니다. 위치가 없는 노드가 order에 있을 때와, 노드의 mapId가 차량의 현재 맵과 다를 때를 시험했습니다.
| 시험 | 결과 |
|---|---|
도착 노드에 nodePosition 없음 | 0.5초 안에 lastNodeId가 바뀜. driving은 true가 된 적 없음. 위치도 그대로 |
도착 노드의 mapId가 다름(floor2, 같은 x·y) | driving true인 채로 약 4초 뒤 도착. 위치의 x·y는 그대로이고 agvPosition.mapId만 floor2로 바뀜 |
위치가 없는 노드는 이 시뮬레이터에서 “이동 없이 도달” 처리됩니다. 표준은 위치 없는 노드를 어떻게 도달 판정하라고 정하지 않으므로, 차량 구현마다 다를 수 있습니다. 위치 없는 노드를 쓸 때는 어댑터가 무엇을 도착 조건으로 삼는지 확인이 필요합니다.
층이 다른 노드는 표준의 설명과 맞습니다. 6.7절은 “엘리베이터를 쓰면 출발 층 맵에서 사라지고 도착 층 맵의 엘리베이터 노드에 나타난다”고 하는데, 시뮬레이터에서도 이동 중에는 driving이 true였고 도착하자 mapId가 새 값으로 바뀌며 같은 좌표에 나타났습니다. 약 4초는 이 시뮬레이터가 층 이동을 흉내 내는 고정 시간으로 보이며(소스에 별도 상수가 있음), 실제 엘리베이터 연동과는 무관합니다. 엘리베이터를 호출하고 문을 여는 절차는 표준 범위 밖이고 시험하지 않았습니다.
관제 구현에서 지킬 점
표준과 위 측정에서 도출한 해석입니다.
- 도착은 보고된 사실로만 판단한다. 좌표가 노드 근처인 것만으로 도착했다고 가정하지 않고,
lastNodeId/lastNodeSequenceId가 바뀌고nodeStates에서 빠진 것을 본다.sequenceId까지 비교해야 같은nodeId가 order에 두 번 나오는 경우를 구분한다. - order 완료는
nodeStates·edgeStates가 비고actionStates가 모두 종료 상태이며driving이 false인지로 판단한다. 마지막 노드 액션이 남은 시간 동안nodeStates는 이미 비어 있다. - 허용 반경을 작게 주면 차량이 정지·감속해야 하므로 느려질 수 있다. 반대로 너무 크게 주면 노드를 비껴 지나도 통과로 보고될 수 있다. 값은 노드에서 일어나는 작업(정밀 정렬이 필요한 픽업인지 단순 경유인지)에 따라 정하고, 실제 차량으로 검증한다.
maxSpeed는 상한이다. 도착 시간 계산에 쓰지 말고 구간별 실제 소요 시간을 state로 측정해 둔다.- 블로킹 액션이 붙은 노드는 거기서 차량이 멈춘다는 전제로 시간표를 짠다.
NONE액션은 주행 중에 실행될 수 있다. - 위치 없는 노드와 층 이동 노드는 구현 의존이다. 처음 쓰는 차량이라면 소규모 order로 먼저 동작을 본다.
한계
표준은 2.0.0 문서(릴리스 후보 표기)를 기준으로 했습니다. 측정은 libVDA5050++ v2.11.3 위의 시뮬레이터 하나에서 했고, 이 시뮬레이터의 이동 모델은 일정 속도 직선 이동이라서 허용 반경 안에서의 도착 판정은 시험할 수 없었습니다(소스에서 도착 시 노드 좌표로 위치를 맞추는 방식입니다). 즉 allowedDeviationXY와 allowedDeviationTheta가 도착 판정에 쓰이는 방식은 확인하지 못했고, 표준 문장만 인용했습니다. 다음도 확인하지 못했습니다.
- 엣지 진입 시점의
edgeStates변화와 엣지 액션 시작(엣지 액션을 쓰지 않았습니다) SOFT블로킹 액션과 여러 액션이 섞인 노드(표준 그림 15의 처리 순서)orientation,trajectory,rotationAllowed가 주행에 미치는 영향- 장애물로 멈췄을 때의
driving과operatingMode - 실제 엘리베이터 연동
측정 시각은 0.2초 폴링과 약 1초의 state 간격 때문에 오차가 있고, 소수 첫째 자리 이하는 의미가 없습니다.