OpenArm 101

Tutoriais

Um caminho selecionado pelos melhores materiais do OpenArm — desde a comunicação SocketCAN até a teleoperação e registro de dados. Comece aqui e depois aprofunde-se nos artigos de pesquisa.

Melhores Primeiros Links

Se você é novo no OpenArm, comece com essas quatro fontes antes de explorar os artigos de pesquisa do SVRC. Elas fornecem a verdade oficial sobre como a pilha funciona.

Comece Aqui

Documentação oficial do OpenArm & GitHub

1

Guia de Software do OpenArm (oficial) Descrição do robô, integração SocketCAN, ROS2 e controles avançados. A visão geral autoritativa antes de mergulhar nos detalhes. Leia o guia oficial →
2

Documentos de Controle ROS2 Arquivos de lançamento, modo de hardware falso, configuração do controlador e comandos de movimento. Leia isso antes de tocar em hardware real. Abra os documentos de controle ROS2 →
3

Documentos da Biblioteca CAN Arquitetura SocketCAN, layout de classes, modo de controle MIT, IDs de motor, modos de callback e temporização. Essencial antes de escrever qualquer código de controle. Abra os documentos CAN →
4

Repositório Principal do GitHub Ponto de entrada do repositório: hardware, software, problemas e links do ecossistema. Abra problemas para encontrar respostas para problemas comuns. Ver GitHub →

Comunicação: SocketCAN e CAN Bus

Entenda como o braço se comunica antes de escrever código de controle. A maioria dos problemas de inicialização são problemas de CAN.

Guia de Pesquisa

Guia de Configuração do SocketCAN

Verificações de comunicação, mapeamento de IDs de motor, quadros de erro CAN e inicialização de interface. A referência canônica SVRC para problemas de configuração de CAN.

Leia o guia → Documentos Oficiais

Biblioteca CAN OpenArm

Documentos completos da API para openarm_can: classes de motor, formato de pacote de controle MIT, modos de callback e configuração de tempo limite.

Abrir documentos → Centro de software

Configuração do Driver (este hub)

Instalação passo a passo do driver CAN: carregamento de módulo do kernel, inicialização de interface, verificação de candump e configuração persistente.

Ver passos →

Nota prática

O que realmente importa na prática

As fontes mais comuns de problemas no CAN não são o uso inadequado da API — são a troca de modo de callback, ajuste de tempo limite e mapeamento inconsistente de ID CAN entre motores após atualizações de firmware. Verifique isso primeiro antes de qualquer outra coisa.

Controle: Modos de Controle ROS2 e MIT

Fluxos de inicialização de hardware e configuração do controlador. Sempre execute primeiro o hardware simulado, depois o hardware real.

Guia de Pesquisa

Guia de Controle ROS2

Modo de hardware simulado, inicialização de hardware real, disciplina do controlador, opções de arquivo de lançamento e exemplos de comandos de trajetória.

Leia o guia → Guia de Pesquisa

Guia de Ganhos de Controle do MIT

Notas de ajuste de Kp/Kd, valores iniciais seguros para cada junta, margens de segurança e o que fazer quando os ganhos causam oscilações.

Leia o guia → Guia de Pesquisa

Guia de Calibração e Homing

Procedimento de configuração do zero da junta, sequência de homing, verificação do espaço de trabalho e modos comuns de falha de calibração.

Leia o guia →

Nota prática

Simule primeiro, real depois

O OpenArm suporta o modo de hardware simulado de fábrica. Sempre valide seu código de controle com use_fake_hardware:=true antes de conectar a motores reais. Isso sozinho previne a maioria dos incidentes de danos ao hardware.

Nota prática

Ganhos e margens de segurança

Comece com Kp=20, Kd=0.5 para todas as juntas. Aumente lentamente. O guia de ganhos do MIT documenta os valores máximos seguros por junta — permanecer dentro deles previne o superaquecimento do motor e estresse mecânico.

Teleoperação e Registro de Dados

Grave demonstrações de alta qualidade para treinamento de políticas. Configuração de hardware, comandos de gravação e gerenciamento de conjuntos de dados.

Guia de Pesquisa

Guia de Teleoperação e Registro de Dados

Configuração de teleoperação de ponta a ponta: conexão do dispositivo do operador, gravação sincronizada de juntas e câmeras, reprodução de episódios e exportação RLDS/LeRobot.

Leia o guia → Página central

Fila de dados (este hub)

Conexões de hardware, fluxo de gravação do LeRobot, explicação do formato do conjunto de dados e lista de verificação de qualidade. Passo a passo completo.

Ir para a página → Artigo de Pesquisa

Como Coletar Dados de Demonstração

Princípios por trás da coleta de demonstração de robô de alta qualidade: consistência de cena, treinamento de operadores, manuseio de falhas e versionamento de conjuntos de dados.

Leia o artigo →

Treinamento de Modelo de IA

Depois de ter um conjunto de dados, o próximo passo é o treinamento de políticas. O OpenArm funciona imediatamente com ACT, Política de Difusão e OpenVLA.

Artigo de Pesquisa

OpenArm: Uma Plataforma Centrada em Dados

Filosofia de design completa: arquitetura de captura de dados, falha como dados, alinhamento sim-para-real e formato de saída pronto para aprendizado.

Leia o artigo → Modelos SVRC

Modelos de IA compatíveis

ACT, Política de Difusão e OpenVLA — pontos de verificação pré-treinados e guias de ajuste fino para conjuntos de dados do OpenArm.

Navegue pelos modelos → Conjuntos de Dados SVRC

Conjuntos de Dados Públicos do OpenArm

Conjuntos de dados da comunidade e SVRC no formato LeRobot, prontos para treinamento. Vá direto para o treinamento se não quiser coletar dados primeiro.

Navegar por conjuntos de dados →

Todos os Recursos do OpenArm SVRC

Cada página interna e artigo de pesquisa indexados em um só lugar. Use isso quando estiver procurando por um problema específico de implementação.

Anterior ← Coleta de Dados

Próximo Segurança →

Discuta o que você está construindo

Use o fórum OpenArm para perguntar sobre configuração CAN, inicialização do ROS2, calibração, registro de dados e decisões de depuração.

Fórum OpenArm → Biblioteca de Robótica Hub da Comunidade