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 coordinatesaps x y z
: Set the coordinates
Commands Summary
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
apg
– Query Current Anchor CoordinatesInput Example
apg
Output Example
apg: x:-2500 y:3600 z:1200 qf:100
Output Field Descriptions
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
aps x y z
– Manually Set Anchor CoordinatesInput 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).
Last updated