Saltar al contenido principal

Primeros pasos con reBot Arm B601-RS

License: MITPython VersionPlatformPinocchio

Brazo robótico de 6 GDL · Soporte para múltiples motores · Solución de cinemática · Planificación de trayectorias · Totalmente de código abierto

Consigue uno ahora 🖱️

El proyecto reBot Arm ha sido publicado como código abierto en GitHub. Esta guía te llevará a través del inicio rápido del B601-RS, desde el montaje hasta la operación. El contenido de esta guía se dirige hacia ti a la velocidad de la luz — mantente atento.

Descargo de responsabilidad de seguridad y aviso de riesgos​

Sobre la fuente de alimentación​

  1. El brazo robótico no se envía con una fuente de alimentación / no incluye una fuente de alimentación por defecto. Puedes conectar una batería por tu cuenta, o comprar nuestra fuente de alimentación MeanWell de 48V 12.5A de código abierto o en Amazon. No compres fuentes de alimentación de fabricantes sin marca o de canales inseguros. Cualquier riesgo o consecuencia que surja de ello será asumido por el propio usuario.

Si el voltaje de tu hogar es 220V, ajusta el interruptor selector de voltaje en el lateral de la fuente de alimentación a 230V. Si el voltaje de tu hogar es 110V, cámbialo a 115V.

220V110V

  1. Como alternativa, puedes elegir nuestra carcasa de fuente de alimentación MeanWell de 24V 14.6A de código abierto para autoensamblaje. Las instrucciones de texto y la lista de materiales (BOM) están publicadas como código abierto en el repositorio de GitHub (recomendado solo para desarrolladores con experiencia relevante en montaje de fuentes de alimentación).

    Vídeo de referencia para el montaje:

Paso 1: Guía de montaje​

  • Antes del montaje, lee atentamente las siguientes instrucciones. Para garantizar un proceso de montaje fluido y una experiencia práctica completa, ten paciencia, mantén la concentración y sigue siempre estos puntos clave:
    1. Este kit incluye numerosos tornillos y piezas estructurales, algunas de las cuales se parecen entre sí. Verifica cuidadosamente las especificaciones de los tornillos y los modelos de las piezas, y confirma la orientación de instalación antes de apretar.
    2. El vídeo se grabó a principios de abril. Puede haber pequeños ajustes en las piezas posteriormente, pero esto no afecta a la calidad del montaje si sigues el vídeo. Las piezas finales están sujetas a lo que se envíe.
    3. Para facilitar la instalación y extracción de los tornillos, la BOM de código abierto especifica tornillos estándar. Sin embargo, los tornillos enviados con el kit tienen fijador de roscas aplicado. También puedes usar tus propias herramientas preferidas o un destornillador eléctrico (se recomienda encarecidamente tener uno preparado). Si utilizas una herramienta eléctrica, asegúrate de ajustar el par de apriete a un nivel bajo a medio (3–6 kgf·cm) para evitar un par excesivo que pueda barrer los tornillos, causando daños irreversibles que impidan retirar las piezas. Si hay cualquier indicio de que la cabeza se está barriendo, sustituye inmediatamente el tornillo o realinea y vuelve a intentarlo. Los tornillos con fijador de roscas barridos no pueden retirarse con un extractor de tornillos y arruinarán toda la pieza. Por lo tanto, procede con precaución.
    4. Da prioridad a la seguridad durante el montaje para evitar pellizcos en los dedos o lesiones por aplastamiento. Los niños deben completar este proyecto acompañados por un padre, madre o tutor.

Paso 2: Calibrar el brazo robótico y comenzar​

  1. Explora nuestra plataforma MotorBridge. Esta plataforma es una solución integral de una sola parada que admite la expansión continua de tipos de motores, cubriendo motores Damiao, motores Robstride, motores Hightorque, motores Myactuator, Hexfellow y más. También es compatible con productos de brazo robótico actualizados continuamente como reBot. La plataforma es fácil de usar para principiantes y también proporciona un SDK de Python con funcionalidad totalmente consistente para desarrolladores.

  2. Experimenta las nuevas funciones y detalles de MotorBridge adaptados específicamente al brazo robótico reBot, incluyendo calibración del punto cero con un solo clic, escritura de parámetros, control de motores mediante arrastrar y soltar a través de la interfaz de usuario, y una interfaz integrada de visualización de modelos.

  3. Esta herramienta es totalmente compatible con los sistemas operativos Windows, Ubuntu y macOS.

tip

  1. Se ha verificado que el rendimiento de las máquinas virtuales es insuficiente para ejecutar las demostraciones y existen problemas de configuración. Se recomienda utilizar una máquina física con Ubuntu para controlar el brazo robótico.

  2. (Versión beta) Deja que un agente te ayude a inicializar el brazo robótico. Copia el siguiente contenido y envíaselo al agente:

Please follow the process in AGENTS.md (https://github.com/Welt-liu/reBot-B601-Agent-Guide/blob/main/en/AGENTS.md) to help the user complete the initialization of a new robotic arm.

Nota: Si compraste un kit preensamblado, dile al agente durante el paso de escritura de ID de motor: "Compré un kit preensamblado, por favor escanea los motores 1–7 para verificar que todos estén en línea, no reescribas los ID de los motores."

  1. El agente utiliza comandos de CLI para completar la escritura de los ID de los motores, mientras que la wiki utiliza un método de interacción mediante interfaz web. Ambos enfoques funcionan.

Deberías haber completado la preparación preliminar para el montaje del brazo robótico siguiendo el vídeo. A continuación, presentaremos los pasos para escribir los ID de los motores y calibrar el brazo robótico.

Consulta el vídeo y el tutorial en texto. Antes de controlar el brazo robótico, necesitas restablecer el punto cero de nuevo.

1. Instalar Miniforge (recomendado) (Compatible con Windows\Ubuntu\macOS\Jetson\Raspberry Pi)​

  1. Instala Miniforge y crea un entorno virtual para evitar conflictos con otros paquetes de entorno que puedan causar fallos en las demostraciones.
wget "https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-$(uname)-$(uname -m).sh"
bash Miniforge3-$(uname)-$(uname -m).sh
  1. Crea un entorno virtual de Python 3.12:
tip

Usuarios de Git Bash: Si no se encuentra el comando conda, significa que Git Bash no ha cargado el entorno de conda. Primero necesitas inicializarlo:

# Temporary (current terminal only), replace <install_path> with the actual path
source <install_path>/etc/profile.d/conda.sh

# Permanent (write to bashrc, run once)
echo 'source <install_path>/etc/profile.d/conda.sh' >> ~/.bashrc
source ~/.bashrc

Para permitir que PowerShell active automáticamente el entorno conda:

conda init powershell
conda create -y -n rebot python=3.12
  1. Activa el entorno virtual. Debes volver a ejecutar este comando de activación cada vez que abras una terminal para usar las funciones relacionadas con reBot:
conda activate rebot

2. Instalar Motorbridge​

Después de activar el entorno virtual de reBot, ejecuta el siguiente comando para instalar motorbridge:

Nota para usuarios de macOS

Si experimentas bajas tasas de fotogramas durante la teleoperación en macOS, puede deberse a una versión obsoleta del controlador WCH CH34x. Para macOS 10.14 y posteriores, el sistema incluye un controlador integrado AppleUSBCHC0M. Puedes desinstalar el controlador antiguo y cambiar al controlador integrado de macOS, lo que debería mejorar eficazmente la tasa de fotogramas.

pip install motorbridge

3. PCAN-USB​

Haz que el dispositivo PCAN-USB funcione en el bus CAN a 1 Mbps para la comunicación con el brazo robótico.

# The kit includes PCAN-USB, which should normally show up as can0 or can1
sudo modprobe peak_usb
ip -br link

# If can0 appears, set the bitrate
sudo ip link set can0 down 2>/dev/null
sudo ip link set can0 type can bitrate 1000000
sudo ip link set can0 up
Atención

Si PCAN-USB no se detecta en el Administrador de dispositivos después de instalar el controlador, despliega la sección siguiente, descarga el firmware de PCAN y sigue los pasos de recuperación.

Descarga del firmware de PCAN y pasos de recuperación del controlador

Si PCAN-USB sigue sin funcionar después de instalar el controlador y el Administrador de dispositivos no muestra el dispositivo PCAN-USB como se ilustra a continuación, descarga el paquete de firmware de PCAN y sigue estos pasos para instalar el controlador DFU y volver a flashear el firmware.

PCAN-USB detected in Device Manager

📦 Download USB2CAN.zip

Instalar el controlador DFU​

  1. Extrae el paquete descargado. Contiene las carpetas Dfu tool y pcan.

Dfu tool and pcan folders extracted from the package

  1. Abre la carpeta Dfu tool y ejecuta el instalador .exe. Después de la instalación, anota la ruta de instalación del controlador, por ejemplo:
C:\Program Files (x86)\STMicroelectronics\Software\DfuSe v3.0.6\Bin\Driver

DfuSe installer and driver installation path

  1. Ajusta el interruptor DIP del módulo USB2CAN a BOOT, luego conecta el módulo a tu ordenador.

Set the USB2CAN DIP switch to BOOT

  1. Abre el Administrador de dispositivos, localiza Otros dispositivos → STM32 BOOTLOADER, haz clic derecho sobre él, selecciona Actualizar controlador y luego selecciona Buscar controladores en mi equipo.

STM32 BOOTLOADER in Device Manager

Select Browse my computer for drivers

  1. Pega la ruta del controlador DfuSeDemo anotada anteriormente en el campo de ubicación, selecciona Incluir subcarpetas y haz clic en Siguiente.

Enter the DfuSeDemo driver path and select Include subfolders

  1. Desconecta y vuelve a conectar el módulo USB2CAN. Si ahora se identifica como STM Device in DFU Mode, la actualización del controlador se realizó correctamente.

  2. Abre DfuSeDemo y confirma que detecta correctamente el módulo USB2CAN.

DfuSeDemo correctly detects the USB2CAN module

Flashear el firmware de PCAN​

  1. En DfuSeDemo, haz clic en Upgrade or Verify Action → Choose... y selecciona el firmware de la carpeta pcan extraída.
  2. Haz clic en Upgrade, haz clic en Yes en el cuadro de diálogo de confirmación y espera a que finalice el proceso de flasheo del firmware. Luego puedes cerrar DfuSeDemo.

Select the PCAN firmware and click Upgrade in DfuSeDemo

Firmware upgrade completed

Restaurar y verificar el dispositivo​

Desconecta el módulo USB2CAN, ajusta el interruptor DIP a 120R y vuelve a conectarlo al ordenador. Abre el Administrador de dispositivos. Si el dispositivo se identifica como PCAN-USB, el problema se ha resuelto y puedes continuar con esta guía.

PCAN-USB successfully detected in Device Manager

Descarga de firmware de PCAN y pasos de reparación del controlador - Ubuntu

Los usuarios de Ubuntu, por favor, consulten esta guía

1.> 📦 Haz clic para descargar USB2CAN.zip

  1. Cambia USB2CAN a BOOT

  2. Extrae el archivo USB2CAN.zip del paso 1 y coloca flash_pcan_ubuntu.sh y pcan_canable_hw.bin (desde el interior de USB2CAN.zip) en el mismo directorio

Haz clic para descargar flash_pcan_ubuntu.sh

Si se transfiere desde otro ordenador (por ejemplo, scp):

scp flash_pcan_ubuntu.sh pcan_canable_hw.bin seeed@your_Ubuntu_IP:~/Downloads/

O simplemente cópielo a una unidad flash USB y conéctela al equipo con Ubuntu: siempre que los archivos terminen en ~/Downloads, el directorio actual o /tmp, el script los encontrará automáticamente.

4.Ejecutar:

bash flash_pcan_ubuntu.sh

Introduzca su contraseña; espere a que finalice

Tras finalizar, cambie de nuevo a "120R"

Vuelva a conectar el USB.

Pasos para descargar el firmware de PCAN y reparar el controlador - MAC

Los usuarios de MAC, por favor, consulten esta guía

1.> 📦 Haga clic para descargar USB2CAN.zip

2.Cambie USB2CAN a BOOT

3.Por favor, extraiga el archivo USB2CAN.zip del paso 1 y coloque flash_pcan_mac.sh y pcan_canable_hw.bin (desde el interior de USB2CAN.zip) en el mismo directorio

Haga clic para descargar flash_pcan_mac.sh

Si se transfiere desde otro ordenador (por ejemplo, scp):

scp flash_pcan_mac.sh pcan_canable_hw.bin seeed@your_MAC_IP:~/Downloads/

O simplemente cópielo a una unidad flash USB y conéctela al MAC: siempre que los archivos terminen en ~/Downloads, el directorio actual o /tmp, el script los encontrará automáticamente.

4.Ejecutar:

bash /Users/"your_username"/Downloads/flash_pcan_mac.sh "/Users/"your_username"/Downloads/pcan_canable_hw.bin"

El comando anterior asume que los archivos se colocan en la ruta Downloads del Mac; ajústelo según su ruta real

Introduzca su contraseña; espere a que finalice

Tras finalizar, cambie de nuevo a "120R"

Vuelva a conectar el USB.

4. Iniciar MotorBridge-gateway para escribir puntos cero y depurar​

Antes del reinicio del motor​

Antes de la configuración de los parámetros del motor, tenga en cuenta las siguientes preparaciones y normas de seguridad:

  • Prepare 2 abrazaderas de sujeción (tamaño ≥3 pulgadas) y una fuente de alimentación conmutada de 48 V con salida XT30 (elija una marca de buena reputación; no utilice fuentes de alimentación de baja calidad).
  • Durante la depuración y el funcionamiento, mantenga una distancia de seguridad de al menos 1 metro.
  • No conecte ni desconecte los motores en caliente; desconecte la fuente de alimentación antes de enchufar o desenchufar el conector XT30 2+2.
  • No sobrecargue ni haga funcionar los motores a exceso de velocidad; compruebe el cableado y los elementos de fijación antes de la puesta en marcha; no utilice el equipo en entornos húmedos, de alta temperatura o con polvo.
  • Establezca parámetros de programa razonables y una función de parada de emergencia para evitar que el equipo se descontrole.
  • Siga estrictamente las reglas anteriores. El vendedor no se hace responsable de ningún riesgo o pérdida causada por operaciones no conformes o errores humanos.

Escritura de puntos cero y depuración mediante la interfaz web​

Abra la dirección motorbridge-studio en su navegador, haga clic en la opción Help, copie el comando correspondiente según su sistema operativo y placa controladora, verifique la dirección IP y el número de puerto y, a continuación, pulse Intro en la terminal para ejecutarlo.

motorbridge-gateway --bind 127.0.0.1:9002

macOS:

motorbridge-gateway --bind 127.0.0.1:9002

o

DYLD_FALLBACK_LIBRARY_PATH=/usr/local/lib motorbridge-gateway --bind 127.0.0.1:9002

Inicializar los parámetros de control del motor RS​

Complete la inicialización de parámetros antes del primer uso

La mayoría de los ejemplos de reBot Arm B601-RS se ejecutan en modo MIT. El modo de Posición nativa (pos_vel) utiliza directamente la ganancia del lazo de posición loc_kp y la velocidad máxima vel_max. Su comportamiento de movimiento también se ve afectado por la ganancia del lazo de velocidad spd_kp y el parámetro de aceleración acc_rad. Si los parámetros recomendados de B601-RS no se han inicializado, o si los parámetros guardados en cada articulación no son coherentes, el modo de Posición puede mostrar una respuesta, velocidad o comportamiento de aceleración y deceleración anómalos.

Primero seleccione rebot-arm-robstride en Robot Model en MotorBridge Studio, escanee y confirme que las articulaciones 1-7 están todas en línea y complete la calibración cero del brazo robótico descrita anteriormente. A continuación, realice los siguientes pasos:

  1. Haga clic en Read Parameters para leer los parámetros guardados actualmente en todas las articulaciones en línea. Esta operación solo lee datos y no modifica los motores. Espere hasta que la página indique que los parámetros de control se han leído correctamente y conserve los valores actuales como registro.
  2. Haga clic en Apply Default Template y confirme que la página indica que la plantilla de parámetros predeterminados de reBot Arm RobStride se ha aplicado a las articulaciones 1-7. Esta operación solo carga los valores recomendados en la página; aún no los escribe en los motores.
Leer los parámetros del motor B601-RS y aplicar la plantilla predeterminada
  1. Haga clic en Write Parameters. Confirme que el brazo robótico está soportado de forma segura y que no hay personas ni obstáculos cerca, y luego confirme la operación de escritura en el cuadro de diálogo. No desconecte la alimentación ni conecte o desconecte cables de motor mientras se están escribiendo los parámetros.
Confirmar la escritura de los parámetros del motor B601-RS
  1. Una vez completada la escritura, MotorBridge Studio lee automáticamente de nuevo los parámetros. La inicialización se habrá realizado correctamente cuando la página indique que la verificación de lectura posterior a la escritura coincide.
Loading Comments...