Unitree G1 Data Streaming Delay: Diagnosis and Solutions

⚠️ SAFETY WARNING / MULTIPLE RISKS. This robotic device, the Unitree G1, presents several intrinsic risks. It contains lithium batteries; improper puncturing or bending during disassembly can cause explosions or fires. Furthermore, its moving mechanical parts (joints, actuators) can cause finger crushing or other injuries. Improper intervention can lead to loss of motor calibration, compromising the robot's stability and safety, or irreversible damage to the firmware and AI. Intervention requires extreme precision and the assistance of a specialized robotics technician is strongly recommended. ReeFix provides this diagnosis EXCLUSIVELY for educational and informational purposes.

TYPICAL ERROR

Your Unitree G1 exhibits significant delay (latency) or irregular fluctuations (jitter) in joint data streaming via SDK. This condition directly compromises the stability and responsiveness of the robot's real-time control.

Cause Analysis and Key Signals:

1. Unoptimized DDS middleware or operating system network buffer configuration (45%):

   • Why it happens: The Linux kernel, if not properly configured, may not allocate sufficient memory for UDP receive sockets, discarding high-frequency packets.
   • Signals: Systematic UDP packet loss, cumulative latency increasing over time, error messages or warnings in DDS logs related to full buffers or discarded packets.
   • Often happens when: A standard Linux operating system (like unpatched Ubuntu) is used without specific real-time optimizations for robotic applications.

2. Use of unstable or interference-prone Wi-Fi connection (30%):

   • Why it happens: The wireless medium is inherently less reliable than wired, introducing temporal fluctuations (jitter) due to environmental noise, reflections, or channel congestion.
   • Signals: High and unpredictable jitter, sudden spikes in delay, especially in environments with many other active wireless networks or physical obstacles.
   • Typical user error: Relying on Wi-Fi for low-level control or real-time development, where a wired connection is always preferable.

3. Interrupt Coalescing active on the workstation's network card (15%):

   • Why it happens: This network card feature intentionally groups packets before generating a CPU interrupt, reducing load but introducing artificial latency.
   • Signals: Constant and fixed latency (typically 1-5 milliseconds) even with a direct wired connection, independent of the workstation's computational load.

HOW TO FIX: Latency Intervention Strategies

The correction strategy focuses on eliminating latency causes, proceeding from the simplest and lowest-risk checks to the more complex ones requiring specific technical skills.

✅ Quick Checks and Preliminary Actions (Can be performed independently)

| Step | Action | Details and Relevance | | :---- | :----- | :------------------- | | 1. | Transmission Medium Evaluation | Action: Connect your Unitree G1 to the control workstation using a high-quality Ugreen Cat 8 Ethernet Cable. If your workstation or laptop does not have an Ethernet port, use an Anker USB-C Gigabit Ethernet Adapter. <br> Why: This is the first and most effective action to isolate and exclude problems related to Wi-Fi connection, which is the second most probable cause. <br> Counter-example: If latency persists or only marginally reduces with the Ethernet cable, the problem lies elsewhere, probably at the operating system software level or DDS configuration. |

🛠️ Advanced Technical Interventions (Requires the assistance of a specialized technician)

⚠️ Warning: modifications to the operating system or network hardware configuration require specific skills. Always entrust these operations to a qualified professional to avoid malfunctions or system instability.

| Step | Action | Details and Technical Relevance | | :---- | :----- | :--------------------------- | | 2. | Linux Kernel Receive Buffer Optimization | Action: A technician will verify and increase the maximum UDP receive buffer limits in the workstation's Linux operating system. <br> Procedure: sysctl parameters in the /etc/sysctl.conf file will be modified, setting values like net.core.rmem_max = 16777216 and net.core.rmem_default = 16777216. <br> Output for technician: This configuration is crucial to prevent "socket buffer overflow" and consequent packet loss. | | 3. | Disabling Interrupt Coalescing on the Network Interface Card (NIC) | Action: The technician will use the ethtool utility to disable interrupt coalescing on the workstation's Ethernet network card. <br> Procedure: Once the network interface is identified, a command similar to sudo ethtool -C <interface_name> rx-usecs 0 tx-usecs 0 will be executed. <br> Why: This operation eliminates the intentional latency introduced by the NIC to optimize generic throughput, at the expense of real-time responsiveness. | | 4. | DDS Middleware and Real-Time Scheduling Configuration | Action: A professional will examine the DDS middleware's XML configuration file (e.g., cyclonedds.xml) to ensure that the network interface and throughput parameters are optimal for robotic control. Additionally, they will verify that the SDK threads responsible for communication have real-time priority. <br> Output for technician: It may be necessary to verify the use of pthread_setschedparam in the SDK source code or consider installing a Linux kernel patched with PREEMPT_RT on the control workstation to ensure deterministic process scheduling. If a wireless connection is strictly necessary, they might suggest a dedicated ASUS Wi-Fi 6E RT-AXE7800 Router. <br> Additional note for technician: If you notice sudden micro-disconnections on the 5GHz or 6GHz bands of this router, a common issue lies in automatic DFS channel selection or the Smart Connect feature; disabling Smart Connect and manually setting fixed non-DFS channels will immediately stabilize the signal. |

FINAL VERIFICATION

After applying the corrections, it is crucial to validate their effectiveness with a series of checks:

1. Network Latency Measurement: Perform a continuous bidirectional ping between the workstation and the Unitree G1 robot's IP. A stable average value below 2-3 milliseconds, with minimal jitter (low standard deviation), indicates significant improvement.
2. SDK Streaming Monitoring: Start the Unitree G1 SDK and observe the logs for the absence of errors or warnings related to full buffers or discarded packets. Verify the fluidity of joint data streaming and control responsiveness.
3. Traffic Analysis (if available): Use tools like Wireshark to capture UDP traffic on the SDK port and confirm the absence of lost, duplicated, or out-of-order packets.

Operational Decision: Since the most frequent cause of latency is related to DDS middleware and Linux kernel buffer configuration (45%), the first recommendation is to verify and optimize these software parameters, an operation for which the support of a specialized robotics technician is advised. If the problem persists, the second priority action is to exclude network interference by switching to a wired Ethernet connection (30%), a simple intervention you can perform independently. Finally, as a last check, it is recommended to disable Interrupt Coalescing on the network card (15%).