Skip to main content

Versions & compatibility

Record the robot model, arm variant, controller firmware, SDK revision, Apex version, and camera/end-effector configuration before installation or an update. Remote access & firmware shows how to read the firmware and Apex versions.

Two software paths​

PathSource referenceWhat to check
Marvin Platform / motion SDKChinese software guide, September 2026The repository, build script, and calculation files matching the controller
Apex teleoperationVR resource guide, September 4, 2026Robot-side compute architecture, desktop package, and headset package

Use TJ_FX_ROBOT_CONTRL_SDK/master, named in the September software guide and listed in the SDK directory. The tianji-robot-SDK03/Marvin_Pro repository named in the older Pro manual is no longer maintained; don't use it for new setups.

Version checks​

The SDK and controller major and minor versions must match. Check the controller firmware version before installing or updating the SDK.

The September software guide has separate build scripts for controller versions it calls “41” and “43.” Check the full firmware version before choosing a script. Installation instructions here do not select a firmware package for you.

Current and earlier hardware​

Current versionEarlier version
Main controllerTianzhun core controller, in the cabinetNVIDIA Jetson Orin
Network6.6.7.x: controller 6.6.7.100, arms 6.6.7.190192.168.10.x: Orin .123, arms .190, router .1
Camera deserializerBuilt into the robotSeparate board under the Orin
HeadsetPico or Meta QuestMeta Quest; some units Pico
Apex Teleop interfaceCurrent interfaceClassic interface
Setup guideWiringEarlier Marvin Pro (Orin)

Don't install current Tianzhun packages on an Orin unit or apply Tianzhun addresses to it.

Apex version matching​

  • Install the controller software, Gento SDK, Teleop service, Apex frontend, and headset client from one delivery release. Their version numbers refer to different components, so don't compare them with each other.
  • The current Marvin Pro documentation baseline is gento-apex 1.1.7.1 with Gento SDK 4.7.1. The source still marks it as unreleased; your delivery manifest decides the installed version.
  • Package filenames change between releases. For example, pro-Teleoperation-apex_v1.1.7.1o_humble_arm64.deb installs the Debian package gento-apex.
  • gento-apex-tool, which adds gripper and end-effector support, must be the same version as gento-apex.
  • Don't update arm-controller, servo, or camera firmware across versions without a package and procedure confirmed by Gento support.

To install or update Apex, see Install or update Apex.

Before changing a working setup​

Back up the configuration and record the installed versions. Have the matching package and recovery instructions available. Configuration changes to IP, payload, stiffness, damping, Home points, and TCP offsets should be tracked together with the software version.