Unitree G1:既知の問題と修正方法

最終更新

38件の既知の問題 View robot profile →
保証と安全に関するお知らせ: 保証は到着時に開始されます。所有者が診断のためにUnitreeにユニットを発送し、送料は自己負担となります。シェルを開けること、分解、または未承認の改造を行うと保証は無効となります。家庭用交換部品のチャネルはなく、リセラーのみが一次サポートを提供します。G1基本モデルは~8ヶ月、G1 EDUは~18ヶ月(EUは24ヶ月)。 ソース: https://www.unitree.com/mobile/terms/policy https://blog.robozaps.com/b/unitree-g1-review 以下に示す回避策はコミュニティ提供であり、保証없이提供されます。
モーター/アクチュエーター 使用をブロック 回避策あり

脚/股関節/足首モーターが過熱し、シャットダウンを強制する

症状
足首ロールモーターはアイドル状態近くでも5〜10分で~90°Cに達します。左股関節はテレオペレーション約30分後に過熱し、自動的にシステムがシャットダウンします。
影響範囲
サードパーティの全身コントローラー(NVIDIA GEAR-SONIC / Isaac-GR00T N1.7 on Jetson Orin NX)で報告されています。Unitreeのストックコントローラーは足首を30〜45°Cに維持します。
修正/回避策
過熱はアクチュエーターのゲイン設定に関連しており、必ずしもハードウェアの故障ではありません。Kp/Kdゲインを小さくし、立ち姿勢を調整して静的負荷を下げ、延長走行にはUnitreeのストックコントローラーを使用してください。ストックコントローラーでなくても温度が急上昇する場合は、使用を停止して検査してください — 本当に故障したアクチュエーターは修理が必要です。
モーター/アクチュエーター 使用を低下 オープン/未解決

Inspire dexhand使用時に肩/アームモーターが過熱し、弛緩する

症状
Inspire FTP dexhandと組み合わせた場合、肩ピッチアームモーターが短時間の操作後に過熱し、アームの反応性が失われます。
影響範囲
G1 ARM7 + Inspire FTP hand、ROS2 Humble; PDゲイン kp=40 / kd=1.5で実行中のユーザー。
修正/回避策
ベンダーによる修正は文書化されていません。コミュニティの指示:ハンドの質量と低いトルク制限に対して、アームには重力/ペイロード補償が必要です。所有者は現在、この組み合わせに対するUnitree推奨のPDゲインを模索中です。ハードウェア故障と見なす前に、タッチングの問題として扱う必要があります。
ファームウェア/アップデート 不便 回避策あり

ロボットがSDKコマンドを無視する(ダンプ/開発モードでスタック)

症状
G1が'Dampモード'で起動し、SDKコマンドを無視します。'Developモード'に入るとSDKの反応性も無効になるため、ユーザーはSDKが壊れたと判断します。
影響範囲
G1ファームウェアの一般的な動作。
修正/回避策
SDKコマンドを送信する前にリモートでロボットをアクティブ化します:L1+Aを押してから、L1+UPでダンプモードを終了します。SDKコントロールが必要な場合は開発モードに座らないでください。開発モードに入った場合は、アプリでai-sportクライアントを更新してください。
SDK/ソフトウェア 使用を低下 ベンダーにより修正済み

SDKからのWaveHand / ShakeHandが失敗する(エラー3203「API未実装」)

症状
WaveHandとShakeHandのアームアクションはリモートでは動作しますが、Python/C++/ROS2では失敗します。ROS2はエラー3203「サーバー上でAPI未実装」を返します。
影響範囲
ファームウェア v1.3.0以前。
修正/回避策
ロボットのファームウェアをv1.3.0以降に更新してください。また、コマンドを発行する前にロボットがダンプモードからアクティブ化されていることを確認してください(L1+A、L1+UP)。
ファームウェア/アップデート 使用をブロック オープン/未解決

ファームウェア1.4.0後、コードと公式サンプルが動作しなくなる(「ClientStub send request error」)

症状
ファームウェア1.4.0への更新後、以前は動作していたPythonコードと公式SDKサンプルが動作しなくなります。繰り返される'[ClientStub] send request error'。関連:GetVolumeがエラー3102を返す、ハイレベル/オーディオサンプルが失敗する。
影響範囲
ファームウェア1.4.0。
修正/回避策
ベンダーによる修正は文書化されていません。ロボットがアクティブ化されている(ダンプモード外にある)ことを確認し、SDKバージョンがファームウェアと一致することを確認してください。特定の機能のためにアップグレードした場合は、一部のユーザーはロールバックしていることに注意してください。後続のパッチについてはUnitreeのリリースノートに注意してください。
ハンド/グリッパー 使用をブロック 回避策あり

Inspire handがシリアルポートを開けない/IPに到達不能

症状
'Open Serial port /dev/ttyUSB0 failed' — Inspire handをコントロールできません。FTP handが192.168.123.211で到達不能です。
影響範囲
G1 + Inspire hand(DFXシリアル vs FTP modbus-TCP Variants)。
修正/回避策
コントロール方法はハンドのVariantに依存します。FTP Inspire handsはシリアルポートではなくModbus TCPを使用します — FTP handでシリアルコードを使用すると設計上将失敗します。所有しているVariantを確認し、一致するコントロール方法を使用してください。handのIPが192.168.123.xネットワークで到達可能であることを確認してください。
ハンド/グリッパー 使用を低下 オープン/未解決

Dex3-1 handの親指がテレオペレーション中にほぼ動かない

症状
テレオペレーション中、親指はシミュレーションのフルレンジに対し3〜4°の微小動作しか行いません。親指と人差指のピンチは約5cmで底打ちし、精密操作には粗すぎます。
影響範囲
G1ソフトウェア V1.4.7 + Dex3-1 hand。
修正/回避策
修正は文書化されていません。起動時の自己診断では関節は正常でシミュレーションも動作するため、ハードウェアの問題ではなく、テレオペレーションとhand driver間のコマンドマッピングの不一致を示唆しています。DriverバージョンをUnitreeに報告してください。
ネットワーク/接続 使用を低下 オープン/未解決

1〜2時間後、テレオペレーションの遅延が~2.5秒に増加する

症状
アームとカメラの遅延が長時間テレオペレーション後に~2.5秒に増加します。アーム準備ポーズが~2秒ではなく~4秒かかるようになり、最終的には起動時に即座に表示されるようになります。
影響範囲
xr_teleoperate v1.3およびv1.5。
修正/回避策
修正は文書化されていません。ギガビットルーターとWiFi 6へのアップグレードも効果がなく、シミュレーションモードは影響を受けていません — これはネットワークではなく、オンボードのバッファリング/蓄積の問題を示唆しています。長期セッション間の回避策として、テレオペレーションスタックを再起動してください。
ネットワーク/接続 使用を低下 回避策あり

WiFi経由のポリシーデプロイが'Waiting for connection rt/lowstate'でハングする

症状
WiFi経由でのデプロイはSSH接続は動作しますが'Waiting for connection rt/lowstate'でハングします。有線イーサネットは正常に動作します。
影響範囲
G1、DDSベースのコントロール。
修正/回避策
有線接続を使用し、インターフェースを指定してください(例:./g1_ctrl --network enx701988512412)。DDSマルチキャストのlowstateは無線インターフェースでは正常に動作しません。
SDK/ソフトウェア 使用をブロック 回避策あり

CycloneDDSバージョン不一致によりG1 simがクラッシュ

症状
G1シミュレーション初期化時のDDSアサーション失敗 / CycloneDDSライターエラー;起動しない。
影響範囲
Ubuntu 22.04、ROS2 Humble;システムCycloneDDS 0.10.5 vs Python CycloneDDS 0.10.2。
修正/回避策
ROSセットアップスクリプトをsourceしないでください(ROSのDDSライブラリはunitree_sdk2のものとは異なります)。コンパイル時にリンクされている.soを確認してください。代替案:ソースからCycloneDDS 0.10.2をビルドする、unitree-sdk2pyを0.10.5用にパッチする、またはUbuntu 20.04で開発する。
SDK/ソフトウェア 使用をブロック 回避策あり

Ethernet接続時に「.robot typeが一致しません」(DOF 23 vs 29)

症状
コントローラーがEthernet経由で接続後、sim-to-real展開時に「Unmatched robot type」で即座に失敗する。
影響範囲
G1 23-DOFおよび29-DOFバリエーション(腰固定/ダミーハンド設定を含む)。
修正/回避策
ロボットのDOF/設定はコントローラーの期待するタイプと一致する必要があります。設定で正しいDOFを設定し、/usr/localとプロジェクトパスの競合するSDKインストールを確認してください—unitree_sdk2をクリーンに再ビルド(deployビルドで-DBUILD_EXAMPLES=OFF、simビルドで別々のCMAKE_INSTALL_PREFIX使用)により、関連するvelocityモード応答なしケースが解決されます。
SDK/ソフトウェア 使用を低下 オープン/未解決

SDKで腕を動かしながら歩行するとバランスを崩す

症状
歩行中(ゲームパッド)にSDKで腕を制御すると、ロボットが前傾하거나バランスを崩す;歩行中の腕上げにより、不安定で重い歩行になる。
影響範囲
3-DOF腰付きG1。
修正/回避策
修正方法は未確認。腰部アクチュエータをゼロ化(initial値を保持して触らない)すべてを試みたが成功なし—ARM SDKコントローラーとlocomotionバランスコントローラーが競合しています。ファームウェアアップデートで対処されるまで、locomotion中の大きな腕の動きは避けてください。
SDK/ソフトウェア 使用を低下 回避策あり

シミュレーション内のG1がデフォルト安定化なしで崩壊

症状
MuJoCoシミュレーションでG1にはデフォルト安定化がなく、コントロールなしでは倒れてしまう。
影響範囲
unitree_mujoco。
修正/回避策
elastic bandを有効にします:unitree_mujoco/simulate/config.yamlでenable_elastic_band: 1を設定(またはENABLE_ELASTIC_BAND=True)。factory motion controllerはsimでは使用できないことに注意。また、joystick制御に切り替える際にbandを無効にするのが困難な場合があります。
battery/power 不便 不明

バッテリー駆動時間が短い(約2時間)

症状
9,000 mAhバッテリーは1回の充電で約2時間しか持たず、ダイナミックな動作ではより速く消耗する。
影響範囲
ベースモデル、9,000 mAhパック。
修正/回避策
これは容量の制限であり、不良品ではありません。セッション間のホット_swap用の充電済みスペアバッテリーを準備してください。アクティブな使用で約2時間のruntimeを予算に組み込んでください。
other 使用をブロック 不明

ベースG1はSDKなしでプログラムできない

症状
約$13,500のベースG1購入者が、これはSDKなしでプログラムできないデモ/ショーケースユニットであることを発見する。
影響範囲
G1 base (23 DoF) vs G1 EDU (最大43 DoF)。
修正/回避策
これは製品ティアの制限です。SDKアクセス、より高い扭矩、より多くのDoFにはG1 EDU / developerプラットフォーム(~$44k-$74k)が必要です。開発予定の場合は購入前にティアを確認してください。
mechanical/structural 使用をブロック 回避策あり

赤いLED点灯 / 物理的Faultチェックリスト(落下、ケーブル、バッテリー)

症状
ソフトウェア/ハードウェアエラーを示す赤いLED点灯;および現地でのFault—落下によるひび/へこみ、粉塵やミスアライメントによるセンサー劣化、緩んだ/擦り切れたケーブルによる応答なしコンポーネント、バッテリーの膨張または変形。
影響範囲
一般。
修正/回避策
衝撃ダメージがないか視覚的に検査;センサー清掃とmounting確認;ケーブルとconnectorの着脱確認;バッテリーの装着確認と膨張や漏れがある場合は交換。赤いLED点灯時はmobile-app diagnosticsを実行し、断続的なFaultのビデオを記録してからサポートに連絡してください。注:シェルを開けると保証が無効になります。
security/privacy 使用をブロック オープン/未解決

重大なセキュリティ:ハードコードされたキーによるBLEコマンドインジェクション(UniPwn)

症状
ハードコードされたAESキーを含むBLE Wi-Fiプロビジョニングのコマンドインジェクション欠陥があり、すべてのユニットで共有されており、rootアクセスを許可し、wormableの可能性があります。別の研究では約5分ごとに外部サーバーにtelemetryが送信されていることがわかりました。
影響範囲
G1(研究者はGo2/H1がコードパスを共有していると示唆)。パブリック'UniPwn'exploitがリリース済み。
修正/回避策
執筆時点でベンダーによるパッチの確認はありません。ネットワークレベルで軽減:ロボットをセグメント化/ファイアウォールされたネットワークに隔離し、内部インターフェース(192.168.123.0/24)へのアクセスを制限し、予期しないアウトバウンドトラフィックをブロックします。Unitreeのファームウェアアドバイザリを監視してください。
other 不便 不明

バイラルデモのスキルは振り付けられており、自律的ではない

症状
カンフーやバク転のクリップはトレーニングされたショーケースです;ロボットは箱から出してすぐに家庭での自律性はなく、ドアを開けるなどの単純なタスクに失敗します。
影響範囲
一般。
修正/回避策
期待値の設定であり、Faultではありません。自律的なタスクパフォーマンスにはEDUプラットフォームでの大幅な開発が必要です;ベースの経験はremote/事前プログラムされたmotionです。
SDK/ソフトウェア 使用をブロック ベンダーにより修正済み

G1 23-DoFロボットがMuJoCo Sim2Simで不規則に動作する

症状
MuJoCoでSim2Simを実行する際、Isaac LabでトレーニングされたポリシーをG1 23-DoF構成で使用すると、ロボットが正常に歩行せず、不規則に動作する。スレッドで報告された推定原因是、モーターIDが23-DoFバージョンに適応されていないこと。
修正/回避策
ベンダー(Agnel-Wang)がリポジトリに23-DoFデプロイコードを追加。報告者は更新されたコードを使用してSim2Realが成功したことを確認。
ネットワーク/接続 使用をブロック オープン/未解決

G1_29_ArmControllerが「dds订阅等待中」を繰り返し出力し、ロボットアプリがファームウェア通信エラーを報告する

症状
テレイオペレーションスクリプトを実行すると、コントローラーが無限ループで『[G1_29_ArmController] dds订阅等待中...』を出力し、モバイルアプリが『底层固件通信故障』(基盤ファームウェア通信故障)を報告する。DDS通信がホストデバイスとロボットの間で確立されない。デバイスは同一ネットワーク上に存在している。
修正/回避策
メンテナーは『cyclonedds ps』と『cyclonedds subscribe rt/lowstate』でネットワーク接続を確認することを提案。解決しない場合はサポートチケットを提出。コメントローでは低レベルサンプルは動作したが、高レベルアームサンプルではロボットの動きがなく、リクエストエラーが発生したとの報告あり。
ネットワーク/接続 使用をブロック オープン/未解決

テレイオペレーション設定でApple Vision ProのWebSocketがすべてのページ読み込み時に即座に切断される

症状
Apple Vision Pro Safariからテレイオペレーションサーバーにアクセスすると、WebSocketが接続하지만、すべてのページ読み込み時に即座に切断され、サーバーで『AssertionError: Websocket session is missing.』が発生する。ページを更新すると接続/切断サイクルを繰り返す。見つかった唯一の回避策は、AVPヘッドセットを取り外すか、Safariを完全に閉じて数秒待つこと。
影響範囲
vuer 0.0.60、televuer 4.0.0、xr_teleoperate commit 9fadc51、visionOS最新
修正/回避策
AVPを取り外すかSafariを完全に数秒閉じて一時的に安定した接続を実現。メンテナーは『https://vuer.ai/?ws=wss://host ip:8012』の試用を提案したが、確認された修正は提供されていない。
SDK/ソフトウェア 使用をブロック オープン/未解決

WBCポリシーが値をストリーミングするが、ハンドキャリブレーション後、実際のG1が動作しない

症状
コミュニティGR00T-WholeBodyControlドライバーを通じて:ロボットがデバッグモードに入り、ハンドのキャリブレーションが正常に完了した後、G1はターミナルにポリシーがロボットに値をストリーミングしているにもかかわらず、全く動作しない。エラーは報告されず、並行シミュレーションは正常に動作している。
修正/回避策
確認された修正なし
SDK/ソフトウェア 使用を低下 オープン/未解決

Quest 3でのリアロボットテレイオペレーション中、Vuer画像フィードが最初のフレームで冻结する

症状
Quest 3ヘッドセットでテレイオペレーションPipelineを実行すると、Vuerディスプレイは最初にキャプチャされたフレームのみを表示して冻结し、PC上のイメージクライアントはライブカメラフィードが正常に動作していることを確認している。問題はメインブランチとteleimagerブランチの両方で再現された。
影響範囲
vuer 0.0.67、xr_teleoperate(コントローラーモード、G1_29)
修正/回避策
メンテナーはteleimagerブランチ(WebRTCストリーミング)に切り替えることを提案。報告者はブランチを適用したが、シミュレーション デプロイメントをサポートしていないことを指摘。フレーム冻结問題の完全な確認された修正なし。
ネットワーク/接続 使用をブロック オープン/未解決

Apple Vision ProでVRモードに入ると、テレイオペレーションページが黒くなりWebSocketが切断される

症状
Vision Proが双眼カメラフィードを正常に表示した後、『virtual reality』をクリックしてハンドトラッキングの許可を与えると、ディスプレイが黒くなり、WebSocketが即座に切断され、『AssertionError: Websocket session is missing.』が発生する。エラートracebackはvuer/server.pyから発生している。
修正/回避策
メンテナーは5 GHz Wi-Fiのみの使用、AVPへのping遅延の監視(50 ms以下であること)、 televuerスクリプトを直接テストすること、vuerバージョン0.0.32rc7を試すことを提案。確認された修正の報告なし。
SDK/ソフトウェア 使用をブロック 回避策あり

G1がテレイオペレーションコントローラー経由で運動コマンド発行時に歩行しない;ジョイスティック入力が無視される

症状
テレイオペレーションスクリプトのコントローラーンモードを--motionフラグで使用すると、アーム制御は正常に動作するが、ロボットは歩行用のジョイスティックコマンドに応答しない。 프로그램을終了した後でも、物理的なリモートコントロールでもロボットを步行らせることができず、アームジェスチャーは正常に機能し続ける。
影響範囲
ai_sportバージョン未指定;xr_teleoperate、G1_29
修正/回避策
メンテナーはai_sport運動サービス名がバージョン8.2.0.0で変更されたことを特定(LOCO_SERVICE_NAMEは>=8.2.0.0では『sport』、それ以前は『loco』が必要)。マルチNICデバイスで実行する場合、コードで正しいネットワークインターフェース名を指定することも助言。メンテナーはバージョン8.4.0.0でgit pull更新後、ロボットの運動が確認されたことを確認。
Show all 38 issues
SDK/ソフトウェア 使用をブロック オープン/未解決

G1の関節がテレイオペレーション программаが起動し『r』が押された後に動作しない

症状
テレイオペレーションプログラムがエラーなしで起動し、DDSが接続しているように見え、AVPがライブカメラフィードとアームトラッキングを表示するが、プログラム実行中および『r』を押してスタートした後、G1ロボットが動作しない。ジョイント位置出力がログから欠落しており、期待される動作と異なる。プログラムからのデバッグモードへの移行は一貫性がないと報告されている。
影響範囲
G1 29-DoF + Inspire dftp hands、AVP
修正/回避策
確認された修正なし
SDK/ソフトウェア 使用をブロック オープン/未解決

XRテレイオペレーションsimでVRヘッドセットが青いグリッドのみ表示、ロボットが表示されない

症状
Meta Quest 3でsimでXRテレイオペレーションを実行すると、ユーザーがVRモードに正常に入りますが、ロボットの代わりに青いグリッドのみが表示されます。simターミナルにも『[DDSManager] object g1 not found』と『g1_robot_dds is not initialized』と表示される。
影響範囲
unitree_sim_isaaclab + Isaac-PickPlace-Cylinder-G129-Dex3-Jointタスク;xr_teleoperate teleop_hand_and_arm.py;Meta Quest 3
修正/回避策
確認された修正なし
SDK/ソフトウェア 使用をブロック 回避策あり

G1 sim2simポリシーにより、MuJoCoでロボットが左にドリフトし、アームが激しく振動する

症状
unitree_rl_labの学習済みRLポリシー(または提供されているv0ポリシー)をsimulate_python経由でMuJoCoにデプロイすると、G1ロボットが左側にドリフトし、高周波・低振幅でアームが激しく振動し、ジョイスティックでの制御がほぼ不可能になります。ロボットは移動起動ボタンスイープの直後にもジッターが発生します。
影響範囲
unitree_rl_lab(最新版);Isaac Sim + Isaac Lab;G1 29dof対応unitree_mujoco;simulate_python(C++のsimulateではなく)
修正/回避策
コミュニティの提案:MuJoCoのg1_29dof.xmlのアームと手首の慣性パラメータ(armature)を増加させ、アームの振動を軽減。有意なドリフト・不安定性に対する確定的な修正なし。
SDK/ソフトウェア 使用をブロック 回避策あり

G1をハンド構成で実行した際のunitree_mujocoでのRuntimeError「list index out of range」

症状
G1(またはInspire hands搭載H1)のunitree_mujoco.pyを実行すると、ランタイムで'[RecurrentThread] target func raise exception: name=IndexError, args=("list index out of range",)'が発生。手attachmentsを持つロボットのシミュレーションAttempt時にエラーが発生。
影響範囲
unitree_mujoco;ハンド付きG1(scene_29dof_with_hand.xml);Inspire hands搭載H1
修正/回避策
コミュニティの回避策:scene_29dof_with_hand.xmlではなくscene_29dof.xmlを使用分别に、config.pyのROBOT名がサポートされている名前(例:'g1')と正確に一致し、'g1_23dof'などのバリアントではないことを確認。
SDK/ソフトウェア 使用をブロック オープン/未解決

G1でHigh-level SDKコマンドが「send request error」を返す;low-levelコマンドは動作

症状
High-level SDKコマンド(例:g1_loco_client_example.py)を実行すると、クライアントが'[ClientStub] send request error. id: <id>'を出力し、コマンドが実行されない。Low-levelスクリプト(g1_low_level_example.py)は正常に動作。
影響範囲
unitree_sdk2_python;G1ロボット;g1_loco_client_example.py high-levelコマンド
修正/回避策
確認された修正なし
SDK/ソフトウェア 使用をブロック 回避策あり

Meta Quest 3でハンドトラッキング入力時にVRモードに入るとWebSocketが即座に切断される

症状
xr_teleoperateをMeta Quest 3で使用している場合、Virtual Realityボタンをクリックすると、ポート8012上のVuerページへのWebSocket接続が即座に切断され、'websocket is now disconnected'と表示。問題がハンドトラッキング入力モード固有の場合、入力モードをコントローラーに切り替えると接続が維持される。
影響範囲
xr_teleoperate v1.5;vuer 0.0.60;aiohttp 3.10.5;Meta Quest 3ビルトインブ라우ザー;Ubuntuホスト;Isaac Sim 5.1 + unitree_sim_isaaclab;G1_29 + Inspire
修正/回避策
コミュニティの回避策:xr_teleoperateをv1.0にダウングレードすると切断が解決别に、--input-mode=controllerに切り替えるとWebSocketが接続を維持。Meta QuestデフォルトブラウザではなくWolvicブラウザを使用 такжеもWebSocket切断 방지,但相机流问题仍然存在。
SDK/ソフトウェア 使用をブロック オープン/未解決

テレオペレーションVRページにローカルIPでアクセス不可;VRモードに入るとWebSocketが切断

症状
テレオペレーションインターフェースにローカルIPアドレス(https://<host-ip>:8012?ws=wss://<host-ip>:8012)でアクセスすると、ページが読み込まれないか、黒い画面が表示される。VR/パススルー(WebXRモード)に入ると、WebSocketが切断され、ロボットがトラッキングデータを受信しなくなる。サーバーは「Websocket session is missing」を報告し、时不時 aiohttp 'resume_writing() AssertionError'を返す。
影響範囲
vuer 0.0.60, televuer 4.0.0;ハードウェア:Inspire RH56DFTP搭載Unitree G1 29-DoF EDU、Meta Quest 3、Apple Vision Pro (visionOS 26.4)
修正/回避策
メンテナーからの提案:証明書のSANフィールドにホストIPが含まれていることを確認、シークレット/プライベートブラウジングを使用、バージョン固定のvuer/televuerの組み合わせを試す。コミュニティ貢献者がQuestブラウザのRTCPeerConnection.createOffer()が解決されないことを特定し、サーバー開始のWebRTCフローを回避策として提案したが、正式なアップストリーム化はされていない。ベンダーからの確定的な修正なし。
SDK/ソフトウェア 使用をブロック 回避策あり

Inspire FTPハンドが有効な状态下、テレオペレーションプログラムがロボットが腕を上げた後自動的に終了する

症状
Inspire FTP dex_HANDOUSハンドが有効な状態(--ee=inspire_ftp)でtelep_hand_and_arm.pyを起動すると、ロボットが少しだけ両腕を上げた後、プログラムが自動的に終了し、腕が下がる。ログには画像クライアントが予期せず閉じられたことが表示され、プログラムが明確なエラーメッセージなしに終了。
影響範囲
xr_teleoperate;ハードウェア:Inspire FTP dexterous hands搭載Unitree G1 29-DoF
修正/回避策
ユーザー確認の回避策:--ee=inspire_ftpフラグなし(FTP dexterous handsを起動せずに)で実行し、腕のみを操作。メンテナーはすべてのエンドエフェクターコードが左右ペア用に書かれているため不良ハンドが1つでもあると問題が発生することを指摘。ユーザーは片手操作を処理するようにInspire_Controller_FTPクラスパッチ。メンテナーは最新コードバージョンの試行を提案。
ハンド/グリッパー 使用をブロック ベンダーにより修正済み

両方のInspire dexterous handsがシリアルポートの誤設定により右手の動きのみをミラーする

症状
2つのInspire dexterous handsでの телеоперации中、両方のhandが右手の動きのみに追従。スレッドで特定された根本原因は、サンプルコードが両方のhandsのコマンドを同じシリアルポートに送信していること。
影響範囲
Inspire DFX / RH56DFTP dexterous hands搭載Unitree G1;ベンダーサンプルパッケージのサンプルコードinspire_ctrl.cpp
修正/回避策
メンテナー確認のコミュニティ特定修正:inspire_ctrl.cppを2つの別々のシリアルポート(serial1 = /dev/ttyUSB1、serial2 = /dev/ttyUSB2)で初期化し、各handをそれぞれのポートとIDにバインドするように修正。ベンダーがコメントで修正済みinspire_ctrl.cppコードを提供。
SDK/ソフトウェア 使用をブロック 回避策あり

unitree_mujocoシミュレーターがランタイムで「free(): invalid pointer」/「Aborted (core dumped)」でクラッシュ

症状
unitree_mujocoシミュレータバイナリを起動すると、プログラムが起動し(「MuJoCo data is prepared」)、直後に「free(): invalid pointer」と「Aborted (core dumped)」でクラッシュします。以前のエラーバリアントは「Joystick open failed」でした。MuJoCoバージョン3.2.7および3.3.1で複数のユーザーから報告されています。
影響範囲
unitree_mujoco; MuJoCo 3.2.7および3.3.1; Ubuntu 22.04およびUbuntu 24.04(ROS2 Jazzy)
修正/回避策
コミュニティユーザーの1人が、Ubuntu 24.04 / ROS2 JazzyでのクラッシュをDDSライブラリパスの競合(ROS2 JazzyのDDSライブラリ)とunitree_sdk2でインストールされたDDSライブラリが同時に読み込まれることが原因と特定しました。パスの競合を解決することで、そのユーザーにとってはクラッシュが解消されました。Joystickエラーは特定のコミット(2f5459d)で修正済みです。報告されているすべてのバリアントに対する単一の確定的な修正はまだありません。
battery/power 使用をブロック オープン/未解決

G1がsonic_releaseポリシーを数分実行すると过热してシャットダウンし、転倒を引き起こします

症状
コミュニティのGR00T-WholeBodyControlドライバーを通じて:Dex3ハンドを備えた実機29-DoF G1ロボットにsonic_releaseポリシーを展開すると、立ち止まっている状态下でも数分後にロボットが过热警告を発し、その後Sonicが自動的にシャットダウンするため、ロボットが何度も転倒します。
影響範囲
Unitree G1 29-DoF EDU(Dex3 hands搭載); GR00T-WholeBodyControl sonic_release checkpoint
修正/回避策
確認された修正なし
SDK/ソフトウェア 使用をブロック オープン/未解決

Quest 3でVirtual Realityモードに入ると、WebSocketセッションが切断され、VRビューがブラックアウトします

症状
Quest 3をテレオペレーションページに正常に接続すると(vuerインターフェースはロードされるがブラックスクリーンが表示される)、「Virtual Reality」をクリックするとWebSocketセッションが切断されます。ターミナルには接続がドロップしたことが表示されます。コミュニティの貢献者はこれをMeta Quest 3のブラウザのバグに起因するものとして特定しました。RTCPeerConnection.createOffer()がPromiseを解決しないため、デフォルトのクライアント開始WebRTCフローが中断します。
影響範囲
xr_teleoperate; ハードウェア: G1-EDU 29-DoF(Dex3-1搭載)、Meta Quest 3
修正/回避策
コミュニティの貢献者は、WebRTCネゴシエーションをサーバーがオファーを作成し、ブラウザがcreateAnswer()を呼び出すサーバ開始型フローに反転させることを回避策として提案しました。上流での確定的な修正はまだありません。
ネットワーク/接続 使用をブロック 回避策あり

ホストPCがG1にWi-Fi而不是Ethernetで接続すると、DDS通信が失敗します

症状
ノートPCがEthernetケーブルでロボットに接続されている場合、テレオペレーションは正常に動作しますが、Wi-Fiでワイヤレスに接続しようとするとDDSエラーで失敗します。さらに、ロボットのPC2(Jetson)ですべてを実行すると、約10分後に接続問題が発生します。
影響範囲
xr_teleoperate; ハードウェア: Unitree G1 EDU(Inspire FTP hands搭載)およびApple Vision Pro
修正/回避策
メンテナーはアプリケーション層でDDS転送プロキシを使用するか、G1の電源インターフェースから給電するG1の背面にルーターを取り付ける(サブネット192.168.123.*/24)ことを提案しています。単一の確定的な完全な修正はまだありません。

Unitree G1についてプロフェッショナルなヘルプが必要ですか?

修理待ちリストに参加して、認定技術者とサービスパートナーをご紹介します。

Join the Repair Waitlist →