Guía de configuración de OpenArm: desde la descajación hasta la primera teleoperación
Guía de configuración completa de OpenArm: lista de verificación de descajo, pasos de ensamblaje, calibración, conexión a la plataforma RCSV, ejecución de su primera sesión de teleoperación y consejos para la recopilación de datos.
Parte de: [Guía de la teleoperación]
OpenArm es la plataforma de código abierto del brazo robótico de RCSV diseñada para la recopilación de datos de aprendizaje de imitación. Esta guía le guía a través de cada paso desde la apertura de la caja de envío hasta la finalización de su primera demostración teleoperada y la grabación de su primer episodio del conjunto de datos.
Lista de control de descajo
Inspeccione todos los componentes en la lista de embalaje antes de desechar cualquier embalaje. Un kit OpenArm estándar incluye: el brazo seguidor (6-DOF brazo robot con articulaciones servo-driven y agarre integrado), el brazo líder (replica cinemática pasiva utilizada por el operador para teleoperar), dos cámaras USB (montadas en la muñeca y por encima), la placa de control y el centro USB, una fuente de alimentación 24V, todo el hardware M3 y M4 requerido, un tornador de par, y el cable de control USB-A a USB-C. Los kits que incluyen la opción de cálculo también se envían con un mini-PC configurado con Ubuntu 22.04 y la pila de software RCSV preinstalada.
Verifique los cables de servo de ambos brazos para detectar cualquier pinzamiento o agitación que pueda haber ocurrido durante el envío. Si alguna articulación se siente rígida o inclinada en lugar de ser suave y compatible, no se aplique el
Coloque el hardware en un espacio de trabajo limpio con al menos 1 m de distancia alrededor del brazo robótico en todas las direcciones antes de la montaje. El brazo líder puede colocarse junto al seguidor o opuesto al operador dependiendo de su estilo de trabajo preferido; la mayoría de los operadores encuentran que colocar el brazo líder directamente a su lado dominante es el arreglo más natural.
Los pasos de la asamblea
Si su OpenArm llegó parcialmente desmontado para el envío (la mayoría de los kits se envían con el brazo superior desprendido para protección), comience conectando el segmento superior del brazo a la articulación del hombro. Alinea los agujeros de montaje y usa los tornillos M4 proporcionados con el destornillador de par fijado a 0.8 Nm
Coloque la cámara de muñeca utilizando el soporte impreso incluido en el kit. Ruta el cable USB a través del canal del antebrazo junto al cable servo del agarre. La cámara aérea se monta en un soporte separado (incluido en los kits completos) posicionado aproximadamente 600 mm por encima y 300 mm detrás de la base del brazo del seguidor, en ángulo de 30
Conectar la placa de control a la cadena de servidor del brazo seguidor a través del conector JST en el primer servo en la base. La placa de control alimenta a todos los servos a través de un bus de alimentación con cadena de margaritas; confirmar la polaridad de cada conector antes de aplicar energía. Conectar la fuente de alimentación de 24V a la placa de control (el conector de barril, no el conector de bus de servidor). Conecte la placa de control a su computadora a través del cable USB-C incluido. Finalmente, conecte ambas cámaras al centro USB y el centro para calcular a través de USB-A.
Calibración
La calibración establece la posición cero de cada articulación
El procedimiento de calibración dura aproximadamente 10 minutos. Se le pedirá que mueva cada articulación a su posición de origen definida
La plataforma RCSV incluye un flujo de trabajo de calibración de cámara basado en la tabla ChArUco que calcula los parámetros intrínsecos y la transformación extrínseca entre la cámara de muñeca, la cámara de cabeza y el marco de base del robot. Imprima la tabla de calibración en la escala especificada (papel A3, escala 100%), recoge 30
Conexión a la plataforma RCSV
La plataforma [RCSV] (T19
Una vez que el agente se conecte, el dispositivo aparecerá como "Online" en el panel de plataforma. Puede verificar la conexión transmitiendo en vivo los datos de estado conjunto y las imágenes de la cámara desde la vista del dispositivo de la plataforma. Este feed en vivo también es útil para monitorear las sesiones de recopilación de datos de forma remota y para revisar la calidad del episodio sin descargar archivos de datos en bruto. El explorador de conjuntos de datos de la plataforma le permite etiquetar, anotar y administrar episodios directamente en el navegador.
Su primera sesión de teleoperatoria
Habilitar el modo de teleoperación en la plataforma RCSV o a través de la herramienta de línea de comandos:
Para su primer episodio grabado, elija una tarea simple y repetible: recoger un cubo de una posición fija y colocarlo en un objetivo marcado. Práctica el movimiento con el sistema de teleoperatorio durante 5
Instalación de software: ROS 2 y el OpenArm SDK
Si ha recibido la opción de cálculo con un mini-PC preconfigurado, salte a "Verificar la pila de software" a continuación.
** Paso 1 - Instalar Ubuntu 22.04 LTS.** La pila de software de OpenArm se dirige exclusivamente a Ubuntu 22.04. Otras distribuciones y versiones pueden funcionar pero no están probadas o soportadas. Utilice una instalación limpia, no una doble arranque o VM. La comunicación servo en tiempo real requiere una latencia USB consistente que los entornos virtualizados no pueden garantizar.
** Paso 2 - Instalar ROS 2 Humble.** ROS 2 Humble Hawksbill es la versión LTS que los paquetes OpenArm se dirigen a. Instalar utilizando los paquetes oficiales de Debian:
sudo apt update && sudo apt install software-properties-common
sudo add-apt-repository universe
sudo curl -sSL https://raw.githubusercontent.com/ros/rosdistro/master/ros.key \
-o /usr/share/keyrings/ros-archive-keyring.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/ros-archive-keyring.gpg] \
http://packages.ros.org/ros2/ubuntu $(. /etc/os-release && echo $UBUNTU_CODENAME) main" \
| sudo tee /etc/apt/sources.list.d/ros2.list > /dev/null
sudo apt update && sudo apt install ros-humble-desktop python3-colcon-common-extensions
Fuente la configuración ROS 2 en su perfil de shell:
** Paso 3 -- Instalar el SDK OpenArm Python.** El SDK proporciona la capa de comunicación servo de bajo nivel, utilidades de calibración y el controlador de teleoperación:
pip install openarm-sdk
# Or from source for development:
git clone https://github.com/svrc-robotics/openarm-sdk.git
cd openarm-sdk && pip install -e ".[dev]"
** Paso 4 -- Instalar el agente RCSV.** El agente RCSV conecta su OpenArm a la plataforma RCSV para el monitoreo remoto, grabación de episodios y gestión de conjuntos de datos:
pip install svrc-agent
svrc-agent init # Creates ~/.svrc/config.yaml
** Verificación de la pila de software.** Ejecutar la herramienta de diagnóstico integrada para confirmar que todo está funcionando:
openarm diagnose --all
# Expected output:
# [OK] USB servo chain detected (6 servos on /dev/ttyUSB0)
# [OK] Leader arm detected (6 joints on /dev/ttyUSB1)
# [OK] Camera 0: /dev/video0 (640x480 @ 30fps)
# [OK] Camera 1: /dev/video2 (640x480 @ 30fps)
# [OK] ROS 2 Humble: active
# [OK] RCSV Agent: connected to platform
El Consejo adoptó una propuesta de reglamento por la que se establece un régimen de control de la posición común.
Antes de ejecutar la teleoperación, compruebe si puede controlar las articulaciones individuales de forma programada. Esto confirma que la cadena de servo, los desreglos de calibración y el bus de comunicación están funcionando correctamente.
from openarm import OpenArm
import time
arm = OpenArm(port="/dev/ttyUSB0")
arm.connect()
# Read current joint positions (radians)
print("Current positions:", arm.get_joint_positions())
# Move joint 1 (shoulder) to 0.5 rad at 30% speed
arm.move_joint(joint_id=1, position=0.5, speed=0.3)
time.sleep(2)
# Move to a named home pose
arm.move_to_home()
time.sleep(2)
# Move through a sequence of waypoints
waypoints = [
[0.0, -0.5, 1.0, 0.0, 0.5, 0.0], # approach
[0.0, -0.3, 0.8, 0.0, 0.3, 0.5], # pre-grasp
[0.0, -0.3, 0.8, 0.0, 0.3, 1.0], # close gripper
]
for wp in waypoints:
arm.move_joints(wp, speed=0.2)
time.sleep(1.5)
arm.disconnect()
Si alguna articulación no responde o se mueve a una posición inesperada, vuelva a calibrar la articulación antes de proceder. El problema más común es un conflicto de servo ID - dos servos asignados el mismo ID en el bus. Utilice
Problemas comunes y soluciones
| Symptom | Likely Cause | Fix |
|---|---|---|
| Servo LED amber on power-up | Communication bus error; bad JST connection | Reseat JST connector; check for bent pins |
| Servo LED red on power-up | Overcurrent fault (stalled motor or short) | Power off, check for mechanical binding; replace servo if persistent |
| Follower arm drifts during teleoperation | PID gains too low or calibration offset drift | Re-run calibration; increase P gain by 10-20% in servo config |
| Camera feed black or frozen | USB bandwidth conflict with servo chain | Move cameras to a separate USB controller (different physical port group) |
| openarm diagnose shows 5/6 servos | Servo ID conflict or broken daisy chain | Run openarm scan-servos; re-assign IDs with openarm set-id |
| High-pitched whine from servo | Servo fighting against hard limit or calibration offset wrong | Re-calibrate the joint; check that no wires are caught in joint mechanism |
| RCSV agent shows "Disconnected" | Device token expired or network issue | Regenerate token in platform dashboard; check firewall allows outbound HTTPS |
| Episodes not appearing in platform | Agent not running or config.yaml path wrong | Check systemctl status svrc-agent; verify ~/.svrc/config.yaml contains correct token |
Los próximos pasos después de la instalación
Una vez que tu OpenArm se monta, calibre, se conecta a la plataforma, y has verificado el control conjunto y la teleoperatoria, aquí está la progresión recomendada:
- Practica la teleoperatoria (2-4 horas). Pasa tiempo desarrollando la memoria muscular con el brazo líder. Comience con grandes movimientos (movimientos a posiciones en el espacio de trabajo) antes de intentar una manipulación fina (apoderarse de objetos pequeños).
- Recoge un conjunto de datos de calibración (50 episodios). Grabe 50 demostraciones de una simple tarea de pick-and-place. Revise cada episodio en la plataforma. Este conjunto de datos valida toda su pipeline desde el hardware hasta el almacenamiento y le permite detectar cualquier problema restante antes de invertir en campañas de recolección más grandes.
- Enséñase una política de prueba. Utilice el conjunto de datos de 50 episodios para entrenar una política de ACT o difusión utilizando LeRobot. Si la política logra un éxito del 40-60% en la tarea simple, su hardware y pipeline de datos están funcionando correctamente. Si logra menos del 30%, revise la calidad de sus datos utilizando el marco de calidad de datos.
- Escala a la recopilación de producción. Una vez que se valide la tubería, haga escala a su tamaño de conjunto de datos objetivo. Para la mayoría de las políticas de manipulación de tareas únicas, las demostraciones de 200 a 500 son el rango típico. Para la ajuste fino del modelo de multitarea o de la base, planifique entre 1.000 y 5.000 demostraciones.
Las especificaciones de OpenArm en un vistazo
| Specification | Value |
|---|---|
| Degrees of freedom | 6 DOF + gripper |
| Maximum reach | 850 mm |
| Repetibilidad | +/- 1 mm |
| Carga Útil | 500 g sustained |
| Control frequency | 50 Hz (configurable to 100 Hz) |
| Communication | USB serial (TTL half-duplex) |
| Power supply | 24V DC, 5A max |
| Weight (follower arm) | 2.8 kg |
| Price | $4,500 (leader + follower kit) |
Consejos de recopilación de datos
Mantener una velocidad constante durante las demostraciones. Cambios repentinos de velocidad
El trabajo de los operadores se produce en las horas de descanso de 30 a 45 minutos. Los episodios de la plataforma de análisis de sesión de RCSV señalan que la duración de la demostración es una anomalía (demasiado rápida o demasiado lenta en comparación con la media de la sesión), proporcionando una señal de calidad automatizada. Para escalar más allá de lo que un solo operador puede producir, el [servicio de recogida administrada] de RCSV proporciona a equipos de operadores capacitados con protocolos de calidad estructurados. [Contacta con nosotros]
Lectura relacionada
- Guía de compra de robots de brazo 2026 -- Cómo OpenArm se compara con UR5e, Franka FR3 y otras plataformas
- [¿Qué hace buenos datos de entrenamiento de robots?]
T28 ) -- Las 6 dimensiones de calidad que sus datos recogidos deben cumplir - Guía de LeRobot -- Formación en ACT y en la política de difusión de sus conjuntos de datos OpenArm
- Desglose de los costes de la recopilación de datos de robots -- Planificación presupuestaria de sus campañas de recopilación de datos
- Mejores manos robóticas 2025 -- Efectores finales dexterosos compatibles con OpenArm
- Servicios de datos de la RCSV -- Recopilación gestionada con operadores capacitados y tuberías de calificación
- Robot Leasing -- Prueba OpenArm con un contrato de arrendamiento a corto plazo antes de comprar
Relacionado: OpenArm in Store · Guía de compra de brazos robóticos 2026 · Aprendizaje de imitación para robots · Plataforma de teleoperación · Servicios de datos