本文へ移動
原資料を確認

MicroDuck のデーモン実機なし検証|MuJoCo で robotd を動かす

実機と同じ robotd、robotctl、50 Hz ループを MuJoCo の身体につなぎ、起動、短い走行、health とリアルタイム率を確認します。

duck-sim はブラウザーの操作体験とは用途が違います。実際のデーモンと IPC を動かせるためソフト開発に有効ですが、モーターバス、Bluetooth、カメラ ISP、NPU、電源や機構の検証にはなりません。

目的で二つのシミュレーターを使い分ける

既存動作を触るだけならブラウザー版を使います。robotd、robotctl、IPC、ポリシー交換を調べる場合は duck-sim が対象です。制御ループより上を実機と同じコードで動かし、身体側だけを MuJoCo に置き換えます。

二つのリポジトリを同じ版で用意する

コピーできる例
git clone https://github.com/pollen-robotics/microduck.git
git -C microduck checkout --detach e90389492bd4da42f60da343983e50cecd43b54b
git clone https://github.com/pollen-robotics/microduck_rl.git
git -C microduck_rl checkout --detach cb70b792312d559a4da09064d92009079671815f
cd microduck_rl
uv sync

RL 側では uv sync により duck-body と ONNX Runtime を含む環境を作ります。配置が標準と異なる場合は DUCK_SIM_RL に絶対パスを渡します。既存作業を壊さないよう、確認用チェックアウトを分けてください。

一台を起動して診断を残す

コピーできる例
cd /absolute/path/to/microduck
DUCK_SIM_RL=/absolute/path/to/microduck_rl scripts/duck-sim
scripts/duck-sim status
scripts/duck-sim drive
scripts/duck-sim ctl health
scripts/duck-sim realtime
scripts/duck-sim down

drive は通信と制御の短いスモークテストです。性能値として扱わず、status、health、realtime、両側のログを同じ記録に残します。実時間率が 1.0 を下回ると方策の時間条件も変わるため、台数、カメラ、表示の順で負荷を減らします。

boot は systemd を調べる時に使う

通常モードは方策とクライアント開発向けです。boot は systemd-nspawn 内で実サービスを起動し、更新、権限、再起動順を調べるための経路です。sudo と追加パッケージが必要なので、質問が systemd に関係しないなら通常モードから始めます。

報告には検証できない範囲も書く

Dynamixel バス、Bluetooth、カメラ ISP、NPU、エンコーダー、電源、造形物、床との接触はこの環境では確認できません。「指定版のデーモンシミュレーション」と明記し、実機結果と混ぜないでください。

続ける前に確認

duck-simは実機配線や校正を確認できますか?

いいえ。仮想の機体でdaemonの動作を確認します。接続、センサー、実際の運動は別の検証が必要です。

対象: Pollen Robotics MicroDuck. モデル、イメージ、ソフトウェア、ドライバーの版を一緒に記録します。各日付の説明は元の検証範囲を維持します。

出典確認日:

出典と確認 (4)
  1. github.com/pollen-robotics/microduck/blob/e90389492bd4da42f60da343983e50cecd43b54b/docs/robot/simulation.md
  2. github.com/pollen-robotics/microduck/blob/e90389492bd4da42f60da343983e50cecd43b54b/scripts/duck-sim
  3. github.com/pollen-robotics/microduck_rl/blob/cb70b792312d559a4da09064d92009079671815f/README.md
  4. github.com/pollen-robotics/microduck_rl/blob/b02fdea4902c2b93b7d34a83a6f05da4ececb7d3/docs/velstand_policy.md

次に読むガイド

MicroDuck シミュレーター|公開モーションの読み込みと元に戻す方法

実機なしで公式ブラウザ版を操作し、公開方策を URL から読み込む手順。PLAYING 表示、manifest の対象スロット、互換性と読み込み失敗時の戻し方を確認します。

MicroDuck の初回接続|BLE で探し、Wi-Fi と画面を切り分ける

公式実機を PC から見つける手順。広告に IP がない場合の Wi-Fi 確認と、コンソールの 8080・8443 の違いを説明します。

MicroDuckのトラブル対処:更新・ペアリング・ポリシー

MicroDuck 0.20.1:復旧の前に接続経路を確認. Wi-Fi SSHは機体のそばで有効にする方式です。daemon/APIとSetup Codeを確認し、接続拒否と更新失敗を切り分けます。