> 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/anchor/undefined.md). # 명령어 기반 데이터 읽기/쓰기 이 문서는 시리얼 명령어를 활용해 GrowSpace UWB 앵커 장치에서 좌표 조회 및 설정 방법을 안내합니다.\ 정확한 좌표 설정은 UWB 실내 위치 측위 시스템의 정확도에 매우 중요한 요소입니다. (Tera Term 또는 기타 시리얼 터미널 기반 환경에서 사용) *** ### 적용 대상 * GrowSpace UWB 고정형 앵커 (GR-ANC-3001, Q1 시리즈) * 시리얼 포트를 통해 명령어 입력이 가능한 환경 (Windows PC + Tera Term 등) *** ### 사용 목적 UWB 앵커는 설치된 위치의 **3차원 좌표(x, y, z)** 를 기반으로 태그의 위치를 계산합니다.\ 따라서 각 앵커의 좌표를 정확하게 입력하고, 현재 설정된 값을 점검하는 과정이 필요합니다.\ 이 가이드는 다음 두 가지 명령어를 중심으로 설명합니다: * `apg`: 현재 좌표 조회 * `aps x y z`: 좌표 설정 *** ### 기본 명령어 태그, 리스너, 앵커의 공통 기본 명령어는 아래 링크에서 확인해주세요. {% embed url="" %} ### 전용 명령어 요약 | 명령어 | 기능 | | ----------- | ---------------------------- | | `apg` | 현재 입력된 앵커 좌표를 조회 | | `aps x y z` | 새로운 좌표를 수동으로 설정 (단위: **mm**) | 예시: * `aps -2500 3600 1200` → x: -2.5m, y: 3.6m, z: 1.2m *** ### 명령어 상세 설명 #### ✅ `apg` – 현재 앵커 좌표 조회 * **입력 예시** ``` apg ``` * **출력 예시** ``` apg: x:-2500 y:3600 z:1200 qf:100 ``` * **출력 항목 설명** | 항목 | 의미 | | ------- | -------------------------------- | | x, y, z | 현재 설정된 3차원 좌표 (단위: mm) | | qf | Quality Factor (품질 지수), 기본값은 100 | > `apg` 명령어는 현재 앵커에 입력되어 있는 좌표값을 확인할 때 사용합니다.\ > 설치된 위치가 정확히 반영되어 있는지 반드시 점검하세요. *** #### ✅ `aps x y z` – 앵커 위치 수동 설정 * **입력 예시** ``` aps -2500 3600 1200 ``` * **해석** * X = -2.5m * Y = 3.6m * Z = 1.2m * **출력 예시** ``` aps: ok ``` > `aps` 명령어는 x, y, z 좌표를 수동으로 설정할 수 있으며, **입력 즉시 저장됩니다**.\ > 별도의 save 명령 없이 반영되므로, 설정 직후 `apg` 명령어로 값이 정확히 적용되었는지 확인하세요. *** ### 참고사항 * **모든 좌표는 밀리미터(mm)** 단위로 입력해야 하며, **소수점은 허용되지 않습니다**. * 예: 2.5m → `2500` / 0.0m → `0` * **음수 좌표도 입력 가능**합니다. 공간 기준점이 (0,0)이 아닌 경우 유용합니다. * **Z 좌표**도 반드시 입력해야 하며, 일반적으로 **1200 \~ 3000mm** 사이 값을 권장합니다. * 앵커의 좌표 설정이 완료되면, 해당 장치가 기준 앵커(Initiator)로 지정되었는지도 함께 확인하세요. {% hint style="info" %} 웹 설정 도구 또는 게이트웨이 설정 가이드 참고 {% endhint %}