目的で二つのシミュレーターを使い分ける
既存動作を触るだけならブラウザー版を使います。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 syncRL 側では 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 downdrive は通信と制御の短いスモークテストです。性能値として扱わず、status、health、realtime、両側のログを同じ記録に残します。実時間率が 1.0 を下回ると方策の時間条件も変わるため、台数、カメラ、表示の順で負荷を減らします。
boot は systemd を調べる時に使う
通常モードは方策とクライアント開発向けです。boot は systemd-nspawn 内で実サービスを起動し、更新、権限、再起動順を調べるための経路です。sudo と追加パッケージが必要なので、質問が systemd に関係しないなら通常モードから始めます。
報告には検証できない範囲も書く
Dynamixel バス、Bluetooth、カメラ ISP、NPU、エンコーダー、電源、造形物、床との接触はこの環境では確認できません。「指定版のデーモンシミュレーション」と明記し、実機結果と混ぜないでください。
続ける前に確認
duck-simは実機配線や校正を確認できますか?
いいえ。仮想の機体でdaemonの動作を確認します。接続、センサー、実際の運動は別の検証が必要です。
対象: Pollen Robotics MicroDuck. モデル、イメージ、ソフトウェア、ドライバーの版を一緒に記録します。各日付の説明は元の検証範囲を維持します。
出典確認日:
出典と確認 (4)
- github.com/pollen-robotics/microduck/blob/e90389492bd4da42f60da343983e50cecd43b54b/docs/robot/simulation.md
- github.com/pollen-robotics/microduck/blob/e90389492bd4da42f60da343983e50cecd43b54b/scripts/duck-sim
- github.com/pollen-robotics/microduck_rl/blob/cb70b792312d559a4da09064d92009079671815f/README.md
- 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を確認し、接続拒否と更新失敗を切り分けます。