TCP ASCII 통신 명령
TCP ASCII 통신을 사용할 때 외부 장치는 다음과 같은 몇 가지의 명령어를 사용하여 Mech-MSR 프로젝트의 실행을 트리거하고 해당 결과를 얻을 수 있습니다.
-
trigger 명령어: 프로젝트 실행의 트리거에 사용됩니다.
-
return 명령어: 지정된 프로젝트의 판정 결과 및 측정 결과를 획득하는 데 사용됩니다.
-
execute 명령어: 프로젝트를 실행하고 프로젝트의 판정 결과 및 측정 결과를 얻는 데 사용됩니다.
-
judge 명령어: 특정 프로젝트의 전체 품질 판정 결과 또는 개별 측정 항목의 품질 판정 결과를 획득하는 데 사용됩니다.
-
value 명령어: 주로 지정된 프로젝트의 측정값을 획득하는 데 사용됩니다.
|
trigger 명령어
trigger 명령어는 Mech-MSR 프로젝트의 실행을 트리거하는 데 사용되며, 여러 프로젝트를 동시에 트리거할 수 있도록 지원합니다.
첫 번째 단계: 프로젝트 번호 결정
Mech-MSR 메인 인터페이스의 프로젝트 리스트 구역에서 트리거 할 프로젝트의 번호를 확인합니다.
| 프로젝트를 위아래로 드래그하여 순서를 조정한 다음 솔루션 이름을 클릭하고 마우스 오른쪽 버튼 클릭 메뉴에서 프로젝트 번호 재설정을 선택하면 프로젝트 번호가 업데이트됩니다. |
두 번째 단계: 명령어 전송
전송된 trigger 명령어는 trigger, 프로젝트 번호, 문자열 구분 기호 세 부분으로 구분됩니다.
-
trigger: 정확한 명령어 명칭이며 대소문자 변경이 불가능합니다.
-
프로젝트 번호: 트리거할 프로젝트가 Mech-MSR 솔루션에서의 번호입니다.
-
문자열 구분 기호: 프로젝트 ID에서 trigger를 구분하는 기호입니다. 기본값은 영문 쉼표(,)입니다. Mech-MSR의 통신 설정 창의 기타 데이터 형식 파라미터에서 문자열 구분 기호를 수정할 수 있습니다.
trigger 명령어의 전송 포맷 및 예시 설명은 아래 표와 같습니다.
| 명령어 포맷 | 설명 | 예시 |
|---|---|---|
|
한 개의 프로젝트 실행을 트리거합니다. |
번호가 1인 프로젝트 실행을 트리거합니다.
|
|
여러 개의 프로젝트 실행을 트리거합니다. |
번호가 각각 1, 2, 3인 프로젝트 실행을 트리거합니다.
|
세 번째 단계: 반환된 결과 확인
trigger 명령어를 전송한 후 수신한 상태 코드가 0인 경우 명령어 실행이 성공임을 의미합니다.
명령어 실행이 실패한 경우 오류 상태 코드 -1 또는 -4를 반환합니다. 가능한 원인과 해결 방법은 오류 코드 내용을 참조하십시오.
return 명령어
trigger 명령어를 전송하여 프로젝트 실행을 트리거한 후 return 명령어를 사용하여 해당 프로젝트의 실행 결과를 획득합니다. return 명령어는 매번 하나의 Mech-MSR 프로젝트 결과만 얻을 수 있습니다.
첫 번째 단계: 반환된 결과 형식 결정
Mech-MSR의 통신 설정 창에서 실제 요구에 따라 return 명령어 데이터 형식을 설정합니다.
기본 데이터 형식은 %judge,%value[%id],%judge[%id]입니다.
두 번째 단계: 명령어 전송
전송된 return 명령어는 return, 프로젝트 번호, 문자열 구분 기호 세 부분으로 구성됩니다.
-
return: 정확한 명령어 명칭이며 대소문자 변경이 불가능합니다.
-
프로젝트 번호: Mech-MSR 솔루션에서 trigger명령어로 트리거 된 프로젝트의 번호입니다.
-
문자열 구분 기호: return과 프로젝트 번호를 구분하는 부호이며, 기본값은 영문 쉼표(,)입니다.
return 명령어의 전송 형식 및 예시 설명은 아래 표와 같습니다.
| 명령어 형식 | 설명 | 예시 |
|---|---|---|
|
프로젝트 실행 결과를 획득합니다. |
번호가 1인 프로젝트의 실행 결과를 획득합니다.
|
지정된 프로젝트가 이미 trigger 명령어에 의해 실행되도록 트리거되었는지 확인 합니다. 그렇지 않으면 return 명령어를 전송한 후 정상적으로 결과를 얻을 수 없습니다.
|
세 번째 단계: 반환된 결과 확인
프로젝트 1을 예로 들면, 외부 장치에서 return, 1 명령어를 전송한 후Mech-MSR에서는 설정한 통신 설정 창에서 설정한 return 명령어 데이터 형식에 따라 결과를 반환할 수 있습니다.
명령어 실행이 실패한 경우 오류 코드 -1, -2, -3 또는 -4를 반환합니다. 가능한 원인과 해결 방법은 오류 코드 내용을 참조하십시오.
| Return 명령어 데이터 형식 | 반환된 결과(예) | 설명 |
|---|---|---|
|
|
프로젝트 1의 전체 품질 판정 결과가 OK임을 표시합니다. |
|
|
프로젝트 1의 전체 품질 판정 결과가 NG임을 표시합니다. |
|
|
프로젝트 1의 전반적인 품질 판정 결과가 OK임을 나타내며, 이 프로젝트에서는 두 개의 측정 항목만 출력되도록 지정되었습니다. 첫 번째 측정 항목의 값은 0.0224로 OK 판정을 받았고, 두 번째 측정 항목의 값은 54.0000으로 NG 판정을 받았습니다. |
|
프로젝트 1의 전체 품질 판정 결과가 NG임을 나타냅니다. 이 프로젝트에서는 하나의 측정 항목만 출력되도록 지정되었습니다. 측정 항목은 측정 결과가 없으므로 invalid(유효하지 않음)로 반환되며, 측정 항목은 NG로 판정됩니다. |
|
|
|
프로젝트 1의 전체 품질 판정 결과가 OK임을 표시하며, 측정 항목 2의 값과 해당 판정 결과가 모두 유효하지 않음을 나타냅니다. 가능한 원인:
해결 방법:
|
|
Mech-MSR이 외부 장치에 결과를 반환하기 위한 기본 조건은 측정값 및 판정 결과를 참조하십시오. |
execute 명령어
execute 명령어는 trigger 및 return 명령어의 기능을 결합하여, 프로젝트를 실행하고 프로젝트의 판정 결과와 측정 결과를 모두 얻는 데 사용할 수 있습니다.
명령어 전송
전송된 execute 명령은 execute, 프로젝트 번호, 문자열 구분 기호로 구성되었습니다.
-
execute: 정확한 명령어 명칭이며 대소문자 변경이 불가능합니다.
-
프로젝트 번호: Mech-MSR 솔루션에서 트리거될 프로젝트의 번호입니다.
-
문자열 구분 기호: execute와 프로젝트 번호를 구분하는 기호입니다. 기본값은 영문 쉼표(,)입니다.
execute 명령의 전송 형식 및 예시는 아래와 같습니다.
| 명령어 형식 | 설명 | 예시 |
|---|---|---|
|
프로젝트를 실행하고 프로젝트의 판정 결과와 측정 결과를 얻습니다. |
번호가 1인 프로젝트를 실행하여, 프로젝트의 판정 결과와 측정 결과를 얻습니다.
|
| execute 명령어(명령 코드 1)는 하나의 프로젝트를 실행하고 프로젝트의 판정 결과 및 측정 결과를 얻는 데에만 사용할 수 있습니다. |
반환된 결과 확인
프로젝트 1을 예로 들면, 외부 장치에서 return, 1 명령어를 전송한 후, Mech-MSR에서 설정된 통신 설정 창에서 지정한 return 명령어 데이터 형식에 따라 결과를 반환할 수 있습니다. 자세한 내용은 return 명령어 반환된 결과를 참조하십시오.
명령어 실행이 실패한 경우 오류 코드 -1, -2, -3 또는 -4를 반환합니다. 가능한 원인과 해결 방법은 오류 코드 내용을 참조하십시오.
judge 명령어
trigger 명령어를 전송하여 프로젝트의 실행을 트리거한 후 judge 명령어는 지정된 Mech-MSR 프로젝트의 전체 또는 단일 측정 항목의 판정 결과를 획득하는 데 사용됩니다.
첫 번째 단계: 명령어 전송
전송된 judge명령어는 judge, 프로젝트 번호, 문자열 구분 기호 세 부분으로 구성됩니다.
-
judge: 정확한 명령어 명칭이며 대소문자 변경이 불가능합니다.
-
프로젝트 번호: Mech-MSR 솔루션에서 trigger 명령어로 트리거 된 프로젝트의 번호입니다.
-
문자열 구분 기호: judge와 프로젝트 번호를 구분하는 부호입니다. 기본값은 영문 쉼표(,)입니다.
judge 명령어의 전송 형식 및 예시는 아래와 같습니다.
| 명령어 형식 | 설명 | 예시 |
|---|---|---|
|
프로젝트의 전체와 각 측정 항목의 품질 판정 결과를 획득하는 데 사용됩니다. |
번호가 1인 프로젝트의 종합 판정 결과 및 단일 측정 항목의 판정 결과를 획득합니다.
|
두 번째 단계: 반환된 결과 확인
프로젝트 1을 예로 들면, 외부 장치에서 judge, 1 명령어를 전송한 후, Mech-MSR에서는 출력 관리 창에서 설정한 품질 판정 규칙 및 출력에 따라 프로젝트의 전체 품질 판정 결과와 개별 측정 항목의 품질 판정 결과를 출력 관리 창에 반환합니다.
명령어 실행이 실패한 경우, 오류 코드 -1, -2, -3 또는 -4가 반환됩니다. 가능한 원인과 해결 방법은 오류 코드 내용을 참조하십시오.
| 반환된 결과 | 설명 |
|---|---|
(예시) |
첫 번째 0은 프로젝트 1의 전체 판정 결과가 OK임을 나타내고, 다음 두 개의 0은 해당 프로젝트에 대해 2개의 측정 항목이 출력되도록 설정되어, 두 항목 모두 판정 결과가 OK임을 나타냅니다. |
(예시) |
첫 번째 1은 프로젝트 1의 전체 판정 결과가 NG임을 나타내고, 다음 두 개의 1은 해당 프로젝트에 대해 2개의 측정 항목이 출력되도록 설정되어, 두 항목 모두 판정 결과가 NG임을 나타냅니다. |
|
Mech-MSR에서 결과를 외부 장치로 반환하기 위한 기본 조건에 대해 알아보시려면 판정 결과 내용을 참조하십시오. |
value 명령어
프로젝트 실행을 트리거하는 trigger 명령어를 보낸 후, value 명령어를 사용하여 지정된 프로젝트의 측정된 값을 가져옵니다.
첫 번째 단계: 명령어 전송
전송된 value명령어는 value, 프로젝트 번호, 문자열 구분 기호로 구성됩니다.
-
value: 정확한 명령어 명칭이며 대소문자 변경이 불가능합니다.
-
프로젝트 번호: Mech-MSR 솔루션에서 trigger 명령어로 트리거 된 프로젝트의 번호입니다.
-
문자열 구분 기호: value와 프로젝트 번호를 구분하는 부호입니다. 기본값은 영문 쉼표(,)입니다.
value 명령어의 전송 형식 및 예시는 아래와 같습니다.
| 명령어 형식 | 설명 | 예시 |
|---|---|---|
|
지정된 프로젝트의 측정값을 획득하는 데 사용됩니다. |
번호가 1인 프로젝트의 측정값을 획득합니다.
|
두 번째 단계: 반환된 결과 확인
프로젝트 1을 예로 들면, 외부 장치에서 value, 1 명령어를 전송한 후, Mech-MSR에서는 출력 관리 창에서 설정한 품질 판정 규칙 및 출력에 따라 프로젝트의 전체 품질 판정 결과와 개별 측정 항목의 품질 판정 결과를 출력 관리 창에 반환합니다.
명령어 실행이 실패한 경우, 오류 코드 -1, -2, -3 또는 -4가 반환됩니다. 가능한 원인과 해결 방법은 오류 코드 내용을 참조하십시오.
| 반환된 결과 | 설명 |
|---|---|
(예시) |
0은 프로젝트 1의 종합 판정 결과가 OK이고 측정 항목 1의 값이 54.000임을 나타내며, 이 프로젝트는 하나의 측정 항목만 출력하도록 지정되었습니다. |
(예시) |
1은 프로젝트 1의 종합 판정 결과가 NG이고 측정 항목 1의 값이 54.000임을 나타내며, 이 프로젝트는 하나의 측정 항목만 출력하도록 지정되었습니다. |
(예시) |
1은 프로젝트 1의 종합 판정 결과가 NG임을 나타냅니다. 본 프로젝트는 하나의 측정 항목만 출력하도록 지정하고, 측정 항목에는 해당 값이 없습니다. 따라서 반환된 값은 invalid(유효하지 않음)입니다. 가능한 원인:
해결 방법:
|
|
Mech-MSR이 외부 장치에 결과를 반환하기 위한 기본 조건은 측정값 및 판정 결과를 참조하십시오. |