# Koch v1.1

Pada langkah-langkah di bawah, kami menjelaskan cara merakit robot Koch v1.1.

## Pesan dan rakit bagian-bagiannya

Ikuti instruksi pengadaan dan perakitan yang diberikan dalam [README](https://github.com/jess-moss/koch-v1-1) ini. Hal ini akan memandu Anda dalam mengatur lengan pengikut dan pemimpin, seperti yang ditunjukkan pada gambar di bawah.

Untuk panduan visual proses perakitan, Anda dapat merujuk pada [tutorial video ini](https://youtu.be/8nQIg9BwwTk).

> [!WARNING]
> Sejak produksi video ini, kami menyederhanakan fase konfigurasi. Karena hal ini, dua hal berbeda dari instruksi di video tersebut:
>
> - Jangan langsung colokkan semua kabel motor dan tunggu hingga diinstruksikan untuk melakukannya di [Configure the motors](#configure-the-motors). - Jangan langsung sekrup papan kontrol (PCB) ke dasar dan tunggu hingga diinstruksikan untuk melakukannya di [Configure the motors](#configure-the-motors).

## Install LeRobot 🤗

Untuk menginstal LeRobot, ikuti [Panduan Instalasi](./installation) kami

Selain instruksi ini, Anda perlu menginstal Dynamixel SDK (jika Anda menginstal LeRobot dari PyPI, jalankan `pip install 'lerobot[dynamixel]'` sebagai gantinya):

```bash
pip install -e ".[dynamixel]"
```

## Konfigurasikan motor

### 1. Temukan port USB yang terkait dengan masing-masing lengan

Untuk menemukan port untuk setiap bus servo adapter, jalankan skrip ini:

```bash
lerobot-find-port
```

Contoh keluaran:

```
Finding all available ports for the MotorBus.
['/dev/tty.usbmodem575E0032081', '/dev/tty.usbmodem575E0031751']
Remove the USB cable from your MotorsBus and press Enter when done.

[...Disconnect corresponding leader or follower arm and press Enter...]

The port of this MotorsBus is /dev/tty.usbmodem575E0032081
Reconnect the USB cable.
```

Port yang ditemukan adalah: `/dev/tty.usbmodem575E0032081` yang sesuai dengan lengan leader atau follower Anda.

Pada Linux, Anda mungkin perlu memberikan akses ke port USB dengan menjalankan:

```bash
sudo chmod 666 /dev/ttyACM0
sudo chmod 666 /dev/ttyACM1
```

Contoh keluaran:

```
Finding all available ports for the MotorBus.
['/dev/ttyACM0', '/dev/ttyACM1']
Remove the usb cable from your MotorsBus and press Enter when done.

[...Disconnect corresponding leader or follower arm and press Enter...]

The port of this MotorsBus is /dev/ttyACM1
Reconnect the USB cable.
```

Port yang ditemukan adalah: `/dev/ttyACM1` yang sesuai dengan lengan leader atau follower Anda.

### 2. Atur id dan baudrate motor

Setiap motor diidentifikasi oleh id unik di bus. Saat baru, motor biasanya memiliki id default `1`. Agar komunikasi antara motor dan controller berjalan dengan baik, kita perlu mengatur id unik yang berbeda untuk setiap motor. Selain itu, kecepatan transmisi data di bus ditentukan oleh baudrate. Agar controller dan semua motor dapat berkomunikasi, keduanya harus dikonfigurasi dengan baudrate yang sama.

Untuk tujuan tersebut, kita pertama perlu terhubung ke setiap motor secara individual dengan pengontrol untuk mengatur parameter ini. Karena kita akan menulis parameter ini ke bagian non-volatile dari memori internal motor (EEPROM), kita hanya perlu melakukan ini sekali.

Jika Anda menggunakan ulang motor dari robot lain, kemungkinan besar Anda juga perlu melakukan langkah ini, karena id dan baudrate kemungkinan tidak akan cocok.

#### Pengikut

Hubungkan kabel usb dari komputer Anda dan catu daya 12V ke papan kontrol lengan pengikut (lengan pemimpin menggunakan catu daya 5V). Kemudian, jalankan perintah berikut atau jalankan contoh API dengan port yang Anda dapatkan dari langkah sebelumnya. Anda juga perlu memberikan nama untuk lengan pengikut Anda dengan parameter `id`.

Untuk referensi visual tentang cara mengatur id motor, silakan lihat [video ini](https://huggingface.co/docs/lerobot/en/so101#setup-motors-video) di mana kami mengikuti proses untuk lengan SO101.

```bash
lerobot-setup-motors \
    --robot.type=koch_follower \
    --robot.port=/dev/tty.usbmodem575E0031751 # <- paste here the port found at previous step
```

```python
from lerobot.robots.koch_follower import KochFollower, KochFollowerConfig

config = KochFollowerConfig(
    port="/dev/tty.usbmodem575E0031751",
    id="my_awesome_follower_arm",
)
follower = KochFollower(config)
follower.setup_motors()
```

Anda harus melihat instruksi berikut.

```
Connect the controller board to the 'gripper' motor only and press enter.
```

Sesuai instruksi, colokkan motor gripper. Pastikan itu satu-satunya motor yang terhubung ke papan, dan bahwa motor tersebut belum di-daisy-chain ke motor lain. Saat Anda menekan `[Enter]`, skrip akan secara otomatis mengatur id dan baudrate untuk motor tersebut.

Pemecahan Masalah

Jika Anda mendapatkan error pada titik tersebut, periksa kabel Anda dan pastikan mereka terpasang dengan benar:

  Kabel daya USB antara komputer Anda dan papan pengontrol Kabel 3-pin dari papan pengontrol ke motor

Jika Anda menggunakan papan kontrol Waveshare, pastikan kedua jumper disetel pada kanal `B` (USB).

Anda seharusnya melihat pesan berikut:

```
'gripper' motor id set to 6
```

Diikuti oleh instruksi berikutnya:

```
Connect the controller board to the 'wrist_roll' motor only and press enter.
```

Anda dapat mencabut kabel 3-pin dari papan kontrol, tetapi biarkan kabel tersebut tetap terhubung ke motor gripper di ujung lainnya karena posisinya sudah tepat. Sekarang, colokkan kabel 3-pin lainnya ke motor pergelangan tangan (wrist roll) dan hubungkan ke papan kontrol. Sama seperti motor sebelumnya, pastikan itu adalah satu-satunya motor yang terhubung ke papan dan motor itu sendiri tidak terhubung ke motor lain.

Ulangi operasi untuk setiap motor sesuai instruksi.

> [!TIP]
> Periksa kabel Anda di setiap langkah sebelum menekan Enter. Misalnya, kabel catu daya bisa terlepas saat Anda memanipulasi papan.

Setelah selesai, skrip akan langsung berakhir, yang berarti motor sudah siap digunakan. Anda sekarang dapat menyambungkan kabel 3-pin dari setiap motor ke motor berikutnya, dan kabel dari motor pertama (‘shoulder pan’ dengan id=1) ke papan kontrol, yang kini dapat dipasang pada dasar lengan.

#### Pemimpin

Lakukan langkah yang sama untuk lengan pemimpin, tetapi modifikasi perintah atau skripnya sesuai kebutuhan.

```bash
lerobot-setup-motors \
    --teleop.type=koch_leader \
    --teleop.port=/dev/tty.usbmodem575E0031751
```

```python
from lerobot.teleoperators.koch_leader import KochLeader, KochLeaderConfig

config = KochLeaderConfig(
    port="/dev/tty.usbmodem575E0031751",
    id="my_awesome_leader_arm",
)
leader = KochLeader(config)
leader.setup_motors()
```

## Kalibrasi

Selanjutnya, Anda perlu melakukan kalibrasi pada robot Anda untuk memastikan bahwa lengan pemimpin dan pengikut memiliki nilai posisi yang sama ketika berada pada posisi fisik yang sama. Proses kalibrasi sangat penting karena memungkinkan jaringan saraf yang dilatih pada satu robot untuk berfungsi pada robot lain.

#### Pengikut

Jalankan perintah atau contoh API berikut untuk mengkalibrasi lengan pengikut:

```bash
# Use the port of your follower arm, and give the arm a unique name with --robot.id
lerobot-calibrate \
    --robot.type=koch_follower \
    --robot.port=/dev/tty.usbmodem58760431551 \
    --robot.id=my_awesome_follower_arm
```

```python
from lerobot.robots.koch_follower import KochFollowerConfig, KochFollower

config = KochFollowerConfig(
    port="/dev/tty.usbmodem585A0076891",
    id="my_awesome_follower_arm",
)

follower = KochFollower(config)
follower.connect(calibrate=False)
follower.calibrate()
follower.disconnect()
```

Kami telah menyatukan metode kalibrasi untuk sebagian besar robot. Dengan demikian, langkah-langkah kalibrasi untuk lengan Koch ini sama dengan langkah-langkah untuk SO100 dan SO101. Pertama, kita harus memindahkan robot ke posisi di mana setiap sendi berada di tengah rentangnya, lalu kita menekan `Enter`. Kedua, kita memindahkan semua sendi melalui rentang gerak penuh mereka. Video dari proses yang sama untuk SO101 sebagai referensi dapat ditemukan [di sini](https://huggingface.co/docs/lerobot/en/so101#calibration-video).

#### Pemimpin

Lakukan langkah yang sama untuk mengkalibrasi lengan pemimpin, jalankan perintah atau contoh API berikut:

```bash
# Use the port of your leader arm, and give the arm a unique name with --teleop.id
lerobot-calibrate \
    --teleop.type=koch_leader \
    --teleop.port=/dev/tty.usbmodem58760431551 \
    --teleop.id=my_awesome_leader_arm
```

```python
from lerobot.teleoperators.koch_leader import KochLeaderConfig, KochLeader

config = KochLeaderConfig(
    port="/dev/tty.usbmodem575E0031751",
    id="my_awesome_leader_arm",
)

leader = KochLeader(config)
leader.connect(calibrate=False)
leader.calibrate()
leader.disconnect()
```

Selamat 🎉, robot Anda sudah siap untuk belajar tugas secara mandiri. Mulai melatihnya dengan mengikuti tutorial ini: [Mulai dengan robot dunia nyata](./il_robots)

> [!TIP]
> Jika Anda memiliki pertanyaan atau membutuhkan bantuan, silakan hubungi kami di [Discord](https://discord.com/invite/s3KuuzsPFb).

