VDA5050 blockingType 실험: NONE·SOFT·HARD가 주행·다른 액션·instantAction과 겹칠 때

이 글의 핵심

libVDA5050++ 2.11.3에서 NONE 액션은 주행·다른 액션과 같이 돌고, SOFT와 HARD 액션은 시작 전에 주행을 멈추게 하며 SOFT끼리는 병렬로, HARD는 혼자 돕니다. 같은 노드의 액션은 목록 순서대로 묶이며 HARD가 끼면 앞 액션이 끝나기를 기다립니다. 주행 중 끼어드는 instantAction은 NONE이 아니면 주행을 일시정지시키고, HARD이거나 진행 중인 액션이 HARD이면 진행 중인 액션을 취소합니다. 실패한 노드 액션은 order를 멈추지 않습니다.

blockingType은 표준 문서에 “이 액션이 도는 동안 다른 일을 해도 되는가”로 정의돼 있지만, 문장만으로는 구현이 어떻게 겹치는지 감이 오지 않습니다. 이 글은 앞 글에서 만든 어댑터에 일정 시간 동안 도는 테스트용 액션 beep을 추가해, NONE·SOFT·HARD를 엣지와 노드와 instantAction에 번갈아 붙이고 그 결과를 시간표로 기록한 것입니다.

환경은 libVDA5050++ v2.11.3, 우분투 24.04 aarch64 컨테이너, 차량은 1 m/s로 n0(0,0)에서 n1(3,0)까지 직선 이동하는 가짜 어댑터입니다. beep은 durationMs 동안 RUNNING으로 있다가 FINISHED가 되며, 선언은 NONE·SOFT·HARD와 node·edge·instant를 모두 허용합니다. 아래 시각은 state를 관찰한 상대 시각(초)이고, 표의 drv는 state의 driving입니다. 결과는 이 라이브러리와 이 어댑터의 동작이지 표준의 필수 동작이 아닙니다.

소스에서 읽은 규칙

스케줄러(core/order/scheduler.cpp)의 규칙을 먼저 정리하면 결과가 읽기 쉽습니다.

  • 다음 액션 그룹을 시작하려 할 때, 이미 활성 액션이 있고 지금 그룹이나 새 그룹이 HARD이면 시작하지 않고 기다립니다. 둘 다 HARD가 아니면 병렬로 돌 수 있습니다.
  • 내비게이션 태스크가 있을 때 블로킹 타입이 NONE이 아닌 액션은 시작하지 않습니다. 즉 SOFT와 HARD는 주행이 끝나거나 멈추기를 기다립니다. “NONE만 주행을 허용한다”는 주석이 코드에 있습니다.
  • instantAction은 interrupt 경로로 들어옵니다. 블로킹 타입이 NONE이 아니면 내비게이션을 일시정지시키고, 새 instantAction이 HARD이거나 진행 중인 액션이 HARD이면 진행 중인 액션에 취소를 보냅니다.
  • 일시정지·취소 중인 스케줄러 상태에서는 interrupt가 상태 오류 예외를 던집니다.

엣지 액션

엣지 n0→n1(3 m, 주행 3초)에 beep 2초를 붙인 결과입니다.

blockingType관찰
NONE주행하면서 동시에 실행. 2.0초에 FINISHED, 3.1초에 도착(주행 시간 그대로)
SOFT출발하지 않고 제자리에서 액션 2초 실행(driving: false), 끝난 뒤 주행. 5.1초에 도착
HARDSOFT와 같음. 5.1초에 도착

엣지 액션이 SOFT나 HARD이면 그만큼 도착이 늦어집니다. 같은 엣지에서 SOFT와 HARD의 차이는 이 실험에서 보이지 않았고, 차이는 다음 노드 액션 묶음에서 나타났습니다.

같은 노드의 여러 액션

n1에 액션 둘을 목록 순서대로 붙였습니다. 도착 시각은 3.1초입니다.

액션 목록관찰총 소요
a NONE 3초, b NONE 3초둘 다 도착 직후 동시에 RUNNING6.1초에 모두 FINISHED
a SOFT 2초, b SOFT 2초동시에 RUNNING5.1초에 모두 FINISHED
a NONE 3초, b HARD 2초a만 RUNNING, b는 WAITING. a가 끝난 6.1초에 b 시작8.1초
a HARD 2초, b NONE 3초a만 RUNNING, a가 끝난 5.1초에 b 시작8.1초

NONE끼리, SOFT끼리는 병렬이고, HARD가 끼면 앞뒤 순서를 지켜 직렬이 됩니다. 노드 액션 목록의 순서가 곧 실행 순서에 영향을 주므로, 관제가 액션 배열을 만들 때 순서를 의도적으로 정해야 합니다. NONE 액션 둘이 같은 장비(그리퍼, 리프트)를 건드리면 병렬 실행이 충돌하므로 장비 자원이 겹치는 액션은 SOFT 이상으로 보내는 편이 안전합니다.

주행 중 instantAction

주행 1초 시점에 beep 2초를 instantAction으로 보냈습니다. order는 n0→n1(주행 3초)이고 액션은 없습니다.

instant blockingType관찰
NONE계속 주행하면서 실행. 3.1초에 FINISHED, 도착은 원래대로 3.1초
SOFT액션 실행 중 차량 정지(위치가 1.0 → 1.1에서 변하지 않음), 3.1초에 FINISHED, 이어서 주행해 5.1초 도착
HARDSOFT와 같음. 5.1초 도착

SOFT·HARD 모두 소스 규칙대로 내비게이션이 일시정지됐다가(위치가 멈춤) 액션이 끝난 뒤 이어서 달렸고, 같은 주행에 2초가 더 걸렸습니다. 주의할 점이 하나 있습니다. 위 SOFT·HARD 관찰에서 정지한 동안에도 state의 driving은 true로 남았습니다. 이 예제 어댑터의 pause()가 setDriving(false)를 부르지 않았기 때문이고, 라이브러리는 주행 여부를 알지 못하므로 driving 값은 어댑터의 책임입니다. pause()와 resume()에서도 driving을 갱신해야 합니다.

instantAction이 order의 액션을 취소하는 경우

가장 조심할 결과입니다. n1에서 beep HARD 4초가 RUNNING일 때(도착 1.1초 뒤) NONE인 beep instantAction 1.5초를 보냈습니다.

시각state
3.1초a(HARD, order) RUNNING, 차량 정지
4.5초a FAILED, i1(instant) RUNNING
6.0초i1 FINISHED

NONE인 instantAction인데도 진행 중이던 HARD 노드 액션이 취소(FAILED)됐습니다. 위 소스 규칙 “진행 중인 액션이 HARD이면 취소” 그대로입니다. 반대로 stateRequest를 같은 시점에 보내자 영향이 없었고 HARD 액션 a는 끝까지 돌아 FINISHED가 됐습니다. stateRequest처럼 라이브러리가 직접 처리하는 제어용 instantAction은 이 경로를 타지 않는다고 볼 수 있습니다.

같은 원리로, order의 HARD 액션이 도는 중에 위치 재설정(initPosition, HARD)을 instantAction으로 보내면 진행 중 액션이 FAILED가 되고 initPosition이 FINISHED가 됐습니다. 실험에서 beep HARD 6초가 RUNNING일 때 initPosition을 보내자 약 1초 만에 beep이 FAILED, initPosition이 FINISHED가 되고 lastNodeId와 mapId가 바뀌었습니다.

상황결과
order의 HARD 액션 진행 중 + NONE beep 또는 HARD initPosition instantAction진행 중 HARD 액션 FAILED (실험)
order의 HARD 액션 진행 중 + stateRequest영향 없음 (실험)
order의 NONE 또는 SOFT 액션 진행 중 + HARD beep instantAction진행 중 액션 FAILED, instantAction 실행 후 FINISHED (실험)
일시정지 중인 order + HARD instantAction즉시 실행되지 않고 대기(아래 참조)

실패한 액션은 order를 멈추지 않는다

위 취소 실험의 뒤를 더 길게 보면, 노드 n2(5,0)와 그 노드의 액션을 추가한 order에서 n1의 HARD 액션 a가 FAILED가 된 뒤에도 차량은 곧바로 n2로 이동했고(4.4초 driving: true), 6.6초에 n2의 액션 c가 RUNNING, 7.6초에 FINISHED가 됐습니다.

취소만의 효과일 수 있어, 진짜 실패도 확인했습니다. 앞 글의 changeMap을 장비 무응답으로 시간 초과시키자 액션이 FAILED(mapChangeTimeout)가 됐고, 차량은 역시 n2로 가서 c를 실행했습니다.

즉 이 라이브러리 버전에서 노드 액션의 실패는 그 액션의 actionStatus와 errors에만 반영되고 order의 진행은 멈추지 않습니다. 맵 전환이나 pick처럼 실패하면 뒤의 동작이 위험해지는 액션이라면 어댑터가 실패 시 직접 cancelOrder와 같은 처리를 해야 하고, 관제도 FAILED가 올라온 시점에 order를 중단할지 결정해야 합니다. 표준 문서가 이 경우에 요구하는 동작은 이 글에서 확인하지 않았습니다.

일시정지 중의 instantAction

order 액션 changeMap이 RUNNING일 때 startPause를 보내 액션을 PAUSED로 만든 뒤 initPosition(HARD)을 instantAction으로 보냈습니다. 일시정지 중에는 actionStates에 initPosition이 나타나지 않았고, stopPause 후에야 WAITING으로 나타났습니다. 소스를 보면 일시정지 상태의 스케줄러에서 interrupt는 상태 오류 예외를 던지는데, 이 예외가 로그에 남았는지는 확인하지 않았습니다. 정리하면 일시정지 중에 보낸 HARD instantAction은 즉시 실행되지 않으므로, 관제는 일시정지된 차량에 위치 재설정이나 충전 같은 HARD instantAction을 보내기 전에 stopPause 또는 cancelOrder를 먼저 보내는 편이 예측하기 쉽습니다. 앞 글에서 “원인을 확인하지 못했다”고 한 initPosition 무시 현상은 이 동작과 맞습니다.

같은 실험에서 하나 더 드러난 것이 있습니다. 앞 글의 changeMap 시간 제한(4초)이 일시정지한 시간까지 포함한 벽시계 기준이어서, 일시정지 중에 시간이 지나자 stopPause 직후 mapChangeTimeout으로 FAILED가 됐습니다. 시간 제한은 일시정지 시간을 빼고 재야 합니다.

정리: 설계 지침

  • 장비 자원(리프트, 그리퍼, 컨베이어)을 쓰는 액션은 HARD로 선언해서 앞뒤 액션과 섞이지 않게 합니다. NONE을 허용하는 선언은 병렬 실행을 감당할 수 있을 때만 엽니다.
  • 노드 액션 배열의 순서는 실행 순서에 영향을 줍니다. HARD가 끼면 앞 액션이 끝나기를 기다립니다.
  • 관제가 order 실행 중에 instantAction을 보낼 때는 진행 중인 액션이 HARD인지 먼저 봅니다. 위치 재설정, 충전 시작처럼 HARD를 쓰는 instantAction은 진행 중 order 액션을 취소합니다. 취소된 액션은 FAILED이므로 필요하면 다시 보내야 합니다.
  • pause()와 resume()에서 driving 값을 갱신하는 일은 어댑터 책임입니다.
  • 액션 시간 제한은 일시정지 시간을 제외하고 잽니다.
  • 노드 액션 실패가 order를 멈추지 않으므로, 치명적 실패는 어댑터가 취소 처리를 하고 관제가 FAILED 액션을 감시합니다.
  • 일시정지 중인 차량에 HARD instantAction을 보내지 않습니다. 새 orderId도 일시정지 중에는 거절됩니다(orderUpdateError).

한계

모든 결과는 libVDA5050++ v2.11.3과 가짜 1 m/s 어댑터에서 한 번씩 관찰한 것이라 시간은 ±0.1초 안팎의 관찰 오차를 가지며, 실제 장비의 응답 시간은 다룬 바 없습니다. 병렬로 도는 NONE 액션이 장비 자원을 어떻게 다루는지, 엣지 액션이 엣지 진입 시점에 정확히 시작하는지, SOFT와 HARD의 차이가 더 나타나는 조합이 있는지는 시험하지 않았습니다. 표준 문서가 같은 상황에서 요구하는 동작과 이 구현이 일치하는지는 확인하지 않았습니다. 다른 버전에서는 동작이 다를 수 있습니다.