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

# 0. Overview

> Scope, notation rules, key terminology, and the overall structure of the mobile positioning infrastructure setup manual.

## 1) Document Information

| Item          | Details                                                                                                                                               |
| ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| Based on      | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>GeoSpace and OneS1ght screens as of September 2026</span></span> |
| Target device | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>AN-500 locator</span></span>                                     |
| Audience      | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>On-site installers and operators</span></span>                   |
| Version       | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>v1.3</span></span>                                               |

**Version History**

| Version | Date       | Main changes                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| ------- | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| v1.3    | 2026-09-22 | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>Added the Applying Firmware OTA document (file registration, target selection, progress and result checks)</span></span><span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>Added retry guidance to Hardware Registration for connection failure (device response timeout)</span></span>                                                                                                                                                                                                                                                 |
| v1.2    | 2026-09-18 | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>Updated for the redesigned verification app (auto-detected positioning, permission guidance, signal-lost screen, event log)</span></span><span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>Added the organization-settings based Geospace integration in OneS1ght and the SDK key issuance and registration steps</span></span><span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>Fully updated Space Management (zone editing): screen layout, zone creation, and zone event settings</span></span> |
| v1.1    | 2026-09-15 | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>Added the Hardware Registration step (provisioning with the GeoSpace Mobile app) and reorganized the manual into 8 steps</span></span><span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>Added entering the actual plan size and verifying it with distance measurement</span></span><span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>Added LED status definitions (top and bottom)</span></span>                                                                                                   |
| v1.0    | 2026-08-21 | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>Initial version (based on screens as of August 2026)</span></span>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |

## 2) Scope and Assumptions

This manual is written with the following assumptions.

* The instructions are based on a setup with 4 locators placed at the corners of the detection area (a space of roughly 15 m × 15 m). If you use more locators or the space has an irregular shape, additional configuration may be required. In that case, contact <span className="support-mail">[onesight-support@onecheck.co.kr](mailto:onesight-support@onecheck.co.kr)</span>.
* This manual covers the downlink method (DL-TDoA) using mobile devices. In the downlink method, mobile devices receive signals sent by the locators and compute their own position.
* The uplink method, which attaches tags to people or assets, uses different equipment and configuration and is not covered in this manual.

## 3) Terminology

| Term                   | Description                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Line of sight (LOS)    | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>A state where signals travel in a straight line between the locator and the receiving device with no obstacles in between</span></span>                                                                                                                                                                                                                              |
| Detection area         | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>The positioning area covered by the locators; positions are measured within this area</span></span>                                                                                                                                                                                                                                                                  |
| Reference direction    | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>The top edge that defines the orientation of the space, used when setting the plan orientation and the coordinate system</span></span>                                                                                                                                                                                                                               |
| Downlink (DL-TDoA)     | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>A method where mobile devices receive signals sent by the locators and compute their own position</span></span>                                                                                                                                                                                                                                                      |
| Plan scaling           | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>Matching distances on the plan image to real-world distances (m)</span></span>                                                                                                                                                                                                                                                                                       |
| Locator                | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>A device mounted on a wall or tripod that transmits UWB signals</span></span>                                                                                                                                                                                                                                                                                        |
| Master locator (INP)   | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>The locator that anchors signal transmission within a cluster</span></span><span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>The master locator transmits first, the remaining locators (RES) follow in a fixed order, and the mobile device computes its position from the arrival-time differences of each signal</span></span> |
| Session ID             | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>A value that identifies a cluster</span></span>                                                                                                                                                                                                                                                                                                                      |
| Simulation mode        | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>A mode for exploring settings and features with a sample floor plan before a partner key is registered</span></span>                                                                                                                                                                                                                                                 |
| Reference point (0, 0) | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>The coordinate origin at the bottom-left corner when facing the reference direction</span></span>                                                                                                                                                                                                                                                                    |
| Offset                 | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>The difference between the conceptual reference point (0, 0) and the coordinates on the plan. Occurs when the plan image includes wall thickness or margins</span></span>                                                                                                                                                                                            |
| Cluster                | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>A unit that groups multiple locators into one transmission group</span></span>                                                                                                                                                                                                                                                                                       |
| Partner key (gpk\_)    | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>An integration key issued in GeoSpace and registered in OneS1ght</span></span>                                                                                                                                                                                                                                                                                       |
| Provisioning           | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>The process of configuring a locator's Wi-Fi with the GeoSpace Mobile app so it connects to and registers with the GeoSpace server</span></span>                                                                                                                                                                                                                     |
| Host                   | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>The locator's main unit. Handles boot, network, and server connection, and runs separate firmware from the internal UWB module</span></span>                                                                                                                                                                                                                         |
| GeoSpace               | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>Software that aligns installed locator positions with building and floor plans, and manages information such as locator coordinates and event areas</span></span><span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>Provides this information for use in the mobile SDK</span></span>                                              |
| OneS1ght               | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>A cloud service that analyzes and utilizes the positioning data collected through GeoSpace</span></span>                                                                                                                                                                                                                                                             |
| SDK key (ock\_sdk\_)   | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>An authentication key used by the SDK in your application when calling the API</span></span>                                                                                                                                                                                                                                                                         |
| Zone                   | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>An area drawn on the plan, used as the basis for enter, exit, and dwell events</span></span>                                                                                                                                                                                                                                                                         |

## 4) Overall Structure

Set up the positioning infrastructure in the following order. Each step assumes the previous step is complete.

| Step                                                        | Description                                                                                     | Environment         |
| ----------------------------------------------------------- | ----------------------------------------------------------------------------------------------- | ------------------- |
| [1. Pre-Installation Preparation](/en/geospace/site-survey) | Check the site and prepare the plan and supplies                                                | On-site             |
| [2. Account Registration](/en/geospace/onboarding)          | Register users and check the license                                                            | GeoSpace            |
| [3. Space Registration](/en/geospace/spaces)                | Register the building and floors, set up the plan                                               | GeoSpace            |
| [4. On-Site Locator Installation](/en/geospace/install)     | Install the locators on-site and connect power                                                  | On-site             |
| [5. Hardware Registration](/en/geospace/hardware)           | Register the locators in GeoSpace as assets                                                     | On-site · GeoSpace  |
| [6. Activating Positioning](/en/geospace/placement)         | Measure installation positions, apply them to the plan, and configure the locators as a cluster | On-site · GeoSpace  |
| [7. Positioning Data Integration](/en/geospace/connect)     | Register in OneS1ght and integrate positioning data                                             | GeoSpace · OneS1ght |
| [8. Verification](/en/geospace/verify)                      | Confirm everything works                                                                        | On-site             |

For problems during installation or operation, see [Troubleshooting](/en/troubleshooting), organized by symptom.
When new firmware is released, see [Applying Firmware OTA](/en/geospace/firmware-ota) for how to apply it.