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