Aurora Agent Commands
TCP/IP로 연결된 Aurora Agent 장치의 화면 캡처·키/터치 입력·이미지 비교.
Aurora agent 명령어는 Aurora Agent 프로그램이 실행 중인 원격 PC·장비(EUT, Equipment Under Test) 를 TCP/IP로 제어하기 위한 명령어 모음입니다. Aurora가 클라이언트(호스트)로 접속하고, 장치 쪽의 Aurora Agent가 키패드·키보드·마우스·터치 입력을 대신 수행하거나 화면 이미지를 전송해 줍니다.
이 카테고리의 명령어는 프로젝트에 Aurora agent 장치가 등록되어 있어야 명령어 입력 창을 열 수 있습니다. 등록되어 있지 않으면 The Aurora agent is not registered on the project properties. 메시지가 표시되고 창이 닫힙니다.
Aurora Agent와 연결 구조
- Aurora Agent는 EUT에서 TCP 서버로 동작하며, Aurora는 프로젝트에 등록된 IP 주소·포트로 접속합니다.
- 접속 직후 Aurora가 프로토콜 확인 명령(
ssAgentV1.00)을 보내고, Agent는 지원 기능(키보드/마우스/터치/키패드/클립보드 등)·화면 해상도·키패드 키 이름 목록(최대 32개) 을 회신합니다. 이 프로필이Insert keypad key버튼의 키 목록과Send keys to device의 입력 방식(마우스 클릭 또는 터치, 키보드 또는 키패드) 판단에 사용됩니다. - 연결은 명령어 실행 시점에 필요하면 자동으로 이루어지며, 이미 연결된 경우 재사용합니다. 스크립트 실행이 끝나면 모든 Agent 연결이 해제됩니다.
- Agent 응답 대기 시간은 일반 명령 3초, 화면 이미지 요청 8초이며, 초과하면
timeout오류로 처리됩니다.
장치(Target) 등록 방법
Aurora agent 장치는 프로젝트 속성(Project Information) 창의 Select DUT(Device Under Test) 영역에서 등록합니다.
- 왼쪽 트리에서 Remote Devices › Aurora agent 를 선택하고
>버튼을 누르거나 항목을 더블 클릭합니다. Insert Aurora Agent Device창에서 다음 항목을 입력합니다.
| 필드 | 설명 |
|---|---|
| Connectivity Name | 연결 모듈 이름 (Aurora agent, 읽기 전용) |
| Device Alias | 스크립트에서 장치를 가리키는 별칭 — 명령어의 Aurora agent alias 콤보에 표시됨 (기본값 Alias) |
| Remote IP Address | Aurora Agent가 실행 중인 EUT의 IP 주소 (기본값 127.0.0.1) |
| Port | Aurora Agent 수신 포트 (기본값 5905) |
OK를 누르면 오른쪽 장치 목록에Type / Name / Option(IP) / Alias / Model(SSTcpipAgent.dll)정보가 추가됩니다. 별칭 또는 IP가 비어 있으면Please input all items.메시지가 표시됩니다.
등록한 장치는 Tools › Aurora Agent Checker... 메뉴로 연결 상태를 확인하고 화면을 받아 직접 제어(터치·키패드 전송)해 볼 수 있습니다.
Aurora agent 별칭은 이 카테고리뿐 아니라 Images 명령어의 Search for image on 대상으로도 선택할 수 있습니다. 장치 화면에서 이미지를 찾아 판정·클릭하려면 If images, Wait for images, Click found image를 함께 활용하세요.
공통 입력 필드
모든 Aurora agent 명령어 입력 창은 같은 다이얼로그를 공유하며, 명령어에 따라 일부 필드가 숨겨지거나 라벨이 바뀝니다.
| 필드 | 설명 |
|---|---|
| Aurora agent alias | 명령을 보낼 Aurora agent 장치 별칭 — 현재 버전에서는 프로젝트에 등록된 첫 번째 Aurora agent 장치의 별칭이 표시·선택됨 |
| 텍스트 입력 필드 | 명령어별로 Expression (Keys): / Key name to press: / Coordinate (x,y): / File name to save: 라벨로 표시 — [x] 버튼으로 변수 삽입 가능 |
| Insert keypad key | 연결된 Agent가 알려준 키패드 키 이름 목록에서 선택해 텍스트 필드에 삽입 — Agent가 키패드를 지원하지 않거나 연결되지 않으면 비활성 |
| Insert x,y coordinates | 장치 화면을 받아 클릭한 위치의 좌표 (x,y) 를 텍스트 필드에 삽입 |
| Get device screen | 장치의 현재 화면을 받아 미리 보는 창을 열기 — Control 버튼(또는 Ctrl 키)을 누른 상태로 화면을 클릭하면 장치에 터치 전송 |
| Delay | 명령어 실행 후 대기 시간 (Milliseconds) |
| Description | 명령어 설명 (스크립트 메모 용도) |
Insert x,y coordinates, Get device screen, 영역 선택(...) 버튼은 실행 즉시 장치에 접속해 화면을 요청합니다. Agent에 연결할 수 없으면 The Aurora agent is not connected. 메시지가 표시됩니다.
반환값과 오류 메시지
- 명령어 실행 결과 코드는
mReturnValue에 저장됩니다. 성공1, 실패0, 오류는 음수 코드이며 디버그 메시지 끝에--> return N형식으로 표시됩니다. - 오류 시 디버그 메시지에는 원인이 함께 출력됩니다. 자주 나오는 메시지는 다음과 같습니다.
| 메시지 | 원인 |
|---|---|
Device alias does not exist | 옵션에 저장된 별칭이 프로젝트 장치 목록에 없음 |
connectivity module does not exist | 장치에 연결된 모듈(SSTcpipAgent.dll)을 찾을 수 없음 |
connectivity is not connected | IP·포트로 TCP 접속 실패 |
timeout | Agent가 제한 시간 안에 응답하지 않음 |
failed to send data / no connected client socket | 전송 중 소켓 오류 (연결이 끊어진 것으로 처리됨) |
expression is empty | 필수 텍스트 필드가 비어 있음 |
명령어 목록
| 분류 | 명령어 | 비고 |
|---|---|---|
| 입력 전송 | Send keys to device | 키·좌표·대기시간을 한 표현식으로 전송 (권장) |
| 화면 캡처 | Capture screen | 장치 화면을 파일로 저장 |
| 입력 전송 (Legacy) | Press keypad (Legacy) · Touch (Legacy) | Send keys to device로 대체 |
| 이미지 비교 (Legacy) | Compare image (Legacy) | Images 카테고리 명령어(If images 등)로 대체 |
Legacy 명령어는 이전 버전 스크립트와의 호환을 위해 유지됩니다. 새 스크립트에서는 키패드·터치 입력은 Send keys to device, 이미지 판정은 Images 카테고리 명령어를 사용하세요.