7. Preparar o braço robótico
Dois braços: um líder que você move com a mão e um seguidor que repete o movimento. Instale o ambiente, grave os IDs de servos (pule nos pré-montados), calibre os dois e verifique com uma primeira teleoperação.
7.1 Os dois braços
7.1 Os dois braços
Braço líder — um braço open source de baixo custo para ensino e pesquisa, disponível como unidade completa ou kit DIY. Seis juntas com servos STS3215 de 7,4 V numa fonte de 5 V; ele apenas lê ângulos de juntas.
Braço seguidor — o que executa. No kit Pro roda servos de 12 V; espelha o líder durante a teleoperação e depois executa a política VLA treinada.
O líder roda em 5 V e o seguidor em 12 V. Inverter pode danificar os servos. Desligue ambos antes de trocar qualquer cabo.
O passo a passo completo de montagem está no curso iniciante: capítulo 6 — configurar motores e montar os braços cobre impressão 3D, planejamento de motores, gravação de IDs e montagem; o capítulo 7 — depuração de servos cobre a ferramenta Feetech para um servo problemático.
7.2 Instalar o ambiente LeRobot
7.2 Instalar o ambiente LeRobot
Antes de calibrar, instale o ambiente exato usado pelos próximos
capítulos. Instale o uv primeiro e crie o workspace:
curl -LsSf https://astral.sh/uv/install.sh | sh
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
uv --version
mkdir ~/rebot_lerobot
cd ~/rebot_lerobot
sudo apt update
sudo apt install -y ffmpeg
# Baixa o fork da Seeed (inclui suporte líder/seguidor SO101)
git clone https://github.com/Seeed-Projects/lerobot.git
# Cria o ambiente virtual (Python 3.12)
uv venv --python 3.12 .venv
source .venv/bin/activate
uv pip install --upgrade pip
uv pip install -e ./lerobot
# SDK de servos Feetech — obrigatório para os barramentos SO-01
uv pip install feetech-servo-sdk
O ambiente é configurado uma única vez. Os capítulos seguintes assumem que
você volta a ele com:
cd ~/rebot_lerobot && source .venv/bin/activate
7.3 Kit ou pré-montado?
7.3 Kit ou pré-montado?
| Sua situação | Montagem | Gravar IDs | Calibração |
|---|---|---|---|
| Versão impressa / kit | Sim | Sim | Sim |
| Braço pré-montado | Já feito | Pular — IDs gravados na fábrica | Sim |
Se comprou braços pré-montados, vá direto para 7.4 Calibrar os braços.
Etiquete cada servo antes de montar — F1–F6 nos do seguidor e L1–L6 nos do líder. Junta 1 = ombro horizontal, 2 = ombro vertical, 3 = cotovelo, 4 = pitch do punho, 5 = rotação do punho, 6 = garra. As juntas 1–3 do líder SO-ARM101 usam razões de redução diferentes do SO-ARM100 — confira a tabela do capítulo 6.2 iniciante antes de montar.
Os seis servos compartilham um barramento serial. Grave os IDs com um único servo ligado à placa, ou um ID duplicado será gravado em todos os servos que o tiverem.
7.4 Gravar IDs de servos (somente versão kit)
7.4 Gravar IDs de servos (somente versão kit)
Primeiro encontre a porta da placa de controle:
lerobot-find-port
Desconecte a placa quando solicitado e reconecte; a porta impressa é a
sua (normalmente /dev/ttyACM0).
Grave os IDs junta por junta:
lerobot-setup-motors \
--robot.type=so101_follower \
--robot.port=/dev/ttyACM0
A ferramenta indica a junta a conectar — ligue só esse servo, aperte Enter e ela grava o ID e o baud rate:
Connect the controller board to the 'gripper' motor only and press enter.
Repita para as seis juntas do seguidor e rode a mesma ferramenta para o líder:
lerobot-setup-motors \
--teleop.type=so101_leader \
--teleop.port=/dev/ttyACM1
Configure as permissões da porta serial (persistentes após reiniciar):
sudo usermod -aG dialout $USER # encerre e reabra a sessão
sudo chmod 666 /dev/ttyACM*
No Ubuntu, o serviço brltty pode se apropriar do adaptador serial. Se a
porta desaparecer após alguns segundos, remova-o:
sudo apt remove brltty.
7.5 Calibrar os braços
7.5 Calibrar os braços
A calibração é obrigatória para kit e pré-montados. Ela ensina ao
LeRobot a posição média de cada junta e seus dois limites mecânicos. Os
arquivos ficam em ~/.cache/huggingface/lerobot/calibration/, indexados
pelo ID do braço — reutilize um ID só para o mesmo braço físico.
Encontre as duas portas e exporte as variáveis usadas por todos os capítulos:
export TELEOP_PORT=/dev/ttyACM0
export TELEOP_ID=so101_leader
export ROBOT_PORT=/dev/ttyACM1
export ROBOT_ID=so101_follower
Calibre o líder:
lerobot-calibrate \
--teleop.type=so101_leader \
--teleop.port=$TELEOP_PORT \
--teleop.id=$TELEOP_ID
- Leve cada junta ao meio do curso. Centralize com cuidado a rotação do punho — se começar num limite, o encoder pode transbordar durante a varredura;
- Aperte Enter e varra cada junta lentamente até os dois limites, uma por vez. Repetir não tem problema: os extremos são sobrescritos;
- Aperte Enter para salvar.
Calibre o seguidor da mesma forma:
lerobot-calibrate \
--robot.type=so101_follower \
--robot.port=$ROBOT_PORT \
--robot.id=$ROBOT_ID
No seguidor, pare no limite mecânico real do braço — não num cabo, não na mesa. Um cabo preso registra um limite falso e comprime o curso útil.
Se o seguidor espelha só metade do movimento do líder, ou uma junta salta para um limite, a varredura foi curta. Recalibre o braço movendo cada junta por todo o curso.
Se usa as ferramentas do workshop da NVIDIA, verifique o seguidor:
export ROBOT_PORT ROBOT_ID
python ~/Sim-to-Real-SO-101-Workshop/docker/real/scripts/so101_check_calibration.py
Uma boa calibração termina com:
Overall: ✓ PASS — calibration looks good.
7.6 Verificar o braço robótico
7.6 Verificar o braço robótico
Leve os dois braços a posturas parecidas e execute:
lerobot-teleoperate \
--robot.type=so101_follower \
--robot.port=$ROBOT_PORT \
--robot.id=$ROBOT_ID \
--teleop.type=so101_leader \
--teleop.port=$TELEOP_PORT \
--teleop.id=$TELEOP_ID
Mova o líder devagar. O seguidor deve rastrear cada junta na mesma
direção e alcançar os mesmos limites. Pare com Ctrl+C.
Isso também confirma a ordem de juntas usada no resto do curso:
shoulder_pan, shoulder_lift, elbow_flex, wrist_flex, wrist_roll,
gripper. Se uma junta andar ao contrário, recalibre — não compense por
software.
Durante as primeiras execuções, mantenha uma mão perto do interruptor de energia do seguidor.