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

# Applying Firmware OTA

> Update locator firmware remotely (OTA) in GeoSpace and confirm the result.

Firmware OTA updates locator firmware remotely from the \[Settings · Firmware OTA] menu in GeoSpace.
When new firmware is released, apply it with the steps below as guided by your contact.

A locator consists of a main unit (the host) with a UWB module inside, so there are two kinds of firmware.
Upload files are in bin (binary) format.

| Kind                | Upload card     | Target                                                                                                                             | File name                                                                                                                                    |
| ------------------- | --------------- | ---------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| UWB module firmware | UWB Module      | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>All devices (shared UWB module)</span></span> | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>`M01-<version>.bin` (e.g., `M01-005.bin`)</span></span> |
| Host firmware       | Geo Anchor(A01) | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>AN500</span></span>                           | <span style={{display:'flex',alignItems:'baseline',gap:'0.3em'}}><span>·</span><span>`A01-<version>.bin` (e.g., `A01-011.bin`)</span></span> |

* For this manual (AN-500), uploads go to the two cards above (UWB Module and Geo Anchor(A01)).
  The other model cards are not used.
* Update targets are locators that have completed [5. Hardware Registration](/en/geospace/hardware).

<Danger>
  Firmware files are provided by your contact. Do not upload any file other than the one provided.<br />
  If you have not received the file, contact <span className="support-mail">[onesight-support@onecheck.co.kr](mailto:onesight-support@onecheck.co.kr)</span>.
</Danger>

## 1) Updating the Firmware

<Frame>
  <img src="https://mintcdn.com/onecheck/qx4EMVAkaVz_Cs2C/images/geospace/ota-firmware-files.png?fit=max&auto=format&n=qx4EMVAkaVz_Cs2C&q=85&s=1e7ac85c5ddde956200de66732388449" alt="Settings · Firmware OTA screen: entering the menu, attaching a file on the model card, the uploaded file label, the select-targets button, and the new update panel" width="4400" height="2475" data-path="images/geospace/ota-firmware-files.png" />
</Frame>

1. Open the \[Settings · Firmware OTA] menu in GeoSpace.

2. Click the paperclip (attach file) button on the firmware card to update and upload the provided firmware file (bin).
   (See the table above for each card's target and file name.)

3. When the upload completes, the file name and size appear on the card as a label. (e.g., `A01-011` · 124 KB)

4. Click the ⊕ (select targets) button on the card.

5. Confirm the 'New update' panel appears at the bottom of the screen.
   The panel title shows the selected file name and target model (e.g., Target: AN500).

<Frame>
  <img src="https://mintcdn.com/onecheck/qx4EMVAkaVz_Cs2C/images/geospace/ota-target-select.png?fit=max&auto=format&n=qx4EMVAkaVz_Cs2C&q=85&s=be343d61c5f3f11a6a9b6661542196ec" alt="New update panel: building selection cards, device selection list with current versions, and the start update button" width="4400" height="2475" data-path="images/geospace/ota-target-select.png" />
</Frame>

6. Under building selection, select the cards containing the devices to update. (Multiple selection allowed)
   * Building name cards: devices placed on that building and floor. (Only buildings and floors with placed devices are shown.)
   * Unplaced connected devices: devices that are connected but not yet placed on a building or floor.
   * Selecting cards lists the matching locators in the device selection list below.

7. In the device selection list, check the devices to update.
   * 'Current version' shows each device's module and host firmware versions. (e.g., module `M01-004` · host `A01-D10`)
   * If the list does not refresh, click \[Refresh]. You can search by name, MAC, model, version, building, or floor,
     and Shift+click to select a range.

8. Click \[Start Update].
   * Once started, it keeps retrying until stopped; disconnected devices are updated automatically once they connect.

<Frame>
  <img src="https://mintcdn.com/onecheck/qx4EMVAkaVz_Cs2C/images/geospace/ota-progress.png?fit=max&auto=format&n=qx4EMVAkaVz_Cs2C&q=85&s=d742a4b61e604a1f8b07ddf16b97cb50" alt="Update progress screen: the running badge on the firmware card, the hide details button, and the per-device progress list" width="4400" height="2461" data-path="images/geospace/ota-progress.png" />
</Frame>

9. Once the update starts, a 'Running n/N' badge appears on the firmware card.

10. The job panel shows the job number, start time, and counts by state (Completed · In progress · Failed · Disconnected · Waiting).
    Use \[Hide details]/\[Show details] to collapse or expand the per-device progress list.
    * To abort the job, click \[Stop].

11. In the per-device progress list, watch the version change (e.g., `A01-D10` → `A01-011`) and progress (file transfer %)
    and wait until it completes. Completed jobs show as 'Completed' in the job history below.

<Danger>
  While an update is in progress, locator LEDs may blink and positioning may not work smoothly.
  Check positioning after the update completes.
</Danger>

## 2) Confirming the Result

<Frame>
  <img src="https://mintcdn.com/onecheck/qx4EMVAkaVz_Cs2C/images/geospace/ota-hardware-version.png?fit=max&auto=format&n=qx4EMVAkaVz_Cs2C&q=85&s=b3ea9e43ab352e74c2bfa07023bb66bb" alt="Hardware Management screen: device list with the new version shown in the firmware module / host column" width="4400" height="2475" data-path="images/geospace/ota-hardware-version.png" />
</Frame>

In the \[Hardware Management] menu, confirm the updated devices' 'Firmware module / host' column
shows the new version (e.g., `M01-004` / `A01-011`).

* Whether positioning still works properly after the update is confirmed in [8. Verification](/en/geospace/verify).

## Checklist

<Note>
  Once all items below are confirmed, the firmware OTA is complete.

  | # | Item                                                                                              | Check |
  | - | ------------------------------------------------------------------------------------------------- | :---: |
  | 1 | The provided firmware file (bin) is uploaded to the matching card (UWB Module / Geo Anchor(A01)). |   ☐   |
  | 2 | Target devices (locators) are selected and you clicked \[Start Update].                           |   ☐   |
  | 3 | The job shows as 'Completed' in the job history.                                                  |   ☐   |
  | 4 | The devices' firmware versions show the new version in \[Hardware Management].                    |   ☐   |
</Note>