# Rhopoint COM Agent

> Section of the Rhopoint Instruments Manual.

This file bundles all 11 pages of this section as Markdown.

# Rhopoint COM Agent

Rhopoint COM Agent는 FT3 막 두께 측정기와 같은 Rhopoint 기기가 직렬(COM) 연결을 통해 전송하는 측정 데이터를 캡처하여 유용한 형태로 변환하는 Windows 애플리케이션입니다. 즉, 디스크에 구조화된 파일로 저장하거나 값을 다른 프로그램에 직접 입력할 수 있습니다.

기기가 결과를 출력할 때마다 COM Agent는 이를 읽어 데이터 형식을 인식한 뒤 사용자가 선택한 형식으로 기록합니다. 원시 **TXT** 파일, 구조화된 **CSV** 파일, 또는 **키 입력 에뮬레이션**을 통해 현재 포커스가 있는 필드(스프레드시트 셀, 품질 관리 데이터베이스, ERP 양식 등)에 값을 직접 표시하는 방식입니다.

![](../_images/com-agent-main-screen-ko.png)

## COM Agent로 할 수 있는 일

1. [COM Agent 설치](rhopoint-com-agent-install-com-agent.md) — 애플리케이션을 다운로드하고 설치하여 시작합니다.
2. [기기 연결](rhopoint-com-agent-connecting-an-instrument.md) — COM 포트와 보 레이트를 선택하고 데이터가 도착하는지 확인합니다.
3. [출력 형식](rhopoint-com-agent-output-formats.md) — 각 측정값을 TXT 및/또는 CSV 파일로 기록합니다.
4. [키보드 에뮬레이션](rhopoint-com-agent-keyboard-emulation.md) — 구성 가능한 구분 기호와 함께 측정값을 다른 애플리케이션에 직접 입력합니다.
5. [측정값 캡처](rhopoint-com-agent-capturing-measurements.md) — 캡처를 시작 및 중지하고 실시간 활동을 확인합니다.
6. [데모 모드](rhopoint-com-agent-demo-mode.md) — 기기를 연결하지 않고 애플리케이션을 사용해 봅니다.
7. [라이선스](rhopoint-com-agent-licensing.md) — 라이선스를 추가하여 실시간 캡처를 활성화합니다. 데모 모드는 라이선스 없이도 항상 작동합니다.
8. [설정 및 언어](rhopoint-com-agent-settings-and-language.md) — 구성이 기억되며, 인터페이스는 13개 언어로 제공됩니다.
9. [명령줄 실행](rhopoint-com-agent-command-line-launch.md) — 미리 구성된 상태로 시작하여 자동으로 캡처합니다(자동화용).
10. [COM Agent 업데이트](rhopoint-com-agent-updating-com-agent.md) — 애플리케이션을 최신 상태로 유지합니다.

## 지원되는 기기

COM Agent는 다음을 포함한 Rhopoint 기기의 직렬 출력을 읽습니다.

- **FT3** 막 두께 측정기

> [!info] COM Agent는 현재 FT3의 *"print all samples"* 두께 형식에 대해 완전한 구조화(CSV) 파싱을 제공합니다. 다른 기기는 원시 텍스트로 캡처되며, 샘플 데이터가 확보되는 대로 구조화 파싱이 추가됩니다. 키보드 및 TXT 출력은 모든 기기에서 작동합니다.

> [!info] COM Agent는 Windows에서만 실행됩니다. 별도의 .NET 설치가 필요 없는 자체 포함 애플리케이션으로 배포되며, 자동으로 최신 상태를 유지합니다.


---

# Install COM Agent

Rhopoint COM Agent는 가벼운 Windows 애플리케이션입니다. 설치 프로그램이 필요한 모든 것을 설정하며 애플리케이션을 자동으로 최신 상태로 유지합니다.

## 다운로드

[download.rhopointservice.net/com-agent](https://download.rhopointservice.net/com-agent)에서 최신 버전의 COM Agent를 다운로드하십시오.

## 설치

1. 위 링크에서 COM Agent 설치 프로그램을 다운로드합니다.
2. 설치 프로그램을 더블 클릭하고 화면의 지시를 따릅니다.
3. 시작 메뉴에서 **Rhopoint COM Agent**를 실행합니다.

> [!info] COM Agent는 자체 포함형이며 별도의 .NET 런타임 설치가 필요하지 않습니다. 설치 프로그램은 업데이트도 확인하여 백그라운드에서 자동으로 설치하므로 항상 최신 버전을 실행하게 됩니다.

## 시스템 요구 사항

- **OS:** Windows 10(빌드 19041 / 20H1) 이상
- **CPU:** x64 또는 ARM64
- **사용 가능한 직렬(COM) 포트** — 내장 포트 또는 USB-직렬 어댑터를 사용하여 기기를 연결합니다. 일부 기기는 특수 케이블이 필요합니다([개요](rhopoint-com-agent.md) 참조).

## 첫 실행

COM Agent를 시작하면 기본 창이 두 영역으로 나뉩니다.

- **왼쪽**에는 구성: 연결 설정 및 출력 옵션이 있습니다.
- **오른쪽**에는 실시간 활동: 상태, 수신된 측정값 수, 마지막 측정값 및 활동 로그가 있습니다.

**시작 / 중지** 버튼은 측정값 카운터 위 오른쪽 상단에 있으며 항상 표시됩니다.

![](../_images/com-agent-main-screen-ko.png)

[다음: 기기 연결](rhopoint-com-agent-connecting-an-instrument.md)


---

# Connecting an Instrument

**실시간** 모드에서 COM Agent는 직렬(COM) 연결을 통해 기기로부터 측정 데이터를 직접 읽습니다.

![](../_images/com-agent-connection-ko.png)

## 1. 하드웨어 연결

1. 직렬 케이블 또는 USB-직렬 어댑터를 사용하여 기기를 PC에 연결합니다. 일부 기기(CBT1.2, NovoHaze TX)는 특수 케이블이 필요합니다 — [개요](rhopoint-com-agent.md)를 참조하십시오.
2. 기기의 전원을 켭니다.

## 2. 연결 설정 선택

왼쪽 **연결** 섹션에서:

| 설정 | 설명 |
| --- | --- |
| **모드** | 직렬 포트에서 읽으려면 **실시간**으로 설정합니다. (하드웨어 없이 앱을 사용해 보려면 **데모**를 사용하십시오 — [데모 모드](rhopoint-com-agent-demo-mode.md) 참조.) |
| **COM 포트** | 기기가 연결된 포트를 선택합니다. 어댑터를 연결한 후 포트를 다시 스캔하려면 **새로 고침** 버튼을 클릭하십시오. |
| **보 레이트** | 직렬 속도입니다. Rhopoint 기기의 기본값은 **19200**입니다. |
| **파트 마커** | 기기가 완전한 데이터 세트의 각 파트를 표시하기 위해 출력하는 문자입니다. 기본값은 **^**입니다. |
| **파트 수** | 몇 개의 파트 마커가 하나의 완전한 데이터 세트를 구성하는지를 나타냅니다. 기본값은 **4**입니다. |

> [!info] **파트 마커**와 **파트 수**는 측정이 완료되었는지를 COM Agent에 알려줍니다. 데이터 세트는 예상되는 수의 마커가 수신되고 줄이 끝났을 때에만 기록됩니다 — 이는 절반만 수신된 측정값이 저장되는 것을 방지합니다. 기본값은 Rhopoint 기기에 맞춰져 있으므로 Rhopoint 지원팀의 안내가 있는 경우에만 변경하십시오.

## 3. 데이터로 무엇을 할지 선택

각 측정값을 어떻게 저장하거나 전달할지 결정합니다.

- 파일 기록 — [출력 형식](rhopoint-com-agent-output-formats.md) 참조.
- 값을 다른 애플리케이션에 입력 — [키보드 에뮬레이션](rhopoint-com-agent-keyboard-emulation.md) 참조.

이러한 방식을 조합할 수 있습니다(예: CSV 파일을 기록하면서 *동시에* 평균을 스프레드시트에 입력).

## 4. 캡처 시작

**시작**(오른쪽 상단)을 누르고 기기에서 측정을 수행하십시오. 오른쪽의 활동 로그가 데이터 도착을 확인해 줍니다. 자세한 내용은 [측정값 캡처](rhopoint-com-agent-capturing-measurements.md)를 참조하십시오.

> [!warning] 선택한 COM 포트를 열 수 없는 경우(예: 다른 프로그램이 이미 사용 중인 경우) COM Agent는 오류를 표시합니다. 다른 프로그램을 닫거나 다른 포트를 선택한 후 다시 시도하십시오.

[다음: 출력 형식 선택](rhopoint-com-agent-output-formats.md)


---

# Output Formats

COM Agent는 완료된 각 측정값을 파일로 기록할 수 있습니다. **출력 폴더**를 선택하고 하나 이상의 **출력 형식**을 선택하십시오. 형식은 자유롭게 조합할 수 있습니다.

![](../_images/com-agent-output-formats-ko.png)

## 출력 폴더

*출력 폴더* 옆의 **찾아보기…**를 클릭하여 파일을 기록할 위치를 선택하십시오. 모든 측정값은 타임스탬프가 포함된 고유한 이름의 새 파일을 생성하므로 어떤 것도 덮어쓰여지지 않습니다.

```
2025-10-11T11-03-56Z-00007-3f9c1a2b-….csv
```

이름에는 UTC 타임스탬프, 누적 카운터 및 고유 식별자가 포함됩니다.

## 형식

| 형식 | 생성되는 내용 |
| --- | --- |
| **텍스트 파일 (.txt)** | 기기에서 수신한 그대로의 원시 데이터로, 아무런 처리도 거치지 않습니다. 모든 기기에서 작동합니다. |
| **CSV 파일 (.csv)** | 명명된 열과 미터법 단위를 갖춘 구조화된 스프레드시트 파일입니다. 인식되는 데이터 형식(현재 FT3 *"print all samples"* 두께 형식)이 필요합니다. |
| **키보드 에뮬레이션** | 파일을 기록하는 대신 값을 다른 애플리케이션에 입력합니다 — [키보드 에뮬레이션](rhopoint-com-agent-keyboard-emulation.md) 참조. |

> [!info] 여러 형식을 한 번에 활성화할 수 있습니다. 예를 들어, **텍스트**와 **CSV**를 선택하여 구조화된 파일과 함께 원시 아카이브를 보관하거나, **CSV**와 **키보드**를 선택하여 데이터를 파일로 저장하면서 *동시에* 값을 품질 관리 시스템에 입력할 수 있습니다.

## CSV 내보내기 옵션

![](../_images/com-agent-csv-options-ko.png)

**CSV**가 활성화되면 파일 기록 방식을 제어하는 네 가지 설정이 담긴 **CSV 옵션** 패널이 나타납니다. COM Agent는 사용자의 언어 및 지역에 따라 적절한 기본값을 선택하므로 대부분의 경우 그대로 두어도 됩니다.

| 옵션 | 선택 항목 | 효과 |
| --- | --- | --- |
| **구분 기호** | 쉼표 "," · 세미콜론 ";" · 탭 "→" | 열 사이에 넣는 문자입니다. |
| **시간 형식** | ISO 8601, UTC · ISO 8601, 로컬 | *Timestamp* 열의 형식: UTC(예: `2025-10-11T11:03:56Z`) 또는 오프셋이 포함된 로컬 시간(예: `2025-10-11T13:03:56+02:00`). |
| **소수점 구분 기호** | 마침표 "." · 쉼표 "," | 숫자 값에 사용되는 소수점 기호입니다. 날짜와 식별자는 절대 변경되지 않습니다. |
| **파일 인코딩** | UTF-8 · UTF-8, BOM 포함 | 파일 시작 부분에 바이트 순서 표시(BOM)를 기록할지 여부입니다. BOM은 일부 스프레드시트 프로그램(예: Excel)이 UTF-8을 감지하고 µm 머리글을 올바르게 표시하도록 돕습니다. |

> [!tip] **구분 기호**와 **소수점 구분 기호**는 기본적으로 사용자 지역의 관례를 따릅니다. 목록 값을 세미콜론으로 구분하는 지역(유럽 대부분)은 **세미콜론 + 쉼표 소수점**으로 시작하고, 그 외 지역(예: 영어)은 **쉼표 + 마침표 소수점**으로 시작합니다. 이렇게 하면 로컬 스프레드시트 프로그램에서 더블 클릭으로 파일이 깔끔하게 열립니다. 설정을 변경하면 선택 항목이 기억됩니다.

## CSV 구조

FT3 두께 형식의 경우 COM Agent는 개별 샘플마다 한 행씩, 요약 통계 및 기기 메타데이터와 함께 생성합니다. 단위는 마이크로미터(µm)로 표시됩니다.

| 열 | 예시 | 의미 |
| --- | --- | --- |
| Index | 1 | 세트 내 샘플 번호 |
| Measurement (µm) | 1090.9 | 개별 샘플 측정값 |
| Min (µm) | 1088.4 | 세트의 최소값 |
| Max (µm) | 1090.9 | 세트의 최대값 |
| Mean (µm) | 1089.4 | 세트의 평균 |
| StdDev (µm) | 0.990 | 세트의 표준 편차 |
| Template | 10 | 기기 데이터 형식 |
| Device_ID | FTG38041012H | 기기 일련번호 / ID |
| Test_Date | 2025-10-07 | 시험 날짜(ISO 8601) |
| Calibration_Date | 2025-10-11 | 마지막 교정 날짜 |
| Test_Time | 11:03:56 | 시험 시간 |
| Sample_Count | 5 | 세트 내 샘플 수 |
| Timestamp | 2025-10-11T11:03:56Z | COM Agent가 세트를 수신한 시점으로, 선택한 *시간 형식*으로 표시 |

> [!info] 기기 자체의 *Test_Date* / *Test_Time*은 장치 시계에서 오며 시간대가 없습니다. **Timestamp** 열은 PC가 세트를 수신한 순간이므로 *시간 형식* 옵션(UTC 또는 로컬)을 반영합니다.

> [!info] COM Agent가 구조화된 형식으로 인식하지 못하는 데이터를 수신하면 해당 측정값에 대한 CSV 파일은 건너뛰며 활동 로그에 메모가 표시됩니다. 원시 **TXT** 출력(활성화된 경우)은 형식과 관계없이 항상 기록됩니다.

[다음: 값을 다른 애플리케이션에 입력](rhopoint-com-agent-keyboard-emulation.md)


---

# Keyboard Emulation

키보드 에뮬레이션을 사용하면 COM Agent가 **측정값을 다른 프로그램에 직접 입력**할 수 있습니다 — 마치 사용자가 키보드로 직접 입력한 것과 똑같습니다. 이는 복사하여 붙여넣지 않고도 스프레드시트, 품질 관리 데이터베이스, ERP 화면 또는 기타 모든 애플리케이션에 측정값을 입력하는 데 이상적입니다.

측정이 완료되면 COM Agent는 선택한 값을 **현재 키보드 포커스가 있는 창과 필드**에 입력합니다.

![](../_images/com-agent-keyboard-options-ko.png)

## 활성화

[출력 형식](rhopoint-com-agent-output-formats.md) 아래에서 **키보드 에뮬레이션**을 선택하십시오. 아래에 **키보드 옵션**이 나타납니다.

## 값

입력할 값을 하나 이상 선택하십시오. 기본적으로 **평균**이 선택되어 있습니다.

| 값 | 입력되는 내용 |
| --- | --- |
| **평균** | 측정 세트의 평균 |
| **최소값** | 가장 작은 측정값 |
| **최대값** | 가장 큰 측정값 |
| **표준 편차** | 표준 편차 |
| **측정값** | 모든 개별 샘플 측정값 |
| **원시 데이터** | 기기에서 수신한 전체 원시 데이터 |

여러 값을 선택하면 위에 표시된 순서대로 입력되며, 각 값은 선택한 **구분 기호**로 구분됩니다.

## 구분 기호 및 접미사

| 옵션 | 용도 |
| --- | --- |
| **구분 기호** | 값 *사이*(및 개별 측정값 사이)에 누르는 키입니다. **Tab**, **Enter** 또는 **없음** 중에서 선택하십시오. |
| **접미사** | *마지막* 값 *뒤*에 누르는 키입니다. **Tab**, **Enter** 또는 **없음** 중에서 선택하십시오. |

> [!info] **Tab**을 사용하여 다음 셀이나 필드로 이동하거나, **Enter**를 사용하여 항목을 확인하고 다음 행으로 이동하십시오. 예를 들어, *구분 기호 = Tab*, *접미사 = Enter*로 설정하면 한 행의 셀을 채운 다음 다음 행으로 이동합니다 — 스프레드시트에 완벽합니다.

## 소수점 구분 기호

대상 애플리케이션에 맞게 **소수점 구분 기호**를 설정하십시오 — 일반적으로 영어 로캘의 경우 마침표(`.`), 독일어/프랑스어 로캘의 경우 쉼표(`,`)입니다.

## 키보드 지연

**키보드 지연**은 에뮬레이트된 각 키 입력 후 짧은 일시 정지를 설정합니다.

> [!warning] 입력된 값이 **깨지거나 문자가 반복되어** 도착하면 키보드 지연을 늘리십시오. 일부 애플리케이션과 PC는 삽입된 키 입력을 다른 것보다 더 느리게 받아들입니다. 기본값에서 시작하여 값이 올바르게 나타날 때까지(예: 100 ms까지) 늘리십시오. 이 설정은 PC별로 저장됩니다.

## 예시

**평균**과 **최소값**을 선택하고 *구분 기호 = Tab*, *접미사 = Enter*로 설정한 상태에서 스프레드시트에 입력하면 다음과 같이 생성됩니다.

```
1089.4 ⇥ 1088.4 ⏎
```

평균은 첫 번째 셀에, 최소값은 다음 셀에 들어가고 커서는 다음 행으로 이동합니다 — 다음 측정값을 받을 준비가 됩니다.

> [!info] 키보드 에뮬레이션은 파일을 기록하지 않습니다. 기록을 유지하면서 *동시에* 값을 입력하려면 [출력 형식](rhopoint-com-agent-output-formats.md) 아래에서 **텍스트** 또는 **CSV**도 선택하십시오.

[다음: 측정값 캡처](rhopoint-com-agent-capturing-measurements.md)


---

# Capturing Measurements

[연결](rhopoint-com-agent-connecting-an-instrument.md)을 구성하고 [출력](rhopoint-com-agent-output-formats.md)을 선택했다면 캡처할 준비가 된 것입니다.

## 시작 및 중지

**시작**(오른쪽 상단)을 누르십시오. COM Agent가 직렬 포트를 열고 수신 대기를 시작합니다. 버튼이 **중지**로 바뀝니다. 이를 눌러 세션을 종료하고 포트를 해제하십시오.

캡처가 실행되는 동안 왼쪽의 구성은 세션 도중 변경할 수 없도록 **잠깁니다**.

![](../_images/com-agent-running-ko.png)

## 실시간 패널

오른쪽에는 실시간으로 일어나는 일이 표시됩니다.

| 요소 | 의미 |
| --- | --- |
| **상태 배지** | 시작 전에는 **대기**, 캡처 중에는 **수신 대기 중**, 연결 실패 시 **오류**가 표시됩니다. |
| **수신된 세트** | 이 세션에서 캡처된 완전한 측정값의 누적 수입니다. |
| **마지막 측정값** | 가장 최근 측정값의 평균, 최소값, 최대값 및 표준 편차입니다(인식되는 형식의 경우). |
| **활동 로그** | 이벤트 목록이 스크롤되어 표시됩니다: 데이터 수신, 기록된 파일(전체 경로 포함), 키보드 출력 및 모든 경고. **지우기**를 사용하여 비우십시오. |

## 측정값 받기

1. COM Agent에서 **시작**을 누릅니다.
2. 평소처럼 기기에서 측정을 트리거합니다.
3. 활동 로그에 *"데이터 수신 중…"*이 표시되고 이어서 기록된 각 파일의 경로가 표시되거나, 키보드 에뮬레이션이 활성화된 경우 *"[Keyboard]"* 항목이 표시됩니다.
4. **수신된 세트** 카운터가 증가하고 **마지막 측정값**이 업데이트됩니다.

> [!info] 완료된 각 측정값은 독립적으로 처리되므로 한 세션에서 원하는 만큼 측정할 수 있습니다. 측정값 사이에 중지하고 시작할 필요가 없습니다.

> [!warning] 상태가 **오류**로 바뀌면(예: 케이블이 분리되었거나 기기 전원이 꺼진 경우) 세션을 중지하고 연결을 확인한 후 다시 시작하십시오.

[다음: 기기 없이 사용해 보기](rhopoint-com-agent-demo-mode.md)


---

# Demo Mode

데모 모드를 사용하면 **기기를 연결하지 않고** COM Agent를 사용해 볼 수 있습니다. 직렬 포트에서 읽는 대신 COM Agent는 요청 시 사실적인 데모 측정값을 생성합니다 — 애플리케이션을 익히거나, 출력 폴더 또는 키보드 설정을 테스트하거나, 시연을 할 때 유용합니다.

![](../_images/com-agent-demo-mode-ko.png)

## 데모 모드 사용

1. 연결 섹션에서 **모드**를 **데모**로 설정합니다. COM 포트와 보 레이트 설정이 사라집니다 — 필요하지 않기 때문입니다.
2. 실시간 모드에서와 똑같이 [출력 형식](rhopoint-com-agent-output-formats.md)을 선택하고, 원하는 경우 [키보드 옵션](rhopoint-com-agent-keyboard-emulation.md)을 선택합니다.
3. **시작**을 누릅니다.
4. 어디서든 — 다른 애플리케이션에서도 — **오른쪽 Alt** 키를 눌러 데모 측정값을 삽입합니다.

오른쪽 Alt를 누를 때마다 하나의 완전한 데모 측정값이 생성되며, 실제 측정값과 마찬가지로 출력 설정에 따라 기록되거나 입력됩니다.

> [!info] 데모 모드는 **키보드 에뮬레이션** 설정을 확인하는 가장 빠른 방법입니다: 모드를 데모로 설정하고, 키보드 출력을 활성화하고, 스프레드시트를 클릭한 다음, 시작을 누르고 오른쪽 Alt를 누르십시오 — 값이 셀에 나타납니다.

> [!info] 데모 데이터는 FT3 두께 형식을 사용하므로 CSV 출력 및 모든 키보드 값(평균, 최소값, 최대값, 표준 편차, 측정값)에서 작동합니다.

[다음: 라이선스](rhopoint-com-agent-licensing.md)


---

# Licensing

COM Agent가 기기로부터 **실시간 측정값을 캡처**하려면 유효한 라이선스가 필요합니다. [데모 모드](rhopoint-com-agent-demo-mode.md)는 라이선스 없이도 항상 작동하므로 언제든지 애플리케이션을 살펴보고 출력 및 키보드 설정을 테스트할 수 있습니다.

라이선스 상태는 항상 창의 오른쪽 상단에 표시됩니다.

- 녹색 **활성 라이선스: N** 배지는 실시간 캡처가 활성화되었음을 의미합니다.
- 빨간색 **활성 라이선스 없음** 배지는 데모 모드만 사용할 수 있음을 의미합니다.

![](../_images/com-agent-licence-manager-ko.png)

## 라이선스 작동 방식

COM Agent 라이선스는 다음 두 가지 방식 중 하나로 바인딩할 수 있습니다.

- **이 컴퓨터에(호스트 ID)** — 연결된 모든 기기에 대해 이 PC에서 실시간 캡처를 활성화합니다.
- **장치 일련번호에** — 모든 PC에서 해당 특정 기기로부터 오는 측정값만 활성화합니다. 라이선스가 컴퓨터가 아닌 기기를 따라가야 할 때 사용하십시오.

## 라이선스 요청

1. 오른쪽 상단의 라이선스 배지(또는 **라이선스 추가**)를 클릭하여 **라이선스 관리자**를 엽니다.
2. 옆에 있는 복사 버튼으로 **호스트 ID**를 복사합니다. 장치 바인딩 라이선스의 경우 대신 기기의 일련번호를 기록해 두십시오.
3. 호스트 ID(또는 일련번호)를 Rhopoint Instruments에 보내 라이선스 파일을 받으십시오.

> [!info] 호스트 ID는 이 특정 컴퓨터를 식별합니다. 호스트 바인딩 라이선스는 해당 호스트 ID로 발급된 컴퓨터에서만 실시간 캡처를 활성화합니다.

## 라이선스 가져오기

1. **라이선스 관리자**를 열고 **라이선스 가져오기…**를 클릭합니다.
2. 받은 라이선스 파일(`.lic`, `.txt` 또는 `.json`)을 선택합니다. 여러 파일을 한 번에 선택할 수 있습니다.
3. 라이선스가 목록에 나타나고 배지가 녹색으로 바뀝니다 — 이제 실시간 캡처가 활성화되었습니다.

## 라이선스 관리

라이선스 관리자는 설치된 모든 라이선스를 다음과 함께 나열합니다.

- **무엇에 바인딩되어 있는지** — *이 컴퓨터*, *장치 일련번호: …*, 또는 *모든 컴퓨터*.
- **상태 및 만료일** — 예: *유효함 · 2027-01-31 만료*.

라이선스를 제거하려면 옆에 있는 **휴지통** 아이콘을 사용하십시오.

> [!info] 장치 일련번호에 바인딩된 라이선스는 장치 ID가 일치하는 측정값만 처리합니다. 같은 PC에 연결된 다른 기기는 라이선스가 등록되지 않은 한 무시됩니다.

> [!warning] 유효한 라이선스 없이 실시간 캡처를 위해 **시작**을 누르면 COM Agent는 메시지를 표시하고 시작하지 않습니다. 라이선스를 가져오거나 **모드**를 **데모**로 전환하십시오.

[다음: 설정 및 언어](rhopoint-com-agent-settings-and-language.md)


---

# Settings and Language

## 설정이 기억됩니다

COM Agent는 구성을 자동으로 저장합니다 — 모드, COM 포트, 보 레이트, 파트 마커 및 수, 출력 폴더, 출력 형식 및 모든 키보드 옵션. 다음에 애플리케이션을 시작하면 모든 것이 마지막으로 종료했을 때와 정확히 동일하므로 **시작**만 누르면 됩니다.

설정은 Windows 사용자별로 저장됩니다.

## 언어

COM Agent는 13개 언어로 제공됩니다: **영어**, **체코어**, **독일어**, **스페인어**, **프랑스어**, **이탈리아어**, **네덜란드어**, **폴란드어**, **포르투갈어**, **터키어**, **한국어**, **일본어** 및 **중국어**. 창의 왼쪽 상단 로고 옆에 있는 드롭다운에서 언어를 선택하십시오. 인터페이스가 즉시 전환되며 선택한 언어는 다음에도 기억됩니다.

![](../_images/com-agent-language-ko.png)

[다음: 명령줄 실행](rhopoint-com-agent-command-line-launch.md)


---

# Command-Line Launch

COM Agent는 명령줄에서 미리 구성된 상태로 시작하여 즉시 캡처를 시작할 수 있습니다. 이는 자동화에 유용합니다 — 고정된 구성으로 다른 프로그램, 바탕 화면 바로 가기 또는 시작 스크립트에서 실행하는 경우입니다.

애플리케이션 창은 평소와 같이 열립니다. 매개변수는 단지 설정을 대신 채워주며 캡처가 자동으로 시작됩니다.

```
RhopointComAgent.exe --mode live --port COM3 --output "C:\Data" --file-extension csv+txt
```

## 옵션

옵션 이름은 창의 설정과 일치합니다. 생략한 옵션은 저장된 값을 유지합니다.

| 옵션 | 값 / 예시 | 의미 |
| --- | --- | --- |
| `--mode` | `live` 또는 `demo` | 캡처 모드. `demo`는 COM 포트가 필요 없습니다. |
| `--port` | `COM3` | 직렬 포트(실시간 캡처에 필요). |
| `--baud` | `19200` | 보 레이트. |
| `--part-marker` | `^` | 완전한 측정 세트를 구분하는 마커. |
| `--part-count` | `4` | 완전한 세트를 구성하는 파트 수. |
| `--output` | `"C:\Data"` | TXT/CSV 파일의 출력 폴더. |
| `--file-extension` | `txt`, `csv`, `csv+txt`, `keyboard` | 출력 형식. 여러 개를 `+`로 조합합니다. |
| `--csv-delimiter` | `comma`, `semicolon`, `tab` | CSV 열 구분 기호. |
| `--csv-decimal` | `dot`, `comma` | CSV 숫자의 소수점 구분 기호. |
| `--csv-time-format` | `utc`, `local` | CSV *Timestamp* 열의 형식. |
| `--csv-encoding` | `utf8`, `utf8-bom` | CSV 파일 인코딩(바이트 순서 표시 포함 또는 미포함). |
| `--keyboard-value` | `mean`, `min`, `max`, `stddev`, `measurements`, `raw` | 입력할 값. 여러 개를 `+`로 조합합니다. |
| `--keyboard-separator` | `tab`, `enter`, `none` | 입력된 값 사이에 누르는 키. |
| `--keyboard-suffix` | `tab`, `enter`, `none` | 마지막 값 뒤에 누르는 키. |
| `--keyboard-decimal` | `.` 또는 `,` | 입력된 값의 소수점 구분 기호. |
| `--keyboard-delay` | `40` | 각 키 입력 후 일시 정지(밀리초). |
| `--start` | *(값 없음)* | 다른 매개변수가 없을 때 저장된 설정으로 시작. |

매개변수가 하나라도 주어지면(또는 `--start`만 단독으로 주어지면) 캡처가 자동으로 시작됩니다.

## 예시

COM3에서 CSV 및 TXT 파일로 캡처:

```
RhopointComAgent.exe --port COM3 --output "C:\QA\Thickness" --file-extension csv+txt
```

평균과 최소값을 탭으로 구분하여 포커스가 있는 애플리케이션에 입력:

```
RhopointComAgent.exe --port COM3 --file-extension keyboard --keyboard-value mean+min --keyboard-separator tab
```

데모 모드로 시작(기기 불필요):

```
RhopointComAgent.exe --mode demo --output "C:\Data" --file-extension txt
```

> [!info] 창은 평소처럼 열리므로 실시간 활동을 계속 확인하고 언제든지 캡처를 중지할 수 있습니다. 공백이 포함된 경로는 따옴표로 묶으십시오.

> [!warning] 실시간 캡처에는 여전히 유효한 [라이선스](rhopoint-com-agent-licensing.md)가 필요합니다. 실행 구성이 불완전하거나 유효하지 않은 경우(예: 출력 폴더가 존재하지 않는 경우) COM Agent는 수동 시작에서와 동일한 메시지를 표시합니다.

[다음: COM Agent를 최신 상태로 유지하기](rhopoint-com-agent-updating-com-agent.md)


---

# Updating COM Agent

COM Agent는 자동으로 최신 상태를 유지합니다.

## 자동 업데이트

COM Agent가 시작되면 백그라운드에서 새 버전을 확인합니다. 사용 가능한 버전이 있으면 창의 오른쪽 상단 모서리에 작은 알림이 나타납니다.

![](../_images/com-agent-update-notification-ko.png)

- **지금 업데이트**를 클릭하여 업데이트를 다운로드하고 설치합니다. COM Agent는 새 버전을 다운로드하고 진행률 표시줄을 보여준 다음 새 버전으로 다시 시작됩니다.
- **✕**를 클릭하여 알림을 닫고 현재 버전에서 계속 작업합니다. 다음에 애플리케이션을 시작할 때 다시 알림이 표시됩니다.

> [!info] 업데이트는 선택 사항이며 사용자가 선택할 때에만 적용됩니다. COM Agent는 업데이트를 위해 캡처 세션을 절대 중단하지 않습니다.

## 버전 확인

현재 버전은 창 제목 표시줄에 표시됩니다(예: *Rhopoint COM Agent 1.2.3*).