> ## 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.

# 로케이터 현장 설치

> 현장에서 지정된 위치에 로케이터를 설치하고 전원을 연결한 뒤, LED로 Wi-Fi 접속을 확인하고 OneS1ght 지원팀에 알립니다.

## 1) 로케이터 현장 설치

<Frame>
  <img src="https://mintcdn.com/onecheck/v-NNoPHtuKTLba-D/images/geospace/4.install-anchor-front-label.svg?fit=max&auto=format&n=v-NNoPHtuKTLba-D&q=85&s=608f0d38304cf9b587be53f05f4f6e18" alt="AN-500 앞면과 뒷면 — 뒷면 MAC 뒤 4자리를 앞면 라벨로 옮겨 적는 방법" width="960" height="600" data-path="images/geospace/4.install-anchor-front-label.svg" />
</Frame>

1. **라벨 표시**
   * 뒷면 라벨의 UWB MAC 주소 뒤 4자리를 읽어, 로케이터 앞면에 마스킹테이프로 표시합니다.
   * 설치 후에는 뒷면 라벨을 확인할 수 없으므로 설치 전에 표시합니다.
     뒷면 라벨의 S/N과 UWB MAC 주소는 [5. 하드웨어 등록](/geospace/hardware)에서 사용하므로,
     설치 전에 라벨을 촬영해 둡니다.
   * 각 모서리에 배치된 로케이터를 쉽게 식별할 수 있으며, [6. 측위 기능 활성화](/geospace/placement)의
     도면 배치에서 어느 모서리가 어느 로케이터인지 대조할 때 사용합니다.
   * 앞면에 식별 정보가 부착된 상태로 배송된 경우에는 기존 표시를 그대로 사용합니다.

<Frame>
  <img src="https://mintcdn.com/onecheck/v-NNoPHtuKTLba-D/images/geospace/4.install-anchor-wall-mount.svg?fit=max&auto=format&n=v-NNoPHtuKTLba-D&q=85&s=12d1eb8494eb9d75f0377df3f3538688" alt="벽면 부착과 삼각대 거치 비교 그림 — 설치 높이, 로케이터 방향, 케이블 정리, 금속 이격" width="1200" height="660" data-path="images/geospace/4.install-anchor-wall-mount.svg" />
</Frame>

설치 방식은 벽면 부착(상설 설치용)과 삼각대 거치(임시·데모용) 두 가지입니다.
로케이터의 앞면 방향, 케이블 단자 아래 방향, 금속 이격 기준은 두 방식에 동일하게 적용됩니다.

<Danger>
  금속 재질의 물체는 측위 신호에 영향을 줄 수 있으므로, 로케이터를 금속 재질의 물체(예: 선반, 기둥, 냉장 설비 등)와 가까운 위치에 설치하지 마십시오.
  로케이터와 금속 재질의 물체 사이에는 최소 0.5 m 이상의 거리를 확보해야 합니다.
</Danger>

2. **로케이터 부착**

   * 감지 영역의 네 모서리에 로케이터를 설치합니다.
   * 설치 높이는 2.4\~3 m를 권장하며, 3 m에 가까울수록 유리합니다. 최소 설치 높이는 2 m 이상입니다.

   **벽면 부착 — 상설 설치용**

   * 양면테이프를 사용하여 바닥에서 2.4\~3 m 높이의 벽면에 로케이터를 고정합니다.
   * LED 표시창이 매장 안쪽을 향하고, 케이블 단자가 아래쪽을 향하도록 세로로 설치합니다.
   * 로케이터의 뒷면(S/N 라벨 면)이 벽면에 닿도록 설치합니다.
   * 벽 모서리에 설치하는 경우 모서리에 최대한 가깝게 배치합니다.
   * 임대 공간의 경우 벽면 훼손 가능 여부를 사전에 확인합니다.

   **삼각대 거치 — 임시·데모용**

   * 벽면 훼손 없이 설치할 수 있어 데모 및 임시 설치에 적합합니다.
   * 책상 위에 설치하는 경우에도 로케이터 높이를 2 m 이상 확보합니다.

3. **전원 연결**
   * 각 로케이터에 USB-C 전원(5V/3A)을 연결합니다. 바닥을 지나는 전선은 종이테이프로 고정하여 케이블 걸림 및 이탈을 방지합니다.
   * 전원을 연결하면 로케이터 전면의 LED 두 개가 흰색으로 점등된 후, 부팅 상태에 따라 색상이 변경됩니다.
     장치의 상단과 하단에 각각 LED가 있으며, 상단 LED는 UWB 초기화 상태를,
     하단 LED는 장치의 부팅·네트워크·서버 연결 및 데이터 전송 상태를 표시합니다.
     색상별 상태 및 의미는 아래 이미지와 표를 참고합니다.

<Frame>
  <img src="https://mintcdn.com/onecheck/jSUe4ZC1WxNcJHaZ/images/geospace/4.install-anchor-led-status.svg?fit=max&auto=format&n=jSUe4ZC1WxNcJHaZ&q=85&s=5a2f7f4bde9873e4e66b399d9eaff957" alt="AN-500 LED 위치와 상태 — 위쪽 UWB LED와 아래쪽 상태 LED, 전원 연결 직후의 부팅 색 변화와 하드웨어 등록 완료 후의 정상 상태" width="1000" height="570" data-path="images/geospace/4.install-anchor-led-status.svg" />
</Frame>

**상단 LED**

| 표시 | 의미 |
| - | - |
| <span style={{display:'inline-block',width:'0.8em',height:'0.8em',borderRadius:'50%',background:'#FFFFFF',border:'1px solid rgba(128,128,128,0.55)',verticalAlign:'-0.08em',marginRight:'0.45em'}} />흰색 켜짐 | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>초기 부팅</span></span> |
| <span style={{display:'inline-block',width:'0.8em',height:'0.8em',borderRadius:'50%',background:'#FDD835',border:'1px solid rgba(128,128,128,0.35)',verticalAlign:'-0.08em',marginRight:'0.45em'}} />노랑 깜빡 | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>장치 초기화 중</span></span> |
| <span style={{display:'inline-block',width:'0.8em',height:'0.8em',borderRadius:'50%',background:'#43A047',border:'1px solid rgba(128,128,128,0.35)',verticalAlign:'-0.08em',marginRight:'0.45em'}} />초록 켜짐 | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>장치 초기화 성공</span></span> |
| <span style={{display:'inline-block',width:'0.8em',height:'0.8em',borderRadius:'50%',background:'#E040FB',border:'1px solid rgba(128,128,128,0.35)',verticalAlign:'-0.08em',marginRight:'0.45em'}} />자주색(마젠타) 깜빡 | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>UWB 초기화 실패</span></span> |

**하단 LED**

| 표시 | 의미 |
| - | - |
| <span style={{display:'inline-block',width:'0.8em',height:'0.8em',borderRadius:'50%',background:'#FFFFFF',border:'1px solid rgba(128,128,128,0.55)',verticalAlign:'-0.08em',marginRight:'0.45em'}} />흰색 켜짐 | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>초기 부팅</span></span> |
| <span style={{display:'inline-block',width:'0.8em',height:'0.8em',borderRadius:'50%',background:'#FFFFFF',border:'1px solid rgba(128,128,128,0.55)',verticalAlign:'-0.08em',marginRight:'0.45em'}} />흰색 깜빡 | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>초기 부팅 중 FW 업데이트</span></span> |
| <span style={{display:'inline-block',width:'0.8em',height:'0.8em',borderRadius:'50%',background:'#E53935',border:'1px solid rgba(128,128,128,0.35)',verticalAlign:'-0.08em',marginRight:'0.45em'}} />빨강 켜짐 | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>장치 오류</span></span> |
| <span style={{display:'inline-block',width:'0.8em',height:'0.8em',borderRadius:'50%',background:'#E53935',border:'1px solid rgba(128,128,128,0.35)',verticalAlign:'-0.08em',marginRight:'0.45em'}} />빨강 깜빡 (2초간) | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>재부팅</span></span> |
| <span style={{display:'inline-block',width:'0.8em',height:'0.8em',borderRadius:'50%',background:'#FDD835',border:'1px solid rgba(128,128,128,0.35)',verticalAlign:'-0.08em',marginRight:'0.45em'}} />노랑 켜짐 | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>USB(uart) 연결 성공</span></span> |
| <span style={{display:'inline-block',width:'0.8em',height:'0.8em',borderRadius:'50%',background:'#E040FB',border:'1px solid rgba(128,128,128,0.35)',verticalAlign:'-0.08em',marginRight:'0.45em'}} /><span style={{display:'inline-block',width:'0.8em',height:'0.8em',borderRadius:'50%',background:'#00BCD4',border:'1px solid rgba(128,128,128,0.35)',verticalAlign:'-0.08em',marginRight:'0.45em'}} />자주색(마젠타)·하늘색(시안) 번갈아 깜빡 | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>네트워크 IP 할당 대기</span></span> |
| <span style={{display:'inline-block',width:'0.8em',height:'0.8em',borderRadius:'50%',background:'#00BCD4',border:'1px solid rgba(128,128,128,0.35)',verticalAlign:'-0.08em',marginRight:'0.45em'}} />하늘색 깜빡 | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>네트워크 IP 할당 성공</span></span> |
| <span style={{display:'inline-block',width:'0.8em',height:'0.8em',borderRadius:'50%',background:'#1E88E5',border:'1px solid rgba(128,128,128,0.35)',verticalAlign:'-0.08em',marginRight:'0.45em'}} />파랑 켜짐 | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>서버 연결 성공</span></span> |
| <span style={{display:'inline-block',width:'0.8em',height:'0.8em',borderRadius:'50%',background:'#1E88E5',border:'1px solid rgba(128,128,128,0.35)',verticalAlign:'-0.08em',marginRight:'0.45em'}} />파랑 깜빡 | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>데이터 전송 중</span></span> |
| <span style={{display:'inline-block',width:'0.8em',height:'0.8em',borderRadius:'50%',background:'#E040FB',border:'1px solid rgba(128,128,128,0.35)',verticalAlign:'-0.08em',marginRight:'0.45em'}} />자주색만 깜빡 | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>공장 초기화 진행 중 (\[공장 초기화] 실행 시에만 표시)</span></span> |

<small>출처: Geoplan LED Default Scenario (protocol V1.8 draft, 2026-09)</small>

<Info>
  **현장에서 보이는 상태**<br />
  로케이터는 전달해 주신 Wi-Fi 정보로 미리 등록되어 있으므로, 전원을 연결하면 잠시 후 상단 초록, 하단 파랑(서버 연결 성공)이 되는 것이 정상입니다.

  * 하단이 자주색·하늘색으로 번갈아 깜빡임: 등록된 Wi-Fi에 접속하지 못하는 상태입니다. 전달한 SSID·비밀번호가 현장 Wi-Fi와 같은지, 2.4 GHz인지 확인하고, 같은데도 계속되면 OneS1ght 지원팀에 문의합니다.
  * 하단 노랑: 로케이터가 등록되지 않은 상태 (Wi-Fi 설정 전)입니다. OneS1ght 지원팀에 문의합니다.
</Info>

* 실제 측위 동작 여부는 OneS1ght 지원팀이 배치 및 클러스터 설정을 완료한 후 [동작 검증](/geospace-quickstart/verify)에서 확인합니다.

## 2) OneS1ght 지원팀에 알리기

로케이터 4대의 하단 LED가 모두 파랑이면 OneS1ght 지원팀(<span className="support-mail">[onesight-support@onecheck.co.kr](mailto:onesight-support@onecheck.co.kr)</span>)에 알립니다. OneS1ght 지원팀이 로케이터 배치, 클러스터 적용, OneS1ght 연동을 진행한 뒤 '구축 완료'를 안내합니다.

<Info>
  '구축 완료' 안내를 받을 때까지 로케이터의 전원과 Wi-Fi를 켜 둡니다.
  구축 완료 뒤에는 Wi-Fi가 끊겨 하단 LED가 깜빡여도 측위는 계속 동작합니다.
</Info>

## 체크리스트

<Note>
  아래 항목이 모두 확인되면 다음 단계로 진행할 수 있습니다.

  | # | 확인 항목 | 확인 |
  | - | - | :-: |
  | 1 | 로케이터 앞면에 MAC 주소 뒤 4자리를 표시했습니다. | ☐ |
  | 2 | 뒷면 라벨(S/N · UWB MAC)을 촬영해 두었습니다. | ☐ |
  | 3 | 설치한 로케이터 4대의 LED가 모두 정상 상태로 켜져 있습니다.<br />(상단 LED: 초록, 하단 LED: 파랑) | ☐ |
  | 4 | OneS1ght 지원팀에 설치 완료를 알렸습니다. | ☐ |
</Note>

전체 매뉴얼: [4. 로케이터 현장 설치](/geospace/install)


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