> For the complete documentation index, see [llms.txt](https://freegrow-1.gitbook.io/product-docs-en/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://freegrow-1.gitbook.io/product-docs-en/en-creator-kit-q1/uwb-creator-kit-q1-complete-setup-and-usage-guide/advanced-guide-for-anchor/dedicated-commands-apg-aps.md).

# Dedicated Commands  / apg, aps

This document is a guide that summarizes the coordinate query and configuration commands for **GrowSpace fixed anchors** (e.g., GR-ANC-3001, Q1 series) to be used in Tera Term or other serial terminal environments.

Accurate coordinate settings are a critical factor for the precision of the UWB indoor positioning system.

***

### Applicable Devices

* GrowSpace UWB Fixed Anchors (GR-ANC-3001, Q1 series)
* Environments where commands can be entered via serial port (e.g., Windows PC + Tera Term)

***

### Purpose of Use

UWB anchors calculate the tag's location based on the three-dimensional coordinates (x, y, z) of their installed positions. Therefore, it is crucial to input the coordinates of each anchor accurately and verify the current settings.\
This guide focuses on the following two commands:

* `apg`: Query the current coordinates
* `aps x y z`: Set the coordinates

***

### Commands Summary

| Commands    | Functionality                                       |
| ----------- | --------------------------------------------------- |
| `apg`       | Query the current entered coordinates of the anchor |
| `aps x y z` | Manually set new coordinates (unit: mm)             |

Example:

* `aps -2500 3600 1200` → x: -2.5m, y: 3.6m, z: 1.2m

***

### Detailed Command Description

#### ✅ `apg` – Query Current Anchor Coordinates

* **Input Example**

  ```
  apg
  ```
* Output Example

  ```
  apg: x:-2500 y:3600 z:1200 qf:100
  ```
* **Output Field Descriptions**

| Item    | Meaning                                       |
| ------- | --------------------------------------------- |
| x, y, z | **Current Set 3D Coordinates** (Unit: mm)     |
| qf      | **Quality Factor (QF)**, default value is 100 |

> The **`apg`** command is used to check the current coordinates entered for the anchor.\
> Be sure to verify that the installed position is correctly reflected.

***

#### ✅ `aps x y z` – Manually Set Anchor Coordinates

* Input Example

  ```
  aps -2500 3600 1200
  ```
* Interpretation
  * X = -2.5m
  * Y = 3.6m
  * Z = 1.2m
* Output Example

  ```
  aps: ok
  ```

> The **`aps`** command allows you to manually set the **x**, **y**, and **z** coordinates, and the values are saved immediately upon input.\
> Since the changes are applied instantly without needing a separate **save** command, use the **apg** command right after to verify that the values have been correctly applied.

***

### Notes

* All coordinates must be entered in **millimeters (mm)**, and decimal points are not allowed.
  * Example: 2.5m → 2500 / 0.0m → 0
* **Negative coordinates** are also allowed, which is useful if the reference point of the space is not at (0,0).
* The **Z coordinate** must be entered as well, with values typically recommended between **1200mm and 3000mm**.
* Once the anchor’s coordinates are set, ensure that the device is designated as the **Initiator** (reference anchor).

{% hint style="info" %}
For further details, refer to the **Web Configuration Tool** or **Gateway Setup Guide**.
{% endhint %}