voyager-build

Build Native Components

Build GStreamer operators, trackers, and C/C++ examples for Axelera AI hardware

Instructions

Build the specified components: $ARGUMENTS

Step 0: Data Source & Environment Selection

{{INCLUDE common/voyager-sdk-setup.md}}

Step 0.5: Axelera Voyager Project & Task Integration

{{INCLUDE common/voyager-task-integration.md}}

Step 1: Environment Verification

• Read .voyager-runtime.json. Native component builds require a supported Linux Voyager SDK host. In package_for_linux mode, provide build commands and caveats instead of claiming the build ran.
• Verify Axelera environment is activated:

  if [ -z "$AXELERA_RUNTIME_DIR" ]; then
      echo "Please activate environment: source venv/bin/activate"
      exit 1
  fi
  

Step 2: Component Identification

Parse build target from arguments:

• all: Build everything (operators, trackers, examples)
• operators: Build GStreamer pipeline operators
• trackers: Build object tracking algorithms
• examples: Build C/C++ example applications
• clean: Clean all build artifacts

Step 3: Build Operators

GStreamer operators provide pipeline processing capabilities:

# Build all operators
make operators

# Or build directly from operators directory
cd operators && make

# Clear CMake cache if needed (target lives in operators/)
make -C operators clear-cmake-cache

Operators built:

• axstreamer: Core streaming operator
• gstaxstreamer: GStreamer integration
• PillowResize: Image resizing operator

Step 4: Build Trackers

Object tracking algorithms:

# Build all trackers
make trackers

# Or build directly
cd trackers && make

Trackers built:

• ByteTrack: Fast multi-object tracker
• OC-SORT: Observation-centric SORT tracker
• TrackTrack: Tracker under trackers/algorithms/tracktrack

Step 5: Build Examples

C/C++ example applications:

# Build all examples
make examples

# Requires operators to be built first
make operators && make examples

# Or build directly
cd examples && make