개요 · 프로토콜 정의

개요

이 문서는 Aurora Professional(Aurora Protocol Player)과 연동하여 EUT(Equipment Under Test, 시험 대상 장비) 를 제어하기 위한 Aurora Protocol을 정의합니다.

통신은 TCP/IP 또는 UDP를 이용하여 문자열로 주고받으며, 같은 네트워크의 기기에서 접속하여 EUT의 WLAN 모드 변경 또는 제어를 수행할 수 있습니다.

구성

Aurora Protocol Player를 실행하면 TCP/IP 서버 또는 UDP 수신 엔드포인트로 동작합니다. 어느 쪽으로 동작할지는 Player의 설정(Settings)에서 고릅니다.

• TCP/IP에서 클라이언트는 하나의 연결만 유지됩니다. 다른 연결이 시도되면 기존 연결을 종료하고 새 연결을 유지합니다.
• UDP에서는 연결 개념이 없습니다. 응답은 마지막으로 데이터를 보낸 클라이언트의 IP와 설정의 원격 포트(Remote Port)로 전송합니다. 받아들일 발신지는 허용 IP(Allowed IP)로 지정할 수 있고, 비워 두면 시작·재시작 후 처음 데이터를 보낸 발신지가 그 실행 동안 고정됩니다.
• 연결이 성공한 후에는 User Application이 주도적으로 Command를 보내고 응답을 받아 처리합니다.
• User Application이 Command를 보내지 않으면 서버는 아무 처리도, 데이터 송신도 하지 않습니다.

연결 정보

프로토콜 정의

프로토콜은 Command와 Data로 구성되며, 문자열은 반드시 NULL로 끝나야 합니다.

명령 전송 (클라이언트 → 서버)

!CC:DATA\0

응답 (서버 → 클라이언트)

!99:N\0

쉼표 이스케이프

클라이언트가 보내는 Data에서 ,는 항목 구분자입니다. 값 안에 쉼표가 필요하면 \, 로 씁니다. 이스케이프는 이것 하나뿐이며, 쉼표 앞이 아닌 역슬래시는 그대로 전달됩니다. 그래서 c:\image\a.png 같은 경로는 이스케이프할 필요가 없고, 값 끝의 역슬래시도 그대로 남습니다.

한글 등 ASCII 밖의 문자

제목·본문(!32), 스크립트 그룹 값(!01), 비교 문자열(!30)처럼 한글이 들어가는 Data는 CP949 또는 UTF-8로 보냅니다. Player는 메시지를 받을 때마다 인코딩을 자동으로 판별합니다.

• Player가 보내는 응답의 문자열(예: !31의 인식 결과)은 클라이언트가 마지막으로 쓴 인코딩으로 보냅니다. 클라이언트는 보낸 인코딩 그대로 응답을 읽으면 됩니다.
• 크기 제한은 글자 수가 아니라 바이트 수입니다. 한글 한 글자는 CP949에서 2바이트, UTF-8에서 3바이트입니다.
• 전송 길이는 인코딩한 바이트 배열의 길이로 정해야 합니다. 문자열 길이(글자 수)를 쓰면 메시지 뒷부분이 잘립니다.
• 한 세션 안에서는 한 가지 인코딩만 쓰세요. 한글 없이 °처럼 2바이트 문자만 담긴 메시지는 두 인코딩 어느 쪽으로도 읽히므로 직전 인코딩을 따릅니다.

C#   byte[] data = Encoding.UTF8.GetBytes(msg + "\0");                    // UTF-8
     byte[] data = Encoding.GetEncoding(949).GetBytes(msg + "\0");        // CP949
     socket.Send(data, data.Length, SocketFlags.None);                    // 바이트 배열 길이

C++  CStringA a(CW2A(msg, CP_UTF8));      // 또는 CP_ACP (한국어 Windows = CP949)
     send(s, a, a.GetLength() + 1, 0);    // NULL까지 포함한 바이트 수

명령 분류