LeRobot documentation

OMX

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

OMX

OMX

Ordene e monte as partes

Primeiro, monte o hardware do OMX seguindo o guia de montagem oficial.

Guia de montagem do OMX: https://ai.robotis.com/omx/assembly_guide_omx.html

Os robôs OMX são enviados pré-configurados da fábrica. Os IDs dos motores, os parâmetros de comunicação e os offsets das juntas já estão definidos, portanto, nenhum ajuste adicional de motores ou calibração é necessário antes de usar o LeRobot.

Instale o LeRobot 🤗

Para instalar o LeRobot, siga nosso Guia de Instalação

Além dessas instruções, você precisa instalar o suporte para motores Dynamixel:

pip install -e ".[dynamixel]"

Conecte o robô

Para encontrar a porta de cada adaptador de servo de barramento, execute este script:

lerobot-find-port

Este comando é executado e, quando solicitado, desconecte o cabo USB do braço líder ou seguidor e pressione Enter. A saída exibirá ‘The port of this MotorsBus is [port]’. Isso identifica a porta do braço desconectado. Repita para o outro braço para identificar ambas as portas.

Mac
Linux

Exemplo de saída no macOS:

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.

Onde a porta encontrada é: /dev/tty.usbmodem575E0032081, correspondente ao seu braço líder ou seguidor.

Teleoperação

Após identificar as portas corretas, você pode teleoperar diretamente o braço seguidor usando o braço líder.

Mac
Linux

Teleopere sem câmera

lerobot-teleoperate \
  --robot.type=omx_follower \
  --robot.port=<your_follower_port> \
  --robot.id=omx_follower_arm \
  --teleop.type=omx_leader \
  --teleop.port=<your_leader_port> \
  --teleop.id=omx_leader_arm

Durante a teleoperação, os movimentos do braço líder são espelhados em tempo real pelo braço seguidor. O OMX já está pré-configurado, a teleoperação pode começar imediatamente, sem etapas de calibração.

Teleopere com câmera

Você também pode habilitar a entrada da câmera durante a teleoperação fornecendo uma configuração de câmera para o braço seguidor.

lerobot-teleoperate \
  --robot.type=omx_follower \
  --robot.port=<your_follower_port> \
  --robot.id=omx_follower_arm \
  --robot.cameras="{front: {type: opencv, index_or_path: '/dev/video0', width: 640, height: 480, fps: 30}}" \
  --teleop.type=omx_leader \
  --teleop.port=<your_leader_port> \
  --teleop.id=omx_leader_arm \
  --display_data=true

Quando a câmera está habilitada, o fluxo da câmera é exibido em tempo real e sincronizado com o estado do robô. Essa configuração é útil para monitoramento visual e pode ser reutilizada posteriormente para gravação de demonstrações e aprendizado por imitação.

Parabéns 🎉, seu robô está pronto para aprender uma tarefa por conta própria.

Se você tiver alguma dúvida ou precisar de ajuda, entre em contato no Discord.

Update on GitHub