NetAssist(네트워크 어시스턴트) 사용 방법
소프트웨어 소개
네트워크 어시스턴트 NetAssist는 Windows 플랫폼에서 실행되는 TCP/IP 네트워크 디버깅 도구로, UDP, TCP, MQTT 등의 애플리케이션 프로토콜을 지원합니다. 이 도구는 네트워크 애플리케이션의 설계, 개발 및 테스트를 수행하는 개발자에게 필수적인 전문 도구 중 하나로, 네트워크 소프트웨어 및 하드웨어의 송수신 상태를 점검하고, 개발 속도를 향상시키며, 복잡한 개발 과정을 단순화하는 데 도움을 줍니다. TCP/UDP 기반 애플리케이션 개발 및 디버깅의 강력한 지원 도구로 활용될 수 있습니다.
응용 시나리오
비전 시스템 디버깅 과정에서 네트워크 어시스턴트는 TCP 또는 UDP 서버 또는 클라이언트 설정을 시뮬레이션하여 네트워크 장치나 네트워크 애플리케이션과의 통신 및 공동 디버깅을 용이하게 합니다. 자세한 내용은 아래와 같습니다.
-
서버 시뮬레이션: 네트워크 어시스턴트는 서버 프로그램을 시뮬레이션을 하여 클라이언트가 통신을 시작할 수 있는지 테스트합니다.
-
클라이언트 시뮬레이션: 네트워크 어시스턴트는 클라이언트 프로그램을 시뮬레이션을 하여 서버가 통신을 시작할 수 있는지 테스트합니다.
옵션 구성
네트워크 어시스턴트는 Mech-Vision&Mech-Viz 설치 디렉터리의 통신 구성 요소\tool 폴더에서 위치합니다. NetAssist.exe를 더블 클릭하면 네트워크 어시스턴트를 열수 있습니다.
인코딩 방식 변경
네트워크 어시스턴트는 ANSI(GBK)와 UTF-8 두 가지 인코딩 포맷을 지원합니다. 기본 인코딩 방식은 ANSI(GBK)입니다. 송신 창의 인코딩 방식과 수신 창의 인코딩 방식은 서로 독립적이며, 각 창의 빈 영역에서 마우스 오른쪽 버튼을 클릭한 후 Charset Encoding을 선택하여 인코딩 방식을 전환할 수 있습니다. 인코딩을 전환한 후,네트워크 어시스턴트는 이미 수신된 잘못된 데이터를 새로 고치지 않으며, 이후에 새로 수신된 데이터만 새로운 인코딩 설정에 따라 표시됩니다.
| 수신 창에 잘못된 데이터가 표시되면, 수신된 데이터가 UTF-8 인코딩으로 되어 있을 수 있습니다. 이 경우, 수신 창의 인코딩 방식을 UTF-8로 전환할 수 있습니다. |
데이터 수신 옵션 설정
네트워크 어시스턴트 왼쪽의 Recv Options에서 사용자는 데이터 수신 형식(ASCII/HEX), 데이터 표시, 데이터 저장 및 기타 옵션을 설정할 수 있습니다.
Recv Options의 옵션 설정은 다음과 같습니다.
| 옵션 | 설명 |
|---|---|
ASCII |
수신된 데이터는 ASCII 포맷으로 표시됩니다. |
HEX |
수신된 데이터는 16진법 형식으로 표시됩니다. |
Log Display Mode |
데이터 수신 창은 수신된 데이터 내용 외에도 수신된 데이터의 타임스탬프, 데이터 형식, 데이터 소스의 IP 주소 및 포트 번호, 그리고 전송된 데이터 기록 정보를 표시합니다. |
Auto Linefeed |
새로운 데이터 기록을 수신할 때마다 자동으로 줄바꿈이 이루어집니다. |
Save Recv to File |
수신된 데이터를 파일에 저장합니다. 이 옵션을 선택하면 파일 저장 경로를 선택하는 대화 상자가 나타납니다. 이 부분에서는 파일 저장 유형에 대해 주의해야 하며, 선택할 수 있는 옵션은 Log file(기본 유형)과 Data File 두 가지입니다.
|
AutoScroll |
자동 스크롤 기능을 비활성화하거나 활성화하려면 클릭하세요. |
Clear |
수신 창에 표시된 내용을 지웁니다. |
Send Options
네트워크 어시스턴트의 왼쪽에 있는 Send Options에서 사용자는 데이터 전송 형식(ASCII/HEX), 이스케이프 문자 명령어 설명, 추가 바이트 자동 추가, 파일 데이터 소스, 반복 주기 등의 옵션을 구성할 수 있습니다.
Send Options의 옵션 설정은 다음과 같습니다.
| 옵션 | 설명 |
|---|---|
ASCII |
ASCII 포맷으로 데이터를 전송합니다. |
HEX |
16진법 형식으로 데이터를 전송합니다. |
Use Escape Chars |
이스케이프 문자가 포함된 ASCII 텍스트를 전송할 때, 이스케이프 문자는 자동으로 해당하는 ASCII 데이터로 해석되어 전송됩니다. 이를 통해 사용자는 텍스트 형식으로 출력 불가능한 문자를 손쉽게 전송할 수 있습니다. i를 클릭하여 이스케이프 문자와 관련된 정보를 확인합니다. |
Auto Append Bytes |
전송된 데이터의 끝에 자동으로 체크섬 또는 종료 문자를 추가합니다. |
Send from File… |
보낼 데이터를 파일로 저장한 후, 파일 데이터 소스를 통해 데이터를 전송합니다. 이는 일반적으로 데이터 양이 많은 경우에 사용됩니다. |
Cycle |
Cycle를 선택하고 주기 시간을 밀리초 단위로 설정하면, 네트워크 어시스턴트는 설정된 주기에 따라 입력된 데이터를 반복해서 전송합니다. |
Net Options
네트워크 어시스턴트 왼쪽의 Net Options에서 사용자는 요구 사항에 따라 네트워크 어시스턴트를 TCP Server, TCP Client, UDP로 시뮬레이션할 수 있습니다. 다음으로 간단한 사례를 통해 TCP와 UDP 통신의 네트워크 설정을 시연합니다.
TCP 통신
A와 B 두 대의 컴퓨터가 동일한 로컬 네트워크에 있다고 가정하고(IP 주소와 포트 번호는 아래와 같음), 각각 네트워크 어시스턴트를 실행합니다. 이때 A 컴퓨터는 TCP 서버를 시뮬레이션하고, B 컴퓨터는 TCP 클라이언트를 시뮬레이션합니다.
-
A(TCP 서버): IP 주소는 192.168.20.224이고 포트 번호는 50000입니다.
-
B(TCP 클라이언트): IP 주소는 192.168.20.233입니다.
사용자는 다음 작업을 수행하여 두 대상 간의 TCP 통신을 테스트할 수 있습니다.
-
A 컴퓨터(TCP 서버)의 네트워크 어시스턴트에서 아래와 같이 네트워크를 설정하고 Open를 클릭하세요.
-
B 컴퓨터(TCP 클라이언트)의 네트워크 어시스턴트에서 아래와 같이 네트워크를 설정하고 Open를 클릭하세요.
-
B 컴퓨터(TCP 클라이언트)의 네트워크 어시스턴트에서 hello를 입력하고 Send를 클릭하세요.
-
A 컴퓨터(TCP 서버)의 네트워크 어시스턴트에서 B 컴퓨터가(TCP 클라이언트) 전송한 데이터를 확인할 수 있습니다.
UDP 통신
A와 B 컴퓨터가 동일한 로컬 네트워크에 있다고 가정하고(아래에 IP 주소와 리스닝 포트 번호가 제공됨), 각각네트워크 어시스턴트를 실행하고 있습니다. UDP는 연결 없는 프로토콜이므로 서버와 클라이언트를 구분할 필요가 없습니다.
-
A: IP 주소는 192.168.20.224이고, 컴퓨터는 포트 50000에서 수신합니다.
-
B: IP 주소는 192.168.20.233이고, 컴퓨터는 포트 50000에서 수신합니다.
사용자는 다음 작업을 수행하여 두 대상 간의 UDP 통신을 테스트할 수 있습니다.
-
A 컴퓨터의 네트워크 어시스턴트에서 아래와 같이 네트워크를 설정하고 Open를 클릭하세요. Remote에서 B 컴퓨터의 IP 주소와 포트 번호를 입력합니다.
-
B 컴퓨터의 네트워크 어시스턴트에서 아래와 같이 네트워크를 설정하고 Open를 클릭하세요. Remote에서 A 컴퓨터의 IP 주소와 포트 번호를 입력합니다.
-
A 컴퓨터의 네트워크 어시스턴트에서 hello를 입력하고 Send를 클릭하세요.
-
B 컴퓨터의 네트워크 어시스턴트에서 A 컴퓨터가 전송한 데이터를 확인할 수 있습니다.
네트워크 어시스턴트를 통해 TCP 표준 인터페이스 명령어를 전송하기
위에서는 네트워크 어시스턴트에 대한 기본 정보를 설명했습니다. 다음으로, 네트워크 어시스턴트를 사용하여 TCP 표준 인터페이스 명령어를 전송하는 방법을 설명하겠습니다.
| 시작하기 전에 Mech-Vision 프로젝트가 올바르게 설정되었는지 확인하고, 프로젝트가 현재 프로젝트를 자동으로 로드하기로 설정되어 있는지, 또한 프로젝트 이름 앞에 프로젝트 번호가 표시되어 있는지 확인하십시오. |
-
IPC의 Mech-Vision 소프트웨어에서 다음 그림과 같이 인터페이스 서비스 유형, 프로토콜, 포트를 구성하세요.
프로토콜을 TCP Server로 설정하면 여기에 구성된 인터페이스 서비스는 TCP 서버와 동일합니다. 
-
Mech-Vision 메인 화면에서 툴 바에 있는 “인터페이스 서비스” 기능이 활성화되어 있는지 확인합니다.
-
IPC에서 네트워크 어시스턴트를 엽니다. Protocol은 TCP Client로 성택하고 Remote Host Addr에서 실제 IPC의 IP 주소를 입력합니다. Remote Host Port에서 Mech-Vision에 설정된 포트를 입력하고 Open를 클릭합니다.
Recv Options와 Send Options의 데이터 형식은 Mech-Vision 소프트웨어에 설정된 프로토콜 형식과 일치해야 합니다. 
-
데이터 전송 창에서 구체적인 명령어를 입력합니다. 예를 들어 101,1,0,0,0,0,0,0,0을 입력합니다. 그 다음 Send를 클릭합니다.
전송이 완료 후, 수신 창에서 Mech-Vision 소프트웨어가 반환한 데이터를 확인할 수 있습니다.
자주 묻는 질문
안전 소프트웨어에서 네트워크 어시스턴트에 문제가 있다고 경고함
소프트웨어는 시작 시 버전 정보를 확인하기 위해 네트워크에 접근합니다. 이로 인해 안전 소프트웨어가 가끔 오류를 보고할 수 있습니다. 만약 실행 중에 이러한 오류가 발생하면, 소프트웨어를 신뢰해 주시기 바랍니다.
리스닝할 때 상태 표시줄에 오류 정보(The specified address is already in use)가 표시됨
이 오류가 발생하는 원인은 다른 프로그램이 리스닝 중인 포트를 사용하기 때문입니다. 사용자는 이 포트를 사용 중인 프로그램을 종료하거나 포트를 변경하세요.
TCP 클라이언트가 TCP 서버에 연결 불가
이 문제는 여러 가지 원인이 있을 수 있으며, 아래 항목들을 차례대로 점검해야 합니다.
-
TCP 클라이언트가 서버에 연결할 때 입력된 서버 주소와 포트는 올바른지 확인해야 합니다.
-
서버에서 리스닝을 위해 올바른 네트워크 어댑터 주소가 선택되었는지 확인해야 합니다.
-
서버가 시작되고 지정된 포트에서 적극적으로 리스닝 중인지 확인해야 합니다.
-
클라이언트와 서버 간의 물리적인 네트워크 연결이 정상적인지 확인해야 합니다. 확인하려면 클라이언트에서 서버 주소로 ping 명령어를 실행하여 데이터가 반환되는지 확인하십시오. 반환되지 않으면 네트워크 문제가 있는지 확인하세요.
-
서버의 리스닝 포트가 서버에 의해 제한되지 않는지 확인해야 합니다.
-
서버와 클라이언트는 동일한 네트워크 세그먼트에 있는지 확인해야 합니다.