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

이 문서는 시리얼 명령어를 활용해 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: 좌표 설정

---

기본 명령어

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

기본 명령어(command) | UWB Creator Kit Q1 | Growspace Manualfreegrow-1.gitbook.io

전용 명령어 요약

명령어	기능
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)로 지정되었는지도 함께 확인하세요.

웹 설정 도구 또는 게이트웨이 설정 가이드 참고