自分の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. 実機につなぐ
open_busのmockでない側で,自分の機器のbus(read_positions,write_positions,enable_torque,close)を返します.nodes/follower.yamlのSET_ARM_ADDRESSを実際の値にし,limitsを実測した安全な範囲にします.- 入力機器(leader)を足すなら,
roboloom.inputs.base.JointInputを継承したclassとjointcontrollerを足します.
ほかの役割(sensor,controller)を足す規則は 自分のpackageから足す にあります.
次へ
- 方策を書く:自作の方策を動かす
- roboloom本体に機体を足す:新しいfollowerを足す