クイックスタート: 始める前に

まずこれをお読みください。 SO-101 は初心者に優しく、箱から出してすぐに LeRobot で動作します。使い始めるのに CAN バス、カーネル モジュール、ROS は必要ありません。 このページには、何が必要か、どれくらい時間がかかるか、完了したら何ができるようになるかが正確に示されます。

★初心者に優しい ✓ LeRobot ネイティブ

SO-101の違い

OpenArm を使用している場合、またはプラットフォーム間で選択している場合、主な違いは次のとおりです。

SO-101は Feetech STS3215 シリアルバスサーボ — OpenArm のような CAN バスモーターではありません。 これには 2 つの大きな影響があります。

  • よりシンプルな配線: 6 つのサーボはすべて、単一の 3 Mbps USB シリアル バス上でデイジーチェーン接続されます。 USB ケーブル 1 本で PC に接続します。 SocketCAN ドライバー、カーネル モジュール、インターフェイスの起動はありません。
  • どの OS でも動作します: macOS、Windows、Linux がすべてサポートされています。 Ubuntu やネイティブ Linux のインストールは必要ありません。

トレードオフは、ペイロードの低下 (250 g 対 1 kg) と制御帯域幅の低下です。SO-101 は、卓上でのピック アンド プレイスや模倣学習のためのデータ収集に最適です。 これは数十の学術研究室で使用されており、LeRobot コミュニティで最も一般的なアームです。

LeRobot ネイティブ: SO-101 は、HuggingFace LeRobot コードベースの参照プラットフォームの 1 つです。 公式 LeRobot クイックスタートに直接従うことができます。カスタム ロボット構成は必要ありません。

これにはどのくらい時間がかかりますか?

パートから最初に録画した LeRobot エピソードまで。

組み立て
~60m
サーボの取り付け、ケーブルの配線、グリッパーの取り付け
ソフトウェアのインストール
~30m
Python、lerobot pip インストール、USB ドライバーのチェック
サーボキャリブレーション
~20m
LeRobot 調整コマンド - 自動
最初のテロップテスト
~15m
2 本の腕を持つリーダーとフォロワー、またはキーボード テロップ
最初のデータセット
~30m
50 エピソード、LeRobot 形式、HuggingFace にプッシュ

初日の合計時間: およそ 2.5 ~ 3 時間。 カーネル ドライバーのセットアップが不要なため、どの CAN バス アームよりも高速です。 初心者は午後に終わるのが一般的です。

ハードウェアチェックリスト

SO-101はDIYキットです。 独自の部品を調達するか、SVRC ストアから組み立て済みキットを購入します。

  • SO-101アーム(フォロアアーム) 6× Feetech STS3215 サーボを備えた 6-DOF アーム、3D プリントまたは CNC 加工されたフレーム。 GitHub 上のファイルを印刷 →
  • リーダーアーム (オプションですが推奨) 遠隔操作入力デバイスとして使用される 2 台目の SO-101。 リーダーとフォロワーが最高品質のデモンストレーションを行います。 片腕しかない場合は、キーボード テロップから始めることができます。
  • Feetech USBサーボコントローラー(STS/SCSバスアダプター) アームごとに 1 つ — USB 経由でサーボを PC に接続します。 「シリアル バス サーボ ドライバー ボード」と呼ばれることもあります。 SVRCストアで入手可能→
  • 5V DC 電源 (アームあたり最小 3A) DIYキットには付属しません。 バレルコネクタを備えた任意の安定化 5V 電源が動作します。 6 つのサーボはピーク負荷時に最大 2A を消費します。
  • ホスト PC (Windows、macOS、または Linux) Python 3.10以降が必要です。 ネイティブ Linux 要件はありません。シリアル バス ドライバーは標準の USB CDC デバイスです。 最小: 8 GB RAM。
  • サーボコントローラー用USB-Aケーブル 標準USBケーブル。 ほとんどのコントローラー ボードは、USB-A から USB-B、または USB-A からマイクロ USB を使用します。
  • USB WebカメラまたはIntel RealSense セットアップの場合はオプションですが、データ収集には必須です。 USBウェブカメラは正常に動作します。 RealSense D435i は奥行きを追加しますが、LeRobot では必要ありません。
  • 安定した取付面 SO-101は卓上アームです。 クランプまたはボルトで作業台に固定します。デモンストレーション中に滑ったり、校正がずれたりしてはなりません。

始める前にインストールするもの

セットアップガイド 各ステップを順を追って説明します。 これは概要ですので、事前に準備してください。

Python 3.10+

必須。 からインストールします python.org Windows/macOS の場合は、Linux のシステム パッケージ マネージャーを使用してください。 確認する:

python --version   # or python3 --version
# Should show Python 3.10.x or higher

ルロボット

SO-101 で制御、校正、記録するために必要な唯一のライブラリです。 仮想環境にインストールします。

python -m venv ~/.venvs/so101
source ~/.venvs/so101/bin/activate   # Windows: .venvs\so101\Scripts\activate
pip install lerobot

LeRobot には、SO-101 ロボット構成、サーボ校正スクリプト、および完全なデータ記録パイプラインが含まれています。 を参照してください。 ソフトウェアページ 完全なセットアップのために。

USBシリアルドライバー

Windows では、サーボ コントローラー ボードに応じて CP2102 または CH340 ドライバーをインストールします。 macOS と Linux では、通常、ドライバーが含まれています。 チェック:

# Linux / macOS — look for the device
ls /dev/ttyUSB* /dev/tty.usbserial*

# Windows — check Device Manager for "USB Serial Device"

ROSは不要

SO-101 は、USB シリアル経由の LeRobot の Python インターフェイス経由で完全に動作します。 ROS2、SocketCAN、またはカーネル ドライバーは必要ありません。 これは、初心者にとって CAN バス アームと比較した主な利点です。

フルパスの後にできること

セットアップ、キャリブレーション、最初のデータ収集が完了すると、次のことができるようになります。

LeRobot Python API を使用して、USB シリアル経由で 6 つのジョイントすべてをリアルタイムで制御
サーボのゼロ位置を自動的に校正します。 lerobot calibrate — 手動測定なし
リーダー/フォロワー モードで腕をテレオペし、同期した関節状態 + カメラ エピソードを記録します
LeRobot / HuggingFace 形式でデータセットをエクスポートし、ACT および拡散ポリシーのトレーニングに備えます
データセットを HuggingFace Hub にプッシュし、データのコミュニティ モデルを微調整します
SO-101 コミュニティ データセットに貢献する — 世界中の何百もの研究室が同じ形式を使用しています

準備ができて? セットアップガイドを起動します。

ハードウェアと Python をインストールしたら、セットアップには約 1 時間かかります。