> For the complete documentation index, see [llms.txt](https://docs.optitrack.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.optitrack.com/activeio/activeio-hardware/activeio-square.md).

# ActiveIO Square

## Overview

The high-powered ActiveIO Square uses ActiveIO technology for more efficient and accurate calibrations. Unlike classic calibration squares, which contain passive markers that reflect light back to the camera, the ActiveIO square has LED markers that emit light rather than reflecting it, making it ideal for calibrating large volumes and systems with SlimX cameras. 

The ActiveIO Square includes features such as [Edge Locators](#set-the-edge-locators) for calibrating force plates and built-in [leveling tools](#level-the-square) to ensure accuracy of the ground plane. 

<figure><img src="/files/19I09g9WN8kRodYPPfFx" alt="An ActiveIO Square in the Open position. "><figcaption></figcaption></figure>

Please consult our [ActiveIO Configuration](/activeio/activeio-configuration.md) page for more information on configuring and working with ActiveIO devices. &#x20;

## Quick Start Guide

### Requirements

* [ActiveIO BaseStation](/activeio/activeio-hardware/activeio-basestation.md)
* Motive 3.5 or higher

## Control Panel

The control panel for the ActiveIO Square is located on the X-axis of the device.&#x20;

<figure><img src="/files/nVUVVekRxahBrNVmF8ja" alt="Photo of the ActiveIO Square control panel and level."><figcaption></figcaption></figure>

### Power

The ActiveIO Square is powered by an internal battery that allows for 15W USB fast charging. The device ships with a USB-C cable. Charge the device before first use.&#x20;

<figure><img src="/files/FbsNoXThuWyASiGI8tVT" alt="A technical drawing of the ActiveIO Square control panel, with the USB-C slot highlighted. "><figcaption><p>The USB-C charging slot on the ActiveIO Square. </p></figcaption></figure>

To power the device on or off, press the Power button. Once the device is powered on, it will be available in Motive.&#x20;

<figure><img src="/files/4ohUKV3q6P41SGTdqaCd" alt="A technical drawing of the ActiveIO Square control panel, with the power button highlighted. "><figcaption><p>The Power button on the ActiveIO Square.</p></figcaption></figure>

{% hint style="info" %}

#### Power-Saving Mode

The LEDs turn off if the square sits idle for several minutes, to prevent the battery from draining in between uses.&#x20;

If the device is on but the markers are not visible in Motive, pick it up or move it to turn the LEDs back on. &#x20;
{% endhint %}

### Sync Modes

The ActiveIO Square has two operating modes, Sync and Always On. The switch on the control panel allows you to change the mode when the device is not connected to to an ActiveIO BaseStation.&#x20;

<figure><img src="/files/6dPbNTiHqhadkUinQi3r" alt="A technical drawing of the ActiveIO Square control panel, with the sync switch highlighted. "><figcaption><p>The Sync switch on the ActiveIO Square.</p></figcaption></figure>

{% hint style="info" %}
When connected to an ActiveIO BaseStation, the control panel switch will remain in Sync mode, even when the marker state in Motive is set to Always On mode.&#x20;
{% endhint %}

#### Sync

In Sync mode, the ActiveIO Square is synced with an ActiveIO BaseStation. In this state, the Infrared marker LEDs flash in sync with the camera exposures. This allows the IR markers to be as bright and as visible as possible, while reducing battery power consumption.&#x20;

The middle LED indicator light flashes blue when in this mode.

#### Continuous

In Continuous mode, the IR LEDs emit constant light with no blinking and are not synced with the camera exposure. This mode does not require an ActiveIO BaseStation. The markers may appear dimmer to the cameras and battery life will be reduced when compared to Sync mode.&#x20;

The middle LED indicator light is solid green in this mode.

### Indicator Lights

The ActiveIO Square has three indicator lights on the control panel.&#x20;

#### Power

The left LED (the lightning bolt symbol) indicates battery strength and charging.

<figure><img src="/files/GrUEU8xaHKlRgjhX1fTe" alt="A technical drawing of the ActiveIO Square control panel, with the Power Indicator light highlighted. "><figcaption><p>The Power indicator light on the ActiveIO Square.</p></figcaption></figure>

* Solid blue: battery power is good.
* Solid orange: the battery is low and should be charged.&#x20;
* Blinking red: the battery is critically low and needs to be charged. The IR LEDs are disabled in this state.&#x20;
* Blinking green: the battery is charging.
* Solid green: the device is fully charged.

{% hint style="info" %}
The light flashes red if a charging error occurs. Disconnect and reconnect the device if this happens. If the problem persists, [contact Support](https://optitrack.com/support#create-new-support-ticket).&#x20;
{% endhint %}

#### Sync State

The middle LED (the light emitting dome symbol) indicates which sync mode the device is in.&#x20;

<figure><img src="/files/ZnekswCpqsfq9GTLYSrt" alt="A technical drawing of the ActiveIO Square control panel, with the Sync State Indicator light highlighted. "><figcaption><p>The Sync state indicator light on the ActiveIO Square.</p></figcaption></figure>

* Blinking blue: the ActiveIO Square is in sync mode.
* Blinking green: the device is scanning.
* Solid green: the device is in Continuous mode

#### IMU&#x20;

The right LED (the gyro symbol) is disabled on the ActiveIO Square.

<figure><img src="/files/cEhRBm5LH2gWhhcnP5ak" alt="A technical drawing of the ActiveIO Square control panel, with the IMU State Indicator light highlighted. "><figcaption></figcaption></figure>

{% hint style="info" %}

#### Firmware Updates

Every time the ActiveIO Square connects to a new instance of Motive, the system does a firmware check and updates the device to the applicable firmware for the version of Motive. All three indicator lights will cycle through the rainbow during a firmware update. &#x20;
{% endhint %}

## Edge Locators

The ActiveIO Square has an Edge Locator at each marker point to use when calibrating a 90° degree object, such as a force plate.&#x20;

<figure><img src="/files/7CXTPLTorIA3VBEEdP6l" alt="The ActiveIO Square end marker, with the Edge Flag highlighted in blue. " width="283"><figcaption><p>The Edge Locator on an end marker <br>on the ActiveIO Square. <br>Blue coloring for illustration purposes only. </p></figcaption></figure>

* Loosen the thumb screw and lower the Edge Locator.
* Place the ActiveIO Square on the right corner of the device, with the Edge Locator flush against the perpendicular edge, in contact with the ground.&#x20;
* After adjusting the Edge Locators, the ActiveIO Square may need to be leveled.&#x20;

<figure><img src="/files/Nuh6IIHQ1R32IRvYNbo8" alt="A technical drawing of the Edge Locator in both the down and up positions."><figcaption></figcaption></figure>

Please see the [Force Plate Setup](/movement-sciences/movement-sciences-hardware/general-motive-force-plate-setup.md) page for more details on calibrating a Force Plate.&#x20;

## Level the Square

The ActiveIO Square includes a built-in level on each axis.&#x20;

<figure><img src="/files/nbbgovST3mv5zGueiKmW" alt="The Control panel and level for the OptiTrack ActiveIO Square. The square is not level."><figcaption></figcaption></figure>

If the device is not horizontally level (as shown in the image, above), turn the adjustment knobs on each end of the device until the level's bubble is centered.&#x20;

<figure><img src="/files/u1WTm6PEI8X22fpfuOKM" alt="The ActiveIO Square end marker, with the leveling knob highlighted in blue. "><figcaption><p>A Leveling Knob on the ActiveIO Square. <br>Blue coloring for illustration purposes only. </p></figcaption></figure>

<figure><img src="/files/Xo7dJNaQfXcTFlsXAkHW" alt="The Control panel and level for the OptiTrack ActiveIO Square. The square is now level."><figcaption><p>The level ActiveIO Square.</p></figcaption></figure>

## Motive Setup

The first time Motive detects the ActiveIO Square, it appears in the [Devices pane](/motive-ui-panes/devices-pane.md) in an Advertising state. Right-click to claim it and make it available for use in that instance of Motive. Select it to view the Device properties.&#x20;

{% hint style="info" %}

#### Using the Square with Multiple Instances of Motive

Once claimed, the ActiveIO Square will remain available in that version of Motive. You must release the device first to claim it in another instance of Motive.&#x20;

* Within Motive, Right-click the device in the Devices pane and select *Release*.&#x20;
* On the device, triple-click the power button to release it from the system.

See the page [ActiveIO Configuration](/activeio/activeio-configuration.md) for more detail on connecting and configuring ActiveIO devices. &#x20;
{% endhint %}

When powered on in Sync mode, the ActiveIO Square connects to Motive through an ActiveIO BaseStation.&#x20;

<figure><img src="/files/TFriQk42965DaMkGspnw" alt="A screenshot of the Motive Properties and Devices pane, with the ActiveIO Square selected, and Standard properties displayed. "><figcaption><p>The ActiveIO Square Basic Properties when the Square is in Sync (ActiveIO) mode. </p></figcaption></figure>

When powered on in Always On mode, the ActiveIO Square will appear in the Devices pane, with fewer editable properties.&#x20;

<figure><img src="/files/lsyLzphAXJfnenQpIFC7" alt="A screenshot of the Motive Properties and Devices pane, with the ActiveIO Square selected, and Advanced properties displayed. "><figcaption><p>The ActiveIO Square Advanced Properties when the square is in Continuous mode. </p></figcaption></figure>

#### Notes (Advanced)

The Notes field is an optional freeform text field for user-defined content. Click the ![Motive button to display Advanced properties. ](/files/z2s0s82plBCe6sk9BIhy) button and select Show Advanced if the field is not visible.&#x20;

#### Marker State

The Marker State dropdown allows you to change between Patterned mode (ActiveIO), Always On mode (Synchronized), and Continuous Illumination mode (Off) when the device is synced. We recommend using the ActiveIO Square in ActiveIO mode whenever possible.&#x20;

If the device is set to run in Always On mode, the Marker State is a read-only property, set to *Off*.&#x20;

{% hint style="info" %}
The switch on the ActiveIO Square control panel will remain set to Sync whenever the device is connected to Motive through an ActiveIO BaseStation, even when the Marker State is set to *Off* in Motive.&#x20;
{% endhint %}

<figure><img src="/files/3LotwLHHIRhNZ41MJLT6" alt="The Marker State Device Property in Motive, with options: Off; Synchronized; ActiveIO "><figcaption><p>Marker State options for the ActiveIO Square.</p></figcaption></figure>

#### Pattern Group

A collection of unique patterns that can be assigned to a specific device. The Pattern Group determines how the IR LEDs blink. You can manually change the Pattern Group through the Device properties as needed. This control is editable only when the ActiveIO Square is connected through an ActiveIO BaseStation, and the Marker State is set to ActiveIO.&#x20;

When connecting multiple devices to the camera system, we recommend using the [auto-pattern](/activeio/activeio-configuration.md#auto-pattern) option to ensure the patterns are unique across all devices in the take.&#x20;

#### Quality of Service

The Quality of Service property is a standard ActiveIO setting that allows you to send a device's IMU packet multiple times on redundant RF channels to reduce dropped packets in difficult RF environments. The result is more stable tracking performance under difficult conditions.

{% hint style="warning" %}
This setting does not apply to the ActiveIO Square as the device IMU is not used to set the ground plane. &#x20;
{% endhint %}

## Specifications

[Additional specifications](https://www.optitrack.com/api/media/file/activeio-square-spec-sheet-1.pdf) are available on the [OptiTrack website](https://optitrack.com/).&#x20;

<details>

<summary>Square Dimensions</summary>

**Dimensions when Open**

* Width: 436 mm (17")
* Height: 336 mm (13.2")
* Depth: 47 mm (1.8") <br>

**Dimensions when Closed**

* Width: 69 mm (2.7")
* Height: 409 mm (16.1")
* Depth: 47 mm (1.8")

</details>

<details>

<summary>Weight</summary>

0.6 kg (1 lb. 4.8 oz.)

</details>

<details>

<summary>Battery</summary>

**3500mAh Li-ion Battery**\
Expected battery life of 12hrs at nominal operating conditions \
Expected battery life of 4hrs in continuous mode

Charging

* USB-C PD Charging (5V\@3A, <9v@1.5A>, 15V\@1A)
* \~4hrs zero to full charge

</details>

<details>

<summary>LEDs</summary>

* 850nm IR Spectrum
* 3 LEDs with Flat Diffusers: (8mm, 5/16" diameter)
* Illuminations synchronized with camera exposures

Illumination Angles

* Bare LED: +/- 56 Degree

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.optitrack.com/activeio/activeio-hardware/activeio-square.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.