# TCPClient

TCPClient 함수를 사용해 스프레드시트 셀을 TCP/IP 클라이언트로 정의할 수 있으며, 이는 네트워크를 통해 데이터를 공유할 수 있도록 다른 TCP/IP 장치와의 연결을 시작합니다.

참고 :

- TCPClient 함수를 추가하거나 작업을 스프레드시트로 로드하면 TCP 스프레드시트 함수와 다른 TCP/IP 장치 간의 연결이 즉시 시작됩니다.

- TCPClient는 패킷을 수신한 후 이벤트를 생성합니다. 이 이벤트는 스프레드시트를 업데이트합니다.

## TCPClient 입력

매개 변수 | 설명
--- | ---
호스트명 | 연결을 설정하는 TCP 장치의 이름 또는 IP 주소를 지정합니다. 호스트 이름을 지정하지 않으면 TCPClient 함수가 #ERR을 반환합니다.
포트 번호 | TCP/IP 장치가 연결되는 포트 번호를 지정합니다. 포트 번호는 부호 없는 16비트 포트 번호입니다. 0은 유효한 포트 번호가 아닙니다. 기본 포트 번호는 3000입니다. 참고 : 여기에 입력한 포트 번호를 서버에서 할당해야 합니다.
패킷 유형 | TCP/IP 장치 간에 통신하는 데이터 문자열의 형식을 정의합니다.
유형 | 설명
--- | ---
0 = 문자열 CR+LF(기본값) | ASCII 형식. TCP 스프레드시트 함수가 송신 시에는 소프트웨어가 데이터 문자열에 ASCII 문자 13(캐리지 리턴)과 10(줄 바꿈)을 추가합니다. 수신 시에는 CR+LF로 데이터 문자열이 종료됩니다.
1 = 문자열 CR(13) | ASCII 형식. TCP 스프레드시트 함수가 송신 시에는 소프트웨어가 데이터 문자열에 ASCII 문자 13(캐리지 리턴)을 추가합니다. 수신 시에는 CR으로 데이터 문자열이 종료됩니다.
2 = 문자열 LF(10) | ASCII 형식. TCP 스프레드시트 함수가 송신 시에는 소프트웨어가 데이터 문자열에 ASCII 문자 10(줄 바꿈)을 추가합니다. 수신 시에는 FL로 데이터 문자열이 종료됩니다.
3 = 문자열 Null 문자(0) | ASCII 형식. TCP 스프레드시트 함수가 송신 시에는 소프트웨어가 데이터 문자열에 ASCII 문자 0(Null 문자)을 추가합니다. 수신 시에는 Null 문자로 데이터 문자열이 종료됩니다. 참고 : 패킷 유형에 관계없이 In-Sight 비전 시스템이 수신 중 ASCII 문자 0(Null 문자)이 있으면 데이터 문자열이 종료됩니다.
5 = 사용자 정의 종료자가 있는 문자열 | ASCII 형식. TCP 스프레드시트 함수가 전송 중이면 소프트웨어는 데이터 문자열에 지정된 종료자를 추가합니다. 수신 시에는 지정된 종료자가 있으면 데이터 문자열이 종료됩니다.
타임아웃 | TCPClient가 TCP/IP 연결 설정을 대기할 시간(1000 - 15000. 기본값 = 1000). 이 시간이 지나면 연결 시도를 중단합니다. 연결이 없는 경우 WriteDevice가 재연결을 시도합니다. 타임아웃 시간 내에 시도가 실패하면 #ERR이 표시됩니다. 연결되어 있지만 TCPClient가 타임아웃 시간 동안 네트워크 장치에 패킷을 전달할 수 없는 경우에도 WriteDevice에 #ERR이 표시됩니다. TCPClient는 #ERR을 반환하지 않습니다.
종료자 | 패킷 유형으로 고객 종료자 문자열 또는 고객 종료자 이진 데이터를 지정할 때 사용하는 바이트 값을 지정합니다.
최대 패킷 크기 | TCPClient가 수신할 수 있는 최대 패킷 크기를 지정합니다. 원격 발신자가 최대 패킷 크기를 초과하는 경우 ReadDevice가 #ERR을 표시합니다.

## TCPClient 출력

반환 | Device 데이터 구조. 입력 매개 변수 중 하나라도 유효하지 않은 경우 #ERR을 반환합니다.
결과 | TCPClient 함수를 셀에 삽입하면 WriteDevice 함수가 오른쪽에 있는 인접한 셀에 자동으로 삽입됩니다.

## 예

In-Sight 호스트 비전 시스템 이름을 SYSTEM0로 구성하고 연결된 셀에 다음 매개 변수 값이 설정합니다.

A3=TCPClient("SYSTEM1",3000,0,1000,0,1024)

B3=WriteDevice($A$0,A3,C3)

TCP/IP 서버가 포함된 SYSTEM1이라는 이름의 두 번째 호스트 시스템을 구성하고 관련 셀에 다음과 같이 매개 변수 값을 설정한다고 가정합니다.

A4=TCPServer(3000,0,0,1024)

B4=ReadDevice(A4)

SYSTEM0 및 SYSYEM1 시스템이 모두 온라인 상태입니다.

SYSTEM0의 셀 $A$0에 있는 기본 이미지를 촬상할 때마다 셀 A3의 TCP/IP 클라이언트는 포트 3000에서 SYSTEM1의 셀 A4에 있는 TCP/IP 서버와의 연결(아직 연결되지 않은 경우)을 설정합니다.

이제 SYSTEM0의 셀 B3에 있는 WriteDevice 함수가 C3의 데이터를 SYSTEM1의 셀 B4에 있는 ReadDevice 함수로 내보냅니다.