MABEL 조립 가이드
Vision Pro로 전신을 원격 조작하는 오픈소스 56자유도 모바일 양팔 로봇
라이선스
- software: Apache 2.0
- hardware design files (CAD, PCB): CERN-OHL-S 2.0 (strongly reciprocal)
- documentation and media: CC BY 4.0
라이선스가 나뉘어 있습니다. 소프트웨어는 Apache-2.0, 하드웨어 설계 파일(CAD, PCB)은 CERN-OHL-S-2.0(수정한 설계를 같은 조건으로 공유하도록 요구하는 강한 상호주의 오픈 하드웨어 라이선스), 문서와 미디어는 CC BY 4.0입니다. 업스트림 구성 요소는 각자의 라이선스를 유지하며, 이는 THIRD_PARTY_NOTICES.md에 나와 있습니다. 암은 OpenArm에서, 핸드는 ORCA Hand에서 파생되었습니다. 2026년 11월 4일 확인.
조립 가이드
1. 시작하기 전에
MABEL이 무엇으로 만들어지는지, 어떤 부품을 구매하고, 제작하고, 다른 오픈 프로젝트에서 만드는지 설명합니다.
1.1 무엇을 만드는지 알아 두기
MABEL은 구매한 모듈, 두 개의 오픈 하위 어셈블리, 소수의 자체 맞춤 부품을 결합합니다.
- MABEL은 모바일 양팔 로봇입니다. 3개 모듈로 된 스워브 베이스, 수직 리프트, 피치 동작을 하는 몸통, 스테레오 카메라를 갖춘 3자유도 헤드, 7자유도 암 2개, 17자유도 핸드 2개로 구성됩니다.
- 암은 OpenArm에서, 핸드는 ORCA Hand에서 파생되었으며, 둘 다 각 프로젝트가 공개한 방식대로 만듭니다.
- 스워브 모듈(REV MAXSwerve)과 리프트(높이 조절 책상 컬럼)는 시판 부품입니다.
- MABEL 자체 부품은 판금 플레이트 일곱 장, 출력한 커버와 마운트, 알루미늄 압출재, 그리고 맞춤 PCB 한 장인 베이스 캐리어 보드입니다.
1.2 구성 등급 선택하기
다섯 가지 선택을 제외하면 모든 구성이 같습니다.
- 먼저 코어 부품을 주문합니다. 업스트림의 Build Guide는 이를 섹션 1~8에 나열하며, Essential, Recommended, Maximum 구성에서 모두 같습니다.
- 그다음 섹션 9의 다섯 가지를 선택합니다. 온보드 컴퓨터, 손목 카메라 두 대, 헤드 카메라, 선택 사항인 베이스 깊이 카메라, 2D 라이다입니다.
- 업스트림 권장 선택은 Orin NX 16 GB, MMlove 1200P 손목 카메라, MMlove 스테레오 헤드 카메라, 베이스 깊이 카메라 없음, RPLIDAR C1입니다.
- 세 가지 기준 구성은 이 다섯 가지 선택만 다릅니다. 현재 가격은 이 프로젝트의 부품 목록을 참고하십시오.
2. 부품 주문하기
코어 부품 목록과 각 부품의 구입처입니다.
2.1 코어 부품 주문하기
업스트림의 비용 산정 목록이 기준이며, 모든 항목에 판매처 링크가 있습니다.
- 이 프로젝트의 부품 목록을 사용합니다. 이 목록은 업스트림의 core.csv로 만든 것이며, 업스트림은 이 파일을 부품표의 기준 출처라고 부릅니다.
- 대부분의 액추에이터, OpenArm 구조 세트, 암 하네스, 핸드 서보는 Taobao에서 구매합니다. 스워브 모듈은 REV, 리프트 컬럼은 FlexiSpot, 압출재는 McMaster-Carr에서 구합니다.
- 부품 목록의 미해결 항목을 확인합니다. 업스트림은 배송비, 필라멘트, 캐리어 보드 부품 등 아직 비용을 산정하지 않은 부품을 표시해 두었습니다.
3. MABEL 맞춤 부품 만들기
판금 플레이트, 출력 부품, 압출재 절단입니다.
3.1 CAD 받기
모든 맞춤 부품은 로봇 전체의 STEP 어셈블리 하나에서 나옵니다.
- hardware/cad/MABEL_full_assembly.step.zip의 압축을 풀고 FreeCAD, Onshape, Fusion, SolidWorks 등 아무 CAD 도구에서 STEP을 엽니다.
- 로봇 전체의 링크별 메시도 simulation/mabel_mujoco/assets/meshes에 있지만, 부품은 STEP으로 만듭니다.
3.2 판금 플레이트 제작 맡기기
플레이트 일곱 장이며, 5052 H32 알루미늄, 2.0 mm(0.080 in)로 견적을 받았습니다.
- 각 플레이트의 DXF 또는 STEP을 온라인 판금 서비스에 올리고 5052 H32 알루미늄, 두께 2.0 mm로 주문합니다.
- 베이스 판금, 하부: 레이저 절단만.
- 베이스 판금, 상부: 벤딩 4회, 딤플 성형, 하드웨어 압입, 탭 가공.
- 리프트-몸통 어댑터: 벤딩 2회, 딤플 성형, 하드웨어 압입, 탭 가공.
- 몸통 출력 플레이트: 벤딩 1회, 하드웨어 압입, 탭 가공.
- 바디 하부 플레이트: 벤딩 2회, 하드웨어 압입, 탭 가공.
- 목 장착 플레이트: 벤딩 2회만.
- 암 장착 플레이트(두 장): 하드웨어 압입, 탭 가공.
- 하드웨어 압입은 PEM 너트나 스탠드오프를 제작 업체에서 압입하는 것을 뜻하고, 탭 가공은 나사 구멍을 작업대에서가 아니라 제작 업체에서 내는 것을 뜻합니다.
3.3 출력 부품을 출력하고 압출재 자르기
커버, 센서 마운트, 트림은 출력하며, 프레임은 2x2 in과 2x4 in 압출재입니다.
- 커버, 센서 마운트, 트림을 STEP에서 1.75 mm 필라멘트로 출력합니다(Build Guide 섹션 8).
- 알루미늄 압출재를 Build Guide 항목 6.01의 길이로 자릅니다. 업스트림은 이 길이를 단위 없이 기재합니다. 2x2 in 프로파일은 15(2개), 17(2개), 4.75(3개), 8(2개), 2x4 in 프로파일은 10(1개), 12.5(2개)입니다.
- 항목 6.02와 6.03의 1010 시리즈 코너 브래킷과 각진 플레이트로 프레임을 결합합니다.
4. 하위 어셈블리 만들기
암, 핸드, 스워브 모듈, 리프트를 각 제작자가 공개한 방식대로 만듭니다.
4.1 암 두 개 만들기
암은 OpenArm에서 파생되었으며 OpenArm이 공개한 방식대로 만듭니다.
- OpenArm 자체 하드웨어 문서를 따르는 저희 OpenArm 가이드로 7자유도 암을 둘 다 만듭니다.
- MABEL의 암 펌웨어는 OpenArm 모터 세트로 각 암을 전용 CAN 버스에서 구동합니다. 관절 1과 2에는 DM8009, 관절 3과 4에는 DM4340, 관절 5~7에는 DM4310을 사용합니다.
- 처음 사용하기 전에 공급업체 도구에서 각 DaMiao 모터의 p_max, v_max, t_max를 확인합니다. 업스트림은 값이 일치하지 않으면 버스상의 모든 값이 아무 경고 없이 다른 배율로 바뀐다고 경고합니다.
4.2 핸드 두 개 만들기
핸드는 ORCA에서 파생되었으며 Feetech 서보로 동작합니다.
- 저희 ORCA Hand 가이드의 Feetech 빌드로 핸드를 둘 다 만듭니다. MABEL의 핸드는 Feetech HL3915M과 HL3930M 서보를 핸드당 17개(손가락 16개와 손목) 사용합니다.
- 각 핸드에는 버스 서보 드라이버 보드 하나와 전원 분배 보드 하나가 필요합니다(Build Guide 항목 4.03과 4.04).
- 토크를 활성화하기 전에 힘줄을 자리에 끼우고 새로 조립한 핸드를 캘리브레이션합니다. 모든 명령은 캘리브레이션된 범위로 제한됩니다.
4.3 스워브 모듈 만들고 리프트 장착하기
둘 다 시판 부품입니다.
- REV MAXSwerve 모듈(REV-21-3005) 세 개를 REV 문서대로 조립합니다.
- FlexiSpot E7 Pro 리프트 컬럼(CBR4830MD-E7WS)을 장착합니다. MABEL은 Raspberry Pi Pico에서 BTS7960 H-브리지를 통해 컬럼의 DC 모터를 구동하고 쿼드러처 인코더를 읽습니다.
- 모듈 세 개를 오른쪽 앞, 왼쪽 앞, 뒤쪽 가운데에 장착합니다. 베이스 펌웨어가 이 순서로 CAN ID를 할당합니다.
5. 베이스 캐리어 보드 만들기
유일한 맞춤 PCB로, 스워브 베이스를 구동하는 Teensy 4.1 캐리어입니다.
5.1 보드 주문하고 조립하기
CAN 버스 세 개, 이더넷, 24 V 출력, IMU를 갖춘 2층 보드입니다.
- electrical/Motherboard/fab을 zip으로 압축해 아무 2층 PCB 서비스에 올립니다. 적층 구성은 fab/Motherboard-job.gbrjob에 있습니다.
- electrical/exports/Motherboard_schematic.pdf의 회로도에 따라 부품을 조달합니다.
- 이 보드는 스워브 모듈마다 CAN 버스 하나, 로봇 컴퓨터로 가는 이더넷, XT30 출력 세 개에 24 V, BNO085 IMU를 제공합니다.
- 업스트림은 이 보드를 제작해 벤치에서 검증했다고 보고합니다. 플래시, 이더넷, CAN 버스 세 개 모두입니다.
6. 펌웨어 플래시하고 버스 가동하기
Teensy 4.1 보드 두 개, 리프트용 Raspberry Pi Pico, 핸드의 서보 버스입니다.
6.1 스워브 베이스 플래시하기
베이스 Teensy는 REV SPARK 컨트롤러를 1 Mbit/s로 구동합니다.
- firmware/swerve_drive에서 pio run -e teensy41 -t upload를 실행합니다.
- ./setup_can.sh를 실행해 can0을 1 Mbit/s로 올립니다.
- scripts/verify_can_motors.py를 실행하고 SPARK 컨트롤러 여섯 개가 모두 응답하는지 확인합니다. 홀수 ID는 구동, 짝수 ID는 조향입니다.
6.2 암, 몸통, 목 플래시하기
Teensy 하나가 SD 카드의 설정 파일을 바탕으로 두 암, 몸통, 목을 구동합니다.
- config/robot.json을 Teensy의 SD 카드에 복사하고 사용하는 네트워크에 맞게 net.ip를 설정합니다.
- firmware/openarm_dual에서 pio run -e teensy41 -t upload를 실행합니다. 첫 업로드가 실패하면 한 번만 다시 시도하고, 성공한 뒤에는 절대 다시 시도하지 않습니다.
- 115200 baud로 시리얼 모니터를 엽니다. 동작 여부와 관계없이 모든 액추에이터가 나열됩니다.
- DaMiao USB-CAN 동글을 연결한 호스트에서 scripts/dm_configurator.py로 모터 ID를 설정합니다. ID는 버스마다 고유해야 합니다.
- 목의 Dynamixel 버스는 5 V 로직이고 Teensy 핀은 5 V를 견디지 못하므로 레벨 시프터를 사용합니다.
6.3 리프트 컨트롤러 플래시하기
리프트는 Raspberry Pi Pico에서 MicroPython으로 실행됩니다.
- pip install mpremote를 실행한 다음 firmware/lift/tools/deploy.sh를 실행합니다.
- calibrate를 한 번 실행해 리프트가 바닥과 천장 위치를 찾게 합니다. 전원이 꺼진 상태에서 컬럼을 손으로 움직였다면 home을 다시 실행합니다.
6.4 핸드와 CAN 버스 확인하기
핸드는 플래시할 필요가 없습니다.
- firmware/orca_hand/feetech/scripts/scan.py를 실행하고 각 핸드에서 서보 ID 1~17을 확인합니다.
- firmware/can_up.sh --ping을 실행해 SocketCAN을 올리고 DaMiao 모터에 ping을 보냅니다.
7. 첫 테스트와 캘리브레이션
각 하위 시스템을 안전하게 테스트한 다음 캘리브레이션합니다.
7.1 베이스 안전하게 테스트하기
스워브 베이스의 첫 주행에 관한 업스트림 규칙입니다.
- 첫 테스트에서는 바퀴를 바닥에서 띄웁니다.
- 바닥에서 주행하기 전에 scripts/set_drive_limits.py를 한 번 실행해 구동 출력 상한을 플래시에 기록합니다.
- 첫 실제 주행 전에 swerve_teleop.py 맨 위에서 STEER_OFFSET, DRIVE_SIGN, WHEEL_RADIUS, DRIVE_GEAR_RATIO를 설정합니다.
- 버스에 명령할 수 있는 프로그램은 하나뿐입니다. 로봇에서 이 도구들을 사용하기 전에 로봇 소프트웨어를 중지합니다.
7.2 모터와 핸드 캘리브레이션하기
인코더 윈도, 관절 방향, 중력 보상은 하나의 캘리브레이션 파일에 저장됩니다.
- pip install -r calibration/requirements.txt로 캘리브레이션 도구를 설치합니다.
- calibration/motor_calibration/hardware/scan.sh를 실행해 모터에 전원을 넣지 않고 목록을 확인합니다.
- run_hardware.sh로 각 모터의 마찰과 관성을 식별합니다. 이때 샤프트에서 떨어져 있고 한 손은 비상 정지 버튼에 둡니다.
- 각 핸드의 엔드스톱 스윕을 실행합니다: python3 -m mabel_hw.drivers.orcahand.calibrate --model left, 그다음 right.
7.3 로봇 전체 가동하기
ROS 2 워크스페이스를 한 번 빌드한 다음, 스크립트 하나로 모든 것을 시작합니다.
- 로봇 컴퓨터에서 ros/dev_up.sh를 한 번 실행해 ROS 2 Jazzy 워크스페이스를 빌드합니다.
- 저장소 루트에서 bash server/real_run.sh를 실행하고, 포트 8094에서 Control Center를 열거나 Vision Pro 앱을 연결합니다.
- 암은 힘이 빠진 상태로 시작하며, 운영자가 명시적으로 토크를 활성화합니다. 토크를 활성화하기 전에 비상 정지 버튼의 위치를 알아 두십시오.
- 호스트를 중지하기 전에 암을 받쳐 둡니다. 250 ms 동안 호스트 패킷이 없으면 모든 암 모터가 비활성화됩니다.
- 베이스의 모든 움직임은 전도 방지 검사를 거치며, 이 검사는 리프트 높이에 따라 속도를 제한합니다.