> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ones1ght.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 하드웨어 등록

> GeoSpace Mobile 앱에서 현장에 설치한 로케이터를 등록합니다.

하드웨어 등록은 [로케이터 현장 설치](/locator/install)에서 설치하고 전원을 연결한 로케이터를
GeoSpace 서버에 등록될 수 있게 처리하는 과정입니다.
GeoSpace Mobile 앱으로 각 로케이터에 Wi-Fi를 설정하면, 로케이터가 GeoSpace 서버에 접속하고, 서버가 접속된 기기를 인식하여 자동으로 등록합니다.

> [!NOTE]
>
> 본 매뉴얼은 iOS(아이폰) 기준으로 작성되었습니다.

> [!NOTE]
>
> **언제 사용하는지**
>
> * 최초 로케이터 등록
> * 로케이터 Wi-Fi 정보 변경 시 (네트워크 SSID 또는 비밀번호가 바뀐 경우)
> * Wi-Fi 접속이 되지 않아 다시 설정하는 경우 ([트러블슈팅](/locator/troubleshooting#로케이터-하단-led가-자주색과-하늘색으로-깜빡임))

## 1) GeoSpace Mobile 설치 및 로그인

1. 아래 버튼을 눌러 스토어에서 **GeoSpace Mobile** 앱을 설치하고 실행합니다.

[![App Store에서 다운로드 — GeoSpace Mobile iOS 앱](https://mintcdn.com/onecheck/E2whs2uAjcPfu5dJ/images/demo/app-store-badge-ko.svg?fit=max\&auto=format\&n=E2whs2uAjcPfu5dJ\&q=85\&s=fbbb82615c877eb887e92a64b1a25e41)](https://apps.apple.com/kr/app/geospace-mobile/id6795709777)

[![Google Play에서 다운로드 — GeoSpace Mobile Android 앱](https://mintcdn.com/onecheck/E2whs2uAjcPfu5dJ/images/demo/google-play-badge-ko.svg?fit=max\&auto=format\&n=E2whs2uAjcPfu5dJ\&q=85\&s=81d7ed1ae509b51a44168c2b06037e76)](https://play.google.com/store)

![GeoSpace Mobile 로그인 화면 — Google · Apple · Microsoft 계정으로 로그인](https://mintcdn.com/onecheck/jSUe4ZC1WxNcJHaZ/images/geospace/5.hardware-app-login.png?fit=max\&auto=format\&n=jSUe4ZC1WxNcJHaZ\&q=85\&s=1f703743d8aaa146685f5f53721f16a3)

2. 로그인 화면에서 사용 중인 계정으로 로그인합니다.

> [!NOTE]
>
> 로그인하려면 [계정 등록](/locator/onboarding)이 완료되어 있어야 합니다.

## 2) 기기 프로비저닝

![GeoSpace Mobile 홈 화면 — 기기 프로비저닝 메뉴 (AN500 BLE 연결 · Wi-Fi 설정 · 등록)](https://mintcdn.com/onecheck/jSUe4ZC1WxNcJHaZ/images/geospace/5.hardware-app-menu.png?fit=max\&auto=format\&n=jSUe4ZC1WxNcJHaZ\&q=85\&s=140cbc2bf2ff7a54f95316d2207add4e)

홈 화면에서 \[기기 프로비저닝] 메뉴로 진입합니다.
프로비저닝은 화면 상단의 진행 표시(1/6 \~ 6/6)에 따라 순서대로 진행됩니다.

**(1) 주변 기기 검색**

![주변 AN500 검색 화면 — 발견된 기기 4대 목록과 다시 검색 버튼](https://mintcdn.com/onecheck/jSUe4ZC1WxNcJHaZ/images/geospace/5.hardware-app-search.png?fit=max\&auto=format\&n=jSUe4ZC1WxNcJHaZ\&q=85\&s=d2a467e12f2a9e6dd499c5080a7518f3)

\[기기 프로비저닝]에 진입하면 주변의 AN500을 자동으로 검색합니다.
휴대폰의 블루투스와 로케이터의 전원이 켜져 있어야 목록에 표시되므로,
두 가지를 확인한 후 기기 가까이에서 진행합니다.

* 발견된 기기 목록에서 등록할 로케이터를 선택합니다.
  기기 이름의 뒤 4자리(예: AN500:03:64)를 [로케이터 현장 설치](/locator/install)에서
  앞면에 표시한 MAC 주소 뒤 4자리와 대조하여 식별합니다.
* 목록에 기기가 표시되지 않는 경우 \[다시 검색]을 클릭합니다.

**(2) 연결 · 식별**

![연결·식별 중 화면 — AN500과 보안 채널을 설정하는 중](https://mintcdn.com/onecheck/jSUe4ZC1WxNcJHaZ/images/geospace/5.hardware-app-connect.png?fit=max\&auto=format\&n=jSUe4ZC1WxNcJHaZ\&q=85\&s=7c3d0e3934363ad561ed116c0be78e3b)

선택한 로케이터와 보안 채널을 설정합니다. 자동으로 진행되므로 완료될 때까지 기다립니다.

> [!CAUTION]
>
> '연결에 실패했습니다 (장치 응답 시간 초과)'가 표시되며 연결에 실패하는 경우가 있습니다.
>
> ![연결 실패 화면 — 연결에 실패했습니다 (장치 응답 시간 초과) 안내와 발견된 기기 목록, 다시 검색 버튼](https://mintcdn.com/onecheck/qx4EMVAkaVz_Cs2C/images/geospace/5.hardware-app-connect-fail.png?fit=max\&auto=format\&n=qx4EMVAkaVz_Cs2C\&q=85\&s=8683497c713359376c31b8aef743397e)
>
> 이 경우 \[다시 검색]을 클릭해 기기를 다시 검색한 후, 목록에서 해당 로케이터를 선택하여
> 연결될 때까지 반복해서 시도합니다.\\
>
> 단, 재시도할 때는 휴대폰을 로케이터에 최대한 가까이 접촉한 상태로 진행하십시오.

**(3) Wi-Fi 정보 입력**

![Wi-Fi 정보 입력 화면 — 네트워크(SSID)·비밀번호 입력과 설정 전송 버튼](https://mintcdn.com/onecheck/jSUe4ZC1WxNcJHaZ/images/geospace/5.hardware-app-wifi.png?fit=max\&auto=format\&n=jSUe4ZC1WxNcJHaZ\&q=85\&s=c0a5ead32f032a9f33967f6e93b2182e)

로케이터가 사용할 Wi-Fi 네트워크를 설정합니다.

> [!NOTE]
>
> 로케이터의 Wi-Fi는 2.4 GHz 네트워크만 지원합니다. 5 GHz 네트워크는 연결되지 않으므로,
> 2.4 GHz 네트워크의 SSID를 입력합니다.

> [!NOTE]
>
> **현장에 2.4 GHz Wi-Fi가 없어 iPhone 개인용 핫스팟(테더링)을 쓰는 경우**
>
> 1. iPhone 설정 → 개인용 핫스팟을 켭니다.
> 2. 같은 화면의 \*\*\[호환성 최대화]\*\*를 켭니다. 이걸 켜야 핫스팟이 2.4 GHz로 동작합니다.
> 3. Wi-Fi 정보 입력에 네트워크(SSID)는 iPhone 이름, 비밀번호는 핫스팟 화면의 'Wi-Fi 암호'를 입력합니다.
> 4. 핫스팟을 켠 iPhone은 하드웨어 등록과 클러스터 적용이 끝날 때까지 로케이터 근처에 둡니다.

1. 네트워크(SSID)와 비밀번호를 입력합니다.
2. **\[설정 전송]**을 클릭합니다.

> [!CAUTION]
>
> 하단의 \[공장 초기화]는 평소에는 사용하지 않습니다. Wi-Fi를 다시 설정해도 접속되지 않을 때만 사용하며,
> 절차와 초기화 후 조치는 [트러블슈팅](/locator/troubleshooting#wi-fi를-다시-설정해도-로케이터가-접속되지-않음)을 참고합니다.

**(4) 설정 전송**

입력한 Wi-Fi 정보가 로케이터로 전송됩니다. 전송이 완료되면 기기가 자동으로 재부팅됩니다.

* 재부팅까지 약 30초가 소요되며, 완료될 때까지 연결을 끊지 않고 기다립니다.

**(5) 등록**

로케이터를 관리 대상으로 등록하는 과정이 자동으로 진행됩니다. 별도의 조작 없이 짧게 표시된 후 다음 단계로 넘어갑니다.

**(6) 완료**

'완료되었습니다'가 표시되면 해당 로케이터의 프로비저닝이 끝난 것입니다.
프로비저닝을 완료한 로케이터는 GeoSpace의 \[하드웨어 관리] 메뉴에 자동으로 등록됩니다.
나머지 로케이터도 (1) \~ (6) 과정을 반복하여 모두 등록합니다.

## 3) 등록 확인

![GeoSpace 하드웨어 관리 화면 — 프로비저닝으로 등록된 AN-500 4대 목록 (UWB MAC · 네트워크 · 마지막 접속 · 배치 위치)](https://mintcdn.com/onecheck/jSUe4ZC1WxNcJHaZ/images/geospace/5.hardware-console-list.png?fit=max\&auto=format\&n=jSUe4ZC1WxNcJHaZ\&q=85\&s=0c92b7ad07354859b50514eaf655f43d)

GeoSpace의 \[하드웨어 관리] 메뉴에서 등록된 기기를 확인할 수 있습니다.

* 등록한 로케이터가 모두 목록에 표시되는지 확인합니다.
  UWB MAC 주소 뒤 4자리를 로케이터 앞면에 표시한 값과 대조합니다.
* 네트워크(Wi-Fi) 연결 상태와 '마지막 접속' 시각이 표시되는지 확인합니다.
* 로케이터의 상단 LED가 초록, 하단 LED가 파랑(서버 연결 성공)으로 켜져 있는지 확인합니다.
  (LED 위치와 색상별 의미는 [로케이터 현장 설치](/locator/install)의 LED 표 참고)
* '배치 위치'는 아직 배치 전이므로 '미배치'로 표시되며, [측위 기능 활성화](/locator/placement)에서
  도면에 배치하면 채워집니다.

## 체크리스트

> [!NOTE]
>
> 아래 항목이 모두 확인되면 다음 단계로 진행할 수 있습니다.
>
> | # | 확인 항목 | 확인 |
> | - | - | :-: |
> | 1 | 로케이터 4대가 GeoSpace \[하드웨어 관리] 목록에 정상 등록되어 있습니다. | ☐ |
> | 2 | 로케이터 4대의 LED가 정상 상태로 켜져 있습니다. (상단 LED: 초록, 하단 LED: 파랑) | ☐ |
> | 3 | 공장 초기화를 한 로케이터는 \[하드웨어 관리]에서 기존 등록을 삭제한 뒤 다시 프로비저닝했습니다. (해당 시) | ☐ |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.