====== 원격 스크립트 ======

이 문서는 ComfileStudio의 <Remote_Script> 기능을 설명합니다.  \\ 
원격 스크립트는 기존의 스크립트 기능(액션 > 스크립트)을  
이더넷을 통해 원격지에서 실행할 수 있는 기능입니다.

C#, C++ 등 프로그래밍 언어를 사용하여  
TCP/IP 통신으로 원하는 스크립트를 실시간 원격 실행할 수 있습니다.

서버 측(HMI 펌웨어) 버전이 3.15 이상이며  CHC 시리즈인 경우에만 원격 스크립트 요청을 인식합니다.

===== 실행 절차 =====

  - HMI 네트워크 설정 후 원격 제어 서버를 구동합니다.  
    (런타임 설정 > 서버 > 원격 제어 서버 구동)

  - PC 등 클라이언트에서 이더넷을 통해 서버에 접속합니다.

  - 접속이 완료되면 서버에 스크립트를 전송합니다.  
    (응답을 받으려면 연결을 유지해야 합니다. 클라이언트가 끊지 않는 한 서버는 연결을 유지합니다.)

===== 스크립트 전송 프로토콜 =====

클라이언트에서 전송하는 스크립트는 XML(ASCII) 형식입니다.

<script>보낼 스크립트 내용</script>

예)  
<script>a=b+3</script>

스크립트 작성법에 대한 자세한 내용은 아래 링크를 참조하십시오.  
(단, 반복 기능은 원격 스크립트에서 지원하지 않습니다.)

[[..:action_run_script:index|스크립트]]

원격 제어 비밀번호가 설정된 경우 다음과 같이 전송합니다.

<script password="비밀번호">보낼 스크립트 내용</script>

예)  
<script password="1289">$a="안녕하세요"</script>

스크립트에 한글 등 다국어가 포함될 경우 UTF-8 형식으로 전송해야 합니다.

===== 응답 받는 방법 =====

스크립트 실행 후 서버로부터 데이터를 응답받을 수 있습니다.

예를 들어 HMI 변수 'a' 값을 byte 형식으로 응답받고 싶다면  
다음과 같이 전송합니다.

<script>write_byte(a);</script>

byte 외에도 word, double word, 문자열, 파일 내용 등을 전송할 수 있습니다.  
자세한 함수 설명은 아래 링크를 참조하십시오.

[[..:system_functions:index|시스템 함수]]


===== 송수신 테스트 방법 =====

ComfileStudio에는 원격 스크립트 기능을 직접 테스트할 수 있는  
"원격 스크립트 테스트 박스" 기능이 제공됩니다.

(메뉴 > 도구 > 고급 기능 > 원격 스크립트 테스트 박스)

{{  :ComfileStudio:Remote_Script:remscript.png?nolink | 원격 스크립트 테스트 박스 화면  }}

----

키워드: Remote_Script, 원격 스크립트 실행, ComfileStudio, CHC 시리즈, TCP/IP 스크립트 실행, XML 스크립트 패킷, write_byte 함수, 원격 제어 서버

[[ComfileStudio:index#원격_제어_및_네트워크_기능|상위 페이지로 가기]]