앱 실행 및 UWB 거리 측정

본 문서는 GrowSpace 모바일 앱을 이용해 스마트폰 단말을 통한 UWB 거리 측정 및 RTLS 기반 실내 위치 추정을 테스트하는 방법을 안내합니다.
앵커 설치가 완료된 상태에서 본 문서의 절차에 따라 앱 실행 및 측정 기능을 검증할 수 있습니다.

---

앱 실행 및 기능 구성

GrowSpace Mobile 앱을 실행하면 다음과 같은 초기 화면이 표시됩니다.

---

Check azimuth, elevation

해당 메뉴는 스마트폰이 UWB 신호를 기반으로 방위각(Azimuth) 및 고도각(Elevation) 정보를 수신할 수 있는지 확인하기 위한 기능입니다.

사용 목적

• 사용 중인 스마트폰 기종이 UWB 각도 측정을 지원하는지 확인
• 측정 환경(거리, 방향)에 따라 감지 성능 차이 확인
• RTLS 보정 전, 각도 기반 정보 활용 가능 여부 판단

사용 절차

1. 앱 메인 화면에서 [Check azimuth, elevation] 버튼 선택
2. 주변 앵커가 감지되면 거리 및 방향값(Azimuth, Elevation) 출력
3. 감지된 디바이스의 BLE 이름, 거리(m), 각도(°) 값 확인

⚠️ 일부 Galaxy S24+ 시리즈 및 특정 iPhone 모델은 해당 기능이 제한될 수 있습니다.
실제 측정 가능 여부는 기기 제조사 또는 테스트 환경에 따라 다릅니다.

---

거리 측정 (Ranging Page)

앵커와의 거리를 실시간으로 측정하고 연결 상태를 확인할 수 있습니다.

설정 항목

항목	설명
maximum connections	N1 앵커 1대에 스마트폰 연결은 최대 5대까지 가능합니다. iOS 휴대폰에는 최대 6대의 N1 앵커를 연결 가능합니다. Android 휴대폰에는 최대 5대의 N1 앵커를 연결 가능합니다.
automatic deletion time (초)	응답 지연 시 자동 해제 시간
maximum connection distance (m)	연결 허용 최대 거리
RSSI 우선 연결	신호 강도가 높은 순으로 연결 시도 (기본 활성화)

실행 절차

1. Ranging Page 이동
2. 설정값 확인 후 Start 버튼 클릭
3. 연결된 앵커의 거리 정보가 실시간 출력
4. 테스트 종료 시 Stop 버튼 클릭

연결 실패 시: LED 점등 여부, USB 전원, 설치 간격을 확인하세요.

---

위치 추정 (RTLS Page)

앵커의 좌표 데이터를 기반으로 단말의 x, y 좌표 위치를 실시간으로 계산합니다.

RTLS 조건

• 실시간 연결된 앵커 3개 이상 필요
• BLE 이름 기준의 정확한 좌표 매핑 필수
  • 예: "FGU-0001" → (0.0, 0.0)

절차

1. RTLS Page 진입
2. 연결된 앵커 거리 정보를 기반으로 위치 자동 계산
3. 결과는 앱 화면 또는 로그로 표시됨

문제 발생 시 점검 사항

증상	점검 항목
장치 미감지	BLE/UWB 권한, USB 전원, LED 상태
거리 측정 불안정	금속 간섭, 설치 거리 6~8m 권장
RTLS 불일치	좌표 등록 오류, 앵커 수 부족, BLE 광고명 불일치

테스트 완료 후

모든 기능이 정상 작동하면 SDK를 활용한 커스텀 연동이나
앵커 좌표 설정 고도화를 통해 실제 서비스 적용 환경으로 확장할 수 있습니다.