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
| Path | Source reference | What to check |
|---|---|---|
| Marvin Platform / motion SDK | Chinese software guide, September 2026 | The repository, build script, and calculation files matching the controller |
| Apex teleoperation | VR resource guide, September 4, 2026 | Robot-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 version | Earlier version | |
|---|---|---|
| Main controller | Tianzhun core controller, in the cabinet | NVIDIA Jetson Orin |
| Network | 6.6.7.x: controller 6.6.7.100, arms 6.6.7.190 | 192.168.10.x: Orin .123, arms .190, router .1 |
| Camera deserializer | Built into the robot | Separate board under the Orin |
| Headset | Pico or Meta Quest | Meta Quest; some units Pico |
| Apex Teleop interface | Current interface | Classic interface |
| Setup guide | Wiring | Earlier 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.1with Gento SDK4.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.debinstalls the Debian packagegento-apex. gento-apex-tool, which adds gripper and end-effector support, must be the same version asgento-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.