コンテンツにスキップ

自分のrobotを足す

模擬のみ

  • 目的:roboloomを変えずに,自分のfollowerのclassとtemplateからprojectを作り,模擬のbusで方策を動かす.
  • 前提:roboloomのrepositoryをcloneしている(examples/own_robot/ はcloneした中だけにある).装置なしで一周する の環境がある.
  • 所要:20分.
  • 結果:.roboloom/lab_arm/ ができ,infer --mock で模擬の腕が動いて,datasets/lab-arm に1 episodeが保存される.
flowchart LR
  T["examples/own_robot<br/>template"] -- "init --template" --> P[".roboloom/lab_arm"]
  P --> C["my_arm.py<br/>MyArm(Follower)"]
  C --> B["open_bus(mock)<br/>MockBus"]

1. templateを見る

file 中身
config.yaml follower arm と,方策のcontroller policy だけの構成
my_arm.py followerのclass MyArm.関節 shoulder,elbow,単位 rad
nodes/follower.yaml type: my_arm:MyArm(module:Class),address,limits
nodes/policy.yaml factory: roboloom.policy:hold(その場に留める),observe: []
mock.yaml --mock のときの SET_ARM_ADDRESS の値
# examples/own_robot/my_arm.py(抜粋)
class MyArm(Follower):
    model = "my_arm"
    keys = (*FOLLOWER_KEYS, "address")
    safety_traits = SafetyTraits(torque_off="falls", unattended="holds")

    def __init__(self, name: str, cfg: dict):
        super().__init__(name, cfg, JOINTS, "rad")
        self.address = str(cfg.get("address"))

    def open_bus(self, mock: bool) -> JointBus:
        if mock:
            return MockBus(initial=0.0, dimension=len(JOINTS))
        raise NotImplementedError(f"{self.name}: connect to {self.address} here")
  • keys は,YAMLで読むkeyです.それ以外のkeyは読み込みのときに拒否します.
  • safety_traits は必ず宣言します.脱力したとき(torque_off)と指令が来なくなったとき(unattended)の性質で,確かめていないものは unknown にします.

2. projectを作る

uv run roboloom init lab_arm --template examples/own_robot

created .roboloom/lab_arm (7 files) と出ます.classのmodule my_arm.py もrobotのdirectoryに写るので,各nodeのprocessがそこから読み込みます.

3. 模擬で動かす

uv run roboloom infer lab_arm --mock --seconds 5 --plain
uv run roboloom infer lab_arm --mock --seconds 5 --plain --task hold
uv run roboloom check-dataset lab_arm --mock
  • 1行目は保存しません(discarded 'inference').2行目は --task があるので保存します.
  • check-dataset で episodes: 1 と problems: none を確かめます.

4. 実機につなぐ

  1. open_bus の mock でない側で,自分の機器のbus(read_positions,write_positions,enable_torque,close)を返します.
  2. nodes/follower.yaml の SET_ARM_ADDRESS を実際の値にし,limits を実測した安全な範囲にします.
  3. 入力機器(leader)を足すなら,roboloom.inputs.base.JointInput を継承したclassと joint controllerを足します.

ほかの役割(sensor,controller)を足す規則は 自分のpackageから足す にあります.

次へ