> For the complete documentation index, see [llms.txt](https://freegrow-1.gitbook.io/product-docs-kr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://freegrow-1.gitbook.io/product-docs-kr/creatorkit_q1/tag/undefined.md).

# 명령어 기반 데이터 읽기/쓰기

이 문서는 시리얼 명령어를 활용해 GrowSpace UWB 태그 장치에서 실시간 거리 및 위치 데이터를 확인하고, 송신 주기 설정을 수행하기 위한 방법을 안내합니다.\
(Tera Term 또는 기타 시리얼 터미널 기반 환경에서 사용)

***

### 적용 대상

* GrowSpace UWB 인적 태그 / 물적 태그
* 개발자 태그

***

### 사용 목적

* 태그의 위치 계산 결과를 실시간으로 확인
* 앵커와의 거리 및 품질 지수 확인
* 송신 주기 조정으로 시스템 반응성 또는 배터리 최적화

***

### 기본 명령어

태그, 리스너, 앵커의 공통 기본 명령어는 아래 링크에서 확인해주세요.

{% embed url="<https://freegrow-1.gitbook.io/product-docs-kr/creatorkit_q1/undefined-1/command>" %}

### 전용 명령어 요약

| 명령어                 | 설명                     |
| ------------------- | ---------------------- |
| `lec`               | 거리 및 위치 정보 출력 (CSV 형식) |
| `lep`               | 위치 정보만 출력 (CSV 형식)     |
| `aurs [nom] [stat]` | 송신 주기 설정 (100ms 단위)    |
| `aurg`              | 현재 송신 주기 확인            |

***

### 명령어 상세 설명

#### ✅ `lec` – 거리 및 위치 정보 출력

**입력 예시**

```
lec
```

**출력 예시**

```
DIST,4,
AN0,365D,-2.92,0.35,0.00,9.22,
AN1,3833,-5.20,15.04,0.00,6.00,
AN2,2FCC,-5.45,2.58,0.00,8.89,
AN3,1027,-1.00,11.48,0.00,3.35,
POS,-3.34,9.49,-1.34,75
```

**항목 설명**

| 항목       | 설명                                  |
| -------- | ----------------------------------- |
| `DIST,4` | 총 4개의 앵커 거리 수신 중                    |
| `ANx`    | 각 앵커의 ID, 좌표(x, y, z), 거리(m)        |
| `POS`    | 태그 위치 좌표(x, y, z), 품질지수(QF: 0\~100) |

* **lec**는 테스트나 디버깅 환경에서 가장 많이 사용되는 명령어입니다.
* 거리 기반 연산 및 품질 상태를 종합적으로 파악할 수 있습니다.

***

#### ✅ `lep` – 위치 정보만 출력

**입력 예시**

```
lep
```

**출력 예시**

```
POS,-3.41,9.54,-1.53,74  
POS,-3.42,9.53,-1.53,73  
POS,-3.40,9.55,-1.55,71  
```

* `POS`: 실시간으로 계산된 태그 위치 좌표
* 마지막 숫자: **품질지수(QF)** – 0\~100 (높을수록 정확)

`lep`는 거리 정보 없이 좌표값만 출력되며,\
**로그 수집**, **대용량 기록** 등에 적합합니다.

***

#### ✅ `aurs [nom] [stat]` – 송신 주기 설정

**입력 예시**

```
aurs 2 5
```

**의미**

| 파라미터     | 설명                 |
| -------- | ------------------ |
| `nom=2`  | 이동 시 200ms마다 위치 송신 |
| `stat=5` | 정지 시 500ms마다 송신    |

* 숫자는 **100ms 단위**로 계산됩니다.\
  (예: `3` → 300ms)

***

#### ✅ `aurg` – 현재 송신 주기 조회

**입력 예시**

```
aurg
```

**출력 예시**

```
aurg: nom=2 stat=5
```

이 명령어를 통해 현재 적용 중인 주기 설정을 확인할 수 있습니다.

***

### 참고사항

* `lec`, `lep` 명령어는 태그가 **3개 이상의 앵커와 연결**된 상태에서 유효한 위치 정보를 출력합니다.
* **송신 주기 설정**은 다음 요소에 영향을 줍니다:
  * **짧은 주기**: 반응 속도↑, 배터리↓
  * **긴 주기**: 배터리↑, 위치 반응↓
* **품질지수(QF)** 가 **60\~80 이상**이면 비교적 안정적인 위치 측위 상태로 간주할 수 있습니다.