unitree-g1/phases/phase-1-population.md

Phase 1: Context Population from Official & Community Sources

Date: 2026-02-13 Objective: Populate all context files with real data from manufacturer documentation, GitHub repositories, research papers, and community resources.

Sources Used

Official Manufacturer Documentation (10 pages)

1. Official G1 product page (unitree.com/g1/)
2. Official User Manual V1.1 (marketing.unitree.com)
3. G1 SDK Developer Guide (support.unitree.com)
4. Quick Start Guide
5. DDS Services Interface
6. Basic Services Interface
7. INSPIRE DFX Dexterous Hand docs
8. Basic Motion Routine (ankle joint control)
9. Get SDK guide
10. Quick Development guide

GitHub Repositories (9 repos)

1. unitree_sdk2 — C++ SDK (v2.0.2, 888 stars)
2. unitree_sdk2_python — Python wrapper (579 stars)
3. unitree_ros2 — ROS2 integration
4. unitree_mujoco — MuJoCo simulator
5. unitree_rl_gym — RL training framework
6. unitree_rl_lab — Isaac Lab RL
7. unitree_sim_isaaclab — Isaac Lab simulation
8. xr_teleoperate — XR teleoperation
9. MuJoCo Menagerie G1 model (Google DeepMind)

Research Papers (6 papers)

1. arXiv:2505.20619 — Gait-Conditioned RL for Humanoid Locomotion
2. arXiv:2502.12152 — Learning Getting-Up Policies
3. arXiv:2511.04131 — BFM-Zero Behavioral Foundation Model
4. arXiv:2502.02858 — Safe Control in Cluttered Environments
5. arXiv:2602.06382 — Vision-Based Locomotion from Depth Pixels
6. arXiv:2509.14096 — Cybersecurity of a Humanoid Robot

Community Resources (5 guides)

1. Weston Robot G1 Development Guide
2. docs.quadruped.de G1 Documentation
3. Robonomics First Two Weeks Experience Report
4. RoboStore EDU Ultimate Technical Specifications
5. HuggingFace LeRobot G1 Documentation

What Changed

Context Files Populated (13 files)

All 13 topic files updated from status: provisional to status: established:

• hardware-specs.md — dimensions, variants, compute, mechanical design, performance
• joint-configuration.md — DOF breakdowns, joint enumeration, actuator specs, DDS control interface
• sensors-perception.md — sensor suite table, D435i/MID360 details, perception pipeline, state estimation
• power-system.md — battery specs, charging, runtime, cooling
• sdk-programming.md — SDK2 C++/Python details, control modes, data streams, development workflow
• ros2-integration.md — supported distros, packages, URDF locations, middleware config
• locomotion-control.md — RL architecture, gait modes, performance, fall recovery
• manipulation.md — end effectors (3 types), Dex3-1 specs, teleoperation systems
• simulation.md — 8 simulators documented, robot models (MJCF/URDF/USD), sim-to-real pipeline
• learning-and-ai.md — RL frameworks, imitation learning, policy deployment, foundation models
• networking-comms.md — network topology, IP map, DDS config, latency
• safety-limits.md — e-stop, joint limits, collision avoidance research, safe dev practices
• deployment-operations.md — setup procedure, pre-op checklist, troubleshooting, maintenance

Equations & Bounds Updated

• 20 robot parameters filled with real values (mass, height, DOF, battery, speed, torque, etc.)
• Joint limits table populated for legs and waist (degrees + radians)
• Validation bounds table with 10 entries
• Battery runtime equation with concrete estimates

Glossary Expanded

• Grew from 12 initial terms to 37 terms
• New categories: Hardware (8), Sensors (6), Software (10), Control (6), Compute (4), Power (2), Safety (1), Operations (3)
• All existing terms updated with confirmed typical_range values

Open Questions Updated

• 9 questions resolved with answers and source citations
• 4 questions remain open (refined with new partial data)
• 8 new questions added based on gaps discovered during research

Key Findings

1. G1 uses RL-based locomotion — gait-conditioned RL with multi-phase curriculum, not classical ZMP control
2. Dual-computer architecture — proprietary locomotion computer (not accessible) + user Jetson Orin NX
3. CycloneDDS 0.10.2 is mandatory — version mismatches cause silent failures (major gotcha)
4. Seamless sim-to-real — same DDS API in simulation and real, only network config changes
5. Rich research ecosystem — 6+ validated papers with real G1 hardware experiments
6. Multiple hand options — prosthetic (base), Dex3-1 3-finger (EDU), INSPIRE 5-finger (Flagship C)

What's Next (Phase 2 candidates)

• Parse G1 URDF from unitree_ros for exact link masses, inertias, and remaining joint limits
• Download and archive actual SDK example code as worked examples
• Create worked examples in examples/ directory
• Investigate firmware update process and LLM integration capability
• Research ankle joint ranges (not in public specs)