LogoLogo
WebsiteSupportDownloadsForumsQuick LinksContact Us
v3.2
v3.2
  • OptiTrack Documentation
  • WHAT'S NEW
    • What's New in Motive 3.2
  • QUICK START GUIDES
    • Quick Start Guide: Getting Started
    • Quick Start Guide: Prime Color Camera Setup
    • Quick Start Guide: Precision Capture
    • Quick Start Guide: Tutorial Videos
    • Quick Start Guide: Active Marker Tracking
    • Quick Start Guide: Outdoor Tracking Setup
  • HARDWARE
    • Cameras
      • Ethernet Cameras
        • PrimeX 120
        • PrimeX 41
        • PrimeX 22
        • PrimeX 13
        • PrimeX 13W
        • SlimX 13
        • Prime Color
        • VersaX 22
        • VersaX 41
        • VersaX 120
      • USB Cameras
        • Slim 3U
        • Flex 13
        • Flex 3
        • V120:Duo
        • V120:Trio
        • Adjusting Global Origin for Tracking Bars
    • Prepare Setup Area
    • Camera Mount Structures
    • Camera Placement
    • Ethernet Camera Network Setup
      • General Overview and Specs
      • Windows 10 Network Settings
      • Cabling and Load Balancing
      • Switch Configuration for PrimeX 120
      • NETGEAR ProSafe GSM7228S: Disabling the Broadcast Storm Control
      • White/Blacklisting Cameras
    • USB Camera System Setup
      • USB Camera Network Overview and Specs
      • V120:Duo and Trio Setup
      • Tracking Bar Coordinate System
        • Transforming Coordinate System: Global to Local
    • Aiming and Focusing
    • Camera Status Indicators
  • MOTIVE
    • Installation and License Activation
    • Motive Basics
    • Calibration
      • .mcal XML Calibration Files
      • Continuous Calibration
      • Continuous Calibration (Info Pane)
      • Calibration Squares
    • Markers
    • Assets
      • Gizmo Tool: Translate, Rotate, and Scale
    • Rigid Body Tracking
      • Aligning Rigid Body Pivot Point with a Replicated 3D Model
    • Skeleton Tracking
    • Trained Markersets
    • IMU Sensor Fusion
    • Data Recording
      • Data Types
    • Labeling
    • Data Editing
    • Data Export
      • Data Export: BVH
      • Data Export: C3D
      • Data Export: CSV
      • Data Export: FBX
      • Data Export: TRC
    • Data Streaming
    • Camera Video Types
    • Audio Recording
    • Motive HotKeys
    • Measurement Probe Kit Guide
    • Motive Batch Processor
    • Reconstruction and 2D Mode
  • MOTIVE UI PANES
    • Settings
      • Settings: General
      • Settings: Assets
      • Settings: Live Pipeline
      • Settings: Streaming
      • Settings: Views
      • Settings: Mouse and Keyboard
      • Settings: Audio
    • Assets Pane
    • Builder Pane
    • Constraints Pane
      • Constraints XML Files
    • Calibration Pane
    • Data Pane
    • Devices Pane
    • Edit Tools Pane
    • Graph View Pane
    • Info Pane
    • Labels Pane
    • Log Pane
    • Probe Pane
    • Properties Pane
      • Properties Pane: Camera
      • Properties Pane: Force Plates
      • Properties Pane: NI-DAQ
      • Properties Pane: OptiHub2
      • Properties Pane: Rigid Body
      • Properties Pane: Skeleton
      • Properties Pane: Take
      • Properties Pane: Trained Markerset
      • Properties Pane: eSync2
    • Status Panel
    • Toolbar/Command Bar
    • Control Deck
    • Viewport
  • PLUGINS
    • OptiTrack Blender Plugin
      • OptiTrack Blender Plugin
    • OptiTrack Unreal Engine Plugin
      • Unreal Engine: OptiTrack Live Link Plugin
        • Quick Start Guide: Real-Time Retargeting in Unreal Engine with Live Link Content
        • Unreal Editor for Fortnite (UEFN): OptiTrack Plugin for Live Link Hub
        • Unreal Engine: Live Link Camera Stream Setup
        • Live Link Content: Active Puck Static Meshes
      • Unreal Engine: MotionBuilder Workflow
      • Unreal Engine: HMD Setup
      • Unreal Engine VCS Inputs
    • OptiTrack Unity Plugin
      • Unity: HMD Setup
    • OptiTrack OpenVR Driver
    • OptiTrack MATLAB Plugin
    • Autodesk Maya
      • Autodesk Maya: OptiTrack Insight VCS Plugin
    • Autodesk MotionBuilder
      • Autodesk MotionBuilder Plugin
      • Autodesk MotionBuilder: OptiTrack Skeleton Plugin
      • Autodesk MotionBuilder: OptiTrack Optical Plugin
      • Autodesk MotionBuilder: OptiTrack Insight VCS Plugin
      • Autodesk MotionBuilder: Timecode Data
    • OptiTrack Peripheral API
    • External Plugins
      • Houdini 19 Integration
  • ACTIVE COMPONENTS
    • Active Components Hardware
      • Active Puck
      • Wired AnchorPuck
      • CinePuck
      • Wired CinePuck
      • BaseStation
      • Information for Assembling the Active Tags
      • Manus Glove Setup
    • Configuration
      • Active Batch Programmer
      • Active Hardware Configuration: PuTTY
      • Active Component Firmware Compatibility
    • Active Marker Tracking
      • Active Finger Marker Set
  • SYNCHRONIZATION
    • Synchronization Hardware
      • External Device Sync Guide: eSync 2
      • External Device Sync Guide: OptiHub2
    • Synchronization Setup
    • OptiTrack Timecode
  • VIRTUAL PRODUCTION
    • Unreal Engine: OptiTrack InCamera VFX
    • Entertainment Marker Sets
    • PrimeX 41
  • MOVEMENT SCIENCES
    • Movement Sciences Hardware
      • General Motive Force Plate Setup
      • AMTI Force Plate Setup
      • Bertec Force Plate Setup
      • Kistler Force Plate Setup
      • Delsys EMG Setup
      • NI-DAQ Setup
      • Multiple Device Setup
    • Movement Sciences Marker Sets
      • Biomechanics Marker Sets
      • Biomech (57)
      • Rizzoli Marker Sets
    • For Visual3D Users
    • Prime Color Camera Setup
      • Prime Color Setup: Required Components
      • Prime Color Setup: Hardware Setup
      • Prime Color Camera Setup: Camera Settings
      • Prime Color Camera Setup: Prime Color FS Calibration
      • Prime Color Setup: Data Recording / Export
      • Prime Color Camera Setup: FAQ / Troubleshooting
      • Prime Color Camera Setup: Windows Network Settings
  • VIRTUAL REALITY
    • VR Plugins
      • VR Unreal Engine
        • OptiTrack Unreal Engine Plugin
        • Unreal Engine: OptiTrack Live Link Plugin
          • UE5.1 Live Link Retarget External Workaround
        • Unreal Engine VCS Inputs
      • VR Unity
        • OptiTrack Unity Plugin
      • VR OpenVR
        • OptiTrack OpenVR Driver
    • VR HMD Setup
      • Unreal Engine: HMD Setup
      • Unity: HMD Setup
      • Manually Calibrating the HMD Pivot Point
      • Sync Configuration with an HTC Vive System
    • SlimX 13
    • Active Marker Tracking
      • Active Finger Marker Set
    • Synchronization Hardware
      • External Device Sync Guide: eSync 2
      • External Device Sync Guide: OptiHub2
  • ANIMATION
    • Autodesk Maya
      • Autodesk Maya: OptiTrack Insight VCS Plugin
    • Autodesk MotionBuilder
      • Autodesk MotionBuilder Plugin
      • Autodesk MotionBuilder: OptiTrack Skeleton Plugin
      • Autodesk MotionBuilder: OptiTrack Optical Plugin
      • Autodesk MotionBuilder: OptiTrack Insight VCS Plugin
      • Autodesk MotionBuilder: Timecode Data
  • ROBOTICS
    • MoCap4ROS2 Setup
    • OptiTrack Robot Applications
    • Outdoor Tracking Setup
  • DEVELOPER TOOLS
    • Developer Tools Overview
    • Camera SDK
      • Class: cCameraModule
      • Class: cUID
    • Motive API
      • Motive API: Quick Start Guide
      • Motive API Overview
      • Motive API: Function Reference
      • Motive API Camera Calibration
    • NatNet SDK
      • NatNet 4.1
      • NatNet: Class/Function Reference
      • NatNet: Creating a Managed (C sharp) Client Application
      • NatNet: Creating a Native (C++) Client Application
      • NatNet: Data Types
      • NatNet: Matlab Wrapper
      • NatNet: Migration to NatNet 3.0 libraries
      • NatNet: Remote Requests/Commands
      • NatNet: Sample Projects
      • NatNet: Unicast Data Subscription Commands
      • Latency Measurements
    • VRPN Sample
    • Peripheral API: Glove Devices
  • SKELETON MARKER SETS
    • Full Body
      • Baseline (41)
      • Core (50)
      • Biomech (57)
      • Conventional (39)
    • Full Body + Fingers
      • Baseline + Passive Fingers (49)
      • Baseline + Active Fingers (57)
      • Core + Passive Fingers (54)
      • Core + Active Fingers (62)
    • Upper
      • Baseline Upper (25)
      • Conventional Upper (27)
    • Lower
      • Baseline Lower (20)
      • Helen Hayes Lower (19)
      • Conventional Lower (16)
    • Hand and Fingers
      • Left/Right Hand (4) Active
      • Left/Right Hand (10) Active + Passive
      • Active Finger Marker Set
    • Glove Device Setup
      • Manus Glove Setup
      • StretchSense Glove Setup
    • Rizzoli Marker Sets
    • Entertainment Marker Sets
    • Rigid Body Skeleton Marker Set
  • GENERAL TROUBLESHOOTING
    • Licensing Troubleshooting
    • Windows 11 Optimization for Realtime Applications
    • Network Troubleshooting
    • Troubleshooting Q&A
    • Running Motive on High DPI Displays
    • Firewall Settings
Powered by GitBook
On this page
  • Overview
  • Requirements
  • Download and Install
  • Active Batch Programmer Settings
  • Batch Information
  • Set Marker Labels
  • Set Radio
  • Set LED Options
  • Program Active Components
  • Firmware Compatibility

Was this helpful?

Export as PDF
  1. ACTIVE COMPONENTS
  2. Configuration

Active Batch Programmer

This page provides instructions to use Active Batch Programmer to configure active components.

PreviousConfigurationNextActive Hardware Configuration: PuTTY

Was this helpful?

Overview

Active Batch Programmer provides a convenient way of programming multiple OptiTrack components including Active Tags, CinePucks, Pucks, and BaseStations.

In general, users should not need to use the batch programmer. Tags and Pucks are pre-configured for every set of devices that ships in the same order, and we ensure none of the Labels overlap.

The cases when you would need to reconfigure the active components are:

  • When you have purchased new Tags/Pucks to add to a system from a previous order.

  • When there is a need to change the RF communication channel to avoid interference.

When needed, multiple BaseStations can be connected to the same camera network, as long as they communicate through separate channels.

Please see the section for more details and specifications for Active Devices.

Requirements

  • Windows 10 or 11

  • BaseStation: Mini USB Data Cable

  • Active Tag/Puck: Micro USB Data Cable

  • CinePuck: USB C Data Cable

  • To use IMU components, all of the devices, including the BaseStation, must have firmware version 2.x or above installed. To determine the version installed, in Read-Only Mode to display its current properties, including the firmware version.

Download and Install

  • Double-click to run the installer.

  • Review the End User License Agreement, check the box to agree to the license terms and conditions, then click Install.

  • The installer will copy a shortcut for the Active Batch Programmer to the Windows desktop.

Active Batch Programmer Settings

Open Active Batch Programmer without any components connected.

Read-Only Mode

Active Batch Programmer opens in Read-Only Mode by default. Once Read-Only Mode is turned off, the current settings are applied when a new device is attached, then powered on.

Stay in Read-Only Mode to view the active device's current configuration. Unchecking Read-Only Mode will apply the settings currently selected in the Active Batch Programmer when a device is connected.

For this reason, we recommend you always configure the settings you wish to apply first, before connecting any devices or turning off Read-Only Mode.

Batch Information

A batch of active components contains one BaseStation and the active components that connect to it. These components can be devices such as Pucks and CinePucks or sets of Active Tags.

Active Batch Programmer assigns a unique active label to each marker in the batch through labeling groups. A labeling group is a set of unique active marker labels that are programmed to the active IR LEDs on the device.

Set Marker Labels

Applicable to Active Tags/Pucks only, Set Marker Labels is selected by default.

Marker labels are the active IDs assigned to individual markers, applied to all the markers on a single device or set of active tags as a group. The label group will increment as each new device is attached.

  • If needed, individual markers can be turned off on a device using the Disable Markers setting.

  • Always on Mode sets all the markers on the programmed device to 0. This causes the markers to strobe in sync with the exposure of the cameras, without an active pattern, making them appear like passive markers.

It's important there are no overlapping labels assigned within the same batch.

When reconfiguring marker labels, program ALL of the Tags and Pucks in the same session, so that labels do not overlap with other components in the system.

Set Radio

Select Set Radio to update the Radio Frequency (RF) Channel. The available RF range is 11-26. All devices in a single batch (BaseStation, Pucks, and/or Active Tags) must use the same RF channel.

  • Enter the RF Channel you wish to use. If programming a new device to attach to an existing BaseStation, make sure to assign the same RF channel used by the BaseStation to the new device.

  • The Uplink ID property is applied to active devices only and is unique to each device. This number increments as each new device is programmed.

  • Use the Signal Intensity slider to adjust the radio gain levels, as needed to address interference in the capture volume.

The Set Radio configuration applies to BaseStations as well as Pucks and Active Tags.

Set LED Options

Select Set LED Options to adjust the brightness of the Active IDs.

  • Use the Custom Brightness setting to select a value between 0 and 100. The Default is 20.

  • Auto Brightness sets the value to 50.

Program Active Components

Once the settings are configured, you are ready to begin the first batch.

  • Uncheck Read-Only Mode (just report existing configuration).

  • With the device powered off, attach the BaseStation, Puck or Active Tag to the PC running Active Batch Programmer, using the following cable type:

    • BaseStation: Mini USB data cable

    • Active Tag/Puck: Micro USB data cable

    • CinePuck: USB C data cable

Skip updating the BaseStation if it's already set to the RF Channel you wish to use.

  • Power on the device and wait for Active Batch Programmer to update the Current Batch information (Active Tags, CinePucks, and Pucks only) and the Log.

  • Once the device is configured, disconnect it and attach the next device. Repeat until all devices in the batch are configured.

Current Batch

The Current Batch field displays summary information about the label groups applied to the devices in the batch. This allows the user to easily track which devices are included in the batch and ensure that duplicate label groups are not assigned.

Note that the Next Label Group value has advanced automatically.

To prevent overlapping label groups, we recommend programming all the devices for each BaseStation in a single batch.

Click Start New Batch to program additional BaseStations and devices.

Log

Monitor the Log while connecting components to make sure configurations are applied successfully. The Log displays detailed information about the device in both read-only mode and when updates are made.

  • Firmware version

  • Existing configuration

  • Device serial number

  • Details of all the changes applied

Read-only information is displayed in gray with a [debug] tag, while changes are shown in black with the [info] tag. If needed, click in the log pane to select and copy the log to paste it into a text file.

Firmware Compatibility

Firmware Compatibility Chart

The charts below outline the firmware versions available for BaseStations and Active Tags/Pucks. With the exception of the CinePuck, the active devices and the BaseStation must be on the same firmware version. The CinePuck uses 3.x firmware and is compatible with BaseStations on 2.x.

For Active Tags specifically, if the device doesn't have an IMU then it's compatible with 1.x. firmware If it has the first version of an IMU, then it is compatible with 2.x. And, if it has an upgraded IMU (i.e., a CinePuck), then it is compatible with 3.x.

If the installed firmware is an older version, please for assistance with upgrading the firmware.

CinePucks on firmware version 3.x may require assistance from to configure.

Download the Active Batch Programmer installer from the section of the page.

contact us
Support
Developer Tools
OptiTrack Downloads
Active Components Hardware
attach each device
Log in read-only mode.
the Active Batch Programmer installer, with EULA.
Read-Only Mode is in the bottom left corner.
Active Batch Programmer at launch.
Set Marker Labels options.
Set Radio options.
Set LED Options.
Read-Only Mode.
Active Batch Programmer with a batch in progress.
Log for an update to a BaseStation RF Channel.
Click image to enlarge.
Click image to enlarge.