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

For further details, refer to the Web Configuration Tool or Gateway Setup Guide.

Last updated