OpenArm 101

Tutoriales

Un camino curado a través de los mejores materiales de OpenArm — desde la comunicación SocketCAN hasta la teleoperación y el registro de datos. Comience aquí, luego profundice a través de los artículos de investigación.

Mejores enlaces iniciales

Si es nuevo en OpenArm, comience con estas cuatro fuentes antes de explorar los artículos de investigación de SVRC. Le brindan la verdad oficial sobre cómo funciona la pila.

Comienza Aquí

Documentación oficial de OpenArm y GitHub

1

Guía de software de OpenArm (oficial) Descripción del robot, integración de SocketCAN, ROS2 y controles avanzados. La visión general autorizada antes de sumergirse en los detalles. Leer guía oficial →
2

Documentación de ROS2 Control Archivos de lanzamiento, modo de hardware simulado, configuración del controlador y comandos de movimiento. Lee esto antes de tocar hardware real. Abre la documentación de ROS2 Control →
3

Documentación de la biblioteca CAN Arquitectura de SocketCAN, diseño de clases, modo de control MIT, IDs de motor, modos de callback y temporización. Esencial antes de escribir cualquier código de control. Abre la documentación de CAN →
4

Repositorio principal de GitHub Punto de entrada del repositorio: hardware, software, problemas y enlaces del ecosistema. Abre problemas para encontrar respuestas a problemas comunes. Ver GitHub →

Comunicación: SocketCAN y CAN Bus

Entiende cómo se comunica el brazo antes de escribir código de control. La mayoría de los problemas de inicio son problemas de CAN.

Guía de investigación

Guía de configuración de SocketCAN

Verificaciones de comunicación, mapeo de IDs de motor, tramas de error de CAN y configuración de interfaz. La referencia canónica de SVRC para problemas de configuración de CAN.

Leer guía → Documentación oficial

Biblioteca CAN de OpenArm

Documentación completa de la API para openarm_can: clases de motor, formato de paquete de control MIT, modos de callback y configuración de tiempo de espera.

Abrir documentos → Centro de software

Configuración del controlador (este centro)

Instalación del controlador CAN paso a paso: carga del módulo del kernel, configuración de la interfaz, verificación de candump y configuración persistente.

Ver pasos →

Nota práctica

Lo que realmente importa en la práctica

Las fuentes más comunes de problemas de CAN no son el mal uso de la API; son el cambio de modo de callback, la sintonización de tiempo de espera y el mapeo inconsistente de ID de CAN entre motores después de las actualizaciones de firmware. Verifica estos primero antes que nada.

Control: Modos de Control ROS2 y MIT

Flujos de activación de hardware y configuración del controlador. Siempre ejecuta primero hardware simulado, luego hardware real.

Guía de investigación

Guía de Control ROS2

Modo de hardware simulado, activación de hardware real, disciplina del controlador, opciones de archivo de lanzamiento y ejemplos de comandos de trayectoria.

Leer guía → Guía de investigación

Guía de Ganancias de Control MIT

Notas de sintonización Kp/Kd, valores de inicio seguros para cada articulación, márgenes de seguridad y qué hacer cuando las ganancias causan oscilación.

Leer guía → Guía de investigación

Guía de Calibración y Homing

Procedimiento de ajuste a cero de articulaciones, secuencia de homing, verificación del espacio de trabajo y modos comunes de fallo de calibración.

Leer guía →

Nota práctica

Simular primero, real después

OpenArm soporta el modo de hardware simulado de forma predeterminada. Siempre valida tu código de control con use_fake_hardware:=true antes de conectar a motores reales. Esto solo previene la mayoría de los incidentes de daño al hardware.

Nota práctica

Ganancias y márgenes de seguridad

Comienza con Kp=20, Kd=0.5 para todas las articulaciones. Aumenta lentamente. La guía de ganancias de MIT documenta los valores máximos seguros por articulación; mantenerse dentro de ellos previene el sobrecalentamiento del motor y el estrés mecánico.

Teleoperación y Registro de Datos

Graba demostraciones de alta calidad para la capacitación en políticas. Configuración de hardware, comandos de grabación y gestión de conjuntos de datos.

Guía de investigación

Guía de Teleop y Registro de Datos

Configuración de teleoperación de extremo a extremo: conexión del dispositivo del operador, grabación sincronizada de articulaciones y cámaras, reproducción de episodios y exportación RLDS/LeRobot.

Leer guía → Página principal

Recolección de datos (este hub)

Conexiones de hardware, flujo de trabajo de grabación de LeRobot, explicación del formato del conjunto de datos y lista de verificación de calidad. Paso a paso completo.

Ir a la página → Artículo de Investigación

Cómo recolectar datos de demostración

Principios detrás de la recolección de demostraciones de robot de alta calidad: consistencia de la escena, capacitación del operador, manejo de fallos y versionado del conjunto de datos.

Leer artículo →

Entrenamiento de Modelos de IA

Después de tener un conjunto de datos, el siguiente paso es el entrenamiento de políticas. OpenArm funciona directamente con ACT, Diffusion Policy y OpenVLA.

Artículo de Investigación

OpenArm: Una Plataforma Centrada en Datos

Filosofía de diseño completa: arquitectura de captura de datos, fallo como datos, alineación sim-a-real y formato de salida listo para el aprendizaje.

Leer artículo → Modelos SVRC

Modelos de IA compatibles

ACT, Diffusion Policy y OpenVLA — puntos de control preentrenados y guías de ajuste fino para conjuntos de datos de OpenArm.

Navegar modelos → Conjuntos de datos SVRC

Conjuntos de datos públicos de OpenArm

Conjuntos de datos de la comunidad y SVRC en formato LeRobot, listos para el entrenamiento. Salta directamente al entrenamiento si no deseas recolectar datos primero.

Navegar conjuntos de datos →

Todos los recursos de OpenArm SVRC

Cada página interna y artículo de investigación indexados en un solo lugar. Utiliza estos cuando busques un problema de implementación específico.

Anterior ← Recolección de Datos

Siguiente Seguridad →

Discuta lo que está construyendo

Utilice el foro de OpenArm para preguntar sobre la configuración de CAN, el arranque de ROS2, la calibración, el registro de datos y las decisiones de depuración.

Foro OpenArm → Biblioteca de Robótica Centro de Comunidad